ckb/.agents/modules/convert/scaffold/styles-README.md
Michał Kopeć c57ddceffd Template 2.2.0: voice and convert modules
- 2.1.0 new opt-in `voice` module (D-0020): skill ckb-voice rewrites every
  prose file written under apply_to (outputs/answers, documents, reports,
  PROJECT-OVERVIEW) in a voice whose profile is a wiki page,
  wiki/voice/<name>.md (type voice-profile); settings in ckb.yaml (mode,
  profile, writer, apply_to, skip, chat); frozen spans never change, vague
  claims flagged not cut; `writer:` delegates to an external rewriting
  skill such as a personal ghost-writer. ckb-module writes a manifest's
  default_config into the entry's config:. Eval ckb-module/install-voice.
- 2.2.0 new opt-in `convert` module (D-0021): skill ckb-convert and
  convert.py turn Markdown into Word/ODT/PDF/HTML through pandoc with a
  house style in templates/styles/; unit tests and eval
  ckb-module/install-convert.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 20:57:39 +01:00

1 KiB
Raw Blame History

House styles

One file per style, used by ckb-convert (the convert module) to turn Markdown into Word, OpenDocument, PDF or HTML:

File Used for Required
<name>.docx Word, and PDF/ODT made from it with LibreOffice yes
<name>.odt ODT, when you want a separate LibreOffice style no
<name>.css HTML no

pandoc takes fonts, sizes, colours, spacing, page size, margins, header and footer from the .docx and ignores any text in it.

Three ways to get a style:

  • Say what you want: "make a house style with Georgia 11pt, navy headings, A4". The agent builds the .docx.
  • Use your company's template: "use Company.dotx as the house style". The agent copies it here and tells you which styles pandoc needs that it lacks.
  • Edit by hand: open <name>.docx in Word or LibreOffice, change the styles (Normal, Body Text, Title, Heading 1–6, Table…), not the text, and save it as .docx.

Fonts aren't embedded in a .docx. Choose fonts your readers have, or they'll see a substitute.