Skip to content

Template for Notebooks for Supporting Information and Zenodo Deposition

License

Notifications You must be signed in to change notification settings

mlund/template-for-supporting-information

Repository files navigation

Binder CC BY 4.0

Electronic Notebook: Title goes here

Template for Notebooks for Supporting Information and Zenodo Deposition.

Instruction video

Watch the video

Layout

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 called my_environment and you'll likely want to rename it to something less generic.
  • .zenodo.json metadata for Zenodo.
  • pyproject.toml and github/workflows/ruff.yml sets up ruff linting for Python and Jupyter Notebooks. Delete if not relevant to your project.

Requirements

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

Checklist - delete before publishing

  • 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 schema legacyrecord.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 under related_identifiers.
  • Update environment.yml to include required packages. Select name for environment.
  • If needed, change the license (LICENSE and badge in README.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!

About

Template for Notebooks for Supporting Information and Zenodo Deposition

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published