Lähdekoodi sivulle Ohje:Muokkauspainikkeet

{{WPManuaalipystynavi|ohjeet}}

{{Uudelleenkirjoitettava|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''.

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

[[Kuva:Toolbar.PNG]]

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

Painikkeiden toiminnot:
* [[Kuva:Bold icon.png]] Lihavointi: lisää <tt><nowiki>'''Teksti'''</nowiki></tt> valitun tekstin ympärille
* [[Kuva:Italic icon.png]] Kursivointi: lisää <tt><nowiki>''Teksti''</nowiki></tt> valitun tekstin ympärille
* [[Kuva:Button_link.png]] Sisäinen linkki: lisää <tt><nowiki>[[Teksti]]</nowiki></tt> valitun tekstin ympärille
* [[Kuva:External link icon.png]] Ulkoinen linkki: lisää <tt><nowiki>[Teksti]</nowiki></tt> valitun tekstin ympärille
* [[Kuva:Headline icon.png]] Otsikko: lisää <tt><nowiki>== Teksti ==</nowiki></tt> valitun tekstin ympärille
* [[Kuva:Image icon.png]] Kuva: <tt><nowiki>[[Kuva:Teksti]]</nowiki></tt> valitun tekstin ympärille
* [[Kuva:Media icon.png]] Mediatiedosto: lisää <tt><nowiki>[[Media:Teksti]]</nowiki></tt> valitun tekstin ympärille
* [[Kuva:Math icon.png]] Matemaattinen kaava: lisää <tt><nowiki><math>Teksti</math></nowiki></tt> valitun tekstin ympärille
* [[Kuva:Nowiki icon.png]] Teksti, jota wiki ei muotoile: lisää <tt><nowiki>&lt;nowiki&gt;Teksti&lt;/nowiki&gt;</nowiki></tt> valitun tekstin ympärille
* [[Kuva:Signature icon.png]] Allekirjoitus: lisää <tt><nowiki>--~~~~</nowiki></tt> osoittimen kohdalle
* [[Kuva:H-line icon.png]] Vaakasuora viiva: lisää <tt><nowiki>----</nowiki></tt> osoittimen kohdalle

=== Työkalupalkin poistaminen ===
Rekisteröityneet käyttäjät voivat poistaa painikkeet näkyvistä lisäämällä [[Toiminnot:Oma sivu/monobook.css|omaan monobook.css]]-sivuunsa koodin:

<syntaxhighlight lang="CSS">
#toolbar{ display: none; }
</syntaxhighlight>


=== Omien painikkeiden lisäys työkalupalkkiin ===
Rekisteröityneet käyttäjät voivat lisätä omia painikkeita muokkaamalla [[Toiminnot:Oma sivu/monobook.js|omaa monobook.js]]-sivua. Painikkeita lisätään koodilla joka on muodoltaan:

<syntaxhighlight lang="JavaScript">
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...
}
</syntaxhighlight>

Arvojen selitykset:
* '''imageFile''': linkki kuvaan, kuvia yläpainikkeita varten löytää esimerkiksi [[:commons:Mediawiki edit toolbar|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ä [[Toiminnot:Oma sivu/monobook.css|omaan monobook.css]]-sivuunsa koodin:

<syntaxhighlight lang="CSS">
body.ns-0 img#mw-editbutton-signature { display: inline; }
</syntaxhighlight>

== 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ä [[Toiminnot:Oma sivu/monobook.js|omaan monobook.js]] –tiedostoon seuraavasti:

<syntaxhighlight lang="JavaScript">
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;
</syntaxhighlight>

;'''var Painikkeet''': Vipu jonka avulla kontrolloidaan kokonaisuudessaan painikkeiden näkyvyyttä
:'''Oletusarvo''': <tt>true</tt>
:'''Vaihtoehdot''': <tt>true</tt>, <tt>false</tt>
;'''var PainikkeetOmat''': Vipu jonka avulla voidaan ylikirjoittaa oletuspainikkeet
:'''Oletusarvo''': <tt>false</tt>
:'''Vaihtoehdot''': <tt>true</tt>, <tt>false</tt>
;'''var PainikkeetOletus''': Vipu jonka avulla voidaan päättää oletusvalikko (eli valikko joka aukeaa kun mikään esimääritellyistä ehdoista ei täyty)
:'''Oletusarvo''': <tt>0</tt>
:'''Vaihtoehdot''': <tt>0–8</tt>
;'''var PainikkeetTuleva''': Vipu jonka avulla voidaan kontrolloida [[:Luokka:Tulevaisuusmallineet|tulevaisuusmallineiden]] oletusaika päättymisajaksi
:'''Oletusarvo''': nykyhetki + 3 kuukautta muodossa <tt>yyyy-mm-dd</tt> (esimerkiksi tänään tulos olisi <tt>{{#time:Y-m-d|now + 3 months}}</tt>)
:'''Vaihtoehdot''': päiväys muodossa <tt>yyyy-mm-dd</tt> (esimerkiksi <tt>{{#time:Y-m-d}}</tt>)
;'''var PainikkeetViite''': Vipu jonka avulla voidaan säätää [[:Luokka:Viitemallineet|viitemallineiden]] ''viitattu'' –kentän ajan muotoa
:'''Oletusarvo''': nykyhetki muodossa j.n.Y (esimerkiksi tänään tulos olisi <tt>{{#time:j.n.Y}}</tt>)
:'''Vaihtoehdot''': päiväys käyttämässäsi muodossa (esimerkiksi <tt>{{#time:[[j. F\t\a|j.n.]][[Y]]}}</tt>)
;'''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''': <tt>null</tt> (jättää toiminnon rauhaan, eli pitää tarkkailtavat sivut tarkkailussa eikä lisää sivuja tarkkailulistaan)
:'''Vaihtoehdot''': <tt>true</tt> (lisää sivun aina tarkkailulistaan), <tt>false</tt> (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''': <tt>true</tt>
:'''Vaihtoehdot''': <tt>true</tt>, <tt>false</tt>
;'''var PainikkeetLyhyt''': Vipu jonka avulla säädetään muokkauspainikekohtaisten valikoiden pituutta
:'''Oletusarvo''': <tt>false</tt>
:'''Vaihtoehdot''': <tt>true</tt>, <tt>false</tt>

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

<syntaxhighlight lang="JavaScript">
function buttons() {
    addSBeforeButton('{{subst:'+'Tt}} –~~'+'~~', 'TT', 'Tervetuloa Wikipediaan',
                     'fiwiki-keskustelu-kayttajaopastus', 'Tervetuloa Wikipediaan!', true);
}

initializebuttons()
</syntaxhighlight>

Funktion parametrit ovat:
# '''arvo''', huomioithan että mallineen sisällytys vaatii <tt>'+'</tt> -katkaisun ja mallineen tavanomainen lopetus <tt>}'+'}</tt>
# '''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:

<syntaxhighlight lang="JavaScript">
function buttons() {
    addSAfterButton ('{{Tynkä/Biologia}'+'}', 'Biologia', 'Tynkä/Biologia',
                     'fiwiki-tyngat-tieteet', '[[:Luokka:Biologiatyngät|' +
                     'Biologiatynkä]]');
}

initializebuttons()
</syntaxhighlight>

Funktion parametrit ovat:
# '''arvo''', huomioithan että mallineen sisällytys vaatii <tt>'+'</tt> -katkaisun ja mallineen tavanomainen lopetus <tt>}'+'}</tt>
# '''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:

<syntaxhighlight lang="JavaScript">
function buttons() {
    addFeatureButton('{{Anonyymi|', '}}', 'Käyttäjä', 'Anonyymi', 'Anonyymi',
                     'fiwiki-keskustelu-aanestys');
}

initializebuttons()
</syntaxhighlight>

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ä [[Toiminnot:Oma sivu/monobook.css|oman monobook.css]]-sivun kautta koodilla:

<syntaxhighlight lang="CSS">
#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 */
</syntaxhighlight>

== 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 <tt>wgNamespaceNumber</tt>, joka sisältää nimiavaruuden numeerisen arvon:

:-2 {{ns:-2}}
:-1 {{ns:-1}}
:0 (artikkeli)
:1 {{ns:1}}
:2 {{ns:2}}
:3 {{ns:3}}
:4 {{ns:4}}
:5 {{ns:5}}
:6 {{ns:6}}
:7 {{ns:7}}
:8 {{ns:8}}
:9 {{ns:9}}
:10 {{ns:10}}
:11 {{ns:11}}
:12 {{ns:12}}
:13 {{ns:13}}
:14 {{ns:14}}
:15 {{ns:15}}
:100 {{ns:100}}
:101 {{ns:101}}
:102 {{ns:102}}
:103 {{ns:103}}

Erilaisia tekniikoita:

<syntaxhighlight lang="JavaScript">
// 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
}
</syntaxhighlight>

[[Luokka:Ohjeet|{{PAGENAME}}]]