Ero sivun ”Linux.fi:Merkitsemiskäytäntöjä” versioiden välillä

Linux.fista
Siirry navigaatioon Siirry hakuun
p (→‎Linkit: vinkki lisätty ulkoisten linkkien lisäyksen yhteydessä tallettaa linkki myös [https://web.archive.org/ Internet Archiveen])
 
(48 välissä olevaa versiota 10 käyttäjän tekeminä ei näytetä)
Rivi 1: Rivi 1:
Tässä wikissä pyritään noudattamaan seuraavia käytäntöjä
Tässä wikissä noudatetaan pääasiassa seuraavia käytäntöjä yhtenäisen tyylin säilyttämiseksi, luettavuuden parantamiseksi ja turhan työn estämiseksi.


==Komennot==
== Yleisiä periaatteita ==
'''Tee yhteistyötä!''' Ennen kuin teet isompia muutoksia esimerkiksi luokkarakenteeseen, keskustele asiasta jollakin keskustelusivulla tai [[Linux.fi:Kahvihuone|kahvihuoneessa]]. Mikäli mahdollista, tule myös [[Linux.fi:IRC|IRC-kanavalle]] keskustelemaan ennen suurempia muokkausoperaatioita.
 
Huomioi, että Linux.fi ei liity mitenkään Wikimedian projekteihin (Wikipedia, Wiktionary, Wikiquote, yms.), vaan on kokonaan erillinen sivusto, jolla on omat sääntönsä ja käytäntönsä. Isompien muutosten perustelu vain sillä, että niin tehdään esimerkiksi Wikipediassa, ei käy. Wikipediasta voidaan toki ottaa mallia toimiviksi havaituissa asioissa.
 
Näiden käytäntöjen tarkoitus ei ole hankaloittaa muokkaamista. Jos joku ei ole vielä tutustunut kaikkiin käytäntöihin yksityiskohtaisesti ja tekee jotain pieniä virheitä, tulee ne korjata ja ystävällisesti huomauttaa asiasta kyseiselle käyttäjälle.
 
Nämä käytännöt eivät myöskään ole aivan ehdottomia, ja niistä voidaan tarvittaessa poiketa.
 
==Yksittäisen artikkelin kohderyhmä ja tavoitteet==
Linux.fi:n artikkeleille ei ole yhtä yhteistä kohderyhmää, ja yksittäisessä artikkelissakin saattaa olla eri tasoisille ja eri tavoin ajatteleville lukijoille suunnattuja osuuksia. Näitä ei kuitenkaan tulisi sekoittaa.
 
== Tyyliseikat ==
=== Kieli ===
Wikin artikkelit ovat suomeksi. Artikkelit kirjoitetaan 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 vaikkapa 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.
 
=== 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), se voidaan laittaa varsinaisen tekstin sekaan <nowiki><tt>- ja </tt></nowiki>-tagien väliin. Esimerkki:<br>
Jos komentoa ei laiteta omalle rivilleen laatikon sisään (eli laittamalla välilyönti rivin alkuun), voidaan se laittaa varsinaisen tekstin sekaan <nowiki><tt>- ja </tt></nowiki>-tagien väliin. Tagien laittamista varten muokkaustyökaluriviltä löytyy <nowiki><tt></nowiki>-nappi> Esimerkki:<br>
Pura paketti komennolla <tt>tar xvzf paketti.tar.gz</tt> ja pidä hauskaa.
Pura paketti komennolla <tt>tar xvf paketti.tar.gz</tt> ja pidä hauskaa.
 
===Skriptit===
Jos artikkeliin liittyy esimerkiksi [[bash]]-skripti, laita se <nowiki><syntaxhighlight  lang="bash"></nowiki> ja <nowiki></syntaxhighlight></nowiki> -tagien väliin. Näitäkin varten löytyy pikanappi muokkaustyökaluriviltä. Esimerkki:
 
<syntaxhighlight lang="bash">
#!/bin/bash
echo Hei $USER
</syntaxhighlight>
Taulukko muista tuetuista kielistä löytyy lisäosan [https://www.mediawiki.org/wiki/Extension:SyntaxHighlight SyntaxHighlight-kotisivulta.]


==Kieli==
=== Luokittelu ===
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].
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]].


Artikkelin lisäksi myös otsikon (eli sivun nimen) pitää olla järkevää suomea. Esimerkiksi "Emulaattorit pääsivu" ei sellaista ole.
=== Mallineet ===
Jos koet tarpeelliseksi lisätä saman sisällön useammalle sivulle, tee siitä malline. Jos joku luokittelu on yhtenevä jonkin mallineen kanssa, laita luokkalinkki mallineeseen, niin sitäkään ei tarvitse erikseen lisätä moneen paikkaan.


==Luokittelu==
* Lista olemassaolevista [https://www.linux.fi/wiki/Linux.fi:Mallineet mallineista].
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]]....
* Luokka olemassaolevista [[:Luokka:Mallineet|Mallineista]].


==Linkit==
=== 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 wikipediaan: <nowiki>[[wikipedia:fi:Linux|Linux]]</nowiki>
* Interwiki, eli linkit Wikipediaan tai ArchWikiin: <nowiki>[[wikipedia:fi:Linux|Linux]]</nowiki>, <nowiki>[[wikipedia:en:Linux|Linux]]</nowiki> <nowiki>[[archwiki:Linux|Linux]]</nowiki>
* Ulkoiset linkit: <nowiki>[http://www.example.com/ Otsikko]</nowiki>
* Ulkoiset linkit: <nowiki>[https://www.example.com/ Otsikko]</nowiki>
* Jos linkki on omalla rivillään, lisätään rivin alkuun pallura (<nowiki>*</nowiki>-merkki)
{{Vinkki|Jos lisäät ulkoista linkkiä, hyvä tapa linkin wikiin lisäämisen ohessa on lisätä se myös  [https://web.archive.org/ Internet Archiveen], jolloin jos linkin sisältö sattuu poistumaan verkosta, se voidaan tulevaisuudessa ohjata arkistoituun tallenteeseen.}}
* Jos linkki on omalla rivillään, lisätään rivin alkuun [[wikipedia:fi:Asteriski|asteriski]] (<nowiki>*</nowiki>-merkki) tai <nowiki><li></nowiki>
* Jos artikkelin nimi pitää olla pienellä kirjaimella alkava. Lisätään rivin alkuun <nowiki>{{pienaakkonen}}</nowiki>
 
=== Ilmoituslaatikot ja huomautukset ===
{{Huomautus|Jos sivulle haluaa huomautus laatikon, se tehdään seuraavasti: <nowiki>{{Huomautus|Huomautettava teksti}}</nowiki>}}
{{Vinkki|Jos sivulle haluaa vinkki laatikon, se tehdään seuraavasti: <nowiki>{{Vinkki|Vinkin teksti}}</nowiki>}}
{{Varoitus|Jos sivulle haluaa varoitus laatikon, se tehdään seuraavasti: <nowiki>{{Varoitus|Varoituksen teksti}}</nowiki>}}
Jos sivulle haluaa komennoista kertovan ohjeen, se tehdään seuraavasti: <nowiki>{{Oikeudet}}</nowiki>
{{Oikeudet}}
Tällä mallineella annetaan vinkki tai varoitus, että ohjelma olisi hyvä suorittaa hiekkalaatikossa. Se tapahtuu seuraavasti: <nowiki>{{Hiekkalaatikko|ohjelman nimi|}}</nowiki> {{Hiekkalaatikko|Wonderwall|}}


==Kappalejako==
=== 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==
=== 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>) ja tämän jälkeen interwikillä linkki Wikipediaan tyyliin <nowiki>[[wikipedia:fi:otsikko]]</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> tai <nowiki>{{perustietoa|haettava sivu}}</nowiki>) Ja jos englannin kielisestä wikistä löyty, niin sen voi linkittää näin: <nowiki>{{Perustietoa|Linux}}</nowiki> tai <nowiki>{{Perustietoa|en:haettava sivu}}</nowiki>.


==Wiki-tyyli==
=== 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==
=== Tiedostot ===
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ä.
====Lisenssit====
Selvitä lähettämäsi teosten mahdollisesti käyttämät [[Lisensointi|lisenssit]], ja jos wikin tarjoamat [[Järjestelmäviesti:Licenses|lisenssityypit]] eivät vastaa teoksen listaamia, merkitse manuaalisesti lisenssitiedot tiedoston kuvaukseen Yhteenveto-kohtaan sekä ehdota puuttuvien lisenssien lisäämistä esim. [[Linux.fi:Kahvihuone|Kahvihuoneessa]] tai Linux.fi:n keskustelukanavalla [https://matrix.to/#/#linux.fi:linux.fi #linux.fi:linux.fi] [[Matrix]]issa sekä [[Linux.fi:IRC|#wikilinux]] IRCnetissä.
 
Teoksen koostuessa useammasta eri lisenssistä, [[Toiminnot:Tallenna|Tallenna tiedosto]]-sivulla valitse lisenssiksi Ei lisenssiä ja lisää itse lisenssit manuaalisesti Yhteenveto-kohtaan, esimerkiksi:
 
<pre>
==Lisenssi==
{{GPL}}
{{CCO}}
{{Logo}}
</pre>
 
====Logot====
Mahdollisuuksien yritä ensisijaisesti käyttää [[svg]]-vektorigrafiikkatiedostoja, logojen kanssa, mutta jos tämä ei ole mahdollista, tai värit eivät toistu oikein, bittikarttagrafiikkatiedostot kuten [[png]], [[jpg]] tai [[gif]] voivat olla soveliaampia vaihtoehtoja.
 
====Kuvakaappaukset====
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ä.
 
=== Jakelut ja ohjelmat ===
Jakeluiden kanssa pyritään käyttämään mallinetta [[Malline:Jakelu|Jakelu]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Jakelut]].
 
Ohjelmien kanssa pyritään käyttämään mallinetta [[Malline:Ohjelma|Ohjelma]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Ohjelmat]].
 
Linux yhteensopivien palvelujen kanssa pyritään käyttämään mallinetta [[Malline:Palvelu|Palvelu]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Palvelu]].
 
==== Yritykset ja yhteisöt ====
Yrityksien ja säätiöiden kanssa pyritään käyttämään mallinetta [[Malline:Yritys|Yritys]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Yritys]].
 
Yhteisöjen kanssa pyritään käyttämään mallinetta [[Malline:Yhteisö|Yhteisö]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Yhteisö]].
 
Järjestöjen kanssa pyritään käyttämään mallinetta [[Malline:Järjestö|Järjestö]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Järjestö]].
 
==== Muut ====
Ytimien kanssa pyritään käyttämään mallinetta [[Malline:Ydin|Ydin]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Ydin]].
 
Ohjelmointikielien kanssa pyritään käyttämään mallinetta [[Malline:Ohjelmointikieli|Ohjelmointikieli]].  


== Jakelut ja ohjelmat ==
Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Ohjelmointikieli]].
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)==
=== 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 (eng. ''package'') <tt>gcc</tt> valitsemalla ''Sovellukset'' - ''Lisää/Poista sovelluksia''."
"Asenna paketti (engl. ''package'') <tt>gcc</tt> valitsemalla ''Sovellukset'' - ''Lisää/Poista sovelluksia''."


==Yhteenveto==
=== 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]]

Nykyinen versio 8. heinäkuuta 2023 kello 12.07

Tässä wikissä noudatetaan pääasiassa seuraavia käytäntöjä yhtenäisen tyylin säilyttämiseksi, luettavuuden parantamiseksi ja turhan työn estämiseksi.

Yleisiä periaatteita[muokkaa]

Tee yhteistyötä! Ennen kuin teet isompia muutoksia esimerkiksi luokkarakenteeseen, keskustele asiasta jollakin keskustelusivulla tai kahvihuoneessa. Mikäli mahdollista, tule myös IRC-kanavalle keskustelemaan ennen suurempia muokkausoperaatioita.

Huomioi, että Linux.fi ei liity mitenkään Wikimedian projekteihin (Wikipedia, Wiktionary, Wikiquote, yms.), vaan on kokonaan erillinen sivusto, jolla on omat sääntönsä ja käytäntönsä. Isompien muutosten perustelu vain sillä, että niin tehdään esimerkiksi Wikipediassa, ei käy. Wikipediasta voidaan toki ottaa mallia toimiviksi havaituissa asioissa.

Näiden käytäntöjen tarkoitus ei ole hankaloittaa muokkaamista. Jos joku ei ole vielä tutustunut kaikkiin käytäntöihin yksityiskohtaisesti ja tekee jotain pieniä virheitä, tulee ne korjata ja ystävällisesti huomauttaa asiasta kyseiselle käyttäjälle.

Nämä käytännöt eivät myöskään ole aivan ehdottomia, ja niistä voidaan tarvittaessa poiketa.

Yksittäisen artikkelin kohderyhmä ja tavoitteet[muokkaa]

Linux.fi:n artikkeleille ei ole yhtä yhteistä kohderyhmää, ja yksittäisessä artikkelissakin saattaa olla eri tasoisille ja eri tavoin ajatteleville lukijoille suunnattuja osuuksia. Näitä ei kuitenkaan tulisi sekoittaa.

Tyyliseikat[muokkaa]

Kieli[muokkaa]

Wikin artikkelit ovat suomeksi. Artikkelit kirjoitetaan 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 vaikkapa lokalisointi.orgin sanakirjasta.

Artikkelin lisäksi myös otsikon (eli sivun nimen) pitää olla järkevää suomea. Esimerkiksi "Emulaattorit pääsivu" ei sellaista ole.

Komennot[muokkaa]

Yleensä selitys ennen komentoa, eli tähän tyyliin:
Tar.gz-paketti puretaan komennolla

tar xvzf paketti.tar.gz

Jos komentoa ei laiteta omalle rivilleen laatikon sisään (eli laittamalla välilyönti rivin alkuun), voidaan se laittaa varsinaisen tekstin sekaan <tt>- ja </tt>-tagien väliin. Tagien laittamista varten muokkaustyökaluriviltä löytyy <tt>-nappi> Esimerkki:
Pura paketti komennolla tar xvf paketti.tar.gz ja pidä hauskaa.

Skriptit[muokkaa]

Jos artikkeliin liittyy esimerkiksi bash-skripti, laita se <syntaxhighlight lang="bash"> ja </syntaxhighlight> -tagien väliin. Näitäkin varten löytyy pikanappi muokkaustyökaluriviltä. Esimerkki:

#!/bin/bash
echo Hei $USER

Taulukko muista tuetuista kielistä löytyy lisäosan SyntaxHighlight-kotisivulta.

Luokittelu[muokkaa]

Olemassa olevat luokat luokkasivulta. Luokitus helpottaa asioiden löytämistä. Lisää artikkeli vain luokkahierarkian syvimmällä olevaan luokkaan: KDE-ohjelma kuuluu KDE-ohjelmat-luokkaan, ja se on turha lisätä erikseen Ohjelmat-luokkaan.

Mallineet[muokkaa]

Jos koet tarpeelliseksi lisätä saman sisällön useammalle sivulle, tee siitä malline. Jos joku luokittelu on yhtenevä jonkin mallineen kanssa, laita luokkalinkki mallineeseen, niin sitäkään ei tarvitse erikseen lisätä moneen paikkaan.

Linkit[muokkaa]

  • Wikin sisäinen linkki [[näin]] esim. [[Screen]]in, jos tarvitsee taivuttaa tai muuten käyttää eri asua, niin [[kohde|otsikko]] esim. [[Lähdekoodi|Lähdekoodeja]]
  • Linkki luokkasivulle: [[:Luokka:Luokannimi|Luokan sivulle]]
  • Interwiki, eli linkit Wikipediaan tai ArchWikiin: [[wikipedia:fi:Linux|Linux]], [[wikipedia:en:Linux|Linux]] [[archwiki:Linux|Linux]]
  • Ulkoiset linkit: [https://www.example.com/ Otsikko]
Vinkki: Jos lisäät ulkoista linkkiä, hyvä tapa linkin wikiin lisäämisen ohessa on lisätä se myös Internet Archiveen, jolloin jos linkin sisältö sattuu poistumaan verkosta, se voidaan tulevaisuudessa ohjata arkistoituun tallenteeseen.
  • Jos linkki on omalla rivillään, lisätään rivin alkuun asteriski (*-merkki) tai <li>
  • Jos artikkelin nimi pitää olla pienellä kirjaimella alkava. Lisätään rivin alkuun {{pienaakkonen}}

Ilmoituslaatikot ja huomautukset[muokkaa]

Huomautus: Jos sivulle haluaa huomautus laatikon, se tehdään seuraavasti: {{Huomautus|Huomautettava teksti}}
Vinkki: Jos sivulle haluaa vinkki laatikon, se tehdään seuraavasti: {{Vinkki|Vinkin teksti}}


Varoitus!!! Jos sivulle haluaa varoitus laatikon, se tehdään seuraavasti: {{Varoitus|Varoituksen teksti}}


Jos sivulle haluaa komennoista kertovan ohjeen, se tehdään seuraavasti: {{Oikeudet}}

Komennot, jotka alkavat $-merkillä suoritetaan tavallisena käyttäjänä ja komennot, jotka alkavat #-merkillä suoritetaan pääkäyttäjänä. Katso myös su, sudo ja doas.

Tällä mallineella annetaan vinkki tai varoitus, että ohjelma olisi hyvä suorittaa hiekkalaatikossa. Se tapahtuu seuraavasti: {{Hiekkalaatikko|ohjelman nimi|}}

Vinkki: Jos Wonderwall ohjelmistoa on välttämättä pakko käyttää, on suositeltavaa sen eristäminen muusta järjestelmästä suorittamalla se eristetyssä hiekkalaatikossa kuten Firejail-ohjelmistossa tai virtuaalikoneessa.


Kappalejako[muokkaa]

Osuva kappalejako parantaa artikkelin luettavuutta. Isommissa artikkeleissa kannattaa usein käyttää hierarkkista kappalejakoa, jossa isoimman wikissä käytettävän otsikkotyypin (esim. ==Omaotsikko==) alla on pienempiä alaotsikoita (esim. ===Alaotsikko1===). 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[muokkaa]

Mikäli sivun sisältö ei ole mitenkään erikoista, vaan Wikipedian sisältö on riittävä, on turha forkata Wikipedian sisältöä (eikä lisenssikään sitä salli) vaan homma hoidetaan lisäämällä sivulle mallinne perustietoa (eli {{perustietoa}} tai {{perustietoa|haettava sivu}}) Ja jos englannin kielisestä wikistä löyty, niin sen voi linkittää näin: {{Perustietoa|Linux}} tai {{Perustietoa|en:haettava sivu}}.

Wiki-tyyli[muokkaa]

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 umpikujalistan tyhjentäminen, ja tyhjänä pitäminen.

Tiedostot[muokkaa]

Lisenssit[muokkaa]

Selvitä lähettämäsi teosten mahdollisesti käyttämät lisenssit, ja jos wikin tarjoamat lisenssityypit eivät vastaa teoksen listaamia, merkitse manuaalisesti lisenssitiedot tiedoston kuvaukseen Yhteenveto-kohtaan sekä ehdota puuttuvien lisenssien lisäämistä esim. Kahvihuoneessa tai Linux.fi:n keskustelukanavalla #linux.fi:linux.fi Matrixissa sekä #wikilinux IRCnetissä.

Teoksen koostuessa useammasta eri lisenssistä, Tallenna tiedosto-sivulla valitse lisenssiksi Ei lisenssiä ja lisää itse lisenssit manuaalisesti Yhteenveto-kohtaan, esimerkiksi:

==Lisenssi==
{{GPL}}
{{CCO}}
{{Logo}}

Logot[muokkaa]

Mahdollisuuksien yritä ensisijaisesti käyttää svg-vektorigrafiikkatiedostoja, logojen kanssa, mutta jos tämä ei ole mahdollista, tai värit eivät toistu oikein, bittikarttagrafiikkatiedostot kuten png, jpg tai gif voivat olla soveliaampia vaihtoehtoja.

Kuvakaappaukset[muokkaa]

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ä.

Jakelut ja ohjelmat[muokkaa]

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.

Linux yhteensopivien palvelujen kanssa pyritään käyttämään mallinetta Palvelu. Lisätietoja sivulla Linux.fi:Merkitsemiskäytäntöjä/Palvelu.

Yritykset ja yhteisöt[muokkaa]

Yrityksien ja säätiöiden kanssa pyritään käyttämään mallinetta Yritys. Lisätietoja sivulla Linux.fi:Merkitsemiskäytäntöjä/Yritys.

Yhteisöjen kanssa pyritään käyttämään mallinetta Yhteisö. Lisätietoja sivulla Linux.fi:Merkitsemiskäytäntöjä/Yhteisö.

Järjestöjen kanssa pyritään käyttämään mallinetta Järjestö. Lisätietoja sivulla Linux.fi:Merkitsemiskäytäntöjä/Järjestö.

Muut[muokkaa]

Ytimien kanssa pyritään käyttämään mallinetta Ydin. Lisätietoja sivulla Linux.fi:Merkitsemiskäytäntöjä/Ydin.

Ohjelmointikielien kanssa pyritään käyttämään mallinetta Ohjelmointikieli.

Lisätietoja sivulla Linux.fi:Merkitsemiskäytäntöjä/Ohjelmointikieli.


Ohjelmia EI pidä laittaa luokkaan Ohjelmat vaan johonkin kuvaavampaan alaluokkaan.

Muotoilu (<tt> ja kursivointi)[muokkaa]

Yleisesti ottaen ohjelmapakettien nimet, tiedostonimet ja komennot (tekstin seassa) merkitään <tt> ja </tt>-tagien väliin. Kursiivilla (''kursivointi'') merkitään valikkotekstit ja käännökset, esimerkiksi:
"Asenna paketti (engl. package) gcc valitsemalla Sovellukset - Lisää/Poista sovelluksia."

Yhteenveto[muokkaa]

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.