Manual de Usuario Presswork (ES)

Este manual documenta todas las funciones de Presswork y explica cada área.

1. Panorama general

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

2. Requisitos e instalación

• Incluido: Pandoc, Typst (PDF Base), motores internos.
• Opcional (Pro): LaTeX + Ghostscript para PDF/X certificados.

Dónde comprobarlo:

• Herramientas → Control de exportación.

3. Modos y licencias (Base / Pro)

• Base: interfaz simplificada, PDF rápido con Typst.
• Pro: PDF/X, preflight, multi‑export, opciones avanzadas.
• 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: Documentos, Herramientas, Exportar, Vista, licencia, guía.
• Editor: área Markdown con barra de herramientas.
• Paneles laterales: Outline, Snapshots, Backlinks, Scrivener.
• Barra de estado: palabras, caracteres, cursor, objetivos.

5. Menú Documentos

• Nuevo: crear documento.
• Guardar MD / Guardar como….
• Importar documento.
• Abrir proyecto.
• Modo Estructura.
• Gestionar Proyecto.
• Imprimir.
• Versiones.

6. Menú Herramientas

• Objetivos.
• Estadísticas.
• Guía de usuario.
• Control de exportación.
• Paleta de comandos.
• Análisis de estilo.
• Asistente AI.
• Modo Vim.
• Collab.
• Tour.
• Firma digital (Pro).

7. Menú Exportar

Formatos: PDF, PDF/X, PDF guion, FDX, DOCX/ODT, EPUB, HTML, ICML.

Opciones

• Estilo PDF, ICC, validación, marcas, sangrado.
• Metadatos EPUB + cover.
• Preflight, historial.
• Exportación múltiple, multi‑formato, exportar con recursos.
• Conversión por carpeta.

8. Menú Vista

• Modos: Escritura, Código, Vista previa, Página, Split.
• Idioma, Tema, Máquina de escribir, Focus.
• Presentación, Accesibilidad.

9. Barra de herramientas

Formato, títulos, enlaces, imágenes, código, listas, citas, tablas, CriticMarkup, templates, metadatos, snapshots, synopsis.

10. Paneles laterales

Outline, Snapshots, Backlinks, Scrivener, Scene Navigator.

11. Escribir en Markdown

Sintaxis básica + \newpage para salto de página. Drag & drop imágenes.

12. Templates

• Templates integrados.
• Templates personalizados:
  • .md cargables en el editor.
  • .tex como estilo PDF (PDF estándar).
• Biblioteca compartida.

13. Metadatos

Editor de metadatos, YAML front‑matter, cover EPUB.

14. Proyectos y Modo Estructura

Crear proyecto, añadir capítulos, reordenar, exportar en orden.

15. Exportación detallada

PDF Base (Typst), PDF/X (LaTeX), PDF guion, FDX, DOCX/ODT, EPUB, HTML, ICML con mapeo de estilos y presets/importación de .icml. Incluye exportación Excel con breakdown, plantillas, importación multi‑sheet con selección de hoja y vista previa de gráficos.

16. Exportación avanzada

Multi‑export, multi‑formato, exportar con recursos, historial.

17. KDP (Amazon)

Quick Export, calculadora, templates KDP y validador ePub con checklist, vista previa Kindle y reporte descargable.

18. Análisis de estilo

Repeticiones, legibilidad, sugerencias.

19. Asistente AI

Resúmenes, reescrituras, coherencia. Compatible con endpoints locales.

20. Colaboración

Sesiones compartidas con cursores remotos.

21. Firma digital

Firma PDFs con certificados PAdES‑T.

22. Presentación

Convierte documentos en diapositivas.

23. Accesibilidad

Tamaño de texto, alto contraste, fuente dislexia.

24. Atajos

Ctrl/Cmd+S, Ctrl/Cmd+N, Ctrl/Cmd+P, F11, Ctrl/Cmd+B/I/U, Ctrl+Alt+V.

25. Solución de problemas

PDF/X no disponible, templates no visibles, exportación lenta.

26. Rutas útiles

Templates: presswork/templates. PDF/X ICC: presswork/pdfx.

Actualizaciones recientes (Data Hub / Gráficos)

• Al insertar un gráfico desde Excel Data Hub ahora se muestra de inmediato una vista previa de imagen dentro del editor, no solo en el panel de vista previa.
• La vista previa inline del gráfico se redujo (aprox. 50%) para ser menos invasiva mientras escribes.
• Toggle bidireccional: 📝 Mostrar código abre el bloque chart-data, 🖼️ Volver al gráfico recupera la vista de imagen.
• El bloque chart-data se mantiene en Markdown para conservar compatibilidad total con preview/render/export.
• Insertar una tabla o un gráfico como imagen ahora guarda el archivo en los assets del documento (nombredoc.assets/images/) y en el editor solo entra la referencia Markdown: funciona también con hojas muy grandes.
• Si el documento aún no está guardado, la app propone guardarlo al momento (igual que al arrastrar imágenes); si rechazas, la tabla se inserta como texto Markdown y el gráfico queda en la hoja.
• La pregunta texto/imagen ahora entiende respuestas como "png", "jpg", "imagen", "foto"; una respuesta no reconocida vuelve a preguntar.
• La cuadrícula de datos sigue el tema claro/oscuro activo.
• Guardar como plantilla: ventana rediseñada al estilo de la app y traducida. Necesita datos en la cuadrícula y un modelo en el editor con marcadores {{NombreColumna}}; "Generar Markdown" repite el modelo por cada fila.
• Export Excel (breakdown): lee el texto del editor (escenas INT./EXT. o capítulos #); si no encuentra escenas ahora avisa en lugar de generar un archivo vacío en silencio.
• Menú Tables simplificado: eliminada la entrada duplicada "Importar como plantilla" (idéntica a "Abrir hoja Tables").
• Panel Import/Export: 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, Multi-formato, Con assets. Las opciones avanzadas solo muestran lo que aplica al formato elegido.
• 🧪 Verificar ICML: en el panel de export (formato ICML) comprueba el documento generado — jerarquía, front matter, escapes, párrafos vacíos — sin escribir nada; los detalles aparecen en una ventana de la app. La misma verificación se ejecuta en cada export ICML.
• Export FDX más seguro: el Markdown genérico (listas, tablas, notas) siempre se convierte en Acción — nunca en Personaje/Diálogo por accidente; los guiones reales se siguen interpretando. \newpage se convierte en un salto de página real (también en ICML, con estilo remapeable).
• Impresión vía PDF: el botón Imprimir genera un PDF temporal (Typst, misma tipografía que los exports) y lo abre en el visor del sistema — se imprime desde el diálogo nativo con vista previa fiel.
• Ajustes reorganizados: 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 de IA son plegables.

27. Análisis profundo de funciones (contenido añadido)

Esta sección cubre funciones avanzadas que existían en la app pero no estaban suficientemente explicadas.

27.1 IA: configuración y diagnóstico

• Endpoints IA cloud/local (OpenAI-compatible, Ollama, LM Studio) mediante PRESSWORK_AI_ENDPOINT, PRESSWORK_AI_MODEL, PRESSWORK_AI_API_KEY.
• Diagnóstico de conexión con informe JSON exportable.
• Control de estilo de respuesta (conciso/equilibrado/detallado), vista previa del prompt técnico y reintento del último prompt.
• Fijación endpoint/modelo por proyecto para mantener coherencia editorial.

27.2 Estadísticas: metodología de cálculo

• Productividad media con ventanas de 7 y 30 días.
• Velocidad de escritura por deltas de palabras en el intervalo de sesiones (palabras/hora y palabras/minuto).
• TTR = palabras únicas / palabras totales; MSTTR = media TTR en ventanas de 50 palabras.
• Estado de flow en tiempo real: intervalo medio de pulsaciones + ratio reciente de borrado.
• Pronóstico de finalización: rango optimista/pesimista con baseline 7d vs 30d.

27.3 Exportaciones avanzadas ahora documentadas

• Final Draft (.fdx): mapea encabezados tipo capítulo a Scene Headings, opciones de notas/saltos de página/numeración de escenas y sidecar .breakdown.json.
• ICML: mapeo de estilos (títulos/listas/citas/guion) + presets + importación .icml personalizada.
• Wizard EPUB/ICML bloquea exportación hasta completar metadatos mínimos y portada.
• Firma PDF: PKCS#7 detached + sello de tiempo RFC 3161.

27.4 Modo Bundle (.pwk)

• Acción principal Exportar con selector de destino.
• Destinos de salida automáticos para reducir errores de ruta.
• Toggle en header para mostrar temporalmente exportaciones rápidas clásicas.

27.5 Colaboración en redes restrictivas

• ID de sesión compartible pw-..., cursores remotos por color, comentarios inline y sincronización en vivo.
• Llamadas voz/video dentro de la sesión.
• Fallback por relay WebSocket si falla WebRTC (presswork-collab-relay-url).