Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Update the AGU article format to the official 2019 template

Abierto
  • ¿Algo no está bien?
#606 1 comentario 0 reacciones 0 asignados Ver en GitHub

@cderv ya está trabajando en esto.

Desde el 17/9/2026.

  • #615 de @cderv — abierto

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
58/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
latex, r
Área
build-system, documentation, testing

Línea de trabajo

Localiza agu_article(), su esqueleto AGU incluido y la prueba de renderizado AGU actual. Empieza comparando el uso de las clases de 2018 y 2019; después, inspecciona la solución alternativa de compatibilidad tabular y las convenciones de citación. La tarea estará terminada cuando la plantilla de envío de 2019 sea la predeterminada, pasen las regresiones de citas y apéndices, y la prueba de renderizado AGU siga habilitada; evalúa la clase de 2025 por separado.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.
Lenguaje dominante
TeX
Estrellas
1.5k
Forks
516
Sin PR fusionados en 30 d

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de rstudio/rticles

Todos los issues de rstudio/rticles

Issues similares

Más issues de Build System

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.