search

DominikPeters / tikz.dev-issues

Feedback, suggestions, and bug reports for tikz.dev
1 stars 0 forks source link

home vs index vs index-0 #23

Closed SwitWu closed 8 months ago

SwitWu commented 9 months ago

I'm reading the code in postprocess.py and I get confused with three files:

Since it has been set HomeHTMLFilename=home, the home page file should be home.html. Where do the other two html files come from?

DominikPeters commented 9 months ago

Hi! I didn't really write postprocessing.py to be readable by others, but you are welcome to try :)

In pgfmanual.tex, I do \usepackage[latexmk,mathjax,HomeHTMLFilename=home]{lwarp}, which sets the lwarp start page as home.html. This is generated during compilation, but it only contains a table of content. This file is discarded during postprocessing.

The actual start page is the introduction chapter (pgfmanual-en-introduction.tex), which is named index when I write \section[index]{Introduction}. Presumably index has a special meaning within lwarp, and so it actually gets generated as index-0.html. Postprocessing then renames that file to index.html.

SwitWu commented 9 months ago

Thanks! Your explanation is very helpful.

I’m doing a project called beamer-html-manual based on your great work. So I have to understand most of the details in your code.