Skip to content

Commit

Permalink
Updated README and added requirements.txt for documentation (#11)
Browse files Browse the repository at this point in the history
* Updated README and added requirements.txt for documentation

* modify github action. add pip install -r

* Update requirements.txt

* update instruction to install doc builiding pkg in requirements.txt which is in docs folder instead of root folder

* modified github workflow to install doc pkg from docs/requirements.txt
  • Loading branch information
marvelousmonicaaa authored Feb 9, 2024
1 parent 61cbc71 commit 1e0ee1f
Show file tree
Hide file tree
Showing 3 changed files with 16 additions and 0 deletions.
1 change: 1 addition & 0 deletions .github/workflows/pytest.yml
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ jobs:
python -m pip install build
python -m pip install pytest
pip install .
pip install -r docs/requirements.txt
- name: Test with pytest
run: |
pytest -v test
Expand Down
9 changes: 9 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,15 @@ Or, if you wish to edit the pySLM2 source code without re-installing each time
```
pip install -e .
```
To view pySLM2 documentation, some additional packages are required. In the pySLM2 directory, do
```
pip install -r docs/requirements.txt
```
This will install the necessary packages for building the documentation. Then `cd` to the docs directory and in command line do
```
make html
```
HTML files for the documentation will be generated and can be viewed in browser.

Optional Dependencies for Hardware Controls
-------------------------------------------
Expand Down
6 changes: 6 additions & 0 deletions docs/requirements.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
matplotlib
furo
m2r2
sphinx
sphinx-math-dollar
sphinx_pyproject

0 comments on commit 1e0ee1f

Please sign in to comment.