Example manuscript using a model-based approach
A PDF document of the example manuscript generated from this repo's continuous deployment (CD) pipeline is available at https://odu-cga-cubesat.github.io/manuscript-example/manuscript-example.pdf
You will need git to clone the project contents and podman to run the podman images that contain the dependencies needed for generating a PDF document of the example manuscript locally.
Alternatively, you can run the following instructions inside the sealion-workspace-image.
Note: It is recommended you run the following instructions on a Linux/Unix-like operating system. If you are on a Windows machine, consider installing Windows Subsystem for Linux.
Clone the manuscript-example repo. This will create a local copy of the repo on your local machine. Don't forget to use --recurse-submodules
flag, or else you won't pull down some of the code you need to generate a PDF document of the example manuscript.
git clone --recurse-submodules https://github.com/ODU-CGA-CubeSat/manuscript-example.git
Note: If you accidentally cloned without using --recurse-submodules
, you can run git submodule update --init --recursive
to pull down submodules needed to generate a working manuscript.
Once you've cloned the repo, you'll need to change directory into the repo you just cloned, using the cd
command:
cd manuscript-example
Once you've installed requirements and cloned the repo, run the buildDocs.sh
script in the project root directory. This will validate the manuscript-example.yaml
against the schema defined in the manuscript-schema/
directory, then generate a PDF document of the example manuscript in the dist/
directory using the Jinja2 templates and LaTeX/BibTeX typesetters/formatters defined in manuscript-templates/
.
./buildDocs.sh
Code for this work is licensed under an MIT License
Content for this work is licensed under a Creative Commons Attribution 4.0 International License