Document files for viewers, parsers, text extraction, conversion, and upload tests.
One subfolder per format, named after the extension it holds:
| Folder | Format | Extension | Kind |
|---|---|---|---|
adoc/ |
AsciiDoc | .adoc |
text |
css/ |
Cascading style sheets | .css |
text |
docx/ |
Word (Office Open XML) | .docx |
binary |
epub/ |
EPUB 3 ebooks | .epub |
binary |
html/ |
HTML pages | .html |
text |
md/ |
Markdown | .md |
text |
odp/ |
OpenDocument presentation | .odp |
binary |
ods/ |
OpenDocument spreadsheet | .ods |
binary |
odt/ |
OpenDocument text | .odt |
binary |
org/ |
Org mode | .org |
text |
pdf/ |
.pdf |
binary | |
pptx/ |
PowerPoint (Office Open XML) | .pptx |
binary |
rst/ |
reStructuredText | .rst |
text |
rtf/ |
Rich Text Format | .rtf |
text |
tex/ |
LaTeX | .tex |
text |
xlsx/ |
Excel (Office Open XML) | .xlsx |
binary |
Folders are formats. File names are topics — the same rule datasets/ follows. A
topic keeps the same name in every format it exists in, so documents/docx/meeting-notes.docx
and documents/odt/meeting-notes.odt are the same document twice, and picking either the
topic or the format tells you where to look.
A format that has no folder yet gets one, named after its extension in lowercase, and a line in the table above.
- Lowercase,
kebab-case, describing the document:invoice-sample.pdf,meeting-notes.docx,budget-planner.xlsx. - Add the feature under test when that is the reason the file exists:
form-fillable.pdf,spreadsheet-with-formulas.xlsx,slides-with-notes.odp. - Add the page, sheet, slide, or chapter count for large files:
manual-20pages.pdf,training-deck-10slides.pptx,short-stories-10chapters.epub. - The extension is not repeated in the name. The folder already says it.
A document is meant to be opened, not archived. Keep text formats under 100 KB and binary ones under 1 MB; a sample that exists to be large says so in its name and says why in the commit that adds it.
One sample is encrypted on purpose. pdf/report-password-protected.pdf opens with the
user password sample, and its permission flags are held by the owner password
sample-owner. A sample that locks something says so here — nothing in this folder
protects anything worth protecting.
Every document is fictional. No real invoices, contracts, résumés, or correspondence — even redacted. If a sample needs a company, an address, or a person, invent one.
The prose samples share a geography on purpose: the Fenwick district, the Northwind Ferry Cooperative, and the Driftwood command-line tool recur across formats so that a converter can be pointed at two files and compared. None of the three exists.
Documents written for this repository are covered by its LICENSE. A document that comes from somewhere else keeps its own license, and is listed here with its source and terms before it is added. Nothing has been added yet.