Guía: artículos para sbayer.de

Esta página está dirigida a quienes escriben artículos para sbayer.de.

La web se genera a partir de archivos de texto sencillos en formato Markdown. Cuanto más se acerque un manuscrito a este formato, antes y con menos errores estará en línea. También sirven archivos de Word o documentos de Google, pero entonces es aún más importante usar solo los recursos de formato descritos aquí. Todo lo demás se pierde en la conversión.

Lo más sencillo es descargar la plantilla y rellenarla. Se abre con cualquier editor de texto.

Qué forma parte de un artículo

1. El texto en un solo archivo, preferiblemente Markdown (.md); si no, Word o un enlace a un documento de Google.
2. Los datos de cabecera (ver más abajo), al principio del archivo o en el correo que lo acompaña.
3. Imágenes y descargas como archivos independientes, no solo pegadas en un documento de Word.

Datos de cabecera

Cada artículo necesita algunos datos que no forman parte del texto. En la plantilla van entre dos líneas de tres guiones:

---
title: "Sincronizar una carpeta de Nextcloud con rclone"
date: 2026-11-15
summary: "Cómo mantener sincronizada una carpeta entre el portátil y Nextcloud con rclone bisync y qué trampas conviene evitar."
tags: [NextCloud, Linux]
---

Dato	Significado
title	Titular del artículo. Unos 70 caracteres como máximo, sin punto final.
date	Fecha de publicación deseada con el formato AAAA-MM-DD.
summary	Una o dos frases, unos 200 caracteres como máximo. Aparece en el listado, en el feed RSS y en los buscadores. Debe entenderse por sí sola y no empezar con «En este artículo…».
tags	De dos a cuatro palabras clave. A ser posible, las que ya existen en las notas.

La dirección de la página (p. ej. sbayer.de/es/nextcloud-rclone-bisync/) la fijamos nosotros. Si tienes alguna preferencia, indícala como permalink: nextcloud-rclone-bisync: solo minúsculas, cifras y guiones, sin tildes ni eñes.

Estructura del texto

Sin título en el texto. El titular sale de los datos de cabecera. El texto empieza directamente con el primer párrafo.

Entrada sin encabezado. De uno a tres párrafos que digan de qué trata el artículo y a quién va dirigido. Quien lea solo esta parte debe saber si le merece la pena seguir.

Subtítulos en dos niveles:

## Sección

### Subsección

Por favor, no más de tres almohadillas. Los subtítulos son breves y dicen algo del contenido («Generar la clave» en lugar de «Paso 2»). En las guías de varias partes, el título es «… – Parte 1: …», etc.

Párrafos breves. De tres a seis frases. Entre dos párrafos va una línea en blanco; un simple salto de línea se ignora.

Cierre. Una conclusión, un resumen o enlaces adicionales son bienvenidos, pero no obligatorios.

Formato

Estos recursos están disponibles y se mantienen tal cual:

Qué	Cómo escribirlo
negrita	**importante**
cursiva	*término*
enlace	[texto del enlace](https://ejemplo.es), siempre con la dirección completa
lista con viñetas	líneas que empiezan con -
lista numerada	líneas que empiezan con 1. , 2. …
cita	párrafo que empieza con >
código en el texto	`sudo apt update` (comillas invertidas simples)
tabla	como las tablas de esta página, solo con contenido sencillo

El código y los comandos de varias líneas van en un bloque de tres comillas invertidas, seguidas del lenguaje (bash, python, yaml, json …):

```bash
rclone bisync ~/Documentos nextcloud:Documentos --resync
```

Escribe los comandos de forma que se puedan copiar y ejecutar: sin $ delante y sin la salida en el mismo bloque. La salida va en un bloque aparte sin lenguaje.

No se mantienen: tipos y tamaños de letra, colores, subrayados, texto centrado, diseños a varias columnas, cuadros de texto, notas al pie e índices automáticos. Para resaltar, solo negrita y cursiva. En lugar de una nota al pie, usa una frase entre paréntesis o un enlace.

Imágenes

• Entrega las imágenes como archivos independientes (JPG para fotos, PNG para capturas de pantalla), de al menos 1200 píxeles de ancho; más grandes, mejor. Nosotros las reducimos.
• Nombres de archivo sin espacios, tildes ni eñes, p. ej. rclone-conflicto.png.
• En el texto, en el lugar adecuado, va una referencia con una breve descripción de la imagen:

![Mensaje de conflicto de rclone en el terminal](rclone-conflicto.png)

• La descripción entre corchetes es obligatoria. Se lee en voz alta a quien no puede ver la imagen y dice qué muestra.
• El pie de foto va en un párrafo propio, en cursiva, justo debajo.
• Usa solo imágenes sobre las que tengamos derechos. Para imágenes de terceros, indica la fuente y la licencia. Las imágenes nunca se insertan desde otros servidores; se guardan en sbayer.de.
• Revisa antes las capturas en busca de datos personales (nombres, direcciones de correo, contraseñas, direcciones IP).

Vídeos y contenidos incrustados

Un enlace de YouTube solo en un párrafo propio se convierte automáticamente en una tarjeta de vista previa con imagen. El reproductor solo se carga al hacer clic. Hasta entonces no se establece ninguna conexión con YouTube.

Este vídeo muestra cómo funciona en la práctica:

https://www.youtube.com/watch?v=VIDEO-ID

No incluimos otras inserciones (publicaciones de redes sociales, mapas, formularios, reproductores de pódcast), porque envían datos a terceros en cuanto se abre la página. En su lugar, basta con un enlace normal.

Descargas

Los scripts, archivos de configuración o PDF que acompañan al artículo se entregan como archivo y se enlazan en el texto:

El script completo está [disponible para descargar](backup-nextcloud.sh).

El texto y el archivo deben coincidir. Si el texto muestra un comando o un fragmento, debe aparecer exactamente igual en el archivo.

Idiomas

La web se publica en alemán, inglés y español. Basta con entregar el artículo en un idioma; las demás versiones las hacemos nosotros. Si traduces tú, mantén la estructura: las mismas secciones, imágenes y bloques de código en el mismo orden. El código no se traduce, pero sí sus comentarios.

Revisiones

Para cambiar un artículo ya publicado, envía la versión nueva completa y explica en una o dos frases qué ha cambiado. El artículo recibe entonces la indicación «actualizado el …».

Lista de comprobación antes de la entrega

• título, fecha, resumen y palabras clave indicados
• sin título en el texto, entrada sin encabezado
• subtítulos solo con ## y ###
• enlaces con la dirección completa
• código en bloques con lenguaje, comandos sin $
• todas las imágenes como archivos, con descripción, derechos aclarados y sin datos personales
• descargas incluidas y enlazadas en el texto
• texto, imágenes y descargas enviados juntos a Stefan, a ser posible en un ZIP