flujo de trabajo git + LaTeX

Cambios en su flujo de trabajo LaTeX:

El primer paso para administrar eficientemente un flujo de trabajo de Git+LaTeX es realizar algunos cambios en sus hábitos de LaTeX.

• Para empezar, escribe cada oración en una línea separada . Git fue escrito en código fuente de control de versiones, donde cada línea es distinta y tiene un propósito específico. Cuando escribes documentos en LaTeX, a menudo piensas en términos de párrafos y los escribes como un documento fluido. Sin embargo, en git, los cambios en una sola palabra de un párrafo se registran como un cambio en todo el párrafo.

  Una solución es usar git diff --color-words(vea mi respuesta a una pregunta similar ¿ Cómo usar Mercurial para el control de versiones de documentos de texto? donde muestro un ejemplo). Sin embargo, debo enfatizar que dividir en líneas separadas es una opción mucho mejor (solo lo mencioné de pasada en esa respuesta), ya que descubrí que genera conflictos de fusión mínimos.

• Si necesita ver la diferencia del código, use la diferencia nativa de Git. Para ver la diferencia entre dos confirmaciones (versiones) arbitrarias, puede hacerlo con las shas de cada una de las confirmaciones. Consulte la documentación para obtener más detalles y también para mostrar qué archivos han cambiado entre dos revisiones .

  Por otro lado, si necesita ver la diferencia de su salida formateada , use latexdiffla cual es una excelente utilidad (escrita en Perl) que toma dos archivos latex y produce una salida clara y diferenciada en pdf como esta ( fuente de la imagen ):

  

  Puede combinar gity latexdiff(más latexpandsi es necesario) en un solo comando usando git-latexdiff (por ejemplo, git latexdiff HEAD^para ver la diferencia entre su árbol de trabajo y el penúltimo compromiso).

• Si está escribiendo un documento extenso en LaTeX, le sugiero dividir los diferentes capítulos en sus propios archivos y llamarlos en el archivo principal usando el \include{file}comando. De esta manera, le resultará más fácil editar una parte localizada de su trabajo y también será más sencillo controlar las versiones, ya que sabrá qué cambios se han realizado en cada capítulo, en lugar de tener que averiguarlo a partir de los registros de un gran capítulo. archivo.

Usando Git eficientemente:

• ¡Usa ramas! . Quizás no haya mejor consejo que pueda dar. He descubierto que las ramas son muy útiles para realizar un seguimiento de "diferentes ideas" para el texto o para "diferentes estados" del trabajo. La masterrama debe ser su cuerpo principal de trabajo, en su estado más actual "listo para publicar", es decir, si de todas las ramas, si hay una en la que está dispuesto a ponerle su nombre, debe ser la rama maestra.

  Las sucursales también son extremadamente útiles si eres un estudiante de posgrado. Como atestiguará cualquier estudiante de posgrado, es probable que el asesor haga numerosas correcciones, con la mayoría de las cuales usted no está de acuerdo. Sin embargo, se podría esperar que al menos los cambie por el momento, incluso si se revierten más adelante después de las discusiones. Entonces, en tales casos, podría crear una nueva rama advisory realizar cambios a su gusto, manteniendo al mismo tiempo su propia rama de desarrollo. Luego puedes fusionar los dos y elegir lo que necesites.

• También sugeriría dividir cada sección en una rama diferente y centrarse solo en la sección correspondiente a la rama en la que se encuentra. Genera una rama cuando creas una nueva sección o secciones ficticias cuando realizas tu confirmación inicial (tu elección, en realidad). Resista la tentación de editar una sección diferente (digamos, 3) cuando no esté en su rama. Si necesita editar, confirme este y luego verifique el otro antes de bifurcarse. Esto me parece muy útil porque mantiene el historial de la sección en su propia rama y también te dice de un vistazo (desde el árbol) la antigüedad de alguna sección. Quizás haya agregado material a la sección 3 que requiera ajustes en la sección 5... Por supuesto, esto, con toda probabilidad, se observará durante una lectura cuidadosa, pero me resulta útil verlo de un vistazo para poder cambiar de tema. si me estoy aburriendo de una sección.

  Aquí hay un ejemplo de mis ramas y fusiones de un artículo reciente (uso SourceTree en OS X y Git desde la línea de comandos en Linux). Probablemente notarás que no soy el cometedor más frecuente del mundo ni dejo comentarios útiles todo el tiempo, pero esa no es razón para que no sigas esos buenos hábitos. El mensaje principal es que trabajar en sucursales es útil. Mis pensamientos, ideas y desarrollo proceden de forma no lineal, pero puedo realizar un seguimiento de ellos a través de ramas y fusionarlos cuando estoy satisfecho (también tenía otras ramas que no conducían a ninguna parte y que luego fueron eliminadas). También puedo "etiquetar" confirmaciones si significan algo (por ejemplo, envíos iniciales a revistas/envíos revisados/etc.). Aquí lo he etiquetado como "versión 1", que es donde se encuentra el borrador a partir de ahora. El árbol representa el trabajo de una semana.

  

• Otra cosa útil sería realizar cambios en todo el documento (como cambiar \alphaa \betatodas partes) por sí solos. De esa manera, puedes revertir los cambios sin tener que revertir algo más junto con ellos (hay maneras de hacerlo usando git, pero bueno, si puedes evitarlo, ¿por qué no?). Lo mismo se aplica a las adiciones al preámbulo.

• Utilice un repositorio remoto y envíe sus cambios periódicamente. Con proveedores de servicios gratuitos como GitHub y Bitbucket (ambos te permiten crear repositorios privados con una cuenta gratuita), no hay razón para no usarlos si estás trabajando con Git/Mercurial. Como mínimo, considérelo como una copia de seguridad secundaria (¡espero que tenga una principal!) para sus archivos LaTeX y un servicio que le permite continuar editando desde donde lo dejó en una máquina diferente.

May 31 '2011 16:05 abcd