Info Draft FLOSS Manuals suomeksi

UKK

Usein kysytyt kysymykset

Mitä on FLOSS?

FLOSS on lyhenne sanoista "Free (Libre) Open Source Software", vapaat ja avoimen lähdekoodin ohjelmat. Suomeksi käytetään usein lyhennettä VALO, vapaat ja avoimen lähdekoodin ohjelmat. Wikipediassa on lisätietoa vapaista ohjelmistoista ja avoimen lähdekoodin ohjelmistoista. Viikon VALO-projekti esittelee viikoittain uuden VALO-ohjelman. FLOSS Manuals on avoimen lähdekoodin ohjelmien dokumentaatioon ja käyttöohjeisiin keskittynyt wiki.

Mikä on FLOSS Manuals?

FLOSS Manuals on kokoelma vapaiden ja avoimen lähdekoodin ohjelmistojen käyttöohjeita. FLOSS Manuals on myös näiden käyttöohjeiden kirjoittamiseen käytetyt työkalut ja kirjoittamiseen osallistunut yhteisö. Tähän yhteisöön kuuluu teknisiä kirjoittajia, taiteilijoita, ohjelmistokehittäjiä, aktivisteja ja monia muita. Jotkin oppaat neuvovat asentamaan ja käyttämään vapaita ja avoimen lähdekoodin ohjelmia. Joissain oppaat liittyvät tiettyyn aihepiiriin, kuten tietoturvaan. Jotkin kirjat liittyvät enemmänkin avoimeen lähdekoodiin liittyvään kulttuuriin tai yhteiskunnallisiin ilmiöihin.

Kuka tahansa voi osallistua oppaan kirjoittamiseen esimerkiksi korjaamalla kirjoitusvirheen, lisäämällä selityksen, kirjoittamalla uuden luvun tai aloittamalla kokonaan uuden oppaan. Dokumentoijia, kääntäjiä, oikolukijoita, graafikoita, koodaajia ja käyttäjiä tarvitaan oppaiden kehittämiseen.

Mistä FLOSS Manuals tulee?

FLOSS Manuals Foundation on Hollannissa vuonna 2006 perustettu säätiö. Aluksi FLOSS Manuals oli englanninkielinen, myöhemmin se on kotoistettu myös hollanniksi, farsiksi, ranskaksi ja suomeksi. Suomenkielinen lokalisaatio avattiin vuonna 2009.

Kuka ylläpitää suomenkielistä FLOSS Manualsia?

Suomenkielisen FLOSS Manualsin koordinaattorina toimii Tomi Toivio (tomi@flossmanuals.net), joka toimii myös Seravon verkkotuottajana.

Voinko muokata oppaita?

Kaikki ovat tervetulleita osallistumaan. Voit rekisteröityä Kirjoita-sivulla ja muokata oppaita täysin vapaasti. FLOSS Manualsiin kaivataan vapaiden ohjelmien käyttäjiä, ohjelmoijia ja asiantuntijoita, wikiharrastajia, teknisiä kirjoittajia, lokalisoijia ja kääntäjiä, oikolukijoita, graafikkoja ja kriitikkoja.

Miten saan yhteyden FLOSS Manualsin ylläpitoon?

Yhteystiedot-sivulla on erilaisia toimivaksi todettuja yhteystietoja.

Tekemäni muutos ei näy oppaassa?

FLOSS Manualsin ylläpitäjän täytyy ensin hyväksyä tekemäsi muutos, jotta se näkyy oppaiden julkaistussa versiossa. Ota yhteyttä ylläpitoon. Huomaa, että Kirjoita-sivulla tekemäsi muutokset näkyvät heti.

Miksi kirjoittajien täytyy rekisteröityä?

FLOSS Manuals vaatii rekisteröitymistä, jolla vältetään internetin riesana olevien spämmibottien hyökkäykset. On hyvä rekisteröityä omalla nimellä, sillä tekijät kreditoidaan käyttöoppaiden tekijänoikeustiedoissa. Mutta vaatimaton ihminen voi valita myös nimimerkin, koska käytännössähän emme voi tarkastaa ihmisten oikeaa nimeä.

Voinko kopioida oppaan sivulleni?

Oppaita saa kopioida, muokata, kääntää ja jakaa eteenpäin, kunhan lisenssiä ei muuteta. On kuitenkin suositeltavaa, että käyttöoppaiden jatkokehitys tapahtuu FLOSS Manualsissa, jotta oppaisiin käytetty aika ja vaiva ei jakaudu monen eri version välille.

Mistä saan vapaat ohjelmat käyttööni?

Monet FLOSS Manualsissa dokumentoiduista ohjelmista on saatavissa Windows-käyttöjärjestelmään suomeksi lokalisoituina VALO-CD -sivustolta. Ubuntu Linux sisältää monet ohjelmista valmiiksi asennettuna tai ne on helppo asentaa Ubuntun ohjelmakirjastoista.

Mistä muualta löydän suomenkielistä dokumentaatiota?

Lisää suomenkielistä avoimen lähdekoodin dokumentaatiota on tarjolla esimerkiksi Linux.fi -wikissä, Ubuntu Suomi -sivuilla ja Wikikirjastossa.

Mitä ohjelmistoa FLOSS Manuals käyttää?

FLOSS Manualsin kirjoitusalustana toimii Booktype, joka on kehitetty juuri FLOSS Manualsin kokemusten ja tarpeiden pohjalta. Booktypessä on sosiaalisen median ominaisuuksia ja se on suunniteltu kirjojen kirjoittamiseen ja julkaisemiseen HTML-, PDF- ja ePub-muodoissa. Booktypeä voi käyttää muuhunkin kuin tekniseen kirjoittamiseen, esimerkiksi koulukirjat ovat olleet suosittu käyttökohde.

Mikä on booksprint?

Booksprint voidaan suomentaa esimerkiksi kirjapyrähdykseksi. Kyseessä on nopea tapa tuottaa teknisiä käyttöohjeita kirjoittajien intensiivisenä yhteistyönä. Joukko kirjoittajia kokoontuu yhteen muutamaksi päiväksi kirjoittamaan opasta. Tietysti kirjapyrähdys voi olla luonteeltaan myös paljon hitaampi tapahtuma tai se voidaan toteuttaa kokonaan etätyönä verkossa.

Mikä tyyliopas FLOSS Manualsissa on käytössä?

FLOSS Manualsin tapoihin ei kuulu pakottaa teknisiä kirjoittajia käyttämään tiettyä tyyliopasta. Oppaan kirjoittajien on syytä päättää tyyliseikat tai valita tyyliopas keskenään. Tekninen kirjoittaminen on melko vapaamuotoista.

Onko Suomessa kirjoitettu uusia oppaita?

OpenOffice, LibreOffice, Avoin mediatuotanto, Stellarium ja OpenShot on kirjoitettu alunperin suomeksi suomenkielisessä FLOSS Manualsissa. Ubuntu tutuksi ja Avoin Elämä on kirjoitettu toisaalla ja siirretty FLOSS Manualsiin päivityksiä varten. Osa käännetyistä oppaista on päivitetty niin monta kertaa, että ne eivät juurikaan muistuta alkuperäistä versiota.

Tarvitsen uuden oppaan!

Uusien avoimen lähdekoodin oppaiden kirjoittamiseen on käytännössä kolme vaihtoehtoa.

  1. Kirjoita-osassa voi aloittaa uuden kirjan ja kirjoittaa siihen sisältöä. Yleensä oppaan kirjoittaminen on melko työlästä, joten tähän kannattaa houkutella mukaan mahdollisimman paljon aiheesta kiinnostuneita ihmisiä.
  2. Yleensä oppaiden laatiminen vaatii huomattavasti enemmän yhteistyötä ja koordinaatiota kuin pelkän wikiartikkelin laatiminen. Nopein ja tehokkain tapa laatia opas on kirjapyrähdys. Tämä vaatii joukon aiheeseen sitoutuneita kirjoittajia ja jonkinlaisen budjetin kustannuksia varten.
  3. Oppaan voi tilata maksullisena kirjoitusprojektina Seravon kautta. Tällöin opas voidaan kirjoittaa maksullisena tilaustyönä ja julkaista avoimen lähdekoodin periaatteiden mukaisesti avoimella lisenssillä.

Aivan ensimmäiseksi kannattaa kuitenkin ottaa yhteyttä ylläpitoon.

Tarvitsen suomennoksen oppaasta!

Muilla kielillä on monia oppaita, joita ei ole vielä suomennettu. Suomennoksen voi yleensä toteuttaa kahdella eri tavalla.

  1. Kirjoita-osaan voi tuoda toisella kielellä olevan FLOSS Manualsin oppaan ja alkaa kääntämään sitä. Yleensä oppaan kääntäminen on melko työlästä, joten tähän kannattaa houkutella mukaan mahdollisimman paljon aiheesta kiinnostuneita ihmisiä.
  2. Suomennoksen voi tilata maksullisena käännösprojektina Seravon kautta. Tällöin opas voidaan suomentaa maksullisena tilaustyönä ja julkaista avoimen lähdekoodin periaatteiden mukaisesti avoimella lisenssillä.

Aluksi kannattaa kuitenkin ottaa yhteyttä ylläpitoon.

Oppaassa on kirjoitusvirhe tai se ei ole ajan tasalla!

Kirjoita-osassa voi vapaasti korjata erilaisia kirjoitusvirheitä, päivittää oppaita ohjelmien nykyisiin versioihin tai lisätä oppaisiin tarpeellista lisätietoa.

Oppaan kuvankaappauksia ei ole suomennettu!

Valitettavasti kaikkia avoimen lähdekoodin ohjelmia ei ole vielä suomennettu kokonaan. Ohjelmien lokalisaatioprojekteihin osallistuminen esimerkiksi Launchpadissa tai Translatewikissä on hyvä tapa tukea avoimen lähdekoodin käyttöä Suomessa.

Mistä saan FLOSS Manualsin lähdekoodin?

FLOSS Manualsin Booktypen, Bookipublisherin ja Objavin lähdekoodit löytyvät GitHubista. Suomenkielinen sivusto käyttää näistä hieman muunneltuja versioita, joten perusversiot voivat poiketa huomattavasti tämän sivun toiminnasta ja ulkoasusta.

Mistä saa oppaita painettuna kirjana? 

Painettuja versioita oppaista on myynnissä Lulu-kirjakaupassa. Mikäli oppaasta tarvitaan huomattavasti suurempaa painosta, kannattaa ottaa yhteyttä ylläpitoon, jotta voidaan järjestää oppaiden painatus jossain paikallisessa painossa.

Kuka toteutti suomenkielisen sivuston?

Suomalaisen lokalisaation toteutti vuosina 2009-2011 mediakultuuriyhdistys m-cult osana osallistuvan median menetelmien ja työkalujen kehittämishanke Medios-projektia. Medios-projektia tukivat Euroopan sosiaalirahasto ja Etelä-Suomen lääninhallitus.

Millä lisenssillä oppaat on lisensoitu? 

Yleisin lisenssi on GNU General Public License version 2. Erilaiset Creative Commons -lisenssit ovat myös yleisiä.