## Usage
### Installation
#### Package Control
1. In Sublime Text, open the command palette with Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS).
2. Enter and select `Install Package Control` to install Package Control if not done so already.
3. Enter and select `Package Control: Install Package`.
3. Search for and select the _Catppuccin_ package.
#### Git download
1. In Sublime Text, locate the path to the `Packages` directory through the **Preferences** > **Browse Packages...** menu.
2. From the command line, go to the previously noted directory path and clone the repository into it.
```
git clone https://github.com/catppuccin/sublime-text.git Catppuccin
```
#### Manual download
1. Download [this repository as a ZIP archive](https://github.com/catppuccin/sublime-text/archive/refs/heads/main.zip).
2. Unzip into a directory named `Catppuccin`.
3. In Sublime Text, open the `Packages` directory through the **Preferences** > **Browse Packages...** menu.
4. Move the unzipped `Catppuccin` directory into the `Packages` directory.
### Activation
1. In Sublime Text, select your flavor of choice through **Preferences** > **Select Color Scheme**.
2. Go to **Preferences** > **Select Theme...** and select `Adaptive`.
## Development
If you're unfamiliar with Sublime Text color scheme development, see ["Color Schemes" in the Sublime Text documentation](https://www.sublimetext.com/docs/color_schemes.html).
This repository uses [Whiskers](https://github.com/catppuccin/whiskers) to generate theme files. Edit the `sublime-text.tera` template, and run `whiskers sublime-text.tera` to update the files in `build/`.
For local editing, create a symlink from your local clone of this repository to the `Catppuccin` subdirectory of the `Packages` directory (revealed through the **Preferences** > **Browse Packages...** menu in Sublime Text). On macOS, this can be done by invoking `ln -s $(pwd) ~/Library/Application\ Support/Sublime\ Text/Packages/` in the directory of this repository. Uninstall the Catppuccin theme from Package Control if installed via that method. Sublime Text should now automatically reload the theme files in `build/` on change.
If you have a specific piece of code you would like to re-color, you'll need to know what scopes are being applied to the token. (Applying scopes is done by the syntax, not the color scheme.) Position your caret over the token, and use Ctrl+Shift+P (or **Tools** > **Developer** > **Show Scope Name**) to show the scopes of the current token.
## 💝 Thanks to
- [BrunDerSchwarzmagier](https://github.com/BrunDerSchwarzmagier)
- [ghostx31](https://github.com/ghostx31)
- [Matthias Portzel](https://github.com/MatthiasPortzel)

Copyright © 2021-present Catppuccin Org
