Sisällysluettelo
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 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 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 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ä: Sivupohjat.
Metadata
Sivupohjassa on tällä hetkellä (15.12.2023) ensimmäisenä metadata-kenttä. Se näyttää tältä:
{{htmlmetatags>metatag-robots=(index,follow)
(kertoo hakukoneille, että indeksoi sivu ja seuraa sitä)
metatag-keywords=(avainsanat)
(tähän voi laittaa avainsanoja artikkelista)
metatag-description=(lyhyt kuvaus)
(tähän lyhyen kuvauksen)
metatag-media-og:image=()
(tämä on Open Graphia varten, joku paremmin tietävä voi selittää)
metatag-og:description=()
(ditto)
metatag-og:any=()
(ditto)
}}
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 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>
-tunnisteiden väliin, ei tulkita Wiki-koodiksi. Esimerkki:
<nowiki>Tätä ei tulkita koodiksi</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ä:
{{tag>Tunniste1 Tunniste2}}
(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ä {{backlinks>.}}
luo automaattisesti listan sivulle viittaavista sivuista. Sivupohjassa valmiina.
Muut sivupohjan jupinat
Lopuksi on pätkä koodia:
[[:etusivu|Takaisin Etusivulle]]
[<6>]
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
Viimeksi päivitetty: 28.9.2023