57 lines
2.1 KiB
Markdown
57 lines
2.1 KiB
Markdown
# 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
|
|
|