Using Omicron
Accessibility and authoring
Image display preferences, keyboard navigation, accessible authoring, and paste/drop reference repair in the web app.
This guide covers the web application and its article editor. The mobile app has a separate interface. Older instances need to upgrade before these controls are available.
Image display
Open Image display, the image-icon button in the web navigation:
| Choice | Effect |
|---|---|
| Follow reduced-motion setting | Default. Hide images when the browser reports a reduced-motion preference. |
| Show images | Show images even when reduced motion is requested. |
| Hide images | Hide all images, including animated images, while preserving their space and alternatives. |
The choice stays in this browser; it is not an account setting and is not synchronized to another device. Hiding changes display only: it does not delete images, edit articles, or change what is exported or sent to other servers.
Images keep their alternatives in the accessibility tree. Outside editing surfaces, images with descriptions also receive visible Image hidden: … text. The editor does not insert that text into your article; use Image settings or description search to review alternatives there.
Hiding is not an animation pause/resume control or a guarantee against all flashing content. Prefer still images and avoid flashing media when publishing.
Keyboard navigation
- Use Skip to content, the first keyboard-focusable link, to move past the shared navigation to the main content.
- In the article body, press Alt+F10 to focus Text style, the first formatting tool. Use arrow keys to move between tools, including dropdowns and the emoji picker. Home and End move to the first and last tool.
- From the toolbar, press Escape or Alt+F10 to return to the body without replacing the current text selection. Close an open menu, popover, or dialog with Escape first; it returns focus to its opener.
- Tab still moves between control groups and the body. These shortcuts do not apply to the title or other fields, and do not bypass the warning before editing simplified imported content.
- Use the usual undo and redo shortcuts in the body. Pasted or dropped content that you explicitly accept can be undone.
- A paste immediately after selecting or extending a passage with the keyboard uses the latest selection, not an earlier one.
These controls need the editor keyboard shortcut update. Immediate paste after a keyboard selection needs the rapid selection paste update. Browsers, operating systems, and assistive technology may reserve some key combinations; use Tab and the toolbar controls when a shortcut is unavailable.
Formatting shortcuts
Select a passage in the article body before applying inline formatting:
| Action | Windows / Linux | macOS |
|---|---|---|
| Toggle bold | Ctrl+B | Command+B |
| Toggle italic | Ctrl+I | Command+I |
| Toggle underline | Ctrl+U | Command+U |
| Add or remove a link | Ctrl+K | Command+K |
| Toggle heading level | Ctrl+Alt+1 through Ctrl+Alt+6 | Command+Option+1 through Command+Option+6 |
The link shortcut uses the same action as Link in the toolbar. For unlinked text, it opens Add link: enter the URL and submit the form. Escape cancels without adding a link. If the selection is already in a link, the shortcut removes that link instead of opening a dialog.
Find and navigate
Below the article body, expand Find and navigate:
- Enter text in Find in article. Results include body text, image descriptions, and table captions.
- Use Previous result and Next result to choose a match.
- Choose Edit result to select matching body text or open the image/table settings for an alternative.
Go to document element jumps to a heading, paragraph, image, table, or other document element. To move an image without dragging, select it there, cut it, move the text cursor to the destination, and paste it. Its supported description and metadata travel with it. If the image references a separate long description, keep that text in the destination article or copy it with the image; copying the image alone does not copy a separate description paragraph.
Image descriptions and sizing
- Select an image and choose Image settings in the toolbar, or use its Alt button.
- In Describe this image, enter Alt text explaining its information or function. Explain complex graphs in nearby article text too.
- To resize without dragging, set Image width (%) to a whole number from 10 to 100. The aspect ratio stays unchanged.
- Choose Save.
Saving an empty alternative explicitly marks the image decorative. Do that only when it adds no information. A newly uploaded image without a reviewed alternative remains an item for Check accessibility; the editor does not invent a description from its filename.
Banners are presented decoratively. Put an informative image in the article body with a description rather than relying on the banner to convey meaning.
For profile photos, Adjust photo provides Left, Right, Up, and Down buttons as an alternative to dragging, plus Photo zoom. Arrow keys also reposition the photo when the photo control has focus.
Passage language
The article’s Language is its primary language. To mark a passage that uses another language:
- Select the passage and open Text language in the formatting toolbar.
- Enter a language tag, such as
frorpt-BR. - Choose the text direction: Inherit, Automatic, Left to right, or Right to left.
- Choose Save. An empty language tag inherits the surrounding language.
In Markdown/HTML authoring surfaces, a passage can use markup such as
<span lang="fr">Bonjour</span>. The article’s language setting and its passage
languages serve different purposes; a feed filter uses the article language.
Table captions and headers
Use Table in the toolbar to insert a table. With the cursor inside it, open Edit table → Table accessibility:
- Set Table caption to explain the table’s purpose. It appears in both the editor and saved article.
- Select Header row or Header column to identify the corresponding cells as headers.
- With a header cell selected, the table menu offers Header applies to column and Header applies to row.
Review header relationships again after merging or splitting cells. These controls do not automatically establish correct relationships for every complex table. Avoid tables used only for visual layout.
Review before publishing
Expand Check accessibility (N) below the editor. It prompts for missing image alternatives, empty or out-of-order headings, table descriptions/headers, and some ambiguous link text. Choose an item’s Review button to locate it.
This review is advisory: it does not block publishing. A count of zero is not a standards pass; these checks cannot judge whether a description is meaningful, whether every header association is correct, or whether the complete article is usable with assistive technology.
The Accessible writing guide below the editor explains images, structure, links, languages, motion, and final review. The same guide is available in the profile Markdown editor and the administrator’s public-information editor.
Imported, pasted, and dropped content
The rich editor supports less markup than imported or external HTML can contain. It compares an inventory of elements, selected attributes, and text to detect some losses; this is not a complete comparison of meaning or relationships.
Opening an imported article
When detected structure or accessibility information would be lost, the editor shows Rich editing may simplify imported content and stays read-only. The stored body remains unchanged, including during a title-only autosave.
Keep an export before continuing if the original markup matters. Edit simplified content unlocks editing; acknowledgement alone does not save a simplified body, but a later body edit can. Information removed by that simplification is not reconstructed automatically.
Paste and drop review
When rich editing would simplify structure or accessibility information, Review pasted content or Review dropped content lists the affected information:
- Cancel leaves the article unchanged. Files waiting for the initial review are not uploaded.
- Paste simplified content or Insert simplified content accepts the simplified result when no missing or ambiguous reference targets are detected. Review the remaining descriptions and relationships; undo is available after insertion.
Missing or ambiguous references
References connect images and tables to descriptions, captions, or headers
through HTML IDs. For example, an image’s aria-describedby="details" needs a
description element with id="details" in the destination article.
If a target is missing or ambiguous, the review says Some references have missing or ambiguous targets. The content has not been inserted, and the dialog offers Cancel only—not an option to accept broken relationships.
- Choose Cancel.
- Copy the referenced description with the image, or include the complete table and its headers instead of an incomplete cell selection. If the source itself has duplicate IDs, correct them in the source before trying again.
- Retry the paste or drop. Keep referenced text or headers in the article when moving content within it.
Use paste-as-plain-text only when you deliberately want to discard the source formatting and relationships. It does not reconstruct missing descriptions.
The editor checks references again before insertion, including after an image upload finishes. If another edit removes a target during the upload, insertion waits for repair. Cancelling does not remove a file that has already been uploaded.
Colliding IDs
When a unique incoming ID is already used by an element remaining in the article,
the editor renames the incoming ID and updates its bundled references together.
For example, details can become details-copy, or another unused suffix when
that name is taken. Existing article IDs stay unchanged. Caption and description
references, table headers, and same-document fragment links follow the renamed
target.
This does not guess associations for duplicate IDs in the source, repair older broken references, or prove that a description or header relationship is correct. The reference guard applies to clipboard and external-drop insertion, not every internal drag/copy or stored-content transformation. Instance administrators can follow the frontend-only upgrade steps.
Image files and other transfer formats
A single image file accompanied by matching HTML can keep its supplied description and surrounding text when uploaded. File-only images still need alternative-text review. Unsupported files, ambiguous image/description matches, or unmatched text with files are rejected with instructions rather than guessed. Insert one image at a time when descriptions cannot be matched reliably, and insert unmatched text separately.
Paste or use the toolbar image-upload button instead of dragging. Use the browser’s paste-as-plain-text command when you deliberately want text without the source formatting. Cross-application formats, partial selections, and complex table transfers can still need additional review.
Found a mistake?Edit this page on GitHub.