Publisher switch to flatten multi-column layouts (@cols)

Aperta
#2,943 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
22/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
html, latex
Ambito
documentation

Direzione di ricerca

Start with how @cols on ol, ul and exercisegroup is handled in the HTML and LaTeX conversions, then compare it with the XSL-FO path, where FOP builds columns from fo:table. The work is a publisher switch that flattens multi-column layouts to one column, either for all conversions or per conversion, with default-off behaviour. Done means the switch exists, the flattened output keeps content and order, and the default output is unchanged. The issue names no existing switch to copy, so a maintainer should confirm the design before coding.

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

Descrizione

@cols on ol/ul (and on exercisegroup) is presentational — it packs items into columns. In HTML (CSS columns) and LaTeX (multicol) the content stays a single real list. In the XSL-FO/PDF conversion FOP has no block-level multicolumn, so the columns are built with fo:table. The item content is preserved — for a list, each cell keeps its list markup, so a screen reader still reads the marker — but the reader meets the whole thing as a table: navigation is cell-by-cell, and each cell announces as its own one-item list, rather than as a single list of N items read in sequence.

Proposal: a publisher-file switch that flattens multi-column layouts to a single column (all conversions, or per-conversion). Since columns are presentational, flattening preserves all content and order, and lets a publisher prioritize list semantics/accessibility (especially for PDF) without editing source @cols. Default off, preserving current behavior.

Claude Opus 4.8, acting as a coding assistant for Rob Beezer

Lingua principale
XSLT
Stelle
466
Fork
251
Merge medio
4m
PR unite (30g)
13

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

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 PreTeXtBook/pretext

Tutte le issue di PreTeXtBook/pretext

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.