Skip to content

Commit 8a0dfc7

Browse files
committed
Actualizo readme
1 parent 5a50f90 commit 8a0dfc7

1 file changed

Lines changed: 4 additions & 69 deletions

File tree

README.md

Lines changed: 4 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -1,71 +1,6 @@
1-
# Plantilla de curso en Quarto
1+
# Programación en Python
22

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.
45

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

Comments
 (0)