Aquest manual serveix com a punt d'accés únic a tota la documentació relacionada amb el projecte Debian Live i en particular s'aplica al programari produït pel projecte per la versió Debian 7.0 "wheezy". Una versió actualitzada es pot trobar sempre a ‹http://live.debian.net/›
Si bé live-manual es centra principalment en ajudar a construir un sistema viu i no en temes dels usuaris finals, un usuari final pot trobar informació útil en aquestes seccions: Conceptes bàsics abasta la preparació d'imatges per ser arrencadas des dels dispositius o la xarxa, i Personalització dels comportaments en temps d'execució descriu algunes de les opcions que es poden especificar durant l'arrencada del sistema, com ara la selecció de la disposició del teclat, la configuració regional i l'us de la persistència.
Algunes de les ordres esmentades en el text s'han d'executar amb privilegis de superusuari que es poden obtenir esdevenint l'usuari root amb su o mitjançant l'ús de sudo. Per distingir entre les ordres que poden ser executades per un usuari sense privilegis i aquelles que requereixen privilegis de root, s'anteposa $ o # respectivament. Aquest símbol no és part de l'ordre.
Si bé creiem que tot el que hi ha en aquest manual és important si més no per alguns dels nostres usuaris, ens adonem que hi ha una gran quantitat de material per cobrir i que és possible que es vulgui experimentar l'èxit amb el programari aviat, abans d'aprofundir en els detalls. Per tant, us recomanem llegir en el següent ordre.
En primer lloc, llegiu aquest capítol, Sobre aquest manual, des del principi i acabant amb els Termes. A continuació, saltar als tres tutorials abans dels Exemples secció dissenyada per ensenyar la creació de la imatge i alguns aspectes bàsics de la personalització. Llegiu en primer lloc Usant els exemples seguit per Tutorial 1: Una imatge estàndard, Tutorial 2: Una utilitat de navegador d'Internet i finalment, Tutorial 3: Una image personalitzada. Al final d'aquests tutorials, tindreu una idea del que es pot fer amb Debian Live.
Us animem a tornar i a fer un estudi del manual en profunditat, la propera lectura pot ser Conceptes bàsics, fregant o saltant Construcció d'una imatge netboot, i acabant per la lectura de la Visió de conjunt de la personalització i els capítols que la segueixen. En aquest punt, esperem que estigueu ben emocionats pel que es pot fer amb Debian Live i motivats per llegir la resta del manual, de principi a fi.
Llistat d'autors (en ordre alfabètic)
Aquest manual està pensat com un projecte comunitari i totes les propostes per millorar-lo i les contribucions són molt benvingudes. La millor forma d'enviar una contribució és enviar-la a la llista de correu. Si us plau, consulteu la secció Contacte per més informació.
Quan es presenta una contribució, si us plau, identificar clarament el titular dels drets d'autor i s'ha d'incloure la declaració de concessió de llicències. Recordar que per ser acceptada, la contribució ha de tenir una llicencia igual que la resta del document, a saber, la versió de la GPL 3 o superior.
Les fonts d'aquest manual es mantenen utilitzant el sistema de control de versions Git. Es pot obtenir còpia actualitzada mitjançant l'execució de:
$ git clone git://live.debian.net/git/live-manual.git
Abans de presentar una contribució, si us plau, previsualitzar el treball. Per previsualitzar el live-manual, assegurar-se que s'han instaŀlat els paquets necessaris per a la seva construcció mitjançant l'execució de:
# apt-get install make po4a sisu-complete libnokogiri-ruby
Es pot crear el live-manual des del directori de nivell superior del arbre Git mitjançant l'execució de:
$ make build
Com es necessita un cert temps per construir el manual en tots els idiomes suportats, potser resulti convenient quan es fa una prova construir per a un sol idioma, per exemple, mitjançant l'execució de:
$ make build LANGUAGES=en
També es possible crear per tipus de document, per exemple:
$ make build FORMATS=pdf
O combinar tot dos, per exemple:
$ make build LANGUAGES=it FORMATS=html
Qualsevol persona pot fer un commit directament al repositori. No obstant això, demanem que s'enviïn els canvis grans a la llista de correu per parlar-ne en primer lloc. Per fer un push al repositori, s'ha de seguir el següent procediment:
$ mkdir -p ~/.ssh/identity.d
$ wget http://live.debian.net/other/keys/git@live.debian.net \
-O ~/.ssh/identity.d/git@live.debian.net
$ wget http://live.debian.net/other/keys/git@live.debian.net.pub \
-O ~/.ssh/identity.d/git@live.debian.net.pub
$ chmod 0600 ~/.ssh/identity.d/git@live.debian.net*
$ cat >> ~/.ssh/config << EOF
Host live.debian.net
Hostname live.debian.net
User git
IdentityFile ~/.ssh/identity.d/git@live.debian.net
EOF
$ git clone git@live.debian.net:/live-manual.git
$ cd live-manual && git checkout debian-next
$ git commit -a -m "Adding a section on applying patches."
$ git push
Per començar la traducció d'un idioma nou, seguir aquests passos:
Nota: Es pot utilitzar make clean per netejar l'arbre git abans de fer un push. Aquest pas no és obligatori, gràcies al fitxer .gitignore, però és una bona pràctica per evitar enviar fitxers de forma involuntària.