Help talk:VisualEditor/User guide

About this board

Visual Editor adds "index.php?title=" in front of every file link when saving

3
216.48.86.87 (talkcontribs)

If I have a file link like [[Media:filename.pdf|filename]] on a page that I'm editing with the visual editor, it changes it to [[index.php?title=Media:filename.pdf|filename]] and every other similar file link in the page. These newly renamed filelinks don't work. Is there a way to stop Visual Editor from doing that?

Stephen

Elitre (WMF) (talkcontribs)
Whatamidoing (WMF) (talkcontribs)

Are you running your own wiki?

Reply to "Visual Editor adds "index.php?title=" in front of every file link when saving"

How do I disable the "Edit source" tab but have the source editor as default?

5
81.154.143.60 (talkcontribs)

Is it possible to have the "Edit source" tab disabled but have the source editor as default just like on Wikipedia?

Elitre (WMF) (talkcontribs)
81.154.143.60 (talkcontribs)

I meant for logged out users on my wiki.

81.154.143.60 (talkcontribs)

I have now added $wgVisualEditorUseSingleEditTab = true; to my LocalSettings.php file which has made it now show a single tab that defaults to edit source which is more or less what I want.

Whatamidoing (WMF) (talkcontribs)
Reply to "How do I disable the "Edit source" tab but have the source editor as default?"

Please remove "margin:auto;" in <div style="max-width:70em; margin:auto;">

2
64.251.40.245 (talkcontribs)

Margin:auto is causing user guide information to be centered, I assume this is not the intended look & feel. Removing the margin will align the content to the left.

Whatamidoing (WMF) (talkcontribs)

Can you tell me more about what you're seeing? For example, do you happen to be using a wide screen?

Reply to "Please remove "margin:auto;" in <div style="max-width:70em; margin:auto;">"
2A02:908:1C41:6900:D867:85CD:2DCB:E396 (talkcontribs)

How can i get an mp3 preview instead of the broken image in media window?

AKlapper (WMF) (talkcontribs)

Where and why do you get a "broken image" on which site after which steps running which MediaWiki version? Please provide way more information. Thanks.

Reply to "mp3 preview"
Amire80 (talkcontribs)

In the template editor dialog, there is a [[]] button on every field. Its tooltip is "Fall back to plain wikitext". I always saw it, but never really understood what it is. I didn't even realize it's a button until I read what User:Robin Strohmeyer (WMDE) wrote about it on the page :meta:WMDE Technical Wishes/Templates. And even after reading that, I don't understand what does it do. I see that it changes the text fields to a monospaced font, but I don't see any other effects. If I understand correctly, the values in these input box are plain wikitext in any case, although I might be wrong.

So, if it doesn't do anything, perhaps it should really be removed, as the proposal on that page says.

If it does something, I don't understand what it is, and it should be documented here. I can't see that it's mentioned in the User guide, but maybe I am missing it.

Thanks!

Jdforrester (WMF) (talkcontribs)

If I understand correctly, the values in these input box are plain wikitext in any case, although I might be wrong.

You are indeed wrong in theory, though in practice most templatedata types aren't enforced yet, as there were too many disagreements between community members as to how their templates should be written.

Amire80 (talkcontribs)

Curious.

Can you give me any links to discussions about this?

Are there any types for which this is implemented? Maybe this button could be shown only for those. If I'm not wrong again, I think that it is shown everywhere now.

Reply to "[[]] button"
Iniquity (talkcontribs)
Whatamidoing (WMF) (talkcontribs)

@Quiddity (WMF) could probably give you better advice, but I think you could use the complex page if it contains any "content", and the regular MediaWiki one for "empty" screenshots (just showing the user interface, with no article content).

Also, if you are using article content from Help:Sample page to make the screenshots, then it's CC-0/public domain, so no attribution is required.

Reply to "License for screenshots"
Amire80 (talkcontribs)

Hi,

In 2015 or so, @Vikassy implemented auto-updated and auto-translated screenshots for this user guide as a GSoC project. @ZFilipin (WMF) and I mentored him. It worked well and was very useful because it kept the guide up to date with VE's current look and strings. However, the Ruby code was difficult to maintain, so if I recall correctly, @ZFilipin (WMF) and @ESanders (WMF) rewrote it in JavaScript in 2016. The screenshot auto-updating software kept working at least for some time after that.

Is this still maintained?

I see, for example, that File:VisualEditor Media Insert Menu-en.png still says "Media", even though the button label was changed to "Images and media" a few months ago.

Pinging also @PPelberg (WMF) and @Whatamidoing (WMF).

Whatamidoing (WMF) (talkcontribs)

It looks like its last run was in June 2018.

Amire80 (talkcontribs)
ESanders (WMF) (talkcontribs)

We still have the code maintained in the VE repo, and it is ready to be run again, but I don't think I have the access to trigger it.

ESanders (WMF) (talkcontribs)

The job is here and I've triggered it to run again, let's see what happens. The last run took about ~9 hours...

Amire80 (talkcontribs)

Thanks!

ESanders (WMF) (talkcontribs)

The screenshots have been updated with about a 3% failure rate. I would also note that fewer than half of the screenshots in the user guide are using auto-screenshots, could be a good project for someone to improve that.

Amire80 (talkcontribs)
Iniquity (talkcontribs)
ESanders (WMF) (talkcontribs)

Those images are no longer generated by the bot, probably because it requires the per-wiki configuration to know if we should show one edit tab or two, and all the screenshots currently run on a test page on en.wiki. I would recommend you just generate them by hand.

Iniquity (talkcontribs)

Are there any other screenshots that need to be manually corrected? To me, in any case, the scheme seems to be quite inconvenient. Better to take all screenshots, and then replace if necessary. Otherwise, it appears completely outdated.

Whatamidoing (WMF) (talkcontribs)

The design team is working on updating so much of the interface right now, that I wonder whether it'd be better to do that in a few months. I understand that OOUI is going to be replaced, (so the 'blue button' will look a little different), and there's the Desktop improvements project, which will make several changes to the appearance. Wtih all that coming up, any screenshots we make now will be outdated by New Year's.

ESanders (WMF) (talkcontribs)

The "replacement" of OOUI will likely not affect the design of the major components, it's more a technology change.

Iniquity (talkcontribs)

In my opinion, this should be done with every design update. The bot does not ask for food :) And while we wait, many users will receive outdated documentation.

Whatamidoing (WMF) (talkcontribs)

I was thinking of the human effort needed to make manual ones. The bot used to run automagically, on a set schedule (just checking to see whether any update needed to be made), and that's fine with me.

ESanders (WMF) (talkcontribs)

Creating new screenshot tasks is unlikely to be on any team's priority list any time soon, but volunteer patches are always welcome.

Reply to "Screenshot auto-updating"

Pic not showing on users guide/citation template

1
Omotecho (talkcontribs)
Reply to "Pic not showing on users guide/citation template"
Mhare (talkcontribs)
AKlapper (WMF) (talkcontribs)

Cannot reproduce in Firefox. After setting Bosnian as my language, your link goes to the Bosnian version of help.

What are your Language settings in Special:Preferences ? Are they set to Bosnian?

Mhare (talkcontribs)

I tested as unregistered user, to simulate new user clicking the help link. It leads me to again to English site. It is correct that if you set explicitly your language in setting that it will go to correct page. That is not ideal, and it might discourage new users. All computer that I have tried from have Bosnian input settings and other related language settings.

AKlapper (WMF) (talkcontribs)

What are your exact language settings in the settings of your web browser?

Whatamidoing (WMF) (talkcontribs)

Are you using the "Special:MyLanguage" link at bs.wikipedia.org? Maybe it would be better to send people straight to the translated subpage (Help:VisualEditor/User guide/bs).

Whatamidoing (WMF) (talkcontribs)

Andre, I don't think that web browser language settings matter. Unless users have intentionally changed their GlobalPrefs, then the second they arrive at mw.org, their language is re-set to English. The default UI language for this wiki is English, even if you are arriving at this wiki by clicking on a link at a wiki in another language.

Mhare (talkcontribs)

Hi,

Sorry for late reply.

Whatamidoing, yes, we use "Special:MyLanguage" link. I agree, I will recommend our administrators that they set link in that way. I found out that web browser language made no difference. Another thing is, that most bosnians here, just use software in english language, because they can't find their way if it's translated :)

Thanks for help!

Mhare (talkcontribs)

Our sysop asks where exactly he can change this link. Link is located in editing mode, where question mark icon is, and text is "Read the user guide"

AKlapper (WMF) (talkcontribs)

The link is defined in "visualeditor-help-link". The translation which is used for all and any MediaWiki users (also outside of Wikimedia sites) who use Bosnian as their language setting is defined and translated in https://translatewiki.net/w/i.php?title=MediaWiki:visualeditor-help-link/bs&action=edit and you likely do not want to change that.

MediaWiki allows custom overrides of user interface text on a per-website basis. For the "Bosnian Wikipedia" website, such a custom override would have to be defined in https://bs.wikipedia.org/wiki/MediaWiki:Visualeditor-help-link

Reply to "Help needed, Bosnian Wiki"

apierror-visualeditor-docserver-http-error: (curl error: 28)

3
83.150.41.60 (talkcontribs)

What could be the problem?

Are there some common problems I have to take a look at it?

Im running a xampp Webserver (Windows Server 2016).

37.117.153.247 (talkcontribs)

I have the same error.......I tried all but still have this problem

Whatamidoing (WMF) (talkcontribs)
Reply to "apierror-visualeditor-docserver-http-error: (curl error: 28)"