PGHRT

This is the source code, just in case you wanted to build it yourself for some reason. Or difference tracking line edits. I should've had this originally, but I didn't, sooooo don't worry about it too much. The edits are for posterity more than they are "crucial info that everyone should look at" generally speaking, especially because it's intended to be a resource that is iterated upon and reviewed over time.

Translations

If you are interested in doing a translation or some sort of alternate version, please get in touch! A number of languages are already in the works, but the more the merrier.

Localizing instructions: a copy of the /trans/en/pghrt_en.tex file should be edited in place, named after the ISO 639 language code for the target language. You can (or I can help you) use the babel package if necessary, but keep in mind that the typesetting priority is the HTML webpage rather than the PDF which has differing goals and limitations. You can skip the "Changelog" section (ideally these are language specific) and add clear translator notes wherever it seems appropriate (i.e., explaining particular phrases or providing relevant local information). Additionally, leave LANGUAGE-CODE-DOT-PGHRT-DOT-DIY and PDF_LINK as they are beacuse those are automatically handled via soup.py.

The /trans/en/spices_en.csv file will also need to be updated to localize parts of the webpage, as will /export/img/cover_en.png (the font is Segoe UI if you'd like to do it yourself, or just tell me the phrase and I'll do it). Look to German in /trans/de/ for an example. Talk to me as you need then submit a Pull Request adding the folder (or I can do it if you don't have a GitHub account). No need to worry about the build process to produce the HTML or PDF files; I have that part covered.

Language Statuses

Desired languages: Korean (inexplicably a lot of traffic from SK), anything someone is interested in doing (never hurts!)

Current list of WIP languages: Polish, Czech, Norweigan, Spanish, Dutch, Indonesian, Ukranian, Russian (tentatively, after Ukranian), Danish (tentatively), Chinese (Simplified; maybe later Traditional), Portuguese (European), Portuguese (Brazilian)

Completed languages: English (obviously!), German, French

Setting Up

This project is reliant on LaTeXML and owes deep gratitute for its existence. Install it here, and please support it if you can!

You might also need to install texlive-latex-extra with your package manager of choice, or specific missing packages through MiKTeX if you prefer a lighter weight LaTeX installation. This project was created using Visual Studio Code so /.vscode/ is included for your convenience for the build task in tasks.json.

Linux

cd pghrt
python3 -m venv .venv
.venv/bin/pip install beautifulsoup4

Windows

cd pghrt
python -m venv .venv
.venv/scripts/pip install beautifulsoup4

Build Instructions

Currently, /export/ contains the build output for the HTML files whereas /pdfs/ contains the PDFs. To compile and build the source yourself, run the build_all.ps1 file. You can select a language or build all of them. Assuming you have all the dependencies, there should be nothing else needed. The process for each language is making the PDF (then cleaning the auxillary files), making the HTML, then altering the HTML.

Please note that the \DTMNow error and the No graphical source found warnings in the output of latexmlc should be ignored as they are handled by soup.py. There will also be a compile error unless the Python 3 package BeautifulSoup version 4.14+ is installed. soup.py manages the HTML post-processing and localization for each language according to the ISO 639 language code (LC) using the constitute spices_[LC].csv components in /trans/[LC]/.

License

I don't know. Please attribute credit when it is safe and reasonable to do so. Please feel free to use any of this as a template (if you'd like to rip the guts of the .tex out) if it aids you in writing your own document about transition. We need more quality resources out there.