View source for Getting Started/Using Project Neon to contribute to KDE (fi)



[https://edge.launchpad.net/project-neon Projekti Neon] on &ouml;inen k&auml;&auml;nn&ouml;s viimeisimm&auml;st&auml; KDE:n versionhallinnan trunk-haarasta. Se on helppo tapa KDE:n uusille mukaantulijoille p&auml;&auml;st&auml; alkuun ilman, ett&auml; tarvitsee k&auml;&auml;nt&auml;&auml; koko KDE-SVN-puuta ja yll&auml;pit&auml;&auml; versiohallinasta noudettua koodia. Sen lis&auml;ksi riippuvuudet k&auml;sitell&auml;&auml;n automaattisesti ja p&auml;ivitet&auml;&auml;n. T&auml;m&auml; on sopiva uusille kehitt&auml;jille, paikallistajille, k&auml;ytett&auml;vyyssuunnittelijoille, dokumentoijille, promoottoreille, virheiden prioriteettien m&auml;&auml;rittelij&ouml;ille jne. T&auml;m&auml; prosessi tekee tarpeettomaksi vaiheet, jotka on kuvattu yksityiskohtaisesti [[Getting_Started/Build/KDE4|t&auml;ll&auml; sivulla]], mukaanlukien muutokset  [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc_(fi)|.bashrc-tiedostoosi]].

Kehitt&auml;jille saattaa jossain vaiheessa tulla v&auml;ltt&auml;m&auml;tt&ouml;m&auml;ksi k&auml;&auml;nt&auml;&auml; lis&auml;&auml; komponentteja SVN:st&auml; kun osallistut syv&auml;llisemmin projektiin. Skripti [[Getting_Started/Build/kdesvn-build|kdesvn-build]] on helppo tapa k&auml;&auml;nt&auml;&auml; kaikki tai osat KDE SVN:st&auml;.

== Vaatimukset ==

Projekti neon vaatii aina viimeisimm&auml;n stabiilin Kubuntu-julkaisun. T&auml;t&auml; kirjoitettaessa tammikuussa 2009 se on versio 8.10. Aikaisempia Kubuntu-versioita ei tueta. On mahdollista siirt&auml;&auml; Projekti Neon muihin linux-levitysversioihin, vaikka t&auml;ll&auml; hetkell&auml; ei ole yht&auml;&auml;n yll&auml;pit&auml;j&auml;&auml; muille jakeluversioille ty&ouml;skentelem&auml;ss&auml; projektissa. OpenSuse tarjoaa heid&auml;n oman viikottaisen k&auml;&auml;nn&ouml;ksen KDE:n versionhallinnan trunk-haarasta. L&ouml;yd&auml;t ohjeet sen k&auml;ytt&auml;misest&auml; [[Getting Started/Using OpenSuse KDE unstable packages for development|t&auml;&auml;lt&auml;]].

== Projekti Neon -asennus ==

Projekti Neonin k&auml;ytt&auml;miseksi lis&auml;&auml; seuraava PPA (Personal Package Archive) sources.list-tiedostoosi k&auml;ytt&auml;en parhaana pidetty&auml; tapaa:

<syntaxhighlight lang="bash">
# Projekti neonin öinen KDE4-käännös
deb http://ppa.launchpad.net/project-neon/ubuntu jaunty main

# yllä mainittu repository on allekirjoitettu PGP:llä, 
# PGP-avaimen saamiseksi viitataan alla olevaan linkkiin
https://launchpad.net/~project-neon/+archive/ppa
</syntaxhighlight>

Sen j&auml;lkeen voit yksinkertaisesti asentaa &ouml;isen pakkauksen mille tahansa moduulille, jonka kanssa haluat ty&ouml;skennell&auml;. Seuraavat pakkaukset ovat saatavilla:

 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

Voit asentaa  kaikki pakkaukset tai vain sen josta olet kiinnostunut, riippuen siit&auml; mihin haluat k&auml;ytt&auml;&auml; niit&auml;. Jos esimerkiksi haluat asentaa viimeisimm&auml;n KDE-ty&ouml;tilan (plasma, kwin jne), asenna kde-nightly-kdebase-pakkaus ja kde-nightly-kdeplasma-addons-pakkaus erikoisplasmoideille.

<syntaxhighlight lang="bash">
sudo aptitude install kde-nightly-kdebase kde-nightly-kdeplasma-addons
</syntaxhighlight>

Jos olet kiinnostunut vain sovelluskehityksest&auml; toisessa moduulissa, voit asentaa vain moduuli-pakkauksen.

<syntaxhighlight lang="bash">
sudo aptitude install kde-nightly-kdepim
</syntaxhighlight>

Tuo komento asentaa my&ouml;s kdelibs, kdepimlibs ja muut riippuvuudet. S&auml;&auml;nn&ouml;nmukaisessa (stabiilissa) kde-sessiossa voit sitten suorittaa valitsemasi sovelluksen &ouml;isen version k&auml;ytt&auml;m&auml;ll&auml; t&auml;ytt&auml; polkua komentorivilt&auml;.

<syntaxhighlight lang="bash">
/opt/kde-nightly/bin/kmail
</syntaxhighlight>

T&auml;m&auml; k&auml;ytt&auml;&auml; oikein &ouml;isen version kirjastoa sen sijaan ett&auml; k&auml;ytt&auml;isi stabiilia versioita, joten mitk&auml;&auml;n muut muutokset eiv&auml;t ole v&auml;ltt&auml;m&auml;tt&ouml;mi&auml; kirjastopolussasi jne.

Vaihtoehtoisesti sen sijaan ett&auml; k&auml;ytt&auml;isi suoritettavan tiedoston koko polkua, voit lis&auml;t&auml; seuraavan .bashrc-tiedostoosi

<syntaxhighlight lang="bash">
_STABLE_PATH=$PATH
function switchtonightly {
  export PATH=/opt/kde-nightly/bin:$_STABLE_PATH
}

function switchtostable {
  export PATH=$_STABLE_PATH
}
</syntaxhighlight>

T&auml;m&auml; sallii sinun valinnaisesti suorittaa ei-stabiileja sovelluksia sellaisenaan istunnossasi.

<syntaxhighlight lang="bash">
# suorittaa kmail-ohjelman stabiilin version
kmail
switchtonightly
# suorittaa kmail-ohjelman öisen version
kmail
# suorittaa knode-ohjelman öisen version
knode
switchtostable
# suorittaa kmail-ohjelman stabiilin version
kmail
</syntaxhighlight>

Huomaa ett&auml; asetukset sovelluksille, joita suoritat projektista neon, eiv&auml;t ole ristiriidassa tavallisten sovellustesi asetusten ja datan kanssa.
<tt>.kde-neon/</tt> k&auml;ytet&auml;&auml;n eik&auml; <tt>.kde/</tt>

== Projekti Neonin k&auml;ytt&auml;minen kehitt&auml;miseen ==

Jos olet liittynyt yhteen KDE:n kehitystiimeist&auml;, tarvitset oikean svn-haun, jotta voit olla osallisena koodin toimittamisessa projektiin ja jotta voit luoda korjauksia helposti.

Joitakin lis&auml;ty&ouml;kaluja (neonmake) tarjotaan t&auml;h&auml;n tarkoitukseen pakkauksessa amarok-nightly-tools. Pakkaukseen on k&auml;&auml;nnetty mukaan kehitys-headers-tiedostot ja virheenj&auml;ljityssymbolit.

<syntaxhighlight lang="bash">
sudo aptitude install amarok-nightly-tools
</syntaxhighlight>

Jos k&auml;yt&auml;t jo &ouml;ist&auml; versiota moduulista, jota haluat kehitt&auml;&auml;, sinun pit&auml;isi poistaa se ja hakea versionhallinnasta kehitysversio. 
Esimerkiksi:

<syntaxhighlight lang="bash">
# Poista pakattu öinen versio
sudo aptitude purge kde-nightly-kdepim

# Lisää alle Projekti Neonin lähdekoodirepository tiedostoon sources.list
deb-src http://ppa.launchpad.net/project-neon/ppa/ubuntu jaunty main

# Hae riippuvuudet kdepim-ohjelman kääntämiseksi
sudo apt-get build-dep kde-nightly-kdepim
cd ~
# Voit valita kehityksen tekemisen eri kansioon.
cd Development
# Hakee viimeisimm&auml;n kdepim-moduulin version.
svn co svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepim
cd kdepim
# Projekti Neonin tarjoama oikotie moduulin kääntämiseen
# asenna se etuliitteeseen /opt/kde-nightly/
sudo neonmake
</syntaxhighlight>

Huomaa, ett&auml; sinun pit&auml;isi hakea moduuli kde:n versionhallinnasta, ei sovellusta. Useimmat moduulit sis&auml;lt&auml;v&auml;t kirjastoja, joita moduuli yhteisk&auml;ytt&auml;&auml; ja jotka ovat v&auml;ltt&auml;m&auml;tt&ouml;mi&auml; moduulissa olevien sovellusten k&auml;&auml;nt&auml;miseksi.

Huomattavaa on my&ouml;s neonmake-komento. Se on oikopolku, jolla tilap&auml;isesti asetetaan joitakin ymp&auml;rist&ouml;muuttujia kuten LD_LIBRARY_PATH, asennusetuliite jne, sitten se suorittaa vastaavan <tt>cmake && make && make install</tt>. Se my&ouml;s suorittaa rpath konfiguroidakseen suoritettavan tiedoston k&auml;ytt&auml;m&auml;&auml;n &ouml;isi&auml; kirjastoja.

== Projekti Neonin k&auml;ytt&auml;minen paikallistamiseen ==

Projekti Neonin &ouml;inen pakkaus sis&auml;lt&auml;&auml; vain englanninkieliset merkkijonot. Paikallistetut pakkaukset eiv&auml;t ole saatavilla. Jos kuitenkin suomennat KDE-sovelluksia, voit asentaa suomennoksen KDE SVN:st&auml; normaalissa ty&ouml;nkulussa.

<syntaxhighlight lang="bash">
cd ~
cd Translations
# Kytkin -N hakee vain ylimmän tason hakemiston svn-versionhallinnasta.
svn co -N svn://anonsvn.kde.org/home/kde/trunk/l10n-kde4
cd l10n-kde4
# suomennosten kääntämiseen välttämätön skripti
svn up scripts
# Hae suomenkielinen versio
svn up fi
# Luo käännöstiedostot suomenkieliseen kielipakettiin
./scripts/autogen.sh fi
cd fi
neonmake
</syntaxhighlight>

Suomennosten k&auml;&auml;nt&auml;misen j&auml;lkeen on mahdollista joko muuttaa kielen j&auml;rjestelm&auml;asetuksia tai suorittaa sovellus toisella kielell&auml; k&auml;ytt&auml;en ymp&auml;rist&ouml;muuttujaa KDE_LANG.

<syntaxhighlight lang="bash">
switchtonightly
KDE_LANG=fi kmail
switchtostable
</syntaxhighlight>

== Projekti Neonin k&auml;ytt&auml;minen dokumentointiin ==

Projekti Neonin &ouml;iset l&auml;hdepakkaukset sis&auml;lt&auml;v&auml;t virallisen KDE k&auml;ytt&auml;j&auml;dokumentaation englannin kielell&auml;.

TODO: Kuinka k&auml;&auml;nt&auml;&auml; k&auml;ytt&auml;j&auml;dokumentit svn-versionhallinnasta.

== Projekti Neonin k&auml;ytt&auml;minen edist&auml;miseen ==

Jos luot n&auml;ytt&ouml;kaappauksia tai vastaavia viimeisimm&auml;st&auml; KDE-versiosta, projekti Neon on yksinkertainen ja nopea tapa saada oletus-KDE3-istunto.

KDE:n edist&auml;mistiimi suosittelee oletustaustan, teemojen, kuvakkeiden jne. k&auml;ytt&auml;mist&auml; kun valmistetaan virallista edist&auml;mismateriaalia (jollei ominaisuus, jota ole n&auml;ytt&auml;m&auml;ss&auml; liityy KDE-ulkoasukomponenttien konfigurointiin. Projekti Neon k&auml;ytt&auml;&auml; oletusulkoasukomponentteja sellaisena kun ne tulee KDE4:st&auml;, joten se on hy&ouml;dyllinen luotaessa edist&auml;mismateriaalia.

T&auml;ss&auml; on oikotie kaikkien saatavilla olevien moduulien saamiseksi PPA:sta:

<syntaxhighlight lang="bash">
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
</syntaxhighlight>

Sovellus [http://ariya.blogspot.com/2008/06/creating-fancy-screenshots-with.html screenie] tarjotaan Kubuntu 8.10 nimell&auml; <tt>screenie-qt</tt>.

<syntaxhighlight lang="bash">
sudo aptitude install screenie-qt
</syntaxhighlight>