Skip to content

Commit 704168a

Browse files
committed
Add jupyter image to rtd page; add .readthedocs.yaml
1 parent 6260b61 commit 704168a

6 files changed

Lines changed: 39 additions & 5 deletions

File tree

.readthedocs.yaml

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# .readthedocs.yaml
2+
# Read the Docs configuration file
3+
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
4+
5+
# Required
6+
version: 2
7+
8+
# Set the version of Python and other tools you might need
9+
build:
10+
os: ubuntu-22.04
11+
tools:
12+
python: "3.11"
13+
14+
# Build documentation in the docs/ directory with Sphinx
15+
sphinx:
16+
configuration: Tutorial/conf.py
17+
18+
# We recommend specifying your dependencies to enable reproducible builds:
19+
# https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
20+
# python:
21+
# install:
22+
# - requirements: docs/requirements.txt

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ The latest version of the tutorial is visible [online at ReadTheDocs](http://hod
1818

1919
This interactive [Jupyter notebook](https://jupyter.org/) can be used to run the Python version of the HH model from above, change the parameters of the model and display the dynamical properties of variables, without the need to write any code.
2020

21-
<p align="center"><kbd><a href="https://github.com/openworm/hodgkin_huxley_tutorial/blob/master/notebooks/Python_HH_version/README.md"><img src="https://raw.githubusercontent.com/openworm/hodgkin_huxley_tutorial/master/notebooks/HH_Jupyter.png" width="600"/></kbd></p>
21+
<p align="center"><kbd><a href="https://github.com/openworm/hodgkin_huxley_tutorial/blob/master/notebooks/Python_HH_version/README.md"><img src="https://raw.githubusercontent.com/openworm/hodgkin_huxley_tutorial/master/Tutorial/_media//HH_Jupyter.png" width="600"/></kbd></p>
2222

2323
Full details can be found [here](https://github.com/openworm/hodgkin_huxley_tutorial/blob/master/notebooks/Python_HH_version/README.md). This work was carried out as part of [Google Summer of Code 2022 by Rahul Sonkar](notebooks/GSoC_2022_Submission/GSoC_Documentation.md).
2424

Tutorial/conf.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,9 +56,9 @@
5656
# built documents.
5757
#
5858
# The short X.Y version.
59-
version = '0.1.1'
59+
version = '0.2.0'
6060
# The full version, including alpha/beta/rc tags.
61-
release = '0.1.1'
61+
release = '0.2.0'
6262

6363
# The language for content autogenerated by Sphinx. Refer to documentation
6464
# for a list of supported languages.

Tutorial/index.rst

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,19 @@ This tutorial gives an introduction to the `Hodgkin-Huxley model <https://en.wik
1414
1) Provide `a guide <_static/Tutorial.html>`_ to implementing the Hodgkin-Huxley model using both `Python <https://www.python.org/>`_ and a `NeuroML2 implementation <http://journal.frontiersin.org/Journal/10.3389/fninf.2014.00079/abstract>`_ of the same equations.
1515
2) Give some background information on the `electrophysiology <_static/Electrophysiology.html>`_ underlying the Hodgkin-Huxley model.
1616

17-
This was originally created by `@joebowen <https://github.com/joebowen>`_ on behalf of the `OpenWorm project <http://www.openworm.org>`_.
17+
The original HH tutorial was created by `@joebowen <https://github.com/joebowen>`_ on behalf of the `OpenWorm project <http://www.openworm.org>`_.
18+
19+
New interactive introduction to the HH model in a Jupyter notebook
20+
==================================================================
21+
22+
A new interactive `Jupyter notebook <https://jupyter.org>`_ can be used to run the HH model, change the parameters of the model and display the dynamical properties of variables, without the need to write any code.
23+
24+
.. image:: _media/HH_Jupyter.png
25+
:target: https://github.com/openworm/hodgkin_huxley_tutorial/blob/master/notebooks/Python_HH_version/README.md
26+
27+
28+
Full details can be found `here <https://github.com/openworm/hodgkin_huxley_tutorial/blob/master/notebooks/Python_HH_version/README.md>`_ with a link to execute the model in your browser. This work was carried out as part of `Google Summer of Code 2022 by Rahul Sonkar <https://github.com/openworm/hodgkin_huxley_tutorial/blob/master/notebooks/GSoC_2022_Submission/GSoC_Documentation.md>`_.
29+
1830

1931
What is the Hodgkin-Huxley model?
2032
=================================

notebooks/Python_HH_version/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
This is an interactive web notebook using [Jupyter technologies](https://jupyter.org/) which can be used to run the HH model, change the parameters of the model and display the dynamical properties of variables.
44

5-
<p align="center" ><kbd><a href="#running-the-notebook"><img src="../HH_Jupyter.png" width="600"/></a></kbd></p>
5+
<p align="center" ><kbd><a href="#running-the-notebook"><img src="../../Tutorial/_media/HH_Jupyter.png" width="600"/></a></kbd></p>
66

77
This notebook was developed as part of [Google Summer of Code 2022 by Rahul Sonkar](notebooks/GSoC_2022_Submission/GSoC_Documentation.md).
88

0 commit comments

Comments
 (0)