Ohje:Koodiopas

Kohteesta ExcaliburWiki
Versio hetkellä 26. marraskuuta 2006 kello 05.00 – tehnyt Sandi (keskustelu | muokkaukset) (→‎Merkkien muotoilu)
Siirry navigaatioonSiirry hakuun

Tämä sivu lainattu suomenkielisestä Wikipediasta lisenssillä GNU Free Documentation License. Alkuperäinen sivu osoitteessa: http://fi.wikipedia.org/wiki/Ohje:Koodiopas


Tämä koodiopas sisältää Mediawikin artikkelien kirjoittamisessa käytettäviä koodeja. Pikaopas on sivulla Kuinka sivuja muokataan.

Luvut, kappaleet, listat ja viivat

Muotoiltu teksti Kirjoitettu teksti

Uudet luvut ja kohdat aloitetaan otsikkoriveillä:


Uusi luku

Kohta

Alikohta


== Uusi luku ==

=== Kohta ===

==== Alikohta ====

Yhdellä rivinvaihdolla ei ole vaikutusta.

Mutta tyhjä rivi aloittaa uuden kappaleen.

Yhdellä rivinvaihdolla 
ei ole vaikutusta.

Mutta tyhjä rivi 
aloittaa uuden kappaleen.
Rivin voi vaihtaa
aloittamatta uutta kappaletta.
Rivin voi vaihtaa<br/>
aloittamatta uutta kappaletta.
  • Listoja voi tehdä helposti:
    • jokainen rivi aloitetaan tähdellä
    • useampi tähti tarkoittaa syvempää tasoa
* Listoja voi tehdä helposti:
** jokainen rivi aloitetaan tähdellä
** useampi tähti tarkoittaa syvempää tasoa
  1. Numeroiduilla listoilla voi
    1. myös tehdä listoja,
    2. joita on helppo seurata.
# Numeroiduilla listoilla voi
## myös tehdä listoja,
## joita on helppo seurata.
  • Listoja voi myös sekoittaa
    1. ja sekoittaa
      • niin kuin tässä on tehty.
* Listoja voi myös sekoittaa
*# ja sekoittaa
*#* niin kuin tässä on tehty.
Määrittelylista 
lista määrittelyjä
asia 
asian määrittely
; Määrittelylista : lista määrittelyjä
; asia : asian määrittely
Rivejä voi
sisentää
useita tasoja
:Rivejä voi
::sisentää
:::useita tasoja
Kaksoispiste sisentää rivin tai kappaleen.

Rivinvaihto aloittaa uuden kappaleen.

:Kaksoispiste sisentää rivin tai kappaleen.
Rivinvaihto aloittaa uuden kappaleen.
IF rivi aloitetaan välilyönnillä THEN
  se muotoillaan juuri niin kuin 
    se on kirjoitettu;
  erilaisella kirjasimella;
  ja rivinvaihdot säilyvät;
ENDIF
Tämä on käyttökelpoinen:
  * valmiiksimuotoilluissa teksteissä;
  * algoritmien kuvauksissa;
  * ascii-taiteessa;

VAROITUS: Jos valmiiksimuotoillusta tekstistä tekee liian leveän, se pakottaa koko sivun leveämmäksi ja siten se huonontaa sivun luettavuutta.

 IF rivi aloitetaan välilyönnillä THEN
   se muotoillaan juuri niin kuin 
     se on kirjoitettu;
   erilaisella kirjasimella;
   ja rivinvaihdot säilyvät;
 ENDIF
 Tämä on käyttökelpoinen:
   * valmiiksimuotoilluissa teksteissä;
   * algoritmien kuvauksissa;
   * ascii-taiteessa;
Keskitetty teksti.
<center>Keskitetty teksti.</center>
Vaakaviiva: yläpuoli

ja alapuoli.

Vaakaviiva: yläpuoli
----
ja alapuoli.
Kun keskustelusivulle lisätään kommentti,

se pitäisi allekirjoittaa. Tämän voi tehdä helposti lisäämällä kolme matoa (tilde, ~) lisätäksesi käyttäjätunnuksesi:
- Montrealais
tai neljä lisätäksesi nimen lisäksi päiväyksen ja ajan:

- Montrealais 08:10 Oct 5, 2002 (UTC)
Kun keskustelusivulle lisätään kommentti, 
se pitäisi allekirjoittaa. Tämän voi tehdä 
helposti lisäämällä kolme matoa (tilde, ~) 
lisätäksesi käyttäjätunnuksesi:
~~~
tai neljä lisätäksesi nimen lisäksi 
päiväyksen ja ajan:
~~~~

Linkit, URL:t, Kuvat

Muotoiltu teksti Kirjoitettu teksti

Linkki: kysymyksiä ja vastauksia Wikipediasta.

  • Artikkelin nimi alkaa automaattisesti isolla kirjaimella.
Linkki [[kysymyksiä ja vastauksia Wikipediasta]].

Sama artikkeli, mutta eri teksti: kysymyksiä.

Sama artikkeli, mutta eri teksti: 
[[kysymyksiä ja vastauksia Wikipediasta|kysymyksiä]].

Päätteet yhdistetään linkin tekstiin: metriä, koiralla

Päätteet yhdistetään linkin 
tekstiin: [[metri]]ä, [[koira]]lla

"Putkitrikki":
Suluissa oleva teksti piilotetaan automaattisesti: kunta.

Nimiavaruus piilotetaan automaattisesti: Hiekkalaatikko.

Palvelin täyttää |-merkin jälkeen tulevan osuuden automaattisesti, kun sivu tallennetaan.

Suluissa oleva teksti piilotetaan 
automaattisesti: 

    [[kunta (matematiikka)|]].
Nimiavaruus piilotetaan automaattisesti:

    [[Wikipedia:Hiekkalaatikko|]].

Sivua Lontoon sää ei ole vielä olemassa.

  • Voit luoda sen klikkaamalla linkkiä.


  • Uuden sivun luominen:
    1. Tee joltakin toiselta sivulta linkki uuteen sivuun.
    2. Tallenna sivu.
    3. Klikkaa juuri tekemääsi linkkiä. Uusi sivu aukeaa muokattavaksi.
  • Vilkaise artikkeleiden nimeämiskäytäntöjä.
  • Luotuasi uuden sivun, etsi sen otsikkoa ja varmista, että linkitykset siihen ovat oikein.
Sivua [[Lontoon sää]] ei ole vielä olemassa.

Uudelleenohjaa artikkelin otsikko toiseen sijoittamalla seuraavanlainen teksti sen ensimmäiselle sivulle. Huomaa, että sen jälkeen ei saa olla tekstiä, jotta uudelleenohjaus toimisi varmasti.

#REDIRECT [[Yhdysvallat]]

Linkki Wikipedian ulkopuolelle: Nupedia, [1]

Linkki Wikipedian ulkopuolelle: 
[http://www.nupedia.com Nupedia], [http://www.nupedia.com]

Tai anna suoraan URL: http://www.nupedia.com.

  • Tekee paperitulosteesta käyttökelpoisemman.

On olemassa erityinen tapa linkittää erikielisiä samaa aihetta käsitteleviä artikkeleita, katso Kieltenväliset linkit.

Tai anna suoraan URL: 
http://www.nupedia.com.
  • URL:ssä jokaisen merkin pitää kuulua seuraaviin: A-Z a-z 0-9 ._\/~%-+&#?!=()@ \x80-\xFF. Jos URL:ssä on muita merkkejä, ne on muutettava, esim. ^ pitää kirjoittaa %5E (Katso ASCII).

Kirjojen linkittämiseen voit käyttää ISBN-linkkejä. ISBN 0123456789X

ISBN 0123456789X

Linkit RFC-dokumentteihin: RFC 123

RFC 123

Kuva: Wikipedian logo

Kuva: [[Kuva:Wikipedia-logo-fi.png]]

tai mieluummin vaihtoehtoisella tekstillä

[[Kuva:Wikipedia-logo-fi.png|Wikipedian logo]] 
joka:
  • näkyy tekstipohjaisilla selaimilla (mm. Lynx)
  • 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 suorakaiteena, kun kursoria pidetään hetken aikaa kuvan päällä.
Tiedosto:Wikipedia-logo-fi.png
Hei, minä olen kuvateksti

Kuvan lisääminen tekstin oheen oikealle, kuvatekstin kera, onnistuu esimerkiksi näin.

  • Kuva ensin, sitten teksti.
[[Kuva:Wikipedia-logo-fi.png|frame|Hei, minä olen kuvateksti]]

Tallennetun kuvan klikkaaminen näyttää kuvauksen, johon voi myös linkittää suoraan: Kuva:Wikipedia-logo-fi.png


[[:Kuva:Wikipedia-logo-fi.png]]

Ääniin ja muihin (ei-kuva) tallenteisiin voi viitata "media"-linkillä. Samalla tavalla kuvat voi näyttää linkkeinä sen sijaan, että ne piirrettäisiin suoraan sivulle.


Ääni

Linkki kuvaan



[[media:Sg_mrob.ogg|Ääni]]

[[media:Tornado.jpg|Linkki kuvaan]]

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>

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

Taulukot

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

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

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
Tiedosto:Wikipedia-logo-fi.png Tiedosto: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>

Sisällysluettelon poisto

Sivuilla, joilla on ainakin neljä otsikkoa, luodaan artikkeliin automaattisesti sisällysluettelon. Jos tämä ei ole toivottavaa (esim. lyhyet artikkelit, luettelot), voit lisätä tekstin __NOTOC__ .

Muuttujia

Koodi Tulos
{{CURRENTMONTH}} 11
{{CURRENTMONTHNAME}} marraskuu
{{CURRENTMONTHNAMEGEN}} marraskuun
{{CURRENTMONTHABBREV}} marraskuu
{{CURRENTDAY}} 22
{{CURRENTDAYNAME}} perjantai
{{CURRENTYEAR}} 2024
{{CURRENTTIME}} 05.10
{{CURRENTWEEK}} 47
{{CURRENTDOW}} 5
{{NUMBEROFARTICLES}} 1 740
{{PAGENAME}} Koodiopas
{{PAGENAMEE}} Koodiopas
{{REVISIONID}} 1594
{{NAMESPACE}} Ohje
{{localurl:pagename}} /wiki/Pagename
{{localurl:Wikipedia:Sandbox|action=edit}} /mediawiki/index.php?title=Wikipedia:Sandbox&action=edit
{{SERVER}} http://xcalibur.cc.tut.fi
{{ns:1}} Keskustelu
{{ns:2}} Käyttäjä
{{ns:3}} Keskustelu käyttäjästä
{{ns:4}} ExcaliburWiki
{{ns:5}} Keskustelu ExcaliburWikistä
{{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}} ExcaliburWiki