This is the repository behind the SSL web site at Loyola University Chicago.
Our site uses the Sphinx backend and generates automatically per commit with [Travis CI].
In addition, we release PDF and EPUB versions of the site per commit as well.
-
The Sphinx docs is not the best source out there for all of the features that ReStructuredText has to offer. Please reference the documents listed under Documentation Links for more information.
-
Use the Black code formatter. This does nothing but make Python code look pretty.
-
Become familiar with the Travis CI docs and Travis-Sphinx docs when writing
.travis.ymlfiles. More often than not, Travis CI and Travis-Sphinx will be the cause of most of your issues. -
Write templates for all of the TYPES of webpages that are being created and keep them organized.