Trabajar con contenido

Use el admin de EmDash para llevar una entrada desde su primer borrador hasta una página publicada. El editor mantiene los cambios del borrador separados de la versión que los visitantes pueden ver, de modo que guardar y publicar son dos acciones distintas.

Abrir una colección

Abra /_emdash/admin en su sitio e inicie sesión. Seleccione una colección, como Posts o Pages, en la barra lateral.

La página de la colección enumera sus entradas. Desde aquí puede:

• seleccionar Add New para crear una entrada;
• buscar por el título de la entrada, el slug y los campos marcados como searchable;
• filtrar por estado de publicación, autor, byline, fecha y locale;
• seleccionar entradas para publicación masiva, volver a borrador o mover a la papelera; y
• abrir Trash para restaurar o eliminar permanentemente una entrada.

Los campos y las funciones de publicación disponibles en el editor dependen del modelo de contenido de la colección. Por ejemplo, una colección puede admitir revisiones, vistas previas, taxonomías o búsqueda.

Crear y publicar una entrada

La entrada tiene un ID de contenido estable y un slug separado. El ID sigue identificando la misma entrada si su slug cambia. Las plantillas suelen usar el identificador orientado a la URL que devuelve getEmDashCollection(); la guía de consultar contenido explica ambos valores.

Escribir texto enriquecido

Los campos Portable Text proporcionan un editor de bloques para encabezados, párrafos, citas, listas, enlaces, imágenes, galerías, bloques de código, tablas, bloques HTML y secciones reutilizables. Los plugins instalados pueden añadir más bloques.

Use la barra de herramientas para formatear el texto seleccionado. Para insertar un bloque, seleccione el control de añadir bloque junto a un párrafo o escriba / y busque un bloque por nombre. Los bloques de imagen y galería abren el mismo selector de medios usado por los campos de imagen.

Cuando selecciona un bloque de imagen, sus ajustes le permiten reemplazar o quitar ese uso de la imagen y fijar su tamaño de visualización, alineación, texto alt, subtítulo y tooltip opcional. Edit asset abre el elemento subyacente de la biblioteca de medios, donde cambiar o reemplazar el asset puede afectar a otras entradas que lo usan. Consulte Biblioteca de medios para esa distinción.

Guardar cambios del borrador

Tras el primer guardado, el editor guarda automáticamente los cambios dos segundos después de que deje de escribir. El botón Save pasa por Saving… a Saved para que pueda confirmar que el servidor aceptó el borrador. El autoguardado reemplaza la revisión de autoguardado actual en lugar de llenar el historial de revisiones con un punto de control por cada pausa.

Seleccione Save cuando quiera que un punto de la secuencia de edición permanezca en el historial de revisiones. Si un guardado falla, el editor mantiene los campos no guardados y muestra el error. No abandone la página hasta que el botón vuelva a Saved o haya copiado el trabajo no guardado en otro sitio.

En una entrada publicada, guardar cambios actualiza solo su borrador. Los visitantes siguen recibiendo la revisión en vivo anterior. Use Preview draft para comprobar la versión pendiente, Live View para comprobar la versión pública y Publish changes cuando el borrador esté listo para reemplazarla.

Cambiar el slug de una entrada publicada sigue el mismo flujo de borrador. La URL pública cambia cuando publica el borrador, no cuando se ejecuta el autoguardado.

Trabajar con otro editor

Abrir una entrada toma un bloqueo de edición para esa entrada y locale. Si otra persona ya la tiene abierta, EmDash identifica al titular del bloqueo y ofrece dos opciones:

• Open read-only muestra la entrada sin aceptar ediciones, de modo que no pueda escribir trabajo que se descartará.
• Take over le da el bloqueo. La otra persona conserva lo que escribió, pero en dos minutos su editor informa que usted tiene la entrada. Su siguiente guardado se rechaza.

El bloqueo se renueva mientras la entrada está abierta y se libera cuando sale del editor o cierra la pestaña. Si el navegador o el ordenador se cierran sin liberarlo, el bloqueo caduca siete minutos después de su última renovación.

Los bloqueos son independientes por cada locale, de modo que dos personas pueden editar traducciones distintas de la misma entrada. Un script o cliente de API también se rechaza mientras otro editor tiene el bloqueo a menos que use el override documentado. Consulte Bloqueo de edición de entrada para el comportamiento completo de la API.

Un administrador puede desactivar el bloqueo de una colección en Content Types, luego la colección, luego Edit locking.

Publicar o programar cambios

Publicar y programar usan controles separados:

• Publish now hace live un borrador nuevo tras la confirmación.
• Publish changes hace live los cambios pendientes de una entrada publicada tras la confirmación.
• Schedule establece cuándo una entrada nueva o los cambios pendientes se vuelven live.
• Change schedule actualiza una programación existente.
• Remove schedule cancela una programación existente.
• Unpublish quita la revisión en vivo de las consultas públicas, cancela cualquier programación y conserva un borrador editable.

Para programar una entrada, guárdela primero, seleccione Schedule bajo el resumen de publicación y elija una fecha y hora futuras. El editor muestra la zona horaria usada para la programación. Hasta ese momento, la revisión en vivo actual permanece pública; para una entrada nueva, aún no hay nada público.

Los despliegues de Node.js ejecutan el barrido de publicación programada automáticamente. Cloudflare Workers requieren un Cron Trigger. Las plantillas de inicio de Cloudflare lo incluyen; los despliegues existentes pueden seguir Publicación programada para verificar el desencadenador.

Restaurar una revisión

Las colecciones con soporte de revisiones muestran Revisions en el panel de ajustes. Expándalo para ver versiones guardadas y los campos que cambiaron entre ellas. Seleccione una revisión para inspeccionar su contenido y luego seleccione Restore si quiere usar esa versión de nuevo.

Restaurar crea una nueva revisión con el contenido seleccionado. No borra las revisiones que vinieron antes, de modo que aún puede inspeccionar la secuencia completa después.

Traducir una entrada

Cuando la internacionalización está habilitada, el panel Translations muestra los locales configurados para la entrada actual.

Cada traducción tiene su propio slug, estado de publicación, programación e historial de revisiones. Use el selector de locale en la página de la colección para ver un idioma a la vez.

Mover contenido a la papelera

Abra las acciones de una entrada o seleccione una o más filas en la página de la colección y luego elija Move to Trash. Las entradas en la papelera dejan de aparecer en las consultas ordinarias de contenido pero siguen disponibles en la pestaña Trash de la colección.

Desde Trash, seleccione Restore para devolver una entrada a la colección. Una entrada restaurada vuelve como borrador sin programación. Publíquela para hacerla pública.

Automatizar el trabajo de contenido

La API REST y la CLI de EmDash admiten el mismo flujo de borrador y publicación. Los campos de colección pertenecen dentro del objeto data de la petición. Una actualización guarda una revisión de borrador; publicar es una acción separada. Pase el valor _rev más reciente al actualizar o publicar para que el servidor rechace una escritura obsoleta en lugar de reemplazar trabajo más reciente.

Use la referencia del ciclo de vida del contenido para transiciones de estado, permisos, conflictos y hooks. La referencia de la API REST define cuerpos de petición y respuesta, y la referencia de la CLI cubre comandos de terminal equivalentes.

Continúe con Consultar contenido para renderizar entradas publicadas en un sitio Astro, o Biblioteca de medios para añadir y gestionar archivos reutilizables.