Skip to content

Commit 3f0bcc1

Browse files
committed
feat: v1.0.0
intec-pdf y otros cambios
1 parent 6eca0eb commit 3f0bcc1

File tree

11 files changed

+308
-178
lines changed

11 files changed

+308
-178
lines changed

README.md

Lines changed: 109 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,8 @@
1-
QUITA EL CÓDIGO DEL TEMPLATE
2-
3-
4-
5-
61
# Tesis RD: que el formato no sea un problema y el código no te quite el sueño
72

83
> Extensión para [Quarto](https://quarto.org/)
94
10-
<hr/>
5+
----
116

127
<!-- BADGES -->
138
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/adatar-do/tesis-rd?include_prereleases)]()
@@ -18,80 +13,135 @@ QUITA EL CÓDIGO DEL TEMPLATE
1813
[![GitHub contributors](https://img.shields.io/github/contributors/adatar-do/tesis-rd)]()
1914
<!-- END BADGES -->
2015

21-
<hr />
16+
----
2217

2318
`tesis-rd` facilita la utilización de Quarto para la generación de tesis con los formatos de las distintas instituciones de educación superior de República Dominicana.
2419

2520
Al utilizar `tesis-rd` no tendrás que preocuparte por el formato de la tesis, ya que este se encarga de generarla en el formato requerido por la institución de educación superior que elijas, cada vez que generes el documento.
2621

27-
Además, al estar basado en Quarto, `tesis-rd` te permite utilizar programación literaria para generar tus gráficos, tablas y demás elementos de la tesis, con todos los beneficios que esto conlleva.
22+
Además, al estar basado en Quarto, `tesis-rd` te permite utilizar <a href="https://adatar.do/blog/quarto/programacion-literaria-como-tenia-que-ser.html"> programación literaria</a> para generar tus gráficos, tablas y demás elementos de la tesis, con todos los beneficios que esto conlleva.
2823

29-
Los siguientes formatos están disponibles:
24+
----
3025

31-
- [Instituto Tecnológico de Santo Domingo (INTEC)](https://github.com/adatar-do/tesis-rd#intec)
32-
- Author: [Daniel E. de la Rosa](https://dnldelarosa.com/)
26+
## Change Log
27+
28+
> **Importante**
29+
> <br/> Este proyecto está en desarrollo y puede cambiar en cualquier momento. A continuación, se muestran los cambios que se han realizado en cada versión.
30+
31+
> **Versión 1.0.0-beta** (Octubre 2022)
32+
> - Primer release de la extensión.
33+
34+
> **Versión 1.0.0** (Enero 2023)
35+
- Esta versión es compatible con Quarto 1.2.198 o superior.
36+
- Se agregó la formato PDF del Instituto Tecnológico de Santo Domingo (INTEC).
37+
- Se realizaron los siguientes cambios en todas los formatos:
38+
- Se eliminó el argumento `advisers` del header del documento. Los asesores se agregan en el argumento `author` del header del documento con el siguiente formato:
39+
```yaml
40+
...
41+
author:
42+
- name: "Daniel E. de la Rosa"
43+
id: 1041951
44+
- name: "Juan Pérez"
45+
id: false
46+
...
47+
```
48+
- Se agregaron los argumentos `ies` y `city` al header del documento.
49+
```yaml
50+
...
51+
ies: "Nombre de la IES"
52+
...
53+
city: "Santo Domingo, República Dominicana"
54+
...
55+
```
56+
- Se realizaron otros cambios menores a nivel de la extensión y de los formatos.
57+
58+
----
3359

3460
## Instalación
3561

3662
> Quarto introdujo muchos cambios en el API de las extensiones en la versión 1.2.0. Esta versión de `tesis-rd` es compatible con Quarto 1.2.0 o superior.
3763

38-
Si ya iniciaste tu proyecto, ejecute el siguiente comando en la línea de comandos:
64+
**Opción 1:** Si ya iniciaste tu proyecto, ejecute el siguiente comando en la línea de comandos:
3965

4066
```bash
4167
quarto install extension adatar-do/tesis-rd
4268
```
4369

44-
Si no has iniciado tu proyecto aún, puedes hacerlo con el siguiente comando:
70+
**Opción 2:** Si no has iniciado tu proyecto aún, puedes hacerlo con el siguiente comando:
4571

4672
```bash
4773
quarto use template adatar-do/tesis-rd
4874
```
4975

5076
## Uso
5177

52-
Si clonaste este repositorio, puedes comenzar a trabajar con el documento `template.qmd` y reemplazar las partes correspondientes. Si ya habías comenzado tu trabajo, cambia el header del documento a:
53-
54-
```yaml
55-
---
56-
title: "Tesis-RD"
57-
subtitle: "A Quarto Extension"
58-
author:
59-
- name: "Daniel E. de la Rosa"
60-
id: 1041951
61-
- name: "Juan Samuel Pérez Rodríguez"
62-
id: false
63-
area: Área de ingenierías
64-
program: "Maestría en Ciencia de Datos (MCD)"
65-
degree: "Magíster en Ciencia de Datos"
66-
abstracts:
67-
- title: Resumen
68-
content: "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus sollicitudin ligula eu leo tincidunt, quis scelerisque magna dapibus. Sed eget ipsum vel arcu vehicula ullamcorper"
69-
keywords:
70-
- title: "Palabras clave"
71-
content: "Visión computacional, georreferenciación"
72-
- title: Abstract
73-
content: "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus sollicitudin ligula eu leo tincidunt, quis scelerisque magna dapibus. Sed eget ipsum vel arcu vehicula ullamcorper"
74-
keywords:
75-
- title: "Keywords"
76-
content: "Computer vision, georeferencing"
77-
date: today
78-
format:
79-
intec-docx: default
80-
intec-html: default
81-
bibliography: bibliography.bib
82-
---
83-
```
84-
85-
Note que el argumento `format` tiene dos formatos:
78+
<br />
79+
80+
> **Consulte la guía de usuario (#TODO) para obtener más información sobre el uso de `tesis-rd`. ([https://adatar.do/blog/tesis-rd/guia-usuario.html](https://adatar.do/blog//tesis-rd/guia-usuario.html))**
81+
82+
<br/>
83+
84+
> **Consulte la documentación de cada formato (#TODO), en la tabla a continuación, para obtener más información sobre el uso de `tesis-rd` con cada formato.**
85+
86+
| Institución de Educación Superior | Autor | Documentación |
87+
| --------------------------------- | ----- | ------------- |
88+
| Instituto Tecnológico de Santo Domingo (INTEC) | [Daniel E. de la Rosa](https://dnldelarosa.com/) | [https://adatar.do/blog/tesis-rd/intec.html](https://adatar.do/blog/tesis-rd/intec.html) |
89+
90+
<br />
91+
92+
> **A continuación, se muestran los pasos para utilizar `tesis-rd` con el formato del Instituto Tecnológico de Santo Domingo (INTEC). Pero, el proceso es similar para los "demás" formatos.**
93+
94+
<br />
95+
96+
- Si **Intalación -> Opción 2**, puedes comenzar a trabajar con el documento `template.qmd` y reemplazar las partes correspondientes.
97+
- Si **Instalación -> Opción 1**, cambia el header del documento a:
98+
99+
```yaml
100+
---
101+
title: "Tesis-RD: A Quarto Extension"
102+
subtitle: "Que el formato no sea un problema y el código no te quite el sueño"
103+
author:
104+
- name: "Daniel E. de la Rosa"
105+
id: 1041951
106+
- name: "Juan Pérez"
107+
id: false
108+
ies: "Instituto Tecnológico de Santo Domingo"
109+
area: Área de ingenierías
110+
program: "Maestría en Ciencia de Datos (MCD)"
111+
degree: "Magíster en Ciencia de Datos"
112+
city: "Santo Domingo, República Dominicana"
113+
abstracts:
114+
- title: Resumen
115+
content: "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus sollicitudin ligula eu leo tincidunt, quis scelerisque magna dapibus. Sed eget ipsum vel arcu vehicula ullamcorper"
116+
keywords:
117+
- title: "Palabras clave"
118+
content: "Visión computacional, georreferenciación"
119+
- title: Abstract
120+
content: "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus sollicitudin ligula eu leo tincidunt, quis scelerisque magna dapibus. Sed eget ipsum vel arcu vehicula ullamcorper"
121+
keywords:
122+
- title: "Keywords"
123+
content: "Computer vision, georeferencing"
124+
date: today
125+
format:
126+
intec-pdf: default
127+
intec-docx: default
128+
intec-html: default
129+
execute:
130+
cache: true
131+
bibliography: bibliography.bib
132+
---
133+
```
134+
135+
Note que el argumento `format` tiene tres formatos:
86136

87137
- `intec-html`: para generar el documento en formato HTML que puede ir visualizando mientras escribe su tesis.
138+
- `intec-pdf`: para generar el documento en formato PDF que puede enviar a la institución para su revisión.
88139
- `intec-docx`: para generar el documento en formato DOCX que puede enviar a la institución para su revisión.
89140

90-
> Asegúrese de colocar el formato intec-docx primero cuando quiera generar el documento final. <!-- Además de cambiar el argumento `draft` a `false` para eliminar la marca de agua del documento. -->
141+
> **Asegúrese de colocar el formato intec-pdf o intec-docx primero cuando quiera generar el documento final.** <!-- Además de cambiar el argumento `draft` a `false` para eliminar la marca de agua del documento. -->
91142

92-
### Tabla de contenidos
93-
94-
Nótese que el argumento `toc` fue omitido en el header. **No debe agregar el argumento `toc`**. Este se agrega de forma automática en el documento `html` y debe ser insertado manualmente en el documento `docx` en la posición indicada en el propio documento.
143+
> **Tabla de contenidos** <br />
144+
Nótese que el argumento `toc` fue omitido en el header. Esto así porque `tesis-rd` ya incluye una tabla de contenidos en el formato del INTEC. Excepto en el formato DOCX, donde la tabla se debe insertar manualmente en el lugar indicado.
95145

96146
## Licencia
97147

@@ -106,36 +156,30 @@ Las contribuciones son lo que hacen que la comunidad de código abierto sea un l
106156
Pero, si quieres contribuir de forma más activa, puedes hacerlo de las siguientes maneras:
107157

108158
1. Asegúrese de entender cómo crear una extensión para Quarto [aquí](https://quarto.org/docs/extensions/formats.html).
159+
1. Revise la guía de usuario (#TODO) para ver como crear un nuevo formato.
109160
1. Haga un fork del proyecto
110161
2. Cree una rama con el nombre de la tesis que deseas agregar (`git checkout -b XXXX`)
111162
3. Confirme sus cambios (`git commit -m 'tesis-XXXX agregada'`)
112163
4. Suba sus cambios (`git push origin XXXX`)
113164
5. Abra una solicitud de extracción (Pull Request)
114165

115-
> **Nota**: Si no está seguro de cómo hacerlo, puede abrir un problema (issue) [en el repositorio](https://github.com/adatar-do/tesis-rd/issues) y alguien lo hará por usted. ¡Esa es la magia de la comunidad de código abierto!
166+
> **Nota**: Si no está seguro de cómo hacerlo, puede abrir un problema (issue) [en el repositorio](https://github.com/adatar-do/tesis-rd/issues) y de seguro alguien lo hará por usted. ¡Esa es la magia de la comunidad de código abierto!
116167

117168

118-
# Ejemplos
169+
# Ejemplos
119170

120171
## INTEC
121172

122-
<img src="https://raw.githubusercontent.com/adatar-do/tesis-rd/main/images/intec1.png" style="border: 1px solid;" />
173+
<img src="https://raw.githubusercontent.com/adatar-do/tesis-rd/main/images/template_Page_1.png" style="border: 1px solid;" />
174+
175+
<img src="https://raw.githubusercontent.com/adatar-do/tesis-rd/main/images/template_Page_2.png" style="border: 1px solid;" />
176+
177+
<img src="https://raw.githubusercontent.com/adatar-do/tesis-rd/main/images/template_Page_3.png" style="border: 1px solid;" />
123178

124-
<img src="https://raw.githubusercontent.com/adatar-do/tesis-rd/main/images/intec2.png" style="border: 1px solid;" />
125179

126180

127181
# Tesis disponibles
128182

129183
## INTEC
130184

131185
- [de la Rosa, D. & Pérez, J. (2022). Georreferenciación de imágenes utilizando visión computacional: el caso del mapa de la República Dominicana. [Trabajo final de maestría, Instituto Tecnológico de Santo Domingo (INTEC)]. https://github.com/dnldelarosa/tesis-maestria-ciencia-datos](https://github.com/dnldelarosa/tesis-maestria-ciencia-datos)
132-
133-
134-
135-
136-
137-
Cambios entre la versión 1 y la versión 2:
138-
139-
- se agregó ies
140-
- se agregó city
141-
- advisers pasó a formar parte de author

_extensions/intec/_extension.yml

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
title: Tesis INTEC
22
author: Daniel E. de la Rosa
3-
version: 2.0.0
3+
version: 1.0.0
44
quarto-required: ">=1.2.198"
55
contributes:
66
formats:
@@ -9,19 +9,21 @@ contributes:
99
req: "Para cumplir con parte de los requerimientos establecidos para obtener el título de "
1010
date-format: long
1111
lang: es
12-
html:
13-
toc: true
14-
number-sections: true
1512
csl: apa-numeric-superscript-brackets.csl
13+
number-sections: true
1614
pdf:
1715
toc: true
16+
lof: true
17+
lot: true
1818
logo: logo.png
19+
bg: back.jpg
20+
white: white.png
1921
template: template.tex
2022
template-partials:
2123
- "partials/title.tex"
24+
pagestyle: fancy
25+
html:
26+
toc: true
2227
docx:
2328
filters: [cover.lua, summary.lua, tocs.lua, header.lua, footer.lua]
2429
reference-doc: custom-reference-doc.docx
25-
csl: apa-numeric-superscript-brackets.csl
26-
toc: false
27-
number-sections: true
-40 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)