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.
39 lines
1.7 KiB
39 lines
1.7 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 Ubuntu Linux:
|
|
- gpp (apt install gpp)
|
|
- Pandoc (apt install pandoc)
|
|
- TexLive (apt install texlive texlive-luatex texlive-fonts-extra)
|
|
|
|
Required for MacOS:
|
|
- gpp (brew install gpp)
|
|
- pandoc (brew install pandoc)
|
|
- TexLive (brew install texlive)
|
|
- Roboto Font (brew install --cask font-roboto)
|
|
|
|
The source directory for the documentation is /Source/Doc. From this
|
|
directory run "Build.cmd" on Windows or "make" on Linux/Mac to create
|
|
the output documents. This will create the final documents and copy
|
|
them to their destination directories.
|