Our Eclipse UI Guidelines are for developers of the Eclipse IDE and Eclipse Plug-Ins. They describe how to create consistent user interfaces in Eclipse or RCP applications.

This repository contains the AsciiDoc source. The HTML version is hosted on GitHub pages.

We'd like to hear your feedback. Please create an issue, submit a pull request or start a discussion.

This repository contains the source for the Eclipse UI Guidelines in AsciiDoc format, as an Eclipse or Maven project.

Build it with mvn verify.

A utility script replace_icons.sh is provided to automate replacing icons in an existing Eclipse installation based on the icon-mapping.json file.

Usage:

./scripts/replace_icons.sh <eclipse_plugins_dir> <mapping_json_file>

Example:

./scripts/replace_icons.sh /path/to/eclipse/plugins iconpacks/eclipse-dual-tone/icon-mapping.json

Important: After running the script, you must restart Eclipse with the following flags to ensure the icon cache is cleared and the new icons are displayed:

eclipse -clean -clearPersistedState

Please ensure that every sentence is on a separate line. The AsciiDoc Syntax Reference explains all available formatting.

Editing is easy with the Eclipse AsciiDoctor Plug-in as well as with the VSCode Extension.