Muokataan sivua Linux.fi:Merkitsemiskäytäntöjä
Siirry navigaatioon
Siirry hakuun
Kumoaminen voidaan suorittaa. Varmista alla olevasta vertailusta, että haluat saada aikaan tämän lopputuloksen, ja sen jälkeen julkaise alla näkyvät muutokset.
Nykyinen versio | Oma tekstisi | ||
Rivi 1: | Rivi 1: | ||
Tässä wikissä | Tässä wikissä pyritään noudattamaan seuraavia käytäntöjä | ||
==Komennot== | |||
Yleensä selitys ennen komentoa, eli tähän tyyliin:<br> | Yleensä selitys ennen komentoa, eli tähän tyyliin:<br> | ||
Tar.gz-paketti puretaan komennolla | Tar.gz-paketti puretaan komennolla | ||
tar xvzf paketti.tar.gz | tar xvzf paketti.tar.gz | ||
Jos komentoa ei laiteta omalle rivilleen laatikon sisään (eli laittamalla välilyönti rivin alkuun), voidaan | Jos komentoa ei laiteta omalle rivilleen laatikon sisään (eli laittamalla välilyönti rivin alkuun), se voidaan laittaa varsinaisen tekstin sekaan <nowiki><tt>- ja </tt></nowiki>-tagien väliin. Esimerkki:<br> | ||
Pura paketti komennolla <tt>tar | Pura paketti komennolla <tt>tar xvzf paketti.tar.gz</tt> ja pidä hauskaa. | ||
== | ==Kieli== | ||
Wikin artikkelit ovat suomeksi. Artikkelit olisi syytä kirjoittaa kirjakielellä käyttäen suomenkielisiä termejä mikäli sellainen on olemassa. Englanninkielisen käännöksen kertominen on tosin joissain tapauksissa järkevää, esimerkiksi voitaisiin kirjoittaa näin: pino (''engl. stack''). Käännöksiä voi katsoa vaikka [[Sanasto|sanastosta]] tai lokalisointi.orgin [http://www.lokalisointi.org/sanakirja/ sanakirjasta]. | |||
Artikkelin lisäksi myös otsikon (eli sivun nimen) pitää olla järkevää suomea. Esimerkiksi "Emulaattorit pääsivu" ei sellaista ole.. | |||
==Luokittelu== | |||
Olemassa olevat luokat [[Luokat|luokkasivulta.]] Luokitus helpottaa asioiden löytämistä. Lisää artikkeli vain luokkahierarkian syvimmällä olevaan luokkaan: KDE-ohjelma kuuluu [[:Luokka:KDE-ohjelmat|KDE-ohjelmat]]-luokkaan, ja se on turha lisätä erikseen [[:Luokka:Ohjelmat|Ohjelmat-luokkaan]]. | Olemassa olevat luokat [[Luokat|luokkasivulta.]] Luokitus helpottaa asioiden löytämistä. Lisää artikkeli vain luokkahierarkian syvimmällä olevaan luokkaan: KDE-ohjelma kuuluu [[:Luokka:KDE-ohjelmat|KDE-ohjelmat]]-luokkaan, ja se on turha lisätä erikseen [[:Luokka:Ohjelmat|Ohjelmat-luokkaan]].... | ||
==Linkit== | |||
* Wikin sisäinen linkki <nowiki>[[näin]]</nowiki> esim. <nowiki>[[Screen]]in</nowiki>, jos tarvitsee taivuttaa tai muuten käyttää eri asua, niin <nowiki>[[kohde|otsikko]]</nowiki> esim. <nowiki>[[Lähdekoodi|Lähdekoodeja]]</nowiki> | * Wikin sisäinen linkki <nowiki>[[näin]]</nowiki> esim. <nowiki>[[Screen]]in</nowiki>, jos tarvitsee taivuttaa tai muuten käyttää eri asua, niin <nowiki>[[kohde|otsikko]]</nowiki> esim. <nowiki>[[Lähdekoodi|Lähdekoodeja]]</nowiki> | ||
* Linkki luokkasivulle: <nowiki>[[:Luokka:Luokannimi|Luokan sivulle]]</nowiki> | * Linkki luokkasivulle: <nowiki>[[:Luokka:Luokannimi|Luokan sivulle]]</nowiki> | ||
* Interwiki, eli linkit | * Interwiki, eli linkit wikipediaan: <nowiki>[[wikipedia:fi:Linux|Linux]]</nowiki> | ||
* Ulkoiset linkit: <nowiki>[ | * Ulkoiset linkit: <nowiki>[http://www.example.com/ Otsikko]</nowiki> | ||
* Jos linkki on omalla rivillään, lisätään rivin alkuun pallura (<nowiki>*</nowiki>-merkki) | |||
* Jos linkki on omalla rivillään, lisätään rivin alkuun | |||
==Kappalejako== | |||
Osuva kappalejako parantaa artikkelin luettavuutta. Isommissa artikkeleissa kannattaa usein käyttää hierarkkista kappalejakoa, jossa isoimman wikissä käytettävän otsikkotyypin (esim. <nowiki>==Omaotsikko==</nowiki>) alla on pienempiä alaotsikoita (esim. <nowiki>===Alaotsikko1===</nowiki>). Vakinaisia kappaleita ovat "Katso myös", jonka alle sijoitetaan wikin sisäisiä linkkejä ja viittauksia paikalliseen dokumentaatioon (esimerkiksi [[man]]-sivut) sekä "Aiheesta muualla", jonka alle sijoitetaan ulkoisia linkkejä. | Osuva kappalejako parantaa artikkelin luettavuutta. Isommissa artikkeleissa kannattaa usein käyttää hierarkkista kappalejakoa, jossa isoimman wikissä käytettävän otsikkotyypin (esim. <nowiki>==Omaotsikko==</nowiki>) alla on pienempiä alaotsikoita (esim. <nowiki>===Alaotsikko1===</nowiki>). Vakinaisia kappaleita ovat "Katso myös", jonka alle sijoitetaan wikin sisäisiä linkkejä ja viittauksia paikalliseen dokumentaatioon (esimerkiksi [[man]]-sivut) sekä "Aiheesta muualla", jonka alle sijoitetaan ulkoisia linkkejä. | ||
==Wikipediassa olevat artikkelit== | |||
Mikäli sivun sisältö ei ole mitenkään erikoista, vaan Wikipedian sisältö on riittävä, on turha forkata Wikipedian sisältöä (eikä [[lisenssi|lisenssikään]] sitä salli) vaan homma hoidetaan lisäämällä sivulle mallinne perustietoa (eli <nowiki>{{perustietoa}}</nowiki> | Mikäli sivun sisältö ei ole mitenkään erikoista, vaan Wikipedian sisältö on riittävä, on turha forkata Wikipedian sisältöä (eikä [[lisenssi|lisenssikään]] sitä salli) vaan homma hoidetaan lisäämällä sivulle mallinne perustietoa (eli <nowiki>{{perustietoa}}</nowiki>) ja tämän jälkeen interwikillä linkki Wikipediaan tyyliin <nowiki>[[wikipedia:fi:otsikko]]</nowiki>. | ||
==Wiki-tyyli== | |||
Pyri linkittämään artikkeleita keskenään. Tee jokaisesta termistä, josta löytyy artikkeli, wikilinkki, ja jos on uusia vaikeita juttuja, niin niistäkin. Artikkelien ei pitäisi olla umpikujia, vaan aina kuuluisi olla keino päästä muualle. Pyrkimyksenä on [[Toiminnot:Deadendpages|umpikujalistan]] tyhjentäminen, ja tyhjänä pitäminen. | Pyri linkittämään artikkeleita keskenään. Tee jokaisesta termistä, josta löytyy artikkeli, wikilinkki, ja jos on uusia vaikeita juttuja, niin niistäkin. Artikkelien ei pitäisi olla umpikujia, vaan aina kuuluisi olla keino päästä muualle. Pyrkimyksenä on [[Toiminnot:Deadendpages|umpikujalistan]] tyhjentäminen, ja tyhjänä pitäminen. | ||
== | ==Kuvat== | ||
Pyri suosimaan png-tiedostomuotoa kuvakaappauksissa, se kun on häviötön ja pakkaa varsinkin paljon tasaisia väripintoja sisältävät kuvat ihan nätisti. Poikkeuksena valokuvia sisältävät ja peleistä otetut kuvakaappaukset, niissä on monesti niin paljon värejä, että png-tiedostosta tulee järjettömän iso. Näissä tapauksissa on syytä suosia jpg:tä. | |||
Pyri suosimaan | |||
Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/ | == Jakelut ja ohjelmat == | ||
Jakeluiden kanssa pyritään käyttämään mallinetta Jakelu. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Jakelut]]. | |||
Ohjelmien kanssa pyritään käyttämään mallinetta Ohjelma. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Ohjelmat]]. | |||
Ohjelmia EI pidä laittaa luokkaan [[:Luokka:Ohjelmat|Ohjelmat]] vaan johonkin kuvaavampaan alaluokkaan. | Ohjelmia EI pidä laittaa luokkaan [[:Luokka:Ohjelmat|Ohjelmat]] vaan johonkin kuvaavampaan alaluokkaan. | ||
== Muotoilu (<nowiki><tt></nowiki> ja kursivointi)== | |||
Yleisesti ottaen ohjelmapakettien nimet, tiedostonimet ja komennot (tekstin seassa) merkitään <nowiki><tt></nowiki> ja <nowiki></tt></nowiki>-tagien väliin. Kursiivilla (<nowiki>''kursivointi''</nowiki>) merkitään valikkotekstit ja käännökset, esimerkiksi:<br> | Yleisesti ottaen ohjelmapakettien nimet, tiedostonimet ja komennot (tekstin seassa) merkitään <nowiki><tt></nowiki> ja <nowiki></tt></nowiki>-tagien väliin. Kursiivilla (<nowiki>''kursivointi''</nowiki>) merkitään valikkotekstit ja käännökset, esimerkiksi:<br> | ||
"Asenna paketti ( | "Asenna paketti (eng. ''package'') <tt>gcc</tt> valitsemalla ''Sovellukset'' - ''Lisää/Poista sovelluksia''." | ||
==Yhteenveto== | |||
Muokattaessa on kohteliasta kirjoitaa Yhteenveto-ruutuun jonkunlainen kommentti tehdyistä muutoksista. Tämä helpottaa muutosten erottamista toisistaan. Mikäli muutoksesi ei ole kovin monen merkin laajuinen, rastita "Tämä on pieni muutos" -ruutu. | Muokattaessa on kohteliasta kirjoitaa Yhteenveto-ruutuun jonkunlainen kommentti tehdyistä muutoksista. Tämä helpottaa muutosten erottamista toisistaan. Mikäli muutoksesi ei ole kovin monen merkin laajuinen, rastita "Tämä on pieni muutos" -ruutu. | ||
[[Luokka:Wiki]] | [[Luokka:Wiki]] |