Ohje:Muokkauspainikkeet

Muokkauspainikkeet ovat Wikipedian muokkaustilassa näkyviä painikkeita jotka avustavat Wikipediaa muokkaavia jos käyttäjän selain vain tukee JavaScript-komentosarjakieltä. Suomenkielisessä Wikipediassa on käytössä kolme aluetta näille painikkeille jotka ovat työkalupalkki, muokkauspalkki ja merkistöpalkki.

Työkalupalkki

Oletuksena ylärivin työkalupalkki sisältää seuraavat painonapit:

Nämä painikkeet allekirjoituspainiketta lukuun ottamatta ovat näkyvissä aina, ja allekirjoituspainike aina paitsi artikkelinimiavaruudessa.

Painikkeiden toiminnot:

• Lihavointi: lisää '''Teksti''' valitun tekstin ympärille
• Kursivointi: lisää ''Teksti'' valitun tekstin ympärille
• Sisäinen linkki: lisää [[Teksti]] valitun tekstin ympärille
• Ulkoinen linkki: lisää [Teksti] valitun tekstin ympärille
• Otsikko: lisää == Teksti == valitun tekstin ympärille
• Kuva: [[Kuva:Teksti]] valitun tekstin ympärille
• Mediatiedosto: lisää [[Media:Teksti]] valitun tekstin ympärille
• Matemaattinen kaava: lisää <math>Teksti</math> valitun tekstin ympärille
• Teksti, jota wiki ei muotoile: lisää <nowiki>Teksti</nowiki> valitun tekstin ympärille
• Allekirjoitus: lisää --~~~~ osoittimen kohdalle
• Vaakasuora viiva: lisää ---- osoittimen kohdalle

Työkalupalkin poistaminen

Rekisteröityneet käyttäjät voivat poistaa painikkeet näkyvistä lisäämällä omaan monobook.css-sivuunsa koodin:

#toolbar{ display: none; }

Omien painikkeiden lisäys työkalupalkkiin

Rekisteröityneet käyttäjät voivat lisätä omia painikkeita muokkaamalla omaa monobook.js-sivua. Painikkeita lisätään koodilla joka on muodoltaan:

if (mwCustomEditButtons) {
    mwCustomEditButtons[mwCustomEditButtons.length] = {
        "imageFile": "http://upload.wikimedia.org/wikipedia/commons/c/c8/"+
                     "Button_redirect.png",
        "speedTip": "Uudelleenohjaus",
        "tagOpen": "#OHJAUS [[",
        "tagClose": "]]",
        "sampleText": "Kohde"};
    mwCustomEditButtons[mwCustomEditButtons.length] = {
        "imageFile": "http://upload.wikimedia.org/wikipedia/commons/3/30/"+
                     "Btn_toolbar_rayer.png",
        "speedTip": "Yliviivaus",
        "tagOpen": "<s>",
        "tagClose": "</s>",
        "sampleText": "Yliviivattu teksti"};
   // mwCustomEditButtons...
}

Arvojen selitykset:

• imageFile: linkki kuvaan, kuvia yläpainikkeita varten löytää esimerkiksi commonsin Mediawiki-osiosta
• speedTip: selaimen alalaidassa ja/tai painikkeen vieressä näkyvä ohjeteksti osoittimen ollessa painikkeen päällä
• tagOpen: avauskoodi, eli koodi joka syötetään muokkaustilassa osoittimen kohtaan tai valinnan eteen
• tagClose: lopetuskoodi, eli koodi joka syötetään muokkaustilassa osoittimen kohtaan tai valinnan perään
• sampleText: teksti jota käytetään kun muokkaustilasta ei ole valittu mitään

Allekirjoitusnappi aina näkyviin

Rekisteröityneet käyttäjät voivat lisätä omaan monobook.css-sivuunsa koodin:

body.ns-0 img#mw-editbutton-signature { display: inline; }

Muokkauspalkki

Muokkauspalkki generoidaan lennosta JavaScriptillä. Mikäli selaimessa on JavaScript kytketty pois päältä, ei muokkauspalkkia tule lainkaan näkyviin. Internet Explorer -selaimen kanssa on raportoitu joitain yhteensopivuusongelmia. Muokkauspalkkia voi muokata vain ylläpitäjät ja sen lähdekoodi sijaitsee sivulla Järjestelmäviesti:Edittools.js.

Muokkauspalkki sijaitsee muokkaustilan alalaidassa, ja sisältää pudotusvalikon avulla näkyviä osa-alueita. Pudotusvalikossa on alueet:

• Artikkelinimiavaruudessa:
  • Yleiset: yleisiä artikkelipainikkeita (kuten täsmenne- ja tulevamallineet)
  • Viitteet: viitepainikkeet, sisarprojektien painikkeet sekä ulkoisten linkkien painikkeet
  • Tyngät: yleisimmät tynkäpainikkeet ja tynkäpainikkeet maanosille sekä tieteille
  • Ongelmat: artikkelin ongelmatilaa varten painikkeita tarkennuspyynnöille sekä mallineet ongelman ilmaisemiseen ja korjauspyynnöille
• Kaikissa nimiavaruuksissa:
  • Poistot: painike roskamerkinnälle sekä artikkelinimiavaruudessa merkittävyyspainikkeen ja kaikissa päänimiavaruuksissa (ei keskustelu) poistettaviin sivuihin lisäämistä varten mallineen
• Kaikissa paitsi artikkelinimiavaruudessa:
  • Keskustelu: käyttäjäkeskustelussa käyttäjävaroitukset, käyttäjähuomautukset, käyttäjäopastukset sekä rekisteröitymättömien käyttäjien huomautukset, lisäksi kaikissa paitsi artikkelinimiavaruudessa näkyy äänestyksissä käytetyt mallineet
  • Mallineet: mallinenimiavaruudessa mallineiden funktioissa käytetyt taulukkomallineet sekä mallineen ohjeistusmallineet, sekä kaikissa paitsi artikkelinimiavaruudessa oleva pikalinkitys mallineeseen
• Vain ylläpitäjille:
  • Ylläpitäjät: ylläpitäjän suojaus ja estonilmoitusmallineet
• Vain osoitepaljastajille:
  • Osoitepaljastajat: osoitepaljastajan ilmoitusmallineet tarkastuksesta sekä sukkanukeista

Muokkauspalkin vivut ja niiden selitykset

Muokkauspalkki sisältää joitakin vipuja joiden avulla voidaan kontrolloida palkin ja sen painikkeiden käyttäytymistä. Vivut tulee lisätä omaan monobook.js –tiedostoon seuraavasti:

var d   = new Date();
var Painikkeet = true;
var PainikkeetOmat = false;
var PainikkeetOletus = 0;
var PainikkeetTuleva = d.getFullYear() + '-' + (d.getMonth()+4) + '-' + d.getDate();
var PainikkeetViite = d.getDate() + "." + (d.getMonth()+1) + "." + d.getFullYear();
var PainikkeetVuosi = d.getFullYear();
var PainikkeetKeskustelu = null;
var PainikkeetAllekirjoitus = "–~~"+"~~";
var PainikkeetValikko = true;
var PainikkeetLyhyt = false;

var Painikkeet

Vipu jonka avulla kontrolloidaan kokonaisuudessaan painikkeiden näkyvyyttä

Oletusarvo: true

Vaihtoehdot: true, false

var PainikkeetOmat

Vipu jonka avulla voidaan ylikirjoittaa oletuspainikkeet

Oletusarvo: false

Vaihtoehdot: true, false

var PainikkeetOletus

Vipu jonka avulla voidaan päättää oletusvalikko (eli valikko joka aukeaa kun mikään esimääritellyistä ehdoista ei täyty)

Oletusarvo: 0

Vaihtoehdot: 0–8

var PainikkeetTuleva

Vipu jonka avulla voidaan kontrolloida tulevaisuusmallineiden oletusaika päättymisajaksi

Oletusarvo: nykyhetki + 3 kuukautta muodossa yyyy-mm-dd (esimerkiksi tänään tulos olisi 2026-03-27)

Vaihtoehdot: päiväys muodossa yyyy-mm-dd (esimerkiksi 2025-12-27)

var PainikkeetViite

Vipu jonka avulla voidaan säätää viitemallineiden viitattu –kentän ajan muotoa

Oletusarvo: nykyhetki muodossa j.n.Y (esimerkiksi tänään tulos olisi 27.12.2025)

Vaihtoehdot: päiväys käyttämässäsi muodossa (esimerkiksi 27.12.2025)

var PainikkeetVuosi

Vipu jonka avulla voidaan säätää vuosilukua

Oletusarvo: kuluva vuosi

Vaihtoehdot: haluamasi vuosi nelinumeroisena

var PainikkeetKeskustelu

Vipu jonka avulla säädetään keskusteluviestien "Lisää tarkkailulistaan" –toimintoa

Oletusarvo: null (jättää toiminnon rauhaan, eli pitää tarkkailtavat sivut tarkkailussa eikä lisää sivuja tarkkailulistaan)

Vaihtoehdot: true (lisää sivun aina tarkkailulistaan), false (poistaa aina sivun tarkkailulistalta)

var PainikkeetAllekirjoitus

Vipu jonka avulla säädetään allekirjoituksen ulkoasua

Oletusarvo: "–~~"+"~~"

Vaihtoehdot: vapaavalintainen allekirjoitus

var PainikkeetValikko

Vipu jonka avulla säädetään muokkauspainikekohtaisten valikoiden näkyvyyttä

Oletusarvo: true

Vaihtoehdot: true, false

var PainikkeetLyhyt

Vipu jonka avulla säädetään muokkauspainikekohtaisten valikoiden pituutta

Oletusarvo: false

Vaihtoehdot: true, false

Muokkauspalkin painikkeiden lisäys

Muokkauspalkkiin voi lisätä kolmenlaisia painikkeita: painikkeita jotka lisäävät halutun tekstin muokkaustilan alkuun, loppuun tai osoittimen kohtaan. Lisäksi painikkeita voi lisätä seuraaville alueille:

• Yleiset: fiwiki-yleiset-sekalaiset, fiwiki-yleiset-tulevat
• Viitteet: fiwiki-viitteet-artikkeliviitteet, fiwiki-viitteet-sisarprojektit, fiwiki-viitteet-ulkoisetlinkit
• Tyngät: fiwiki-tyngat-maanosat, fiwiki-tyngat-tieteet, fiwiki-tyngat-geneeriset
• Ongelmat: fiwiki-ongelmat-tarkennuspyynnot, fiwiki-ongelmat-ongelmat, fiwiki-ongelmat-korjaukset
• Poistot: fiwiki-poistot
• Keskustelu: fiwiki-keskustelu-kayttajavaroitukset, fiwiki-keskustelu-kayttajahuomautukset, fiwiki-keskustelu-kayttajaopastus, fiwiki-keskustelu-rekisteroitymattomat, fiwiki-keskustelu-aanestys
• Mallineet: fiwiki-mallineet
• Ylläpitäjät: fiwiki-yllapitajat

addSBeforeButton

Funktiolla addSBeforeButton lisätään painikkeet, joiden teksti lisätään muokkaustilan alkuun:

function buttons() {
    addSBeforeButton('{{subst:'+'Tt}} –~~'+'~~', 'TT', 'Tervetuloa Wikipediaan',
                     'fiwiki-keskustelu-kayttajaopastus', 'Tervetuloa Wikipediaan!', true);
}

initializebuttons()

Funktion parametrit ovat:

1. arvo, huomioithan että mallineen sisällytys vaatii '+' -katkaisun ja mallineen tavanomainen lopetus }'+'}
2. nimi, painikkeen nimi
3. ohjeteksti, painikkeen ohjeteksti
4. alue, alue jonne painike sijoitetaan (ks. yllä)
5. yhteenveto
6. lisäys tarkkailulistaan (huom: arvo false poistaa kohteen mahdolliselta tarkkailulistalta, jos painikkeen halutaan jättävän rauhaan tarkkailulistavalinta, ei tähän tule syöttää mitään arvoa)

addSAfterButton

Funktiolla addSAfterButton lisätään painikkeet, joiden teksti lisätään muokkaustilan loppuun:

function buttons() {
    addSAfterButton ('{{Tynkä/Biologia}'+'}', 'Biologia', 'Tynkä/Biologia',
                     'fiwiki-tyngat-tieteet', '[[:Luokka:Biologiatyngät|' +
                     'Biologiatynkä]]');
}

initializebuttons()

Funktion parametrit ovat:

1. arvo, huomioithan että mallineen sisällytys vaatii '+' -katkaisun ja mallineen tavanomainen lopetus }'+'}
2. nimi, painikkeen nimi
3. ohjeteksti, painikkeen ohjeteksti
4. alue, alue jonne painike sijoitetaan (ks. yllä)
5. yhteenveto
6. lisäys tarkkailulistaan (huom: arvo false poistaa kohteen mahdolliselta tarkkailulistalta, jos painikkeen halutaan jättävän rauhaan tarkkailulistavalinta, ei tähän tule syöttää mitään arvoa)

addFeatureButton

Funktiolla addFeatureButton lisätään painikkeet, joiden teksti lisätään muokkaustilan osoittimen kohtaan:

function buttons() {
    addFeatureButton('{{Anonyymi|', '}}', 'Käyttäjä', 'Anonyymi', 'Anonyymi',
                     'fiwiki-keskustelu-aanestys');
}

initializebuttons()

Funktion parametrit ovat:

1. aloitusarvo, eli arvo joka lisätään ennen osoitinta
2. lopetusarvo, eli arvo joka lisätään osoittimen jälkeen
3. oletusarvo, eli arvo joka lisätään ja korostetaan osoittimen kohtaan
4. nimi, painikkeen nimi
5. alue, alue jonne painike sijoitetaan (ks. yllä)

Merkistöpalkki

Merkistöpalkki sijaitsee muokkaustilan aivan alimmaisena, ja näkyy oletuksena kaikille käyttäjille. Merkistöpalkissa on alueet:

• Välimerkit erikoisemmille välimerkeille (kuten yhdysviivalle ja erilaisille matemaattisille symboleille)
• Allekirjoitus allekirjoituksen lisäämiseksi (ei artikkelinimiavaruudessa)
• Wiki MediaWikin erikoismerkinnöille (kuten linkeille, mallineille ja erinäisille erikoistageille)
• Symbolit erilaisille yleisille- ja matemaattisille symboleille
• Erikoismerkit sisältää käytetyimmät, aksenttimerkein varustetut aakkoset
• Kreikkalaiset aakkoset
• Kyrilliset aakkoset
• IPA

Merkistöpalkin poistaminen

Rekisteröityneet käyttäjät voivat poistaa merkistöpalkin käytöstä oman monobook.css-sivun kautta koodilla:

#editpage-specialchars { display: none; } /* Kaikki */
#edittools_main        { display: none; } /* Välimerkit */
#edittools_name        { display: none; } /* Allekirjoitus */
#edittools_wikimarkup  { display: none; } /* Wiki */
#edittools_symbols     { display: none; } /* Symbolit */
#edittools_characters  { display: none; } /* Erikoismerkit */
#edittools_greek       { display: none; } /* Kreikkalaiset aakkoset */
#edittools_cyrillic    { display: none; } /* Kyrilliset aakkoset */
#edittools_ipa         { display: none; } /* IPA */

Lisättyjen painikkeiden näkyvyyden rajoittaminen

Kaikkien lisättyjen painikkeiden näkyvyyttä voidaan rajoittaa samanlaisella, if-lauseeseen perustuvalla menetelmällä. MediaWiki sisältää oletuksena JavaScript-muuttujan wgNamespaceNumber, joka sisältää nimiavaruuden numeerisen arvon:

-2 Media

-1 Toiminnot

0 (artikkeli)

1 Keskustelu

2 Käyttäjä

3 Keskustelu käyttäjästä

4 Testwiki

5 Keskustelu Testwikistä

6 Tiedosto

7 Keskustelu tiedostosta

8 Järjestelmäviesti

9 Keskustelu järjestelmäviestistä

10 Malline

11 Keskustelu mallineesta

12 Ohje

13 Keskustelu ohjeesta

14 Luokka

15 Keskustelu luokasta

100

101

102

103

Erilaisia tekniikoita:

// Vain artikkelinimiavaruuden painike
if (wgNamespaceNumber == 0) {
    // Painikekoodi
}
// Ei artikkelinimiavaruuteen tätä painiketta
if (wgNamespaceNumber != 0) {
    // Painikekoodi
}
// Käyttäjäsivusta eteenpäin tämä painike
if (wgNamespaceNumber > 1) {
    // Painikekoodi
}
// Vain keskustelusivujen painike
if (wgNamespaceNumber % 2 == 1) {
    // Painikekoodi
}
// Ei keskustelusivuille tätä painiketta
if (wgNamespaceNumber % 2 == 0) {
    // Painikekoodi
}