¿Cómo instalar HedgeDoc en Saplo (edición colaborativa de documentos Markdown en vivo)?

Tomar notas de una reunión por una sola persona, mientras el resto del equipo espera o añade comentarios en el chat, es más lento que escribir el mismo documento juntos en vivo. Notion y Dropbox Paper lo permiten, pero a costa de una cuenta en la nube de terceros y una suscripción que crece con el número de personas en el equipo. HedgeDoc es un editor Markdown de código abierto en el que varias personas trabajan en el mismo documento simultáneamente, ven los cursores y los cambios de los demás en tiempo real, y todo ello lo configuras en tu propio Box. A continuación, te mostramos cómo instalar HedgeDoc en Saplo paso a paso.

Por qué HedgeDoc en lugar de Notion o Dropbox Paper

Las herramientas de pago para la edición colaborativa de documentos tienen dos características que afectan más a los equipos pequeños y a los autónomos:

• el precio aumenta con el número de personas - el plan gratuito suele ser suficiente para una persona, y añadir cada colaborador adicional a un equipo en Notion o una herramienta similar es una partida independiente en la factura cada mes,
• el contenido de los documentos reside en el servidor de otro - las notas de reuniones, los planes de proyectos y los borradores de textos están en manos de una empresa externa, no en las tuyas.

HedgeDoc funciona como un contenedor Docker con su propio contenedor PostgreSQL en tu Box, por lo que el contenido de todos los documentos y el historial de edición permanecen en tu infraestructura, sin coste por persona y sin límite en el número de documentos.

HedgeDoc vs. Trilium y Wiki.js/BookStack: tres nichos de notas diferentes en el catálogo de Saplo

El catálogo de Saplo ya incluye Trilium Notes, Wiki.js y BookStack, así que la pregunta natural es en qué se diferencia HedgeDoc de ellos. La respuesta está en el propósito de cada una de estas herramientas:

• Trilium Notes es un bloc de notas personal: una base de datos jerárquica de notas y conocimientos, creada por un solo usuario durante un período prolongado, sin énfasis en la edición en vivo por varias personas a la vez.
• Wiki.js y BookStack son wikis empresariales con control de versiones de páginas, estructura de categorías y permisos, ideales para documentación con una estructura constante y un historial de cambios, pero no para un borrador colaborativo rápido en vivo.
• HedgeDoc se centra exclusivamente en la edición en vivo y simultánea de un único documento Markdown: ves los cursores de otros participantes y sus cambios en tiempo real, sin la estructura de una base de conocimientos completa y sin un sistema de permisos como en una wiki empresarial.

Si estás creando una base de conocimientos personal, echa un vistazo a Trilium. Si tu equipo necesita documentación estructurada con historial de versiones, elige Wiki.js o BookStack. Si se trata de escribir notas de reuniones o un borrador de texto en vivo, aquí, ahora, junto con alguien, HedgeDoc es la mejor opción.

Requisitos

Para instalar HedgeDoc en Saplo, necesitas:

• Un Box con Docker en funcionamiento (el motor lo activa automáticamente durante la instalación desde el catálogo, se requiere anidamiento en el contenedor, algo que Saplo tiene por defecto).
• Un mínimo de 1 GB de RAM libre en el Box y 2 GB de espacio en disco, es decir, un plan Box M (65 €/año) o superior.
• Un dominio o subdominio *.saploapp.pl incluido en el precio de cada plan, donde se alojará el editor.
• NO necesitas configurar una base de datos separada manualmente. HedgeDoc requiere una base de datos SQL, y el motor configura un contenedor PostgreSQL dedicado para este propósito en el mismo docker-compose (la base de datos compartida de Saplo solo es compatible con MySQL/MariaDB).

Instalación paso a paso

1. En el panel de Saplo, ve al Catálogo de aplicaciones y selecciona HedgeDoc (categoría "Negocios").
2. Indica el Box con al menos 1 GB de RAM libre donde se instalará el editor, y el dominio o subdominio bajo el cual funcionará.
3. Confirma la instalación. El motor implementa un contenedor desde la imagen oficial quay.io/hedgedoc/hedgedoc junto con un contenedor dedicado postgres:15-alpine, genera una contraseña de base de datos aleatoria y un secreto de sesión aleatorio, y luego expone la aplicación exclusivamente en el loopback del Box, conectado a Nginx, que la sirve bajo el dominio especificado con SSL gratuito. Solo el puerto 443 está expuesto externamente, no el puerto raw del contenedor.
4. Después de docker compose up, el motor verifica adicionalmente si la página de HedgeDoc realmente responde a través de HTTP, ya que el primer inicio del contenedor realiza migraciones del esquema de la base de datos y puede demorar más de los típicos pocos segundos, por lo que el estado "el contenedor está funcionando" no significa que la aplicación esté lista.
5. La edición colaborativa funciona a través de websocket en el mismo dominio que la aplicación; no requiere ninguna configuración adicional del lado del cliente ni un puerto separado.

Primera configuración

HedgeDoc, a diferencia de Directus o Wiki.js, no tiene el concepto de cuenta de administrador: cualquier persona que se registre es un usuario normal y solo ve sus propios documentos y aquellos a los que se le ha enviado un enlace.

1. Ve a la dirección de tu dominio, por ejemplo, notatki.saploapp.pl, y crea la primera cuenta en el asistente de registro la primera vez que entres en la página.
2. Crea un nuevo documento con el botón New note - obtendrás un enlace de edición único que enviarás a cualquiera que necesite unirse a la colaboración en el contenido.
3. Los colaboradores abren el mismo enlace y ven inmediatamente los cursores y los cambios de otros en tiempo real, sin necesidad de crear su propia cuenta, si el documento tiene acceso abierto a la edición.
4. Puedes exportar el documento terminado a PDF, HTML o un archivo Markdown sin formato desde el menú del documento, o compartirlo solo para lectura con un enlace separado.
5. Puedes ver el historial de versiones del documento en la vista Revision, lo que te permite volver a contenido anterior sin necesidad de copiar manualmente las copias de seguridad.

HedgeDoc en Saplo vs. Notion y Dropbox Paper

Preguntas frecuentes

¿HedgeDoc necesita una base de datos separada? Sí, a diferencia de algunas aplicaciones en el catálogo de Saplo, HedgeDoc requiere una base de datos SQL, por lo que el motor despliega un contenedor PostgreSQL dedicado para ella en el mismo docker-compose, y no utiliza la base de datos compartida de Saplo que solo está disponible para MySQL/MariaDB.

¿En qué se diferencia HedgeDoc de Trilium Notes, si ambos están en el catálogo de Saplo? Trilium es un cuaderno jerárquico para una sola persona, diseñado para ser construido a lo largo del tiempo. HedgeDoc se centra en la edición simultánea de un único documento por varias personas a la vez, en tiempo real.

¿Es necesario crear una cuenta para coeditar un documento? No, si el documento tiene acceso abierto a la edición, solo necesitas el enlace. La cuenta la creas tú mismo exclusivamente para tener una lista de tus propios documentos guardados permanentemente.

¿Se puede exportar un documento terminado fuera de HedgeDoc? Sí, desde el menú del documento puedes exportar el contenido a PDF, HTML o un archivo Markdown sin formato.

Si tu equipo escribe notas y borradores juntos, en tiempo real, y busca un editor sencillo sin suscripciones por persona, escríbenos. Te ayudaremos a elegir el Box adecuado para tu equipo.