Ero sivun ”Linux.fi:Merkitsemiskäytäntöjä” versioiden välillä
Siirry navigaatioon
Siirry hakuun
Linux.fi:Merkitsemiskäytäntöjä (muokkaa)
Versio 15. heinäkuuta 2022 kello 11.45
, 15. heinäkuuta 2022→Ilmoituslaatikot ja huomautukset: typo poistettu
p (Ilmoituslaatikot ja huomautukset) |
p (→Ilmoituslaatikot ja huomautukset: typo poistettu) |
||
| (21 välissä olevaa versiota 2 käyttäjän tekeminä ei näytetä) | |||
| Rivi 27: | Rivi 27: | ||
===Skriptit=== | ===Skriptit=== | ||
Jos artikkeliin liittyy esimerkiksi [[bash]]-skripti, laita se <nowiki>< | 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 | #!/bin/bash | ||
echo Hei $USER | echo Hei $USER | ||
</ | </syntaxhighlight> | ||
Taulukko muista tuetuista kielistä löytyy lisäosan [ | Taulukko muista tuetuista kielistä löytyy lisäosan [https://www.mediawiki.org/wiki/Extension:SyntaxHighlight SyntaxHighlight-kotisivulta.] | ||
=== Luokittelu === | === Luokittelu === | ||
| Rivi 41: | Rivi 41: | ||
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. | 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. | ||
Lista olemassaolevista [https://www.linux.fi/wiki/Linux.fi:Mallineet mallineista]. | * Lista olemassaolevista [https://www.linux.fi/wiki/Linux.fi:Mallineet mallineista]. | ||
* 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>[ | * Ulkoiset linkit: <nowiki>[https://www.example.com/ Otsikko]</nowiki> | ||
* Jos linkki on omalla rivillään, lisätään rivin alkuun | * 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 === | === Ilmoituslaatikot ja huomautukset === | ||
{{Huomautus|Jos sivulle haluaa huomautus laatikon, se tehdään seuraavasti | {{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 === | ||
| Rivi 62: | Rivi 69: | ||
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. | ||
=== | === 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 === | === Jakelut ja ohjelmat === | ||
| Rivi 73: | Rivi 96: | ||
==== Yritykset ja yhteisöt ==== | ==== Yritykset ja yhteisöt ==== | ||
Yrityksien kanssa pyritään käyttämään mallinetta [[Malline:Yritys|Yritys]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Yritys]]. | 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ö]]. | Yhteisöjen kanssa pyritään käyttämään mallinetta [[Malline:Yhteisö|Yhteisö]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Yhteisö]]. | ||
| Rivi 82: | Rivi 105: | ||
Ytimien kanssa pyritään käyttämään mallinetta [[Malline:Ydin|Ydin]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Ydin]]. | 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]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Ohjelmointikieli]]. | Ohjelmointikielien kanssa pyritään käyttämään mallinetta [[Malline:Ohjelmointikieli|Ohjelmointikieli]]. | ||
Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Ohjelmointikieli]]. | |||