Tämä sivu (ja dokumentit) on saatavilla myös seuraavilla kielillä:

tanska | hollanti | englanti | ranska | saksa | unkari | italia | japani | venäjä | espanja | perinteinen kiina

• Johdanto
• Asennusohjeet
• Järjestelmädokumentaatio
• Ylläpitodokumentaatio
• Työpöytädokumentaation kokoelma
• Kehittäjien dokumentit
• Muut dokumentit
• Yleiskatsaus kaikkeen dokumentaatioon

Tervetuloa Gentoon dokumentaatiosivuille. Täältä löydät nopean silmäyksen kaikkeen ohjeistukseen mitä tarjoamme. Suurin osa dokumenteista on lisensoitu Creative Commons - Attribution / Share Alike -lisenssillä. Kaikki dokumentit on saatavilla myös tulostettavassa muodossa. Tämän saa esille lisäämällä ?style=printable verkko-osoitteeseen.

Jos dokumenteista löytyy virheitä tai haluat ehdottaa jotain, käytä Vianseurantakjärjestelmää ja täytä englanniksi vikailmoitus, joka on liitetty kohteeseen "Docs-developer" tai "Docs-user". Nämä viat hoitaa Gentoo Documentation Project. Suomennosvirheistä voi ilmoittaa joko suoraan dokumentin vastuulliselle kääntäjälle (meilitse, irkitse...) tai merkitä vianseurantajärjestelmään ja asettaa vian komponentiksi Translated Documentationin ja URLiksi viallisen sivun (sekä vastuulliseksi flammie@g.oin jos käyttää tehokäyttäjän vianilmoitusrajapintaa, tämä ei tietenkään ole välttämätöntä).

Dokumentaatiota on saatavilla useilla kielillä. Vaikka kaikkia dokumentteja ei ehditäkään kääntää, yritämme toki parhaamme niiden ylläpitämiseksi. Jos haluat auttaa käännösprojektissa yleensä, ota yhteys Xavier Neysiin, joka vastaa käännöksistä. Suomennusapua voi tarjota foorumeilla tai meilaamalla Flammielle. Katso myös suomennusprojektin sivuilta lisää tietoa.

Kuten kaikissa suurissa projekteissa, Gentoollakin on VUKK. Ensinnäkin meillä on muutama virallinen VUKK, joita dokumentointiprojekti ylläpitää:

• Gentoo VUKK vastaa yleisiin Gentooseen liittyviin kysymyksiin. Tämä keskittyy hieman x86-alustoille.
• The Gentoo PPC VUKK vastaa kysymyksiin Gentoosta PPC-alustoilla.
• The Gentoo SPARC VUKK vastaa kysymyksiin Gentoosta SPARC-alustoilla.

Lisäksi on olemassa kattava kokoelma VUKKeja foorumeilla. VUKK-osio foorumeista on osoitteessa http://forums.gentoo.org/viewforum.php?f=40.

Gentoo Documentation Project on kasaamassa Gentoon käsikirjaa. Tällä hetkellä ensimmäiset kaksi osaa—Gentoon asentaminen ja Gentoon käyttäminen—ovat valmiita. Käsikirjan asennusohjeiden käyttäminen on suostiteltavaa ja ongelmista kannattaa lähettää vikailmoituksia (käytä Handbook-komponenttia tai käännösvirheille Translated Documentation -komponenttia).

Lisää tietoa on käsikirjan indeksisivulla.

Asennusohjeissa on hyödyllistä tietoa Gentoon asentamisesta. Tähän kuuluvat paitsi käsikirjan osio Gentoon asentaminesta, myös vanhempi, mutta vieläkin ylläpidetty, arkkitehtuurikohtainen asennusopastus, jota voi seurata asennuksen edetessä.

Gentoon käsikirjan ensimmäinen osa kertoo kuinka järjestelmä asennetaan. Jokaisessa versiossa on alustakohtaisia ohjeita.

Kokeneemmille käyttäjille on tarjolla myös pika-asennusohjeita:

• x86-pika-asennusohje
• Sparc-pika-asennusohje

Alphan käyttäjille on tarjolla myös Compaq Alpha Tools Guide, jossa selostetaan miten Gentooseen voidaan virittää Compaqin Alpha Tools.

AMD64:n omistajien kannattaa aloittaa lukemalla AMD64 Technotes, jossa kerrotaan AMD64-projektista, asennuksesta, lataamisesta ja muustakin.

Joissain tapauksissa ylläolevat asennusoppaat eivät riitä näppärään asennukseen, koska käyttöympäristöön ei voi buutata LiveCD:ltä. Tällaisia ympäristöjä varten on olemassa Alternative Installation Guide, jossa kerrotaan tapoja asentaa Gentoo muilta asennusvälineiltä (toisesta distrosta, cd:ltä, verkkokäynnistyksellä jne.).

LVM2:n käytöstä kiinnostuneille on olemassa LVM2 Guide, joka selvittää prosessin LVM2:n toimintakuntoon virittämiseksi.

Koska asennusohjeet ovat varsin joustavat, on olemassa myös paljon temppuja joita voi soveltaa asennuksen aikana. Dokumentissa Gentoo/x86 Installation Tips 'n Tricks on paitsi temppuja x86:lle, myös muutamia muille alustoille tai yleisemmin.

Oppaassa Gentoo Linux 1.4 Upgrade Guide kerrotaan Gentoo 1.x -järjestelmien päivittämisestä 1.4:n tasalle.

Gentoo Upgrading Guide menee askeleen pidemmälle ja kertoo Gentoon yleisestä (julkaisuttaisesta) päivittämisestä ja profiilijärjestelmästä.

Genkernel Guide kertoo viitteellisesti kaiken genkernelin sisältämistä funktioista.

coLinux Howton avulla pysty ajamaan Gentoota Windowsista käsin.

Gentoon järjestelmädokumenteissa kerrotaan mikä tekee Gentoosta Gentoon. Tähän sisältyy tarinaa init-järjestelmästä, Portagesta, USE-asetuksista ja niin pois päin.

Gentoon käsikirjan osassa Gentoon käyttö kerrotaan Portagesta, USE-asetuksista, Gentoon init-järjestelmästä ja ympäristömuuttujista.

Kappale Portage ja ohjelmisto Gentoon käsikirjassa kertoo lyhyesti kuinka pitää paketit ajan tasalla ja ylläpitää ohjelmistoa. Toisin sanoen se on kappale emergen käytöstä.

Gentoon käsikirjan kappale Portagen ominaisuudet luo yleiskatsauksen portagen ero toiminnalisuuksiin.

Gentoon käsikirjan kappale Portagen käytöksen ohjailu kertoo Portagen virittämisestä ympäristöön ja tarpeisiin sopivaksi.

Kappale USE-asetukset Gentoon käsikirjassa opastaa Gentoon tärkeimmän työkalun käyttöä: USE-asetuksia. Sen avulla voit selvittää mitä USE-asetuksia tarvitset. Lisäksi siinä kuvataan etcatin käyttöä pakettien lisätietojen selvittelyssä.

Gentoolkit Guide kertoo monista Portagen hyödyllisistä lisäosista.

Gentoo for Mac OS X Guide kertoo miten Portage asennetaan Mac OS X -järjestelmiin.

Kappale Ympäristömuuttujat Gentoon käsikirjassa kertoo kuinka pystyt helposti käsittelemään ympäristömuuttujia (kuten $PATH:a) ja dynaamisen linkittäjän cachea.

Kappale Initskriptit Gentoon käsikirjassa kertoo tarkemmin Gentoon käynnistysjärjestelmästä ja palveluita hoitavista skripteistä. Tavallisten initscript-juttujen lisäksi dokumentissa kerrotaan niiden riippuvuuksista ja virtuaalien käytöstä.

Kernel Guide luetteloi Gentoon tarjoamia ytimen lähdekoodeja. Useimmat näistä ovat Gentoo Kernel Projectin ylläpitämiä.

Ylläpitodokumenteissa on tutoriaaleja ja oppaita erilaisten palvelujen asentamiseen, säätämiseen ja järjestelmän ylläpitoon. Vaikka ohjeet keskittyvät Gentoon ylläpitoon, monet niistä sopivat myös muille käyttäjille.

Gentoo Security Guide kertoo kuinka lujitetaan Gentoo-järjestelmä hyökkääjien varalle. Siinä on yleistä tarinaa turvallisuudesta (palvelujen turvantamisesta, palomuurin suunnittelusta, IDS:ien käytöstä, ytimen turvallisuudesta jne.). Vieläkin tiukemman järjestelmän pystyttämisestä kerrotaan Gentoo Hardened -projektin sivuilla.

Prelinking Guide kertoo järjestelmän nopeuttamisesta prelinkkauksen avulla. Prelinkkaamalla saat suuremmat softat käynnistymään nopeammin.

IPv6 Guide näyttää mallia kuinka IPv6 Gentoossa toimii. IPv6:han on Internet-käytännön seuraava versio, joka saavuttaa hitaasti suosiotaan.

User Mode Linux Guide opastaa User-Mode Linuxin käyttöön Gentoo-järjestelmässä. User Mode Linux (UML) lisää Linuxiin mukavan ominaisuuden: Linuxin ajamista Linuxin sisällä (aina rekursiivisesti ad astra...). UMLilla saa helposti aikaan näennäisasetustoja.

OpenMosix Howto kertoo askel askeleelta miten openmosixilla saa palvelinfarmin (PC-klusterin) aikaiseksi.

Diskless Howto kertoo askeleittain kuinka Gentoosta voi tehdä levyttömiä koneita.

LTSP Guide kertoo Linux Terminal Serverin käytöstä Gentoossa.

Distcc Guide neuvoo distcc:n käyttöön käännösten jakamiseksi Gentoo-järjestelmissä.

DevFS Guide kuvailee DevFS:n toimintaa ja sen käyttöä Gentoossa.

Gentoo udev Guide kuvailee uutta laitteistonhallintajärjestelmää, joka korvaa DevFS:n. Tässä kerrotaan kuinka udev on järjestetty Gentoossa.

Printing Howto on kattava opas tulostamiseen Gentoossa.

OpenAFS Guide kertoo OpenaAFS:n, jaetun tiedostonjaon, asennuksesta.

Virtual/Mailhost Postfix Howto on opas kaikille Postfixiä käyttäville meiliylläpitäjille. Se kattaa MySQL:n näennäiskäyttäjille, webbipohjaiset meiliohjelmistot, postituslista jne.

qmail/vpopmail Howto on käytännöllinen opas qmail-pohjaisille järjestelmille. Se keskittyy etäkäyttöön ja kryptattuun tiedonsiirtoon.

Gentoo/SPARC Netboot Howto kertoo verkkokäynnistysjärjestelmän pystyttämisestä Sun Microsystems SPARC -tai UltraSPARC-pohjaisille laitteille.

Gentoo SPARC OpenBoot PROM reference Guide kertoo SPARCin OpenBoot-järjestelmästä, joka on kaikille Sun Microsytsms SPARC/UltraSparc -pohjaisille koneille.

Quick SAMBA Howto antaa kuvauksen SAMBAsta ja kertoo kuinka virustorjunta asennetaan siihen.

Home Router Howto kertoo Gentoon asettamisesta reitittimeksi pienverkoille. Täydellinen tapa saada vanha kodin nurkassa lojuva tietokone hyötykäyttöön palomuurina, reitittimenä ja niin edelleen.

Gentoo on vapaaehtoisvoimin työstetty distro. Siksi onkin tärkeää tarjota korkealaatuista kehitysdokumentaatiota, jotta kiinnostuneet voivat oppia auttamaan suosikkidistronsa kehitystä.

Kaikki kehittäjäkohtainen dokumentaatio, mukaanlukien ebuild- ja eclass-opastus, käytäntöjä ja sen sellaista, on nyt kasattu loistavaksi kehittäjän käsikirjaksi.

Gentoo Linux Documentation Policy kertoo käytännöistä dokumenttien luonnissa ja muokkauksessa.

Contributing Ebuilds Guide kertoo kuinka lähettää käyttäjän tekemiä ebuildeja.

GuideXML Guide kertoo XML-muodosta jota Gentoon web-pohjaiset dokumentit käyttävät.

Doc Developers' Tips & Tricks antaa joitain ohjeistuksia dokumenttien kehittäjille.

CVS Tutorial kertoo alkeita CVS:n (Concurrent Versioning System) käytöstä.

• Katso CVS repositorystä ebuildeja ja niiden koodeja.
• Tietoja Gentoo-projektista.
• Gentoon Yhteiskuntasopimus.
• Lisää Gentoon XML-projekteista.
• Gentoon peilaaminen: Rsync.
• Gentoon peilaaminen: Distfiles.
• Gentoo Linux -uutiset (RDF, Subscribe).

Niille, jotka haluavat yleiskatsauksen kaikkeen dokumentaatioon (vain suomennettujen dokumenttien nimet on suomennettu):