Ohje:Muokkauspainikkeet

Tätä artikkelia tai sen osaa on pyydetty kokonaan uudelleen kirjoitettavaksi. Voit auttaa Wikipediaa parantamalla artikkelia. Lisää tietoa saattaa olla keskustelusivulla. Tarkennus: Missä määrin ohjeet pätevät vector-teemaan? Päivitettävä, kuvakkeet vaihtuneet.

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.

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ää ] valitun tekstin ympärille
• Ulkoinen linkki: lisää valitun tekstin ympärille
• Otsikko: lisää == Teksti == valitun tekstin ympärille
• Kuva: ] valitun tekstin ympärille
• Mediatiedosto: lisää ] 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

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

#toolbar{ display: none; }

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 = {
        "imageFile": "http://upload.wikimedia.org/wikipedia/commons/c/c8/"+
                     "Button_redirect.png",
        "speedTip": "Uudelleenohjaus",
        "tagOpen": "#OHJAUS [[",
        "tagClose": "]]",
        "sampleText": "Kohde"};
    mwCustomEditButtons = {
        "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

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

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

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

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-07-13)

Vaihtoehdot: päiväys muodossa yyyy-mm-dd (esimerkiksi 2025-04-13)

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 13.4.2025)

Vaihtoehdot: päiväys käyttämässäsi muodossa (esimerkiksi 13.4.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

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

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)

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)

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 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

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 */

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
}