Manual de Usuario Presswork (ES)

Este manual describe todas las funciones de Presswork, con un recorrido guiado por cada área de la aplicación.

1. Panorama general

Presswork es un editor Markdown profesional para edición y autopublicación. Combina escritura limpia, herramientas editoriales (estilo, sinopsis, versiones) y exportaciones profesionales (PDF, PDF/X, EPUB, DOCX, HTML, ICML, FDX). Incluye Typst para PDF rápidos y admite LaTeX + Ghostscript para PDF/X certificados.

2. Requisitos e instalación

Incluidos: Pandoc, Typst (PDF Base), motores internos.
Opcionales (Pro): LaTeX y Ghostscript para PDF/X certificados.

Dónde comprobarlo:

Herramientas → Control de exportación: verificación y guía de instalación.

3. Modos y licencias (Base / Pro)

Base: interfaz simplificada, PDF rápido con Typst, menos opciones.
Pro: PDF/X, preflight, multi-export, opciones avanzadas y herramientas editoriales completas.
Cambia al vuelo con el interruptor Base/Pro del encabezado; el plan completo y la Licencia se gestionan desde Configuración → App → Vista de trabajo.

4. Interfaz principal

Encabezado: acceso rápido a Documento, Herramientas, Exportar, Vista, licencia, manual.
Editor: área Markdown con barra de herramientas y atajos.
Barra lateral: Outline, Snapshot, Backlink, Scrivener.
Barra de estado: palabras, caracteres, línea/columna, objetivos.

5. Menú Documentos

Nuevo: crea un documento nuevo.
Guardar MD / Guardar como…: guarda en .md.
Importar documento: Word (.docx, .doc), ODT, HTML, Markdown, PDF, ICML, Final Draft. Las imágenes entran con el texto: las figuras de un documento de Word —incluidas las tablas de Excel pegadas como imagen— y las incrustadas en un PDF se extraen a una carpeta junto al archivo importado. Lo que en un PDF es dibujo vectorial (muchos gráficos lo son) no es una imagen y no se puede extraer.
Abrir proyecto: carga un proyecto por capítulos.
Modo Estructura: gestión de capítulos/orden.
Gestionar proyecto: crea/actualiza proyectos editoriales.
Imprimir: imprime el documento actual.
Versiones: historial de autoguardados y restauración.

Flujo recomendado:

Crea un documento o proyecto.
Guarda a menudo.
Usa Versiones para recuperar revisiones.

6. Menú Herramientas

Objetivos: metas de palabras diarias o por documento.
Estadísticas: evolución de la escritura, ritmo, dificultad, flow.
Guía de usuario: manual integrado.
Control de exportación: verifica LaTeX/Ghostscript.
Command Palette: búsqueda de comandos (Ctrl/Cmd + P).
Análisis de estilo: repeticiones, legibilidad, tono, inclusividad.
Asistente IA: resúmenes, reescrituras, coherencia.
Modo Vim: comandos Vim.
Collab: sesiones colaborativas P2P con invitación rápida por ID de sesión.
- Inicio rápido: abre Herramientas → Collab, escribe tu nombre, crea o pega un ID de sesión (pw-...) y pulsa Conectar.
- Durante la llamada: usa los conmutadores de micrófono y cámara del panel flotante; si WebRTC falla, configura el relay WebSocket (presswork-collab-relay-url).
Tour: recorrido guiado por los formatos especiales.
Firma digital: firma PDF con certificado (Pro).

7. Menú Exportar

Formatos principales

PDF (Typst, rápido)
PDF/X (LaTeX, certificado)
PDF Guion (Hollywood)
FDX (Final Draft)
DOCX / ODT
EPUB
HTML
ICML (InCopy/InDesign)

Opciones

Estilo PDF: selección de plantilla PDF.
PDF/X: perfil ICC, validación, fuentes incrustadas.
Marcas de corte/Sangrado: opciones de impresión.
Metadatos EPUB + Portada.
Preflight: lista de control de calidad e impresión.
Historial de exportación: registro de exportaciones.
Exportación múltiple: varios archivos en uno.
Exportación multiformato: PDF + EPUB + HTML, etc.
Exportar con recursos: incluye imágenes/recursos.
Convertir carpeta: conversión por lotes.

8. Menú Vista

Modos: Escritura, Código, Vista previa, Página, Split.
Idioma: 9 idiomas de interfaz.
Tema: Claro/Oscuro.
Máquina de escribir: línea activa centrada.
Modo Focus: oculta la interfaz (F11).
Presentación: diapositivas a pantalla completa.
Accesibilidad: tamaño del texto, contraste, fuente para dislexia.

9. Barra de herramientas del editor

Formato: negrita, cursiva, subrayado.
Títulos: H1/H2/H3.
Elementos: enlaces, imágenes, código en línea/bloque.
Listas: con viñetas/numeradas.
Citas.
Tablas.
CriticMarkup: insertar, borrar, comentar.
Plantillas: preajustes de maquetación.
Metadatos: front matter YAML.
Snapshot: instantáneas de escena.
Sinopsis: resúmenes por capítulo.

10. Paneles laterales

Outline: navegación por secciones.
Snapshot: gestión de instantáneas.
Backlink: enlaces entre documentos.
Scrivener: capítulos y arrastrar y soltar.
Scene Navigator: para guiones.

11. Escribir en Markdown

Sintaxis básica

# Título / ## Subtítulo
**negrita**, *cursiva*
- lista / 1. lista numerada
[enlace](url)
![alt](imagen)
> cita
\newpage para salto de página

Consejos

Arrastra y suelta imágenes.
Usa Split o Vista previa para controlar la maquetación.

12. Plantillas

Plantillas predefinidas: acceso desde la barra de herramientas (Tpl).
Plantillas personalizadas:
- Importación de archivo único o carpeta (menú Plantillas → "Importar archivo / Importar carpeta").
- Clasificación automática en pestañas: css→UI Kit, xlsx/xls/ods/csv→Business, resto→Documentos.
- Insignia Custom y tooltip completo al pasar el ratón (nombre + descripción).
- .md: cargables en el editor.
- .tex/.pdfx/.pdft: utilizables como estilos de exportación PDF.
- .xlsx/.xls/.ods/.csv: utilizables en flujos de hojas de datos/informes.
Auto-emparejado UI↔PDF: los temas CSS pueden emparejarse automáticamente con la plantilla PDF (conmutador + Desemparejar).
Biblioteca compartida: guarda preajustes tipográficos compartidos.
Referencia completa de funciones de plantillas: docs/template-functions-overview-en.md.

13. Metadatos y front matter

Editor de metadatos para título, autor, ISBN.
Front matter YAML para exportaciones coherentes.
EPUB: portada y metadatos muy recomendados.

14. Proyectos y Modo Estructura

Documentos → Gestionar proyecto.
Crea la carpeta del proyecto.
Añade capítulos (.md).
Reordena con arrastrar y soltar.
Exporta todo con orden automático.

15. Exportación en detalle

15.1 PDF Base (Typst)

Rápido, sin LaTeX.
Ideal para borradores y revisiones.

15.2 PDF/X (LaTeX)

Usa una plantilla certificada.
Requiere LaTeX + Ghostscript.
Admite ICC, validación y preflight.

15.3 PDF Guion

Maquetación Hollywood.
Compatible con Fountain.

15.4 FDX (Final Draft)

Exportación para flujos cinematográficos, con informe .breakdown.json al lado (escenas, personajes, etiquetas).
Diálogo simultáneo: añade ^ tras el nombre del segundo personaje (GUIDO^) — en Final Draft las réplicas aparecen en columnas (dual dialogue nativo); al importar un .fdx el ^ reaparece solo.
Etiquetas de producción: clic derecho sobre una palabra seleccionada → Etiquetar para producción, o escribe [[prop: linterna]] o #prop: linterna al final de la línea. En FDX se convierten en etiquetas nativas del Tagger; en los demás formatos los marcadores se eliminan; las etiquetas hechas en Final Draft vuelven al importar.
Claves principales (italiano o inglés): prop, costume, vehicle, sound, music, makeup, animal, effects, location, note.
Título y autor (front matter, o # Título + "by …" al inicio) van a la Title Page de Final Draft.

15.5 DOCX/ODT

Conversión mediante Pandoc.

15.6 EPUB

Metadatos + portada recomendados.
Compatible con tiendas digitales.

15.7 HTML

Salida web con recursos.

15.8 ICML

Estilos mapeados para InDesign/InCopy.
Títulos, listas, citas y guion convertidos en estilos dedicados.
Preajustes de plantilla incluidos + importación de un .icml personalizado.
Notas al pie reales (numeradas por InDesign), enlaces con destinos, tablas con cabeceras y alineaciones, imágenes como marcos vinculados (panel Vínculos), superíndices/subíndices y versalitas — también dentro de celdas, notas y enlaces.
Reimportación fiel: un ICML exportado y reabierto en PressWork conserva el documento (ida y vuelta verificada en CI, incluso con manuscritos largos).

15.9 Excel

Exportación Excel con desglose de escenas, personajes y producción.
Soporte de plantillas: escribe en hojas existentes para conservar los estilos base.
Importación multi-hoja a tablas Markdown (con metadatos de tipo/celda).
Selección de hoja y rango al importar para evitar datos no deseados.
Chart Mapper: opcional, genera gráficos de vista previa a partir de datos Excel.

16. Exportación avanzada

Exportación múltiple: une varios documentos.
Exportación multiformato: genera PDF+EPUB+HTML en una carpeta.
Exportar con recursos: copia imágenes y recursos.
Historial de exportación: registro y resultados.

17. KDP (Amazon)

Quick Export: PDF + EPUB con nomenclatura KDP.
Calculadora: dimensiones y márgenes.
Plantillas KDP: portadas/maquetación dedicadas.
Validador ePub: lista de control, vista previa Kindle e informe descargable.

18. Análisis de estilo

Frases largas, repeticiones, voz pasiva.
Sugerencias en línea.
Métricas de legibilidad.

19. Asistente IA

Resúmenes, reescritura, coherencia, títulos.
Servicios en la nube listos en el menú: OpenAI, Anthropic (Claude), Mistral y agregadores como OpenRouter. Elegir uno configura dirección y modelo: solo queda pegar la clave.
Cada servicio recuerda su clave: al pasar de uno a otro ya no hay que volver a introducirla. Las claves viven en el llavero del sistema operativo, no en un archivo de la aplicación.
Modelos locales: con «Detectar Ollama» aparecen los instalados en tu ordenador. Ahí no hace falta ninguna clave y nada sale de la máquina.
Prueba de conexión comprueba el canal que estás usando de verdad —el de la nube si tienes clave, el local si no— y dice cuál ha verificado.

20. Colaboración (P2P)

Sesiones compartidas con cursores remotos de colores, comentarios en línea y sincronización en vivo.
Llamadas de voz/vídeo integradas durante la sesión.
ID de sesión compartible (pw-...) para invitar rápidamente a otros usuarios.

Cómo usarla (paso a paso)

Abre Herramientas → Collab y elige un nombre reconocible.
Crea una sesión nueva o pega el ID recibido de un colega.
Espera el estado Online y comprueba los participantes en el dock de colaboración.
Si necesitas voz/vídeo, inicia la llamada desde el panel Collab y usa los botones de silencio/cámara.
En redes corporativas restrictivas, configura el relay WebSocket (clave localStorage: presswork-collab-relay-url).

21. Firma digital

Firma PDF con certificado PAdES-T.
Sello de tiempo RFC 3161 (requiere red).

22. Presentación

Convierte documentos en diapositivas.
Maquetaciones y paletas configurables.

23. Accesibilidad

Tamaño del texto 12–18px.
Alto contraste.
Fuente para dislexia.

24. Atajos principales

Ctrl/Cmd + S → Guardar
Ctrl/Cmd + N → Nuevo
Ctrl/Cmd + P → Command Palette
Ctrl/Cmd + Shift + P → Presentación
F11 → Modo Focus
Ctrl/Cmd + B/I/U → Negrita/Cursiva/Subrayado
Ctrl + Alt + V → Vim

25. Resolución de problemas

PDF/X no disponible: instala LaTeX + Ghostscript y reinicia.
Plantillas no visibles: usa "Abrir carpeta de plantillas" y verifica las extensiones.
Exportación lenta: desactiva la validación en fase de borrador.

26. Rutas útiles

Plantillas personalizadas: carpeta presswork/templates dentro del directorio de configuración del usuario.
PDF/X ICC: carpeta presswork/pdfx.

Presswork une sencillez y herramientas editoriales profesionales: escribe rápido en Base, publica en Pro.

Novedades recientes (Data Hub / Gráficos)

Al insertar un gráfico desde el Excel Data Hub ahora se muestra de inmediato una vista previa de imagen también en el editor, no solo en el panel de vista previa.
La vista previa en línea se ha reducido (alrededor del 50%) para ser menos invasiva al escribir.
Conmutador bidireccional: 📝 Mostrar código abre el bloque chart-data, 🖼️ Volver al gráfico restaura la vista de imagen.
El bloque chart-data permanece en el Markdown para garantizar la compatibilidad con vista previa/render/exportación.
Insertar una tabla o un gráfico como imagen ahora guarda el archivo en los recursos del documento (nombredoc.assets/images/) y en el editor solo entra la referencia Markdown: funciona incluso con hojas muy grandes.
Si el documento aún no está guardado, la aplicación propone guardarlo al momento (como con el arrastre de imágenes); si se rechaza, la tabla entra como texto Markdown y el gráfico permanece en la hoja.
La pregunta texto/imagen también entiende respuestas como "png", "jpg", "imagen", "foto"; una respuesta no reconocida repite la pregunta.
La cuadrícula de datos sigue el tema claro/oscuro activo.
Guardar como plantilla: ventana rediseñada al estilo de la app y traducida. Requiere datos en la cuadrícula y un modelo en el editor con marcadores {{NombreColumna}}; "Generar Markdown" repite el modelo para cada fila.
Exportación Excel (desglose): lee el texto del editor (escenas INT./EXT. o capítulos #); si no encuentra escenas, ahora avisa en vez de generar un archivo vacío.
Menú Tables simplificado: eliminada la entrada duplicada "Importar como plantilla" (idéntica a "Abrir hoja Tables").
Panel Importar/Exportar: nueva pestaña Múltiples (junto a Formato base / Impresión pro / Guion / Editorial) con las acciones por lotes: Convertir carpeta, Exportación múltiple, Multiformato, Con recursos. Las opciones avanzadas muestran solo lo que afecta al formato elegido.
🧪 Verificar ICML: en el panel de exportación (formato ICML) comprueba el documento generado — jerarquía, front matter, escapes, párrafos vacíos — sin escribir nada en disco; los detalles aparecen en una ventana dentro de la app. La misma verificación se ejecuta igualmente en cada exportación ICML.
Exportación FDX más segura: el Markdown genérico (listas, tablas, notas) se convierte siempre en Acción — nunca en Personaje/Diálogo por accidente; los guiones reales se siguen interpretando (escenas, personajes, diálogos, transiciones). \newpage se convierte en un salto de página real (también en ICML, con estilo "Salto de página" remapeable).
Impresión vía PDF: el botón Imprimir genera un PDF temporal (Typst, la misma tipografía de las exportaciones) y lo abre en el visor del sistema — se imprime desde el diálogo nativo con una vista previa fiel.
Configuración reorganizada: sección Instalaciones (LaTeX en un clic, estado de Ghostscript), idioma en vista compacta, tema con chips Oscuro/Claro. Los prompts rápidos del panel IA son plegables.

27. Análisis en profundidad de las funciones (huecos cubiertos)

Esta sección integra las funciones avanzadas que a menudo no se usan porque son poco visibles en los menús.

27.1 IA: configuración, diagnóstico y calidad de respuesta

Endpoints configurables cloud/local (compatibles con OpenAI, Ollama, LM Studio) mediante las variables PRESSWORK_AI_ENDPOINT, PRESSWORK_AI_MODEL, PRESSWORK_AI_API_KEY.
Diagnóstico de conexión IA con informe JSON exportable (útil para soporte técnico/equipos de TI).
Control del estilo de respuesta (sintética/equilibrada/detallada), vista previa del prompt técnico y reintento del último prompt.
Fijación de endpoint/modelo por proyecto: mantiene la coherencia editorial entre documentos.

27.2 Estadísticas: método de cálculo (operativo)

Productividad media: calculada sobre el historial diario (7 días / 30 días).
Velocidad de escritura: palabras totales divididas por la ventana de sesiones (palabras/hora y palabras/min).
TTR (Type-Token Ratio): palabras únicas / palabras totales.
MSTTR: media de TTR en ventanas de 50 palabras (reduce la distorsión en textos largos).
Flow state en tiempo real: intervalo medio de pulsaciones + proporción de borrados recientes.
Previsión de finalización: estimación optimista/pesimista usando medias de 7d frente a 30d.

27.3 Exportaciones avanzadas ausentes de la guía rápida

Final Draft (.fdx): mapea los títulos a Scene Headings reales, admite notas/saltos de página/numeración de escenas y genera el archivo adjunto .breakdown.json.
ICML: mapeo tipográfico avanzado (títulos/listas/citas/guion) + preajustes + importación de .icml personalizado.
Asistente EPUB/ICML: bloquea la exportación hasta que los metadatos mínimos (título/autor/ISBN) y la portada estén configurados.
Firma PDF: PKCS#7 detached + sello de tiempo RFC 3161.

27.4 Modo Bundle (.pwk)

Acción principal: Exportar con elección de destino.
Destinos de salida automáticos para reducir errores manuales de ruta.
Conmutador en el encabezado para mostrar temporalmente las exportaciones rápidas clásicas.

27.5 Colaboración (P2P) en contextos reales

ID de sesión compartible pw-..., cursores remotos de colores, comentarios en línea, sincronización en vivo.
Llamada de voz/vídeo integrada en la misma sesión editorial.
Relay WebSocket de reserva si WebRTC no pasa (redes corporativas/cortafuegos), mediante la clave presswork-collab-relay-url.

27.6 Sistema de plantillas (uso profesional)

Importación de archivo/carpeta con clasificación automática (Business / Documentos / UI Kit).
Soporte de plantillas binarias y hojas de cálculo para flujos de informes.
Auto-emparejado UI↔PDF para vincular el tema del editor y el estilo de exportación, con opción Desemparejar.

27.7 Lista de control operativa recomendada

Configura el modo Base/Pro según el entregable.
Verifica los requisitos en Control de exportación (LaTeX/Ghostscript solo si necesitas PDF/X).
Ejecuta el Preflight antes de la entrega.
Para EPUB/ICML completa el asistente de metadatos + portada.
Para documentos firmados activa la firma PKCS#7 + sello de tiempo.
En equipo, guarda el ID de sesión Collab y el relay de reserva en la política interna.

28. Conectar un asistente (MCP)

Desde la 4.2, PressWork actúa como puente MCP: los asistentes de IA de chat (Claude Desktop, Codex CLI, Gemini CLI…) leen tus proyectos .pwk directamente en tu ordenador — capítulos, notas, estadísticas — sin copiar y pegar. Solo lectura: el puente no tiene ninguna herramienta de escritura, solo siete de lectura. Si el asistente que conectas tiene herramientas propias para acceder a los archivos del ordenador, esas no pasan por PressWork.

Configuración con un clic: Ajustes → IA → Conectar un asistente (MCP) → «Configura por mí» (Claude Desktop / Codex CLI / Gemini CLI). Se conecta la carpeta del proyecto abierto, con todos los .pwk que contiene.
Cierra del todo el asistente antes de configurar (Claude Desktop reescribe su configuración al cerrarse), luego vuelve a abrirlo. La app hace copia de seguridad antes de escribir.
Las carpetas se suman: configura desde proyectos en carpetas distintas y el asistente las verá todas. Funciona incluso con PressWork cerrado.
En Claude: los chats normales viven en la nube y no llegan a tu máquina — elige la actividad «En tu ordenador» o marca el conector presswork.
Otros clientes MCP (Cursor, OpenCode…): fragmento de configuración manual para copiar. Con Exportar la Competencia generas la skill que enseña a Claude a aprovechar al máximo tus proyectos (se añade una vez, vale para siempre).
Privacidad, con honestidad: lo que el asistente lee se envía a su servicio en la nube para elaborar la respuesta — como un copia-pega, pero automático. No conectes proyectos que no enviarías a un chat.
Requiere la vista de trabajo Complete.

29. Ramas y variantes de capítulo

Dos herramientas distintas que responden a la misma pregunta — «¿y si en cambio…?» — a dos escalas diferentes.

La rama es otro libro. En cada libro, cada capítulo puede tener sus variantes.

29.1 Las ramas

Una rama es una versión alternativa del documento entero: cambia el final, quita un personaje, prueba otra estructura. El documento principal queda intacto.
Panel: Ctrl/Cmd+Shift+B o desde el menú. Abre una rama y entras dentro: desde ese momento escribes ahí.
Siempre se ve dónde estás: abajo en la ventana aparece una píldora con el nombre de la rama. Sin píldora = estás en el documento principal, el que va a imprenta.
Promover convierte la rama en el documento real (el principal anterior se archiva como rama). Diff compara línea por línea. Exportar separa la rama en un .pwk independiente.
Todas las ramas viven dentro del mismo .pwk: ningún archivo extra, ningún Git.
Las fichas de la Sinopsis dicen dónde se separan los caminos: en cada ficha-capítulo aparece una marca con el color de la rama si allí ese capítulo es distinto, tachada si allí no existe. Un clic abre las Ramas. Las fichas idénticas en todas las ramas quedan limpias: el silencio significa «aquí no se ha separado nada». Dentro de una rama la comparación incluye el documento principal, que es justo con el que hace falta compararse mientras se explora otro camino.
Los capítulos que solo viven en otro sitio no desaparecen: al final de la Sinopsis aparece, cuando hace falta, la lista de los capítulos que solo existen en otra versión. Sirve sobre todo para los renombrados, porque los capítulos se reconocen por el título.

29.2 Las variantes de capítulo

Una variante es una segunda versión de un solo capítulo: en el papel era tachar un fragmento y reescribirlo al lado. En el texto queda viva una sola, y es la que sale en los archivos.
Crearla: Sinopsis → pasa el ratón sobre la ficha del capítulo → ⑂ arriba a la derecha. El texto actual pasa a ser la primera versión; a la nueva le pones nombre.
Cambiarla: pulsa la píldora ⑂ en la ficha y elige. La activa lleva la marca «en el texto». Solo cambia ese capítulo.
Eliminarla: la papelera del menú. La activa no se borra: cambia antes a otra.
Dónde se ve: barra de estado, junto al contador de palabras — ⑂ variante: nombre. Si el capítulo donde tienes el cursor no tiene, también lo dice, en gris.
Cada rama tiene sus variantes: las creadas dentro de una rama no aparecen en el principal, y es intencionado.

29.3 Si algo no cuadra

Capítulo renombrado, variantes desaparecidas: no se han perdido. Al final de la Sinopsis hay una banda «Variantes sin capítulo» con todo lo que ahora no encuentra sitio; con el menú «asignar a…» las devuelves a su lugar. PressWork intenta seguir por su cuenta los títulos renombrados, pero cuando no está seguro prefiere enseñarte el material antes que adivinar.
Deshacer también vale aquí: cambiar de variante es una modificación como cualquier otra (Ctrl/Cmd+Z).
En el disco: versions/branches/<id>/ y versions/variants/ dentro del .pwk. Son archivos .md normales: incluso sin PressWork el trabajo se lee.