Help:VeesualEediter/Uiser guide

From MediaWiki.org
Jump to: navigation, search
This page is a translated version of the page Help:VisualEditor/User guide and the translation is 89% complete.

Other languages:
العربية • ‎asturianu • ‎azərbaycanca • ‎Bikol Central • ‎беларуская (тарашкевіца)‎ • ‎български • ‎বাংলা • ‎bosanski • ‎català • ‎Cebuano • ‎čeština • ‎Cymraeg • ‎dansk • ‎Deutsch • ‎Zazaki • ‎Emiliàn • ‎Ελληνικά • ‎emiliàn e rumagnòl • ‎English • ‎British English • ‎Esperanto • ‎español • ‎eesti • ‎فارسی • ‎suomi • ‎føroyskt • ‎français • ‎Frysk • ‎galego • ‎עברית • ‎हिन्दी • ‎Fiji Hindi • ‎hrvatski • ‎magyar • ‎Հայերեն • ‎Bahasa Indonesia • ‎Interlingue • ‎Ilokano • ‎italiano • ‎日本語 • ‎Basa Jawa • ‎ქართული • ‎ភាសាខ្មែរ • ‎ಕನ್ನಡ • ‎한국어 • ‎Lëtzebuergesch • ‎lietuvių • ‎latviešu • ‎Malagasy • ‎македонски • ‎മലയാളം • ‎मराठी • ‎Bahasa Melayu • ‎Napulitano • ‎norsk bokmål • ‎Nederlands • ‎Oromoo • ‎ଓଡ଼ିଆ • ‎Picard • ‎polski • ‎پښتو • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎Scots • ‎slovenčina • ‎slovenščina • ‎српски / srpski • ‎Basa Sunda • ‎svenska • ‎தமிழ் • ‎ไทย • ‎Tagalog • ‎Türkçe • ‎татарча/tatarça • ‎українська • ‎Tiếng Việt • ‎isiXhosa • ‎ייִדיש • ‎中文
PD Note: When you edit this page, you agree to release your contribution under the CC0. See Public Domain Help Pages for more info.
PD
If you would like to try VisualEditor without editing an article, here is a page where you can freely do so.
You don't need an account to use it.

Apenin VeesualEediter[edit | edit source]


Tae eedit ae page uisin VeesualEediter, clap oan the "Edit" tab at the tap o the page.

It can tak ae few seiconts fer the page tae apen fer eeditin, n langer gif the page is awfa lang.

Clapin oan the "Edit source" tab will apen the classeec wikitex soorce eediter.

VisualEditor - Edit tab.png

Foreby, ye can apen VeesualEediter bi clapin oan the "edit" link oan ilka section.
VisualEditor - Section edit links.png


Gettin stairtit: the VeesualEediter tuilbaur[edit | edit source]


The VeesualEediter tuilbaur
The VeesualEediter tuilbaur kiths at the tap o the screen whan ye begin eeditin throoch VeesualEediter. It incluids some fameeleear icons:

VisualEditor - Toolbar - Undo-redo.png
Undo n Redo the chynges that ye'v dun.

VisualEditor Toolbar Headings-en.png
Heidins pul-doon menu: permits ye tae chynge the heider level o tex. The staundairt section heidins ar "Heading".

VisualEditor - Toolbar - Formatting.png
Formattin: Clapin oan the "A" apens ae submenu.
  • The "Bold" icon (B) bauds the selectit tex.
  • The "Italic" icon (I) italeecises the selectit tex.
  • The "Subscript" icon (S2) causes the selectit tex tae kith smawer than the surroondin tex n slichtlie ablo the line.
  • The "Superscript" icon (S2) causes the selectit tex tae kith smawer than the surroondin tex n slichtlie abuin the line.
  • The "Strikethrough" icon (S) eiks ae solid baur throoch the selectit tex.
  • The "Computer code" icon (ae set o curlie brackets: {}) chynges the font displey in the selectit tex til ae monospaced font, tae mak it kenspeackle fae the surroondin tex.
  • The "Underline" icon (U) adds ae solid line aneath the selectit tex.
  • The laist icon ("Clear styling") remuivs whitever formattin is nou applied til the selectit tex.

VisualEditor - Toolbar - Linking.png
Airtin tuil: The chain is the airtin tuil.

VisualEditor - Cite Pulldown.png
Cite menu: The cite menu offers quick access to some of the more familiar citation templates. It is not available on all MediaWiki projects yet and must be enabled.

(Instructions to add the cite menu to a specific wiki are available at VisualEditor/Citation tool.)


VisualEditor Toolbar Lists and indentation-en.png
Leets & indentation: The first twa icons permit ye tae cræft nummert or bullet leets, respecteevelie. The laist twa permit ye tae mak muckler or smawer the indentation level o content.

VisualEditor insert menu 16 February 2014.png
Insert: The "Insert" puldoon oan the VeesualEediter tuilbaur leads til several addeetional optional actions, incluidin eikin referances n transcluidin templates. The "Insert" puldoon micht be differant oan some waurks. Ablo is ae leet o aw opties that micht kith.
  • The "Media" icon (ae pictur o moontains) apens the media dialog.
  • The "Gallery" icon (ae set o photæs) Permits ye tae insert ae gallerie oantil the page.
  • The "References list" icon (three buiks) apens ae dialog tae displey referances.
  • The "template" icon (ae puzzle piece) permits ye tae eedit templates.
  • The "formula" icon (Σ) permits ye tae enter the formula inserter. (See ablo.)
  • The "hierogleepheecs" icon (aen ankh) permits ye tae enter the hierogleepheecs inserter. (See ablo.)
  • The "Language" icon (The letter A in the Latin alphabet n Japanese kana (あ)) switches leid n directionalitie. (See ablo.)
  • The "Special character" icon (Ω) permits ye tae insert some byordinair chairacters. (See ablo.)

VisualEditor - Toolbar - SpecialCharacters.png
Special character insertion: The "Special character" icon permits yae tae summin ae subwindae wi ae nummer o byordinar chairachters that ye can steid intil the tex. Thir incluid some staundairt simbils, accents n mathemateecal simbils.

VisualEditor - Cancel and Save buttons.png
The Page opties is nex til the buttons that permit ye tae Cancel or hain yer chynges. Unner Page opties ar nou opties tae adjust page settins lik whather it's ae reguidal, or hou it's indexed, eeditin categeries n leetin leid airtins uisin the "Language" (The letter A in the Latin alphabet n Japanese kana (あ)). Ye can switch yin-waa fae VeesualEediter til the classeec wikitex soorce eediter aes weel.


Hainin chynges[edit | edit source]


Whan ye'r dun eeditin clap the green "Save page" button in the tuilbaur. The green button canna be clapt gif nae chynges were dun.
VisualEditor - Cancel and Save buttons.png

Pressing the green "Save page" button opens a small dialog into which you can enter a brief summary of your actions, mark your edit as minor, and choose to watch future edits to the page. The box for the summary is the equivalent of the Summary (?): field in the wikitext editor.

The number indicates how much space is left in your edit summary. You can also review your changes to be sure they work as intended before saving your changes, similar to the Show changes button in the wikitext editor.

New VE save dialog.jpg


Eeditin airtins[edit | edit source]


VisualEditor - Toolbar - Linking.png
Airtins can be eikit throoch the "Link" icon (airtins in ae chain) in the tuilbaur, or bi uisin the shortcut  Ctrl+K (or  Command+K oan ae Mac).

Gif ye select tex or place yer curser oan ae waird, pressin the "Link" button will insert ae link oan that tex.


VisualEditor - Link editing inline 2.png
Whather ye uise the button or the shortcut, ae dialog will apen, whaur in ye can type the airtin. VeesualEediter will ettle tae heelp wi internal airtins (airtins til ither pages o Wikipædia) bi seekin likelie matches aes ye begin tae type.

Yince ye'v entered or selectit the airtin, ye can press  Enter, clap ootside the kist, or press the claise icon (<). Yer airtin will kith oan the VeesualEediter page, bit it will na be hained ontil ye hain the page.


VisualEditor - External link.png
Tae airt til ae wab page ootside Wikipædia, the process is the same; jist enter the link in the field n it will be added aes "ootby airtin".

VisualEditor - Link editing inline.png
Tae chynge or remuiv aen exeestin airtin, clap in the link in the tex, than press the "Link" icon that kiths naur it. Forby, ye can clap the same icon in the tuilbaur or uise the  Ctrl+K keybuird shortcut while oan it.

Ye can than eedit the airtin's tairget, or remuiv it awthegather bi pressin the "Remove" icon (ridd bin) in the tap-richt corner o the dialog.


Eeditin eemages n ither media files[edit | edit source]

Tae eik ae new eemage (or anither type o media file) til the page, clap the "Media" icon (ae pictur o moontains) in the "Insert" puldoon menu. The eemage will be eikit whaurever yer cursor is.
VisualEditor - Media editing 1.png

Clapin oan the "Media" icon apens ae dialog that autæmateeclie rakes Wikimedia Commyns fer media files sib til the page that ye'r eeditin.

Ye can seek ither media files bi chyngin the tex in the dialog's rake kist.

Clap oan ae thummnail tae chuise ae file.

VisualEditor - Media editing 2.png

Yince inserted, the eemage is selectit (it kiths blue). Ye can resize it uisin the haunles at its corners, n drag n drap it til its desired location.

Clap oan the "Media" icon that kiths oan the picture, or the yin in the tuilbaur, tae add ae caption.

VisualEditor - Media editing 3.png

The media dialog permits ye tae eik (n eedit) ae caption, that can contain formattin n airtins.
VisualEditor - Media editing 6.png

The media dialog permits ye tae eik alternateeve tex captions aes weel, this heelps uisers that uise screen readers, or that hae disabled eemage displey.
Media editing 7.png

Ye can set vareeis boondins fer the eemage in the "Advanced settins" windae aes weel. Thir incluid its alignment, its type, n its size.
VisualEditor - Media editing 8.png

Whan ye dun, clap "Apply changes" tae claise the dialog n return til the page eediter.
VisualEditor - Apply changes.png

Editing and inserting galleries[edit | edit source]

Tae eik ae new gallerie, clap the "Gallery" icon (ae set o photæs).
VisualEditor - Gallery1.png

This will apen the gallerie inserter, this is ae simple kist the nou that wairks siclyk til wikitex maurkup. Tae eik eemages til yerr gallerie, ye'll need tae incluid the file name, follaed bi ae baur (|) n the caption ye wid lik fer the eemage. Ilka eemage in the gallerie shid hae its ain line. Yince ye'v eikit aw o the eemages that ye'd lik in yer gallerie, clap the cair triangle (<) tae exit the inserter. Ye shid see yer gallerie aes it will kith. Please mynd that yer gallerie will na hain ontil ye hain the page.
VisualEditor - Gallery3.png

Tae eedit aen exeestin gallerie in VeesualEediter, clap oan the gallerie tae cause the icon tae kith in the upper richt corner. Clapin oan the icon will summin the gallerie inserter kist wi the ful leet o eemages incluidit in the gallerie. Ye can eedit this leet tae remui, eik or rearrange eemages or tae alter captions. Onfortunatelie, ye canna see the chynges that ye'v dun the nou ontil ye clap oan the cair triangle (<) tae exit the inserter. Yince ye'v finished modifiein the gallerie, be sair tae hain the entire page - exitin the gallerie inserter will na hain yer chynges.
VisualEditor - Gallery2.png

Eeditin referances[edit | edit source]


Eeditin aen exeestin referance[edit | edit source]


VisualEditor - Editing references 1.png
Tae eedit aen exeestin referance, clap oan it in the tex, n clap oan the "Basic" icon (buikmaurk) that kiths naur it, or the yin in the tuilbaur.

VisualEditor - Editing references 6.png
Clapin oan the "Basic" icon apens ae dialog that incluids ae mini-eediter, whau ye can eedit the referance's tex.

Monie wikis uise templates tae format referances accordin til ae speceefeec staundairt. Ye'll see this gif ye eedit aen exeestin referance whase content turns blue whan ye select it.

Click on the Template icon (puzzle piece) to edit the content of the template in the template mini-editor.


VisualEditor - Editing References - Cite Web.png
If what appears when you click on the reference is one of the several template icons, clicking on it takes you directly to the template mini-editor.

VisualEditor - Editing references 5.png
Clapin oan the Template icon (puzzle piece) permits ye tae eedit the template's indiveedual boonds.

VisualEditor - Apply changes.png
Clap oan "Apply changes" whan ye'r dun, n ye'll gang back til the referance eediter.

Gif thaur's nathing mair tae eedit, clap oan "Apply changes" again tae return til the page.


Reuisin aen exeestin referance[edit | edit source]


VisualEditor references more.png
Gif the page awreadie contains referances, ye can chuise tae reuise aen exeestin citation, gif it applies til the tex that ye want tae soorce.

Tae reuise aen exeestin referance, place yer curser whaur ye want tae add it in the tex, n clap on the "Basic" icon (buikmaurk) fae the "Insert" menu.


VisualEditor - Editing references 21.png
In the referance eediter, clap oan the button that says "Use an existing reference", in the bottom cai corner o the windae.

VisualEditor - Editing references 18.png
Gif thaurs monie referances, ye can uise the rake baur (labeled "What do you want to reference?") tae yinlie displey referances that match ae gien tex.

Seek the referance that ye want tae reuise in the leet, n select it.


Adding ae new referance[edit | edit source]


VisualEditor references more.png
Tae eik ae new referance, place yer curser whaur ye want tae add it in the tex, n clap oan the "Basic" icon (buikmaurk) in the "Insert" puldoon oan the tuilbaur.

VisualEditor - Editing references 20.png
In the referance eediter, ye can eik, eedit n format yer citation.

Ye can mak the referance belang til ae gien groop; this is uised tae displey groops o referances wi the "References list" tuil.


VisualEditor reference toolbar transclusion.png
Gif ye'r eikin ae new referance n ye want tae include ae template in it, clap the Template icon (puzzle piece) in the puldoon "Insert" tuilbaur o the referance eediter.

VisualEditor - Editing references 9.png
Than, seek the template that ye want tae uise, eik it n eedit it aes ye wid aen exeestin template.

Clap oan "Apply changes" tae return til the refarence eediter, n "Apply changes" again tae return til the page.


VisualEditor - Editing references 10.png
Gif thaur's na awreadie ae leet o referances oan the page (fer example, gif ye'r addin the first referance o the page), ye need tae eik it in order fer the tex o yer referance tae be displeyed.

Place the curser whaur ye want tae displey referances (uissuallie at the bottom o the page), n clap the "References list" icon (three buiks) tae eik it.


VisualEditor - Editing references 11.png
Tae simplie eik ae referances leet, clap "Apply changes" oan the dialog.

Gif ye cræftit groops o referances, ye can speceefie ae groop in this dialog, tae selecteevelie displey referances that belang til it.

Using the cite menu[edit | edit source]


VisualEditor - Editing References - Cite Pulldown.png
If your wiki supports the cite menu, this may be an appropriate and easier avenue for adding references. (The cite menu can also be used for updating existing references; see above.) The cite menu offers quick access to some of the more familiar citation templates. It is not available on all MediaWiki projects yet and must be enabled.

(Instructions to add the cite menu to a specific wiki are available at VisualEditor/Citation tool.)

To add a citation using the cite menu, press "cite" and select the appropriate template from the menu.


VisualEditor - Editing references - Cite book required fields.png
Selecting the template icon will take you into the template mini-editor for the template you have chosen. Strongly recommended parameters may be marked with an asterisk. While the most common parameters will display, they are not all required. Unused parameters should not display.

VisualEditor - Editing references - Add parameter.png
To add additional parameters, scroll down in the template mini-editor to the "add parameter" option.

VisualEditor - Apply changes.png
Click on "Apply changes" when you're done, and you'll go back to the editor. If there is nothing more to edit, click on "Apply changes" again to return to the page.

Eeditin templates[edit | edit source]

Tae eik ae new template til the page, steid yer curser whaur ye want the template tae be inserted, n clap oan the "Template" icon (puzzle piece) in the "Insert" puldoon menu oan the tuilbaur.
VisualEditor Insert transclusion.png

Enter the name o the template that ye want tae insert, n clap "Add template".
VisualEditor - Template editing 4.png

Foreby ye can eedit templates that ar awreadie oan the page bi selectin thaim (thay turn blue), n clapin oan the "Template" icon (puzzle piece) that kiths, or the yin in the tuilbaur.
VisualEditor - Template editing 1.png

Eikin ae new template or apenin aen exeestin template apens the "Transclusion" dialog, wi ae leet o indiveedual boondins n thair values (gif the template haes awreadie been updated tae contain TemplateData information; itherwise, aen airtin til the documentation will be available in the dialog).

Ye can eik boondins or eedit thae awreadie leetit.

VisualEditor - Template editing 2.png

Tae chynge ae boondin's value, select the boondin in the leet, n eedit its value in the naur bi windae.
VisualEditor - Template editing 3.png

Whan ae template embeds ither templates, thir sub-templates will kith inside the boondins that displey thaim. Thay can be eedited or remuived inside the boondin field.

New sub-templates ar eikit bi follaein the steps o addin ae boondin. Ye micht need tae check the template documentation tae mak sair that the sub-template is supported.

VisualEditor - Template editing 5.png

Whan ye'r dun, clap "Apply changes" tae claise the dialog n return til the page eediter.
VisualEditor - Apply changes.png

Substitutin templates[edit | edit source]


Whan ae template maun be substitutit, type subst: (colon incluidit) afore the template's name.

Autæcompleation disna wairk wi subst:; gif ye need the autæcompleation, eik subst: yinlie efter fyndin the template that ye'r seekin.

Than, clap the green "Add template" button.

VisualEditor - Template editing 7.png

Eik onie boonds aes uissual n "Apply changes".
VisualEditor - Template editing 6.png

Y'll see the template expand oan the page efter ye clap "Apply changes". Whan ye'r readie, hain the page.
VisualEditor - Template editing 8.png


Eeditin categeries[edit | edit source]

VisualEditor Categories.png
The "Page opties" puldoon menu apens access til the "Categories" button.

VisualEditor - Category editing 1.png
The "Categories" button apens ae dialog that leets exeestin categeries n permits ye tae eik new catergeries.

Thaur's aen optie tae confeegure the sortin key uised tae leet the page oan the categeries' pages.


VisualEditor - Category editing 3.png
Tae eik ae new categerie, enter its name in the field "Add a category". Ye can either cræft ae new categaerie, or select aen exeestin catergerie.

VisualEditor - Category editing 2.png
Tae remuiv aen exeestin categerie, clap oan it n clap oan the "Remove" icon (ridd bin) in the dialog that apens.

Foreby, ye can speceefie thaur the sortin key fer ae speceefeec categerie. This owerrides the general sortin key.


VisualEditor - Apply changes.png
Clap "Apply changes" whan ye'r dun eeditin categeries tae return til the page eediter.


Eeditin page settins[edit | edit source]

VisualEditor - Page Settings menu.png
Tae eedit ae page's settins, clap tae apen the "Page opties" puldoon menu in the tuilbaur n select the "Page settins" button.

VisualEditor - Page Settings1.png
The "Page settins" button apens ae pane that shaws vareeis opties sib til the page.

VisualEditor - Page Settings Redirects.png
Ye can mak ae page ae reguidal til anither page bi checkin the "Reguid this page ti" checkkist, n than selectin in the kist ablo the page that ye want this page tae point til.

At the bottom is the optie tae hinder page renames updatin this reguidal, this is uised awfa rarelie.


VisualEditor - Page Settings Edit Links.png
Ye can mak ae page na shaw eedit kists nex til ilka section heider bi checkin this checkkist.

VisualEditor - Page Settings TOC.png
Ye can chynge whather the page shaws ae Buird o Contents bi selectin yin o thir three buttons. Bi defaut, pages will shaw ae Buird o Contents gif thaur's three or mair heidin, this is whit "Gif needit" will dae.

VisualEditor - Apply changes.png
Clap "Apply changes" whan ye'r dun eeditin page opties tae return til the page eediter.

Eeditin mathemateecal formulae[edit | edit source]

The formula eediter is still unner deveelipmant, sae oan some wikis ye micht need tae opt-in til the formula eediter tae uise it. Tae dae this, clap oan "Beta" in yer personal tuils in the tap richt o onie wiki page, check the kist nex til "VeesualEediter formulae eeditin", n press "Hain" at the bottom o the page.

Tae eik ae new mathemateecal formula til the page, steid yer curser whaur ye want it tae be inserted, n clap oan the "Formula" icon ("Σ") in the "Insert" puldoon menu oan the tuilbar.
VisualEditor-logo.svg

Ae windae will apen whaur in ye can type the formula, uisin LaTeX syntax. VeesualEediter will update the formula aes ye type it, sae that ye can see hou it will luik aes ye mak the chynges. Yince ye'r happie wi the formula, jist clap oot o the windae.
VisualEditor-logo.svg

Tae eedit aen exestin mathematecal formula oan the page, clap oan it n than clap oan the "Σ" icon in the menu that kiths. This will apen the windae, n lat ye mak some chynges.
VisualEditor-logo.svg


Eeditin poems n ither biordinair eetems[edit | edit source]

Some eetems, like poems n museec scores ar na yet supportit bi VeesualEediter. Ontil thay ar, ye'll need tae eedit the soorce wikitex directlie gif ye want tae alter or eik thir.


Keybuird shortcuts[edit | edit source]


Monie eediters ar uissed tae enterin wikitex directlie, especiallie baud, italeecs n wikilinks. Keybuird shortcuts permit ye tae quicklie insert siclike formattin wioot haeing tae clap the tuilbaur buttons. Commyn general shortcuts, n some uised bi ither eediters, function in VeesualEediter:

PC shortcut Action Mac shortcut

 Ctrl+B Baud  Cmd+B

 Ctrl+I Italeecs  Cmd+I

 Ctrl+K Insert airtin  Cmd+K

 Ctrl+X Cut  Cmd+X

 Ctrl+C Copie  Cmd+C

 Ctrl+V Paste  Cmd+V

 Ctrl+Z Ondae  Cmd+Z