The MyST-Markdown extension is recommended for development.
- Clone the project:
git clone https://github.com/DeepwaterExploration/DeepwaterExplorationDocs.git
- cd to the docs directory:
cd DeepwaterExplorationDocs/docs
- Install the requirments:
pip install -r requirements.txt
(you may need to use an administrator shell) - Run the live server:
sphinx-autobuild . build/html
. When a change is detected inbuild/html
, the documentation is rebuilt and any open browser windows are reloaded automatically.KeyboardInterrupt
(ctrl+c) will stop the server. - Open the browser to view the local server:
http://localhost:8000
docs/index.rst
- index file (written in reStructuredText)docs/*.md
- myST markdown files (new ones should be added to theindex.rst
table of contents)docs/conf.py
- site configuration (only modified when absolutely necessary)
- Fork the project
- Create your feature branch
git checkout -b feature/AmazingFeature
- Commit your changes
git commit -m "Add some amazing feature"
- Push to the branch
git push origin feature/AmazingFeature
- Open a Pull Request