|
1 | | -# Plantilla de curso en Quarto |
| 1 | +# Programación en Python |
2 | 2 |
|
3 | | -Plantilla de Quarto para crear sitios web para cursos. |
| 3 | +Sitio web de la asignatura **Programación en Python** de la Licenciatura en Estadística de la |
| 4 | +Universidad Nacional de Rosario. |
4 | 5 |
|
5 | | -## Uso |
6 | | - |
7 | | -### Dependencias |
8 | | - |
9 | | -- [Quarto](https://quarto.org/docs/get-started/), versión 1.8 o superior. |
10 | | - |
11 | | -### Primeros pasos |
12 | | - |
13 | | -1. En GitHub, hacer clic en el botón verde **Use this template** y crear un nuevo repositorio. |
14 | | -1. Clonar el nuevo repositorio en tu máquina local. |
15 | | -1. Modificar los archivos de configuración mencionados en |
16 | | -[Configuración del sitio](#configuración-del-sitio), según sea necesario. |
17 | | - |
18 | | -Para visualizar el sitio de forma local, se pueden usar los comandos: |
19 | | - |
20 | | -- `quarto preview` para ver los cambios en tiempo real, o |
21 | | -- `quarto render` para generar todo el sitio y explorarlo de manera estática (por defecto, guardado en `_site`). |
22 | | - |
23 | | -### Publicación |
24 | | - |
25 | | -Para publicar el sitio web en GitHub Pages, |
26 | | -ver la [documentación oficial de Quarto](https://quarto.org/docs/publishing/github-pages.html). |
27 | | - |
28 | | -Esta plantilla incluye una [acción de GitHub](.github/workflows/publish.yml) |
29 | | -para compilar y publicar el sitio de forma automática. |
30 | | - |
31 | | ->[!NOTE] |
32 | | -> Aunque se compile y publique el sitio automáticamente mediante GitHub Actions, es necesario |
33 | | -> utilizar `quarto publish gh-pages` al menos una vez de forma manual, tal como se indica en la |
34 | | -> documentación de Quarto. |
35 | | -
|
36 | | -## Configuración del sitio |
37 | | - |
38 | | -### Contenido |
39 | | - |
40 | | -La plantilla incluye contenidos de ejemplo para los datos del curso. |
41 | | -Para adaptarla a un curso específico, es necesario editar los siguientes archivos: |
42 | | - |
43 | | -* `_quarto.yml`: configuración del proyecto de Quarto. |
44 | | -Define aspectos como el nombre del curso, su logo, el favicon, el pie de página, |
45 | | -así como el contenido del _sidebar_ y del _navbar_, entre otros. |
46 | | -* `templates/front.yml`: datos del curso que se muestran en la _home_. |
47 | | -* `templates/instructors.yml`: datos de los docentes que se muestran en la _home_. |
48 | | - |
49 | | -### Estilo |
50 | | - |
51 | | -El estilo visual del sitio está determinado por los siguientes archivos: |
52 | | - |
53 | | -* `_brand.yml`: configuración del _branding_ del sitio. |
54 | | -Centraliza la definición de colores, tipografías y otros elementos visuales, |
55 | | -y establece variables que son utilizadas por los estilos SCSS de la plantilla en el archivo `styles.scss`. |
56 | | -Para más información, ver [_Multiformat branding with `_brand.yml`_](https://quarto.org/docs/authoring/brand.html). |
57 | | -* `styles.scss`: define los estilos del sitio utilizando las variables declaradas en `_brand.yml`. |
58 | | - |
59 | | -Una vez clonado el repositorio, estos archivos se pueden modificar para adaptar el sitio según se desee. |
60 | | - |
61 | | -### Otros |
62 | | - |
63 | | -- `templates/front.ejs` y `templates/instructors.ejs`: plantillas EJS que luego se utilizan en la _home_. |
64 | | -- `citas/bibliografia.bib`: archivo de bibliografía en formato BibTeX. |
65 | | - |
66 | | -## Extensiones |
67 | | - |
68 | | -Se utilizan las siguientes extensiones de Quarto: |
69 | | - |
70 | | -- [quarto-ext/fontawesome](https://github.com/quarto-ext/fontawesome): para usar íconos de Font Awesome. |
71 | | -- [pandoc-ext/section-bibliographies](https://github.com/pandoc-ext/section-bibliographies): para generar bibliografías por sección. |
| 6 | +El sitio fue creado a partir de la plantilla [quarto-curso-plantilla](https://github.com/tomicapretto/quarto-curso-plantilla). |
0 commit comments