Difference between revisions of "Manual:Extension/VisualEditor"

__HIDETITLE__
        
        
        <bs:bookshelf src="Book:User manual" />
        
        
        
        __TOC__
        
        
        
        ==What is VisualEditor?==
        
        
        
        '''VisualEditor'''  (also called WYSIWYG - what you see is what you get) is an editor you can use without having to enter special markup (like HTML, wiki tags). The editor bars resemble those of commonly used word processing programs.
        
        
        
        ==How to find the visual editor?==
        
        
        
        When you switch to the edit mode of an article, you will be presented with the wiki code at first. To activate the WYSIWYG editor, click on the following button:
        
        
        
        
        
        ::: [[File:Btn-Wikicode-WYSIWYG.png]]
        
        
        
        
        
        
        
        The article's text will now be displayed with its formatting. Above the input field, you can see a new toolbar:
        
        
        
        ::: [[Image:BlueSpice2-VisualEditor.png|thumb|none|700px|Screenshot: The WYSIWYG-Editor in BlueSpice]]
        
        
        
        ==The functions of the editor==
        
        
        
        The editor does exactly what you would expect from standard word processing programs: You mark the elements you want to change, and then choose the change, for example bold, from the toolbar. The change in formatting can be seen immediately. Hallo Welt! implements the WYSIWYG editor as an optional editor only so as not to restrict the variety of MediaWiki's design possibilities.
        
        
        
        ===Fundamental functions===
        
        
        
        {| border="0"
        
        |-
        
        ||'''Button'''
        
        ||'''Function'''
        
        |-
        
        ||[[File:Btn-WYSIWYG-Wikitext.png]]
        
        ||switch to editing using the wiki code
        
        |-
        
        ||[[File:Btn-WYSIWYG-Speichern.png]]
        
        ||save
        
        |-
        
        ||[[File:Btn-WYSIWYG-Rückgängig.png]][[File:Btn-WYSIWYG-Wiederholen.png]]
        
        ||undo; redo
        
        |-
        
        ||[[File:Btn-WYSIWYG-SuchenundErsetzen.png]]
        
        ||find and replace
        
        |-
        
        ||[[File:Btn-WYSIWYG-CopyandPaste.png]]
        
        ||paste as formatted text (e.g. from Word)
        
        |-
        
        ||[[File:Btn-WYSIWYG-Signatur.png]]
        
        ||insert signature
        
        |-
        
        ||[[File:Btn-WYSIWYG-InsertLink.png]]
        
        ||insert or edit link; you can find out how to insert links to any sites you want at the page [[Reference:InsertLink|InsertLink]].
        
        |-
        
        ||[[File:Btn-WYSIWYG-Link_entfernen.png]]
        
        ||remove link
        
        |-
        
        ||[[File:Btn-WYSIWYG-InsertMagic.png]]
        
        ||insert tags or MagicWords. More at [[Reference:InsertMagic|InsertMagic]]
        
        |-
        
        ||[[File:Btn-WYSIWYG-InsertImage.png]]
        
        ||insert image; the function [[InsertImage]] lets you upload and embed images.
        
        |-
        
        ||[[File:Btn-WYSIWYG-InsertFile.png]]
        
        ||insert file
        
        |-
        
        ||[[File:Btn-WYSIWYG-InsertCategory.png]]
        
        ||insert category; the feature [[Reference:InsertCategory|Insert Category]] gives you an overview of the categories which already exist and lets you assign them to the current article.
        
        |-
        
        ||[[File:Btn-WYSIWYG-CheckboxChecklist.png]]
        
        ||insert checkboxes or checklists
        
        |-
        
        ||[[File:Btn-WYSIWYG-Tabelle_einfügen.png]]
        
        ||insert table (also "table properties" and "delete table")
        
        |-
        
        ||[[File:Btn-WYSIWYG-Tabellenfunktionen.png]]
        
        ||insert row above, insert row below, delete this row; insert column to the left, insert column to the right, delete this column
        
        |-
        
        ||[[File:Btn-WYSIWYG-Fett.png]][[File:Btn-WYSIWYG-Kursiv.png]][[File:Btn-WYSIWYG-Unterstrichen.png]][[File:Btn-WYSIWYG-Durchgestrichen.png]]
        
        ||bold; cursive; underlined;
        
        |-
        
        ||[[File:Btn-WYSIWYG-Aufzählung.png]] [[File:Btn-WYSIWYG-Nummerierte_Liste.png]]
        
        ||list with bullet points; numbered list
        
        |-
        
        ||[[File:Btn-WYSIWYG-Einzug_verkleinern.png]][[File:Btn-WYSIWYG-Einzug_vergrößern.png]]
        
        ||decrease indent; increase indent
        
        |-
        
        ||[[File:Btn-WYSIWYG-Symbol.png]]
        
        ||insert special symbol
        
        |-
        
        ||[[File:Btn-WYSIWYG-Zeilenumbruch.png]]
        
        ||insert line break
        
        |-
        
        ||[[File:Btn-WYSIWYG-Formate.png]]
        
        ||headings; Inline; alignment(left; center; rigth); table (standard, sortable, greyscale); pre
        
        |-
        
        ||[[File:Btn-WYSIWYG-Überschriften.png|none|none]]
        
        ||define headings
        
        |-
        
        ||[[File:Btn-WYSIWYG-Schriftfarbe.png]]
        
        ||text color
        
        |-
        
        ||[[File:Btn-WYSIWYG-Formatierung_entfernen.png]]
        
        ||remove formatting
        
        |-
        
        ||[[File:Btn-WYSIWYG-Vollbild.png]]
        
        ||edit in full screen mode
        
        |}
        
        
        
        ===Working with tables===
        
        
        
        As uncomplicated as it may be for other formatting, wiki code is not ideal for tables. However, in the WYSIWYG editor, you can work with tables quickly and easily. Note that the majority of the buttons which deal with table formatting will only become active when a table is selected.
        
        
        
        ==Tips for working with the WYSIWYG editor==
        
        
        
        * The WYSIWYG editor makes it easier to work with tables and images, in particular. We recommend working with normal wiki tags when making or editing complex pages.
        
        * TinyMCE is a web editor and so cannot be guaranteed to work completely smoothly with desktop applications like, for example, Word. You will need to be tolerant and be pleased that the editor at least makes some of your work easier.
        
        * The editor can be activated by default by changing your settings under personal settings => BlueSpice => visual editor.
        
        
        
        ==Settings==
        
        
        
        * When BlueSpice is installed, VisualEditor is set as default editor. This means, every new registered user gets VísualEditor as default.
        
        * Every users can diable VisualEditor as default editor in his personal settings.
        
        * To change a setting for all users, a sysadmin has to change all settings with help of a script.
        
        
        
        ==See also==
        
        
        
        Our [[Reference:VisualEditor|reference page.]]