Ohje:Koodiopas

Kohteesta Wikikirjasto
Loikkaa: valikkoon, hakuun

Tämä koodiopas sisältää keskeisimmät Wikikirjaston artikkelien kirjoittamisessä käytettävät wikikoodit. Wikikoodi on käytännössä HTML-koodia, mutta se merkitään erilaisella syntaksilla.

Luvut, kappaleet, listat ja viivat[muokkaa]

Uudet luvut ja kohdat aloitetaan otsikkoriveillä:

Koodi
== Uusi luku ==

=== Kohta ===

==== Alikohta ====
Tulos

Uusi luku[muokkaa]

Kohta[muokkaa]

Alikohta[muokkaa]


Kappaleenvaihto

Koodi
Yhdellä rivinvaihdolla 
ei ole vaikutusta.

Mutta kaksi rivinvaihtoa aloittaa uuden kappaleen.
Tulos

Yhdellä rivinvaihdolla ei ole vaikutusta.

Mutta kaksi rivinvaihtoa aloittaa uuden kappaleen.


Pakotettu rivinvaihto

Koodi
Rivin voi br-tagilla vaihtaa<br />
aloittamatta uutta kappaletta.
Tulos

Rivin voi br-tagilla vaihtaa
aloittamatta uutta kappaletta.


Numeroimaton lista

Koodi
* Listoja voi tehdä helposti:
** jokainen rivi aloitetaan tähdellä
** useampi tähti tarkoittaa syvempää tasoa
Tulos
  • Listoja voi tehdä helposti:
    • jokainen rivi aloitetaan tähdellä
    • useampi tähti tarkoittaa syvempää tasoa

Numeroitu lista

Koodi
# Numeroiduilla listoilla voi
## myös tehdä listoja,
## joita on helppo seurata.
Tulos
  1. Numeroiduilla listoilla voi
    1. myös tehdä listoja,
    2. joita on helppo seurata.

Yhdistelmälista

Koodi
* Listoja voi myös sekoittaa
*# ja sekoittaa
*#* niin kuin tässä on tehty.
Tulos
  • Listoja voi myös sekoittaa
    1. ja sekoittaa
      • niin kuin tässä on tehty.

Määrittelylista

Koodi
; Määrittelylista : lista määrittelyjä
; asia : asian määrittely
Tulos
Määrittelylista 
lista määrittelyjä
asia 
asian määrittely

Sisennys

Koodi
:Kaksoispiste sisentää rivin tai kappaleen.
Sisennyksen tai luettelon jälkeen jo yksi rivinvaihto aloittaa uuden kappaleen.
Tulos
Kaksoispiste sisentää rivin tai kappaleen.

Sisennyksen tai luettelon jälkeen jo yksi rivinvaihto aloittaa uuden kappaleen.


Vaakaviiva

Koodi
Vaakaviiva: yläpuoli
----
ja alapuoli.
Tulos

Vaakaviiva: yläpuoli


ja alapuoli.


Allekirjoituksen lisääminen onnistuu helposti lisäämällä neljä tildeä ja lisäksi alkuun erotukseksi kaksi väliviivaa eli --~~~~. Tuloksena on linkki käyttäjäsivulle ja muutoksen ajankohta.

Koodi
--~~~~
Tulos

-- Käyttäjänimi 18. elokuuta 2008 kello 24.12 (EEST)

Jos kuvat tai taulukot työntyvät toistensa päälle, voi niiden väliin lisätä katkaisukoodin, jolloin alempi objekti ei saa piirtyä ennen ylemmän päättymistä

<div style="clear: both"></div></nowiki>

Wikikirjaston sisäinen linkitys[muokkaa]

Artikkelin nimi alkaa automaattisesti versaalilla kirjaimella, joten ensimmäisessä kirjaimessa aakkoslajilla ei ole väliä mutta muissa kirjaimissa on. Eli tervetuloa Wikikirjastoon ja tervetuloa wikikirjastoon ovat eri sivuja.

Koodi
[[Tervetuloa Wikikirjastoon]] tai [[tervetuloa Wikikirjastoon]]
Tulos

Tervetuloa Wikikirjastoon tai tervetuloa Wikikirjastoon.


Sama artikkeli, mutta eri teksti:

Koodi
[[tervetuloa Wikikirjastoon|tervetuloa]]
Tulos

tervetuloa


Päätteet yhdistetään linkin tekstiin mutta ei etumäärettä:

Koodi
[[metri]]ä, [[koira]]lla mutta Esi[[merkki]]
Tulos

metriä, koiralla mutta Esimerkki


"Putkitrikillä" voidaan nopeuttaa linkittämistä kahdessa eri tapauksessa. Kun sivun nimelle on annettu lisämäärite sen vuoksi että samalla nimella on kaksi sivua ja kun viitataan muuhun kuin päänimiavaruuteen, riittää että kirjoittaa sivun kokonimen ja sen jälkeen putken (|). Palvelin täydentää linkin automaattisesti.

Koodi:

Koodi
[[Kunta (matematiikka)|]]
Tulos

Kunta

Koodi:

Koodi
[[Wikikirjasto:Hiekkalaatikko|]]
Tulos

Hiekkalaatikko


Olemattoman sivun linkki näkyy oletuksena punaisena ja sitä klikkaamalla pääsee suoraan muokkaustilaan, jossa sen voi luoda.


Lukija voidaan ohjata suoraan toiseen artikkeliin sijoittamalla seuraavanlainen teksti sen ensimmäiselle riville. Huomaa, että sivulla ei saa olla muuta tekstiä, jotta ohjaus toimisi varmasti. Toisen sivun tiettyyn osioon voidaan viitata lisäämällä sivun nimen perään risuaita (#) ja osion nimi.

Koodi
#OHJAUS [[Toinen sivu]]

#OHJAUS [[Toinen sivu#Tietty osio]]
Tulos
  1. OHJAUS Toinen sivu
  1. OHJAUS Toinen sivu#Tietty osio

Ulkoinen linkki minne tahansa WWW:ssä[muokkaa]

Koko URL-oseitteella linkittäessä tulee jokaisen merkin kuulua seuraaviin: A–Z a–z 0–9 ._\/~%-+&#?!=()@ \x80-\xFF. Jos URL:ssä on muita merkkejä, ne on esitettävä koodina, esim. ^ pitää kirjoittaa %5E (Katso w:ASCII).

Koodi
Linkki Wikipedian ulkopuolelle: 
*[http://www.google.fi/ Google]
*[http://www.google.fi/]
*http://www.google.fi/
Tulos

Linkki Wikipedian ulkopuolelle:

Samankielisten projektien välinen linkitys[muokkaa]

Sisarprojekteihin linkitetään alla olevan taulukon mukaisesti. Muihin kuin päänimiavaruuteen linkitetään kohteen mukaisella kokonimellä Esimerkiksi

Projekti Avainsana Esimerkki Tulos
Wikipedia w [[w:sana|sana]] sana
Wikisitaatit / Wikiquote q [[q:Bertrand Russell|Bertrand Russell]] Bertrand Russell
Wikisanakirja / Wiktionary wikt [[wikt:yhdyssana|yhdyssana]] yhdyssana
Wikiaineisto / Wikisource s [[s:Valokuvaus matkoilla|Valokuvaus matkoilla]] Valokuvaus matkoilla
Metawiki m [[m:Mission|Mission]] Mission
Wikimedia Commons commons [[commons:Project Apollo|Project Apollo]] Project Apollo
Wikiuutiset / Wikinews n [[n:Tieteilijät antoivat selvityksen ilmastonmuutoksen ehkäisemiseksi|Tieteilijät antoivat selvityksen ilmastonmuutoksen ehkäisemiseksi]] Tieteilijät antoivat selvityksen ilmastonmuutoksen ehkäisemiseksi
Wikispecies wikispecies [[wikispecies:Tonicella venusta|Tonicella venusta]] Tonicella venusta
Wikimedia Incubator incubator [[incubator:Main Page|Main Page]] Main Page

Kielten välinen linkitys ja Interwiki[muokkaa]

Kieltenväliseen linkitykseen tarvitaan hankkeen kielitunnus. Esimerkiksi englannin kielistä tarkoittaa tunnus en. (kaikki Wikikirjastojen kielitunnukset)

Wikikirjastojen kieliversioiden välinen linkitys

Varsinainen interwikilinkki, joka tulee vasempaan sivupalkkiin

  • Koodi: [[en:Wikijunior]]

Linkki johonkin muuhun ja muunkieliseen projektiin

Luokan linkitys muun kieliseen wikikirjastoon.

Luokan linkitys muunkieliseen muuhun projektiin.

Erikoislinkkejä[muokkaa]

Kirjojen linkittämiseen voi käyttää ISBN-linkkejä.

Koodi
ISBN 0-12-345678-9
Tulos

ISBN 0-12-345678-9

Kuvat ja muut tiedostot[muokkaa]

Vain Commonsiin tai Wikikirjastoon tallennettuja kuvia tai muita tiedostoja voi käyttää. Kuvia tai muita tiedostoja voi tallentaa tallennussivulla. Tallennetut kuvat on lueteltu luettelossa kuvista. Aiheesta tarkemmin sivulla Ohje:Kuvat.

Koodi
Kuva: [[Tiedosto:Wikibooks-logo.svg|50px|Wikikirjaston logo]] 
Tulos

Kuva: Wikibooks-logo.svg

Kuvat on yleensä syytä lisätä tekstin kanssa, koska se

  • näkyy tekstipohjaisilla selaimilla (mm. Lynx (selain))
  • näkyy selaimilla, kun käyttäjä on estänyt kuvien näyttämisen.
  • muutetaan puheeksi mm. sokeiden käyttämissä puheselaimissa.
  • näkyy monissa selaimissa ponnahdustekstinä, kun kursoria pidetään hetken aikaa kuvan päällä
  • tulostetaan kuvatekstinä.
Koodi
[[Tiedosto:Wikibooks-logo.svg|50px|Wikikirjaston logo]]
Tulos

Wikikirjaston logo

Tallennetun kuvan klikkaaminen näyttää kuvan oman sivun, johon voi myös linkittää suoraan lisäämällä koodiin kaksoispiste:

Koodi
[[:Tiedosto:Wikibooks-logo.svg]]
Tulos

Tiedosto:Wikibooks-logo.svg

Ääni- ja videotallenteita voidaan lisätä sivulle samalla tavalla kuin kuvia.

Koodi
[[Tiedosto:Marriage of Figaro.ogg|200px|Marriage of Figaro.ogg]]
[[:Tiedosto:Marriage of Figaro.ogg|Marriage of Figaro.ogg]]

[[Tiedosto:Apollo 15 launch.ogv|thumb|left|200px|Apollo 15:n laukaisu.]]
[[:Tiedosto:Apollo 15 launch.ogv|Apollo 15 launch.ogv]]
Tulos

Marriage of Figaro.ogg

Apollo 15:n laukaisu.

Apollo 15 launch.ogv

Merkkien muotoilu[muokkaa]

Muotoiltu teksti Kirjoitettu teksti

Painota, voimakkaasti, hyvin voimakkaasti.

  • Nämä ovat siis moninkertaisia heittomerkkejä ('), eivät lainausmerkkejä (").
''Painota'', '''voimakkaasti''', 
'''''hyvin voimakkaasti'''''.

Voit myös kirjoittaa kursiivia ja lihavoitua jos et halua muuttaa painotusta vaan kirjasintyyppiä, kuten matemaattisissa kaavoissa:

F = ma
  • Näiden kahden välinen ero on pieni, eivätkä useimmat ota sitä huomioon.
Voit myös kirjoittaa <i>kursiivia</i> ja <b>lihavoitua</b>
jos et halua muuttaa painotusta vaan kirjasintyyppiä, kuten
matemaattisissa kaavoissa:

:<b>F</b> = <i>m</i><b>a</b>
Tekniset termit kirjoitetaan tasavälisellä kirjasimella.
<tt>Tekniset termit</tt> kirjoitetaan tasavälisellä kirjasimella.
Voit käyttää tätä tyyliä mm. kuvateksteissä.
 Voit käyttää <small>tätä</small> tyyliä<br/>
mm. <small>kuvateksteissä</small>. 
Voit yliviivata poistettavaa tekstiä

ja alleviivata uutta.

  • Hyödyllinen muokatessa artikkeleita.
 Voit <strike>yliviivata poistettavaa tekstiä</strike>
ja <u>alleviivata uutta</u>.

Pilkkuja, pisteitä ja aksentteja: (Katso wikipedia:Special characters)
À Á Â Ã Ä Å
Æ Ç È É Ê Ë
Ì Í Î Ï Ñ Ò
Ó Ô Õ Ö Ø Ù
Ú Û Ü ß à á
â ã ä å æ ç
è é ê ë ì í
î ï ñ ò ó ô
õ ö ø ù ú û

ü ÿ


&Agrave; &Aacute; &Acirc; &Atilde; &Auml; &Aring; 
&AElig; &Ccedil; &Egrave; &Eacute; &Ecirc; &Euml; 


&Igrave; &Iacute; &Icirc; &Iuml; &Ntilde; &Ograve; 
&Oacute; &Ocirc; &Otilde; &Ouml; &Oslash; &Ugrave; 
&Uacute; &Ucirc; &Uuml; &szlig; &agrave; &aacute; 
&acirc; &atilde; &auml; &aring; &aelig; &ccedil; 
&egrave; &eacute; &ecirc; &euml; &igrave; &iacute;
&icirc; &iuml; &ntilde; &ograve; &oacute; &ocirc; 
&otilde; &ouml; &oslash; &ugrave; &uacute; &ucirc; 
&uuml; &yuml;

Välimerkkejä:
¿ ¡ « » § ¶
† ‡ • —


&iquest; &iexcl; &laquo; &raquo; &sect; &para;
&dagger; &Dagger; &bull; &mdash;



Kaupallisia merkkejä:
™ © ® ¢ € ¥

£ ¤

&trade; &copy; &reg; &cent; &euro; &yen; 
&pound; &curren;
Alaindeksi: x2

Yläindeksi: x2 tai x²

  • Jälkimmäinen tapa tehdä yläindeksi ei ole kaikkein yleiskäyttöisin, mutta sitä suositellaan milloin mahdollista (esim. mittayksiköissä). Useimpien selainten on helpompi muotoilla rivit sitä käytettäessä.

ε0 = 8.85 × 10−12

C² / J m.
Alaindeksi: x<sub>2</sub>
Yläindeksi: x<sup>2</sup> tai x&sup2;







&epsilon;<sub>0</sub> =
8.85 &times; 10<sup>&minus;12</sup>
C&sup2; / J m.
Kreikkalaiset kirjaimet:

α β γ δ ε ζ
η θ ι κ λ μ ν
ξ ο π ρ σ ς
τ υ φ χ ψ ω
Γ Δ Θ Λ Ξ Π
Σ Φ Ψ Ω


&alpha; &beta; &gamma; &delta; &epsilon; &zeta; 
&eta; &theta; &iota; &kappa; &lambda; &mu; &nu; 
&xi; &omicron; &pi; &rho;  &sigma; &sigmaf;
&tau; &upsilon; &phi; &chi; &psi; &omega;
&Gamma; &Delta; &Theta; &Lambda; &Xi; &Pi; 
&Sigma; &Phi; &Psi; &Omega;

Matemaattisia merkkejä:
∫ ∑ ∏ √ − ± ∞
≈ ∝ ≡ ≠ ≤ ≥ →
× · ÷ ∂ ′ ″
∇ ‰ ° ∴ ℵ ø
∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇
¬ ∧ ∨ ∃ ∀ ⇒ ⇔
(Katso myös: Wikipedia:TeX markup, Special characters ja WikiProject Mathematics)

&int; &sum; &prod; &radic; &minus; &plusmn; &infin;
&asymp; &prop; &equiv; &ne; &le; &ge; &rarr;
&times; &middot; &divide; &part; &prime; &Prime;
&nabla; &permil; &deg; &there4; &alefsym; &oslash;
&isin; &notin; &cap; &cup; &sub; &sup; &sube; &supe;
&not; &and; &or; &exist; &forall; &rArr; &hArr;
x2   ≥   0 true.
  • Jos tarvitaan tilaa, käytä katkeamatonta välilyöntiä - &nbsp;.
  • &nbsp; estää myös kesken kaiken tapahtuvat rivinvaihdot, mikä on hyödyllistä kaavoja muokatessa.
<i>x</i><sup>2</sup>&nbsp;&nbsp;&ge;&nbsp;&nbsp;0 true.

Monimutkaiset kaavat:
  

  
<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>

Taulukot[muokkaa]

Pääartikkeli:Wikipedia:Taulukoiden lisääminen

Taulukoita voi tehdä joko wikipedian omalla wikimerkinnällä tai HTML:llä. Alla yksinkertainen esimerkkitaulukko kummallakin tavalla tehtynä.

Esimerkkitaulukko wikimerkinnällä
Ensimmäinen otsikko Toinen otsikko Kolmas otsikko
vasen ylänurkka yläreunan keskiosa oikea reuna
vasen reuna keskikenttä
alarivi
Esimerkkitaulukko HTML:llä
Ensimmäinen otsikko Toinen otsikko Kolmas otsikko
vasen ylänurkka yläreunan keskiosa oikea reuna
vasen reuna keskikenttä
alarivi


Taulukoiden lähdekoodit
{| border="1"
|+ Esimerkkitaulukko wikimerkinnällä
!Ensimmäinen otsikko
!Toinen otsikko
!Kolmas otsikko
|-
| vasen ylänurkka
| yläreunan keskiosa
| rowspan=2 | oikea reuna
|-
| vasen reuna
| keskikenttä
|-
| colspan="3" align="center" | alarivi
|}
<table border="1">
<caption>Esimerkkitaulukko HTML:llä</caption>
<tr>
<th>Ensimmäinen otsikko</th>
<th>Toinen otsikko</th>
<th>Kolmas otsikko</th>
</tr>
<tr>
<td>vasen ylänurkka</td>
<td>yläreunan keskiosa</td>
<td rowspan=2>oikea reuna</td>
</tr>
<tr>
<td>vasen reuna</td>
<td>keskikenttä</td>
</tr>
<tr>
<td colspan="3" align="center">alarivi</td>
</tr>
</table>

Wikitaulukko[muokkaa]

Taulukko tehdään merkinnällä

{| parametrit
|}

Näiden rivien väliin tulevat kaikki muut merkinnät. Jos taulukolle halutaan antaa otsikko, se merkitään ensinnä:

|+ otsikko

tai, mikäli otsikko halutaan määritellä tarkemmin

|+ parametrit | otsikko

Solut merkitään riveittäin vasemmalta oikealle. Uuden rivin aloittaa

|- parametrit

jossa parametrit voi jättää pois. Ensimmäisen rivin alkua (heti taulukon alun tai otsikon jälkeen) ei tarvitse merkitä, koska sen voi olettaa alkavan taulukon ensimmäisestä solusta. Solut merkitään joko kukin omalle rivilleen:

| 1. solun sisältö
| 2. solun sisältö

tai useita samalle riville kahden pystyviivan erottamina:

| 1. solun sisältö || 2. solun sisältö

Merkintätapoja voi vapaasti yhdistellä tarpeen mukaan

| lyhyt || lyhyt
| huomattavasti pitempi solun sisältö omalla rivillään

Mahdolliset parametrit kirjoitetaan tuttuun tapaan solun alkumerkin ja sisällön väliin, ja ne päättyvät yhteen pystyviivaan:

| parametrit | 1. solu
| parametrit | 2. solu || 3. solu

Otsikkosolut merkitään kuten tavallisetkin solut, mutta pystyviivan sijasta käytetään huutomerkkiä. Parametrit erotetaan solun sisällöstä kuitenkin pystyviivalla.

! parametrit | 1. otsikkosolu !! parametrit | 2. otsikkosolu

Parametreiksi kelpaavat kaikki HTML-taulukoiden parametrit, ja ne annetaan siis HTML-merkinnällä.

HTML-taulukko[muokkaa]

Jos taulukkosi näyttää virheelliseltä, varmista että kaikki <tr>- ja <td>-tagit on suljettu vastaavilla </tr>- ja </td>-tageilla. Rivejä ei pidä sisentää, eikä taulukoihin pidä tehdä tyhjiä rivejä. Muuten taulukon yläpuolelle tulee ylimääräistä tilaa, tai pahimmassa tapauksessa selain saattaa kaatua.

Toisessa hieman monimutkaisemmassa esimerkissä esitellään muutamia muita tapoja taulukoiden muotoiluun. Voit kokeilla näitä omilla taulukoilla, esim. hiekkalaatikossa. Muista, että värejä on parasta käyttää säästeliäästi. <thead>, <tfoot> ja <tbody> -elementit eivät ole käytettävissä. Yllä esiteltyjä tekstinmuotoilumenetelmiä voi käyttää myös taulukoiden soluissa olevaan tekstiin.

Esimerkkitaulukko
Ensimmäinen otsikko Toinen otsikko
vasen ylänurkka   oikea reuna
vasen alanurkka alareuna
Taulukko taulukossa
Wikipedia-logo-fi.png Wikipedia-logo-fi.png
Kaksi Wikipedian logoa
<table border="1" cellpadding="5" cellspacing="0" align="center">
<caption>'''Esimerkkitaulukko'''</caption>
<tr>
<th style="background:#efefef;">Ensimmäinen otsikko</th>
<th colspan="2" style="background:#ffdead;">Toinen otsikko</th>
</tr>
<tr>
<td>vasen ylänurkka</td>
<td> </td>
<td rowspan=2 style="border-bottom:3px solid grey;" valign="top">oikea reuna</td>
</tr>
<tr>
<td style="border-bottom:3px solid grey;">vasen alanurkka</td>
<td style="border-bottom:3px solid grey;">alareuna</td>
</tr>
<tr>
<td colspan="3" align="center">
<table border="0">
<caption>''Taulukko taulukossa''</caption>
<tr>
<td align="center" width="150px">[[Image:wiki.png]]</td>
<td align="center" width="150px">[[Image:wiki.png]]</td>
</tr>
<tr>
<td align="center" colspan="2" style="border-top:1px solid red; border-right:1px solid red;
border-bottom:2px solid red; border-left:1px solid red;">Kaksi Wikipedian logoa</td>
</tr>
</table>
</td>
</tr>
</table>

Avainsanoja[muokkaa]

Kattavampi lista Wikipediassa sivulla w:Ohje:Malline.

Sivuille joilla on ainakin neljä otsikkoa, luodaan automaattisesti sisällysluettelo. Jos tämä ei ole toivottavaa (esim. lyhyet artikkelit, luettelot), voit lisätä sivulle avainsanan __NOTOC__ , joka piilottaa sisällysluettelon.

Taikasanoja[muokkaa]

Kattavampi lista Wikipediassa sivulla w:Ohje:Malline.

Aika[muokkaa]

Koodi Tulos
{{CURRENTMONTH}} 11
{{CURRENTMONTHNAME}} marraskuu
{{CURRENTMONTHNAMEGEN}} marraskuun
{{CURRENTDAY}} 18
{{CURRENTDAYNAME}} lauantai
{{CURRENTYEAR}} 2017
{{CURRENTTIME}} 19.24
{{CURRENTWEEK}} 46

Muita[muokkaa]

Koodi Tulos Selitys
{{NUMBEROFARTICLES}} 3 884 tietokannassa olevat artikkelit, joissa on linkki ja jotka eivät ole uudelleenohjaussivuja.
{{PAGENAME}} Koodiopas
{{NAMESPACE}} Ohje
{{FULLPAGENAME}} Ohje:Koodiopas
{{localurl:pagename}} /wiki/Pagename
{{localurl:Wikikirjasto:Hiekkalaatikko|action=edit}} /w/index.php?title=Wikikirjasto:Hiekkalaatikko&action=edit
{{SERVER}} //fi.wikibooks.org

Nimiavaruudet[muokkaa]

Koodi Tulos
{{ns:1}} Keskustelu
{{ns:2}} Käyttäjä
{{ns:3}} Keskustelu käyttäjästä
{{ns:4}} Wikikirjasto
{{ns:5}} Keskustelu Wikikirjastosta
{{ns:6}} Tiedosto
{{ns:7}} Keskustelu tiedostosta
{{ns:8}} Järjestelmäviesti
{{ns:9}} Keskustelu järjestelmäviestistä
{{ns:10}} Malline
{{ns:11}} Keskustelu mallineesta
{{ns:12}} Ohje
{{ns:13}} Keskustelu ohjeesta
{{ns:14}} Luokka
{{ns:15}} Keskustelu luokasta
{{ns:-1}} Toiminnot
{{ns:-2}} Media
{{SITENAME}} Wikikirjasto