This repository is for manage PATRIC static contents such as Website Tutorial, CLI Tutorial, User Guides, and PATRIC eNews. See here for configuration.
After following the Sphinx/Nginx Setup Guide make sure your local Nginx server is running.
sudo nginx
And enter your password. You'll need to turn this on everytime you restart your computer unless you have it set to start automatically.
- Create a folder. If you don't have image associated, then you can ommit the images folder.
mkdir -p tutorial/excel_formatting/images/
-
Make a markdown or ReST (ReStructuredText) format file
-
Place images under
./imagessub folder -
If you have a file attachment to link, place the file in the '_static' directory, and reference it from there. (Sphinx will ignore attachment files such as .PDF, .XLSX, etc)
-
Add a link in the category index file (e.g.
tutorial/index.rst) -
build html
$ make html
Note: You may need to completely clear your previously built docs application to see new changes made. You can run this command to delete and rebuild from within the docroot directory.
rm -rf _build && make html
In order to generate feed RSS, you need to write the news entries in rst format. Check a sample entry here
- Follow the instruction for creating a file & linking
- For news entries, you need to add a code block like below,
.. feed-entry::
:date: 2017-09-30
Add description (a line or two) regarding the news item here. This will show up in the home page.
.. cut::
- When you build html,
news.rsswill be updated.
We write our documentation pages in both Markdown (.md) and reStructuredText (.rst). Sphinx uses the CommonMark version of Markdown when it builds the documentation site. It is slightly different than the GitHub Flavored MarkDown used by GitHub so make sure to take note of any subtle differences. Use these resources to write and develop documentation for PATRIC without causing warnings or failures. There is only one flavor of reStructuredText.