Apple-2-Tools/ciderpress
1
0
Fork 0
mirror of https://github.com/fadden/ciderpress.git synced 2024-12-02 10:51:30 +00:00
Code Issues Projects Releases Wiki Activity
a2962e976f
ciderpress/app/Help/html/t215.htm

32 lines
4.0 KiB
HTML
Raw Normal View History

WinHelp to HtmlHelp conversion, part 1 The original version of CiderPress used a WinHelp help file, built with an application called HelpMatic Pro. This app used a proprietary format, and had no facility for exporting to "raw" HPJ + RTF files, so I decompiled the HLP and imported it into HelpScribble. Using HelpScribble, I cleaned up the help file formatting a little, fixed up the table of contents, and exported as "raw" HtmlHelp (HHP, HHK, HHC, and a whole bunch of HTML). I also split the pop-up help text, which isn't supported by HelpScribble, into a separate text file that Microsoft's HTML Help Workshop understands. I'm checking in the files that HTML Help Workshop needs to generate a CHM, so anyone can update the help text. I'm also checking in the CHM file, rather than adding the help workshop to the build, so that it's not necessary to download and configure the help workshop to build CiderPress. This change adds all of the updated help, but only updates the Help and question mark button actions for one specific dialog. A subsequent change will update the rest of the dialogs. This change is essentially upgrading us from a totally obsolete help system to a nearly-obsolete help system, but the systems are similar enough to make this a useful half-step on the way to something else. The code will centralize help activation in a pair of functions in the main app class, so any future improvements should be more limited in scope. This also adds a build step to copy the CHM to the execution directory.
2014-12-09 06:34:34 +00:00
<HTML><HEAD>
<TITLE>Convert Disk Image to File Archive</TITLE>
<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<PARAM NAME="Keyword" VALUE="convert">
<PARAM NAME="Keyword" VALUE="disk image">
<PARAM NAME="Keyword" VALUE="file archive">
</OBJECT>
<META NAME="AUTHOR" CONTENT="Copyright (C) 2014 by CiderPress authors">
<META NAME="GENERATOR" CONTENT="HelpScribble 7.8.8">
<STYLE> span { display: inline-block; }</STYLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="4">Convert Disk Image to File Archive</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">This feature extracts every file it can find in a disk image and stores it in a ShrinkIt archive.&nbsp; This is similar to extracting all files with "preservation mode" enabled and re-adding them, but is faster and easier.&nbsp; It can be used in conjunction with "convert file archive to disk image" to resize a ProDOS volume.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Open a disk image and highlight the files you want to convert.&nbsp; Items will be converted in the order that they appear, so if you want to leave the order undisturbed make sure you have them sorted in the original order (<A HREF="t50.htm">more information on this</A>).&nbsp; Select "Convert to file archive..." from the Actions menu.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The "Preserve empty folders" feature is useful when you plan to convert the file archive back to a disk archive, perhaps after modifying some files or just choosing a different disk size.&nbsp; The ShrinkIt archive format describes a way to store empty folders, but it has never been used by any ShrinkIt utility and could cause some software to break.&nbsp; Instead, CiderPress creates standard zero-length file entries with the name ".$$EmptyFolder".&nbsp; These are automatically dropped when converting to a disk archive, but will appear as normal entries in the archive.&nbsp; This option should therefore be enabled only when you plan to convert back to a disk image.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">The selected <A HREF="t29.htm">default compression</A> will be used when creating the ShrinkIt archive.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Text files on DOS 3.2/3.3 and RDOS disks (file type 'T') will be converted to ProDOS format.&nbsp; This involves stripping "high ASCII" text from the file.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">For performance reasons this feature holds most of the files in memory during the operation, making this somewhat memory-intensive.&nbsp; If you are working with 32MB hard drive partitions, performance on systems with insufficient RAM may suffer.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">&nbsp;</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;"><FONT FACE="MS Sans Serif" SIZE="2">Files in embedded volumes, such as a DOS volume inside an 800K ProDOS disk, can be converted.&nbsp; However, they become just like any other file, and if the file archive is converted back to a disk image they will no longer be stored in an embedded volume.</FONT></P>
<P STYLE="margin-top:0;margin-bottom:0;">
</P>
</BODY></HTML>
Reference in New Issue Copy Permalink