Skip to content
Sphinx docs to gh-pages

docs: update readme #88

Sign in to view logs

docs: update readme

docs: update readme #88

Workflow file for this run

.github/workflows/sphinx_docs_to_gh_pages.yaml at a57edfc
name: Sphinx docs to gh-pages
on:
push:
branches:
- main
# workflow_dispatch: # Un comment line if you also want to trigger action manually
jobs:
sphinx_docs_to_gh-pages:
runs-on: ubuntu-latest
name: Sphinx docs to gh-pages
steps:
- uses: actions/checkout@v3
with:
fetch-depth: 0
# ------------------------------
# - name: Make conda environment
# uses: conda-incubator/setup-miniconda@v2
# with:
# python-version: 3.7 # Python version to build the html sphinx documentation
# environment-file: devtools/conda-envs/docs_env.yaml # Path to the documentation conda environment
# auto-update-conda: false
# auto-activate-base: false
# show-channel-urls: true
# ------------------------------
- name: Setup Python
uses: actions/setup-python@v4
with:
python-version: '3.10'
- name: Installing the Documentation requirements
run: |
pip3 install .[docs]
# ------------------------------
- name: Installing the library
shell: bash -l {0}
run: |
python setup.py install
- name: Installing pandoc
# shell: bash -l {0}
run: |
sudo apt-get install pandoc -y
# ------------------------------
#- name: Preprocess README.md
# run: |
# sed -i 's#\](\/#](https://github.com/MarkusPic/intensity_duration_frequency_analysis/blob/main/#g' README.md
- name: Copy readme and examples
# pwd
# ls -lh
run: |
cp ./examples ./documentation/examples -r
cp ./README.md ./documentation/README.md
sed -i 's|examples|https://markuspic.github.io/intensity_duration_frequency_analysis/examples|' ./documentation/README.md
sed -i 's|.ipynb||' ./documentation/README.md
- name: Running the Sphinx to gh-pages Action
# https://github.com/marketplace/actions/sphinx-docs-to-github-pages
uses: uibcdf/[email protected]
with:
branch: main
dir_docs: documentation
# sphinxapiopts: '--separate -o . ../'
# sphinxapiexclude: '../*setup* ../*.ipynb'
# sphinxopts: ''