mirror of https://github.com/wwarthen/RomWBW.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
33 lines
1.6 KiB
33 lines
1.6 KiB
***********************************************************************
|
|
*** ***
|
|
*** R o m W B W ***
|
|
*** ***
|
|
*** Z80/Z180 System Software ***
|
|
*** ***
|
|
***********************************************************************
|
|
|
|
This document describes the process to build the custom documentation
|
|
for RomWBW. The RomWBW documentation is not normally built as part of
|
|
the full build process. This is because it requires external tools
|
|
to be installed.
|
|
|
|
All source documents are first pre-processed with gpp to allow use of
|
|
some global variable expansions. Pandoc is then used to generate a
|
|
variety of output formats. The most significant of these are the PDF
|
|
documents. Pandoc invokes a Latex-type processor (LuaTeX) to
|
|
produce the final PDF documents.
|
|
|
|
Required for Windows:
|
|
- Pandoc (https://pandoc.org/)
|
|
- MiKTeX (https://miktex.org/)
|
|
- Install Roboto font from MiKTeX Console
|
|
|
|
Required for Linux:
|
|
- gpp ((apt install gpp)
|
|
- Pandoc (dpkg -i pandoc-3.1.8-1-amd64.deb)
|
|
- TexLive (apt install texlive-latex-extra texlive-luatex fonts-roboto texlive-fonts-extra)
|
|
|
|
The source directory for the documentation is .../Source/Doc. From this
|
|
directory run Build.cmd for Windows or make for Linux to create the
|
|
output documents. This will create the final documents and copy them
|
|
to their destination directories.
|