Rekisteröitymätön käyttäjä
Ero sivun ”Linux.fi:Merkitsemiskäytäntöjä” versioiden välillä
Siirry navigaatioon
Siirry hakuun
Linux.fi:Merkitsemiskäytäntöjä (muokkaa)
Versio 20. toukokuuta 2014 kello 02.57
, 20. toukokuuta 2014→Jakelut ja ohjelmat
p (→Muotoilu (<nowiki><tt></nowiki> ja kursivointi): eng. -> engl.) |
|||
(8 välissä olevaa versiota 6 käyttäjän tekeminä ei näytetä) | |||
Rivi 6: | Rivi 6: | ||
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. | 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 | 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. | Nämä käytännöt eivät myöskään ole aivan ehdottomia, ja niistä voidaan tarvittaessa poiketa. | ||
Rivi 14: | Rivi 14: | ||
== Tyyliseikat == | == Tyyliseikat == | ||
=== Kieli === | === Kieli === | ||
Wikin artikkelit ovat suomeksi. Artikkelit | 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. | Artikkelin lisäksi myös otsikon (eli sivun nimen) pitää olla järkevää suomea. Esimerkiksi "Emulaattorit pääsivu" ei sellaista ole. | ||
Rivi 24: | Rivi 23: | ||
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 | 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 | Pura paketti komennolla <tt>tar xvf paketti.tar.gz</tt> ja pidä hauskaa. | ||
===Skriptit=== | |||
Jos artikkeliin liittyy esimerkiksi [[bash]]-skripti, laita se <nowiki><source lang="bash"></nowiki> ja <nowiki></source></nowiki> -tagien väliin. Näitäkin varten löytyy pikanappi muokkaustyökaluriviltä. Esimerkki: | |||
<source lang="bash"> | |||
#!/bin/bash | |||
echo Hei $USER | |||
</source> | |||
Taulukko muista tuetuista kielistä löytyy lisäosan [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi kotisivulta.] | |||
=== Luokittelu === | === Luokittelu === | ||
Rivi 31: | Rivi 39: | ||
=== Mallineet === | === Mallineet === | ||
Jos koet tarpeelliseksi lisätä saman sisällön useammalle sivulle, tee siitä malline. Jos joku luokittelu | 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 [http://linux.fi/index.php?title=Toiminnot%3AKaikki+sivut&from=&namespace=10 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 | * Interwiki, eli linkit Wikipediaan: <nowiki>[[wikipedia:fi:Linux|Linux]]</nowiki> | ||
* Ulkoiset linkit: <nowiki>[http://www.example.com/ Otsikko]</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 pallura (<nowiki>*</nowiki>-merkki) | ||
Rivi 44: | Rivi 54: | ||
=== 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> | 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>). | ||
=== Wiki-tyyli === | === Wiki-tyyli === | ||
Rivi 56: | Rivi 66: | ||
Ohjelmien kanssa pyritään käyttämään mallinetta [[Malline:Ohjelma|Ohjelma]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Ohjelmat]]. | Ohjelmien kanssa pyritään käyttämään mallinetta [[Malline:Ohjelma|Ohjelma]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Ohjelmat]]. | ||
Yrityksien kanssa pyritään käyttämään mallinetta [[Malline:Yritys|Yritys]]. Lisätietoja sivulla [[Linux.fi:Merkitsemiskäytäntöjä/Yritys]]. | |||
Ohjelmia EI pidä laittaa luokkaan [[:Luokka:Ohjelmat|Ohjelmat]] vaan johonkin kuvaavampaan alaluokkaan. | Ohjelmia EI pidä laittaa luokkaan [[:Luokka:Ohjelmat|Ohjelmat]] vaan johonkin kuvaavampaan alaluokkaan. |