Centro de ayuda
Guías claras y prácticas para escribir, compilar y compartir proyectos LaTeX y Typst.
Git, GitHub y WebDAV
Mueve los archivos del proyecto por Git o sincronízalos con GitHub y almacenamiento externo.
Elegir la conexión adecuada
Elige Git, la sincronización con GitHub o WebDAV según cómo trabaje tu equipo. Estas conexiones están disponibles en Educación, Plus y Pro.
Cómo hacerlo
- Usa Git cuando quieras el proyecto en tu propia máquina con tu flujo de línea de comandos habitual.
- Usa la sincronización con GitHub cuando la fuente de verdad sea un repositorio que tu equipo ya revisa y publica.
- Usa WebDAV cuando el proyecto deba residir en almacenamiento institucional o personal en lugar de un servicio de código.
- Nada impide combinarlos, pero decide qué lado será el autoritativo antes de conectar el segundo.
- El plan que cuenta no es el mismo en cada caso: el acceso Git depende de tu propio plan, mientras que la sincronización con GitHub y con WebDAV depende del plan del propietario del proyecto.
- Para partir de archivos que ya están en otro sitio, elige «Importar desde GitHub o WebDAV» en el panel. Crea un proyecto a partir de una rama de un repositorio o de una carpeta WebDAV y lo mantiene conectado.
Configurar la conexión
Prepara las credenciales necesarias para el tipo de conexión y configúrala en el proyecto que quieras sincronizar.
Cómo hacerlo
- Para Git por línea de comandos, abre Tokens de acceso en la configuración de la cuenta y crea un token de Git. En el proyecto, despliega Git, copia la URL del repositorio o el comando de clonado y usa el token como contraseña HTTP Basic. Los lectores pueden clonar y hacer pull; propietarios y editores además pueden hacer push a main.
- Un push que va por detrás del proyecto se fusiona automáticamente cuando tus cambios y los de tus colaboradores afectan a archivos distintos. Cuando afectan al mismo archivo, el push se rechaza e indica las rutas: ejecuta git pull, resuelve y vuelve a hacer push.
- Para la sincronización con GitHub, abre Conexiones externas en la configuración de la cuenta, conecta GitHub e instala la GitHub App de JointTex en los repositorios que elijas. Después abre GitHub en las Conexiones externas del proyecto, elige repositorio y rama existentes, revisa la vista previa completa de cambios y confirma la sincronización manual.
- JointTex sincroniza toda la raíz del repositorio, salvo .github/workflows. Un repositorio que contiene submódulos no se puede sincronizar. La sincronización siempre es manual: un cambio en GitHub solo queda señalado en el proyecto hasta que eliges «Revisar y sincronizar».
- Para usar un repositorio nuevo, elige «Crear repositorio en GitHub», concede a la GitHub App acceso a él si hace falta y después elige «Actualizar repositorios». En un repositorio vacío, JointTex crea la rama durante la primera sincronización.
- Para WebDAV, guarda un perfil reutilizable en Configuración de la cuenta › Conexiones externas con la URL de la carpeta raíz, el usuario y una contraseña de aplicación, o introduce credenciales para un solo proyecto. Elige la carpeta del proyecto, prueba la conexión, revisa la primera sincronización y conecta.
Mantener WebDAV sincronizado
Solo se contacta con una carpeta WebDAV cuando hay motivo para ello, así que un cambio que solo existe en el remoto espera a la siguiente sincronización.
Cómo hacerlo
- Usa Sincronizar ahora cuando necesites traer cambios que solo existen en el WebDAV remoto. La sincronización automática opcional de WebDAV solo se dispara tras un cambio en el proyecto de JointTex; tres fallos seguidos la pausan hasta que una sincronización manual funcione.
- Si la primera vista previa muestra conflictos, conectar no cambia ningún archivo; revisa los conflictos una vez creada la conexión.
- Las credenciales introducidas para un solo proyecto se pueden conservar más adelante para otros proyectos con «Guardar como perfil de cuenta».
Resolver conflictos y gestionar el acceso
Si hay un conflicto, revisa las diferencias antes de decidir qué versión conservar. Los permisos siguen los roles del proyecto.
Cómo hacerlo
- Si GitHub o WebDAV informa de un conflicto, esa sincronización no cambia ningún archivo.
- Abre Revisar conflictos, compara ambas versiones, elige qué lado conservar —o conserva los dos cuando se ofrezca— y envía todas las decisiones; JointTex vuelve a comprobar ambos lados antes de escribir.
- Usa «Aplicar a todos los archivos compatibles» para tomar una sola decisión para muchos archivos. Un archivo que no se puede mostrar como diff de texto se puede descargar en ambas versiones antes de decidir.
- El propietario configura o desconecta GitHub y WebDAV; propietarios y editores sincronizan y resuelven conflictos, y los lectores pueden consultar el estado.
- Si desconectas con conflictos sin resolver, ambas versiones siguen disponibles para descarga durante 30 días en «Archivos de conflictos recientes», pero ya no se pueden aplicar automáticamente.
- Desconecta los proyectos que ya no uses antes de eliminar una cuenta de GitHub o un perfil de WebDAV.