Index

Select

Text Mode

You can select a few of Markup Shredder­s settings if you press [S] and one of the keys mentioned in the following sub-sections.

To edit any item, press [Enter] to jump into the input line, and the [Up] or [Down] arrow key to leave it. Typing [Backspace] removes undesired characters. Press [Q] to quit the selection dialog.

All changes that you have done here are assigned to variables like [GMS­_CODE­PAGE] in $GMS­_ROOT/etc/ge­rolf (Linux) respectively %GMS­_ROOT%\etc\ ge­rolf.bat (Dos, Windows), the launcher and configuration script.

Animation

[A]: The menu animation can be switched on or (nearly) off. GMS makes use of the reply binary, which draws a menu box line after line. GMS provides a fast drawing mode and another one that looks a bit nicer. The effect is nearly invisible on modern computers, but on a slow Dos machine, menu building may last too long; so the command line interface should be used instead.

Colors

[C]: You can set the interface colors as you like. GMS will open a color pane and another input box where you can enter numbers between 0 (black) and 15 (white) for the foreground colors (text, hotkey, and pattern). The numbers for background colors (banner, shadow, and desktop) must be in range 0 to 7 (gray). The desktop pattern letter is defined by its index number in the US-American code page (ASCII); it must be in range 32 (blank) to 126 (tilde).

By default, all these values are set to R, meaning that they are assigned a random number after every viewer call or execution of external programs (chameleon mode). If you want to set the interface to fixed colors, try the following numbers: 15, 15, 15, 2, 4, 1, 47, or 0, 12, 15, 7, 0, 1, 92.

Programs

[P]: GMS opens another input box where you can enter the name of the program binaries to be associated with the main GMS menu functions (view, edit, browse, analyse, typeset, and read). These executables – or startup shell scripts, batch files, links (*.sh, *.bat, *.lnk) – should be found in the search path or in [GMS_BI­NA­RIES], a sub-directory of [GMS­_ROOT]/binbin. Do not enter paths, spaces and parameters into the input line, only the file name is allowed.

For example, if you want to use HTML-Kit (Windows NT/XP) as editor to be called from GMS, open Explorer, change into the %Pro­gram­Fi­les%\Cha­mi\HTML-Kit\bin directory and click on HTML-Kit.exe with the right mouse button. In the context menu select create link. Move this link to %GMS­_ROOT%\bin\win and rename it to HTML-Kit; so the corresponding link file is named HTML-Kit.lnk. Enter HTML-Kit.lnk into the editor input line in the program selection dialog. Do not add a search path or a parameter here.

On Windows 9x, LNK files are not executable; so in %GMS­_ROOT%\bin\win, create a HTML-Kit.bat batch file instead, consisting of just the line "%Pro­gram­Fi­les%\Cha­mi\HTML-Kit\bin\HTML-Kit.exe" %1 %2 %3 %4 %5.

On Dos, omit the quotation marks when calling a program from a batch file. To access your work file, you can also make use of the variables %GMS­_REMO­DRV% (drive letter), %GMS­_FOLD­ER%, %GMS­_FILE%, %GMS­_SHORT% (8.3-format) and %GMS­_BASE% (no extension). – Similarly, on Linux, use $GMS­_FOLD­ER, $GMS­_FILE and $GMS­_BASE.s

Debug

[D]: If you want to engage in debugging Markup Shredder, you can set this item to other values than 0 (no debugging): Z creates a [GMS­_ROOT]/etc/gms­de­bug.loggms­de­bug.log file, listing all internal calls to the command line and text mode interface mod­ules, together with parameters and values of important environment variables (not on Dos and Windows 9x). X traces these module calls on additional banners inside the text mode interface. Y does the same in slow motion.

Encoding

[E]: Here you can enter the main 8-bit encoding, which fits for most of the fonts used with Markup Shredder, usually one of a Latin alphabet. Encodings that cover only a small number of fonts should be defined in the GMS configuration files font.cfg, encoding.cfg and alias.cfg in [GMS­_ROOT]/etc.

Every letter in a HTML file is stored as a number indicating its index in a table of characters. Since every code page can only hold 28  = 256 characters, there are systems of related code pages covering a wider range: First, the iso-8859-x or i8859-x series by ISO. Second, the windows-125x or cp125x series by MicrosoftMicrosoft, which makes a more efficient use of the table space. Third, the UnicodeUnicode system that defines hundreds of consecutive code pages to enumerate every character of every language on earth. But there are also code pages that have been developed independently to fit a particular language or script, for example ISCII (Indian) or VISCII (Vietnamese).

Markup Shredder will employ a matching code page designation, if you simply enter one of the following keywords: Arabic, Baltic, Central, Cyrillic, Greek, Hebrew, Indian, Latin, Thai, Turkish, Vietnamese, or Western.

You cannot enter the word Unicode (or UTF-8) here. Markup Shredder works with 8-bit input files, and you have to decide for one single code page, not a whole series. However, GMS gives you access to fonts with a different encoding, if Unicode char­acters are escaped according to the HTML specification, writing the mathematical infinity symbol as ∞ or ∞, for example. You can change a file’s encoding with your browser’s menu function File/Save as.

Whenever you have changed the standard code page here, you still must re-compute the TeX font metrics (in order to write the font map) and re-initialize the TeX format file for GMS.

Codepage

In the text mode interface, Markup Shredder can only show half of the characters from the current code page.

Command Line

Enter gms -s to open the launcher and configuration script, and gms -e to edit it, directly selecting GMS properties by assigning new values to the GMS variables therein.

Appendix