Ohje:Muokkauspainikkeet

n · k · m


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 muokkaa

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 muokkaa

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 muokkaa

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 muokkaa

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

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

Muokkauspalkki muokkaa

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 muokkaa

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 2024-06-07)
Vaihtoehdot: päiväys muodossa yyyy-mm-dd (esimerkiksi 2024-03-07)
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 7.3.2024)
Vaihtoehdot: päiväys käyttämässäsi muodossa (esimerkiksi 7.3.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 muokkaa

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 muokkaa

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 muokkaa

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 muokkaa

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 muokkaa

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 muokkaa

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 muokkaa

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
}