search

michal-h21 / make4ht

Build system for tex4ht
137 stars 15 forks source link

Question: How to browse 4ht files in source repository #70

Closed ThiloteE closed 2 years ago

ThiloteE commented 2 years ago

When browsing the source repository of make4ht, the website does not show .4ht files. What can I do to have a look at them and download the newest version of these files?

ThiloteE commented 2 years ago

To be honest, I am so confused. Do I understand this right? The flow of development is this:

  1. Test and change files in source repository
  2. If it works, upload it to github
  3. If github works, push it to miktex/texlive/ctan

???

michal-h21 commented 2 years ago

No, .4ht files are not part of make4ht, they come form TeX4ht. The source files are literate programming TeX files, from which .4ht files are created. They are here. The most important source file is tex4ht-4ht.tex, it is source for all .4ht files for packages. Other TeX files contain configurations for output format, so tex4ht-html4.tex contains configurations for HTML, tex4ht-oofffice.tex for the ODT output, etc.

The literate programming system is described a bit here: https://www.kodymirus.cz/tex4ht-doc/ForDevelopers.html

So the process is :

  1. copy relevant generated .4ht files to a directory with a test file
  2. debug code
  3. add changes to the literate TeX sources and update it to SVN
  4. Karl Berry watches SVN, and when it changes, he generates .4ht files and pushes it directly to TeX Live. CTAN is not updated at all. MikTeX pulls changes from TeX Live.
michal-h21 commented 2 years ago

Here is also the ChangeLog: https://tug.org/tex4ht/changelog.html

ThiloteE commented 2 years ago

Thanks!