Help talk:VisualEditor/User guide

Translation

Available on it.wiki as it:Wikipedia:VisualEditor/Manuale --Elitre (WMF) (talk) 16:39, 23 June 2013 (UTC)

Do we want to use the translate tool here so that it is kept updated here (and then copy over), or just do that by hand? Jdforrester (WMF) (talk) 16:49, 23 June 2013 (UTC)

Yes, I'm going to set up the page for translation, similarly to Help:VisualEditor/FAQ where this was split from. guillom 16:52, 23 June 2013 (UTC)

Mac users

Is it worth saying something about using ⌘ Command on Macs at the first mention of a shortcut? Whatamidoing (WMF) (talk) 08:38, 28 June 2013 (UTC)

Yes. Thank you for the reminder. I've added it :) guillom 11:54, 1 July 2013 (UTC)

Issue viewing this page with Firefox

When I view this page with Firefox 22, the image titled "The VisualEditor toolbar" is superimposed on the last three links over the links titled "TemplateData tutorial", "Help new users", and "Translate & localize documentation". In MSIE 10, the image is properly displayed underneath these links. GoingBatty (talk) 02:29, 30 June 2013 (UTC)

Thanks for fixing this! GoingBatty (talk) 03:50, 1 July 2013 (UTC)

You're welcome :) It sort of fixed itself when I added a new section at the top. guillom 11:45, 1 July 2013 (UTC)

Discoverability

Is this page linked from the VisualEditor interface? I couldn't find any help clue in it. --Nemo 14:57, 30 June 2013 (UTC)

Well, if the interface can not point to localized versions for each wiki, yes, we might try and ask for a link here, at least. Will keep you posted. --Elitre (WMF) (talk) 19:37, 30 June 2013 (UTC) PS, [1].

The best way to do this would probably be to add a new interface message linking to Special:MyLanguage/Help:VisualEditor/User guide. That way, wikis can customize it to have it link to a local version. guillom 11:45, 1 July 2013 (UTC)

Elitre created bugzilla:50476 :) guillom 11:50, 1 July 2013 (UTC)

This is done, and I opened a bug about pointing more directly to the user's language. --Amir E. Aharoni (talk) 18:27, 23 July 2013 (UTC)

No thanks

How do I turn Visual Editor off? --Merovingian (talk) 18:27, 2 July 2013 (UTC)

Never mind; I found it. --Merovingian (talk) 18:31, 2 July 2013 (UTC)

me too, see Help:VisualEditor/FAQ. --Flominator (talk) 15:41, 26 July 2013 (UTC)

Translation in Marathi (mr)

The language Marathi (mr) is not appearing in the language list at the header of the page along with other languages. I have recently made certain translations there on the translation page.To see them here,i didnt find the page of my language. Pl confirm.

V.narsikar 13:21, 23 August 2013 (UTC)

 Thanks anyway! When I went back, it now appeared.

V.narsikar 13:45, 23 August 2013 (UTC)

Translation into Bikol Central (bcl)

I'm doing the translation from English to Bicol Central. But it seems that my translations are not coming back to fore for further revisions. How can I get back to it? Can you give me a link to it? Thanks. Geopoet (talk) 02:20, 11 September 2013 (UTC)

@Geopoet: Hey - thanks for doing this. Unfortunately you replaced the original, English version rather than writing a new version for bcl. Instead, you should edit the page using this link. Thank you again. Jdforrester (WMF) (talk) 15:47, 11 September 2013 (UTC)

Updates to the page

This can be used as a screenshot of the new More menu. --Elitre (WMF) (talk) 20:26, 18 September 2013 (UTC)

Saving for later, since these signs have disappeared from insert

• The "<visualeditor-mwhieroinspector-title>" icon (an Egyptian ankh: ☥) will allow you to add Egyptian hieroglyphics to the page. (Pending. Not yet available.)
• The "<visualeditor-mwmathinspector-title>" icon (a sigma sign: Σ) will allow you to display mathematical formulas. (Pending. Not yet available.)

These show for me? Jdforrester (WMF) (talk) 05:42, 10 January 2014 (UTC)

They show at MediaWiki, but not elsewhere. The math formula item appears on other wikis only if you've opted in, and I don't see any way to enable hieroglyphics. Whatamidoing (WMF) (talk) 19:38, 10 January 2014 (UTC)

@Whatamidoing (WMF): Yes, the hieroglyphics experimental mode will eventually be a beta feature when it's a little more polished; for now it's MediaWiki-only (and has been for ~ 6 months). I still think they should be documented, maybe as "available on some wikis" or somesuch. Jdforrester (WMF) (talk) 00:35, 13 January 2014 (UTC)

Appearance of page

What's the reason for boxes around headings? Or for shrinking the width? Because they are quite quite non-standard when compared to other help pages: Help:Contents or any other page. --Usp (talk) 05:32, 10 March 2014 (UTC)

I believe that the original hope was that it would be easier to read. Whatamidoing (WMF) (talk) 21:05, 11 March 2014 (UTC)

I think having such drastic difference in appearance for a single thing (VisualEditor) does not help, on the contrary I would say. I think these kind of things (manually trigging heading style and page width) should be done centralized like in Typography_refresh. To prevent maintainability issues with blink-code for one. --Usp (talk) 06:38, 12 March 2014 (UTC)

Frankly, Usp, I like the regular help pages better myself, but I think that there's a belief that the white spaces improve readability, as Whatamidoing says. (Maybe an accurate one - I haven't studied this at all.) I'm used to the regular wiki display, and I find this table system a pain to work with - I grumble at it every time I try to update it. :) --Mdennis (WMF) (talk) 15:38, 12 March 2014 (UTC)

info about "show changes" -- and how to enter an edit comment -- was HARD TO FIND

I stumbled into a visual editor because it was a default for a certain page (see https://www.mediawiki.org/w/index.php?title=Universal_Language_Selector%2FDesign%2FInterlanguage_links&diff=1023297&oldid=993136 ).

However, I was able to find [only] the "Save page" button -- I had no idea where to look, to find (or, to find out how to find) the "show changes" button, nor the method to enter an "edit comment".

Fortunately (see the"DIFF" link above) I was making only a single-character edit -- a spelling (or blatant TYPO) correction. Upon clicking on the "Save page" button, some of my questions were (too late! -- in a sense) answered.

However, before I found those [answers to my questions], I had to -- FIRST! -- "give up" on trying to find them. The organization of how it works might seem very clever to you. That is, the set-up of clicking on the "Save page" button FIRST, and then being shown (the existence of, and the location of) the "show changes" button, and the method to enter an "edit comment" -- all of that, might seem very ergonomic to you.

But -- (switching now, to discuss this Help page, instead) -- when a person comes to a Help page, it should be possible -- [and, ideally, easy!] -- to find the desired answers -- (even the ones I was looking for, IMHO) -- without being obligated to already know certain things. So, IMHO this Help page should contain the character string "show changes", even if only to allow readers of this Help page to find what they are looking for. Such readers might already know about the existence (and the usefulness) of the "show changes" button in the OLD (non-"Visual") ["wikitext"] editor. They might get an idea (as I did) to search for the character string "show changes". (That character string should probably be placed in a section that "explains" the stuff mentioned in the previous paragraph -- i.e., the fact that AFTER you click on the "Save page" button, THEN you are shown the "show changes" button, and the method [or "opportunity"] to enter an "edit comment".)

I was glad (at first) that there was a w:hyperlink to this "help" page. However, initially, I found this "help" page UN-helpful, and I was disappointed.

I have made many edits (a 4-digit number) to the English Wikipedia -- using the "OLD" (non-"Visual") ["wikitext"] editor. I am very unfamiliar with the "visual editor". So far, I do not like^H^H^H^H prefer the "visual editor".

Just my 0.02. YMMV. --Mike Schwartz (talk) 03:57, 6 June 2014 (UTC) (but "see also" w:User_talk:Mike_Schwartz)

Good idea, Mike Schwartz. We should be able to internationalize this so that it will auto-translate to whatever jargon is common on that wiki, by using {{int:summary}}, which will give us "Summary ^(?):" (in whatever language you're viewing the page in) and {{int:showdiff}}, which will produce "Show changes" or the local equivalent.

On a bigger question, do you think it would be a good idea to have a sort of "cheatsheet" for experienced editors? I'm not sure that experienced editors need this whole long thing. Whatamidoing (WMF) (talk) 03:04, 8 June 2014 (UTC)

"In most cases you do not select text"

Hi,

The page currently says:

In most cases, when creating internal links (links to other pages in the same wiki) you do not select text. But when creating external links, in most cases you do select text before starting the linking process, and text is probably something you just typed.

This sounds very odd to me. I select text in both cases: When I add an internal or an external link.

Am I missing something here? --Amir E. Aharoni (talk) 13:14, 27 September 2014 (UTC)

Not really. There are just several ways to create links. For simple wikilinks, you don't need to type a word, select it and make it a link. You can simply hit CTRL+K, or the link button, and add it in the dialog. (You can also type it, put the cursor on it and hit CTRL+K to create the link, yet another way which doesn't involve selecting.) For external links, you'll probably want to select multiple words first and then adding the link; otherwise using the method I just described would lead to a label which is a mere number in brackets. HTH, --Elitre (WMF) (talk) 13:37, 6 October 2014 (UTC)

Elitre, You can also type it, put the cursor on it and hit CTRL+K to create the link - if I understand correctly, this only works if the title of the target article is a single word.

In general, this whole description sounds too complicated for me. --Amir E. Aharoni (talk) 13:00, 29 October 2014 (UTC)

Yup, that's what I had in mind when I said "simple". Please feel free to try to simplify that passage yourself, of course. --Elitre (WMF) (talk) 13:36, 29 October 2014 (UTC)

"it will not be saved until you save the entire page"

The page currently says:

Your link will immediately appear on the VisualEditor page, but it will not be saved until you save the entire page.

Isn't that true for all other changes? Is there anything special about linking? --Amir E. Aharoni (talk) 13:19, 27 September 2014 (UTC)

It is, and a similar remark is also made for galleries editing. This note was in the guide since its very first version. It is possible that people were a bit confused by how VE worked in June 2013, so we thought that such a warning was necessary. Do you think those passages should now be revisited? Best, --Elitre (WMF) (talk) 13:49, 6 October 2014 (UTC)

On one hand - Yes.

On the other hand - VE is kinda similar to Google Docs, and Google Docs autosaves everything, so this may confuse some people.

So I'm not entirely sure. Are there any tests with users from which we can know the expectations? --Amir E. Aharoni (talk) 18:03, 6 October 2014 (UTC)

I can ask. --Elitre (WMF) (talk) 18:06, 6 October 2014 (UTC)

James confirms there are not such tests, but we believe that we can safely take out those notices entirely at this point (or if we really want to be cautious, just adding a general one at the top of the page rather than inside single sections. HTH, --Elitre (WMF) (talk) 17:42, 9 October 2014 (UTC)

Exporting the English version

Extracting the English version from the grips of the translation system is complicated, so here's the link:

https://www.mediawiki.org/w/index.php?title=Help:VisualEditor/User_guide/en&action=edit

Click that and copy the results to any English-speaking wiki. (NB that today's version won't work very well for you, unless you also have a copy of {{Language screenshot URL}} installed.) Whatamidoing (WMF) (talk) 00:12, 9 October 2014 (UTC)

Update:

Here's my current workaround for the Language screenshot template. It should work on any language.

• Copy the text over.
• Use "search and replace" on your browser to find the string {{Language screenshot URL|name= and change it to File: (or the preferred local equivalent).
• At the end of that line, replace the }} with -xx.png so that "xx" is the code for the language whose screenshots you want. This means that you'll paste -en.png for English ones or -it.png for Italian ones.
• Preview the whole page before saving, to make sure that you haven't missed anything and that all of the screenshots actually exist for that language. (Fallback to -en.png if they don't.)

The file names won't normally change, and the screenshots should update automatically (by bot), so you should only have to do this once per major update to the page. Whatamidoing (WMF) (talk) 17:55, 23 October 2014 (UTC)

VisualEditor Portal template

Is the VisualEditor Portal template needed here?

Some of the links in it can be useful for general users, but some seem too much for a page that is supposed to give people quick reference about editing. It's very big and doesn't work so well with the rest of the text, which has special design - margins, a lot of whitespace, etc. I tried moving it a bit to other places on the page, but it just doesn't quite fit anywhere.

Can it be removed entirely? If there are any very useful links, they can be posted separately in a smaller box. --Amir E. Aharoni (talk) 16:41, 17 November 2014 (UTC)

I'm guessing it's here for consistency, but I also think a smaller/shorter box just on this page (maybe with a similar design though) won't hurt. --Elitre (WMF) (talk) 16:44, 17 November 2014 (UTC)