Redacción de artículos
El editor de texto enriquecido TipTap, lo que admite y lo que se sanea al guardar.
Los artículos se redactan en un editor de texto enriquecido basado en TipTap / ProseMirror. La barra de herramientas cubre el formato que realmente necesita; el HTML subyacente se sanea antes de guardar para que no pueda guardar accidentalmente una etiqueta <script>, aunque la pegue.
La barra de herramientas
- Negrita, cursiva, tachado, código en línea
- Encabezados — H1, H2, H3 (el título del artículo es el
<h1>del documento, por lo que use H2 como encabezado de sección principal) - Lista con viñetas, lista numerada, cita en bloque
- Bloque de código — código delimitado, sin coloreado de sintaxis por idioma (por ahora)
- Enlace — se abre en una nueva pestaña con
rel="noopener noreferrer"de forma automática - Línea horizontal
- Deshacer / rehacer
Eso es todo. Sin selector de fuente, sin selector de color, sin tamaño de fuente. El diseño es intencionadamente restrictivo — los artículos de la base de conocimiento son más legibles cuando los autores no tienen que tomar decisiones tipográficas.
Qué se elimina al guardar
Cada guardado pasa por HTMLPurifier con un perfil estricto:
<script>,<iframe>,<style>,style="…"en línea,onClick="…"— eliminados.- Cualquier etiqueta que no esté en la lista de permitidas — eliminada.
- Esquemas de URL distintos de http(s), mailto, tel — eliminados.
Pegar desde Word o Google Docs funciona bien; el ruido de formato se limpia. Pegar desde una página de phishing no puede colar nada a través del saneador.
Campos más allá del cuerpo
- Título — el
<h1>del artículo y la etiqueta<title>de la página. - Slug — ruta de la URL. Se genera automáticamente a partir del título; es editable. No cambie el slug de un artículo publicado sin configurar una redirección desde la URL anterior.
- Meta description — menos de 320 caracteres. Se usa para
<meta name="description">y Open Graph. Si lo omite, se extraerá automáticamente del cuerpo. - Etiquetas — separadas por comas. Consulte Etiquetas y destacados.
- Categoría — obligatoria para que el artículo sea navegable. Los artículos sin categoría aún tienen una URL pero no aparecen en las listas de categorías.
Guardado
El editor guarda solo al enviar — actualmente no hay guardado automático. Si su navegador se cierra a mitad de la redacción, perderá lo que no se guardó. Guarde con frecuencia, especialmente antes de reformatear.
Editar un artículo publicado
Simplemente edite y guarde. Los cambios se publican de inmediato — no hay paso de borrador ni vista previa. La marca de tiempo updated_at es la que aparece como "Última actualización" en el sitio del visitante.