REILUMPI KERHO ≈

Olet ladannut vanhan version dokumentista Jos tallennat tämän, tästä tulee uusin versio dokumentista.

====== Ohjeita kirjoittajille ======
===== TÄRKEÄÄ: Ota käyttöön kaksiosainen tunnistus! =====

Tällä sivustolla on käytössä kaksiosainen tunnistus, joko Google Authenticatorin tai sähköpostin kautta. Jos olet rekisteröitynyt käyttäjä, OTA TÄMÄ KÄYTTÖÖN HETI.

===== Harjoittele Playground-alueella =====

[[playground:playground|PlayGround]] on alue, jossa voi treenata vapaasti wikisyntaksia ja vaikka mitä. Se ei ainakaan hajota mitään tärkeää, mutta tietoja ei myöskään tallenneta.

===== Luo uudet artikkelit suoraan juureen, omat blogisi omaan ''kayttajat''-hakemistoosi =====

Wiki-ajatteluun kuuluu, ettei kukaan "omista" artikkeleita: kaikki käyttäjät voivat muokata niitä paremmiksi. Kokeilkaamme ainakin toistaiseksi matalaa hierarkiaa myös tiedostonhallinnassa: sen sijaan että käyttäisimme monimutkaisia kansiohierarkioita, luokaamme artikkelit mieluummin suoraan juurikansioon.

Näitä artikkeleita saa lähtökohtaisesti muokata vapaasti.

Jos haluat kuitenkin kirjoittaa "omia" artikkeleita, kuten blogeja, muistiinpanoja, some-tallenteita tai vastaavia, voit tehdä niitä käyttäjähakemistoosi (esim. ''kayttajat:jmkorhonen:artikkelin_nimi''.)

(Huomaa, että wikin sisäisissä linkeissä käytetään kaksoispistettä siinä, missä normaalisti käytettäisiin kauttaviivaa. Tiedoston nimissä on syytä välttää ääkkösiä ja erikoismerkkejä.)

Suosittelen käyttämään blogikirjoituksiin yms. päivämäärätunnistetta, mieluiten muotoa YYYY-MM-DD.

===== Huomaa, että tekstit ovat CC Attribution-Noncommercial 4.0-lisenssillä =====

Ellei toisin mainita, sisältö on jaettu CC Attribution-Noncommercial 4.0-lisenssin mukaisesti.

Lisenssin tarkat ehdot löydät [[https://creativecommons.org/licenses/by-nc/4.0/deed.fi|täältä]] tai alapalkissa näkyvästä linkistä. Lyhyesti sanoen, tekstejä saa lähtökohtaisesti jakaa ja käyttää uudelleen ei-kaupallisiin tarkoituksiin, kunhan niiden lähteen mainitsee.

Älä jaa materiaalia, joihin sinulla ei ole tekijänoikeutta!

===== Käytä valmista sivupohjaa (Templates) =====

Uudet sivut kannattaa tehdä sivupohjaa hyväksikäyttäen.

Editointinäkymän oikeassa laidassa on nappula "Insert Templates." Painamalla sitä saat auki näkymän, josta voit valita sivupohjan. Sivupohja lisää editoriin automaattisesti tärkeimmät osiot.

* ''artikkelipohja'' on tarkoitettu tavallisille artikkeleille. Voi käyttää muuhunkin.

Sivupohjat ovat tavallisia wiki-tiedostoja, joita voi muokata täällä: [[snippets|Sivupohjat.]]

===== Metadata =====

Sivupohjassa on tällä hetkellä (15.12.2023) ensimmäisenä metadata-kenttä. Se näyttää tältä:

''<nowiki>{{htmlmetatags>metatag-robots=(index,follow)</nowiki>''
(kertoo hakukoneille, että indeksoi sivu ja seuraa sitä)

''<nowiki>metatag-keywords=(avainsanat)</nowiki>'' 
(tähän voi laittaa avainsanoja artikkelista)

''<nowiki>metatag-description=(lyhyt kuvaus)</nowiki>''
(tähän lyhyen kuvauksen)

''<nowiki>metatag-media-og:image=()</nowiki>''
(tämä on Open Graphia varten, joku paremmin tietävä voi selittää)

''<nowiki>metatag-og:description=()</nowiki>''
(ditto)

''<nowiki>metatag-og:any=()</nowiki>''
(ditto)

''<nowiki>}}</nowiki>''

Metadataa ei ole pakko täyttää.
===== Tekstien kirjoittaminen ja muokkaaminen =====

Koko artikkelia saa muokattua sivun oikeasta laidasta löytyvällä Muokkaa-nappulalla (kynän kuva). Tai voit muokata vain jotain osiota kerrallaan.

==== Wiki-syntaksi ====

DocuWiki-syntaksin [[https://www.dokuwiki.org/wiki:syntax|ohjesivu löytyy täältä.]] Voit myös katsoa esimerkkejä editoimalla valmiita sivuja.

Hyvä cheatsheet syntaksista: https://reso-nance.org/wiki/_media/projets/dokuwiki_cheatsheet.pdf

==== Otsikointi ====

Ylimmät, H1-tason otsikot eivät näy Sisällysluettelossa. Ylimmän tason otsikko (wikisyntaksissa kuusi =-merkkiä peräkkäin) on varattu sivun otsikolle.

Sivun otsikosta tulee sivun nimi navigointinäkymissä (esim. Breadcrumbs/jäljet ylälaidan palkissa).

==== Koodiblokin lisääminen sivulle ====

Jos haluat lisätä ''koodiblokkeja'' kuten ohjeissa yllä: mitä kirjoitatkaan ''<nowiki><nowiki>....</nowiki></nowiki>''-tunnisteiden väliin, ei tulkita Wiki-koodiksi. Esimerkki:

''<nowiki><nowiki>Tätä ei tulkita koodiksi</nowiki></nowiki>''

===== Tunnisteiden (tags) käyttäminen =====

Käyttäkäämme tunnisteita erottelemaan esimerkiksi aihepiirit.

Tällä hetkellä (15.12.2023) käytössä ovat ainakin seuraavat pääaihepiirit:

''Ympäristö''
''Talous''
''Energia''
''Politiikka''
''Maanpuolustus''
''Strategia''

Mutta älkää antako tämän rajoittaa. Tunnisteita melkeinpä kannattaa käyttää mieluummin enemmän kuin vähemmän.

Sivupohja lisää sivuille valmiiksi tunniste-koodin, joka näyttää tältä:

''<nowiki>{{tag>Tunniste1 Tunniste2}}</nowiki>''

(Jos et käytä sivupohjaa, voit kopioida sen vaikka tästä, tai jostain toisesta artikkelista.)

Lisää tunnisteet ''>''-merkin jälkeen, erottele välilyönnillä. Tunnisteiden kannattanee olla yksinkertaisia ja melko ylätason käsitteitä. Blogiteksteihin, Twitter-ketjuihin ym. kannattanee lisätä myös oma käyttäjänimi tunnisteeksi.

===== Varmista, että tekstiisi on olemassa linkki =====

Jos tekstiä ei linkata mihinkään, sitä ei löydykään.
===== Nimeä kuvat tunnistettavasti =====

Kuvat saa ladattua Media manageria käyttäen. Kuvat kannattaa nimetä niin, että ne voi tunnistaa jälkikäteenkin. Nimeen kannattaa lisätä jokin viite kuvan lähteestä.

===== Sivulle viittaavat sivut =====

Koodinpätkä ''<nowiki>{{backlinks>.}}</nowiki>'' luo automaattisesti listan sivulle viittaavista sivuista. Sivupohjassa valmiina.

===== Muut sivupohjan jupinat =====

Lopuksi on pätkä koodia:

''<nowiki>[[:etusivu|Takaisin Etusivulle]]</nowiki>''

''<nowiki>[<6>]</nowiki>''

Ensimmäinen rivi luo linkin takaisin Etusivulle, toinen lisää navigaationäppäimet.

===== Älä jännää liikaa, korjataan ongelmat kun mennään eteenpäin =====

Sivuja ja tiedostoja voidaan siirtää paikasta toiseen ja uudelleennimetä. Ei siis kannata miettiä hirveän paljon, miten tätä käyttää - emme tiedä vielä, miten wikiä kannattaisi käyttää, joten kokeillaan.

====== Katso myös ======

===== Tälle sivulle viittaavat sivut =====

===== Tunnisteet =====
{{tag>Ohjeet jmkorhonen 2023}}

//Viimeksi päivitetty: 28.9.2023//

[[:etusivu|Takaisin Etusivulle]]

Yhteenveto muokkauksesta

Huom: Muokkaamalla tätä sivua suostut lisensoimaan sisällön seuraavan lisenssin mukaisesti: CC Attribution-Noncommercial 4.0 International