Wesley R. Elsberry
95905429e1
|
||
|---|---|---|
| .forgejo/workflows | ||
| .github/workflows | ||
| figs | ||
| polypaper | ||
| scripts | ||
| setup | ||
| .gitignore | ||
| CITATION.cff | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| Dockerfile.full | ||
| Dockerfile.tinytex | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
| biblio.bib | ||
| build.el | ||
| docker-compose.yml | ||
| paper.org | ||
| polypaper-logo.svg | ||
| repo_meta.json | ||
README.md
PolyPaper
“One manuscript, many destinations.”
PolyPaper is a set of tools for scientific manuscript production that combines a single source tree coherently with targeting documents for multiple venues.
Rationale
Scientific research has uncertainties about publication venues that have varying restrictions on page length, numbers of figures or tables, or other restrictions. Being prepared for shifts in these sorts of conditions has mostly required building entire variants of manuscripts separate from one another. Besides additional effort, this means that updates to content may need to be applied in multiple different places, increasing the likelihood of drift between the variants in statements, tone, or other properties. PolyPaper aims to help keep similar content together leveraging the capabilities of Emacs Org-Mode documents that provide literate programming capability with LaTeX typesetting and Markdown/Pandoc flexible document type generation.
How it works
The first step is to have 'venues', which are simply the possible ways in which the material can be presented for publication, as separate Org-Mode documents. These will incorporate the metadata needed for LaTeX production or Pandoc target. See 'setup/README.md' for more detail on working with the venue configuration system.
The manuscript content will reside in an Emacs Org-Mode document. The user can choose whether to keep that as a single document or use include statements so that sections might have their own Org-Mode document, depending on the research group's preferences on ways to merge changes.
Figures and tables are also specified in the source document, and can be updated through Org-Mode commands. All the necessary processing can be accomplished via use of command-lines and thus Makefiles can automate repeated tasks.
Generative AI Disclosure
This repository was largely derived by Wesley R. Elsberry prompting OpenAI's ChatGPT with GPT 5.
The associated chat session is at https://chatgpt.com/share/68e3c7d6-ef60-8007-b56c-8f221b8250da
Status
2025-10-07:
- Some basic testing done
- Dockerfiles built
- Demo paper compiled, including generated figure