====== Manejando el código fuente ======


===== Como instalar el código fuente y compilarlo con Lazarus. =====

La forma más simple es agregar un directorio ./src en el directorio del biario de cdc existente.

Descargar el archivo fuente skychart_v3_xxx_source.tar.gz a este directorio y extraer el archivo ahí. \\
En Linux, el comando es : tar xzf skychart_v3_xxx_source.tar.gz

O mejor aún, obtiene el fuente de Subversion utilizando un cliente svn. \\
El comando es: 
<code>svn co https://svn.origo.ethz.ch/skychart/trunk .</code>

Finalmente deberías tener algo parecido a esto :

<file>
cdc -|                                    < directorio base conteniendo el ejecutable 
     |- src -|                            < directorio de fuentes
             |- skychart |                < módulo skychart
                         |- component     < componente de proyecto
                         |- library       < librería de proyecto
                         |- ...
                         |- units         < todos los objetos de compilación van aquí
             |- tools | - data            < el directorio "data" es necesario para ejecutar el programa
                      | - ...             < herramientas varias, no necesariamente útiles para el usuario final
</file>

Para utilizar este código fuente, instala Lazarus utilizando la última versión 0.9.18 o superior de http://lazarus.freepascal.org

Ejecuta Lazarus y abre Components-Configure, Installed Packages.

Verifica que Printer4Lazarus, JPEGForLazarus y TurboPowerIPro están instalados, 
que es lo usual con la versión 0.9.18.
Si no están, instálalos desde lazarus/component 
<code>
      printers/printer4lazarus.lpk
      jpeg/jpegforlazarus.lpk
      turbopower_ipro/turbopoweripro.lpk
</code>

Entonces, desde el directorio src/skychart/component instala el paquete para el componente requerido:

Click en "Open Package", selecciona "component/cdccomponents.lpk", click "Compile", "Install".

Cuando el instalador pregunte si deseas reconstruir Lazarus, click en Si.

Ahora puedes abrir el proyecto principal skychart/cdc.lpi y compilar.

Para ejecutar en modo debug, ajusta Run-Run Parameters-Working Directory al directorio de CDC.

Para reducir el tamaño del ejecutable para producción, utiliza strip y upx.

Algunas librerías y plugins específicos de Windows aún no han sido portados a Lazarus,
por favor, utiliza Delphi si deseas compilarlos.

===== Convención de nombres para el código del programa =====

La siguiente convención se utiliza para el fuente del proyecto principal con el fin de permitir reconocer rápidamente el destino de una unidad.

<code>
cdc.lpi         : Proyecto principal
pu_*.pas        : Unidades de Fromularios con código específico únicamente
pu_*.lfm        : Definición de Formularios
cu_*.pas        : Unidad conteniendo objetos no visuales
u_*.pas         : Unidad con código genérico.
</code>