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

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

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

Muokkauspalkki

Rekisteröityneiden käyttäjien muokkauspalkki sijaitsee muokkaustilan alalaidassa, ja sisältää alasvetovalikon avulla näkyviä osa-alueita. Alasvetovalikossa 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

Muokkauspalkin poistaminen

Rekisteröityneet käyttäjät voivat poistaa muokkauspalkin käytöstä joko oman monobook.js-sivun kautta koodilla:

var Painikkeet = false;

tai oman monobook.css-sivun kautta koodilla:

#mw-editTools { display: none; }

Muokkauspalkin painikkeiden ylikirjoitus

Rekisteröityneet käyttäjät voivat ylikirjoittaa oletuspainikkeet lisäämällä omaan monobook.js-sivuun koodin:

var PainikkeetOmat = true;

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äen useiten käytetyt, 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 Keskustelu luokasta

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
}