Formatear Informe APA

Crear un informe con formato APA 7a edición usando Quarto (apaquarto) o R Markdown (papaja).

Cuándo Usar

• Escribir un artículo académico en formato APA
• Crear un informe de investigación en psicología o ciencias sociales
• Generar manuscritos reproducibles con análisis integrado
• Preparar un capítulo de tesis o disertación

Entradas

• Requerido: Código de análisis y resultados
• Requerido: Archivo de bibliografía (.bib)
• Opcional: Coautores y afiliaciones
• Opcional: Tipo de manuscrito (artículo de revista, trabajo estudiantil)

Procedimiento

Paso 1: Elegir Marco de Trabajo

Opción A: apaquarto (Quarto, recomendado)

install.packages("remotes")
remotes::install_github("wjschne/apaquarto")

Opción B: papaja (R Markdown)

remotes::install_github("crsh/papaja")

Esperado: El paquete del marco elegido se instala exitosamente y es cargable con

library(apaquarto)

o

library(papaja)

.

En caso de fallo: Si la instalación falla por dependencias del sistema faltantes (p. ej., LaTeX para salida PDF), instalar TinyTeX primero con

quarto install tinytex

. Para fallos de instalación desde GitHub, verificar que el paquete

remotes

esté instalado y que GitHub sea accesible.

Paso 2: Crear Documento (apaquarto)

Crear

manuscript.qmd

:

---
title: "Effects of Variable X on Outcome Y"
shorttitle: "Effects of X on Y"
author:
  - name: First Author
    corresponding: true
    orcid: 0000-0000-0000-0000
    email: author@university.edu
    affiliations:
      - name: University Name
        department: Department of Psychology
  - name: Second Author
    affiliations:
      - name: Other University
abstract: |
  This study examined the relationship between X and Y.
  Using a sample of N = 200 participants, we found...
  Results are discussed in terms of theoretical implications.
keywords: [keyword1, keyword2, keyword3]
bibliography: references.bib
format:
  apaquarto-docx: default
  apaquarto-pdf:
    documentmode: man
---

Esperado: El archivo

manuscript.qmd

existe con frontmatter YAML válido que contiene título, título corto, afiliaciones de autores, resumen, palabras clave, referencia bibliográfica y opciones de formato específicas de APA.

En caso de fallo: Verificar que la indentación YAML sea consistente (2 espacios) y que las entradas de

author:

usen el formato de lista con campos

name:

,

affiliations:

y

corresponding:

. Verificar que

bibliography:

apunte a un archivo

.bib

existente.

Paso 3: Escribir Contenido APA

# Introduction

Previous research has established that... [@smith2023; @jones2022].
@smith2023 found significant effects of X on Y.

# Method

## Participants

We recruited `r nrow(data)` participants (*M*~age~ = `r mean(data$age)`,
*SD* = `r sd(data$age)`).

## Materials

The study used the Measurement Scale [@author2020].

## Procedure

Participants completed... (see @fig-design for the study design).

# Results

```{r}
#| label: fig-results
#| fig-cap: "Mean scores by condition with 95% confidence intervals."
#| fig-width: 6
#| fig-height: 4

ggplot(summary_data, aes(x = condition, y = mean, fill = condition)) +
  geom_col() +
  geom_errorbar(aes(ymin = ci_lower, ymax = ci_upper), width = 0.2) +
  theme_apa()
```

A two-way ANOVA revealed a significant main effect of condition,
*F*(`r anova_result$df1`, `r anova_result$df2`) = `r anova_result$F`,
*p* `r format_pvalue(anova_result$p)`, $\eta^2_p$ = `r anova_result$eta`.

# Discussion

The findings support the hypothesis that...

# References

Esperado: El contenido sigue la estructura de secciones APA (Introducción, Método, Resultados, Discusión, Referencias) con código R en línea para estadísticas y referencias cruzadas apropiadas usando prefijos

@fig-

y

@tbl-

.

En caso de fallo: Si el código R en línea no se renderiza, verificar que la sintaxis de comilla invertida-r sea correcta (

`r expression`

). Si las referencias cruzadas aparecen como texto literal, verificar que las etiquetas de bloque referenciadas usen el prefijo correcto y que el bloque tenga una opción de subtítulo correspondiente.

Paso 4: Formatear Tablas en Estilo APA

#| label: tbl-descriptives
#| tbl-cap: "Descriptive Statistics by Condition"

library(gt)

descriptive_table <- data |>
  group_by(condition) |>
  summarise(
    M = mean(score),
    SD = sd(score),
    n = n()
  )

gt(descriptive_table) |>
  fmt_number(columns = c(M, SD), decimals = 2) |>
  cols_label(
    condition = "Condition",
    M = "*M*",
    SD = "*SD*",
    n = "*n*"
  )

Esperado: Las tablas se renderizan con formato APA: encabezados de columna en cursiva para símbolos estadísticos, alineación decimal apropiada y un subtítulo descriptivo sobre la tabla.

En caso de fallo: Si la tabla

gt

no se renderiza en estilo APA, asegurar que el paquete

gt

esté instalado y que

cols_label()

use cursivas estilo markdown (

*M*

,

*SD*

). Para usuarios de papaja, usar

apa_table()

en lugar de

gt()

.

Paso 5: Gestionar Citas

Crear

references.bib

:

@article{smith2023,
  author = {Smith, John A. and Jones, Mary B.},
  title = {Effects of intervention on outcomes},
  journal = {Journal of Psychology},
  year = {2023},
  volume = {45},
  pages = {123--145},
  doi = {10.1000/example}
}

Estilos de cita APA:

• Parentética:

  [@smith2023]

  -> (Smith & Jones, 2023)
• Narrativa:

  @smith2023

  -> Smith and Jones (2023)
• Múltiple:

  [@smith2023; @jones2022]

  -> (Jones, 2022; Smith & Jones, 2023)

Esperado:

references.bib

contiene entradas BibTeX válidas con todos los campos requeridos (author, title, year, journal) y las claves de cita coinciden con las usadas en el texto del manuscrito.

En caso de fallo: Validar la sintaxis BibTeX con un validador en línea o

bibtool -d references.bib

. Asegurar que las claves de cita en el texto coincidan exactamente con las claves del

.bib

(sensible a mayúsculas).

Paso 6: Renderizar

# Word document (common for journal submission)
quarto render manuscript.qmd --to apaquarto-docx

# PDF (for preprint or review)
quarto render manuscript.qmd --to apaquarto-pdf

Esperado: Documento APA correctamente formateado con página de título, encabezado continuo y sección de referencias correctamente formateada.

En caso de fallo: Para fallos de renderizado PDF, verificar que TinyTeX esté instalado (

quarto install tinytex

). Para problemas de salida DOCX, verificar que la plantilla Word de apaquarto sea accesible. Si las referencias no aparecen, asegurar que el encabezado

# References

esté presente al final del documento.

Validación

• Página de título formateada correctamente (título, autores, afiliaciones, nota de autor)
• Resumen presente con palabras clave
• Citas en texto coinciden con la lista de referencias
• Tablas y figuras numeradas correctamente
• Estadísticas formateadas según APA (cursiva, símbolos apropiados)
• Referencias en formato APA 7a edición
• Números de página y encabezado continuo presentes (PDF)

Errores Comunes

• Formato de código R en línea: Usar sintaxis comilla invertida-r para estadísticas en línea, no valores codificados
• Discrepancias en claves de cita: Asegurar que las claves .bib coincidan exactamente en el texto
• Ubicación de figuras: Los manuscritos APA típicamente colocan figuras al final; configurar

  documentmode: man

• Archivo CSL faltante: apaquarto incluye el CSL de APA; usuarios de papaja pueden necesitar especificar

  csl: apa.csl

• Caracteres especiales en resúmenes: Evitar formato markdown en el bloque abstract del YAML

Habilidades Relacionadas

• create-quarto-report

  - Creación general de documentos Quarto

• generate-statistical-tables

  - Tablas listas para publicación

• build-parameterized-report

  - Generación de informes por lotes