Project Pythia is an open community, and all contributions are welcome following our Code of Conduct.
The source code for the Pythia Portal is publicly hosted on github. Contributions to open issues and new Pull Requests are welcome at any time. Detailed instructions for new users will be posted here in the near future.
In the mean time, if you have links to some open educational content that you would like to include in the portal, feel free to open an issue on github or contact any member of the Project Pythia core team directly.
Instructions for building the portal site¶
The portal site is built with Sphinx.
When testing new content is important to build and view the site. Read the Docs automatically builds the site for you when each Pull Request is checked. You can also build it locally on your machine.
To view the Read the Docs autobuild¶
Once a Pull Request has passed all tests, including the Read the Docs build, you can click “Details” of the check that says, “docs/readthedocs.org:projectpythia - Read the Docs build succeeded!” to launch a new tab with a build of the Project Pythia site. (You may have to click “Show all checks” for this to be displayed.)
To build and view the site locally¶
Fork the source repository on GitHub
Make a local clone of the repository on your machine
git clone firstname.lastname@example.org:USERNAME/projectpythia.github.io.git # or git clone https://github.com/USERNAME/projectpythia.github.io.git
In your favorite terminal, navigate to the
contentdirectory of the source repository
Use conda to set up a build environment:
conda env create -f ../ci/environment.yml conda activate pythia
Build the site locally using Sphinx (which you just installed in the
pythiaenvironment, along with all necessary dependencies):
The newly rendered site is now available in
content/_build/html/index.html. Open with your web browser, or from the terminal:
When you’re done, you can deactivate the dedicated build environment with
You can re-activate the
pythiaconda environment at any time with
conda activate pythia.