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 2025-03-03); Vaihtoehdot: päiväys muodossa yyyy-mm-dd (esimerkiksi 2024-12-03)
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 3.12.2024); Vaihtoehdot: päiväys käyttämässäsi muodossa (esimerkiksi 3.12.2024)
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:

arvo, huomioithan että mallineen sisällytys vaatii ' ' -katkaisun ja mallineen tavanomainen lopetus }' '}
nimi, painikkeen nimi
ohjeteksti, painikkeen ohjeteksti
alue, alue jonne painike sijoitetaan (ks. yllä)
yhteenveto
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:

arvo, huomioithan että mallineen sisällytys vaatii ' ' -katkaisun ja mallineen tavanomainen lopetus }' '}
nimi, painikkeen nimi
ohjeteksti, painikkeen ohjeteksti
alue, alue jonne painike sijoitetaan (ks. yllä)
yhteenveto
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:

aloitusarvo, eli arvo joka lisätään ennen osoitinta
lopetusarvo, eli arvo joka lisätään osoittimen jälkeen
oletusarvo, eli arvo joka lisätään ja korostetaan osoittimen kohtaan
nimi, painikkeen nimi
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 Wikipedia

5 Keskustelu Wikipediasta

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 Teemasivu

101 Keskustelu teemasivusta

102 Metasivu

103 Keskustelu metasivusta

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
}