Email&CorTeXQuedMac May 1993 alpha version (not yet complete) Master posting on ftp matups.matups.fr in directory TeX/TypingTeX.dir ************************************************* ****** ****** Conversions: ****** ****** TeX <-- email-fr <--> CorTeX --> TeX ****** ****** on the Apple Macintosh. ****** ************************************************* Note aux francophones : Des renseignements assez d'etaill'es sur CorTeX et email-fr apparaissent avril-juin 1993 dans les transactions de la liste 'electronique GUT, affich'ees sur le serveur ftp ftp.cicb.fr (login: anonymous). Voir aussi un r'esume 'eventuel juxtant ce fichier sur ftp matups.matups.fr. ************************************************* ***** INTRODUCTION ***** ************************************************* --- email-fr is a scheme for efficient typing of French accented characters in which one types ' for \' (accute accent), ` for \` (grave accent), ^ for \^ (hat accent), and / for for apostrophe (at least before before e and E). The French abstract avove is in this style. --- CorTeX is a similar scheme which differs in that ' ^ ` follow the vowel, and / is not used for apostrophe. It was set up by by Hubert Garavel (imag) and modified somewhat by Pascal Amsili . See a partial posting by Amsili on ftp matups.matups.fr. Many users find CorTeX conventions just a bit more natural, probably because they are closer to handwriting. CorTeX also allows " for diaressis following a vowel. But one one should avoid its use on terminal vowels: type aigu\"e, Malm\"o, not aigue", Malmo" to avoid confusion with " as closing double quotes (guillemets). In both systems of typing Knuth's more prolix syntax for accents remains available. The email-fr typing is acceptable to TeX once a small macro pakage email-fr.sty has been loaded; email-fr is thus perfectly portable. CorTeX requires a preprocessor, which is given as a lex script (lex is a unix utility). This script performs a couple of extra services: (a) Conversion of tabs to spaces. This trivial feature is neglected here since it can be done readily by a wordprocessor at any time. (b) Conversion of oe to \oe when french typography requires it. This non-trivial feature is retained here and adopted for all conversions concerning email-fr since it manages to do gracefully what many of us neglect. Please complain if mistakes result! Because lex is not conveniently accessible on the Mac but the editor QedM is, there was a need for a QedM version of CorTeX. It is the macro: **post-acc2tex : CorTeX --> TeX For users of email-fr who want to have ".tex" file blend most easily with Knuth's syntax (perhaps at the cost of readibility) there is also: **pre-acc2tex : email-fr --> TeX For good measure converters between email-fr and CorTeX are provided: **post-acc2pre-acc : email-fr <-- CorTeX **pre-acc2post-acc : email-fr --> CorTeX And also three converters from standard TeX typing to various more readable formats: **tex2pre-acc : TeX to email-fr --- useful for making a French language .tex file readable without while leaving it portable ie ascii and typesettable anywhere. Do not forget to add essential email-fr commands. **tex2mac : TeX to full Macintosh 8-bit encoding (Mac Times) --- useful for spelling checks by Mac spelling checkers for French or for freeding to non-TeX Mac formatters such as Microsoft Word. **tex2swt : TeX to Sweet 8-bit encoding (Sweet-teX). --- The font Sweet-teX is a 12 point bitmapped screen font for Macintosh that combines essential accents, formatting "roadsigns", and math symbols. It is part of the TeX preprocessor Sweet-teX for math typeseting that is available on ftp matups.matups.fr. All these macros are located in an appendix in ascii form or as a binary Macintosh file of type QMAC and creator QED1. ************************************************* ***** USE OF THE MACROS ***** ************************************************* (0) Only the macros whose names begin with stars **... are intended to be used directly; the rest are "subroutines". Choose a work folder by opening a file in it. Run the macro ***initialize to be sure that a work file "ctwk" exists in it. The action of a two-star macro such as **post-acc2tex will be restricted to the active window and further it will not change that window without approval of the user; instead, auxiliary files are used. (1) To process a file open it and save a copy to the folder work folder. The window of the fiel to process must be selected a macor is run. Further, if some text is SELECTED in the active window the macro ignores everything but the selection. This is useful to make a quick trial run on a critical part of the typescript. This may equally be useful and necessary to avoid parts of a typescript that are typed in distinct fashion. In such heterogeneous typescripts, QuedM allows one to mark various chunks of the typescript in such a way that they can be selected instantly at any time. (Select the chunk and use the Set Marker... option in the Search menu.) For example, one might mark text from \beginemailFR to \endemailFR for conversion to ordinary tex syntax. If one takes care to use a *copy* of the original typescript, one can then progressively paste in the converted chunks offered by the macros. (2) Contrary to the original CorteX policy, the character " following a terminal vowel is not interpreted as a dieresis thereon, but as a double quote --- unless the word in question is aigue" or Malmo" or oither exceptions to be added. This allows Knuth's use of " for closing double quotes to be maintained in practice. (3) A fundamental weakness of these macros is that they do not distinguish math mode rigourously. In math mode ^, _ or , ', (each without \ before it) have meanings that may conflict with their meanings in prose. Hence the inspection macros will be provided in a separate macro file to warn of possible conflicts with the CorTeX and email syntax. They give a report on possible difficulties. It should suffice to arrange that the above characters are separated by a space or at least something that avoids possible interpretation as an accent. These inspector macros will also warn of possible problems outside of mathematics. Laurent Siebenmann, May-June, 1993 ************************************************* ***** USE OF THE MACROS ***** ************************************************* (0) Only the macros whose names begin with stars **... are intended to be used directly; the rest are "subroutines". The action of a macro will be restricted to the active window and further it will not change that window without approval of the user; instead, auxiliary files are used. (1) If some text is SELECTED in the active window the macro ignores everything but the selection. This is useful to make a quick trial run on a critical part of the typescript. This may equally be useful and necessary to avoid parts of a typescript that are typed in distinct fashion. In such heterogeneous typescripts, QuedM allows one to mark various chunks of the typescript in such a way that they can be selected instantly at any time. (Select the chunk and use the Set Marker... option in the Search menu.) For example, one might mark text from \beginemailFR to \endemailFR for conversion to ordinary tex syntax. If one takes care to use a *copy* of the original typescript, one can then progressively paste in the converted chunks offered by the macros. (2) Contrary to the original CorteX policy, the character " following a terminal vowel is not interpreted as a dieresis thereon, but as a double quote --- unless the word in question is aigue" or Malmo" or oither exceptions to be added. This allows Knuth's use of " for closing double quotes to be maintained in practice. (3) A fundamental weakness of these macros is that they do not distinguish math mode rigourously. In math mode ^, _ or , ', (each without \ before it) have meanings that may conflict with their meanings in prose. Hence the inspection macros will be provided in a separate macro file to warn of possible conflicts with the CorTeX and email syntax. They give a report on possible difficulties. It should suffice to arrange that the above characters are separated by a space or at least something that avoids possible interpretation as an accent. These inspector macros will also warn of possible problems outside of mathematics. Laurent Siebenmann, May-June, 1993 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% APPENDIX: TEXT FORM OF THE MACINTOSH QEDM MACROS NB. The working form is the resource file: **Post&PreAcc7BitTeX-QuedMac which is a Macintosh binary file. %%%%% ***documentation %%%%% ***initialize %%%%% **post-acc2tex %%%%% **post-acc2pre-acc %%%%% **pre-acc2post-acc %%%%% **tex2mac %%%%% **tex2pre-acc %%%%% **tex2swt %%%%%% Auxiliary macros %%% de-oemacros %%% re-oemacros %%% de-verbatim %%% re-verbatim %%% de-verbatim-loop %%% re-verbatim-loop %%% post-acc-pre-trans %%% pre-acc-post-trans %%% post-acc-tex-trans %%% oe %%% tex-mac-trans %%% tex-pre-acc-trans %%% tex-swt-trans %%%%% ***documentation