Skip to content

Plantilla de Quarto para tesis y trabajos de grado de la Universidad de Antioquia - Quarto Template for Thesis and Degree Projects at the University of Antioquia

License

Notifications You must be signed in to change notification settings

alexespinosaco/udea-quarto-thesis

Repository files navigation

Plantilla de Quarto para trabajos de grado de la Universidad de Antioquia

html portada html portada

pdf portada pdf citacion.png1

Introducción

udea-thesis es una plantilla/extensión de Quarto diseñada para la creación de trabajos de grado conforme a las directrices de la Universidad de Antioquia (UdeA), establecidas en la Resolución Rectoral 47233 (21 de agosto de 2020). Aunque esta resolución no impone un formato único y deja la decisión a las dependencias o asesores, el Sistema de Bibliotecas proporciona plantillas en MS Word (APA, Chicago, IEEE, Vancouver) y LaTeX (APA, IEEE).

Esta plantilla fue desarrollada para la creación de trabajos de grado íntegramente en Quarto, promoviendo la adopción de este sistema de escritura académica de código abierto. Aunque toma como base los formatos APA, incluye adaptaciones específicas para generar tanto versiones en PDF como en HTML, aprovechando las ventajas de los libros de Quarto.

⚠️ Se ofrece una versión en MS Word únicamente para revisión por parte de asesores o evaluadores, ya que no cumple con todas las características de la plantilla y no está lista para su entrega.

⚠️ Esta extensión se ofrece de manera independiente, sin depender de Python, R u otros lenguajes de programación, con el objetivo de minimizar problemas durante el proceso de renderización. Sin embargo, es importante destacar que una de las grandes ventajas de Quarto radica en su capacidad para integrar texto y código en un único entorno.

Puede ver un ejemplo en PDF o visitando el sitio web del repositorio.

Para una demostración práctica de esta plantilla/extensión de Quarto en uso, puede consultar el repositorio de ejemplos (Muy pronto).

Estructura

Debido a ciertas limitaciones y a decisiones de diseño, las versiones en PDF y HTML de la plantilla difieren en algunos aspectos, principalmente en términos estéticos y en el orden de algunos elementos. Sin embargo, es importante destacar que la versión en PDF es la que debe entregarse oficialmente al Sistema de Bibliotecas.

Estructura de la versión en PDF

  • Portada
  • Citación, Licencia e información Institucional
  • Cita (Opcional)
  • Dedicatoria (Opcional)
  • Agradecimientos (Opcional)
  • Índice
  • Lista de tablas
  • Lista de figuras
  • Resumen
  • Abstract
  • Cuerpo del trabajo de grado
  • Referencias
  • Anexos (Opcional)

Estructura de la versión en HTML

  • Portada
  • Cita (Opcional)
  • Dedicatoria (Opcional)
  • Resumen
  • Abstract
  • Agradecimientos (Opcional)
  • Citación, Licencia e información Institucional
  • Cuerpo del trabajo de grado
  • Referencias
  • Anexos (Opcional)

Estructura del repositorio / trabajo de grado

El repositorio está organizado para reflejar la estructura del documento de tesis. Los archivos index.qmd y _quarto.yml pueden editarse según sea necesario, pero no pueden borrarse ni renombrarse. El siguiente diagrama proporciona una visión general de la estructura de la plantilla. Revise el código en el repositorio para una mejor comprensión de cómo Quarto une todo.

├── book/                      # Carpeta generada automáticamente por Quarto al renderizar (output).
│   ├── index.html             # Índice de la versión HTML, se omiten otros archivos.
│   └── manuscrito.pdf         # Versión en PDF del trabajo de grado.
├── _extensions/               # Extensiones utilizadas en el proyecto.
│   ├── udea-thesis/
├── anexos/                    # Capítulos correspondientes a los anexos.
│   ├── assets/                # Recursos relacionados con los anexos.
|   ├── a00_anexos.qmd
|   ├── a01_recomendaciones.qmd
|   ├── a02_autorarchivo.qmd
|   ├── a03_citas-referencias.qmd
|   └── a04_citas-referencias-legales.qmd
├── capitulos/                 # Capítulos principales del documento.
│   ├── assets/                # Recursos relacionados con los capítulos.
|   ├── 00_introduccion.qmd
|   ├── 01_planteamiento-problema.qmd
|   ├── 02_justificacion.qmd
|   ├── 03_objetivos.qmd
|   ├── 04_problema-investigacion.qmd
|   ├── 05_hipotesis.qmd
|   ├── 06_marco-teorico.qmd
|   ├── 07_metodologia.qmd
|   ├── 08_resultados.qmd
|   ├── 09_discusion.qmd
|   ├── 10_conclusiones.qmd
|   ├── 11_recomendaciones.qmd
|   └── 12_referencias.qmd
├── assets/                    # Recursos generales del proyecto.
├── guia-estilo/               # Archivos relacionados con las guías de estilo.
├── images/                    # Imágenes generales del proyecto (si no están en "assets").
├── qmd/                       # Archivos Quarto para las secciones introductorias o adicionales.
|   ├── _index-docx.qmd        # Índice o portada para la versión en Word.
|   ├── _index-html.qmd        # Índice o portada para la versión en HTML.
|   ├── agradecimientos.qmd    # Sección de agradecimientos.
|   ├── citacion.qmd           # Sección sobre cómo citar el documento.
|   └── licencia.qmd           # Información sobre la licencia del documento.
├── tex/                       # Archivos relacionados con LaTeX o configuraciones específicas.
├── .gitignore                 # Archivos y carpetas que Git debe ignorar.
├── LICENSE                    # Licencia bajo la cual se publica el repositorio.
├── _quarto.yml                # Archivo de configuración principal de Quarto.
├── apa.csl                    # Estilo de citación (APA en este caso).
├── index.qmd                  # Índice principal del documento.
├── README.md                  # Información general sobre el proyecto y cómo usarlo.
├── references.bib             # Archivo de referencias bibliográficas en formato BibTeX.
└── udea-quarto-thesis.Rproj   # Archivo del proyecto de RStudio.

Instalación

Esta plantilla/extensión fue creada y probada utilizando las siguientes herramientas y versiones:

En un proyecto nuevo

Ejecute en la Terminal:

quarto use template alexespinosaco/udea-quarto-thesis

Esto instalará la extensión y creará los archivos mencionados anteriormente.

En un proyecto existente

Desde el directorio del proyecto o documento Quarto, ejecute en la Terminal:

quarto add alexespinosaco/udea-quarto-thesis

Este formato puede ser utilizado con un proyecto o documento Quarto existente. Esto instalará sólo los archivos en la carpeta _extension y no instalará los archivos por encima de eso (los archivos de demostración). Esta es también la forma de actualizar la extensión si ha habido cambios.

Ahora puede usar udea-thesis como formato o como un tipo de proyecto:

---
format:
  udea-thesis-html: default
  udea-thesis-pdf: default
  # udea-thesis-docx: default
---
---
project:
  type: udea-thesis
---

Descargar los archivos / clonar el repositorio

En este punto, podría descargar los archivos. Hacer clic en la opción Download zip. Esto descargará el archivo quarto-workshop-main.zip, el cual tendrá que descomprimir.

También podría ejecutar en la Terminal:

git clone https://github.com/alexespinosaco/udea-quarto-thesis.git
  • En RStudio, ir a File > New Project > Version Control > From Git > pegar la URL en el cuadro de Repository URL. Hacer clic en Create Project. Esperar a que termine

Tomado de Get Started with Quarto

Uso

Para renderizar su trabajo de grado, ejecute en la Terminal:

quarto render

Por defecto, esto renderizará la tesis en formatos HTML y PDF. Puede controlar en qué formato se renderizará el trabajo de grado:

quarto render --to udea-thesis-pdf

Si no deseas renderizar el trabajo de grado en alguno de los formatos, puedes cambiar el comportamiento predeterminado en el archivo _quarto.yml, cambiando:

---
format:
  udea-thesis-html: default
  udea-thesis-pdf: default
  # udea-thesis-docx: default
---

a

---
format:
  # udea-thesis-html: default
  udea-thesis-pdf: default
  # udea-thesis-docx: default
---

Esto renderizará sólo la versión en PDF.

Opciones de formato

El archivo _quarto.yml es un archivo YAML que contiene la configuración global del trabajo de grado. La mayoría de estos ajustes pueden modificarse siguiendo las opciones de Quarto. Algunos de estos ajustes están predeterminados en el archivo _extension.yml. Si tiene experiencia con Quarto, puede cambiarlos según sus necesidades.

⚠️ Prontamente se espera incluir un listado de los valores válidos para estos ajustes, dado que muchos hacen referencia a nombres específicos designados por la Universidad de Antioquia y, por tanto, no pueden ser cambiados arbitrariamente. Mientras tanto, estos valores pueden ser consultados en los desplegables disponibles al abrir en MS Word la versión de MS Word de la plantilla proporcionada por el Sistema de Bibliotecas.

Los ajustes específicos de esta plantilla que pueden modificarse en _quarto.yml son:

tipo-documento: "Tipo de trabajo"
titulo-otorgado: "Título ortorgado por la UdeA"
tipo-orientador: "Tipo de orientador"
nombre-orientador: "Nombre del orientador"
titulo-orientador: "Título académico mas alto"
unidad-academica: "Facultad, escuela, instituto o corporación"
programa: "Pregrado o posgrado"
ciudad: "Ciudad"
ano-grado: "año de grado"

citacion: "Primer Autor & Segundo Autor" # No incluir el año
referencia: "Primer Autor, N. & Segundo Autor, N." # Sólo incluir los nombres
modalidad-grado: "Modalidad de grado"

licencia-tipo: assets/license/by.png

cohorte-posgrado: "cohorte posgrado en numero romano"
grupo-investigacion: "Nombre grupo de investigación"
centro-investigacion: "Nombre centro de investigación"

biblioteca: "Nombre biblioteca, CRAI o centro de documentación"

rector: "Nombres y Apellidos del rector"
decano-director: "Nombres y Apellidos del decano o director"
jefe-departamento: "Nombres y Apellidos del jefe de departamento"

cita:
texto: "Texto de la cita"
autor: "Autor de la cita"

dedicatoria: "texto de dedicatoria"
agradecimientos: "Texto de agradecimientos"

abreviaturas: "abreviaturas.tex"

format:
udea-thesis-html: default
udea-thesis-pdf: default
udea-thesis-docx: default

💡 De ser necesario, la plantilla permite incluir un archivo .tex con las abreviaturas. El cual se renderizará sólo en el PDF.

Agradecimientos

Esta plantilla/extensión fue creada como un ejercicio académico en los ratos libres y no cuenta con un apoyo económico detrás. Por ello, consideramos importante agradecer y reconocer a quienes, con su trabajo, han servido de guía o inspiración para realizar este proyecto. Agradecemos a todas las personas que hay detrás de Quarto y su excelente guía. También extendemos nuestro reconocimiento a los creadores de otras plantillas por compartir abiertamente su código, especialmente: Bjørn Peare Bartholdy, Daniel Vartanian, Eli Holmes, Fred Guth, Gonzalo García-Castro, James H., Julian Tao, Rob J Hyndman, Samir. Asimismo, agradecemos a los autores de diversos artículos y publicaciones en blogs que han sido de gran utilidad: Cameron Patrick, Christopher T. Kenny, Gonzalo García-Castro, Rich Posert.

Citación

Si decide utilizar el formato udea-thesis en su trabajo de grado, le solicitamos amablemente que considere la posibilidad de citarlo. La creación y el mantenimiento de este formato de Quarto, gratuito y de código abierto, ha requerido un esfuerzo considerable, por lo que le agradecemos que lo cite. A continuación encontrará los detalles de la cita.

APA:

Espinosa-Correa, Á. (2025). Plantilla de Quarto para trabajos de grado de la Universidad de Antioquia. https://github.com/alexespinosaco/udea-quarto-thesis/

BibTeX:

@unpublished{espinosa-correa2025,
  author = {Álex Espinosa-Correa},
  title = {Plantilla de Quarto para trabajos de grado de la Universidad de Antioquia},
  url = {https://github.com/alexespinosaco/udea-quarto-thesis/},
  year = {2025}
}

Contribuir

Si desea contribuir a la mejora y ampliación de esta plantilla/extensión, no dude en ponerse en contacto, o bien abra un issue o un pull request en este repositorio. Todas las contribuciones son bienvenidas y altamente valoradas.

Licencia

Esta plantilla/extensión está publicada bajo la Licencia MIT.

Disclaimer

Este repositorio es el resultado de un esfuerzo académico independiente y no representa una comunicación oficial de la Universidad de Antioquia ni de ninguno de los colaboradores mencionados.

Más información

About

Plantilla de Quarto para tesis y trabajos de grado de la Universidad de Antioquia - Quarto Template for Thesis and Degree Projects at the University of Antioquia

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published