Wikipedysta:Serdelll/brudnopis/Extra edit buttons


Wikipedysta:Serdelll/brudnopis/Extra edit buttons w encyklopedii

Z Wikipedii, wolnej encyklopedii < Wikipedysta:Serdelll‎ | brudnopis Przejdź do nawigacji Przejdź do wyszukiwania

Extra edit buttons allows the user to change the buttons on the top of the edit panel. The main features are:

  • Ability to add buttons to the toolbar. Extra Edit buttons makes a large number of extra buttons available to the user. Simply including the script will add a set of extra buttons to your toolbar.
  • The option to change the order of the buttons.
  • The option to remove the standard buttons
  • The option to include extra user defined buttons.
  • Popup dialog boxes to easily customise the markup code that is entered.

Spis treści

Supported Browsers | edytuj kod

I normally test Extra Edit buttons:

The code will normally be tweaked to ensured that it works fully on these browsers.

I may sometimes test on:

  • SeaMonkey (Windows XP SP2)
  • Firefox on Linux (Ubuntu).
  • Konqueror (Ubunutu)
  • Earlier version of IE

Users | edytuj kod

A list of users of XEB is kept at List of users. The list will be used to help contact interested parties in the event of new features/radical changes/problems. XEB will work whether or not you are on the list of users.

Installing | edytuj kod

Simple Install | edytuj kod

For extra edit page buttons, put the following code in your monobook.js, replacing "monobook" with the name of your skin, in all lowercase (using "standard" for Classic skin).

{{subst:js|User:MarkS/extraeditbuttons.js}} 

Once this has been done, refresh Wikipedia in your browser (select Refresh or Reload) and the new buttons will be available on your toolbar. You do not need to do anything further. If after using the extra edit buttons for some time you wish to alter the buttons available or the order of the buttons then please read the more detailed instructions below.

Customised Install | edytuj kod

rmEditButtons=['all']

To fully customise extra edit buttons then add the following code to your monobook.js, replacing "monobook" with the name of your skin, in all lowercase (using "standard" for Classic skin).

XEBOrder='A,B,C,D'; rmEditButtons=[1,2,3]; myButtons=[]; {{subst:js|User:MarkS/extraeditbuttons.js}} 

Note:

  • XEBOrder specifies which buttons to display and the order in which to display them
  • rmEditButtons lists the standard buttons to remove
  • myButtons lists extra buttons which you wish to use with extra edit buttons.

If you don't add one or more of these variables to your monobook.js then extra edit buttons will still work.

The buttons | edytuj kod

Extra edit buttons includes the buttons listed below. Those marked as standard are added to your toolbar if you install XEB. The remaining buttons can be included by using the XEBOrder option (see below).

You can also specify completely new buttons to be included using the myButtons option (see below).

By default only buttons with a "*" in the standard column are displayed. This is keeps the total number of buttons down and avoids showing the more complex buttons in the default arrangement. To show the extra (non-default) buttons or alter the order of the buttons are showed see the section below 'Changing the layout').


Reference Buttons | edytuj kod

The reference buttons come in two parts:

  1. Button 'R' (included by default) includes the basic reference tags
  2. Button 'R1','R2' and 'R3' allow you to build up a reference in parts. R1 starts a reference. R2 lets you add the reference material and 'R3' finishes the reference. You are likely to want all these buttons or none of them

Changing the layout: XEBOrder | edytuj kod

XEB displays the standard buttons in the order listed above automatically.

You can change the order of the buttons and which buttons are displayed by creating a Javascript variable XEBOrder. Set this variable equal to a string containing each button's code separated by commas. The order of the buttons in XEBOrder is the order they are displayed on the toolbar. For example:

XEBOrder="A,B,C,E,G,I1,I2,R1,R2,R4,T1,Y1,Y2,Z,AI,N"; document.write('<script type="text/javascript" src="' + 'http://en.wikipedia.org/w/index.php?title=User:MarkS/Extra edit buttons/dev.js' + '&action=raw&ctype=text/javascript&dontcountme=s"></script>'); 

Removing buttons: rmEditButtons | edytuj kod

rmEditButtons is an array which lists the index numbers of the standard english wikipedia buttons you wish to remove. For example:

rmEditButtons=[0,2] 

will remove buttons 0 and 2 from your toolbar.

rmEditButtons=['all'] 

will remove all the standard buttons from your toolbar. You may wish to use this option if you want to fully customise the toolbar and specify where the standard buttons appear in the toolbar.

rmEditButtons can only remove buttons that Wikipedia itself places on your toolbar. These buttons have numbered IDs. IF you wish to remove buttons from the default extra buttons supplied by XEB then you must use the XEBOrder variable and specify all the buttons you want XEB to add to your toolbar.

Standard Wikipedia buttons | edytuj kod

The Wikimedia software used to power Wikipedia provides 10 standard buttons. The English version of Wikipedia then provides a further 11 standard buttons. These 21 buttons are the default toolbar shown to users. XEB provides access to these buttons using numeric codes starting from 0 (so Bold is 0, Italic is 1). You can use these codes in two ways: (i) You can include them in XEBOrder to make a standard button appear somewhere else in the toolbar, (ii) You can use then in rmEditButtons to stop wikipedia displaying them. In this way you can customise the whole toolbar.

User defined buttons: myButtons | edytuj kod

XEB can also work with extra buttons created by the user. To do this you must define the myButtons variable in your monobook.js. The format of myButtons is:

myButtons={'_CODE1':['url1','Tooltip1','Before1','After1','Text1'], '_CODE1':['url2','Tooltip2','Before2','After2','Text2']}; 

where:

  • Code is a code for the button. You should place this code in XEBOrder to make your button appear on the toolbar. You can use any text you like. However, it is recommended that you start the code with an underscore to make sure it doesn't clash with any future standard XEB buttons. This must be in upper case letters.
  • URL is the full URL to the button image. You must enter the URL of the image on its own, rather than the Wikimedia page that describes the button, so use: http://upload.wikimedia.org/wikipedia/commons/f/f0/Bouton_Vandale0.png rather than http://commons.wikimedia.org/wiki/Image:Bouton_Vandale0.png
  • ToolTip is the popup tooltip that will appear when the mouse moves over the button.
  • Before is the text to insert before the current cursor location.
  • After is the text to place after the current cursor location.
  • Text is the text that is placed between before and after. If the user has selected text in the edit box when the button is pressed this selected text will be placed between before and after instead.


This example defines two extra buttons:

myButtons={'_ZZ':['http://upload.wikimedia.org/wikipedia/commons/e/e9/Button_headline2.png','Mark Test','Before','After','Middle'], '_ZA':['http://upload.wikimedia.org/wikipedia/commons/1/13/Button_enter.png','Mark2 Test','111','333','222']}; 

Pictures for myButtons | edytuj kod

This is the list of buttons we know of so far (the list below includes the standard buttons). Buttons used by the 'extra buttons' have captions. Please upload any new buttons you find to the commons:Category:ButtonToolbar and add them to the gallery below (in alphabetical image order, so we can find duplicates and easily know what is there). Buttons not in Commons cat are tagged as MOVE TO COMMONS (please upload them to Commons and remove the tag from the gallery). The list as of now may contain duplicates, images not upload to commons and images at commons not at category - please help fix it!

Popups | edytuj kod

From the 6 March 2007 XEB includes popups on a number of buttons. Popups are dialog boxes that float over the web page when you click on the button. The dialog boxes are to make it easier to customise in more detail the markup code that gets entered.

The popups currently available are:

Requests | edytuj kod

If you want something extra added or changed then you can:

  • Amend the code. Please note: If you amend the main code (User:MarkS/extraeditbuttons.js) then everybody who uses XEB will pick up the change at the same. For this reason you should test changes in a development version (see below) before amending the live code.
  • Leave a request on the talk page, ideally with the code you want added.

Changes | edytuj kod

Wikipedia has revised how it builds toolbar buttons. Wikipedia now seems to build its toolbar buttons through on onload event after the page has loaded. Extra edit buttons overrode this which stopped the buttons working. However, as the buttons are now loading after the page has loaded the extra edit buttons now have to be added first. The choice was either add the buttons before wikipedia's or add them on a separate line. I have gone for a separate line. I have removed all the original code which insert HTML into the toolbar and replaced it by filling in the javascript array wmCustomEditButtons. This seems to be the official way to do it and the resulting code is a lot neater.
  • June 26 2006 Added 4 extra buttons: template, category, reflink and references
  • October 13 2006 Complete rewrite of the code added. Ability to change the order of the buttons and which buttons are shown.
  • November 19 2006 Added tl button and updated two images.
  • December 13 2006 All toolbar buttons (XEB and standard buttons) are now fully customizable. Changes to the timing of when the buttons are setup. Users can now defined their own buttons. Ability to remove some or all of the standard buttons. Order of standard Wikipedia buttons can changed.
  • 6 March 2007 Major upgrade. XEB now features popups on some of the buttons. These display a dialog box to complete with parameters. The markup code then depends on the inserted text.
  • 8 March 2007. Quick update to fix a bug. It looks as if the order of items in the array which stores the mediaWiki standard buttons has changed. When these were copied to XEB then the URL of the image ended up as the popup text. This quick update copies the info a different way. The bug only affect people who reused the standard MediaWiki buttons elsewhere in the toolbar.
  • 28 April 2007. Update to the way text from popups is inserted into the page. This mainly affects IE which had problems putting the text in right place after Wikipedia's edit box had lost focus. Version: 3.1

Development Versions | edytuj kod

My test version can be found under User:MarkS/Extra edit buttons/dev.js. This version may or may not be different to the live version. You can use this version by updating your monobook.js to use the test version rather than the live version.

If trying out your own changes then you can use the test version or you may find it easier to take a copy of the live code and create a test version under your userpages. Change the reference in your monobook.js to this test version. Then try out your changes. Once your changes have been made and tested then either update the live code or ask me. Note: When I update the live version I usually test in IE7, Opera and Firefox (Windows versions).

Installing XEB on your own Wiki | edytuj kod

Installing XEB on setups other than Wikipedia is not something that is supported. However, the steps may help:

  1. You will need your own setup of the MediaWiki software. This is not something I can help you with. However, I have used meta:Wiki on a stick and found it easy to setup. I have also installed XEB on it.
  2. You must enable users to run Javascript by setting $wgAllowUserJS to true in LocalSettings.php (see: [1])
  3. For the simplest install create a user called MarkS (or see below at 6).
  4. Copy the XEB script from User:MarkS/extraeditbuttons.js to the same location on your wiki
  5. Copy the XEB css from User:MarkS/XEB/live.css to the same location on your wiki
  6. Get users to include the script by editing their monobook.js. (Note: The easiest way to do this without creating a user MarkS is adding an accordant line in [MonoBook].php (the php of your skin)!) You might be able to do this the same way that it works on Wikipedia (see the top of this article). Alternatively use the following lines (changing the URL as necessary):

document.write('<script type="text/javascript" src="' + 'http://en.wikipedia.org/w/index.php?title=User:MarkS/extraeditbuttons.js' + '&action=raw&ctype=text/javascript&dontcountme=s"></script>'); 

7. Once the script is running you should move the images from MediaWiki to your own wiki.

There may be other ways to install the script. For example it could be installed in common.js which would provide the script to all users. I have never tried this.

Credits | edytuj kod

  • Brian0918 who supplied the code to English Wikipedia from Hebrew Wikipedia
  • Ingoolemo for supply the code for four of the buttons and the original GIF images (which I converted to PNG)
  • Olliminatore for supplying a major rewrite of the code producing something significantly shorter and simpler
  • Karl Dickman for converting some GIF images to PNG images

Category:Wikipedia scripts

de:User:Olliminatore/Extra-Editbuttons es:User:Axxgreazz/Monobook-Suite/Botonera


Die Extra-Editbuttons

Das Extra-Editbuttons-Helferlein fügt einige Extra-Editbuttons zur oberen Bearbeitungswerkzeugleiste hinzu, um einen einfachen Zugriff auf weitere Formatierungs-Optionen (der Wikimedia-Software) zu haben.

Schnell-Installation: Man geht auf Spezial:Einstellungen in den Karteireiter „Gadgets“, setzt im Abschnitt „Bearbeitungswerkzeuge“ den Haken vor „Extra-Editbuttons-Helferlein“ und geht auf „Einstellungen speichern“.

Installation | edytuj kod

Installation in Wikipedia | edytuj kod

Man muss unter einem Wikipedia-Benutzerkonto angemeldet sein, um dieses Helferlein verwenden zu können. Hier kann man ein solches Konto anlegen und sich anmelden.

Der nächste Schritt ist es auf Spezial:Einstellungen in den Karteireiter „Gadgets“ zu gehen, dort im Abschnitt „Bearbeitungswerkzeuge“ den Haken vor „Extra-Editbuttons-Helferlein“ zu setzen und anschließend auf „Einstellungen speichern“ zu klicken. Davon ausgegangen, dass JavaScript im Browser nicht deaktiviert ist, sollten ab jetzt abhängig vom Kontext der Seite die zusätzlichen Karteireiter zu sehen sein.

Um das Skript zu deinstallieren, entfernt man einfach den Haken in den Einstellungen und speichert diese ab.

Installation in anderen Wikimediawikis | edytuj kod

Will man das Script auf Commons, dem Wiktionary oder auch in anderen Sprachversionen der Wikipedia verwenden fügt man dort einfach auf seiner monobook.js-Seite (oder ersetzt je nach Skin-Einstellung den Namen „monobook“) folgenden Textbaustein ein:

// [[:de:MediaWiki:Gadget-Extra-Editbuttons.js]] – diese Zeile bitte mitkopieren document.write('<script type="text/javascript" src="http://de.wikipedia.org/w/index.php?title=' + 'MediaWiki:Gadget-Extra-Editbuttons.js&action=raw&ctype=text/javascript&dontcountme=s"><\/script>'); 

Falls man den kompletten Code direkt übernehmen und anpassen will kann man ihn unter MediaWiki:Gadget-Extra-Editbuttons.js finden.

Anpassung über Parameter | edytuj kod

Über diverse Parameter, welche in der eigenen monobook.js (oder anderen Skriptseite) gesetzt werden können, kann man die Anzahl und die Reihenfolge der Buttons neben anderen Dingen verändern. Hier nun eine Beispielkonfiguration:

// Anzahl und Reihenfolge wählbar (siehe: [[Wikipedia:Helferlein/Extra-Editbuttons#Die Buttons]]) var customEditButtons = "A,A3,B,C,E,F,G,H,I,I1,I2,J1,K,M,O,P,PO,Q,R,R1,R2,R3,S,T,T1,U,V,W,X,Y1,Y2,VP,VC,VN,SM"; // zu entfernende Standard-Edit buttons (0...10) var rmEditButtons = [6,7,10]; // Standardbutton entfernen var myButtons = {} // eigene Buttons? // (Signaturvariante 1: sinnvoll bei unter "Einstellungen" typografisch angepassten Signaturen) // var usersignature = '\~\~\~\~'; // (Signaturvariante 2: Datum kleiner, kein Zeilenumbruch nach dem Leerzeichen) var usersignature = '--&nbsp;\~\~\~&nbsp;<small>\~\~\~\~\~<\/small>'; // (Wiki-Standard-Signatur, bitte das Leerzeichen nach den zwei Strichen beachten) // var usersignature = '-- \~\~\~\~'; 

Es sind also genau 4 mögliche also optionale Parameter. Die standardmäßige Liste der Buttons ist in Anzahl und Reihenfolge (momentan) wie folgt (in dem Parameter customEditButtons) benannt, welche später individuell angepasst werden kann, siehe die Liste aller Buttons weiter unten:

customEditButtons = "A,A3,B,E,F,G,H,I1,I2,J1,K,M,Q,R,R1,R2,R3,S,T,U,V,W,X"; // oder:

customEditButtons = "all"; // für alle Buttons.

  • Für rmEditButtons s. unten.
  • Für myButtons s. unten.
  • Für usersignature wird einfach nur die Standard-Signatur ersetzt.

Die Buttons | edytuj kod

Standardbuttons | edytuj kod

0 = Fetter Text (bold), 1 = Kursiver Text, 2 = Interner Link, 3 = Externer Link, 4 = Überschrift (Level 2) , 5 = imagelink, 6 = Mediendatei-Link, 7 = Mathematische Formel, 8 = Unformatierter Text (nowiki), 9 = Signatur, 10 = Waagrechte Linie

Ausschluss

Mit dem Parameter var rmEditButtons = [6,7,10] können beliebig nicht benötigte Standard-Editbuttons entfernt werden. Diese werden mittels Indexzahl von 0 bis 10 angewählt. Mit var rmEditButtons = ['all'] können alle entfernt werden.

Umsortieren

Die Standardbuttons können nun ebenfalls in ihrer Position mit den (neuen) Custombuttons beliebig vermischt werden. Diese werden dann ebenfalls einfach mit den Indexzahlen (ihrer normalen Reihenfolge 0-10) in der customEditButtons angesprochen. Dabei ist nicht zu vergessen diese über rmEditButtons zu entfernen (s. kurz vorher: Ausschluss).

Die Extraeditbuttons umfassen alle nachstehend aufgeführten Buttons. Die, die als Standard gekennzeichnet sind, werden deiner Bearbeitungswerkzeugleiste hinzugefügt, wenn du es ohne Parameter aktivierst. Die übrigen Buttons können eingefügt werden, indem der Parameter customEditButtons verwendet wird (s. oben).

Du kannst auch vollständig neue Buttons definieren, die über den Parameter myButtons eingefügt werden (s. unten).

Die Standard-Version der Extrabuttons enthält nicht alle diese Buttons. Nur die mit einem "*" in der Standard-Spalte gekennzeichneten, werden im Defaultmodus angezeigt (welche jedoch dennoch alle über den Parameter customEditButtons = "ALL" eingefügt werden können). Dies ist zum Teil, um die Gesamtzahl der Buttons klein zu halten, und teils, um zu vermeiden, dass die „komplizierteren“ (bzw. seltener benötigten) in der Standard-Anordnung mit angezeigt werden.

Benutzerdefinierte Buttons | edytuj kod

Es ist ebenfalls möglich, vollkommen eigene benutzerdefinierte Extrabuttons, über einen Parameter hinzuzufügen. Um dies zu tun, musst du den Parameter myButtons (ebenfalls in deiner monobook.js) im folgenden Format definieren:

var myButtons={'code1':['url1','Tooltip1','Before1','After1','Text1'], 'code2':['url2','Tooltip2','Before2','After2','Text2']}; 

(Bedeutung:

  • Code ist eine interne Bezeichnung für den Button. Diese Bezeichnung muss auch in der Variable XEBOrder eingefügt werden, damit der Button auch in der Werkzeugleiste erscheint. Man kann jeden beliebigen Namen als Bezeichnung verwenden. Um Namenskonflikte mit bestehenden und künftigen beeits definierten Buttons zu vermeiden, sollte man den Namen aber mit einem _ anfangen.
  • URL ist die URL des Buttonimagees. Die URL des imagees, nicht die imagebeschreibungsseite, muss hierzu angegeben werden, also bspw.: http://upload.wikimedia.org/wikipedia/commons/f/f0/Bouton_Vandale0.png statt http://commons.wikimedia.org/wiki/Image:Bouton_Vandale0.png
  • ToolTip ist der Hinweis, der erscheint, wenn man die Maus über den Button bewegt.
  • Before ist der Text, welcher vor der aktuellen Cursorposition eingefügt wird, wenn man auf den Button klickt.
  • After ist der Text, welcher nach der aktuellen Cursorposition eingefügt wird, wenn man auf den Button klickt.
  • Text ist der Text, welcher in die Mitte der beiden obigen Textstücke gesetzt wird, wenn man auf den Button klickt. Falls man im Eingabefeld Text ausgewählt hat, so werden beim Klicken auf den Button die beiden obigen Textstücke vor und hinter diesen ausgewählten Text eingefügt.

Dieses Beispiel definiert zwei Extrabuttons:

var myButtons={'_ZZ':['http://upload.wikimedia.org/wikipedia/commons/e/e9/Button_headline2.png','Mark Test','Before','After','Middle'], '_ZA':['http://upload.wikimedia.org/wikipedia/commons/1/13/Button_enter.png','Mark2 Test','111','333','222']}; 

Bitte lade alle neuen imageer für die Buttons auf Commons:Category:ButtonToolbar hoch.

Installation in ein eigenes Wiki | edytuj kod

  1. Zuerst vergewissere man sich, ob JavaScript für Benutzer aktiviert ist, durch die Einstellung $wgAllowUserJS = true in LocalSettings.php (siehe: Manual:$wgAllowUserJs).
  2. Kopiere das Extraeditbuttonsskript von MediaWiki:Gadget-Extra-Editbuttons.js nach MediaWiki:Common.js (im eigenen Wiki)
  3. Oder wende einfach die „#Installation in anderen Wikimediawikis“ an.
  4. Noch ein Beispiel, wie es schlicht ohne Parameter geht wikt:MediaWiki:Onlyifediting.js

All dies ist ohne Gewähr und Testlauf. Über dementsprechendes Feedback würde sich der Autor freuen.

ToDo | edytuj kod

Fehlerbehebung/FAQ/Feedback | edytuj kod

Falls der Fehler: bc has no properties auftritt, wurde ein falscher Buttonname eingetragen.

Für weitere Fragen und Probleme steht die Diskussionseite zur Verfügung. Bugs und Fehler zu dem Helferlein können an den Programmautor MarkS (auf Englisch) berichtet werden, die deutsche Übersetzung wird von Olliminatore betreut.

Extra edit buttons

en:User:MarkS/Extra_edit_buttons es:User:Axxgreazz/Monobook-Suite/Botonera pt:Wikipedia:Software/Scripts/Botões extra de edição


Na podstawie artykułu: "Wikipedysta:Serdelll/brudnopis/Extra edit buttons" pochodzącego z Wikipedii
OryginałEdytujHistoria i autorzy