27 lines
1.4 KiB
Markdown
27 lines
1.4 KiB
Markdown
# How to Make Zines with LaTeX
|
|
|
|
This is a demo of how to make a zine using Pandoc to convert marktown to LaTeX. To learn more about what it does and how it works, build the zine! (Or read the zine source ([doc.md](doc.md))
|
|
|
|
To build the zine: Run `./build.sh`
|
|
|
|
_On Windows: Uninstall Windows. Install Linux. Run `./build.sh`_
|
|
|
|
|
|
|
|
Note: you will have to install some version of tex-live. If space is not an issue you should install the full version. However I was able to get away with installing the barebones version and a few collections (namely, latex, latexextra, latexrecommended, pictures, fontsextra, fontsrecommended) and have had no issues.
|
|
|
|
## website
|
|
|
|
It also generates a standalone website. To view the website:
|
|
|
|
./html-build.sh
|
|
cd public
|
|
python3 -m http.server
|
|
|
|
### some notes on HTML
|
|
|
|
Usually I like to convert Pandoc documents as fragments and add my own document structure, to cut down on the messy markup Pandoc adds. For HTML in particular I like to see how little I can get away with by using [classless CSS](https://github.com/dbohdan/classless-css) for the style. However in this case I combined the two because Pandoc applies classes to each code token (i.e., it applies syntax highlighting) and there's no way to do this without Pandoc's preamble.
|
|
|
|
- [ ] TODO figure out how to extract the syntax highlighting from Pandoc's HTML template
|
|
- [ ] TODO figure out how to prevent image from floating
|