summaryrefslogtreecommitdiff
path: root/support/tex-converter
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/tex-converter
Initial commit
Diffstat (limited to 'support/tex-converter')
-rw-r--r--support/tex-converter/README633
-rw-r--r--support/tex-converter/Version 2.61
-rw-r--r--support/tex-converter/licence.txt23
-rw-r--r--support/tex-converter/update/CustomCode.txt25
-rw-r--r--support/tex-converter/update/LaTeX2HTML.init6
-rw-r--r--support/tex-converter/update/TeX Converter.ini128
-rw-r--r--support/tex-converter/update/Updates.txt15
-rw-r--r--support/tex-converter/update/Version 2.61
-rw-r--r--support/tex-converter/update/convert.bat104
-rw-r--r--support/tex-converter/update/licence.txt23
-rw-r--r--support/tex-converter/update/readme.txt633
11 files changed, 1592 insertions, 0 deletions
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 <mayer@dial.pipex.com> 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{<META NAME="description" CONTENT="This is an example">}
+
+[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 <mayer@dial.pipex.com> 12th August 2004
+
+(c) Steve Mayer 1999 \ No newline at end of file