Instalación
Qué hace falta antes de empezar.
Herramientas
Todo lo que se puede usar al escribir una entrada, con el resultado y cómo se escribe cada cosa.
Esta entrada es una chuleta. Cada sección enseña un recurso tal y como se ve y, debajo, el código para escribirlo. El recuadro de Ficha de arriba y los bloques del final (Referencias, Relacionado, Mencionado en) salen solos del frontmatter: están explicados en Bloques automáticos.
Los componentes (<Aside>, <Tabs>, etc.) solo funcionan en archivos .mdx y hay que importarlos al principio, justo después del frontmatter:
import { Aside, Tabs, TabItem } from '@astrojs/starlight/components';El título de la página sale del frontmatter (title) y la entradilla gris de description. Dentro del texto se usan ##, ### y ####. Los ## llevan una línea separadora encima y, junto con los ###, aparecen en el índice de la derecha.
## Título de sección### Subsección#### DetalleUn párrafo normal con negrita, cursiva, las dos, tachado, código en línea y un atajo de teclado como Ctrl + K. También hay superíndice (m2), subíndice (H2O) y texto resaltado.
Un salto de línea dentro del mismo párrafo se hace con una barra invertida al final
y el texto sigue en la línea siguiente.
**negrita**, *cursiva*, ***las dos***, ~~tachado~~, `código en línea`<kbd>Ctrl</kbd> + <kbd>K</kbd>m<sup>2</sup>, H<sub>2</sub>O, <mark>texto resaltado</mark>Línea que sigue\en la siguiente[Servicios](/servicios)[ir a Bloques de código](#bloques-de-código)[documentación de Astro Starlight](https://starlight.astro.build/es/)Texto con una nota.[^1]
[^1]: Contenido de la nota.Tarjetas para mandar a otras páginas. Una suelta:
O varias en rejilla:
Y tarjetas con icono para agrupar ideas (no son enlaces):
Instalación
Qué hace falta antes de empezar.
Uso diario
Los comandos que más se repiten.
<LinkCard title="Herramientas" href="/herramientas" description="Texto de la tarjeta." />
<CardGrid> <LinkCard title="Técnicas" href="/tecnicas" description="..." /> <LinkCard title="Metodologías" href="/metodologias" description="..." /></CardGrid>
<Card title="Instalación" icon="setting">Contenido.</Card>Las listas de tareas son checklists interactivas: se pueden marcar, el estado se guarda en tu navegador y debajo aparece el progreso con un botón para reiniciar. Lo que esté marcado con [x] en el texto empieza marcado. Es lo que usan las Metodologías para sus pasos.
- Elemento - Anidado
1. Primer paso2. Segundo paso
- [x] Tarea hecha- [ ] Tarea pendienteUna cita o un fragmento copiado de la documentación oficial. Sirve para separar lo que dice la fuente de lo que explicas tú.
> Texto citado.Cuatro tipos, de menos a más importante.
:::noteTexto del aviso.:::
:::caution[Título personalizado]Tipos: note, tip, caution, danger.:::Todos los bloques tienen botón de copiar (aparece al pasar el ratón). Se indica el lenguaje justo después de las tres comillas para colorear la sintaxis.
Con lenguaje de shell y un title, el bloque se dibuja como una ventana de terminal:
sudo apt updatersync -az --delete dist/ usuario@servidor:/var/www/sitio/Con otro lenguaje, el title se muestra como la pestaña del archivo:
server { listen 80; server_name ejemplo.com; root /var/www/sitio;}Para salidas de comandos o texto plano, frame="none" quita la ventana:
Filesystem Size Used Avail Use% Mounted on/dev/sda1 40G 12G 26G 32% /Líneas marcadas {2}, añadidas ins={3}, quitadas del={4} y una palabra resaltada "root":
server { listen 80; listen 443 ssl; server_name viejo.ejemplo.com; root /var/www/sitio;}Con el lenguaje diff, las líneas que empiezan por + y - se colorean:
services: web: image: nginx:1.25 image: nginx:1.27Con wrap, las líneas largas se parten en vez de obligar a hacer scroll lateral:
docker run --rm -it --name prueba -p 8080:80 -v "$(pwd)/html:/usr/share/nginx/html:ro" -e TZ=Europe/Madrid nginx:alpineEscribe los datos que cambian como {NOMBRE} (mayúsculas, números y _). Pulsa el botón { } de la cabecera o Alt + V, rellena los valores y se sustituyen en todos los comandos de la wiki, también en lo que copia el botón de copiar. Sin valor, el placeholder se ve resaltado; al hacer clic en uno se abre el panel en esa variable. Los valores se guardan solo en tu navegador.
ssh {USUARIO}@{SERVIDOR} -p {PUERTO}rsync -az --delete dist/ {USUARIO}@{SERVIDOR}:{RUTA}```bash title="terminal"comando```
```nginx title="/etc/nginx/nginx.conf"contenido del archivo```
```txt frame="none"salida sin marco```
```nginx {2} ins={3} del={4} "root"...```
```diff lang="yaml"-línea quitada+línea añadida```
```bash wrapcomando muy largo```
```bashssh {USUARIO}@{SERVIDOR}```| Opción | Para qué sirve | Por defecto |
|---|---|---|
-a |
Copia en modo archivo | no |
-z |
Comprime durante la transferencia | no |
--delete |
Borra en destino lo que sobra | no |
| Opción | Para qué sirve | Por defecto || :----- | :------------- | ----------: || `-a` | Copia en modo | no |Para procedimientos numerados con bloques dentro:
Instala las dependencias.
npm ciCompila el sitio.
npm run buildRevisa el resultado en dist/.
<Steps>
1. Primer paso.
```bash comando ```
2. Segundo paso.
</Steps>Útiles para el mismo comando en varios sistemas. Con syncKey, todas las pestañas con la misma clave cambian a la vez en toda la wiki.
sudo systemctl restart nginxRestart-Service -Name nginx<Tabs syncKey="so"> <TabItem label="Linux"> ```bash comando para Linux ``` </TabItem> <TabItem label="Windows"> ```powershell comando para Windows ``` </TabItem></Tabs><FileTree>
- carpeta/ - archivo.yml - **destacado.conf** comentario - …
</FileTree>Etiquetas: Nota Consejo Precaución Peligro Éxito Por defecto
Iconos:
Botón principal Secundario<Badge text="Consejo" variant="tip" /><Icon name="rocket" /><LinkButton href="/servicios" icon="right-arrow">Texto</LinkButton><LinkButton href="/servicios" variant="secondary">Texto</LinkButton>Reading package lists... DoneBuilding dependency tree... DoneAll packages are up to date.<details><summary>Título visible</summary>
Contenido que se despliega (deja una línea en blanco arriba y abajo).
</details>Las imágenes van en la misma carpeta que la entrada (o en una subcarpeta) y se enlazan con ruta relativa. Astro las optimiza al compilar.
Una línea horizontal para cortar dentro de una sección:
---En .mdx se puede dejar texto que no se publica, por ejemplo notas para ti mismo. Esta página tiene uno justo después de los import.
{/* Esto no aparece en la página. */}Cuatro bloques que no se escriben en el texto: salen del frontmatter (o se calculan solos) y solo aparecen si tienen datos.
ficha: puertos: ['80/tcp', '443/tcp'] protocolo: HTTP / HTTPS documentacion: https://nginx.org/en/docs/ archivosConfig: [/etc/nginx/nginx.conf]referencias: - titulo: Documentación oficial url: https://ejemplo.com/docsrelacionado: [/servicios/nginx, /herramientas/rsync]La cabecera entre --- de cada archivo. Solo title es obligatorio.
---title: Título de la entradadescription: Entradilla gris bajo el título.draft: true # si está, no se publica (sí se ve en local)tags: [docker, nginx] # etiquetas libres; sirven de filtro en el buscadorsidebar: order: 1 # posición en el menú lateral label: Nombre corto # texto en el menú, si quieres otro distinto del título badge: Nuevo # etiqueta junto al nombre en el menúrelacionado: [/servicios/otra-entrada]referencias: - titulo: Documentación oficial url: https://ejemplo.com/docsficha: puertos: ['80/tcp', '443/tcp'] protocolo: HTTP documentacion: https://ejemplo.com/docs archivosConfig: [/etc/servicio/servicio.conf]---Las notas al pie van numeradas y enlazan de vuelta al texto. ↩