¿La forma más sencilla de escribir conjuntamente un manuscrito?

Al igual que con muchos artículos en las ciencias, hay varios autores que no están físicamente cerca el uno del otro. Tenía curiosidad sobre la forma más eficiente y sencilla de compartir técnicamente la escritura. En el lado más complicado estaría LaTeX y, posteriormente, usar subversión para fusionar todos los cambios. Luego está Google Docs. Finalmente, están las ediciones tradicionales de escritura en Word y correo electrónico del documento con comentarios de ida y vuelta.

¿Que funciona?

Olvidó un enfoque tradicional: "Estoy liberando el token para la Sección 2; la fuente de látex actualizada se adjunta a este correo electrónico. Ahora reclamo el token para las Secciones 3 y 4".
Debo agregar, mi asesor no es técnicamente competente. De ahí el énfasis en lo más simple.
Uso un servicio de repositorio de SubVersioN, muchos de ellos están disponibles en línea de forma gratuita (consulte, por ejemplo, xp-dev.com ).
Necesitas poner a uno de los autores a cargo. De lo contrario, el que no es técnicamente competente sería el cuello de botella.
Si literalmente se refiere a la forma más simple (incluso un poco más que el excelente comentario de JeffE), entonces no puede obtener nada más simple que el enfoque ingenuo: pase un solo archivo de un lado a otro por correo electrónico, con el destinatario teniendo el control total hasta que lo devuelven por correo electrónico. Este es el único enfoque que conozco que no requiere competencia técnica ni software especial (más allá de lo que se necesita para escribir un artículo de un solo autor), y que evita cualquier complicación relacionada con múltiples archivos, copiar y pegar, o quién tiene permiso exactamente. hacer que. Esto puede ser excesivo, pero a veces ayuda.
@AnonymousMathematician: hacer que el técnicamente incompetente edite y el competente haga la fusión puede funcionar bien.
@eykanal: Buen punto, aunque aún debe haber hecho algún arreglo sobre cómo evitar (o manejar) ediciones conflictivas en la misma sección.
@JeffE Espero con ansias el día en que el paso manual de tokens se vea como una reliquia antigua similar a un grabado en piedras :)
@Suresh Aawwww.

Respuestas (4)

Si su colaborador no tiene inclinaciones técnicas, existen algunas posibilidades:

  • Google Docs
    es muy simple, robusto y en tiempo real (sin necesidad de pensar 'qué versión es la más reciente'). Creé muchos documentos con él (aunque solo 1 artículo científico). Una buena idea es usar diferentes colores para que quede claro quién escribió qué. Un inconveniente es que puede que no sea tan simple para las ecuaciones y que necesitará copiar las cosas desde allí a LateX manualmente.
  • Anotación de archivos PDF con Adobe Reader o algo equivalente
    También simple y robusto. Sin embargo, como no es en tiempo real, debe realizar un seguimiento de la versión actual y no es posible realizar cambios al mismo tiempo. Aquí usted es el único responsable de los cambios en el archivo LaTeX.
  • Anotar o cambiar con OpenOffice , MS Word u otro paquete ofimático...
    Otra variante que permite a tu colaborador realizar cambios directos, a costa de cierta robustez.

Como observación práctica para los dos últimos: siempre mantenga un registro de la versión, por ejemplo draft_20120424_prof.pdf, donde agrega tanto la fecha de la última edición (¡no final5!) como el nombre del último editor. Al intercambiar cosas por correo electrónico, es fácil perder el rastro de qué versión es la más reciente y, de hecho, se pierden los cambios (a menudo sin saberlo).

Otras posibilidades, que requieren algunos conocimientos técnicos:

  • writeLaTeX o algo similar ( ShareLaTeX , ScribTeX , LaTeX Lab - el que usa GoogleDocs, ...)
    Herramientas para editar documentos en colaboración (en tiempo real) y compilarlos dentro del navegador (por lo que no es necesario instalar nada). Aunque se requiere algún conocimiento de LaTeX (al menos para saber cómo no estropear un archivo).
    ScribTeX (el único que usé) brinda control de versión y puede ver qué líneas se cambiaron (como en el sistema de control de versión), por lo que no es necesario adivinar qué podría haber cambiado.
    EDITAR: ScribTeX está siendo reemplazado por ShareLaTeX.
    writeLaTeX tiene vista previa en vivo y puede ser el más adecuado para principiantes.
  • Git u otro sistema de control de versiones, por ejemplo, en GitHub
    . Sin embargo, puede requerir habilidades técnicas más allá de la edición de LaTeX. Si bien no es difícil de usar, nunca lo hice. Lo estoy usando para escribir documentos y nunca intentaría usarlo con alguien con pocos conocimientos informáticos.

Cuando se trata de Dropbox , es bueno para compartir archivos para un proyecto, pero NO para realizar cambios en los archivos. Primero, nunca se sabe cuándo ocurren los cambios. En segundo lugar, no sabes dónde suceden los cambios.

También hay un artículo al respecto: Consejos de investigación: escritura colaborativa en línea .

Vea también algunas preguntas:

¡+1 buena variedad de posibilidades y advertencia sobre Dropbox! LaTeX + Git sigue siendo mi favorito.
Como señala la tercera pregunta sugerida, LaTeX Lab es una buena solución. Sin embargo, carece de algunas funciones. Pero te ayudaría a empezar. Prefiero esa opción.
@adn: Se agregó LaTeX Lab, gracias. De hecho, lo he intentado antes, pero el "historial de revisión" no funcionaba (y sigue sin funcionar).

Si está trabajando con documentos de Word, Word 2007 incluye una función de cambios de combinación muy ingeniosa. Este documento de ayuda en línea de microsoft.com detalla cómo funciona, pero en realidad no hace justicia a la función. Vea la siguiente captura de pantalla para una idea:

Comparación de documentos en Word 2007

Brevemente, puede hacer clic en "comparar" (en la cinta, tercero desde la derecha), y le permite elegir dos documentos de origen. A partir de ahí, abre la muy agradable interfaz que se muestra arriba, con los dos documentos de origen a la derecha, el documento fusionado en el medio y los cambios a la izquierda (o en la parte inferior, puede ocultarlo si no lo desea). ). Lo usa como cualquier otro "control de cambios"; simplemente revise, cambio por cambio, usando los botones "anterior", "siguiente", "aceptar" y "rechazar" en la sección Cambios de la cinta. Cuando haya terminado, simplemente guarde el documento combinado y tendrá su documento combinado.

Lo he usado varias veces y es una característica muy útil. Con mucho, el mejor aspecto de esto es que se puede utilizar con los técnicamente incompetentes. Simplemente dígales, "tome el documento, haga los cambios, yo me ocuparé de eso"; He usado esto con mi jefe tecnológicamente desafiado varias veces, y ha sido un salvavidas. Dada su situación, esta puede ser su mejor apuesta.

Horrible. Escribir un trabajo en Word.
@DaveClarke - Cuando la vida te da limones...
encogerse de hombros Si necesita usarlo, aquí está. Nunca he escrito un artículo académico en Word, y nunca lo haré, pero para aquellos que lo hacen, aquí tienen. No lo estoy recomendando ; Sólo estoy informando de una característica.
desafortunadamente, muchas revistas de ecología solo aceptan archivos de Word. Me he acostumbrado a escribir mis manuscritos en html solo para que Word los abra; es vergonzoso para mi campo.

También depende de cuál debe ser el formato final de su documento. Por ejemplo, escribo todos mis artículos en Latex y, cuando colaboro con otros investigadores, uso BitBucket .: Creo un repositorio de Latex y doy derechos de acceso a los demás autores. Un buen aspecto de BitBucket es que tienen un plan especial para académicos, donde puedes obtener una cantidad ilimitada de colaboradores de forma gratuita. Para evitar conflictos tanto como sea posible, generalmente descomponemos el documento principal en un archivo para cada sección, y tratamos de evitar trabajar en la misma sección al mismo tiempo, pero incluso si sucede, generalmente es posible fácilmente combinar las diferentes ediciones. Una buena característica es la posibilidad de recibir notificaciones automáticamente cuando un autor confirma sus cambios. Además, dado que cualquiera puede crear una cuenta de BitBucket, no existe el problema de crear una cuenta para un colaborador externo en un servidor interno.

Por supuesto, BitBucket no es la única posibilidad, y también se podría usar Git , o incluso Dropbox , aunque para este último, no me gusta mucho la falta de un sistema de versiones nativo.

Por otro lado, si no trabajo directamente en un documento, pero por ejemplo en un borrador para una propuesta de proyecto, entonces uso Google Docs , porque es bastante simple hacer algo de edición colaborativa.

También uso Bitbucket (y tenga en cuenta que su repositorio puede ser Git o Mercurial; Bitbucket aloja ambos). Sin embargo, no voté por esta respuesta porque no es la forma más sencilla . Tal vez se debería hacer una pregunta diferente.
Bueno, supongo que "más simple" es una noción relativa :) En mi humilde opinión, para escribir documentos de Latex, esta es la solución más simple para hacer trabajo colaborativo: no es necesario administrar un servidor, no es necesario pasar un token manual, también sirve como un copia de seguridad, posibilidad de confirmar localmente, todo con solo tres comandos: "hg pull --update", "hg commit" y "hg push". Ahora, si no se requiere látex, entonces no sé cuál es el más simple :)
Authorea.com está cerca de este flujo: detrás de escena hay un archivo por sección y es posible acceder a Git (aunque es un poco complicado de configurar), pero lo oculta detrás de una interfaz de usuario web para que los colaboradores puedan usarlo sin ningún software o Experiencia en control de versiones. Además, es compatible con Markdown.

Hacemos token pass y algún tipo de método para intercambiar los archivos. Creo que este método se trató en los comentarios, pero déjame explicarlo aquí. Usaré Word como ejemplo, ya que lo más probable es que si está pasando tokens manualmente, es porque no ha podido convencer a nadie en su equipo para que cambie a LaTeX, y las personas que no quieren cambiar a LaTeX es probablemente del tipo que no quiere lidiar con el control de versiones.

La "carpeta compartida" es el mecanismo que utiliza para compartir archivos. Podría ser una carpeta de Dropbox, correo electrónico, WebDAV, un directorio remoto en un servidor accesible por SSH, etc.

  1. Bloqueo : la persona que comienza con el archivo lo renombra para que su nombre esté al final. Envían un correo electrónico al grupo que dice: "Estoy cerrando la Sección 1". Enumere los bloqueos en el correo electrónico.

  2. Desbloqueo : Este es un proceso de varios pasos.

a. Si nadie más desbloqueó una sección antes de que usted la desbloqueara, puede cambiar el nombre del archivo a la fecha y hora actuales y luego colocarlo en la carpeta compartida.

b. Si otro colaborador desbloqueó una sección antes que tú, debes quitar la última versión de la carpeta compartida, copiar la sección en la que estabas trabajando y pegarla en la última versión que acabas de descargar. Cambie el nombre del archivo recién editado a la fecha y hora actuales, luego colóquelo en la carpeta compartida.

La razón por la que lo hace de esta manera y no de la otra (copiando y pegando las secciones de todos los demás en su documento) es porque hacerlo significa que debe realizar un seguimiento de lo que hicieron los demás, mientras que de esta manera solo necesita realizar un seguimiento de lo que lo hiciste.

Eso es básicamente todo. El mayor problema es cuando alguien no está prestando atención y no se fusiona correctamente, o cuando dos personas intentan bloquear algo al mismo tiempo (ya que el correo electrónico tiene un retraso), pero por lo general tendrá que hacer que alguien que conozca el proceso mantenga un control. atento a ello.