Käyttäjän työkalut

Sivuston työkalut


ohjeita_kirjoittajille

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

Takaisin Etusivulle

ohjeita_kirjoittajille.txt · Viimeksi muutettu: 2023/12/15 18:07 / Janne M. Korhonen