Tweaks to HTML generation options and documentation.

Signed-off-by: Daira Hopwood <daira@jacaranda.org>
This commit is contained in:
Daira Hopwood 2018-03-24 09:11:18 +00:00
parent c3fae92bb4
commit cfa437b3e8
2 changed files with 23 additions and 4 deletions

View File

@ -13,9 +13,10 @@ pdf:
mv -f aux/protocol.pdf . mv -f aux/protocol.pdf .
.PHONY: html .PHONY: html
html: pdf sapling html: protocol.pdf sapling.pdf
pdf2htmlEX --decompose-ligature 1 --font-size-multiplier 60 --split-pages 1 --dest-dir html protocol.pdf # Can't use --split-pages 1 because XHR doesn't work by default on local files in Chrome.
pdf2htmlEX --decompose-ligature 1 --font-size-multiplier 60 --split-pages 1 --dest-dir saplinghtml sapling.pdf pdf2htmlEX --decompose-ligature 1 --font-size-multiplier 65 --fit-width 1000 --dest-dir html protocol.pdf
pdf2htmlEX --decompose-ligature 1 --font-size-multiplier 65 --fit-width 1000 --dest-dir html sapling.pdf
.PHONY: pvcpdf .PHONY: pvcpdf
pvcpdf: pvcpdf:
@ -65,7 +66,7 @@ nolatexmk-sapling:
.PHONY: clean .PHONY: clean
clean: clean:
rm -f aux/* protocol.ver \ rm -f aux/* html/* protocol.ver \
protocol.dvi protocol.pdf protocol.bbl protocol.blg protocol.brf protocol.toc \ protocol.dvi protocol.pdf protocol.bbl protocol.blg protocol.brf protocol.toc \
protocol.aux protocol.out protocol.log protocol.bcf protocol.run.xml protocol.fls protocol.fdb_latexmk \ protocol.aux protocol.out protocol.log protocol.bcf protocol.run.xml protocol.fls protocol.fdb_latexmk \
sapling.dvi sapling.pdf sapling.bbl sapling.blg sapling.brf sapling.toc \ sapling.dvi sapling.pdf sapling.bbl sapling.blg sapling.brf sapling.toc \

View File

@ -46,3 +46,21 @@ to optimize just ``protocol.pdf`` or ``sapling.pdf`` respectively.
This gives a size saving of about 50% for ``protocol.pdf``, and This gives a size saving of about 50% for ``protocol.pdf``, and
40% for ``sapling.pdf``. 40% for ``sapling.pdf``.
Converting to HTML
------------------
To convert to HTML you will first need to install ``pdf2htmlEX``. On Debian:
.. code::
apt-get install pdf2htmlex
Then use ``make html`` (or ``make optimized html``) to convert both PDFs.
The results are placed in the ``html`` directory at ``html/protocol.html``
and ``html/sapling.html``.
See `<https://github.com/zcash/zips/issues/127>`_ for limitations of
this conversion.