Go to file
Arlo Breault 94c4d619a7 Add a checkbox to use the image caption as the alt text for galleries
The need for something like this was anticipated in
I2bf43c7e83283f43e047229eb53c244918fcbb0c.

As of version 2.5.0 of Parsoid's output, if alternate text is missing
for an image but a caption is present and image isn't displaying the
caption (ie. it isn't a thumb or frame), then the text content of the
caption will be set as the alt attribute.  Parsoid will then drop the
alt attribute when serializing if it matches the caption text, since
it's unnecessary.

However, if the caption is modified and the alt text isn't, the alt will
be serialized.  This is likely to be unexpected to editor.  They may
have missed that the both the caption and alt are populated in VE and
only edited one place.

Since all of the above is happening only for images where the caption
isn't visible, it doesn't appear to be a much used feature since, at
least for inline images, the experience of caption editing was already
less than optimal.

However, because of a quirk in how galleries are rendered in Parsoid,
this affects gallery caption editing, which is visible and presumably
used more often.  See T268250 for a discussion on an improved gallery
structure.  But for now, gallery images are effectively inline and set
the alternate text, thus subject to the above.

Here we add a checkbox so that the default is to ignore the alt if it's
the same as the caption.  And only make use of it if it differed
originally or was explicitly unchecked to modify.

Bug: T311677
Change-Id: Idf297d8a98995971c5835b0cea56c3317a3626e2
2022-07-22 15:46:55 -04:00
.jsduck Copy BookletLayout implementation from ooui-js 0.44.0 2022-06-21 11:06:44 +02:00
.phan
.vscode selenium: The first test 2021-11-09 16:11:22 +01:00
bin
build eslint: Lint root files with server rules 2022-03-17 23:39:53 +00:00
i18n Add a checkbox to use the image caption as the alt text for galleries 2022-07-22 15:46:55 -04:00
images Manually optimize BetaFeatures .svg files 2021-09-02 11:38:14 +02:00
includes ApiVisualEditor: set title when expanding permission editnotices 2022-07-20 10:48:56 -04:00
lib Update VE core submodule to master (1800c35de) 2022-07-16 19:18:02 +02:00
maintenance Raise PHP coding standards in this codebase a bit 2021-11-08 13:34:29 +01:00
modules Add a checkbox to use the image caption as the alt text for galleries 2022-07-22 15:46:55 -04:00
screenshots
tests Merge "ApiVisualEditorTest: Set Database annotation and $tablesUsed" 2022-07-12 13:31:02 +00:00
.eslintignore eslint: Lint all files except those in .eslintignore 2022-04-13 15:44:49 +01:00
.eslintrc.json eslint: Lint root files with server rules 2022-03-17 23:39:53 +00:00
.gitignore selenium: The first test 2021-11-09 16:11:22 +01:00
.gitmodules
.gitreview
.mailmap Update Legoktm's mailmap entry 2021-04-11 19:18:33 -07:00
.phpcs.xml ApiVisualEditor: Remove $wgTitle hack, set page for {{PAGENAME}} when needed 2022-02-28 23:43:54 +00:00
.stylelintrc.json build: Update stylelint-config-wikimedia to 0.13.0 2022-05-04 22:54:48 +01:00
AUTHORS.txt Replace non-breaking spaces in AUTHORS.txt 2022-04-19 16:09:48 +02:00
composer.json build: Updating dependencies 2022-05-20 10:06:25 +00:00
CONTRIBUTING.md
extension.json Add a checkbox to use the image caption as the alt text for galleries 2022-07-22 15:46:55 -04:00
Gruntfile.js eslint: Lint all files except those in .eslintignore 2022-04-13 15:44:49 +01:00
jsduck.json Update all tests in the ve-mw module to use ES6 syntax 2021-04-30 08:07:54 +00:00
LICENSE.txt
package-lock.json build: Updating grunt to 1.5.3 2022-07-20 09:42:42 -04:00
package.json build: Updating grunt to 1.5.3 2022-07-20 09:42:42 -04:00
Rakefile
README.md Add newline to README.md to fx render issue 2021-09-03 14:54:50 +02:00
VisualEditor.i18n.alias.php

VisualEditor

VisualEditor provides a visual editor for wiki pages. It is written in JavaScript and runs in a web browser.

It uses the Parsoid parser to convert wikitext documents to annotated HTML which the VisualEditor is able to load, modify and emit back to Parsoid at which point it is converted back into wikitext.

For more information about these projects, check out the VisualEditor and Parsoid pages on mediawiki.

Developing and installing

For information on installing VisualEditor on a local wiki, please see https://www.mediawiki.org/wiki/Extension:VisualEditor

For information about running tests and contributing code to VisualEditor, see CONTRIBUTING.md. Patch submissions are reviewed and managed with Gerrit. There is also API documentation available for the VisualEditor.

Terminology