====== 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 siis uskoo voivansa niitä parantaa.

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''.) Näihin artikkeleihin ei nimettömillä käyttäjillä ole muokkausoikeuksia.

(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 YY-MM-DD. 

==== Lähdeviiteartikkelit ====

Olen kokeillut tehdä joitain artikkelisivuja usein käyttämistäni lähdeviitteistä, kuten vaikka [[korhonen2017_constructed_solutions_to_constructed_constraints|Korhonen (2017). Constructed solutions to constructed constraints: Resource scarcities and technological change]]. Nämä sivut voivat toimia paitsi tiivistelminä esim. tutkimusartikkeleista, myös paikkana kerätä esim. tärkeisiin tutkimuksiin liittyvää kritiikkiä ja kommentteja yhteen paikkaan.

Lähdeviiteartikkelit kannattaa mielestäni nimetä logiikalla ''1. kirjoittajan sukunimi'' + ''vuosi muodossa YYYY'' + ''otsikko''. Esimerkiksi
''korhonen2017_constructed_solutions_to_constructed_constraints''

(plus mitä nyt onkaan tarpeen erottelemiseksi)

Lähdeviiteartikkeleihin kannattaa myös laittaa tagiksi ''Lähteet''.



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

{{backlinks>.}}

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

//Viimeksi päivitetty: 28.9.2023//

[[:etusivu|Takaisin Etusivulle]]