You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This patch add some scripts which are meant to generate html files
successfully using `make4ht`. The target is to build a directory
html/ for github page deployment usuage.
Problems :
When you try using `make4ht -suf html5 -d html lkmpg.tex` to parse the
file, you'll find out that make4ht has several defectors:
1. The layout is unsatisfying
2. When it parsing lkmpg.tex and meet \tableofcontents will throw error
3. It generated a lot unneeded files when parsing lkmpg.tex
4. The output filenames are based on input filename and you can't assign
them, which is inconvinient cause github page will only recognize the
file named `index.html`.
Solutions :
For problem 1, we can write a config file `html.cfg` to specify the
layout style of lkmpg.html with css selectors.
For problem 2, we can turn off the \tableofcontents section when
using make4ht. However, this cause the output html files without
table of contents part. And we can fix this by adding
`\Configure{tableofcontents*}{chapter,section,subsection}` into
html.cfg so the output html files will contain table of contents again.
For problem 3, we can add some delete commands into Makefile.
For problem 4, we can add a symbolic link `index.html` lined to
`lkmpg.html`
Overview of file changes :
In html.cfg :
Specify the layout of lkmpg.html.
Add tables of contents.
In Makefile :
Add a new target `html` for generating html files and put them in html/
directory.
Add a symbolic link `index.html` linked to `lkmpg.html`.
Add several `rm` command to get rid of unneeded files.
In lkmpg.tex :
Turn off the \tableofcontens section when using `make4ht` to prevent
from error.
0 commit comments