Typst "Grid Customization" lists `body-width`, but it has no effect

Aperta Adatta ai principianti
#14,574 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
62/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Ambito
documentation

Direzione di ricerca

Inizia dalla pagina di personalizzazione dei grids di Typst collegata nell’issue ed esamina le opzioni documentate e l’esempio. Controlla src/resources/filters/layout/meta.lua in typstGeometryFromPaperWidth per confermare il comportamento attuale; il lavoro è completato quando la pagina documenta solo le impostazioni supportate, spiega la larghezza rimanente del corpo e rimanda a margin-geometry.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

documentation typst
What would you like to do?

Report an issue on quarto.org

Description

Page: https://quarto.org/docs/output-formats/typst.html#grid-customization

The Typst Grid Customization section documents three grid options:

Option Description (current docs)
margin-width Width of the margin note column
body-width Width of the main text column
gutter-width Gap between body text and margin

…and the example sets all three:

format:
  typst:
    grid:
      margin-width: 2in
      body-width: 4in
      gutter-width: 0.25in

However, body-width is silently ignored. Quarto's geometry calculation reads it but never uses it.
For reference, the mapping lives in typstGeometryFromPaperWidth — margin-width/gutter-width are consumed but body-width is not:

https://github.com/quarto-dev/quarto-cli/blob/e768e5c2d34381173aa3d43d8d3a332125647561/src/resources/filters/layout/meta.lua#L479-L496

If we view this as a docs issue, I think the solution is:

  1. Drop body-width from the Typst grid table. Remove it from the example.
  2. Clarify the two that work:
    • margin-width — width of the margin note column.
    • gutter-width — gap between the body and the margin column.
  3. Note that the body width is whatever space is left over and point to margin-geometry for full control.

However, we could potentially honor body-width if zero or one of margin-width and gutter-width is supplied, and warn if all three are supplied. @gordonwoodhull, if you think that's a better fix, feel free to relabel.

Lingua principale
JavaScript
Stelle
6k
Fork
458
Merge medio
1g 8h
PR unite (30g)
42

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di quarto-dev/quarto-cli

Tutte le issue di quarto-dev/quarto-cli

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.