Skip to content

Commit 29e690e

Browse files
tomicaprettotomicapretto
authored
Initial commit
0 parents  commit 29e690e

46 files changed

Lines changed: 10157 additions & 0 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/workflows/publish.yml‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
name: Compilar y publicar sitio web
2+
3+
on:
4+
workflow_dispatch:
5+
push:
6+
branches: main
7+
8+
jobs:
9+
build-deploy:
10+
runs-on: ubuntu-latest
11+
permissions:
12+
contents: write
13+
steps:
14+
- name: Check out repository
15+
uses: actions/checkout@v4
16+
17+
- name: Set up Quarto
18+
uses: quarto-dev/quarto-actions/setup@v2
19+
with:
20+
version: 1.8.26
21+
22+
- name: Render Webpage
23+
shell: bash
24+
run: quarto render
25+
26+
- name: Publish to GitHub
27+
uses: quarto-dev/quarto-actions/publish@v2
28+
with:
29+
target: gh-pages
30+
render: false
31+
path: _site
32+
env:
33+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
34+

‎.gitignore‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# Salida de Quarto
2+
_site/
3+
.quarto/
4+
5+
# Archivos temporales
6+
*.DS_Store
7+
.Rhistory
8+
.RData
9+
.Rproj.user/
10+
11+
/.quarto/
12+
13+
/.luarc.json
14+
15+
**/*.quarto_ipynb

‎README.md‎

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
# Plantilla de curso en Quarto
2+
3+
Plantilla de Quarto para crear sitios web para cursos.
4+
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.

‎_brand.yml‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
color:
2+
palette:
3+
white: "#ffffff"
4+
blue: "#699cc5"
5+
blue-light: "#cddeec"
6+
blue-dark: "#233a4c"
7+
red: "#bf3830"
8+
red-light: "#cc6059"
9+
red-dark: "#992d26"
10+
gray-100: "#dedfe0"
11+
gray-200: "#bcbfc1"
12+
gray-300: "#9b9ea1"
13+
gray-400: "#797e82"
14+
gray-500: "#585e63"
15+
gray-600: "#464b4f"
16+
gray-700: "#35383b"
17+
gray-800: "#232628"
18+
gray-900: "#121314"
19+
20+
typography:
21+
fonts:
22+
- family: Source Sans Pro
23+
source: google
24+
- family: Roboto Slab
25+
source: google
26+
- family: Cascadia Code
27+
source: google
28+
base:
29+
family: Source Sans Pro
30+
headings:
31+
family: Roboto Slab
32+
monospace:
33+
family: Cascadia Code
34+
35+
defaults:
36+
bootstrap:
37+
defaults:
38+
# General text color
39+
body-font-color: $brand-gray-800
40+
41+
# General links
42+
link-font-color: $brand-red
43+
link-font-color-hover: $brand-red-light
44+
link-font-color-active: $brand-red-dark
45+
46+
# Navbar styles
47+
navbar-font-family: Roboto Slab
48+
navbar-background-color: $brand-blue
49+
navbar-font-color: $brand-white
50+
navbar-font-color-hover: $brand-blue-light
51+
navbar-font-color-active: $brand-blue-dark
52+
53+
navbar-decoration-color-hover: $brand-blue # "Invisible"
54+
navbar-decoration-color-active: $brand-blue # "Invisible"
55+
56+
# Footer styles
57+
footer-background-color: $brand-gray-600
58+
footer-font-color: $brand-gray-100
59+
footer-link-color: $brand-gray-100
60+
footer-link-color-hover: $brand-white
61+
62+
# Sidebar
63+
sidebar-font-color: $brand-gray-600
64+
sidebar-link-font-color: $brand-gray-600
65+
sidebar-link-font-color-hover: $brand-gray-300
66+
sidebar-link-font-color-active: $brand-gray-900
67+
sidebar-link-text-decoration: underline
68+
sidebar-link-text-decoration-thickness: 1px
69+
sidebar-code-color: $brand-gray-600
70+
71+
# Pagination links
72+
pagination-font-color: $brand-gray-800
73+
pagination-font-color-hover: $brand-gray-600

‎_extensions/pandoc-ext/section-bibliographies/_extension.yml‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
title: section-bibliographies
2+
author: Albert Krewinkel
3+
version: 0.0.1
4+
contributes:
5+
filters:
6+
- section-bibliographies.lua

0 commit comments

Comments
 (0)