diff --git a/.github/workflows/jupyterbook.yml b/.github/workflows/jupyterbook.yml new file mode 100644 index 00000000000..34e528aaa71 --- /dev/null +++ b/.github/workflows/jupyterbook.yml @@ -0,0 +1,64 @@ +name: Build Jupyter Book + +on: + workflow_dispatch: + push: + branches: + - '*' + pull_request: + branches: + - master + +defaults: + run: + shell: bash -l {0} + +concurrency: + group: ${{ github.workflow }}-${{ github.head_ref || github.ref }} + cancel-in-progress: true + + +jobs: + build: + runs-on: ubuntu-latest + environment: + name: github-pages + permissions: + pages: write + id-token: write + steps: + - uses: actions/checkout@v4 + + - uses: actions/checkout@v4 + with: + repository: tardis-sn/tardis-regression-data + path: tardis-regression-data + lfs: true + sparse-checkout: | + atom_data/kurucz_cd23_chianti_H_He.h5 + + - name: Setup environment + uses: ./.github/actions/setup_env + with: + os-label: linux-64 + + - run: | + micromamba install jupyter-book sphinx-autoapi + pip install -e . --user + + - name: Copy atom_data + run: | + mkdir -p ~/Downloads/tardis-data && cp -a ./tardis-regression-data/atom_data/. ~/Downloads/tardis-data + + - name: Build the book + run: | + jupyter-book build --all docs + + - name: Upload artifact + uses: actions/upload-pages-artifact@v2 + with: + path: "docs_new/_build/html" + + - name: Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v3 diff --git a/docs/_config.yml b/docs/_config.yml new file mode 100644 index 00000000000..a9c70d8302a --- /dev/null +++ b/docs/_config.yml @@ -0,0 +1,47 @@ +# Book settings +# Learn more at https://jupyterbook.org/customize/config.html + +title: TARDIS Documentation +author: TARDIS RT Collaboration +logo: graphics/tardis_banner.svg + +# Force re-execution of notebooks on each build. +# See https://jupyterbook.org/content/execute.html +execute: + execute_notebooks: force + timeout: 1000 + +# Define the name of the latex output file for PDF builds +latex: + latex_documents: + targetname: book.tex + +# Add a bibtex file so that we can create citations +bibtex_bibfiles: + - references.bib + +# Information about where the book exists on the web +repository: + url: https://github.com/executablebooks/jupyter-book # Online location of your book + path_to_book: docs # Optional path to your book, relative to the repository root + branch: master # Which branch of the repository should be used when creating links (optional) + +# Add GitHub buttons to your book +# See https://jupyterbook.org/customize/config.html#add-a-link-to-your-repository +html: + use_issues_button: true + use_repository_button: true + + +sphinx: + extra_extensions: + - 'sphinx.ext.autodoc' + - 'sphinx.ext.autosummary' + - 'sphinx.ext.viewcode' + - 'autoapi.extension' + config: + html_extra_path: ['screenshots'] + autodoc_member_order: 'bysource' + autosummary_generate: True + autoapi_dirs: ['../tardis'] + autoapi_options: [ 'members', 'undoc-members', 'private-members', 'show-inheritance', 'show-module-summary', 'special-members', ] \ No newline at end of file diff --git a/docs/_toc.yml b/docs/_toc.yml new file mode 100644 index 00000000000..bf50db14470 --- /dev/null +++ b/docs/_toc.yml @@ -0,0 +1,38 @@ +format: jb-book +root: index +parts: + - caption: Getting Started + chapters: + - file: installation + - file: quickstart + - file: tutorials + - caption: Input/Output + chapters: + - file: io/hdf/index + - file: io/configuration/index + - file: io/model/index + - file: io/optional/index + - file: io/visualization/index + - file: io/output/index + - file: io/grid/TardisGridTutorial + - caption: Physics Walkthrough + chapters: + - file: physics/intro/index + - file: physics/setup/index + - file: physics/montecarlo/index + - file: physics/update_and_conv/update_and_conv + - file: physics/spectrum/index + - file: physics/tardisgamma/index + - caption: Contributing to TARDIS + chapters: + - file: contributing/CONTRIBUTING + - file: contributing/development/index + - file: contributing/tools/index + - file: contributing/CHANGELOG + - file: contributing/in_progress/index + - caption: Other Resources + chapters: + - file: resources/credits + - file: resources/research_done_using_TARDIS/research_papers + - file: resources/code_comparison/index + - file: resources/zreferences \ No newline at end of file diff --git a/docs/api.rst b/docs/api.rst new file mode 100644 index 00000000000..025f1f58c05 --- /dev/null +++ b/docs/api.rst @@ -0,0 +1,8 @@ +API documentation +================= + +.. autosummary:: + :toctree: _autosummary + :recursive: + + tardis