|
1 | | -# Tesis RD: que el formato no sea un problema y el código no te quite el sueño |
2 | | - |
3 | | -> Extensión para [Quarto](https://quarto.org/) |
4 | | -
|
5 | | -<hr/> |
6 | | - |
7 | | -<!-- BADGES --> |
8 | | -[]() |
9 | | -[]() |
10 | | -[](https://www.repostatus.org/#active) |
11 | | -[]() |
12 | | -[]() |
13 | | -[]() |
14 | | -<!-- END BADGES --> |
15 | | - |
16 | | -<hr /> |
17 | | - |
18 | | -`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. |
19 | | - |
20 | | -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. |
21 | | - |
22 | | -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. |
23 | | - |
24 | | -Los siguientes formatos están disponibles: |
25 | | - |
26 | | -- [Instituto Tecnológico de Santo Domingo (INTEC)](https://github.com/adatar-do/tesis-rd#intec) |
27 | | - - Author: [Daniel E. de la Rosa](https://dnldelarosa.com/) |
28 | | - |
29 | | -## Instalación |
30 | | - |
31 | | -> 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. |
32 | | -
|
33 | | -Si ya iniciaste tu proyecto, ejecute el siguiente comando en la línea de comandos: |
34 | | - |
35 | | -```bash |
36 | | -quarto install extension adatar-do/tesis-rd |
37 | | -``` |
38 | | - |
39 | | -Si no has iniciado tu proyecto aún, puedes hacerlo con el siguiente comando: |
40 | | - |
41 | | -```bash |
42 | | -quarto use template adatar-do/tesis-rd |
43 | | -``` |
44 | | - |
45 | | -## Uso |
46 | | - |
47 | | -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: |
48 | | - |
49 | | -```yaml |
50 | | ---- |
51 | | -title: "Tesis-RD" |
52 | | -subtitle: "A Quarto Extension" |
53 | | -author: |
54 | | - - name: "Daniel E. de la Rosa" |
55 | | - id: 1041951 |
56 | | -advisers: |
57 | | - - "Juan Samuel Pérez Rodríguez" |
58 | | -area: Área de ingenierías |
59 | | -program: "Maestría en Ciencia de Datos (MCD)" |
60 | | -degree: "Magíster en Ciencia de Datos" |
61 | | -abstracts: |
62 | | - - title: Resumen |
63 | | - 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" |
64 | | - keywords: |
65 | | - - title: "Palabras clave" |
66 | | - content: "Visión computacional, georreferenciación" |
67 | | - - title: Abstract |
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: "Keywords" |
71 | | - content: "Computer vision, georeferencing" |
72 | | -date: today |
73 | | -format: |
74 | | - intec-docx: default |
75 | | - intec-html: default |
76 | | -bibliography: bibliography.bib |
77 | | ---- |
78 | | -``` |
79 | | - |
80 | | -Note que el argumento `format` tiene dos formatos: |
81 | | - |
82 | | -- `intec-html`: para generar el documento en formato HTML que puede ir visualizando mientras escribe su tesis. |
83 | | -- `intec-docx`: para generar el documento en formato DOCX que puede enviar a la institución para su revisión. |
84 | | - |
85 | | -> 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. --> |
86 | | -
|
87 | | -### Tabla de contenidos |
88 | | - |
89 | | -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. |
90 | | - |
91 | | -## Licencia |
92 | | - |
93 | | -Este proyecto está bajo la licencia MIT. Consulte el archivo [LICENSE](LICENSE) para obtener más información. |
94 | | - |
95 | | -## Contribución |
96 | | - |
97 | | -Las contribuciones son lo que hacen que la comunidad de código abierto sea un lugar increíble para aprender, inspirar y crear. Cualquier contribución que hagas es **muy apreciada**. |
98 | | - |
99 | | -> La contribución más básica que puedes hacer es regalar una estrella a este proyecto. :star: |
100 | | -
|
101 | | -Pero, si quieres contribuir de forma más activa, puedes hacerlo de las siguientes maneras: |
102 | | - |
103 | | -1. Asegúrese de entender cómo crear una extensión para Quarto [aquí](https://quarto.org/docs/extensions/formats.html). |
104 | | -1. Haga un fork del proyecto |
105 | | -2. Cree una rama con el nombre de la tesis que deseas agregar (`git checkout -b XXXX`) |
106 | | -3. Confirme sus cambios (`git commit -m 'tesis-XXXX agregada'`) |
107 | | -4. Suba sus cambios (`git push origin XXXX`) |
108 | | -5. Abra una solicitud de extracción (Pull Request) |
109 | | - |
110 | | -> **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! |
111 | | -
|
112 | | - |
113 | | -# Ejemplos |
114 | | - |
115 | | -## INTEC |
116 | | - |
117 | | - |
118 | | - |
119 | | - |
120 | | - |
121 | | - |
122 | | -# Tesis disponibles |
123 | | - |
124 | | -## INTEC |
125 | | - |
126 | | -- [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) |
| 1 | +# Tesis RD: que el formato no sea un problema y el código no te quite el sueño |
| 2 | + |
| 3 | +> Extensión para [Quarto](https://quarto.org/) |
| 4 | +
|
| 5 | +---- |
| 6 | + |
| 7 | +<!-- BADGES --> |
| 8 | +[]() |
| 9 | +[]() |
| 10 | +[](https://www.repostatus.org/#active) |
| 11 | +[]() |
| 12 | +[]() |
| 13 | +[]() |
| 14 | +<!-- END BADGES --> |
| 15 | + |
| 16 | +---- |
| 17 | + |
| 18 | +`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. |
| 19 | + |
| 20 | +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. |
| 21 | + |
| 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. |
| 23 | + |
| 24 | +---- |
| 25 | + |
| 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 | +---- |
| 59 | + |
| 60 | +## Instalación |
| 61 | + |
| 62 | +> Si no sabes que es **Quarto** inicia aquí: [https://adatar.do/blog/quarto/mas-que-rmarkdown-2.0.html](https://adatar.do/blog/quarto/mas-que-rmarkdown-2.0.html) |
| 63 | + |
| 64 | +**Instalación de Quarto:** |
| 65 | + |
| 66 | +Sigue los pasos indicados aquí para [instalar Quarto](https://quarto.org/docs/get-started/) en tu sistema operativo. |
| 67 | + |
| 68 | +**Opción 1:** Si ya iniciaste tu proyecto, ejecute el siguiente comando en la línea de comandos: |
| 69 | + |
| 70 | +```bash |
| 71 | +quarto install extension adatar-do/tesis-rd |
| 72 | +``` |
| 73 | + |
| 74 | +**Opción 2:** Si no has iniciado tu proyecto aún, puedes hacerlo con el siguiente comando: |
| 75 | + |
| 76 | +```bash |
| 77 | +quarto use template adatar-do/tesis-rd |
| 78 | +``` |
| 79 | + |
| 80 | +## Uso |
| 81 | + |
| 82 | +<br /> |
| 83 | + |
| 84 | +> **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))** |
| 85 | + |
| 86 | +<br/> |
| 87 | + |
| 88 | +> **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.** |
| 89 | + |
| 90 | +| Institución de Educación Superior | Autor | Documentación | |
| 91 | +| --------------------------------- | ----- | ------------- | |
| 92 | +| 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) | |
| 93 | + |
| 94 | +<br /> |
| 95 | + |
| 96 | +> **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.** |
| 97 | + |
| 98 | +<br /> |
| 99 | + |
| 100 | +- Si **Intalación -> Opción 2**, puedes comenzar a trabajar con el documento `template.qmd` y reemplazar las partes correspondientes. |
| 101 | +- Si **Instalación -> Opción 1**, cambia el header del documento a: |
| 102 | + |
| 103 | + ```yaml |
| 104 | + --- |
| 105 | + title: "Tesis-RD: A Quarto Extension" |
| 106 | + subtitle: "Que el formato no sea un problema y el código no te quite el sueño" |
| 107 | + author: |
| 108 | + - name: "Daniel E. de la Rosa" |
| 109 | + id: 1041951 |
| 110 | + - name: "Juan Pérez" |
| 111 | + id: false |
| 112 | + ies: "Instituto Tecnológico de Santo Domingo" |
| 113 | + area: Área de ingenierías |
| 114 | + program: "Maestría en Ciencia de Datos (MCD)" |
| 115 | + degree: "Magíster en Ciencia de Datos" |
| 116 | + city: "Santo Domingo, República Dominicana" |
| 117 | + abstracts: |
| 118 | + - title: Resumen |
| 119 | + 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" |
| 120 | + keywords: |
| 121 | + - title: "Palabras clave" |
| 122 | + content: "Visión computacional, georreferenciación" |
| 123 | + - title: Abstract |
| 124 | + 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" |
| 125 | + keywords: |
| 126 | + - title: "Keywords" |
| 127 | + content: "Computer vision, georeferencing" |
| 128 | + date: today |
| 129 | + format: |
| 130 | + intec-pdf: default |
| 131 | + intec-docx: default |
| 132 | + intec-html: default |
| 133 | + execute: |
| 134 | + cache: true |
| 135 | + bibliography: bibliography.bib |
| 136 | + --- |
| 137 | + ``` |
| 138 | + |
| 139 | +Note que el argumento `format` tiene tres formatos: |
| 140 | + |
| 141 | +- `intec-html`: para generar el documento en formato HTML que puede ir visualizando mientras escribe su tesis. |
| 142 | +- `intec-pdf`: para generar el documento en formato PDF que puede enviar a la institución para su revisión. |
| 143 | +- `intec-docx`: para generar el documento en formato DOCX que puede enviar a la institución para su revisión. |
| 144 | + |
| 145 | +> **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. --> |
| 146 | + |
| 147 | +> **Tabla de contenidos** <br /> |
| 148 | +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. |
| 149 | + |
| 150 | +## Licencia |
| 151 | + |
| 152 | +Este proyecto está bajo la licencia MIT. Consulte el archivo [LICENSE](LICENSE) para obtener más información. |
| 153 | + |
| 154 | +## Contribución |
| 155 | + |
| 156 | +Las contribuciones son lo que hacen que la comunidad de código abierto sea un lugar increíble para aprender, inspirar y crear. Cualquier contribución que hagas es **muy apreciada**. |
| 157 | + |
| 158 | +> La contribución más básica que puedes hacer es regalar una estrella a este proyecto. :star: |
| 159 | + |
| 160 | +Pero, si quieres contribuir de forma más activa, puedes hacerlo de las siguientes maneras: |
| 161 | + |
| 162 | +1. Asegúrese de entender cómo crear una extensión para Quarto [aquí](https://quarto.org/docs/extensions/formats.html). |
| 163 | +1. Revise la guía de usuario (#TODO) para ver como crear un nuevo formato. |
| 164 | +1. Haga un fork del proyecto |
| 165 | +2. Cree una rama con el nombre de la tesis que deseas agregar (`git checkout -b XXXX`) |
| 166 | +3. Confirme sus cambios (`git commit -m 'tesis-XXXX agregada'`) |
| 167 | +4. Suba sus cambios (`git push origin XXXX`) |
| 168 | +5. Abra una solicitud de extracción (Pull Request) |
| 169 | + |
| 170 | +> **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! |
| 171 | + |
| 172 | + |
| 173 | +# Ejemplos |
| 174 | + |
| 175 | +## INTEC |
| 176 | + |
| 177 | +<img src="https://raw.githubusercontent.com/adatar-do/tesis-rd/main/images/template_Page_1.png" style="border: 1px solid;" /> |
| 178 | + |
| 179 | +<img src="https://raw.githubusercontent.com/adatar-do/tesis-rd/main/images/template_Page_2.png" style="border: 1px solid;" /> |
| 180 | + |
| 181 | +<img src="https://raw.githubusercontent.com/adatar-do/tesis-rd/main/images/template_Page_3.png" style="border: 1px solid;" /> |
| 182 | + |
| 183 | + |
| 184 | + |
| 185 | +# Tesis disponibles |
| 186 | + |
| 187 | +## INTEC |
| 188 | + |
| 189 | +- [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) |
0 commit comments