From 5d0fb432d96d1ecb402a08fedd427f8058e57ebc Mon Sep 17 00:00:00 2001 From: mrodobbe Date: Fri, 6 Dec 2024 00:17:07 +0100 Subject: [PATCH] update readthedocs --- docs/source/conf.py | 3 ++- docs/source/index.rst | 3 +++ docs/source/installation.rst | 32 ++++++++++++++++++++++++++++++++ pyproject.toml | 3 ++- 4 files changed, 39 insertions(+), 2 deletions(-) create mode 100644 docs/source/installation.rst diff --git a/docs/source/conf.py b/docs/source/conf.py index 33b684a..2255750 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -25,7 +25,8 @@ "sphinx.ext.mathjax", "sphinx.ext.viewcode", "sphinx.ext.doctest", - "sphinx_rtd_theme" + "sphinx_rtd_theme", + "sphinxcontrib.bibtex", ] bibtex_bibfiles = ['refs.bib'] diff --git a/docs/source/index.rst b/docs/source/index.rst index 8a616f9..d9d2a4a 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -19,10 +19,13 @@ Rxn-INSIGHT can be installed from PyPI using pip (on python 3.10 or 3.11): Please cite the Rxn-INSIGHT paper, if you use it in your own work. +.. footbibliography:: + .. toctree:: :maxdepth: 2 :caption: Contents + installation modules diff --git a/docs/source/installation.rst b/docs/source/installation.rst new file mode 100644 index 0000000..e7ad1e1 --- /dev/null +++ b/docs/source/installation.rst @@ -0,0 +1,32 @@ +.. _installation: + +Installation +============ + +Rxn-INSIGHT can be installed from PyPI via pip or directly from the GitHub repository. + +Option 1: Installing from PyPI using pip +---------------------------------------- +.. code-block:: + + conda create -n rxn-insight python=3.11 + conda activate rxn-insight + pip install rxn-insight + +.. note:: + Currently only python 3.10 and python 3.11 are supported. + +Option 2: Installing from source using pip +------------------------------------------ +.. code-block:: + + conda create -n rxn-insight python=3.11 + conda activate rxn-insight + git clone https://github.com/mrodobbe/Rxn-INSIGHT.git + cd Rxn-INSIGHT + pip install -e . + +.. note:: + You can also use this option to install additional optional dependencies for development purposes, + which are required to run the tests and build the docs by running ``pip install -e ".[test,doc]"``. + diff --git a/pyproject.toml b/pyproject.toml index b9b0e2e..64e788b 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -19,6 +19,7 @@ dependencies = [ "openpyxl", "ipykernel", "sphinx-rtd-theme", + "sphinxcontrib-bibtex", ] authors = [ {name = "Maarten R. Dobbelaere", email = "mrodobbe.dobbelaere@ugent.be"} @@ -40,7 +41,7 @@ dynamic = ["version"] [project.urls] source = "https://github.com/mrodobbe/rxn-insight" tracker = "https://github.com/mrodobbe/rxn-insight/issues" -# documentation = "https://rxn-insight.readthedocs.io" +documentation = "https://rxn-insight.readthedocs.io" [project.optional-dependencies] test = [