Escribir con alguien más
Sin cuenta propia de ComdTeX, sin la nube de ComdTeX
ComdTeX no tiene un servicio propio de sincronización. En vez de eso, mantiene el vault sincronizado entre coautores usando un repositorio Git que tú controlas: GitHub, GitLab, o cualquier host de Git. Todo esto se maneja desde una sección del panel de Git llamada “Escribir con alguien más”, en lenguaje simple. No necesitas saber Git para usarla.
Compartir un vault, una sola vez
- Abre el panel de Git (el botón de rama en la barra superior). Si el vault todavía no tiene repositorio, el mismo panel lo inicializa.
- En “Escribir con alguien más”, haz clic en Crear repositorio en GitHub. Créalo privado y vacío, sin README.
- Copia la dirección del repositorio (la que empieza con
https://…ogit@…) y pégala en el cuadro; haz clic en Conectar. Tu vault se sube y se convierte en la copia compartida. - Invita a tu coautor desde la configuración del repositorio (Colaboradores). Ellos lo clonan una vez y abren esa carpeta como vault en ComdTeX.
El día a día
La sección siempre muestra una frase que describe dónde estás parado, y uno o dos botones:
| Dice | Significa | Qué presionar |
|---|---|---|
| Tienes trabajo sin guardar en el historial | Escribiste algo desde el último punto de guardado | Guardar y enviar (el mensaje es opcional; si lo dejas vacío se usa uno honesto con la fecha) |
| Hay N cambios nuevos de tu coautor | Te enviaron trabajo que todavía no tienes | Traer cambios |
| Tienes N cambios guardados esperando enviarse | Tus puntos de guardado no llegaron a la copia compartida | Enviar cambios |
| Todo al día con la copia compartida | No hay nada que hacer | Nada |
Si intentas enviar y tu coautor llegó primero, ComdTeX te avisa que traigas sus cambios antes y vuelvas a enviar. Nada se pierde en ese intercambio.
Cuando los dos editaron las mismas líneas
Traer cambios puede detenerse en un conflicto: las mismas líneas cambiaron en ambos lados, y ningún programa debería decidir en silencio cuál versión de un párrafo sobrevive. La sección lista cada archivo en conflicto con dos botones:
- Mantener la mía: se queda tu versión de ese archivo.
- Usar la suya: se queda la versión de tu coautor.
Para un resultado mixto, abre el archivo en el editor en su lugar: las regiones en conflicto están marcadas entre líneas <<<<<<<, ======= y >>>>>>>. Deja lo que quieras, borra las marcas, y guarda. Cuando todos los archivos estén resueltos, presiona Terminar la fusión, y luego envía.
Notas
- Las secciones avanzadas del panel de Git (ramas, staging, stash, remotos) siguen disponibles: la sección guiada es una capa encima, no un reemplazo.
- Funciona con cualquier host de Git, no solo GitHub; el botón de crear simplemente abre GitHub porque es donde ya está la mayoría de los coautores.
- Repositorio privado más historial de Git significa que tus borradores son tuyos, quedan versionados, y no pasan por ningún servidor salvo el que tú elegiste. Es la misma postura local-first del resto de ComdTeX.
Write with someone else
No ComdTeX account, no ComdTeX cloud
ComdTeX has no sync service of its own. Instead, it keeps a vault in sync between coauthors using a Git repository you control: GitHub, GitLab, or any Git host. All of this is driven from a section of the Git panel called “Write with someone else”, in plain language. You never need to know Git to use it.
Sharing a vault (once)
- Open the Git panel (the branch button in the top bar). If the vault has no repository yet, the same panel initializes one.
- In “Write with someone else”, click Create repository on GitHub. Create it private and empty, no README.
- Copy the repository address (the one starting with
https://…orgit@…) and paste it into the box; click Connect. Your vault is uploaded and becomes the shared copy. - Invite your coauthor from the repository’s settings (Collaborators). They clone it once and open that folder as a vault in ComdTeX.
Day to day
The section always shows one sentence describing where you stand, and one or two buttons:
| It says | It means | What to press |
|---|---|---|
| You have work not yet saved to the history | You wrote things since the last save point | Save and send (the message is optional; an honest dated one is used if you leave it empty) |
| There are N new changes from your coauthor | They sent work you do not have yet | Bring changes |
| You have N saved changes waiting to be sent | Your save points have not reached the shared copy | Send changes |
| Everything level with the shared copy | Nothing to do | Nothing |
If you try to send and your coauthor got there first, ComdTeX tells you to bring their changes first, then send again. Nothing is ever lost in that exchange.
When you both edited the same lines
Bringing changes can stop on a conflict: the same lines changed on both sides, and no program should decide silently which version of a paragraph survives. The section lists each conflicted file with two buttons:
- Keep mine: your version of that file stays.
- Use theirs: your coauthor’s version stays.
For a mixed outcome, open the file in the editor instead: the conflicting regions are marked between <<<<<<<, =======, and >>>>>>> lines. Keep what you want, delete the markers, and save. When every file is settled, press Finish the merge, then send.
Notes
- The advanced sections of the Git panel (branches, staging, stash, remotes) remain available: the guided section is a layer on top, not a replacement.
- Works with any Git host, not only GitHub; the create button simply opens GitHub because it is where most coauthors already are.
- A private repository plus Git history means your drafts stay yours, versioned, and off every server except the one you chose. This is the same local-first stance as the rest of ComdTeX.