vsc-material-theme/README.md

174 lines
10 KiB
Markdown
Raw Normal View History

2018-04-20 20:07:36 +02:00
2019-02-06 14:21:23 +01:00
<p align="center"><img width="800px" src="https://i.ibb.co/LzRwxp4/Frame.jpg"></p>
2019-02-06 14:17:57 +01:00
<p align="center">
2020-05-15 18:37:04 +02:00
<a href="https://marketplace.visualstudio.com/items?itemName=Equinusocio.vsc-material-theme#review-details"><img src="https://vsmarketplacebadge.apphb.com/rating-star/Equinusocio.vsc-material-theme.svg?style=for-the-badge&colorA=FBBD30&colorB=F2AA08"/></a> <a href="https://marketplace.visualstudio.com/items?itemName=Equinusocio.vsc-material-theme"><img src="https://vsmarketplacebadge.apphb.com/downloads-short/Equinusocio.vsc-material-theme.svg?style=for-the-badge&colorA=5DDB61&colorB=4BC74F&label=DOWNLOADS"/></a> <br> <a href="https://a.paddle.com/v2/click/16413/37697?link=1227"><img src="https://img.shields.io/badge/Supported%20by-VSCode%20Power%20User%20%E2%86%92-gray.svg?colorA=655BE1&colorB=4F44D6&style=for-the-badge"/></a> <a href="https://a.paddle.com/v2/click/16413/37697?link=2345"><img src="https://img.shields.io/badge/Supported%20by-Node%20Cli.com%20%E2%86%92-gray.svg?colorA=61c265&colorB=4CAF50&style=for-the-badge"/></a>
2019-02-06 13:18:19 +01:00
</p>
2019-02-06 14:17:57 +01:00
2020-01-11 00:10:01 +01:00
The most epic theme meets Visual Studio Code. You can help by reporting issues [here](https://github.com/material-theme/vsc-material-theme/issues).
2018-04-20 20:07:36 +02:00
- [Getting started](#getting-started)
2019-02-08 11:46:01 +01:00
- [Installation](#installation)
2019-05-25 16:45:07 +02:00
- [Activate theme](#activate-theme)
- [Set the accent color](#set-the-accent-color)
- [Override theme colors](#override-theme-colors)
- [Color Scheme override](#color-scheme-override)
2018-04-20 20:07:36 +02:00
- [Recommended settings for a better experience](#recommended-settings-for-a-better-experience)
2018-04-20 21:59:55 +02:00
- [Official Portings](#official-portings)
2018-04-20 20:07:36 +02:00
- [Other resources](#other-resources)
- [Contributors](#contributors)
- [Backers](#backers)
- [Sponsors](#sponsors)
2018-04-20 20:07:36 +02:00
## Getting started
2018-04-20 20:07:36 +02:00
You can install this awesome theme through the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Equinusocio.vsc-material-theme).
### Installation
2018-04-20 20:07:36 +02:00
Launch *Quick Open*:
2018-04-20 20:07:36 +02:00
- <img src="https://www.kernel.org/theme/images/logos/favicon.png" width=16 height=16/> <a href="https://code.visualstudio.com/shortcuts/keyboard-shortcuts-linux.pdf">Linux</a> `Ctrl+P`
- <img src="https://developer.apple.com/favicon.ico" width=16 height=16/> <a href="https://code.visualstudio.com/shortcuts/keyboard-shortcuts-macos.pdf">macOS</a> `⌘P`
- <img src="https://www.microsoft.com/favicon.ico" width=16 height=16/> <a href="https://code.visualstudio.com/shortcuts/keyboard-shortcuts-windows.pdf">Windows</a> `Ctrl+P`
Paste the following command and press `Enter`:
```shell
2018-11-19 17:55:10 +01:00
ext install material theme
2018-04-20 20:07:36 +02:00
```
2020-09-30 21:11:09 +02:00
And pick the one by **Mattia Astorino (Equinusocio)** as author.
2018-04-20 20:07:36 +02:00
## Activate theme
Launch *Quick Open*:
2018-04-20 20:07:36 +02:00
- <img src="https://www.kernel.org/theme/images/logos/favicon.png" width=16 height=16/> <a href="https://code.visualstudio.com/shortcuts/keyboard-shortcuts-linux.pdf">Linux</a> `Ctrl + Shift + P`
- <img src="https://developer.apple.com/favicon.ico" width=16 height=16/> <a href="https://code.visualstudio.com/shortcuts/keyboard-shortcuts-macos.pdf">macOS</a> `⌘ + Shift + P`
- <img src="https://www.microsoft.com/favicon.ico" width=16 height=16/> <a href="https://code.visualstudio.com/shortcuts/keyboard-shortcuts-windows.pdf">Windows</a> `Ctrl + Shift + P`
Type `theme`, choose `Preferences: Color Theme`, and select one of the Material Theme variants from the list. After activation, the theme will set the correct icon theme based on your active theme variant.
2018-04-20 20:07:36 +02:00
## Set the accent color
Launch *Quick Open*:
2018-04-20 20:07:36 +02:00
- <img src="https://www.kernel.org/theme/images/logos/favicon.png" width=16 height=16/> <a href="https://code.visualstudio.com/shortcuts/keyboard-shortcuts-linux.pdf">Linux</a> `Ctrl + Shift + P`
- <img src="https://developer.apple.com/favicon.ico" width=16 height=16/> <a href="https://code.visualstudio.com/shortcuts/keyboard-shortcuts-macos.pdf">macOS</a> `⌘ + Shift + P`
- <img src="https://www.microsoft.com/favicon.ico" width=16 height=16/> <a href="https://code.visualstudio.com/shortcuts/keyboard-shortcuts-windows.pdf">Windows</a> `Ctrl + Shift + P`
Type `material theme`, choose `Material Theme: Set accent color`, and pick one color from the list.
2018-04-20 20:07:36 +02:00
## Override theme colors
You can override the Material Theme UI and schemes colors by adding these theme-specific settings to your configuration. For advanced customisation please check the [relative section on the VS Code documentation](https://code.visualstudio.com/docs/getstarted/themes#_customizing-a-color-theme).
2018-04-20 20:07:36 +02:00
2018-04-25 09:50:31 +02:00
### Color Scheme override
2018-04-25 09:49:50 +02:00
**Basic example**
2018-04-20 20:07:36 +02:00
```js
"editor.tokenColorCustomizations": {
"[Material Theme]": {
"comments": "#229977"
2018-04-25 09:48:40 +02:00
}
2018-04-20 20:07:36 +02:00
},
2018-04-25 09:48:40 +02:00
```
2018-04-25 09:49:50 +02:00
**Advanced example**
2018-04-25 09:48:40 +02:00
```js
2018-04-25 09:49:50 +02:00
"editor.tokenColorCustomizations": {
"[Material Theme VARIANT]": {
"textMateRules": [
{
"scope": [
2020-05-15 15:44:36 +02:00
"comment",
"comment punctuation.definition.comment"
2018-04-25 09:49:50 +02:00
],
"settings": {
"foreground": "#FF0000"
2018-04-25 09:48:40 +02:00
}
2018-04-25 09:49:50 +02:00
}
]
2018-04-25 09:48:40 +02:00
},
2018-04-25 09:49:50 +02:00
},
Develop (#377) * fix: Fix search highlight matched result color Close #358 * fix: Fix inputs selection background Close #362 * Release: 29.1.0 * feat: Add support for tree's guidelines * fix: Fix terminal cursor color * Release 29.2 * chore(deps): bump handlebars from 4.1.0 to 4.1.2 (#368) * Release 29.2 (#367) * fix: Fix search highlight matched result color Close #358 * fix: Fix inputs selection background Close #362 * Release: 29.1.0 * feat: Add support for tree's guidelines * fix: Fix terminal cursor color * Release 29.2 * chore(deps): bump handlebars from 4.1.0 to 4.1.2 Bumps [handlebars](https://github.com/wycats/handlebars.js) from 4.1.0 to 4.1.2. - [Release notes](https://github.com/wycats/handlebars.js/releases) - [Changelog](https://github.com/wycats/handlebars.js/blob/master/release-notes.md) - [Commits](https://github.com/wycats/handlebars.js/compare/v4.1.0...v4.1.2) Signed-off-by: dependabot[bot] <support@github.com> * chore(deps): bump js-yaml from 3.12.1 to 3.13.1 (#369) * Release 29.2 (#367) * fix: Fix search highlight matched result color Close #358 * fix: Fix inputs selection background Close #362 * Release: 29.1.0 * feat: Add support for tree's guidelines * fix: Fix terminal cursor color * Release 29.2 * chore(deps): bump js-yaml from 3.12.1 to 3.13.1 Bumps [js-yaml](https://github.com/nodeca/js-yaml) from 3.12.1 to 3.13.1. - [Release notes](https://github.com/nodeca/js-yaml/releases) - [Changelog](https://github.com/nodeca/js-yaml/blob/master/CHANGELOG.md) - [Commits](https://github.com/nodeca/js-yaml/compare/3.12.1...3.13.1) Signed-off-by: dependabot[bot] <support@github.com> * Update readme
2019-07-29 09:58:27 +02:00
"workbench.colorCustomizations": {
"[Material Theme VARIANT]": {
"sideBar.background": "#ff0000",
}
},
2018-04-25 09:48:40 +02:00
```
## Recommended settings for a better experience
2018-04-20 20:07:36 +02:00
```js
{
// Controls the font family.
"editor.fontFamily": "Operator Mono",
// Controls the line height. Use 0 to compute the lineHeight from the fontSize.
"editor.lineHeight": 24,
// Enables font ligatures
"editor.fontLigatures": true,
// Controls if file decorations should use badges.
"explorer.decorations.badges": false
}
```
## Official Portings
2020-02-15 12:58:58 +01:00
Thanks to the Material Theme community you can use it with other software, here are the official portings:
2018-04-20 21:59:55 +02:00
2019-11-11 18:38:13 +01:00
- [Windows Terminal](https://github.com/julianlatest/material-windows-terminal) (by [@julianlatest](https://github.com/julianlatest))
2019-07-08 16:08:19 +02:00
- [Vim and NeoVim](https://github.com/kaicataldo/material.vim) (by [@kaicataldo](https://github.com/kaicataldo))
2018-07-01 18:55:38 +02:00
- [Vim](https://github.com/hzchirs/vim-material) (thanks to [@hzchirs](https://github.com/hzchirs)).
2018-04-20 21:59:55 +02:00
- [Terminal OSX](https://gist.github.com/mvaneijgen/4c56701215847dd5ddcf) (thanks to [@mvaneijgen](https://github.com/mvaneijgen)).
- [iTerm2](https://gist.github.com/Revod/3f3115f8d4b90fc986fd4b61441c2567) (by [@Revod](https://github.com/Revod)) and [iTerm2 Palenight](https://github.com/JonathanSpeek/palenight-iterm2) (by [@jonathanspeek](https://github.com/jonathanspeek)).
- [Hyper](https://github.com/equinusocio/hyper-material-theme).
- [ConEmu](https://gist.github.com/rajadain/b306b2ba71bd58a1df41) (thanks to [@rajadain](https://github.com/rajadain)).
- [Slack App](https://slack.com/) ( #263238,#2e3a40,#80CBC4,#FFFFFF,#13191C,#ffffff,#50fa7b,#FF5555 )
- [Nylas N1](https://github.com/jackiehluo/n1-material) (thanks to [@jackiehluo](https://github.com/jackiehluo))
- [Base16](https://github.com/ntpeters/base16-materialtheme-scheme) (by [@ntpeters](https://github.com/ntpeters))
- [Bear Notes](https://github.com/r3volution11/material-theme-bear-notes) (by [@r3volution11](https://github.com/r3volution11))
2020-05-06 23:00:07 +02:00
- [Mattermost](https://gist.github.com/k1r8r0wn/47cfa776a6fa4e9bf3fa40df0fb76c2c) (by [@k1r8r0wn](https://github.com/k1r8r0wn))
2020-11-27 17:26:04 +01:00
- [Material Theme to GitHub](https://github.com/CharlieEtienne/material-github)
2018-04-20 21:59:55 +02:00
## Other resources
2020-01-11 00:10:01 +01:00
- **AppIcon:** [Download](https://github.com/material-theme/vsc-material-theme/files/989048/vsc-material-theme-appicon.zip) the official Material Theme app icon for Visual Studio code
2018-04-20 20:07:36 +02:00
## Contributors
This project exists thanks to all the people who contribute. [[Contribute]](CONTRIBUTING.md).
2020-09-17 11:42:33 +02:00
<a href="graphs/contributors"><img src="https://opencollective.com/material-theme/contributors.svg?width=890" /></a>
2018-04-20 20:07:36 +02:00
## Backers
2020-09-17 11:42:33 +02:00
Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/material-theme#backer)]
2018-04-20 20:07:36 +02:00
2020-09-17 11:42:33 +02:00
<a href="https://opencollective.com/material-theme#backers" target="_blank"><img src="https://opencollective.com/material-theme/backers.svg?width=890"></a>
2018-04-20 20:07:36 +02:00
## Sponsors
2020-09-17 11:42:33 +02:00
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/material-theme#sponsor)]
<a href="https://opencollective.com/material-theme/sponsor/0/website" target="_blank"><img src="https://opencollective.com/material-theme/sponsor/0/avatar.svg"></a>
<a href="https://opencollective.com/material-theme/sponsor/1/website" target="_blank"><img src="https://opencollective.com/material-theme/sponsor/1/avatar.svg"></a>
<a href="https://opencollective.com/material-theme/sponsor/2/website" target="_blank"><img src="https://opencollective.com/material-theme/sponsor/2/avatar.svg"></a>
<a href="https://opencollective.com/material-theme/sponsor/3/website" target="_blank"><img src="https://opencollective.com/material-theme/sponsor/3/avatar.svg"></a>
<a href="https://opencollective.com/material-theme/sponsor/4/website" target="_blank"><img src="https://opencollective.com/material-theme/sponsor/4/avatar.svg"></a>
<a href="https://opencollective.com/material-theme/sponsor/5/website" target="_blank"><img src="https://opencollective.com/material-theme/sponsor/5/avatar.svg"></a>
<a href="https://opencollective.com/material-theme/sponsor/6/website" target="_blank"><img src="https://opencollective.com/material-theme/sponsor/6/avatar.svg"></a>
<a href="https://opencollective.com/material-theme/sponsor/7/website" target="_blank"><img src="https://opencollective.com/material-theme/sponsor/7/avatar.svg"></a>
<a href="https://opencollective.com/material-theme/sponsor/8/website" target="_blank"><img src="https://opencollective.com/material-theme/sponsor/8/avatar.svg"></a>
<a href="https://opencollective.com/material-theme/sponsor/9/website" target="_blank"><img src="https://opencollective.com/material-theme/sponsor/9/avatar.svg"></a>
2018-04-20 20:07:36 +02:00
---
2020-01-11 00:10:01 +01:00
<p align="center"> <img src="https://equinusocio.gallerycdn.vsassets.io/extensions/material-theme/vsc-material-theme/0.0.14/1494970083238/Microsoft.VisualStudio.Services.Icons.Default" width=16 height=16/> Copyright &copy; 2019 Mattia Astorino & Alessio Occhipinti</p>
2018-04-20 20:07:36 +02:00
2019-01-10 11:07:35 +01:00
<p align="center"><a href="http://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/License-Apache_2.0-5E81AC.svg?style=flat-square"/></a></p>