Template for Notebooks for Supporting Information and Zenodo Deposition.
Description of the directory layout.
README.md
This is the file you're viewing right now.environment.yml
Defines the required Python packages using conda. Try to pin to specific major versions of your dependencies as their behavior may change in the future. The environment is currently calledmy_environment
and you'll likely want to rename it to something less generic..zenodo.json
metadata for Zenodo.pyproject.toml
andgithub/workflows/ruff.yml
sets up ruff linting for Python and Jupyter Notebooks. Delete if not relevant to your project.
To run the Notebooks online, click on the Launch Binder badge above. Alternatively, to run on your own computer, install Python using e.g. Miniforge or Anaconda and make sure all required packages are loaded by issuing the following terminal commands
conda env create -f environment.yml
source activate my_environment
jupyter-lab
- Add authors incl. ORCID's and other relevant metadata to
.zenodo.json
; to learn more about the available datafields, see here. Before publishing, validate the JSON file using the Zenodo deposition schemalegacyrecord.json
with e.g.pip install check-jsonschema check-jsonschema --schemafile https://raw.githubusercontent.com/zenodo/zenodo/master/zenodo/modules/deposit/jsonschemas/deposits/records/legacyrecord.json .zenodo.json
- Update Binder badge to point to your repository
- Add the Github repo link and DOI of the associated publication to
.zenodo.json
underrelated_identifiers
. - Update
environment.yml
to include required packages. Select name for environment. - If needed, change the license (
LICENSE
and badge inREADME.md
), see e.g. Creative Commons alternatives - Activate Github tracking of the repository on https://zenodo.org. Repository must be public.
- Create a release on Github - adhere to SemVer. This triggers a deposition on Zenodo.
- Once you get the Zenodo DOI, add a badge to the top if this README. Use link to all versions.
- Feel free to update and make new releases!