2.4 KiB
SWG Source Documentation
This repository houses the documentation for SWG Source. The documentation is built using Sphinx and rendered via ReadTheDocs. The browsable documentation is available at docs.swgsource.com which is an alias to the ReadTheDocs swgsource.readthedocs.io site.
Structure and Syntax
Every page in the documentation is housed inside the docs directory. Documentation pages are written using the plain text markup language reStructuredText (the .rst files). Please refer to the link for syntax information and replicate the existing structural use of subdirectories and flow if authoring any pages.
Editing or Contributing
To contribute, simply add or edit a file in the docs directory and submit via pull request. When a pull request is merged, ReadTheDocs will automatically rebuild the documentation with the new changes and add them to the documents site, so no additional steps are required.
To test your changes locally and render the documentation pages as they will appear when you commit, clone the repository and navigate to the docs folder inside the docs repository (which would be clone-path/docs/docs) and run make html. The compiled files will be placed in _build/html/ where you can open them with your browser locally to preview the changes. GitHub also renders .rst files, but certain syntax will not appear as it would when built by Sphinx and under the ReadTheDocs theme.
Depending on what you're trying to do, you may need to install Sphynx (and Python if you don't have it) via pip install sphinx. If you are using the SWG Source VM, you just need to install Sphinx. You can refer, generally, to the ReadTheDocs Documentation or the Sphinx Documentation to determine how to achieve a specific goal or ask Aconite in the SWG Source Discord.
Bug Reports
If you notice a problem, typo, etc. in any of the documentation, please create a GitHub Issue.