v1.5.0

What's new

Breaking change — annotation syntax

The embedded annotation extension has been replaced: zinc75/quarto-comments (shortcode syntax) → zinc75/quarto-proofread-comments v1.0.0 (Pandoc span syntax).

Old syntax (no longer works):

{{< comment "My note." author="eb" >}}
{{< todo "Fix this." author="eb" >}}

New syntax:

[]{.comment by="eb" remark="My note."}
[]{.comment by="eb" type="todo" remark="Fix this."}
[highlighted text]{.comment by="eb" remark="Note on this passage."}

Configuration changes

Before	After
extensions.quarto-comments:	extensions.quarto-proofread-comments:
authors:	reviewers:
show_author:	show_names:
wide_margins: false (default)	wide_margins: true (default)
filters: - comments	filters: - proofread-comments

New features (from quarto-proofread-comments)

• Highlight + note: [text]{.comment …} highlights the text and attaches a margin note
• Flow inline mode (inline="true"): badge inserted directly in the text flow, no block/line break
• Numbered connectors: clickable in-text anchor linked to margin callout (HTML)
• Hover synchronisation: hovering anchor or callout highlights both (HTML)

Other changes

• *.upa / *.upb (soulpos position files) added to .gitignore
• Documentation, cheatsheets and READMEs updated throughout

v1.4.5

Sync embedded zinc75/quarto-quartable from 0.1.0 → 0.3.0:

• HTML/Reveal vlines via CSS classes (quartable-vl / quartable-vr)
• Fix \multirow{N}{=} → \multirow{N}{\linewidth} for proper text
  wrapping in p{…} columns

v1.4.4

v1.4.4 — Cheat-sheet appendix & visible PDF links

Highlights
- Removable cheat-sheet appendix (FR + EN): a landscape table recapping common
  Quarto/Markdown commands, each linked to the online documentation, with a
  'Cheat sheet' callout at the top of every starter chapter.
- PDF: internal cross-references and links are now visible (Cnam red); external
  URLs keep their dashed underline.
- New Links / Liens documentation section (structure chapter, FR + EN).
- template.tex: pdflscape for true rotated landscape pages; cnam-thesis.lua:
  new .no-minitoc heading class.

v1.4.3

Adds the optional GitHub link in the HTML topbar (docs profiles).

v1.4.1

Patch.

HTML layout fixes for chapters containing margin comments: previous/next page navigation is kept at the bottom of the page, and the right-hand margin TOC no longer fades out when scrolling level with a comment.

v1.4.0

v1.4.0 — Real twoside layout & per-chapter wide margins

✨ Highlights

Real twoside layout — The PDF now uses a genuine mirrored twoside book layout (inner/binding margin 2.5 cm, outer 2 cm), replacing the previous symmetric-margins workaround. Headers, margins and the cover page are now consistent across recto/verso.

Per-chapter wide_margins — When wide_margins: true, page widening and the grey annotation strip now appear only in the chapters that actually contain comments; every other chapter stays standard A4. Commented zones stand out in a proofreading PDF without bloating the whole document.

Mid-sentence comments in HTML — A comment placed in the middle of a sentence now floats into the margin as a block callout instead of breaking the paragraph (via the upstream quarto-comments 0.4.0 hoist filter).

Styled proofreading list — The {{< listoftodos >}} box is restyled: white background, thin Cnam-red dashed border, looser line spacing.

🔧 Other changes

• Embedded quarto-comments synced to 0.4.0 (improved dashed connectors, .tdo colour safeguard, inline-comment hoist filter).
• Full quarto-comments option set documented in _quarto.yml; profile overrides slimmed down.
• Documentation reorganised: annotations split into a dedicated chapter; wide_margins and the hoist filter documented in the chapters and appendices (FR + EN).
• Extension bumped to 1.4.0.

⚠️ Notes

• Cosmetic: at the boundary between a wide and an A4 chapter, a blank \cleardoublepage spacing page may inherit the previous width — irrelevant for the final deposit (comments off → uniform A4).
• pdflatex only; no change to the PDF/A-1b workflow.

v1.3.0

v1.3.0 — Collaborative annotations

quarto-comments extension (embedded, v0.2.0)
- FontAwesome 5 icons in HTML (via CDN) and PDF (via \faComment, \faEdit, etc.), replacing emoji placeholders
- Auto-assigned author colors from Bootstrap 5 palette — no need to specify color_html/color_latex in YAML
- Config key moved from comments: to extensions.quarto-comments: (scoped namespace, removes the need for validate-yaml: false)
- show_author: true is now the default and can be omitted
- show_list option removed (incompatible with LaTeX book class)
- Co-authorship: Vincent Grégoire + Éric Bavu

Hypothesis web annotations (opt-in)
- Uncomment a single block in _quarto.yml to enable hypothes.is annotations on the HTML output
- Theme clean (sidebar hidden until text is selected) — documented in chapter 5 and the YAML appendix

Documentation
- Chapter 5 updated: new Hypothesis section, inline=true PDF behavior explained, config examples aligned with v0.2.0
- YAML appendix updated: simplified comments config, Hypothesis opt-in block, postrender.ts reference corrected

v1.2.0

v1.2.0 — Cross-platform post-render script (Deno/TypeScript)

Breaking change

The post-render script is now _scripts/postrender.ts, executed by the Deno
runtime bundled with Quarto >= 1.4. The previous shell scripts (postrender.sh,
postrender.bat, postrender.ps1) are archived in _scripts/legacy/ and no
longer active.

Users upgrading from v1.1.x should update the post-render line in their
profile YAML:

before

post-render: ./_scripts/postrender.sh fr _these_fr

after

post-render: ./_scripts/postrender.ts fr _these_fr

What's new

• Single cross-platform script — identical behaviour on macOS, Linux and
  Windows with no OS-specific code paths.
• Python no longer required for post-render — slug generation now uses
  native Unicode normalisation (String.prototype.normalize) instead of
  python3 -c "import unicodedata…".
• Python (or R) is now exclusively required for executable code cells
  (computed figures, tables). A text-only thesis needs no scripting language
  beyond Quarto itself.

Documentation

• Prerequisites step 3 updated: "Python or R (optional)" — only for
  executable code cells, not for post-render.
• Docs intro chapters (FR + EN) and READMEs: new section
  "Executable code (Python, R…)" with links to
  quarto.org/docs/computations/python.html and .../r.html.
• R mentioned as a fully supported alternative to Python for code cells,
  relevant for statistics, econometrics, ecology and life sciences.

External dependencies (unchanged)

• pdftoppm (poppler) or magick (ImageMagick) — cover image generation
• curl — CINES PDF/A-1b validation (optional, pre-installed on most systems)

v1.1.2

chore: bump version to 1.1.2

v1.1.1

chore: bump version to 1.1.1