This repository generates this Jupyter Book website: https://pmagpy.github.io/PmagPy-docs/
Github Actions are currently configured so that when changes are made to book files within the main repo that these are used to compile the book and to publish it. The book can also be built locally using the instructions below. Note that the book is currently built using Jupyter Book 1.0 (Jupyter Book 2.0 is underdevelopment and will require some changes to structure and workflow.
Jupyter book can be installed via pip:
pip install -U jupyter-book
The Jupyter Book is built automatically using Github Actions when a push is made to the main branch of the repository
We are in the process of translating the content from the PmagPy Cookbook to this updated format.
This involves getting the .txt documents into MyST markdown. Here is what I did for a two step process that worked on the osx_developer.tex file.
pandoc -s osx_developer.tex -o osx_developer.rst
rst2myst convert osx_developer.rst
With Jupyter book installed, the Jupyter book in this repository can be made with this command. To run this command you need to be not in the directory itself, but in the directory that contains the folder:
jupyter-book build PmagPy-docs
To keep the repository from getting humongous. The current approach is to build the html locally using the above command, but not to push the changes in the resulting _build folder.
The resulting html after a local build can be published to github pages using these directions:
https://jupyterbook.org/en/stable/publish/gh-pages.html
and specifically this command from within the main branch:
ghp-import -n -p -f _build/html