Help talk:VisualEditor/User guide

Jump to navigation Jump to search

About this board

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"
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"

Pic not showing on users guide/citation template

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

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;">"
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)"
Davey2010 (talkcontribs)

Hi, Is there a way I can remove multiple wikilinks from a table ?, At present I can only seem to do one link at a time, Thanks, ~~~~

Davey2010 (talkcontribs)

Resolved - Used the clear formatting tool, Thanks ~~~~

Whatamidoing (WMF) (talkcontribs)

I thought that "clear formatting" wasn't supposed to remove links.

Reply to "Removing multiple wikilinks"

Is there some way to use visual editor to replace an image with another whilst maintaining the formatting?

2
John Cummings (talkcontribs)

Hi

I'm trying to think of ways to create easy to use templates for photo essays for the Wiki Loves competitions. If I created a template with placeholder images with special formatting (e.g larger than normal and in galleries with no borders) and placeholder text, is there an easy way to replace the placeholder images in VE?

I mean something like this https://commons.wikimedia.org/wiki/User:John_Cummings/WLE_photo_essay_template

Thanks

Whatamidoing (WMF) (talkcontribs)

If you use exactly that (not a {{template}}, but that gallery code itself), then the users could remove the old images and insert new ones. Switch to the visual mode and try it out on your page to see what I mean.

How soon do you need this? The team isn't really working on galleries right now, but it might be possible to convince them to add a "Change image" button (assuming that it's not much extra work).

Reply to "Is there some way to use visual editor to replace an image with another whilst maintaining the formatting?"
Stryn (talkcontribs)

I changed it because now there are both words, and would be better to use one of them anywhere to make it consistent.

Jdforrester (WMF) (talkcontribs)
Reply to "Click or press?"