Obtención del código fuente con Git

1.  Introducción

Git permite que varias personas trabajen a la vez en el desarrollo de código. Puedes obtener mucha más información en Git y descargar el código de su página web.

Para conocer su uso detallado con LyX (o si quieres iniciar trabajo con el código) puedes echar un vistazo a nuestras páginas wiki.

Aún quedan unos pocos módulos activos que usan el antiguo SVN, puedes verlo aquí.

2.  Repositorio Git de LyX

lyxgit
Este repositorio aloja el código fuente de LyX. El desarrollo de la próxima versión importante de LyX tiene lugar en la rama master y las versiones de menor nivel (de mantenimiento) tienen lugar en ramas como 2.0.2. La próxima versión estable reside en la rama más reciente 2.0.x. Siguiendo antiguos hábitos, a veces denominamos a la rama master trunk y a la rama de mantenimiento simplemente branch.

Para seleccionar la rama que desees explorar debes usar el menú desplegable "Visitar".

3.  Navegador de código Trac

Usando Git puedes descargar un repositorio completo con un solo comando. Si quieres mirar sólo un archivo Git considera el uso del navegador de código Trac. Trac es una herramienta que permite, entre otras cosas, explorar un repositorio Git y da la posibilidad de explorar archivos de diferencias entre versiones arbitrarias, leer registros y demás.

El navegador de código Trac para el repositorio Git de LyX (y el anterior SVN) está en la página de inicio de de LyX. Sin embargo, lo más probable es que quieras descargar un repositorio Git. En ese caso, lee lo que sigue.

4.  Clon anónimo de Git

Desde el directorio en el que quieras alojar localmente tu copia del código fuente, ejecuta:

 git clone git://git.lyx.org/lyx

Así se crea un directorio lyx y se descargarán muchos archivos en él. (Una copia nueva ocupará unos 300 MB. Sin embargo, hará falta mucho más espacio para la versión compilada, hasta 1 GB).

Puedes cambiar a la rama de mantenimiento mediante git checkout 2.0.x dentro del directorio lyx.

5.  Después de la primera descarga

Si el código está actualizado, ve con cd al directorio lyx y ejecuta:

 git pull

Así, por arte de magia, se descargarán o parchearán solo aquellos archivos que hayan cambiado o sido añadidos, ahorrandote así mucho tiempo (y al servidor).

Si deseas comprobar qué ha cambiado en tu copia local en relación al repositorio, ejecuta:

 git status

6.  Compilación del código fuente

Si quieres compilar y ejecutar la versión en desarrollo, las cosas son algo más complicadas que en el caso de las descargas de versiones ya compiladas, porque se necesitan programas adicionales como automake, autoconf y gettext.

En Linux solo hay que seguir las instrucciones en INSTALL (esto es más o menos como el habitual ./autogen.sh, ./configure, make, y make install).

Alternativamente, consulta las instrucciones en INSTALL.Win32/MacOSX.


7.  Modificación de fuentes

Apoyamos firmemente cualquier impulso creativo por tu parte. Analizaremos cuidadosamente las correcciones de errores, los aportes a la documentación y nuevas características, y generalmente las aceptaremos salvo pocas excepciones. Las características nuevas casi nunca son aceptadas para la versión estable publicada.

Si deseas contribuir cambios, lo más fácil para todos es cambiar las últimas fuentes en Git mejor que en la última publicación de LyX. He aquí un breve resumen de lo que has de hacer:

  • Obtén la versión más reciente del código con git pull. Un parche a fuentes antiguas será mucho más difícil de aplicar y por lo tanto, más propenso a ser ignorado.
  • Cambia los archivos.
  • Ejecuta git diff > mypatch.diff para crear un parche.
  • Envía el parche a la Lista de correo de desarrolladores de LyX.

8.  Acceso de escritura mediante ssh

Si te encuentras en situación de escribir muchos parches que el equipo LyX incorpora en el código, se te puede conceder acceso a Git. Esto hará más fácil tu tarea. Información detallada en wiki.

El contenido no wiki del sitio web de LyX (por ejemplo, las noticias o los anuncios) y los diccionarios y tesauros todavía están en Subversion.

9.  Ramas en Git

El desarrollo principal de LyX se hace en ramas Git. Si estás interesado en colaborar en el desarrollo o en las pruebas de estas ramas, puedes verificar una copia de trabajo local con un comando como estos:

 git checkout 2.0.x

o

 git checkout master

sobre el repositorio ya clonado.

Nombre de la ramaAdministrador de lanzamientoMantenedorEstadoComentario
master (trunk)VF Ravesteijn inestableRama Maestra
branch 2.1.xVF RavesteijnRG HeckestableSeries de la rama estable 2.1
branch 2.0.xP SandaRG HeckestableSeries de la rama estable 2.0

Hay además algunas ramas obsoletas:

Nombre de la ramaAdministrador de lanzamientoMantenedorEstadoComentario
BRANCH_1_6_XJMatosJSpitzmestableSeries estables 1.6
BRANCH_1_5_XJMatosJSpitzmestableSeries estables 1.5
BRANCH_1_4_XLGBjønnesJMarcestableSeries estables 1.4
BRANCH_1_3_X JMarcestableSeries estables 1.3
BRANCH-1_2_XLGBjønnesJMarcestableSeries estables 1.2
BRANCH_1_1_6 JMarcestableEstabilación de 1.1.6