From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- support/tex-converter/README | 633 +++++++++++++++++++++++++ support/tex-converter/Version 2.6 | 1 + support/tex-converter/licence.txt | 23 + support/tex-converter/update/CustomCode.txt | 25 + support/tex-converter/update/LaTeX2HTML.init | 6 + support/tex-converter/update/TeX Converter.ini | 128 +++++ support/tex-converter/update/Updates.txt | 15 + support/tex-converter/update/Version 2.6 | 1 + support/tex-converter/update/convert.bat | 104 ++++ support/tex-converter/update/licence.txt | 23 + support/tex-converter/update/readme.txt | 633 +++++++++++++++++++++++++ 11 files changed, 1592 insertions(+) create mode 100644 support/tex-converter/README create mode 100644 support/tex-converter/Version 2.6 create mode 100644 support/tex-converter/licence.txt create mode 100644 support/tex-converter/update/CustomCode.txt create mode 100644 support/tex-converter/update/LaTeX2HTML.init create mode 100644 support/tex-converter/update/TeX Converter.ini create mode 100644 support/tex-converter/update/Updates.txt create mode 100644 support/tex-converter/update/Version 2.6 create mode 100644 support/tex-converter/update/convert.bat create mode 100644 support/tex-converter/update/licence.txt create mode 100644 support/tex-converter/update/readme.txt (limited to 'support/tex-converter') diff --git a/support/tex-converter/README b/support/tex-converter/README new file mode 100644 index 0000000000..a7c0dad0ff --- /dev/null +++ b/support/tex-converter/README @@ -0,0 +1,633 @@ +TeX Converter +------------- + +This program is a windows front-end to a number of programs that convert +TeX or Latex files to another format: + +1. HeVeA converts LaTeX files to HTML without using graphics +2. Tth converts (La)TeX files to HTML without using graphics +3. TeX4ht converts (La)TeX files to HTML using GIFS,PNGs or JPEGs +4. LaTeX2HTML converts LaTeX files to HTML using GIFS or PNGs +5. TeXify is part of MiKTeX and converts (La)TeX files to DVI and PDF +6. LaTeX and pdfLaTeX are part of MiKteX and convert LaTeX files to + DVI and PDF respectively + +All these programs run in DOS and require complicated command lines. +The purpose of TeX Converter is to make these programs easy to run. + +It is not necessary to install all these programs. For example HeVea +and Tth can be run without installing MiKteX. The downloaded files +install TeX Converter only. HeVeA, Tth, TeX4ht, LaTeX2HTML, TeXify and +MiKTeX must be downloaded and installed separately. + +The program also converts LaTeX files written by Scientific Notebook +and Scientific Word/Workplace. + +TeX Converter is freeware - see licence.txt +http://www.mayer.dial.pipex.com/tex.htm + +Setup +----- +TeX Converter should work in 32 bit Windows ie Windows 95/98/Me and +NT/2000/XP. + +1. Run the Setup program to install TeX Converter and its various files. + +2. Open TeX Converter.ini and change the paths to match your files. + + Thus if HeVeA is in C:\Hevea then change + + Hevea=D:\TeX\Hevea to Hevea=C:\Hevea + + This is essential if you want TeX Converter to find the relevant + programs. + + There are up to 13 changes you need to make. If you haven't installed + one of the programs leave the path empty. + + If you are using Version 1.4 or later you can get TeX Converter to + write this for you by clicking on the Help tab then choosing + Program Locations. Type in the paths or press the buttons marked ... + You can also use Auto Search to look for the necessary files. + + IMPORTANT + If you update any of the programs that you are using you must update + the program locations, otherwise TeX Converter may be unable to run + some programs or may insist on running an old version if still + present. + Ghostscript, for example, changed its default location for version + 6.01 and then again for 6.50. Alternatively, you may wish to + rationalise your folders. Please let TeX Converter know! + +3. If you are using Win 95/98/Me then: + + Open Windows Explorer. Right-click on Convert.bat and choose + Properties. Click on the Program tab and ensure the 'Close on exit' + box is ticked. + + Click on the Memory tab and in the 'Initial Environment' dropdown box + select 1024. + + Then press OK. + + Note: + These changes will ensure the DOS box opens and closes by itself and + that you don't get 'Out of environment space' messages. If you do + still get such messages, change 1024 to a higher number. Environment + space problems don't happen in NT or Win2000, and NT seems to default + to automatically closing DOS. + +4. Make a shortcut for TeX Converter.exe and put this shortcut in + the SendTo folder. Then you can right-click on a TeX file in + Windows Explorer and choose Send To and Tex Converter and it will + automatically put the file name in the box for you. + + You can also drag and drop files from Windows Explorer to TeX + Converter. + + +That's it. Now you should be able to run TeX Converter. + +Notes +----- +1. HeVeA and Tth are fast programs which run without user intervention. + The error messages flash by too quickly to read, so TeX Converter + doesn't bother to show them and instead saves them in a log file. + To read this file press View Log. + + TeX4ht, LaTex2HTML TeXify, pdfLaTeX all use LaTeX and may need user + input so the messages are put on screen. They still produce a log + which again will be shown by the View Log button. + + There is a Pause after DOS checkbox for Tex4ht and Latex2HTML + (press Adjust Init File to see it) if you want to read DOS messages + before the window closes. + +2. Do install the latest version of LaTeX2HTML - for example from + http://saftsack.fs.uni-bayreuth.de/~latex2ht/current/ + TeX Converter has been tested on version 99.2 beta 6 and there is + no guarantee it will work with previous versions. + There's a good installation guide at + http://feynman.faii.etsii.upm.es/~seidel/l2h/l2h_eng.html + with an updated version at + http://www.mayer.dial.pipex.com/l2h.htm + + Installation problems + --------------------- + Some people have reported problems installing LaTeX2HTML especially + with version 6.01 of Ghostscript. Here are a number of workarounds: + (the error messages in quotes are on the screen and in config.log) + + a. 'checking for gswin32c... no' means that Ghostscript can't be + found. This can happen if the LaTeX2HTML installation is on a + different drive from that of Ghostscript. I would suggest keeping + all the programs (including Perl and Netpbm) on the same drive + + b. 'checking if perl globbing works...' which is followed by the + program stopping or even causing a crash. Turn off any anti-virus + checkers and make the changes to config.bat in d. below + (globbing means understanding wildcards like * and ? in file names) + + c. 'checking for ghostscript version... no + Error: could not determine gs version + Warning: Will not be able to generate images due to above failure' + + This is due to a change in the way Ghostscript version 6.01 reports + its version and other features and the installation code is at + present unable to find the information. Until the code is changed + the following should work: + In config.pl (in \config subdirectory) add after + close(GS); + and before + # Configure things determined by the Ghostscript version + the 2 lines + @gs_devs=qw(pnmraw ppmraw); + $gs_version=6.01; + + d. I have found that a few changes to config.bat can also help + Change the first few lines to (with your correct paths): + + @ECHO OFF + REM this is a DOS batch file + + REM *vital* This is the path to the perl interpreter + set opath=%path% + REM put in the correct paths for perl in the next two lines + set path=%path%;c:\perl\bin;c\perl\lib + set PERL=c:\perl\bin\perl.exe + REM change the following paths if necessary + set gs_lib=c:\aladdin\gs6.01\lib;c:\aladdin\fonts + + REM ------------------------------------------------------------ + ECHO Starting Configuration... + + and at the end of config.bat add + + ECHO Configuration procedure finished + set path=%opath% + set perl= + set gs_lib= + :END + + Finally, if you are using Windows 95, 98 or Me change the + Environment space from Auto to 1024: + In Windows Explorer right-click on Convert.bat then Properties + then Memory tab and in the 'Initial Environment' dropdown box + select 1024. + + It is not necessary to do this in Windows NT or 2000 + +3. TeX Converter supports Philip A Viton's htrun facility for TeX4ht. + You may put htrun.exe and its batch files files in any directory + which will allow you to use both MiKteX and Scientific Workplace + versions. TeX Converter expects to find a copy of htrun.exe in + each directory containing the batch files. + + Please note that htrun's method of putting the options on the + command line rather than in the tex file is now the preferred + way of working. It has a greater range of output possibilities; + indeed working without it may well cease to be supported in the + future. It is strongly advised that you install the relevant files. + + MiKteX files can be found at: + http://facweb.knowlton.ohio-state.edu/pviton/support/tex4ht.html + with the htrun files at: + http://facweb.knowlton.ohio-state.edu/pviton/support/tex4ht-miktex-install.zip + + SWP files can be found at: + http://facweb.knowlton.ohio-state.edu/pviton/support/swpht.html + + Version 2.5 now supports the command line for any non-htrun batch + file while still allowing the option of using of \usepackage. If the + command line is used and htrun not used (and Scientific Workplace not + selected) then the default batch file is htlatex; using \usepackage + defaults to ht latex. SWP users should normally use htrun which has + been specially adapted to their requirements. + + Version 2.5 reads and writes the command line slightly differently, + so if you upgrade from an earlier version TeX Converter will ask you + to check a previous command line in case it has read it wrongly. + +4. TeX Converter also supports Philip A Viton's automated production of + PDF files for Scientific Workplace/Word. Full instructions and the + necessary files are available at: + http://facweb.knowlton.ohio-state.edu/pviton/support/pdfgs.html + + TeX Converter will help you install the files (PDF tab then + Setup batch files). + +5. Advanced Tex4ht users may wish to alter the command line to test + ideas or to use new options which haven't yet been supported by TeX + Converter. To do this, just before pressing the Convert button, click + on the textbox containing the words Command line: then Press the Esc + key. The key is a toggle so pressing the Esc key again turns off this + feature. Do note that changes to the command line should be made after + all the options have been selected, otherwise the changes will be + lost. + + From Version 2.6.6 you can double-click as an alternative to pressing + Esc. + + If you use code fragments regularly then from version 2.6.11 TeX + Converter will show them in a dropdown box when you press Esc. When you + click on an entry in the box the code fragment will be placed in the + command line at the cursor position. Put the code fragments (one fragment + per line) into a file called codefragments.txt saved in the TeX Converter + directory. + +6. Tex4ht has an extensive language which allows the user to configure + the resulting HTML. This is achieved by using document-level + configuration files - for details see + http://facweb.knowlton.ohio-state.edu/pviton/support/swpht.html + 'Advanced Use of TeX4ht', 'Configuring TeX4ht's HTML' + and the material on myconfig.cfg in that section. + + TeX Converter offers an easy way to use a configuration file by using + its own configuration file tcconfig.cfg. This is accessed via the Edit + tcconfig.cfg button in the Advanced window. + + Use tcconfig.cfg to insert modifications that are to be available to + all documents. The default code in this file will also then enable any + document-level configuration files you may wish to use (these have the + same name as the tex file but with extension .cfg or .cfh). + + There is online help for the Tex4ht code at + http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn2.html + + You can ask TeX Converter to generate an up-to-date manual called + Tex4htCode.txt. This is done by applying Tex4ht to a small tex file. + +7. When using LaTeX2HTML or Tex4ht tex files are copied to a destination + directory before any conversion. This allows TeX Converter to make + any required changes to a copy of the tex file whilst leaving the + original untouched. + + TeX Converter then changes the current directory to the new directory + and copies files referenced in \input and \include commands to that + directory. Normally, class files and packages are kept in a texmf + tree where Latex can find them, but it is possible to keep special + versions in the same directory as the tex file, and these will then be + used. TeX Converter will attempt to copy any such class files + referenced in \documentclass but you may need to copy other files + manually to the destination directory so that Latex can find them. + +8. From version 2.6.0 onwards you can easily check for updates by + pressing the Update Check button on the Help tab. Updates shouldn't + be required unless a required feature has been added or a there is + a bug. + + The updating mesage will open in the external or internal browser + as chosen on the first four tabs. + +9. Older versions of TeX Converter accommodated use of an images + subdirectory for tex4ht graphics by post-processing the html files. + From version 2.6.6 onwards you can get Tex4ht itself to produce the + references, which is more efficient. + + TeX Converter will add the command imgdir:images/ and Tex4ht will + create the correct paths. However, for this to work you may need + to update your tex4ht files. Look for *.4ht dated 31st August 2002 + or later in the 'alternative zipped' files on Tex4ht's Bug Fixes and + Comments page at + http://www.cis.ohio-state.edu/~gurari/TeX4ht/bugfixes.html + + If you have an earlier version of Tex4ht then it will ignore the + new command and TeX Converter will post-process the files for you. + + In other words, TeX Converter will use the best method for creating + the html files without any need for action by the user. + +10. TeX Converter now supports the mouseover option. For details on this + see Updates (25 July 2002) at + http://facweb.knowlton.ohio-state.edu/pviton/support/swpht.html + which will explain how SWP can use this option. + + Miktex users will also require updated tex4ht files dated + 24 July 2002 or later obtainable from + http://www.cis.ohio-state.edu/~gurari/TeX4ht/bugfixes.html + + In addition Miktex users will also require xhtex.bat: + + If you use htrun (highly recommended) then look for a file + called xhtexm.bat (which may be inside xhtml.zip) and make + a copy called xhtex.bat and save it in your htrun directory. + + If you don't use htrun or cannot find this file then + download it from + http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn-scripts.html + Look for xhtex.bat in the MS Bitmap Math column and save it + in your Tex4ht directory - changing the name of the downloaded + file from xhtex-bat.txt to xhtex.bat. + + +Possible Problems +----------------- +1. Try not to bury your programs or TeX files too deep in the directory + structure. It can cause problems where TeX Converter has to send + long commands to DOS. You can be warned of this by checking the + 'Warn if command line is too long' in TeX Converter's Help. + +2. Try not to use long file or directory names. These are shortened by + DOS which puts a ~ in the filename/directory. TeX Converter gets + over this by offering to swap ~ to _. However, as a general rule + stick to short file names in short directories with no spaces so + that the DOS names are the same. + If you do wish to try using a long file name for the tex file then + you can choose this option on the Help tab, More.... Please do be + aware that many TeX related programs do not support long file names + and may not work properly, and may give hard to find errors. + +3. You will be able to convert files on a CD-ROM because, if necessary, + TeX Converter will offer to copy them onto a hard drive first. + +4. TeX Converter can use its own Web Browser to view HTML files. + This is based on Internet Explorer so is unlikely to work + if you don't have IE installed. If it doesn't work click on + 'Use External Browser' and it will then use the default browser + installed on your system. + +5. If you have installed Tex4ht for MiKteX and do not wish to use + htrun (though this is now the preferred option) or htlatex.bat then + ensure there is a file called ht.bat in the Tex4ht directory with the + entries + %1 %2.tex + %1 %2.tex + %1 %2.tex + tex4ht %2 + t4ht %2 + If not, create ht.bat or alter the similar ht.tab + +6. There appears to be a clash between LaTex2HTML and anti-virus software + such as Norton or McAfee. If you have trouble installing or running + LaTeX2HTML try deactivating the anti-virus checker. TeX Converter + will, if you wish, remind you to do this every time you run + LaTeX2HTML. + +7. Allowing multiple conversions (checkbox on Help tab) lets you process + more than one tex file at a time, which is particularly useful for + TeX4ht and LateX2HTML as these programs can require a long period in + which to produce pictures. If you turn on this facility it is + possible that you will get strange effects. If so, then turn it off, + or put AllowMultiProcess=No in the [Preferences] section of + TeX Converter.ini. + +8. If you click on a link and find the URL has changed, then you can + update the URL by right-clicking on the link. The new URL will then + be saved. + +9. If you use a low screen resolution or large fonts you may find that + some of the windows don't fit onto your screen or that some buttons + are off-screen. You may scroll these windows by pressing Alt+arrow + key. The amount of scroll for each key press can be changed by + clicking on the More... button on the Help tab. + You can also try checking the "Move buttons I can't see box" + [If a number of users tell me there is still a problem I could + redesign the windows but there is so much information to fit on them, + which could mean using multiple tabs or windows which is not very + friendly either.] + +Please keep me informed of any bugs. There are bound to be problems +especially as it has been tested on a limited number of PCs. + +Thanks +------ +Philip A Viton for lots and lots of help especially with Hevea and Tex4ht +Thomas Wilson for helping to sort out long name problems in NT +Alain Braun for lots of user interface suggestions +Eitan Gurari for encouragement and help in developing advanced Tex4ht +support +Sebastian Paris for suggesting frames and tcconfig configuration window +for Tex4ht + +and everyone else, all of whom have given their help freely. + + +Revisions +--------- +Version 2.6 +2.6.16 +- Added licence +2.6.15 +- Tex4ht: Default always mean 3 passes +- Debug browser focus change +2.6.14 +- Ensure external editors can cope with long file names +- Option to allow non-tex files to be converted (eg Tex4ht and .ltx files) +- Tex4ht: debug showing of html vs xml output +- Tex4ht: allow absolute graphics paths in SWP files +2.6.13 +- Update links to Philip Viton's web pages +2.6.12 +- Ensure scrollwheel works in browser without needing to click first +2.6.11 +- Internal browser now copes with JavaScript focus changes +- Allow for separate alternative editors for text and tex files +- Stop Numlock being turned off in More Preferences +- Tex4ht: Add dropdown box for code fragments +- Tex4ht: Stop XHTML options being saved when Save options on exit + is not checked +- Tex4ht: removed bug when copying graphics file in SWP's \Frame and with + \framebox generally +2.6.10 +- Correct for XP's version of SendTo plus other minor bugs +2.6.9 +- Tex4ht: Added MathPlayer option +2.6.8 +- Tex4ht: Removal of delete custom code bug +2.6.7 +- Tex4ht: Correction of bug that creates images subdirectory with + overlib.js when not requested +2.6.6 +- Tex4ht: Added support for tex4ht to create images subdirectory + references in the HTML files. +- Tex4ht: Added double-click option to use manual command line +- Tex4ht: Added option to save advanced settings +- Tex4ht: Clear out unwanted files in output directory +- Tex4ht: Added support for mouseover (using overlib.js) +2.6.4 +- PDF: Added check for Windows XP in Setup batch files +2.6.3 +- Update: Minor change to show correct revisions from current version +2.6.2 +- Tex4ht: Copy correctly tcconfig files for XHTML +2.6.0 +- Added update check on Help tab + +Version 2.5 +- PDF: Added 0 passes option for SWP + Ghostscript +- Tex4ht & Latex2html: Added copying of \documentclass file kept in the + tex file directory to the destination directory +- Added revision file number and file date & time to help tab +- Hevea: Added support for Esponja the HTML optimizer in version 1.06 +- Hevea: Added support for Philip Viton's byte/native code +- Tex4ht: Remove bug stopping use of other batch files +- Tex4ht: Copy foo.bbl and mydoc.* files to destination directory +- Tex4ht: Workaround for SWP grahics+babel-french problem +- Tex4ht: Allow htrun to work with \usepackage +- Tex4ht: Substantial changes in the code to allow for command line and + \usepackage options for any non-htrun batch files. htlatex and + ht latex (and xht for SWP) are now the respective defaults + +Version 2.4 +- Tex4ht: Fixed bug which could make mangled copy of tcilatex.tex +- Tex4ht: Fixed bug where SWP graphics were not being copied to correct + directory +- Tex4ht: Added option for aligned equations in amsmath +- Fixed Windows NT/2000 crash in Auto Search for non-Administrator mode +- Tex4ht: Added options for glyph image type +- Tex4ht: Added append footnote option +- Hevea: Added -fix option + +Version 2.3 +- Tex4ht: Force use of / instead of \ for image subdirectory +- Tex4ht: Give indication of progress in processing html files +- Tex4ht: Eliminate double insertion of text in copied tex file +- Tex4ht; Adds number of latex passes if allowed in miktex htrun.ini +- Tex4ht: Subdocuments are now copied correctly +- DVI: Removed erroneous reference to pdfLatex +- PDF: Added refresh for printers list in setup batch files +- Tex4ht: Added support for subsubdocuments +- Tex4ht: Fixed error referencing included files +- Tex4ht: Added support for htlatex and any non-htrun batch file +- Added long file name support for tex files +- Added new More Preferences form +- Added scrolling of forms and option to move off-screen buttons for low + screen resolutions or large system fonts +- Added facility to change URL of links +- Tex4ht: Repaired broken link to tex4ht manual +- Tth: Removed extraneous -L from command line +- Tex4ht: Fixed error where not all graphics files were copied to + destination folder +- PDF: Added automatic setup for batch files +- PDF: Updated support for changed pdfmakegstc.bat file +- Tex4ht: Added facility for saving and loading of configuration code + fragments +- Tex4ht: Added edit window for tcconfig configuration file + +Version 2.2 +- Tex4ht: Removed unnecessary frames number +- Latex2html: Save split depth and verbosity to ini file +- Tex4ht: Added support for subdocuments +- Tex4ht: Added support for frames +- Tex4ht: Allow manual editing of command line for advanced users +- Tth: Update check for @hour etc +- Tex4ht and Latex2html: Save Pause after DOS option to ini file +- Tth: Update command line to work with newer versions +- Latex2html: Show new link for installation help +- Eliminated bug when pressing OK on program locations +- PDF: Added support for Philip Viton's automated PDF from + Scientific Workplace + +Version 2.1 +- Latex2html: Extra help in readme.txt for installation +- Reorganised this readme.txt so that the most recent revision is in the + logical place ie at the top +- Latex2html: Link on help page to mirror site during August 2000 only +- Tex4ht: Save number of SWP latex passes to ini file +- Tex4ht and Hevea: Serial conversion of tex files - allow option to + change links referencing tex files to links referencing html files +- Tex4ht: Support Philip Viton's conversion of graphics. Files such as + graphics or config files are copied to the required directories +- Tex4ht and Latex2HTML: Copy graphics like snapshots to images + directory +- Tex4ht and Latex2HTML: Look for gs_init.ps rather than gswin32c.exe + which takes account of new folders for Ghostscript 6.01 but still + works for version 5.50. +- Tex4ht: Allow long file names for SWP +- Hevea: Updated link for Hevea 1.05 +- Tex4ht: Better monitoring in of \package in tex file +- Tex4ht: Support new switch name for htrun +- Tex4ht: Allow user to choose batch file to run +- Tex4ht: Show command line +- Tex4ht: Added support for alternative htrun switches +- Tex4ht: Ensured browser loads xml files (even though IE can't read + them!) +- Tex4ht: Added support for htrun using command line options + and supporting new output formats xhtml, mathml, mozilla +- All programs: Added multiple conversions +- Tex4ht: Corrected labels not showing text properly (thanks to Philip) +- Tex4ht: Added advanced options for sectioning, xhtml, jpgs etc +- Tex4ht: Added support for Philip A Viton's htrun files + +Version 2.0 +- Ensured Latex2html saves html files in correct directory +- Added pause option to Tex4ht +- Document path problem in Latex2html sorted out +- Ensured that hacha uses correct paths, only one version of TeX + Converter runs, default editor used for files, edit tex file button + added, choice of text editor (again thanks to Alain Braun). +- Added Hacha support to Hevea (thanks to Alain Braun for his ideas and + help). +- Added Latex2html.init file to download ($HTML_VERSION = '3.2,math') +- Made images subdirectory Netscape friendly (using / not \) +- Changed misleading text in Program Locations browser windows +- Added options to Hevea for French mode and verbosity (for debugging) +- Prevent crash if filename is used for path in Program Locations +- Minor bugs dealt with +- Removed restrictions on settings (may be overwritten by l2h) +- L2h Init Form - added scroll bars and pause option +- Ensured Reload INI used newly saved version of file +- Squashed startup tab bug +- Added support for LaTeX2HTML + +Version 1.4 +- Allow change of start-up configuration on Load Configuration form +- Changed names of Hevea and Tth log files to give name of TeX file + that has been converted. Needs new version of convert.bat so version + checked on start +- Added converted tex files history list +- Enable DVI options disabled in error +- Eliminated bug in altering tex4ht html file for images subdirectory +- Added Auto Search option to find program paths +- Added Program Locations button to allow easier entry of paths + +Version 1.3 +- Added Hevea configurations to INI file +- Ensure filename is at top of Tth log for all versions of Tth +- Added option to store Tex4ht image files in separate subdirectory +- Added facility to change subdirectory where Tex4ht files are stored +- Added tooltips to links +- Added links to Philip A Viton's tutorials +- Tex4ht can choose to use Scientific Workplace's TrueTeX compiler + +Version 1.2 +- More bugs squashed including Windows NT not finding convert.bat +- Eliminated (I hope!) bug causing Run Time Error 52: Bad File Name or + Number message and crash +- Use user-defined path for tth.exe (so not dependent on installation + of MiKteX) +- Allow inline graphics in Tth +- Correct bug in log file path +- Allow long file names for tex files when using Hevea or Tth +- Allow programs to be stored in directories with long file names +- Less confusing scrolling of styles box when using arrows +- Correct showing of styles in load configuration form +- Check for version of Hevea and run xxdate.exe for version 1.05 +- Allow delete configurations in Load Configuration +- Corrected error where TeX Converter wouldn't load Include Style setting +- stop adding blank lines to end of convert.bat +- If configuration is empty then Save Configuration deletes unwanted + configurations +- Use default configuration at start-up +- Resolve errors in Load Configuration +- Hevea now saves html files to tex doc directory with .html extension + and Tth now uses .htm, so as to be compatible with forthcoming version + of Hevea for Scientific Workplace/Word +- Add drag facility to styles list +- Warn if Hevea or Tth give more than 50 bytes of errors +- Allow option to save browser position independently of Save Preferences + +Version 1.1 +- TeX Converter now writes directly to convert.bat to avoid long + command lines +- Ini file minor changes +- Reload ini option +- Larger form to cope with new options +- More extensive Hevea options allowing multiple use of style files, + excluded file, saveable configurations and text/info output. Thanks + to Philip A Viton for all his help. +- A few small bugs swatted eg now reads imagemagick, ghostscript paths + +Steve Mayer 12th August 2004 + +(c) Steve Mayer 1999 \ No newline at end of file diff --git a/support/tex-converter/Version 2.6 b/support/tex-converter/Version 2.6 new file mode 100644 index 0000000000..6529ecdf96 --- /dev/null +++ b/support/tex-converter/Version 2.6 @@ -0,0 +1 @@ +This is Tex Converter Version 2.6 \ No newline at end of file diff --git a/support/tex-converter/licence.txt b/support/tex-converter/licence.txt new file mode 100644 index 0000000000..97a47fd71f --- /dev/null +++ b/support/tex-converter/licence.txt @@ -0,0 +1,23 @@ +TeX Converter + +Copyright (c) 1999 Steve Mayer + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + diff --git a/support/tex-converter/update/CustomCode.txt b/support/tex-converter/update/CustomCode.txt new file mode 100644 index 0000000000..440f823351 --- /dev/null +++ b/support/tex-converter/update/CustomCode.txt @@ -0,0 +1,25 @@ +;Custom Tex4ht Code + +[HTML] +\HCode{} + +[Nav Buttons] +\Configure{crosslinks} {}{}{$\scriptstyle\Rightarrow$} {$\scriptstyle\Leftarrow$} {}{}{}{$\scriptstyle\Uparrow$} + +[Table] +\begin{tabular}{|r||r@{--}l|p{1.25in}|} + \hline + \multicolumn{4}{|c|}{GG\&A Hoofed Stock} + \\ \hline\hline + & \multicolumn{2}{c|}{Price}& \\ \cline{2-3} + \multicolumn{1}{|c||}{year} + & \multicolumn{1}{l@{\,\vline\,}}{high} + &low & \multicolumn{1}{c|}{Comments} + \\ \hline + 1971 & 97 & 245 & Bad year for + farmers in the west. \\ \hline + 72 & 245 & 245 & Light trading due to a + heavy winter. \\ \hline + 73 & 245 & 2001 & No gnus was very + good gnus this year. \\ \hline +\end{tabular} diff --git a/support/tex-converter/update/LaTeX2HTML.init b/support/tex-converter/update/LaTeX2HTML.init new file mode 100644 index 0000000000..1e570dd4e4 --- /dev/null +++ b/support/tex-converter/update/LaTeX2HTML.init @@ -0,0 +1,6 @@ +# Automatic settings +$DESTDIR = 'c:\l2h\temp'; +$IMAGE_TYPE = 'gif'; + +# User settings +$HTML_VERSION = '3.2,math'; diff --git a/support/tex-converter/update/TeX Converter.ini b/support/tex-converter/update/TeX Converter.ini new file mode 100644 index 0000000000..632121dacd --- /dev/null +++ b/support/tex-converter/update/TeX Converter.ini @@ -0,0 +1,128 @@ +[Paths] +;paths needed by TeX Converter +;change the paths after each= +;to the ones on your PC + +;CD-ROM drive letter to allow conversion on this drive but saves converted file elsewhere +CD-ROM=F + +;folder/directory where you keep most TeX files +TeXDocs=c:\Tex\Docs + +;hevea files are found here +Hevea=c:\Hevea + +;tth.exe is found here +Tth=c:\texmf\miktex\bin + +;texify files are found here +Texify=c:\texify + +;tex4ht files are found here +Tex4ht=c:\TeX4ht + +;delegates.mgk for ImageMagick is found here +imagemagick=c:\ImageMagick-nt\ImageMagick-5.1.1\delegates.mgk + +;gs_init.ps for Ghostscript is found here +gs=c:\Aladdin\gs6.01\lib + +;Htrun for MiKteX batch files kept here +htrunm=c:\TeX4ht\htrun miktex + +;Htrun for SWP batch files kept here +htruns=c:\TeX4ht\htrun swp + +;latex2html main directory containing l2hconf.pm +l2h=c:\l2h + +;perl.exe and perl batch files are found here +perl=c:\l2h\perl\bin + +;netpbm exe files are found here +netpbm=c:\l2h\netpbm\bin + +;alternative editor for text files +Editor= + +[Preferences] +;store settings here +SavePrefs=Yes +RunHTML=Yes +Showinownbrowser=Yes +Close=No +StartupTab=0 +Warning=No +BrowserPos=No +FirstTime=Yes +AllowMultiProcess=No +ScrollPercent=1 +LowRes=False +LongFileName=False + +[Hevea] +IncludeStyle=Yes +OutputType=html +DefaultConfig=hhtml +Version1.05OrLater=No +French=No +Hacha=No +Verbose=None +Fix=No +Code=Byte +Esponja=No + +[HeveaConfigs] +Exclude tcilatex=-e tcilatex.tex,html +hevea=-e tcilatex.tex,html +hhtml=swp.hva xhvbc.hva -e tcilatex.tex,html +seart=swp.hva xhvbc.hva article.hva -e tcilatex.tex,html +sebook=swp.hva xhvbc.hva book.hva -e tcilatex.tex,html +sereport=swp.hva xhvbc.hva book.hva -e tcilatex.tex,html +htext=swp.hva xhvbc.hva -e tcilatex.tex,text + +[Tth] +Italics=Yes +NumberMulti=Yes +Revise=Yes +Inline=Yes + +[Texify] +UseDVI=Yes +ReportDVI=No +UsePDF=Yes +ReportPDF=No +SWPGS=No +Passes=0 + +[TeX4ht] +SWP=No +SaveTo=c:\TeX4ht +RunHTML=Yes +Showinownbrowser=Yes +Close=No +Warning=No +ImagesSubDir=Yes +SubDir=images +Htrun=Yes +Cmdline= +Usepackage= +Htruncommand= +SWPpasses=0 +DOSPause=Yes +Ver2.5=Yes +AdvancedSave=True + +[Latex2HTML] +SaveTo=c:\l2h +Anti-Virus=No +ImageType=GIF +ImageSubDir=Yes +NavLinks=Yes +About=Default +Author=Default +Title=Default +CheckSyntax=Yes +DOSPause=No +Split=0 +Verbosity=0 diff --git a/support/tex-converter/update/Updates.txt b/support/tex-converter/update/Updates.txt new file mode 100644 index 0000000000..701efb3480 --- /dev/null +++ b/support/tex-converter/update/Updates.txt @@ -0,0 +1,15 @@ +You only need files here that are newer than the files you currently +have. + +Just copy the newer unzipped files over the previous versions. + +Convert.bat may have been updated so be sure to use the latest version. + +You may not need the latest version of TeX Converter.ini but if you +do then you will need to: + +either update the program paths using Help / Program Locations + +or retype the paths in TeX Converter.ini + +or copy and paste the paths from a copy of the old version. \ No newline at end of file diff --git a/support/tex-converter/update/Version 2.6 b/support/tex-converter/update/Version 2.6 new file mode 100644 index 0000000000..6529ecdf96 --- /dev/null +++ b/support/tex-converter/update/Version 2.6 @@ -0,0 +1 @@ +This is Tex Converter Version 2.6 \ No newline at end of file diff --git a/support/tex-converter/update/convert.bat b/support/tex-converter/update/convert.bat new file mode 100644 index 0000000000..c69fe1b2c4 --- /dev/null +++ b/support/tex-converter/update/convert.bat @@ -0,0 +1,104 @@ +@echo off +REM Batch file converts TeX file +REM using Hevea, Tth, Texify, pdfLaTeX, LaTeX +REM %1=Program used to convert +REM %2=TeX file +REM %3=Optional pause + +REM ***************************************************** +REM Please don't alter these lines +REM Otherwise TeX Converter may not work properly +REM TeX Converter will be writing text here automatically +set redir=d:\visual~1.0\my\tex\texfor~1\versio~1.5\redir.exe +set progpath=d:\tex\heveaf~1 +set cmdline=-exec xxdate.exe swp.hva dek.hva xhvbc.hva -e tcilatex.tex +set cmdline2= +set code=x +REM ***************************************************** + +goto %1 + +:hevea +REM find ocamlrun.exe +set path=%progpath% +REM find .hva files +set heveadir=%progpath% +echo Running HeVeA%code% ... +%redir% -ea %2.hlog hevea%code%.exe %cmdline% %2 +echo. +if "%cmdline2%"=="no" goto nohacha +echo Running HaChA%code% ... produces index.html + %2???.html +%heveadir%\hacha%code%.exe %cmdline2% %2.html + +:nohacha +echo. +echo Done +set path= +set hevea= +set heveadir= +set cmdline= +set cmdline2= +set code= +goto final + +:tth +set path=%progpath% +echo Running tth ... +%redir% -ea %2.tlog tth.exe %cmdline% -e2 -L%2 <%2.tex >%2.htm +echo . +echo Done +set path= +goto final + +:tex4ht +set opath=%path% +set path=%path%;%progpath%;%htrunpath% +call %cmdline% +%3 +set path=%opath% +set opath= +set delegate_path= +set gs_lib= +set htrunpath= +goto final + +:latex2html +set oldpath=%path% +set path=%path%;%progpath% +echo Starting Latex2HTML ... +call latex2html.bat -init_file=%init% %2 +%3 +set path=%oldpath% +set L2HMODULE= +set gs_lib= +goto final + +:dvi +latex %2 --src-specials +goto final + +:pdf +pdflatex %2 +goto final + +:texify +set opath=%path% +set path=%path%;%progpath% +texify %cmdline% %2.tex +set path=%opath% +set opath= +goto final + +:gspdf +set opath=%path% +set path=%path%;%progpath%;%filepath% +call %cmdline% +set path=%opath% +set opath= +set filepath= +goto final + +:final +set redir= +set progpath= +set cmdline= diff --git a/support/tex-converter/update/licence.txt b/support/tex-converter/update/licence.txt new file mode 100644 index 0000000000..97a47fd71f --- /dev/null +++ b/support/tex-converter/update/licence.txt @@ -0,0 +1,23 @@ +TeX Converter + +Copyright (c) 1999 Steve Mayer + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + diff --git a/support/tex-converter/update/readme.txt b/support/tex-converter/update/readme.txt new file mode 100644 index 0000000000..a7c0dad0ff --- /dev/null +++ b/support/tex-converter/update/readme.txt @@ -0,0 +1,633 @@ +TeX Converter +------------- + +This program is a windows front-end to a number of programs that convert +TeX or Latex files to another format: + +1. HeVeA converts LaTeX files to HTML without using graphics +2. Tth converts (La)TeX files to HTML without using graphics +3. TeX4ht converts (La)TeX files to HTML using GIFS,PNGs or JPEGs +4. LaTeX2HTML converts LaTeX files to HTML using GIFS or PNGs +5. TeXify is part of MiKTeX and converts (La)TeX files to DVI and PDF +6. LaTeX and pdfLaTeX are part of MiKteX and convert LaTeX files to + DVI and PDF respectively + +All these programs run in DOS and require complicated command lines. +The purpose of TeX Converter is to make these programs easy to run. + +It is not necessary to install all these programs. For example HeVea +and Tth can be run without installing MiKteX. The downloaded files +install TeX Converter only. HeVeA, Tth, TeX4ht, LaTeX2HTML, TeXify and +MiKTeX must be downloaded and installed separately. + +The program also converts LaTeX files written by Scientific Notebook +and Scientific Word/Workplace. + +TeX Converter is freeware - see licence.txt +http://www.mayer.dial.pipex.com/tex.htm + +Setup +----- +TeX Converter should work in 32 bit Windows ie Windows 95/98/Me and +NT/2000/XP. + +1. Run the Setup program to install TeX Converter and its various files. + +2. Open TeX Converter.ini and change the paths to match your files. + + Thus if HeVeA is in C:\Hevea then change + + Hevea=D:\TeX\Hevea to Hevea=C:\Hevea + + This is essential if you want TeX Converter to find the relevant + programs. + + There are up to 13 changes you need to make. If you haven't installed + one of the programs leave the path empty. + + If you are using Version 1.4 or later you can get TeX Converter to + write this for you by clicking on the Help tab then choosing + Program Locations. Type in the paths or press the buttons marked ... + You can also use Auto Search to look for the necessary files. + + IMPORTANT + If you update any of the programs that you are using you must update + the program locations, otherwise TeX Converter may be unable to run + some programs or may insist on running an old version if still + present. + Ghostscript, for example, changed its default location for version + 6.01 and then again for 6.50. Alternatively, you may wish to + rationalise your folders. Please let TeX Converter know! + +3. If you are using Win 95/98/Me then: + + Open Windows Explorer. Right-click on Convert.bat and choose + Properties. Click on the Program tab and ensure the 'Close on exit' + box is ticked. + + Click on the Memory tab and in the 'Initial Environment' dropdown box + select 1024. + + Then press OK. + + Note: + These changes will ensure the DOS box opens and closes by itself and + that you don't get 'Out of environment space' messages. If you do + still get such messages, change 1024 to a higher number. Environment + space problems don't happen in NT or Win2000, and NT seems to default + to automatically closing DOS. + +4. Make a shortcut for TeX Converter.exe and put this shortcut in + the SendTo folder. Then you can right-click on a TeX file in + Windows Explorer and choose Send To and Tex Converter and it will + automatically put the file name in the box for you. + + You can also drag and drop files from Windows Explorer to TeX + Converter. + + +That's it. Now you should be able to run TeX Converter. + +Notes +----- +1. HeVeA and Tth are fast programs which run without user intervention. + The error messages flash by too quickly to read, so TeX Converter + doesn't bother to show them and instead saves them in a log file. + To read this file press View Log. + + TeX4ht, LaTex2HTML TeXify, pdfLaTeX all use LaTeX and may need user + input so the messages are put on screen. They still produce a log + which again will be shown by the View Log button. + + There is a Pause after DOS checkbox for Tex4ht and Latex2HTML + (press Adjust Init File to see it) if you want to read DOS messages + before the window closes. + +2. Do install the latest version of LaTeX2HTML - for example from + http://saftsack.fs.uni-bayreuth.de/~latex2ht/current/ + TeX Converter has been tested on version 99.2 beta 6 and there is + no guarantee it will work with previous versions. + There's a good installation guide at + http://feynman.faii.etsii.upm.es/~seidel/l2h/l2h_eng.html + with an updated version at + http://www.mayer.dial.pipex.com/l2h.htm + + Installation problems + --------------------- + Some people have reported problems installing LaTeX2HTML especially + with version 6.01 of Ghostscript. Here are a number of workarounds: + (the error messages in quotes are on the screen and in config.log) + + a. 'checking for gswin32c... no' means that Ghostscript can't be + found. This can happen if the LaTeX2HTML installation is on a + different drive from that of Ghostscript. I would suggest keeping + all the programs (including Perl and Netpbm) on the same drive + + b. 'checking if perl globbing works...' which is followed by the + program stopping or even causing a crash. Turn off any anti-virus + checkers and make the changes to config.bat in d. below + (globbing means understanding wildcards like * and ? in file names) + + c. 'checking for ghostscript version... no + Error: could not determine gs version + Warning: Will not be able to generate images due to above failure' + + This is due to a change in the way Ghostscript version 6.01 reports + its version and other features and the installation code is at + present unable to find the information. Until the code is changed + the following should work: + In config.pl (in \config subdirectory) add after + close(GS); + and before + # Configure things determined by the Ghostscript version + the 2 lines + @gs_devs=qw(pnmraw ppmraw); + $gs_version=6.01; + + d. I have found that a few changes to config.bat can also help + Change the first few lines to (with your correct paths): + + @ECHO OFF + REM this is a DOS batch file + + REM *vital* This is the path to the perl interpreter + set opath=%path% + REM put in the correct paths for perl in the next two lines + set path=%path%;c:\perl\bin;c\perl\lib + set PERL=c:\perl\bin\perl.exe + REM change the following paths if necessary + set gs_lib=c:\aladdin\gs6.01\lib;c:\aladdin\fonts + + REM ------------------------------------------------------------ + ECHO Starting Configuration... + + and at the end of config.bat add + + ECHO Configuration procedure finished + set path=%opath% + set perl= + set gs_lib= + :END + + Finally, if you are using Windows 95, 98 or Me change the + Environment space from Auto to 1024: + In Windows Explorer right-click on Convert.bat then Properties + then Memory tab and in the 'Initial Environment' dropdown box + select 1024. + + It is not necessary to do this in Windows NT or 2000 + +3. TeX Converter supports Philip A Viton's htrun facility for TeX4ht. + You may put htrun.exe and its batch files files in any directory + which will allow you to use both MiKteX and Scientific Workplace + versions. TeX Converter expects to find a copy of htrun.exe in + each directory containing the batch files. + + Please note that htrun's method of putting the options on the + command line rather than in the tex file is now the preferred + way of working. It has a greater range of output possibilities; + indeed working without it may well cease to be supported in the + future. It is strongly advised that you install the relevant files. + + MiKteX files can be found at: + http://facweb.knowlton.ohio-state.edu/pviton/support/tex4ht.html + with the htrun files at: + http://facweb.knowlton.ohio-state.edu/pviton/support/tex4ht-miktex-install.zip + + SWP files can be found at: + http://facweb.knowlton.ohio-state.edu/pviton/support/swpht.html + + Version 2.5 now supports the command line for any non-htrun batch + file while still allowing the option of using of \usepackage. If the + command line is used and htrun not used (and Scientific Workplace not + selected) then the default batch file is htlatex; using \usepackage + defaults to ht latex. SWP users should normally use htrun which has + been specially adapted to their requirements. + + Version 2.5 reads and writes the command line slightly differently, + so if you upgrade from an earlier version TeX Converter will ask you + to check a previous command line in case it has read it wrongly. + +4. TeX Converter also supports Philip A Viton's automated production of + PDF files for Scientific Workplace/Word. Full instructions and the + necessary files are available at: + http://facweb.knowlton.ohio-state.edu/pviton/support/pdfgs.html + + TeX Converter will help you install the files (PDF tab then + Setup batch files). + +5. Advanced Tex4ht users may wish to alter the command line to test + ideas or to use new options which haven't yet been supported by TeX + Converter. To do this, just before pressing the Convert button, click + on the textbox containing the words Command line: then Press the Esc + key. The key is a toggle so pressing the Esc key again turns off this + feature. Do note that changes to the command line should be made after + all the options have been selected, otherwise the changes will be + lost. + + From Version 2.6.6 you can double-click as an alternative to pressing + Esc. + + If you use code fragments regularly then from version 2.6.11 TeX + Converter will show them in a dropdown box when you press Esc. When you + click on an entry in the box the code fragment will be placed in the + command line at the cursor position. Put the code fragments (one fragment + per line) into a file called codefragments.txt saved in the TeX Converter + directory. + +6. Tex4ht has an extensive language which allows the user to configure + the resulting HTML. This is achieved by using document-level + configuration files - for details see + http://facweb.knowlton.ohio-state.edu/pviton/support/swpht.html + 'Advanced Use of TeX4ht', 'Configuring TeX4ht's HTML' + and the material on myconfig.cfg in that section. + + TeX Converter offers an easy way to use a configuration file by using + its own configuration file tcconfig.cfg. This is accessed via the Edit + tcconfig.cfg button in the Advanced window. + + Use tcconfig.cfg to insert modifications that are to be available to + all documents. The default code in this file will also then enable any + document-level configuration files you may wish to use (these have the + same name as the tex file but with extension .cfg or .cfh). + + There is online help for the Tex4ht code at + http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn2.html + + You can ask TeX Converter to generate an up-to-date manual called + Tex4htCode.txt. This is done by applying Tex4ht to a small tex file. + +7. When using LaTeX2HTML or Tex4ht tex files are copied to a destination + directory before any conversion. This allows TeX Converter to make + any required changes to a copy of the tex file whilst leaving the + original untouched. + + TeX Converter then changes the current directory to the new directory + and copies files referenced in \input and \include commands to that + directory. Normally, class files and packages are kept in a texmf + tree where Latex can find them, but it is possible to keep special + versions in the same directory as the tex file, and these will then be + used. TeX Converter will attempt to copy any such class files + referenced in \documentclass but you may need to copy other files + manually to the destination directory so that Latex can find them. + +8. From version 2.6.0 onwards you can easily check for updates by + pressing the Update Check button on the Help tab. Updates shouldn't + be required unless a required feature has been added or a there is + a bug. + + The updating mesage will open in the external or internal browser + as chosen on the first four tabs. + +9. Older versions of TeX Converter accommodated use of an images + subdirectory for tex4ht graphics by post-processing the html files. + From version 2.6.6 onwards you can get Tex4ht itself to produce the + references, which is more efficient. + + TeX Converter will add the command imgdir:images/ and Tex4ht will + create the correct paths. However, for this to work you may need + to update your tex4ht files. Look for *.4ht dated 31st August 2002 + or later in the 'alternative zipped' files on Tex4ht's Bug Fixes and + Comments page at + http://www.cis.ohio-state.edu/~gurari/TeX4ht/bugfixes.html + + If you have an earlier version of Tex4ht then it will ignore the + new command and TeX Converter will post-process the files for you. + + In other words, TeX Converter will use the best method for creating + the html files without any need for action by the user. + +10. TeX Converter now supports the mouseover option. For details on this + see Updates (25 July 2002) at + http://facweb.knowlton.ohio-state.edu/pviton/support/swpht.html + which will explain how SWP can use this option. + + Miktex users will also require updated tex4ht files dated + 24 July 2002 or later obtainable from + http://www.cis.ohio-state.edu/~gurari/TeX4ht/bugfixes.html + + In addition Miktex users will also require xhtex.bat: + + If you use htrun (highly recommended) then look for a file + called xhtexm.bat (which may be inside xhtml.zip) and make + a copy called xhtex.bat and save it in your htrun directory. + + If you don't use htrun or cannot find this file then + download it from + http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn-scripts.html + Look for xhtex.bat in the MS Bitmap Math column and save it + in your Tex4ht directory - changing the name of the downloaded + file from xhtex-bat.txt to xhtex.bat. + + +Possible Problems +----------------- +1. Try not to bury your programs or TeX files too deep in the directory + structure. It can cause problems where TeX Converter has to send + long commands to DOS. You can be warned of this by checking the + 'Warn if command line is too long' in TeX Converter's Help. + +2. Try not to use long file or directory names. These are shortened by + DOS which puts a ~ in the filename/directory. TeX Converter gets + over this by offering to swap ~ to _. However, as a general rule + stick to short file names in short directories with no spaces so + that the DOS names are the same. + If you do wish to try using a long file name for the tex file then + you can choose this option on the Help tab, More.... Please do be + aware that many TeX related programs do not support long file names + and may not work properly, and may give hard to find errors. + +3. You will be able to convert files on a CD-ROM because, if necessary, + TeX Converter will offer to copy them onto a hard drive first. + +4. TeX Converter can use its own Web Browser to view HTML files. + This is based on Internet Explorer so is unlikely to work + if you don't have IE installed. If it doesn't work click on + 'Use External Browser' and it will then use the default browser + installed on your system. + +5. If you have installed Tex4ht for MiKteX and do not wish to use + htrun (though this is now the preferred option) or htlatex.bat then + ensure there is a file called ht.bat in the Tex4ht directory with the + entries + %1 %2.tex + %1 %2.tex + %1 %2.tex + tex4ht %2 + t4ht %2 + If not, create ht.bat or alter the similar ht.tab + +6. There appears to be a clash between LaTex2HTML and anti-virus software + such as Norton or McAfee. If you have trouble installing or running + LaTeX2HTML try deactivating the anti-virus checker. TeX Converter + will, if you wish, remind you to do this every time you run + LaTeX2HTML. + +7. Allowing multiple conversions (checkbox on Help tab) lets you process + more than one tex file at a time, which is particularly useful for + TeX4ht and LateX2HTML as these programs can require a long period in + which to produce pictures. If you turn on this facility it is + possible that you will get strange effects. If so, then turn it off, + or put AllowMultiProcess=No in the [Preferences] section of + TeX Converter.ini. + +8. If you click on a link and find the URL has changed, then you can + update the URL by right-clicking on the link. The new URL will then + be saved. + +9. If you use a low screen resolution or large fonts you may find that + some of the windows don't fit onto your screen or that some buttons + are off-screen. You may scroll these windows by pressing Alt+arrow + key. The amount of scroll for each key press can be changed by + clicking on the More... button on the Help tab. + You can also try checking the "Move buttons I can't see box" + [If a number of users tell me there is still a problem I could + redesign the windows but there is so much information to fit on them, + which could mean using multiple tabs or windows which is not very + friendly either.] + +Please keep me informed of any bugs. There are bound to be problems +especially as it has been tested on a limited number of PCs. + +Thanks +------ +Philip A Viton for lots and lots of help especially with Hevea and Tex4ht +Thomas Wilson for helping to sort out long name problems in NT +Alain Braun for lots of user interface suggestions +Eitan Gurari for encouragement and help in developing advanced Tex4ht +support +Sebastian Paris for suggesting frames and tcconfig configuration window +for Tex4ht + +and everyone else, all of whom have given their help freely. + + +Revisions +--------- +Version 2.6 +2.6.16 +- Added licence +2.6.15 +- Tex4ht: Default always mean 3 passes +- Debug browser focus change +2.6.14 +- Ensure external editors can cope with long file names +- Option to allow non-tex files to be converted (eg Tex4ht and .ltx files) +- Tex4ht: debug showing of html vs xml output +- Tex4ht: allow absolute graphics paths in SWP files +2.6.13 +- Update links to Philip Viton's web pages +2.6.12 +- Ensure scrollwheel works in browser without needing to click first +2.6.11 +- Internal browser now copes with JavaScript focus changes +- Allow for separate alternative editors for text and tex files +- Stop Numlock being turned off in More Preferences +- Tex4ht: Add dropdown box for code fragments +- Tex4ht: Stop XHTML options being saved when Save options on exit + is not checked +- Tex4ht: removed bug when copying graphics file in SWP's \Frame and with + \framebox generally +2.6.10 +- Correct for XP's version of SendTo plus other minor bugs +2.6.9 +- Tex4ht: Added MathPlayer option +2.6.8 +- Tex4ht: Removal of delete custom code bug +2.6.7 +- Tex4ht: Correction of bug that creates images subdirectory with + overlib.js when not requested +2.6.6 +- Tex4ht: Added support for tex4ht to create images subdirectory + references in the HTML files. +- Tex4ht: Added double-click option to use manual command line +- Tex4ht: Added option to save advanced settings +- Tex4ht: Clear out unwanted files in output directory +- Tex4ht: Added support for mouseover (using overlib.js) +2.6.4 +- PDF: Added check for Windows XP in Setup batch files +2.6.3 +- Update: Minor change to show correct revisions from current version +2.6.2 +- Tex4ht: Copy correctly tcconfig files for XHTML +2.6.0 +- Added update check on Help tab + +Version 2.5 +- PDF: Added 0 passes option for SWP + Ghostscript +- Tex4ht & Latex2html: Added copying of \documentclass file kept in the + tex file directory to the destination directory +- Added revision file number and file date & time to help tab +- Hevea: Added support for Esponja the HTML optimizer in version 1.06 +- Hevea: Added support for Philip Viton's byte/native code +- Tex4ht: Remove bug stopping use of other batch files +- Tex4ht: Copy foo.bbl and mydoc.* files to destination directory +- Tex4ht: Workaround for SWP grahics+babel-french problem +- Tex4ht: Allow htrun to work with \usepackage +- Tex4ht: Substantial changes in the code to allow for command line and + \usepackage options for any non-htrun batch files. htlatex and + ht latex (and xht for SWP) are now the respective defaults + +Version 2.4 +- Tex4ht: Fixed bug which could make mangled copy of tcilatex.tex +- Tex4ht: Fixed bug where SWP graphics were not being copied to correct + directory +- Tex4ht: Added option for aligned equations in amsmath +- Fixed Windows NT/2000 crash in Auto Search for non-Administrator mode +- Tex4ht: Added options for glyph image type +- Tex4ht: Added append footnote option +- Hevea: Added -fix option + +Version 2.3 +- Tex4ht: Force use of / instead of \ for image subdirectory +- Tex4ht: Give indication of progress in processing html files +- Tex4ht: Eliminate double insertion of text in copied tex file +- Tex4ht; Adds number of latex passes if allowed in miktex htrun.ini +- Tex4ht: Subdocuments are now copied correctly +- DVI: Removed erroneous reference to pdfLatex +- PDF: Added refresh for printers list in setup batch files +- Tex4ht: Added support for subsubdocuments +- Tex4ht: Fixed error referencing included files +- Tex4ht: Added support for htlatex and any non-htrun batch file +- Added long file name support for tex files +- Added new More Preferences form +- Added scrolling of forms and option to move off-screen buttons for low + screen resolutions or large system fonts +- Added facility to change URL of links +- Tex4ht: Repaired broken link to tex4ht manual +- Tth: Removed extraneous -L from command line +- Tex4ht: Fixed error where not all graphics files were copied to + destination folder +- PDF: Added automatic setup for batch files +- PDF: Updated support for changed pdfmakegstc.bat file +- Tex4ht: Added facility for saving and loading of configuration code + fragments +- Tex4ht: Added edit window for tcconfig configuration file + +Version 2.2 +- Tex4ht: Removed unnecessary frames number +- Latex2html: Save split depth and verbosity to ini file +- Tex4ht: Added support for subdocuments +- Tex4ht: Added support for frames +- Tex4ht: Allow manual editing of command line for advanced users +- Tth: Update check for @hour etc +- Tex4ht and Latex2html: Save Pause after DOS option to ini file +- Tth: Update command line to work with newer versions +- Latex2html: Show new link for installation help +- Eliminated bug when pressing OK on program locations +- PDF: Added support for Philip Viton's automated PDF from + Scientific Workplace + +Version 2.1 +- Latex2html: Extra help in readme.txt for installation +- Reorganised this readme.txt so that the most recent revision is in the + logical place ie at the top +- Latex2html: Link on help page to mirror site during August 2000 only +- Tex4ht: Save number of SWP latex passes to ini file +- Tex4ht and Hevea: Serial conversion of tex files - allow option to + change links referencing tex files to links referencing html files +- Tex4ht: Support Philip Viton's conversion of graphics. Files such as + graphics or config files are copied to the required directories +- Tex4ht and Latex2HTML: Copy graphics like snapshots to images + directory +- Tex4ht and Latex2HTML: Look for gs_init.ps rather than gswin32c.exe + which takes account of new folders for Ghostscript 6.01 but still + works for version 5.50. +- Tex4ht: Allow long file names for SWP +- Hevea: Updated link for Hevea 1.05 +- Tex4ht: Better monitoring in of \package in tex file +- Tex4ht: Support new switch name for htrun +- Tex4ht: Allow user to choose batch file to run +- Tex4ht: Show command line +- Tex4ht: Added support for alternative htrun switches +- Tex4ht: Ensured browser loads xml files (even though IE can't read + them!) +- Tex4ht: Added support for htrun using command line options + and supporting new output formats xhtml, mathml, mozilla +- All programs: Added multiple conversions +- Tex4ht: Corrected labels not showing text properly (thanks to Philip) +- Tex4ht: Added advanced options for sectioning, xhtml, jpgs etc +- Tex4ht: Added support for Philip A Viton's htrun files + +Version 2.0 +- Ensured Latex2html saves html files in correct directory +- Added pause option to Tex4ht +- Document path problem in Latex2html sorted out +- Ensured that hacha uses correct paths, only one version of TeX + Converter runs, default editor used for files, edit tex file button + added, choice of text editor (again thanks to Alain Braun). +- Added Hacha support to Hevea (thanks to Alain Braun for his ideas and + help). +- Added Latex2html.init file to download ($HTML_VERSION = '3.2,math') +- Made images subdirectory Netscape friendly (using / not \) +- Changed misleading text in Program Locations browser windows +- Added options to Hevea for French mode and verbosity (for debugging) +- Prevent crash if filename is used for path in Program Locations +- Minor bugs dealt with +- Removed restrictions on settings (may be overwritten by l2h) +- L2h Init Form - added scroll bars and pause option +- Ensured Reload INI used newly saved version of file +- Squashed startup tab bug +- Added support for LaTeX2HTML + +Version 1.4 +- Allow change of start-up configuration on Load Configuration form +- Changed names of Hevea and Tth log files to give name of TeX file + that has been converted. Needs new version of convert.bat so version + checked on start +- Added converted tex files history list +- Enable DVI options disabled in error +- Eliminated bug in altering tex4ht html file for images subdirectory +- Added Auto Search option to find program paths +- Added Program Locations button to allow easier entry of paths + +Version 1.3 +- Added Hevea configurations to INI file +- Ensure filename is at top of Tth log for all versions of Tth +- Added option to store Tex4ht image files in separate subdirectory +- Added facility to change subdirectory where Tex4ht files are stored +- Added tooltips to links +- Added links to Philip A Viton's tutorials +- Tex4ht can choose to use Scientific Workplace's TrueTeX compiler + +Version 1.2 +- More bugs squashed including Windows NT not finding convert.bat +- Eliminated (I hope!) bug causing Run Time Error 52: Bad File Name or + Number message and crash +- Use user-defined path for tth.exe (so not dependent on installation + of MiKteX) +- Allow inline graphics in Tth +- Correct bug in log file path +- Allow long file names for tex files when using Hevea or Tth +- Allow programs to be stored in directories with long file names +- Less confusing scrolling of styles box when using arrows +- Correct showing of styles in load configuration form +- Check for version of Hevea and run xxdate.exe for version 1.05 +- Allow delete configurations in Load Configuration +- Corrected error where TeX Converter wouldn't load Include Style setting +- stop adding blank lines to end of convert.bat +- If configuration is empty then Save Configuration deletes unwanted + configurations +- Use default configuration at start-up +- Resolve errors in Load Configuration +- Hevea now saves html files to tex doc directory with .html extension + and Tth now uses .htm, so as to be compatible with forthcoming version + of Hevea for Scientific Workplace/Word +- Add drag facility to styles list +- Warn if Hevea or Tth give more than 50 bytes of errors +- Allow option to save browser position independently of Save Preferences + +Version 1.1 +- TeX Converter now writes directly to convert.bat to avoid long + command lines +- Ini file minor changes +- Reload ini option +- Larger form to cope with new options +- More extensive Hevea options allowing multiple use of style files, + excluded file, saveable configurations and text/info output. Thanks + to Philip A Viton for all his help. +- A few small bugs swatted eg now reads imagemagick, ghostscript paths + +Steve Mayer 12th August 2004 + +(c) Steve Mayer 1999 \ No newline at end of file -- cgit v1.2.3