initial commit 0.10.0

Author: maximetinu

LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <http://unlicense.org>

README.md

@@ -0,0 +1,54 @@
+# Sublime Text Monokai C# theme for Visual Studio Code
+[![License: Unlicense](https://img.shields.io/badge/license-Unlicense-blue.svg)](http://unlicense.org/)
+
+This theme is exactly the same Monokai's theme of Sublime Text but for Visual Studio Code instead. Unlike default VSCode's Monokai, this is an actual, perfect and identical copy of the loved by all Sublime Text's theme. It's name is **Sublime Monokai**.
+
+   - [Visual Studio Marketplace: Theme&Colorizer Extension](https://marketplace.visualstudio.com/items?itemName=maximetinu.identical-sublime-monokai-csharp-theme-colorizer)
+## Screenshots
+![Sublime monokai theme demo](/screenshots/sublime-monokai-demo.png?raw=true "Sublime monokai theme demo")
+### Comparison between this theme and Sublime Text's
+![This theme vs Sublime Text's](/screenshots/sublime-monokai-vs-sublime-text.png?raw=true "This theme vs Sublime Text's")
+### Comparison between default VSCode Monokai theme and Sublime Text's
+Observe the differences. Is subtle but it's there.
+![Default VSCode Monokai vs Sublime Text's](/screenshots/default-monokai-vs-sublime-text.png?raw=true "Default VSCode Monokai vs Sublime Text's")
+## Instructions
+Option 1, search for the extension in Visual Studio Code Marketplace:
+1. At the Welcome tab *(Help>Welcome)* click "Tools and languages" and search by my "identical sublime monokai theme". Install it.
+2. Ready to code!
+
+Option 2, install it as a local VSCode extension:
+1. Copy the folders in this repository *csharp-sublime-colorizer* and *theme-sublime-monokai* into your folder *<User Home>/.vscode/extensions/*.
+2. Ready to code!
+   
+Make sure that you choose the **Sublime Monokai** color theme at the Welcome tab *(Help>Welcome)* and check bottom right if **C# Sublime Colorizer** is working instead of the default C#, as can be seen in the next screenshot:
+![Sublime colorizer working](/screenshots/sublime-colorizer-working.png?raw=true "Sublime colorizer working")
+
+**Why override C# parser/colorizer if it's a theme? Keep reading.**
+
+---
+
+## Why default VSCode's Monokai is so different from Sublime Text's?
+There are two reasons.
+
+First of all, VSCode's theme assign the same style to certains colorizer rules which differ each other in Sublime Text. It's possible to solve it by modifying the default VSCode Monokai's theme.
+
+Secondly, no matter how much we modify default VSCode's Monokai, it's impossible to get the same color scheme as Sublime Text due to limitations of the C# colorizer that uses VSCode. On the one hand, VSCode groups in the same selector two things which are different styled in Sublime Text, and it is not possible to assign different styles to things with the same selector. On the other hand, the VSCode C# colorizer is more limited due to it is only possible to assign one single selector to each code token, unlike Sublime Text's colorizer, which allows the assignment of multiple selectors to increase flexibility when it comes to styling. This is because VSCode uses a *.tmLanguage* file as colorizer while Sublime Text uses *.sublime-syntax* files to make the parsing. It is possible to convert from *.tmLanguage* to *.sublime-syntax*, but not the opposite, since *.sublime-syntax* is a superset of *.tmLanguage* functionality, so it is not possible to convert in such a way.
+
+In the next screenshot can be seen the gap between the two colorizers:
+![tmlanguage vs sublime syntax](/screenshots/tmlanguage-vs-sublimesyntax.png?raw=true "tmlanguage vs sublime syntax")
+### So, what's the trick, then?
+I've modified the VSCode C# colorizer (the *.tmLanguage* file) to differentiate differents elements. Once that's done, I've modified the default VSCode's Monokai theme to assign the styles as Sublime Text does. That's why it's necessary to modify the official C# parser folder.
+
+**Happy coding!** now with Monokai ;)
+
+---
+
+**UNLICENSED** 
+
+[![License: Unlicense](https://img.shields.io/badge/license-Unlicense-blue.svg)](http://unlicense.org/)
+
+   - Only tested in Windows 10, but it should also work in MacOS and Linux.
+   - Only tested with C#, but it should also work for other programming languages. It should be more like Sublime's Monokai working with any language, but it won't be as accurate as with C# since the only colorizer modified is the C# parser.
+   - Only tested with Visual Studio Code, but it should also work with Visual Studio IDE as long as the *.tmLanguage* file (the colorizer) is modified or replaced and the theme is installed too.
+   
+In general, it should also work in any editor which uses the same Text Mate grammar tokens as theme and the *.tmLanguage* as colorizer, as Text Mate editor itself.

screenshots/default-monokai-vs-sublime-text.png

@@ -0,0 +1,9 @@
+// ATTENTION - THIS DIRECTORY CONTAINS THIRD PARTY OPEN SOURCE MATERIALS:
+
+[{
+	"name": "maximetinu/sublime-monokai-theme-colorizer",
+	"version": "0.1.0",
+	"license": "UNLICENSED",
+	"repositoryURL": "https://github.com/Maximetinu/Sublime-Text-Monokai-theme-for-Visual-Studio-Code",
+	"description": "Actual, perfect and identical Monokai Sublime Text Theme for Visual Studio Code and C# colorizer to make it possible"
+}]

screenshots/sublime-colorizer-working.png

@@ -0,0 +1,25 @@
+# Sublime Text Monokai C# theme for Visual Studio Code
+[![License: Unlicense](https://img.shields.io/badge/license-Unlicense-blue.svg)](http://unlicense.org/)
+
+This theme is exactly the same Monokai's theme of Sublime Text but for Visual Studio Code instead. Unlike default VSCode's Monokai, this is an actual, perfect and identical copy of the loved by all Sublime Text's theme. It's name is **Sublime Monokai**.
+
+---
+
+**Important!** Make sure that you choose the **Sublime Monokai** color theme at the Welcome tab *(Help>Welcome)* and check bottom right if **C# Sublime Colorizer** is working instead of the default C#, as can be seen in the next screenshot:
+
+![Sublime colorizer working](/screenshots/sublime-colorizer-working.png?raw=true "Sublime colorizer working")
+
+---
+
+## Screenshots
+![Sublime monokai theme demo](/screenshots/sublime-monokai-demo.png?raw=true "Sublime monokai theme demo")
+### Comparison between this theme and Sublime Text's
+![This theme vs Sublime Text's](/screenshots/sublime-monokai-vs-sublime-text.png?raw=true "This theme vs Sublime Text's")
+### Comparison between default VSCode Monokai theme and Sublime Text's
+Observe the differences. Is subtle but it's there.
+
+![Default VSCode Monokai vs Sublime Text's](/screenshots/default-monokai-vs-sublime-text.png?raw=true "Default VSCode Monokai vs Sublime Text's")
+
+**Why override C# parser/colorizer if it's a theme? Keep reading [the repo](https://github.com/Maximetinu/Identical-Sublime-Text-Monokai-theme-for-Visual-Studio-Code)**
+
+**Happy coding!** now with Monokai ;)