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:

• Configuración → App → Instalaciones → Abrir 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.
• Cronología (sección Historial): los puntos guardados solos y su restauración (Ctrl/Cmd + Shift + H).
• Versiones (sección Historial): las versiones alternativas del libro, junto a la definitiva que va a imprenta (§29).

Flujo recomendado:

1. Crea un documento o proyecto.
2. Guarda a menudo.
3. Usa la Cronología para volver a un punto anterior.

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 (LaTeX/Ghostscript): no está en este menú, sino en Configuración → App → Instalaciones («Abrir control de exportación»).
• 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: no está en este menú, sino en Configuración → Editor → Modos de escritura (o Ctrl + Alt + V).
• Collab: sesiones colaborativas en tiempo real con invitación rápida por ID de sesión; el texto, el chat y los adjuntos pasan por el relay de PressWork (§20).
  • 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; la voz y el vídeo viajan con WebRTC, directamente o, si la red no lo permite, a través de un servidor de reenvío (TURN): no hay nada que configurar.
• 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: entre las Opciones de impresión profesional (PDF). El interior para KDP sale siempre sin ellas.
• 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 MD, Vista de página.
• Idioma (9 idiomas): no está en este menú, sino en Configuración → App → Idioma.
• Tema: Configuración → App → Tema, 🌙 Oscuro / ☀️ Claro, o desde la Command Palette.
• Máquina de escribir (línea centrada): Configuración → Editor → Modos de escritura.
• Modo Focus: oculta la interfaz (F11).
• Presentación: diapositivas a pantalla completa.
• Accesibilidad (tamaño del texto, alto contraste, fuente para dislexia): no está en este menú, sino en Configuración → Editor → Texto y Tipografía.

9. Barra de herramientas del editor

• Formato: negrita, cursiva, subrayado. El primer clic lo aplica y deja la palabra seleccionada; el segundo la devuelve a la normalidad (también vale para el código).
• 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
• $E=mc^2$ dentro de la línea, $$ … $$ en una línea aparte: fórmula

Consejos

• Arrastra y suelta imágenes.
• Usa Split o Vista previa para controlar la maquetación.
• Fórmulas, también sin conexión: la vista previa las muestra sin red (al arrancar, PressWork no descarga nada). Lo que en la vista previa es una fórmula sale como fórmula en el PDF, el PDF/X, Imprimir, el PDF rápido, el ePub y el HTML, y al revés: un precio como «$50» sigue siendo texto. Solo en Imprimir y en el PDF rápido \cancel sale escrito tal cual y \color pierde el color, pero el PDF se genera igualmente.
• Emoji: llegan al PDF en lugar de cuadraditos, en color en el PDF normal y en negro en el PDF/X.

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

• Metadatos (barra superior) abre 🏷 Gestionar metadatos; desde el Área editorial también la abre Editar metadatos (título, autor…): título, autor, idioma, fecha, ISBN, editorial, género, etiquetas.
• Idioma, debajo de Título y Autor: cada uno de los nueve idiomas aparece escrito en el suyo (Italiano, English (US), English (UK), Español, Français, Deutsch, 中文, Русский, العربية, עברית); con Otro… se escribe un código como pt-BR o de-CH, y un código erróneo no se guarda. El idioma vale para el ePub y para los PDF: separación silábica, comillas, «Indice» o «Contents». El chino, el japonés y el coreano quedan en italiano en el PDF vía LaTeX y en el PDF/X, y la ventana lo avisa. Con Sin indicar, el ePub toma el idioma de la app y el PDF el italiano.
• El idioma se convierte en la línea lang: del documento: si la habías escrito a mano, la encuentras en la ventana. La Editorial y un ISBN válido llegan al ePub (el ISBN no va en el PDF), y el formato de página elegido ahí se convierte en el Papel de la exportación, también para un .md.
• Front matter YAML para exportaciones coherentes.
• EPUB: portada y metadatos muy recomendados.

14. Proyectos y Modo Estructura

1. Documentos → Gestionar proyecto.
2. Crea la carpeta del proyecto.
3. Añade capítulos (.md).
4. Reordena con arrastrar y soltar.
5. 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; el Idioma de los Metadatos (§13) es el que usa el lector electrónico para separar sílabas y leer en voz alta.
• 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)

• Área editorial (botón arriba): las herramientas para Amazon KDP, en cinco pestañas: Exportar, Portadas, Validación, Calculadora, IA.
• 🚀 Exportar KDP (PDF + ePub) escribe los archivos que hay que subir: Título_interior.pdf (PDF/X si LaTeX está instalado, si no un PDF normal; siempre sin portada y sin marcas de corte), Título_ebook.epub y, si la elegiste en la pestaña Portadas, Título_cover.pdf. Al final, Abrir abre el interior.
• Portadas → Portada del libro impreso: la pestaña indica las medidas de la portada completa (entera en mm y en pulgadas, el lomo, el sangrado), calculadas sobre el Papel elegido en el menú Exportar (A4, A5, US Letter), con el tipo de papel y las páginas de la Calculadora. Con Elegir la portada completa… eliges la portada ya hecha (PDF, JPG o PNG) y PressWork comprueba enseguida sus medidas: un PDF con marcas de corte hay que volver a exportarlo sin ellas, a una portada hecha al formato de corte le falta el sangrado, y por debajo de 300 DPI aparece un aviso. Quitar la quita.
• Si las medidas no cuadran, la portada no se escribe, y el mensaje dice cuáles hacen falta. Sin portada la exportación se hace igualmente, y la portada se sube en KDP. La elección vale para el libro abierto y no se conserva tras un reinicio.
• Calculadora: a partir de las páginas y del papel (crema, blanco, Color estándar, Color prémium) da el lomo y el margen interior mínimo. El Color estándar no existe en A4 y solo se imprime a partir de 72 páginas.
• Plantillas KDP: tres esqueletos de texto (Novela 6x9, Ensayo 6x9, Autoayuda 5x8); el que eliges, tras una confirmación, sustituye el texto del editor.
• 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. Con una selección, Insertar en el editor no sustituye: propone, y tú decides en el texto (§36).
• 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

• 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)

1. Abre Herramientas → Collab y elige un nombre reconocible.
2. Crea una sesión nueva o pega el ID recibido de un colega.
3. Espera el estado Online y comprueba los participantes en el dock de colaboración.
4. Si necesitas voz/vídeo, inicia la llamada desde el panel Collab y usa los botones de silencio/cámara.

Cómo viajan los datos

• El texto, el chat y los adjuntos pasan por el servidor de conexión de PressWork (el relay), que los reenvía a los demás participantes sin guardarlos: no hay nada que configurar. Si el relay no responde, PressWork intenta conectar a los participantes directamente.
• La voz y el vídeo viajan con WebRTC, directamente entre los participantes o, si la red no lo permite, a través de un servidor de reenvío (TURN).
• La conexión está protegida durante el trayecto, pero el texto, el chat y los adjuntos no están cifrados de extremo a extremo: el servidor de conexión los ve mientras los reenvía. Por eso la colaboración no es adecuada para material confidencial.
• Quien tenga el ID de la sesión puede entrar: dáselo solo a quien invites, como una llave.

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: Configuración → Editor → Texto y Tipografía.
• Alto contraste (menús y ventanas): en la misma sección. Cambia menús, barras y ventanas; la hoja del texto queda igual.
• Fuente para dislexia en los menús: en la misma sección. Usa OpenDyslexic o Atkinson Hyperlegible si están instaladas en el sistema (PressWork no las incluye), y vale para los menús, no para el texto.

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 (la segunda vez los quita)
• Ctrl + Alt + V → Vim

25. Resolución de problemas

• PDF/X no disponible: instala LaTeX + Ghostscript y reinicia.
• La exportación ha fallado: lee el mensaje, que dice qué ha fallado y dónde (§35).
• 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 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.
• El texto, el chat y los adjuntos pasan por el relay de PressWork (no se puede configurar un relay propio), que los reenvía sin guardarlos; no están cifrados de extremo a extremo, así que no es la herramienta adecuada para material confidencial (§20).

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

1. Configura el modo Base/Pro según el entregable.
2. Verifica los requisitos en Control de exportación (Configuración → App → Instalaciones; LaTeX/Ghostscript solo si necesitas PDF/X).
3. Ejecuta el Preflight antes de la entrega.
4. Para EPUB/ICML completa el asistente de metadatos + portada.
5. Para documentos firmados activa la firma PKCS#7 + sello de tiempo.
6. En equipo, guarda el ID de sesión Collab en las instrucciones internas.

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. Nunca escribe en el texto: el puente tiene ocho herramientas de lectura y, solo en los documentos donde lo permites, dos que dejan propuestas para que las decidas tú (§36). Ninguna herramienta cambia el texto. 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. Versiones y variantes de capítulo

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

Una versión es otro libro. En cada versión, cada capítulo puede tener sus variantes.

29.1 Las versiones

• Una versión es una alternativa del documento entero: cambia el final, quita un personaje, prueba otra estructura. La definitiva, la que va a imprenta, queda intacta.
• Panel: Ctrl/Cmd+Shift+B o desde el menú. Abre una versión 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 versión. Sin píldora = estás en la definitiva.
• Hacer definitiva convierte la versión en el texto que va a imprenta; el texto anterior no se pierde, queda como punto en la Cronología y se puede restaurar. Comparar muestra las diferencias con la definitiva línea por línea. Copiar en un documento nuevo… separa la versión en un .pwk independiente.
• Todas las versiones 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 versión si allí ese capítulo es distinto, tachada si allí no existe. Un clic abre las Versiones. Las fichas idénticas en todas las versiones quedan limpias: el silencio significa «aquí no se ha separado nada». Dentro de una versión la comparación incluye la definitiva, que es justo con la 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 versión tiene sus variantes: las creadas dentro de una versión no aparecen en la definitiva, 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.

30. La vista Tabla, las entregas y el resto de la 4.4

30.1 La vista Tabla y la fecha de entrega

• Dentro de la Sinopsis, la vista Tabla muestra los capítulos como una tabla: para cada uno el objetivo de palabras, las palabras escritas y la Diferencia entre ambos. Arrastra las filas para reordenarlas; el nuevo orden se aplica al documento real.
• El pie lleva las cuentas globales: objetivo del documento, cuánto está asignado a los capítulos, cuánto queda por asignar. Para imprimir, la última fila estima las páginas e indica cuántas faltan para el múltiplo de 16 (el pliego de imprenta).
• En la ventana 🎯 Objetivos (barra superior) puedes añadir una fecha de entrega: el pie de la Tabla dirá cuántos días quedan y cuántas palabras al día hacen falta — contando las palabras escritas, no los objetivos. Es opcional y desaparece con el objetivo diario; alcanzada la meta, el ritmo calla.

30.2 El diálogo de actualización

• Cuando sale una versión nueva, pocos segundos después del arranque una ventana dice qué versión está disponible y cuál tienes. «Novedades» abre el registro de cambios en tu idioma; «Actualizar ahora» descarga y reinicia; «Más tarde» cierra sin insistir: la propuesta volverá en el próximo arranque.

30.3 Los dos idiomas del asistente

• El asistente te habla en el idioma de la aplicación y escribe en el idioma del manuscrito: app en español y novela en inglés = explicaciones en español, prosa en inglés. Pide explícitamente una traducción cuando quieras cambiar el idioma del texto.

31. Importar una carpeta de Markdown (Notion, Obsidian, apuntes)

• Archivo y Proyecto → Importar carpeta de Markdown: elige una carpeta de archivos .md — una exportación de Notion (Exportar → Markdown y CSV con subpáginas, luego descomprime el zip), un vault de Obsidian (ya es una carpeta) o una carpeta de apuntes. PressWork muestra el árbol real y pregunta dónde empieza el libro: las entradas de primer nivel bajo el punto elegido se convierten en capítulos, las más profundas en secciones. Se crea un .pwk nuevo junto a la carpeta; el original no se toca.
• Notion y Obsidian se reconocen solos: fuera los códigos hexadecimales de los títulos, bases de datos pequeñas → tablas y grandes → Notas, filas de bases de datos excluidas, callouts → citas; [[wikilinks]] y embeds resueltos por nombre, front matter eliminado. Las imágenes se copian en el documento; los enlaces entre páginas del libro se convierten en referencias, los que apuntan fuera en texto.
• El informe final dice qué entró y qué no — páginas, capítulos, imágenes copiadas y no encontradas, enlaces reescritos y convertidos en texto, tablas, archivos excluidos, bloques de código cerrados. Las entradas a cero también se ven.

32. Guardar y exportar con nombre, abrir desde el sistema (4.5)

• Guardar con nombre… (Archivo y Proyecto, junto a Guardar): en un .md guarda una copia con el nombre elegido y se sigue en la copia; en un .pwk duplica todo el documento — texto, metadatos, imágenes, apuntes, historial, versiones — y abre la copia, sin las salidas de exports/. El título de la sección dice siempre qué archivo está abierto («Documento · novela.pwk»); Guardar como documento .pwk solo aparece en un .md.
• Exportar con nombre… (panel Exportar, junto a Generar): abre siempre el diálogo del sistema para nombre y carpeta, incluso donde la exportación normal escribe sin preguntar. El campo Nombre de archivo está bajo Formato y el nombre elegido se recuerda por documento, independiente del título de los metadatos.
• Abrir con: en Mac y Windows PressWork aparece en «Abrir con» para los archivos .md sin convertirse en su programa predeterminado: después de instalarlo, un .md se sigue abriendo con el programa de antes. El doble clic en un .md asociado a PressWork abre ese archivo, incluso con la app ya abierta. En Mac (desde la 4.6) un .pwk es un documento: el doble clic abre PressWork; para ver su interior está Mostrar contenido del paquete (clic derecho), y los archivos exportados se abren desde la píldora de la salida o desde Compartir. En Windows y Linux un .pwk sigue siendo una carpeta: se abre desde Recientes, arrastrándolo a la ventana o desde Abrir documento.

33. Dictar en lugar de escribir

• Dictar en lugar de escribir: PressWork usa el dictado del sistema, que escribe en el editor como en cualquier campo de texto, con la puntuación dicha en voz alta («coma», «punto»). macOS: dos veces fn; sin fn, Ajustes del Sistema → Teclado → Dictado → Atajo, por ejemplo «Pulsar Control dos veces». Windows: Win+H. Linux no tiene dictado del sistema.

34. Dónde estás y qué está guardado (4.6, 4.7)

• El nombre del documento está siempre a la vista: abajo a la izquierda, en la barra de estado (al pasar el ratón se lee la ruta completa), y en el título de la ventana donde el sistema lo muestra. En una versión aparece al lado 🌿 con su nombre, y al reabrir un documento que dejaste en una versión, PressWork vuelve a esa versión.
• Un .md con cambios sin guardar tiene el nombre en cursiva, con un «•» delante. Si cierras PressWork en ese estado, la app pregunta si cerrar sin guardar. Si cierras de todos modos, los cambios quedan apartados: al reabrir, PressWork vuelve al último .md y ofrece restaurarlos; luego basta con guardar. Un .pwk se guarda solo y no pregunta nada, mientras el guardado funcione.
• Si un guardado falla (el .pwk renombrado o movido desde fuera, el disco lleno, los permisos, una memoria USB desconectada), el estado queda a la vista: el nombre lleva el «•», y el indicador de abajo y la píldora de arriba dicen ⚠️ No guardado hasta que un guardado funcione. Antes de cerrar la app, pasar a otra versión, «Hacer definitiva» o abrir otro documento, aparece la ventana «El documento no se guarda», con el motivo.
• Las opciones de la ventana: «Reintentar el guardado» (después de volver a conectar la memoria USB o liberar el disco), «Guardar una copia…» (el texto en otro sitio), «Salir sin guardar» al cerrar o «Continuar sin guardar» en los demás casos, y «Cancelar» para quedarte. Si luego la salida no funciona, te quedas en el documento, y la próxima vez vuelve a preguntar. Un documento que se guarda no pregunta nada más.
• Si content.md se modifica con otro programa, una franja propone recargarlo.

35. Exportar y pedir ayuda (4.6, 4.7)

• La exportación recuerda la última carpeta usada para cada documento, en este ordenador. Si cambias el título, en exports/ el archivo con el nombre antiguo se sustituye por el del nombre nuevo, para no enviar el equivocado.
• Después de exportar, el mensaje «Exportación completada en: …» tiene dos botones: Abrir abre el archivo, Mostrar en la carpeta lo muestra ya seleccionado. Están también después de un PDF/X o con un aviso, y el mensaje se queda mientras tengas el ratón encima; después de la exportación KDP, «Abrir» abre el interior.
• Si una exportación falla, el mensaje dice qué ha fallado y dónde, en el idioma de la app: el comando LaTeX desconocido y cerca de qué frase, el paquete LaTeX que falta y cómo instalarlo, el error de Typst con su línea, el front matter YAML roto. Si faltan imágenes, dice cuántas son, la primera y la carpeta en la que las ha buscado.
• Word y ODT salen con el tamaño de página y los márgenes del PDF; el ePub tiene índice y la hoja de estilo de PressWork, también al exportar un solo documento.
• Las fotos grandes, por ejemplo las del teléfono a resolución completa, se ven en el editor y en la vista previa a partir de una copia reducida, creada la primera vez en un segundo: la app no se bloquea, y las exportaciones usan siempre la foto original.
• Para el soporte: ventana Info → «Copiar la información para el soporte». Copia la versión, el sistema y los motores de exportación instalados, sin textos ni nombres de archivo: pégala en tu mensaje.

36. Revisiones y propuestas, decididas en el texto (4.7)

• Cada marca de revisión tiene sus botones. Junto a una adición, una eliminación o una sustitución hay ✓ (aceptar) y ✗ (rechazar); un resaltado o un comentario tienen ✓ (hecho: quita la marca y deja el texto). Se decide ahí donde está la marca, una a una; Deshacer (Ctrl/Cmd+Z) vuelve atrás.
• Los asistentes pueden proponer, nunca escribir. Un asistente conectado con el puente MCP (§28) — Claude, Codex, Gemini — solo puede dejar propuestas en los documentos donde lo permites: clic en el nombre del documento abajo → «Los asistentes pueden proponer cambios». Mientras está activado, junto al nombre se ve ✎ Propuestas de IA activadas: un clic lo desactiva. En los documentos nuevos está desactivado.
• Las propuestas esperan fuera del texto. Cuando llegan aparece ✎ Propuestas de Claude: 3: un clic las lleva al texto como marcas, con el nombre de quien propone y el porqué (@Claude: …), para decidirlas con ✓ y ✗. Deshacer las quita todas a la vez. No entran solas: el texto no se mueve mientras escribes.
• También la IA de PressWork propone. Con una selección, en el panel de IA Insertar en el editor pone su texto como propuesta, con ✓ y ✗ (en varias líneas, cada línea se decide por separado), y mientras no la aceptes, a imprenta va el texto anterior. Sin selección, el texto se añade en el cursor, como antes. Con una selección, la IA responde con el texto nuevo y nada más.
• Todas a la vez. Junto a ✓ ✗ de una propuesta hay ▾, con «Aceptar todas las propuestas de AI (15)» y «Rechazar todas las propuestas de AI (15)»: valen para quien hizo esa propuesta, y las propuestas de los demás autores y tus propias revisiones se quedan donde están. Deshacer las devuelve todas.
• Si mientras tanto has cambiado esa frase, la propuesta no toca nada: la píldora la cuenta entre las «ya no aplicables» y se descarta.
• Lo que no has decidido no va a imprenta. Una propuesta pendiente queda fuera de la vista previa y de toda exportación, como si estuviera rechazada, y el menú Export dice cuántas hay. Tus propias revisiones siguen aceptadas como siempre.
• También apuntes y sinopsis. Un asistente puede proponer un apunte nuevo (nota, investigación, personaje) o la sinopsis de un capítulo. Con la píldora llegan a su sitio: el apunte al panel Apuntes con la etiqueta «✎ @Claude», la sinopsis a la ficha del capítulo, en un recuadro. Los conservas o los descartas ahí; nada sobrescribe lo que ya has escrito.
• Las propuestas valen para la versión definitiva, no para las otras versiones.