Skip to content

Notebooks-Now/submission-myst-lite

Repository files navigation

Notebooks Now! Submission Template

Made with MyST Binder

This submission template is for a simple notebook-based publication with one source file, supporting data, bibliography, and MyST build configuration.

Source file

The source file for this template is a Jupyter notebook. There is not necessarily anything special about this notebook. It may contain markdown cells, code cells, and outputs from common Python packages, including pandas, matplotlib, plotly, seaborn, and altair. Specific markdown cells may be tagged in their metadata as "part": "abstract", or "part": "availability" - these cells will be extracted from the document and included as the specified part in the built output.

Supporting material

Supplementary data

By convention, all data should be saved in data/ directory. There is nothing magic about this directory; references to your data from your notebook must still specify the correct relative path.

Supplementary images

Similar to the data/ directory, images for figures should be specified in images/ directory.

Bibliography

Bibliography entries may be specified two ways, both described in the MyST docs. They may be listed explicitly in bibtex format, by convention in the file references.bib, and referenced by key using a cite MyST role. They may also be specified as inline DOI links. These do not require full bibliographic information; the data is fetched implicitly on build from the DOI.

MyST configuration

A myst.yml file must be provided to configure notebook metadata and exports. This includes authors, affiliations, licenses, keywords, and much more.

Building output artifacts

To build PDF/JATS output from your source data, you must have the MyST Markdown CLI installed

npm install -g mystmd

Then build all exports defined in the myst.yml file:

myst build --all

About

Template for Notebooks Now! submission with single notebook and MyST build

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published