diff --git a/.ci_support/environment-docs.yml b/.ci_support/environment-docs.yml deleted file mode 100644 index 205e035e..00000000 --- a/.ci_support/environment-docs.yml +++ /dev/null @@ -1,4 +0,0 @@ -channels: -- conda-forge -dependencies: - - myst-parser \ No newline at end of file diff --git a/.github/workflows/push-pull.yml b/.github/workflows/push-pull.yml index 341b8af7..5d77861d 100644 --- a/.github/workflows/push-pull.yml +++ b/.github/workflows/push-pull.yml @@ -12,7 +12,7 @@ jobs: uses: pyiron/actions/.github/workflows/push-pull-main.yml@main secrets: inherit with: - docs-env-files: .ci_support/environment.yml .ci_support/environment-docs.yml + docs-env-files: .ci_support/environment.yml notebooks-env-files: .ci_support/environment.yml .ci_support/environment-notebooks.yml tests-in-python-path: true runner-alt2: 'macos-11' diff --git a/docs/README.md b/docs/README.md index 40e13367..9b06a860 100644 --- a/docs/README.md +++ b/docs/README.md @@ -4,7 +4,6 @@ [![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause) [![Codacy Badge](https://app.codacy.com/project/badge/Grade/0b4c75adf30744a29de88b5959246882)](https://app.codacy.com/gh/pyiron/pyiron_workflow/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade) [![Coverage Status](https://coveralls.io/repos/github/pyiron/pyiron_workflow/badge.svg?branch=main)](https://coveralls.io/github/pyiron/pyiron_workflow?branch=main) - [![Documentation Status](https://readthedocs.org/projects/pyiron-workflow/badge/?version=latest)](https://pyiron-workflow.readthedocs.io/en/latest/?badge=latest) [![Anaconda](https://anaconda.org/conda-forge/pyiron_workflow/badges/version.svg)](https://anaconda.org/conda-forge/pyiron_workflow) diff --git a/docs/conf.py b/docs/conf.py index 1001b6da..15ab975d 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -37,6 +37,7 @@ extensions = [ 'myst_parser', 'nbsphinx', + 'sphinx_gallery.load_style', 'sphinx.ext.mathjax', 'sphinx.ext.autodoc', 'sphinx.ext.viewcode', @@ -48,7 +49,10 @@ templates_path = ['_templates'] # The suffix of source filenames. -source_suffix = '.rst' +source_suffix = { + '.rst': 'restructuredtext', + '.md': 'markdown' +} # The encoding of source files. # source_encoding = 'utf-8-sig' @@ -57,7 +61,7 @@ master_doc = 'index' # General information about the project. -project = u'pyiron' +project = u'pyiron_workflow' copyright = u'2021, Max-Planck-Institut für Eisenforschung GmbH - Computational Materials Design (CM) Department ' \ u'All rights reserved' @@ -235,7 +239,7 @@ # (source start file, target name, title, # author, documentclass [howto, manual, or own class]). latex_documents = [ - ('index', 'pyiron.tex', u'pyiron Documentation', + ('index', 'pyiron_workflow.tex', u'pyiron_workflow Documentation', u'Max-Planck-Institut für Eisenforschung GmbH - Computational Materials Design (CM) Department', 'manual'), ] @@ -266,8 +270,8 @@ # (source start file, name, description, authors, manual section). man_pages = [ ('index', - 'pyiron', - u'pyiron Documentation', + 'pyiron_workflow', + u'pyiron_workflow Documentation', [u'Max-Planck-Institut für Eisenforschung GmbH - Computational Materials Design (CM) Department'], 1) ] @@ -283,7 +287,7 @@ texinfo_documents = [ ('index', 'pyiron_workflow', - u'pyiron Documentation', + u'pyiron_workflow Documentation', u'Max-Planck-Institut für Eisenforschung GmbH - Computational Materials Design (CM) Department', 'pyiron_workflow', 'Graph-based workflow management.', diff --git a/docs/environment.yml b/docs/environment.yml index 13d3ebfe..3facc4ff 100644 --- a/docs/environment.yml +++ b/docs/environment.yml @@ -2,7 +2,10 @@ channels: - conda-forge dependencies: - ipykernel +- myst-parser - nbsphinx +- sphinx-gallery +- sphinx-rtd-theme - coveralls - coverage - bidict =0.22.1 @@ -13,4 +16,3 @@ dependencies: - python-graphviz =0.20.1 - toposort =1.10 - typeguard =4.1.5 -- myst-parser diff --git a/docs/index.rst b/docs/index.rst index a1da2bc7..41541a7e 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -9,4 +9,5 @@ .. toctree:: :hidden: + source/examples.rst source/indices.rst \ No newline at end of file diff --git a/docs/source/examples.rst b/docs/source/examples.rst new file mode 100644 index 00000000..de824f08 --- /dev/null +++ b/docs/source/examples.rst @@ -0,0 +1,11 @@ +.. _examples: + + +Example Notebooks +================= + +.. nbgallery:: + :maxdepth: 2 + :glob: + + notebooks/* \ No newline at end of file diff --git a/docs/source/indices.rst b/docs/source/indices.rst index 2e2007f3..28767e9f 100644 --- a/docs/source/indices.rst +++ b/docs/source/indices.rst @@ -9,4 +9,4 @@ API Documentation .. toctree:: - :maxdepth:2 + :maxdepth: 2