Skip to content

Commit

Permalink
sphinx replaced with pdoc3
Browse files Browse the repository at this point in the history
Signed-off-by: Berkay Bozkurt <[email protected]>
  • Loading branch information
rbbozkurt committed Feb 2, 2024
1 parent 6edb76b commit 1c89e9b
Show file tree
Hide file tree
Showing 7 changed files with 14 additions and 164 deletions.
21 changes: 12 additions & 9 deletions .github/workflows/documentation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,21 +16,24 @@ jobs:
- uses: actions/setup-python@v3
- name: Install dependencies
run: |
pip install sphinx sphinx_rtd_theme myst_parser
- name: Sphinx build
python -m pip install --upgrade pip
pip install pipenv
# if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
pipenv install --dev
- name: Set PYTHONPATH
run: |
sphinx-apidoc -o docs src/
- name: Generate HTML
echo "PYTHONPATH=${PYTHONPATH}:${GITHUB_WORKSPACE}" >> $GITHUB_ENV
- name: Run Command
run: |
cd docs
make clean html
make html
cd ..
echo $PYTHONPATH
- name: Generate pdoc
run: |
pdoc --html ./src --output-dir ../docs
- name: Deploy to GitHub Pages
uses: peaceiris/actions-gh-pages@v3
if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/python-generation' }}
with:
publish_branch: gh-pages
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: docs/_build/html/
publish_dir: docs/src/
force_orphan: true
14 changes: 1 addition & 13 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -57,19 +57,7 @@ bin/
**/data/classification_reports/*

#generated pydoc
**/docs/_build/*
**/docs/_static/*
**/docs/_templates/*
**/docs/*.html
**/docs/*.js
**/docs/*.rst

!**/docs/.gitkeep
!**/docs/.conf.py
!**/docs/Makefile
!**/docs/make.bat
!**/docs/index.rst

/docs/*

# Env files
*.env
Expand Down
1 change: 1 addition & 0 deletions Pipfile
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,7 @@ colorama = "*"
torch = "2.1.2"
deutschland = "0.4.0"
bs4 = "0.0.2"
pdoc3 = "0.10.0"

[requires]
python_version = "3.10"
23 changes: 0 additions & 23 deletions docs/Makefile

This file was deleted.

58 changes: 0 additions & 58 deletions docs/conf.py

This file was deleted.

23 changes: 0 additions & 23 deletions docs/index.rst

This file was deleted.

38 changes: 0 additions & 38 deletions docs/make.bat

This file was deleted.

0 comments on commit 1c89e9b

Please sign in to comment.