Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
mallowigi authored Sep 13, 2017
1 parent 5169f95 commit 9a9edbe
Showing 1 changed file with 46 additions and 8 deletions.
54 changes: 46 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,9 @@

This is a [Material Theme](https://github.com/equinusocio/material-theme) port of both the IDE and Color scheme for JetBrains products.

**Please note:** This is a work in progress. There are some work to be done before this can be considered stable.

Special thanks to [@mallowigi](https://github.com/mallowigi) for doing a fantastic job keeping the plugin alive and extending it with some very nice features. Well done!

Note: You can have a sneak peak of the features to come in his repository:
Note: You can have a sneak peek of the features to come in his repository:
[Material Theme Jetbrains EAP](https://github.com/mallowigi/material-theme-jetbrains-eap)

Buy me a beer:
Expand All @@ -30,6 +28,7 @@ And him too :*
* [Configuration](#configuration)
* [Development](#development)
* [Contribution](#contribution)
* [Known Issues](#known-issues)
* [Screenshots](#screenshots)
* [Authors](#authors)
* [Icon Reference](#icon-reference)
Expand All @@ -54,6 +53,8 @@ Note: This is not installing a new Look And Feel, instead, it is **overwriting**
LAF and select back *Darcula*, you will revert to the original Darcula LAF. You will probably need to restart the IDE to retrieve the
Material LAF.

--------------------

### Switching the IDE theme

There are many ways to change the Material Theme Look and Feel of the IDE:
Expand All @@ -70,16 +71,20 @@ There are currently 4 bundled themes:

And you can also disable the theming and revert to the original Darcula, while still keeping Material Theme additions such as the icons and UI components.

#### Custom Themes
-------------------

### Custom Themes

Since version 0.10.0 with the possibility to add custom themes, two new themes have been added (without their color schemes and file
colors):
- **Monokai**, the theme used in **Sublime Text**
- **Arc Dark**, from https://github.com/horst3180/arc-theme
- **One Dark**, from **Atom One Dark Theme**

With the ability to set up custom themes, we can even start to host a gallery of custom themes I will add some that are the most popular,
or even give the ability to import them. But it's still far away! :)

-----------------

### Set color scheme (code)
This plugin will not set the new color scheme for you, as that would cause a couple problems. You need to set the new color scheme manually:
Expand Down Expand Up @@ -109,6 +114,8 @@ https://intellij-support.jetbrains.com/hc/en-us/articles/206544519-Directories-u

Then delete the *"@_user_Material Theme"* icls files.

-------------

### Custom Themes (alpha version)

Since version 10.0 it is now possible to customize the Material Theme's theme colors to your own desires. You can find the options under
Expand All @@ -120,6 +127,8 @@ In order to select your custom theme, you will need to select the theme inside t
**Note (Important!)**: Because of how things work, currently it is not possible to change the whole IDE colors on the fly. You will need
to do a full restart of the IDE to get your custom colors to work on the whole application.

-----------------

### Material Status File Colors

Since the latest releases IntelliJ IDEA removed the option to set colors to specific file statuses (added to VCS, modified, ignores...).
Expand All @@ -128,6 +137,8 @@ This plugin is giving the opportunity to set it back, but only in the Project Tr
You can find the settings to set the file colors under **Colors and Fonts** -> **Material File Colors**. Of course, this is *per color
scheme*, not *per theme*, so please take this into consideration.

-----------------

### File Colors

*File Colors* is an option in IntelliJ IDEA to put a background color in the Project View and Tabs to certain files belonging to a scope.
Expand All @@ -140,6 +151,7 @@ So, much like color schemes, the *Material Theme* is now prebundled with specifi

However, to be able to see them take priority, you would have to put your relevant file color **at the top**, before the ones bundled with IDEA. It is not done automatically as we don't want to override user settings, so make sure to do so if you want to use them.

-----------------

### Default Font

Expand All @@ -150,6 +162,8 @@ Don't forget though that the plugin doesn't come with the aforementioned font. T

Just install the font (if you want to), then restart the IDE to see if you like it :)

-------------------

### Contrast Mode

Much like the Sublime plugin, the plugin also comes with a **Contrast Mode** to put more contrast between different components of the IDE. These elements are:
Expand All @@ -159,7 +173,7 @@ Much like the Sublime plugin, the plugin also comes with a **Contrast Mode** to

To set/unset the Contrast Mode, either go to *Settings -> Tools -> Material Theme* and check/uncheck `Contrast Mode`, or click on the black and white icon on the Main Toolbar.


-------------------

### Custom Wallpaper

Expand All @@ -171,6 +185,8 @@ Therefore some things need to be known:
- If you want to disable the background completely, set the custom wallpaper path to be empty and the checkbox on, then click Apply, and finally uncheck the option and save.
- And same if you want to disable the plugin, it will not revert back the blank wallpaper, you will have to open the IDE's dialog.

-------------------

### Custom Accents

From version 0.7.0 the plugin can now have different accent colors! To change the Accent Color, just press on the *Accents* Action Button on the Toolbar/Quick Switch/Tools,
Expand All @@ -189,7 +205,9 @@ The Accent Color is changing:
- Autocomplete
- Quick info

## Project View Decorators
---------------------

### Project View Decorators

Another feature taken from the Sublime Plugin is the ability to differentiate **opened directories** from closed ones. *"Opened directories"* actually mean
directories from the project view whose one of their children is opened in the Editor.
Expand All @@ -198,6 +216,8 @@ The plugin is decorating these directories by setting an "outlined" directory ic

You can disable this behavior through the Settings or the Action Buttons in the toolbar.

--------------------

## Configuration

You can customize some plugin features in a Settings Panel under **Settings** -> **Appearance** -> **Material Theme**:
Expand All @@ -224,7 +244,9 @@ Component Settings:
- *Project View Decorators*: Enable/Disable the Project View Decorators. See the above section about separators.
- *Themed Scrollbars*: Enable/Disable transparency in scrollbars

More features are to come!
Keep in touch for new features!

---------------

## Development

Expand All @@ -243,12 +265,29 @@ can run the above mentioned CLI Gradle tasks directly in the "Gradle" Tool
Window, which expands from the right side of the screen. To debug, find
"runIde" in the list, right-click it, and choose Run/Debug.

---------------

## Contribution

Pull requests are appreciated! I can use some help on bugs and features listed in [https://github.com/mallowigi/material-theme-jetbrains/projects/1], or you can send me some new ideas!

However, please note that this is a plugin dedicated to replicate the Sublime plugin, so it should coincide with its features and not deviate too much.

----------------

## Known Issues

### Material Wallpaper

Since the Material Wallpaper is making use of a somewhat hidden feature of the IDE allowing users to change their background wallpaper and is not providing its own, removing or disabling the plugin **does not** remove the wallpaper set by the plugin. Currently the implementation is trying its best to do so by caching the wallpaper set by the user at start, and restoring this wallpaper on exit, but if somehow the wallpaper is still there despite having deleted/disabled the plugin, here is how to remove it:

- Close all open editors
- Open Command Palette (Cmd+Shift+A/Ctrl+Shift+A)
- Type "Set background image"
- Change/delete the background image



## Screenshots
#### Darker theme
![Darker theme](https://plugins.jetbrains.com/files/9377/screenshot_17081.png)
Expand Down Expand Up @@ -319,7 +358,6 @@ Also many thanks to other plugin developers for helping me solving A LOT of issu
* [Browse Word At Caret](https://plugins.jetbrains.com/plugin/201-browsewordatcaret)
* [GitIgnore](https://github.com/hsz/idea-gitignore)
* [Project Label](https://github.com/drinchev/project-label)
* And of course the original plugin [Material Theme UI](https://plugins.jetbrains.com/plugin/8006-material-theme-ui)

Thanks to all [original plugin contributors](https://github.com/ChrisRM/material-theme-jetbrains/graphs/contributors), [EAP contributors](https://github.com/mallowigi/material-theme-jetbrains-eap/graphs/contributors)
and a special thanks to the guys at [JetBrains](https://www.jetbrains.com/) for contributing and showing interest in the project!
Expand Down

0 comments on commit 9a9edbe

Please sign in to comment.