adonath / showyourwork Goto Github PK

This repository is intended to help authors publish the code that generated the figures and results in a scientific article. It ensures that the compiled article PDF is always in sync with all of the code used to generate it. It does this automatically—and seamlessly—with the help of the Snakemake workflow management system, the tectonic typesetting engine, and Github Actions CI. The basic philosophy behind showyourwork is this: scientific papers should exist as GitHub repositories comprised of LaTeX files, figure scripts, rules to access datasets, a platform/environment specification, and nothing else. Anyone should be able to re-generate the article PDF from scratch at the click of a button.

Click here to get started with a fresh article repository based on showyourwork. Once your repo is created, a GitHub Action will automatically run to finish setting it up. Refresh the page after a few minutes to view the new README.md with instructions on how to get started.

The showyourwork-template repository contains several branches, each containing a workflow template that demonstrates a particular use case or customization of showyourwork. Upon every release of showyourwork (triggered via a GitHub Actions workflow_dispatch event), these templates are updated and instantiated on the showyourwork-example repository. The following table shows the build status of all of these examples.

branch	build status	output
aa
custom-figure-rule
custom-ms-name
expensive-figure
figure-dataset
figure-deps
graphicspath
jinja-yaml
latex-figure
main
mnras
ms-deps
multi-panel-figure
multiple-figures
non-python
simple-figure
static-figure
zenodo-tarball
zenodo-tarball-manual