Files
business-suite/CHANGELOG.md
T
Marc WäckerlinandClaude Opus 5 adc58e19d7 One LaTeX design for a company, in three templates
A company that writes with LaTeX ends up with a document class, a letter class
and a presentation theme that share a design and not a line of code. Every fix
is then made three times, two of them late and the third never.

Here the page is written once. A company declares its colours, faces and logo in
one file, and the document template, the letter class and the presentation theme
read that one file. Nothing in the suite carries a colour value, a font name or
a file name of any company, which is what lets it be published while the
companies stay private.

Every measure of the page follows from a measurement or from a named definition:
the room the head and the foot need is taken from the boxes they really build,
one line of the body text stands between the head and the text and between the
text and the foot, a heading never stands alone at the foot of a page, a picture
takes the size of the family, and a Markdown file reaches the same page as the
same document written in LaTeX.

The suite ships with a company that does not exist, Nordwind AG, so that it
builds and is measured anywhere: three colours, the TeX Gyre families every
installation carries, and an icon drawn in TikZ.

574 checks over five measurements, all of them on the rendered page or on the
build log rather than on the source.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-22 15:06:07 +02:00

38 lines
4.0 KiB
Markdown

# Changelog
- 2026-09-22 **1.0.0**
- Published under the MIT licence, and every source file carries the notice in its first lines, because a LaTeX package is installed file by file
- The document template, the letter and the presentation of a company, all three configured by one corporate identity
- A company declares its colours, faces and logo in a single file, and every template of that company reads the same one
- `\logo` sets the logo of the company in the form the place needs, and every size in it is measured: the name at the height at which it matches the running text, the address line as wide as the logo, the icon on the middle of the text beside it
- Nineteen signs are asked at the font in force and taken from the symbol family only where the company face does not carry them
- One converter from Markdown to PDF for every company, with the column widths of a table computed from a line width measured in a probe document with the identity of that company
- The letter without a window measures its own address field and gives the rest of the page to the text
- The presentation uses beamer's own sidebar theme
- The identity of a company carries the name of the company, and a document of that company loads it in one line
- A company may let punctuation hang into the margin; off by default, because the edge is then straight to the eye and crooked to the ruler
- A paragraph whose line fits nowhere stretches its spaces rather than let a word stand outside the page
- The PDF opens with its outline beside it
- Cells of equal width side by side, measured from the line and the number of columns
- A block that lies in the TeX tree is used by its name instead of being copied
- The inner corner of the foot carries whatever a document puts there, and the page reserves the room for it
- The heading in the head of a page and the name beside the logo stand on one text line, whatever sizes the two are
- A company may set a sentence under its name: the logo then stands beside two lines, in the page head, the head of a letter and on the title slide of a deck
- The tagline is set to the width of the name over it and the icon to the height of the text beside it, so a mark and its name fit each other at every size of type; a factor for the tagline and a height or a width for the icon override it
- Both lines of that block stand in the colour of the logo; a face or a colour for one of the two is a deviation a company asks for with one key, and asking for none sets none
- The page measures the room for its head again when the company declares itself, so an identity given after the template still fits the page
- The room the head and the foot need is measured at the head and at the foot, on every document
- Exactly one line of the body text between the head and the text and between the text and the foot, whatever the two carry
- From its second page on, a letter carries the page number and the date on the left and the logo on the right
- A picture takes the size of the family by itself: upright at most half the page, lying the whole free height, both centred, and never so large that a quarter of the page stays empty
- The page never breaks between two headings that follow one another
- The right edge of a paragraph stands on the margin
- A page ends where every other page ends
- The room over and under a rule of a table follows the face of the company
- The arrow that marks a wrapped line of code comes from the symbol family of the company
- The distance under the title block is the same whether the document opens with a heading or with a paragraph
- A formula in a Markdown document reaches the page as a formula, also when it is written over several lines
- The example documents show a picture, in both roads into the design
- The example company is called after itself, `nordwind`, because TeX Live already ships a package named `example`
- The proportions of the logo are the ones the family decided, and a test compares them against the origin