aboutsummaryrefslogtreecommitdiff
path: root/content/overview-abridge/index.es.md
diff options
context:
space:
mode:
authorJieiku2026-08-19 11:51:59 -0700
committerJieiku2026-08-19 11:51:59 -0700
commitaaa4fae60d0e1b87af917829af1b1b4cceca9e31 (patch)
tree1ca45acb83fb5d4a6222aa92dc5ba682abb1e4b9 /content/overview-abridge/index.es.md
parente90d09750f7958ad42db340d68248b0842e6fcb4 (diff)
downloadabridge-aaa4fae60d0e1b87af917829af1b1b4cceca9e31.tar.gz
abridge-aaa4fae60d0e1b87af917829af1b1b4cceca9e31.tar.bz2
abridge-aaa4fae60d0e1b87af917829af1b1b4cceca9e31.zip
Update Documentation
Diffstat (limited to 'content/overview-abridge/index.es.md')
-rw-r--r--content/overview-abridge/index.es.md59
1 files changed, 35 insertions, 24 deletions
diff --git a/content/overview-abridge/index.es.md b/content/overview-abridge/index.es.md
index 99778b6..a17b4a8 100644
--- a/content/overview-abridge/index.es.md
+++ b/content/overview-abridge/index.es.md
@@ -29,7 +29,7 @@ Un tema para [Zola](https://getzola.org) rápido, ligero y moderno que utiliza H
- Temas Dark, Light, Auto y Switcher. (colores personalizables, variables css)
- [Resaltado de sintaxis de](https://abridge.pages.dev/overview-code-blocks/) código. (colores personalizables, variables css)
- Bloques de código numerados con [resaltado de línea](https://abridge.pages.dev/overview-code-blocks/#toml).
-- Sitio completamente Offline usando el PWA **o** configurando `search_library = "offline"` en `config.toml`.
+- Sitio completamente Offline usando el PWA **o** configurando `search_library = "offline"` en `zola.toml`.
- Soporte multi-idioma.
- Soporte para búsquedas.[(elasticlunr](https://abridge.pages.dev/), [pagefind](https://abridge-pagefind.pages.dev/), [tinysearch](https://abridge-tinysearch.pages.dev/))
- Sugerencias de búsqueda teclas de navegación, `/` focus, `arrow` move, `enter` select, `escape` close.
@@ -52,6 +52,17 @@ Un tema para [Zola](https://getzola.org) rápido, ligero y moderno que utiliza H
- Media Components: [video](https://abridge.pages.dev/overview-rich-content/#video), [img](https://abridge.pages.dev/overview-images/#img-component), [imgswap](https://abridge.pages.dev/overview-images/#imgswap-component), [image](https://abridge.pages.dev/overview-rich-content/#image), [gif](https://abridge.pages.dev/overview-rich-content/#gif), [audio](https://abridge.pages.dev/overview-rich-content/#audio).
- Otros Components: [showdata](https://abridge.pages.dev/overview-showdata/), [katex](https://abridge.pages.dev/overview-math/#usage-1).
+## Usuarios de Windows
+
+A continuación utilizo algunos comandos de Linux durante la configuración; para contar con un entorno similar, puedes instalar [Msys2](https://www.msys2.org/).
+En Msys2, utiliza Shift + Insert para pegar en la terminal; yo prefiero el lanzador UCRT64.
+
+```bash
+MSYS2
+pacman -Syu
+pacman -S --needed mingw-w64-ucrt-x86_64-git mingw-w64-ucrt-x86_64-zola rsync
+```
+
## Inicio rápido
Este tema requiere la versión {{<showdata src="https://raw.githubusercontent.com/Jieiku/abridge/master/theme.toml" key="min_version" type="toml" page={page} config={config} />}} o posterior de [Zola](https://www.getzola.org/documentation/getting-started/installation/)
@@ -97,7 +108,7 @@ Copia algunos archivos del directorio del tema al directorio raíz de tu proyect
```bash
rsync themes/abridge/.gitignore .gitignore
-rsync themes/abridge/config.toml config.toml
+rsync themes/abridge/zola.toml zola.toml
rsync themes/abridge/content/_index.md content/
rsync -r themes/abridge/COPY-TO-ROOT-SASS/* sass/
rsync themes/abridge/netlify.toml netlify.toml
@@ -105,17 +116,17 @@ rsync themes/abridge/package_abridge.js package_abridge.js
rsync themes/abridge/package.json package.json
```
-- `config.toml` configuración base con todos los valores de configuración.
+- `zola.toml` configuración base con todos los valores de configuración.
- `content/_index.md` requerido para establecer la paginación.
- `COPY-TO-ROOT-SASS/abridge.scss` overrides para personalizar las variables de Abridge.
- `netlify.toml` configuración para desplegar su repo con netlfiy.
- `package_abridge.js` node script para: actualizar la lista de archivos de caché en PWA, minify js, bundle js
- `package.json` utilizado por node, define scripts y dependencias.
-Descomenta la línea theme en el config.toml raíz de tu proyecto:
+Descomenta la línea theme en el zola.toml raíz de tu proyecto:
```bash
-sed -i 's/^#theme = "abridge"/theme = "abridge"/' config.toml
+sed -i 's/^#theme = "abridge"/theme = "abridge"/' zola.toml
```
### 4: Añadir nuevo contenido
@@ -136,7 +147,7 @@ zola serve
Zola iniciará el servidor web dev, accesible por defecto en `http://127.0.0.1:1111`.
-Los cambios guardados se recargarán en vivo en el navegador. (pulse `ctrl+f5`, o mientras desarrolla configure `pwa=false` en `config.toml`)
+Los cambios guardados se recargarán en vivo en el navegador. (pulse `ctrl+f5`, o mientras desarrolla configure `pwa=false` en `zola.toml`)
## Paginación {% raw %}{#pagination}{% endraw %}
@@ -198,10 +209,10 @@ Si tiene abridge configurado para utilizar el modo conmutador en lugar de auto/o
Si su visitante utiliza noscript o algún otro complemento de navegador que bloquee javascript, entonces estará atascado con cualquiera que sea el tema configurado por defecto para el modo conmutador.
-Para ajustar este modo, debe establecer los siguientes dos valores de configuración en `abridge.scss` **Y** `config.toml`:
+Para ajustar este modo, debe establecer los siguientes dos valores de configuración en `abridge.scss` **Y** `zola.toml`:
```scss
-$switcherDefault: "dark",// default nojs switcher mode: dark, light (make sure to also set js_switcher_default in config.toml)
+$switcherDefault: "dark",// default nojs switcher mode: dark, light (make sure to also set js_switcher_default in zola.toml)
```
```toml
@@ -210,13 +221,13 @@ js_switcher_default = "dark" # default nojs switcher mode: dark, light (make sur
Por defecto abridge utiliza el modo oscuro para el conmutador, así que a menos que desee establecer el modo por defecto a la luz para los visitantes nojs/noscript, entonces usted no necesita preocuparse acerca de estos ajustes.
-## Config.toml Configuración
+## zola.toml Configuración
-La mayoría de las opciones en `config.toml` se documentan por sí mismas. (obvio entre el nombre del valor config y los comentarios)
+La mayoría de las opciones en `zola.toml` se documentan por sí mismas. (obvio entre el nombre del valor config y los comentarios)
-Abridge trabajará con un `config.toml` barebones porque los valores por defecto se proporcionan en los archivos de plantilla.
+Abridge trabajará con un `zola.toml` barebones porque los valores por defecto se proporcionan en los archivos de plantilla.
-Recomiendo copiar todo el archivo config.toml como se indica en el paso 3, ya que proporciona todos los valores configurables.
+Recomiendo copiar todo el archivo zola.toml como se indica en el paso 3, ya que proporciona todos los valores configurables.
### Menús superior y pie de página
@@ -243,13 +254,13 @@ menu_footer = [
### Etiquetas SEO y de cabecera {% raw %}{#seo}{% endraw %}
-Puede revisar las etiquetas SEO en la component seo ubicada en `templates/components/seo.html`, todos los valores configurables deben estar en `config.toml` bajo `config.extra` o en los archivos markdown de contenido.
+Puede revisar las etiquetas SEO en la component seo ubicada en `templates/components/seo.html`, todos los valores configurables deben estar en `zola.toml` bajo `config.extra` o en los archivos markdown de contenido.
En el archivo markdown de su post debe establecer un título de menos de 60 caracteres y una descripción de entre 80 y 160 caracteres de longitud. La descripción es lo que se muestra en los resultados de búsqueda debajo del título de la página. Si no especifica una descripción de página, se utilizará en su lugar el archivo config.description del sitio principal.
-También debe establecer palabras clave específicas de la página a menos que sus palabras clave definidas en config.toml sean suficientes, cualquier palabra clave que añada a la página es adicional a las definidas en config.toml, así que no añada esas mismas palabras clave a sus palabras clave de la página.
+También debe establecer palabras clave específicas de la página a menos que sus palabras clave definidas en zola.toml sean suficientes, cualquier palabra clave que añada a la página es adicional a las definidas en zola.toml, así que no añada esas mismas palabras clave a sus palabras clave de la página.
-Opcionalmente, también puede establecer una imagen específica de la página para los resultados de búsqueda utilizando page.extra.thumbnail. Facebook, Twitter y OpenGraph Cards son compatibles (imagen y descripción automáticas para los enlaces publicados). OpenGraph recomienda 1200 x 630 (1,9:1). Twitter recomienda 2:1 para las grandes y 1:1 para las pequeñas. Si no establece una miniatura específica para la página, se utilizará en su lugar el banner definido en config.toml.
+Opcionalmente, también puede establecer una imagen específica de la página para los resultados de búsqueda utilizando page.extra.thumbnail. Facebook, Twitter y OpenGraph Cards son compatibles (imagen y descripción automáticas para los enlaces publicados). OpenGraph recomienda 1200 x 630 (1,9:1). Twitter recomienda 2:1 para las grandes y 1:1 para las pequeñas. Si no establece una miniatura específica para la página, se utilizará en su lugar el banner definido en zola.toml.
Consulta [overview-images](https://raw.githubusercontent.com/Jieiku/abridge/master/content/overview-images/index.md) para ver un ejemplo:
@@ -266,7 +277,7 @@ KaTeX se puede utilizar para mostrar matemáticas complejas, es una "Rápida com
Puedes ver una demo en [esta página](https://abridge.pages.dev/overview-math/).
-Para un mejor rendimiento, recomiendo sólo habilitar las matemáticas en una [base por página en sus archivos post.md](https://github.com/Jieiku/abridge/blob/master/content/overview-math.md?plain=1#L11-L13), en lugar de en su archivo config.toml principal.
+Para un mejor rendimiento, recomiendo sólo habilitar las matemáticas en una [base por página en sus archivos post.md](https://github.com/Jieiku/abridge/blob/master/content/overview-math.md?plain=1#L11-L13), en lugar de en su archivo zola.toml principal.
### PWA, Aplicación Web Progresiva {% raw %}{#pwa}{% endraw %}
@@ -276,15 +287,15 @@ Si utilizas Chrome en tu ordenador, busca el botón de instalación al final de
Hay un script npm para generar la lista de caché de archivos y la minificación `npm run abridge`. Mi archivo [netlify.toml](https://github.com/Jieiku/abridge/blob/master/netlify.toml) ejecuta automáticamente este script npm durante el despliegue del sitio, por lo que todo es automático. Si Zola fuera capaz de crear un archivo js, entonces sería posible generar la lista de archivos de caché dinámicamente durante la compilación en lugar de depender de node/npm.
-Para utilizar una lista específica de archivos en lugar de todos los archivos de editar la entrada `pwa_BASE_CACHE_FILES` en `config.toml`. Si incluso un solo archivo en la lista de caché no se encuentra entonces no pre caché de la lista, por lo que sólo la caché a medida que navega. (Si está configurando por primera vez, pruebe sólo con un par de páginas)
+Para utilizar una lista específica de archivos en lugar de todos los archivos de editar la entrada `pwa_BASE_CACHE_FILES` en `zola.toml`. Si incluso un solo archivo en la lista de caché no se encuentra entonces no pre caché de la lista, por lo que sólo la caché a medida que navega. (Si está configurando por primera vez, pruebe sólo con un par de páginas)
-La función PWA también es fácil de desactivar simplemente configurando `pwa = false` en `config.toml`
+La función PWA también es fácil de desactivar simplemente configurando `pwa = false` en `zola.toml`
## Optimización del rendimiento
### Archivos Javascript
-Todo javascript puede ser desactivado en `config.toml`:
+Todo javascript puede ser desactivado en `zola.toml`:
```toml
build_search_index = false
@@ -317,7 +328,7 @@ Estos son los archivos javascript utilizados por Abridge:
Todos los bundles necesarios son generados dinámicamente por el script node [package\_abridge.js](https://github.com/Jieiku/abridge/blob/master/package_abridge.js)
-El script node escaneará su config.toml en busca de los valores de configuración relevantes y, basándose en su config.tomnl, generará los paquetes necesarios.
+El script node escaneará su zola.toml en busca de los valores de configuración relevantes y, basándose en su config.tomnl, generará los paquetes necesarios.
Todo lo que se necesita es `zola build && npm run abridge`.
@@ -335,7 +346,7 @@ Para utilizar tinysearch se requieren pasos adicionales.
```bash
npm install
-sed -i 's/^search_library =.*/search_library = "pagefind"/' config.toml
+sed -i 's/^search_library =.*/search_library = "pagefind"/' zola.toml
npm run abridge
# zola serve
```
@@ -343,14 +354,14 @@ npm run abridge
**Cambiar a elasticlunr:**
```bash
-sed -i 's/^search_library =.*/search_library = "elasticlunr"/' config.toml
+sed -i 's/^search_library =.*/search_library = "elasticlunr"/' zola.toml
npm run abridge
```
**Cambiar a nosearch:**
```bash
-sed -i 's/^search_library =.*/search_library = "false"/' config.toml
+sed -i 's/^search_library =.*/search_library = "false"/' zola.toml
npm run abridge
```
@@ -369,7 +380,7 @@ exit # reload shell environment
Cambiar Abridge a tinysearch
```bash
-sed -i 's/^search_library =.*/search_library = "tinysearch"/' config.toml
+sed -i 's/^search_library =.*/search_library = "tinysearch"/' zola.toml
npm run abridge
tinysearch --optimize --path static public/data_tinysearch/index.html
# zola serve