Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Update the AGU article format to the official 2019 template

Aperta
  • Qualcosa non va?
#606 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
58/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
latex, r
Ambito
build-system, documentation, testing

Direzione di ricerca

Individua agu_article(), il suo scheletro AGU incluso e l'attuale test di rendering AGU. Inizia confrontando l'uso delle classi del 2018 e del 2019, quindi esamina la soluzione alternativa per la compatibilità tabulare e le convenzioni di citazione. Il lavoro è completato quando il modello di submission del 2019 è quello predefinito, le regressioni relative a citazioni e appendici superano i test e il test di rendering AGU rimane abilitato; valuta separatamente la classe del 2025.

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

Descrizione

Background

The agu_article() format currently bundles agujournal2018.cls. AGU's current submission resources still identify agujournal2019.cls as the primary class and strongly recommend the newest submission template, while allowing older legible templates.

AGU also publishes agujournal2025.cls, but describes it as a newer template that more closely resembles Wiley's typeset output. It should be evaluated separately rather than assumed to be a drop-in replacement for the submission-oriented 2019 class.

Official resources:

Proposed update

Update the default agu_article() template from agujournal2018.cls to the official agujournal2019.cls, including its current skeleton and submission guidance.

This needs more than renaming the class. In particular:

  • agu_article() currently defaults to citation_package = "natbib".
  • The existing skeleton teaches \citet and \citep.
  • The 2019 class uses apacite conventions and documents \citeA and \cite.
  • Track-changes defaults and appendix numbering also changed.

Citation output and existing-document compatibility should therefore receive focused tests.

Current LaTeX compatibility problem

The bundled 2018 class fails to render ordinary tabular environments with the LaTeX 2026-06-01 kernel (Missing $ inserted at \begin{tabular}). The cause is the class's copied \@array implementation, whose center branch uses the math-only \vcenter while current LaTeX uses \vcenter@text.

The official 2019 and 2025 classes retain the same bare \vcenter, so updating the class alone will not fix this failure. The rticles template will need a small backward-compatible workaround (use \vcenter@text when available, otherwise \vcenter) until this is corrected upstream.

Suggested scope

  1. Add the narrow LaTeX compatibility workaround and keep the AGU render test enabled.
  2. Migrate the submission template to agujournal2019.cls with citation and appendix regression coverage.
  3. Evaluate agujournal2025.cls separately, potentially as an additional output format.
Lingua principale
TeX
Stelle
1.5k
Fork
516
Merge medio
1g 8h
PR unite (30g)
5

Preparare l'ambiente

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 rstudio/rticles

Tutte le issue di rstudio/rticles

Issue simili

Altre issue su Build System

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.