README.md

Eclipse Color Theme

Color themes for Eclipse.

Eclipse Color Theme makes it possible to import and switch color themes conveniently and without side effects.

You can install the plugin from the update site (there's also an archive of the site for offline installation). After installing, go to Window->Preferences->General->Appearance->Color Theme to change the color theme.

Please note:

• When updating the plugin via Eclipse, go to the preferences page and press OK once, otherwise you won't see any changes. We're planning to fix this.
• When updating from an earlier version than 0.6, please uninstall the plugin and the update site, add the site listed above and install it again from there. Otherwise you won't see any updates.

Rationale

While Eclipse allows you to change the syntax coloring in great detail, there is no support for managing multiple color themes. It is possible to achieve that by importing and exporting preferences files, but this is inconvenient and likely to mess up your preferences. Furthermore, color themes have to be created for every single editor, a theme for the Java editor does not change the XML, JavaScript or any other editors. This plugin solves these issues by mapping a generic color theme format to specific preferences entries for each supported editor.

Editors and themes

Eclipse Color Theme currently supports the following editors (add links to projects):

• ActionScript/MXML (Adobe Flash Builder)
• Ant
• BibTex/LaTeX (TeXlipse)
• C++
• Clojure (Counterclockwise)
• ColdFusion (CFEclipse)
• Chromium Debugger JavaScript Editor
• CSS
• DTD
• Erlang (ErlIDE)
• FDT
• FreeMarker (JBoss Tools)
• Go (GoClipse)
• Gradle (Nodeclipse/Enide Minimalist Gradle Editor)
• Groovy
• Haskell (EclipseFP)
• haXe (eclihx)
• HTML (Eclipse WTP, AngularJS Eclipse Plugin)
• Jade (Node.js template engine; Nodeclipse/Enide Minimalist Jade Editor)
• Java
• Java properties (Eclipse JDT, Properties Editor)
• JavaScript
• Json (Json Eclipse Plugin, Eclipse Json Editor Plugin, JsonTools)
• JSP
• Markdown
• PDE
• Perl
• PHP
• Puppet (Gepetto)
• Python
• R (StatET)
• Ruby
• Scala
• Spket IDE (JavaScript and XML)
• SQL
• TCL
• Text
• Twig
• TypeScript
• XML
• XSL
• Xtend
• Yaml (Yedit)

Bundled themes:

• Black Pastel
• frontenddev
• Gedit Original Oblivion
• Havenjark
• Inkpot
• minimal
• Monokai
• Mr
• NightLion Aptana Theme
• Notepadd++ Like
• Oblivion
• Obsidian
• Pastel
• RainbowDrops by Andrea Guarinoni
• RecognEyes
• Retta
• Roboticket
• Schuss
• Solarized Dark
• Solarized Light
• Sublime Text 2
• Sunburst
• Tango
• Vibrant Ink
• Wombat
• Zenburn

You can download additional themes or create your own on eclipsecolorthemes.org.

Adding a theme

To create a new theme, go to eclipsecolorthemes.org, create it, download it in *.xml format and import it from the Color Theme preference page.

Adding a mapping

If you would like to add an editor mapping, proceed as follows:

1. Go to the syntax coloring preferences page of the editor, e.g. C/C++->Editor->Syntax Coloring.

2. Look at the colour theme keys of one theme (See ColorThemeKeys for all available keys) and set up the syntax colouring using the colours defined there.

3. Open the editor's preferences file, e.g. workspace/.metadata/.plugins/org.eclipse.core.runtime/.settings/org.eclipse.cdt.ui.prefs and create a new XML file named after the plugin ID in the mapper directory which maps the colour theme's keys to those of the editor.

4. Open plugin.xml and add the new mapping file to the extension point com.github.eclipsecolortheme.theme.

Adding a mapping explanation by Andrea Guarinoni

Add here a new XML with the same name of your .pref file (eg. org.nodeclipse.enide.editors.gradle.xml) and place into that file your mappings for the color's preferences keys:

<eclipseColorThemeMapping plugin="org.nodeclipse.enide.editors.gradle" created="2014-05-02 13:10:08">
    <mappings>
        <mapping pluginKey="color_comment" themeKey="singleLineComment"/>
        ....
    </mappings>
</eclipseColorThemeMapping>

Finally add to plugin.xml your <mapper> properties to the extension point com.github.eclipsecolortheme.mapper.

Building

Generating an update site

If you just want to generate an update site from the sources, you can do so using Maven:

mvn clean verify

This will create an update site in com.github.eclipsecolortheme.updatesite/target/repository.

Development

All you need is Eclipse PDE. Once you have that, you can import the projects in this repository into an Eclipse workspace.

License

Copyright (C) 2011-2014 Felix H. Dahlke and Roger Dudler

This is open source software, licensed under the Eclipse Public License. See the file COPYING for details.