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.

20 lines
868 B

  1. # Building Manual.
  2. The manual PDF file is generated by concatenating relevant markdown files and by transforming the result using Gimli to obtain the final PDF file. This steps are handled automatically by the ```build_docs.sh``` script located in the root of the repository next to the Makefile.
  3. ## Requirements & Installation
  4. The PDF manual generation uses the Gimli for the conversion. It can be installed via ruby gems. On Debian based systems the installation steps are:
  5. ```bash
  6. sudo apt-get install ruby1.9.1 ruby1.9.1-dev rubygems zlib1g-dev wkhtmltopdf libxml2-dev libxslt-dev
  7. sudo gem1.9.1 install gimli
  8. ```
  9. ## Configuration
  10. All markdown files need to be registered in the ```build_manual.sh``` file individually by modifying the ```doc_files``` variable / array:
  11. ```bash
  12. doc_files=( 'Configuration.md'
  13. 'Board - SPRACINGF3.md'
  14. '...'
  15. '...'
  16. )
  17. ```