Getting Started/Using Project Neon to contribute to KDE (es)

From KDE TechBase
Revision as of 13:02, 10 December 2009 by Nicolas17 (talk | contribs) (→‎Using Project Neon for documentation: translate. That was a quick one...)


Getting_Started/Using_Project_Neon_to_contribute_to_KDE


El Proyecto Neon es una compilación "nightly" del último código de KDE (SVN trunk). Es una forma fácil para que los nuevos contribuidores de KDE puedan empezar sin tener que compilar todo el árbol KDE-SVN. Ademas, las dependencias se manejan y actualizan automáticamente. Ésto es apropiado para nuevos desarrolladores, traductores, diseñadores, promotores, clasificadores de bugs, etc. Éste proceso hace que los pasos detallados en esta página, incluyendo los cambios a tu .bashrc, sean innecesarios.

Sin embargo, para desarrolladores, en algún momento se hará necesario compilar algunos componentes desde SVN a medida que te involucres más en el proyecto. El script kdesvn-build es una forma fácil de compilar todo o algunas partes de KDE SVN.

Requerimientos

El proyecto Neon siempre requiere la última versión de Kubuntu. En enero del 2009, la última versión era 8.10. Las versiones anteriores de Kubuntu no están soportadas. Es posible portar el Proyecto Neon a otras distribuciones; sin embargo, actualmente no hay nadie trabajando en esto. OpenSuse provee su propia compilación de KDE trunk. Puedes encontrar instrucciones de cómo usarlo aquí.

Instalar Proyecto Neon

Para usar el Proyecto Neon, agrega el siguiente «PPA» (Archivo de Paquetes Personal; «Personal Package Archive» en inglés) a tu sources.list:

  1. Project neon nightly KDE4 build

deb http://ppa.launchpad.net/project-neon/ubuntu jaunty main

  1. el repositorio está firmado con PGP, consultar el siguiente link para ver cómo agregar la clave

https://launchpad.net/~project-neon/+archive/ppa

Después, puedes simplemente instalar el paquete «nightly» de cualquier módulo en el que deseas trabajar. Los siguientes paquetes están disponibles:

kde-nightly-kdebase
kde-nightly-kdeplasma-addons
kde-nightly-kdepim
kde-nightly-kdeedu
kde-nightly-kdenetwork
kde-nightly-kdeutils
kde-nightly-kdegraphics
kde-nightly-kdemultimedia

Puedes instalar todos los paquetes o sólo los que te interesan, dependiendo para qué los vas a usar. Por ejemplo, si quieres instalar el último KDE Workspace (plasma, kwin, etc.), instala el paquete kde-nightly-kdebase, y kde-nightly-kdeplasma-addons para plasmoids extra.

sudo aptitude install kde-nightly-kdebase kde-nightly-kdeplasma-addons

Si sólo estás interesado en desarrollo de aplicaciones en otro módulo, puede instalar simplemente el paquete del módulo.

sudo aptitude install kde-nightly-kdepim

Ese comando también instalará kdelibs, kdepimlibs, y otras dependencias. En tu sesión KDE regular (estable) puedes ejecutar la versión «nightly» de las aplicaciones usando la ruta completa en la línea de comandos.

/opt/kde-nightly/bin/kmail

Esto usará la versión correcta de las librerías en vez de usar la versión estable, por lo tanto no es necesario hacer ningún otro cambio a tu ruta de librería, etc.

En vez de usar la ruta completa al ejecutable, una alternativa es agregar lo siguiente a tu .bashrc

_STABLE_PATH=$PATH function switchtonightly {

 export PATH=/opt/kde-nightly/bin:$_STABLE_PATH

}

function switchtostable {

 export PATH=$_STABLE_PATH

}

Luego puedes correr aplicaciones «nightly» así:

  1. Ejecuta la version estable de kmail

kmail switchtonightly

  1. ejecuta la version «nightly» de kmail

kmail

  1. ejecuta la version «nightly» de knode

knode switchtostable

  1. Ejecuta la version estable de kmail

kmail

La configuración de las aplicaciones del proyecto neon que corres no tienen conflicto alguno con la configuración de tus aplicaciones regulares. Se usa .kde-neon/ en vez de .kde/.

Usando el Proyecto Neon para desarrollo

Si te estás uniendo a uno de los equipos de desarrollo de KDE, necesitarás un svn checkout verdadero para poder contribuir tu código de vuelta al proyecto, y crear parches fácilmente.

Se proveen algunas herramientas extra para éste propósito (como neonmake) en el paquete amarok-nightly-tools. Los paquetes incluyen encabezados de desarrollo y símbolos de depuración por defecto.

sudo aptitude install amarok-nightly-tools

Si ya estás usando un paquete «nightly» del módulo que quieres desarrollar, debes desinstalarlo, y hacer «checkout» de la versión de desarrollo. Por ejemplo:

  1. Desinstala el paquete de la versión nightly

sudo aptitude purge kde-nightly-kdepim

  1. Agrega abajo el repositorio fuente del Proyecto Neon a sources.list

deb-src http://ppa.launchpad.net/project-neon/ppa/ubuntu jaunty main

  1. Instala las dependencias para compilar kdepim

sudo apt-get build-dep kde-nightly-kdepim cd ~

  1. Quizás prefieras hacer el desarrollo en una carpeta diferente.

cd Development

  1. Descarga la última versión del módulo kdepim.

svn co svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepim cd kdepim

  1. Atajo provisto por el Proyecto Neon para compilar el módulo
  2. e instalarlo en el prefijo /opt/kde-nightly/

sudo neonmake

Normalmente deberías hacer «checkout» de un módulo de KDE, no de una aplicación. La mayoría de los módulos contienen librerías compartidas que se necesitan para compilar las aplicaciones dentro del módulo.

También interesante es el comando neonmake. Este es un atajo que temporalmente configura algunas variables de entorno como LD_LIBRARY_PATH, el prefijo de instalación, etc. y luego ejecuta el equivalente de cmake && make && make install. También ejecuta rpath para configurar el ejecutable para que use las librerías que acabas de compilar.

Usando el Proyecto Neon para traducción

Los paquetes del Proyecto Neon incluyen el idioma inglés solamente. Los paquetes traducidos no están disponibles. Sin embargo, si estás traduciendo aplicaciones KDE, puedes instalar las traducciones desde el SVN de KDE.

cd ~ cd Translations

  1. La opción -N hace checkout sólo del directorio de primer nivel desde SVN.

svn co -N svn://anonsvn.kde.org/home/kde/trunk/l10n-kde4 cd l10n-kde4

  1. scripts necesarios para compilar traducciones

svn up scripts

  1. descargar las traducciones de español

svn up es

  1. generar los archivos de compilacion para el paquete de idioma español

./scripts/autogen.sh es cd es neonmake

Después de compilar las traducciones, es posible cambiar el idioma en las preferencias del sistema, o correr aplicaciones en otro idioma usando la variable de entorno KDE_LANG.

switchtonightly KDE_LANG=es kmail switchtostable

Usando el Proyecto Neon para documentación

Los paquetes fuente del proyecto neon incluyen la documentación de usuario oficial en inglés.

TODO: Cómo armar los docs de usuario desde svn.

Using Project Neon for promotion

If you are creating screenshots or screencasts of the latest version of KDE, project Neon is a simple and fast way of getting a default KDE4 session.

The KDE Promotion team recommends using the default background, theme, icons etc when preparing official promotional materials (unless the feature you are showing is related to configuring KDE artwork). Project Neon uses the default artwork that comes with KDE4, so it is useful for creating promo materials.

Here is a shortcut to get all available modules from the PPA:

sudo aptitude install kde-nightly-kdebase kde-nightly-kdeplasma-addons \ kde-nightly-kdepim kde-nightly-kdeedu kde-nightly-kdenetwork \ kde-nightly-kdeutils kde-nightly-kdegraphics kde-nightly-kdemultimedia

The application screenie is provided in Kubuntu 8.10 as screenie-qt.

sudo aptitude install screenie-qt