Lähdekoodi sivulle SRAL wiki:Kuinka sivuja muokataan

<div class="floatright">__TOC__</div>

Sivuja pääsee muokkaamaan kirjautumalla käyttäjätunnuksella. Muokkaukset uudella muokkaimella (visuaalinen muokkaus, WYSIWYG, jossa sivu näyttää lähes samalta kuin julkaistuna) hoituvat valitsemalla sivun yläosasta '''Muokkaa''', vanhantyylinen tekstimuokkain taas löytyy valinnasta '''Muokkaa wikitekstiä'''.

Täysin uuden sivun voi luoda 
a) kirjoittamalla hakusanan URL-osoitteeseen (tyyliin https://wiki.sral.fi/wiki/Hakusana) tai
b) luoda olemassaolevalle sivulle linkki haluttuun hakusanaan ja sen jälkeen seurata linkkiä muokattavalle sivulle.

Englanninkielisellä Wikipedialla on [http://en.wikipedia.org/wiki/Wikipedia:Tutorial Tutorial]

==Väliotsikot==
# tason väliotsikko tehdään näin: <code>=väliotsikko=</code>
# tason väliotsikko tehdään näin: <code>==väliotsikko==</code>
# tason väliotsikko tehdään näin: <code>===väliotsikko===</code>
# tason väliotsikko tehdään näin: <code>====väliotsikko====</code>
# tason väliotsikko tehdään näin: <code>=====väliotsikko=====</code>
# tason väliotsikko tehdään näin: <code>======väliotsikko======</code>

Wiki tekee näistä HTML:n H1/H2/H3/H4/H5/H6 tägejä ja konventio on,
että artikkelissa väliotsikot ovat 2. tasoa ja alempia.
Käytännössä ei kuitenkaan kannata olla yli kolmea väliotsikkotasoa.

::'''Väliotsikon pitää olla omalla rivillään.'''

Älä hyppää tasojen yli, koska se näyttää rumalta.

===Väli<sup>2</sup>otsikko===
====Väli<sup>3</sup>otsikko====
=====Väli<sup>4</sup>otsikko=====
Esimerkkejä väliotsikkotasoista.
Katso erityisesti miltä sisällysluettelo näyttää!

==Tekstin asettelu==

Tekstissä olevat yksittäiset rivinvaihdot käyttäytyvät pääasiassa kuin välilyönnit.
Kappaleet erotetaan kahdella rivinvaihdolla. Listoissa asia on toisin.

Rivejä voi katkaista keskeltä käyttämällä <nowiki><br></nowiki>-tagia kuin html:ssä.


 Jos rivi alkaa välilyönnillä ( ), se tulostuu ruudulle sellaisenaan.
 Kirjasin on  tasalevyinen  ja  rivit  eivät  katkea automaattisesti.
 Muista katkoa rivit järkevän mittaisiksi.
 
 Kuitenkin <u>useimmat meta-tägit toimivat</u> mm: <math>\oint matematiikka\,</math>

Verbatim tekstiä saa aikaan myös HTML:n <code>CODE-tägillä</code>, sekä
<pre>PRE-tägillä</pre>

Lista tehdään aloittamalla rivi yhdellä tai useammalla tähdellä (*). Mitä useampi tähti rivin edessä on, sitä enemmän rivi sisentyy. Lista lopetetaan tyhjällä rivillä. Esim:

 *Ensimmäinen taso
 **Toinen taso

*Ensimmäinen taso
**Toinen taso


Numeroituja listoja tehdään aloittamalla rivi vastaavasti yhdellä tai useammalla risuaidalla (#).
Myös numeroidun ja numeroimattoman listan yhdistelmiä voi luoda.

 #Ensimmäinen taso
 ##Toinen taso
 ##Toinen taso

#Ensimmäinen taso
##Toinen taso
##Toinen taso

 *Ensimmäinen taso
 *#Toinen taso
 *#Toinen taso

*Ensimmäinen taso
*#Toinen taso
*#Toinen taso


Rivin tai kappaleen (kunhan se on kokonaan kirjoitettu yhtenä rivinä ilman rivivaihtoja!) voi sisentää laittamalla sen alkuun kaksoispisteen (:).
Useampi kaksoispiste sisentää enemmän.

 :Sisennetään
 ::Sisennetään hiukan enemmän
 :::vielä enemmän
 ::::ja vielä enemmän
 :::vähemmän
 ::vähemmän
 :vain vähän

:Sisennetään
::Sisennetään hiukan enemmän
:::vielä enemmän
::::ja vielä enemmän
:::vähemmän
::vähemmän
:vain vähän

Toinen tapa sisentää pidempää tekstiosuutta on käyttää HTML:n BLOCKQUOTE rakennetta:

  &lt;blockquote&gt;
     sisältöä pitkät pätkät
  &lt;/blockquote&gt;


Teksti keskitetään kuten html:ssä: <nowiki><center>keskitettävä teksti</center></nowiki>.

Vaakasuoran, sivun halkaisevan viivan saa aikaan kirjoittamalla omalle rivilleen <nowiki>----</nowiki>.  (Toki myös HTML:n <nowiki><hr></nowiki> toimii.)

==Linkit==

Linkki toiseen wiki-sivuun tehdään kirjoittamalla hakusana kaksiin
hakasulkuihin "[" ja "]".

::<code><nowiki>[[hakusana]]</nowiki></code>

Jos hakusana ei esiinny lauseessa perusmuodossaan, linkkiä osoittavien hakasulkujen sisään laitetaan hakusanan perusmuoto ja heti viimeisen hakasulun jälkeen taivutuspääte. Toinen tapa tehdä asia on kirjoittaa linkki näin:

::<code><nowiki>[[hakusanan perusmuoto|hakusana]]</nowiki></code>

Tavallinen linkki wikin ulkopuolelle tehdään yksinkertaisesti kirjoittamalla URL. Linkin saa myös näkymään pelkkänä numerona, kun kirjoittaa URLin yksinkertaisiin hakasulkuihin. Jos hakasulkujen sisään lisää linkkiä kuvaavan sanan osoitteen perään välilyönnillä erotettuna, linkkitekstinä näkyy ko. kuvaava sana. Muista http ja muut alkuun!

==Uudelleenohjaukset==

Mikäli jollekin aiheelle on kaksi tai useampia yleisessä käytössä olevaa termiä, kannattaa niistä valita vain yksi artikkelin nimeksi ja tarvittaessa tehdä muista uudelleenohjaus tähän. Kannattaa kuitenkin harkita onko uudelleenohjaus todella tarpeen.

Yhdistettäessä olemassaolevia artikkeleita toisteisen tiedon vähentämiseksi kannattaa poistuvasta sivusta kuitenkin lähes aina tehdä uudelleenohjaus yhdistettyyn sivuun.

Uudelleenohjaus tehdään lisäämällä muutoin tyhjälle sivulle koodi

::<code><nowiki>#REDIRECT [[ohjauksen kohdeartikkeli]]</nowiki></code>

==Kuvat ja äänet==

Wikiin tuodut kuvat, esimerkiksi munkuva.png, saadaan näkyviin kirjoittamalla

::<code><nowiki>[[Image:munkuva.png]]</nowiki></code>

Tekstikuvauksen kuvalle saadaan kirjoittamalla

::<code><nowiki>[[Image:munkuva.png|kuvaus]]</nowiki></code>

Pelkän linkin kuvaan saadaan kirjoittamalla

::<code><nowiki>[[media:munkuva.png|kuvaus]]</nowiki></code>

Linkki wikiin tuotuun äänitiedostoon saadaan kirjoittamalla

::<code><nowiki>[[media:munääni.ogg|Ääniä]]</nowiki></code>

http://en.wikipedia.org/wiki/Wikipedia:Picture_tutorial

==Kirjainten muotoilu==

Painotus tehdään lisäämällä sanan molemmille puolille <nowiki>''</nowiki>''kahdet''<nowiki>''</nowiki> tai <nowiki>'''</nowiki>'''kolmet'''<nowiki>'''</nowiki> heittomerkit.

Yliviivaus tehdään näin: <nowiki><s>yliviivattava teksti</s></nowiki>: <s>yliviivattava teksti</s>

Alleviivaus tehdään näin: <nowiki><u>alleviivattava teksti</u></nowiki>: <u>alleviivattava teksti</u>

Wikin omat muotoilut voidaan estää näin: <code><nowiki><nowiki> [[ohjeet]] </nowiki></nowiki></code>

Tekstin kommentointi, joka näkyy vain muokkaus-tilassa (ja tietysti
sivun lähdekoodia katsoessa) saadaan seuraavasti:

 <nowiki><!-- tekstin kommentointia --></nowiki>

==Sisällysluettelot ja taulukot==

Sisällysluettelo ilmestyy tekstin alkuu automaattisesti, jos tekstistä löytyy
vähintään neljä väliotsikkoa. Sisällysluettelon saa pakotettua haluttuun paikka
kirjoittamalla <code><nowiki>__TOC__</nowiki></code>.
Sisällysluettelon saa pois näkyvistä sijoittamalla minne vain 
<code><nowiki>__NOTOC__</nowiki></code>.

Kapean mutta pitkän sisällysluettelon voi sijoittaa haluamaansa kohtaan
myös esim. oikeaan reunaan sijoitettuna niin että artikkelin teksti on sen 
vasemmalla puolella:
<pre><nowiki><div class="floatright">__TOC__</div></nowiki></pre>


Taulukoita voi tehdä kahdella tavalla: joko käyttämällä perinteisiä html:ää tai wikin omaa esitysmuotoa.

http://en.wikipedia.org/wiki/Wikipedia:How_to_use_tables

==Sivujen luokittelu==

Yksittäinen sivu voidaan merkitä kuuluvaksi johonkin artikkeliluokkaan
lisäämällä johonkin kohden sivun koodia luokitustagi 
<code><nowiki>[[Category:Luokan nimi]]</nowiki></code>.
Artikkeli voidaan merkitä kuuluvaksi myös useampaan kuin yhteen 
artikkeliluokkaan lisäämällä erilliset luokitustagit jokaista luokkaa
varten (on suositeltavaa koota sivun luokitustagit yhteen paikkaan, joko
artikkelin alkuun tai sen loppuun).

Uusi artikkeliluokka luodaan automaattisesti heti kun yksikin sivu ilmoittaa
kuuluvansa siihen. Olemassaolevat luokat listataan 
[[Toiminnot::Categories|artikkeliluokkalistassa]] ja
jokaiselle luokalle on olemassa myös Luokka:Luokan_nimi koostesivunsa.
Luokan koostesivulla on nähtävissä automaattisesti luotava lista kyseiseen
luokkaan kuuluvista artikkeleista ja lisäksi sille voi lisätä esimerkiksi 
lyhyen selityksen luokan sisällöstä. Pidemmät selostukset on hyvä laittaa 
omiksi artikkeleikseen, kuten yksittäiset luokkaan liittyvät aiheetkin.

==Matematiikka==

WIKI:n <code><nowiki><math>...</math></nowiki></code> tagit kapseloivat
LaTeX matematiikkaformatointikieltä.
Apua löytyy Wikimedian metahelpeistä: (englanniksi)
::http://meta.wikimedia.org/wiki/Help:Formula

Oikein pitkiä kaavoja kirjoittaessa auttaa, kun hoksaa että LaTeX on aika
tunteeton rivinvaihdoille matematiikkasyötteessään ja että siksi näitä
MATH-tägejä voi kirjoittaa monen rivin matkalle.

 <nowiki> Sijoittamalla <math>\gamma_g^2\,</math> kolmanneksi termiksi
 yhtälön (eq.60) vasemmalle  puolelle ja kertomalla saatu yhtälö
 <math>r^2\,</math>:lla, saadaan:
 ::<math>\frac{r}{R}\frac{d}{dr}\left(r\frac{dR}{dR}\right)
         + \frac{1}{\Phi}\frac{d^2\Phi}{d\phi^2}
         - \left(\gamma^2 - \gamma_g^2\right)r^2 = 0</math> (eq.63)
 </nowiki>

Sama formatoituvana:
<blockquote>
Sijoittamalla <math>\gamma_g^2\,</math> kolmanneksi termiksi
yhtälön (eq.60) vasemmalle puolelle ja kertomalla saatu yhtälö
<math>r^2\,</math>:lla, saadaan:
::<math>\frac{r}{R}\frac{d}{dr}\left(r\frac{dR}{dR}\right)
        + \frac{1}{\Phi}\frac{d^2\Phi}{d\phi^2}
        - \left(\gamma^2 - \gamma_g^2\right)r^2 = 0</math> (eq.63)
</blockquote>

Yhtälöryhmien LaTeX-maisen kaunista muotoilua on hieman vaikea tehdä,
mutta sekin onnistuu esim. jakamalla pidemmät yhtälöt sopivista kohdista
palasiksi ja sijoittamalla palaset taulukkoon, jonka ruutuja sitten
tarvitessa varustetaan  <code>|align=right|</code>  tägillä.
Automaattiset kaavanumeroinnit ja numeroinnin sijoitus rivin oikeaan
reunaan kaavan ollessa keskellä riviä eivät kuitenkaan onnistu.

Hyviä esimerkkejä tällaisista formatointikikkailuista on mm:
::[[Aaltoputkien_teoria#TE-muodot_suorakulmaisessa_aaltoputkessa]]

==Ulkoisten editorien käyttö==

Erityisesti pitkiä artikkeleita kirjoittaessa alkaa kaivata parempia editoreja,
kuin web-selaimen normaali tekstimuokkausikkuna.  Lisätietoja:

http://en.wikipedia.org/wiki/Wikipedia:Text_editor_support