/ST-BootstrapAutocomplete

Sublime Text 4 plugin for Bootstrap class name autocompletion.

Primary LanguagePythonMIT LicenseMIT

ST-BootstrapAutocomplete

Required ST Build GitHub Actions Package Control GitHub tag (latest SemVer) Project license GitHub stars Donate to this project using Paypal

This Sublime Text 4 plugin means to unify other Bootstrap autocompletion plugins.

This plugin is designed to support various versions of Bootstrap's autocompletion with ease. At this moment, it supports Bootstrap 2, 3, 4 (default) and 5. If you find a missing class name, an issue or pull request is always welcome.

screenshot-st4

Installation

This package is available on Package Control by the name of BootstrapAutocomplete.

Global Settings

From the main menu: Preferences » BootstrapAutocomplete » Settings

{
    // scopes that this plugin should activated
    "selectors": [
        "text.html string.quoted - meta.path",
        "text.html meta.attribute-with-value.class",
    ],
    // targeted Bootstrap versions (available versions are: "2", "3", "4", "5")
    "versions": ["4"],
}

Project Settings

You most likely want to use only a specific version of Bootstrap in a project. In that case, you can specify the version(s) you want to use in your project settings.

From the main menu: Project » Edit Project

{
    "folders":
    [
        // ...
    ],
    "settings": {
        // settings here will override global settings
        "BootstrapAutocomplete": {
            // use Bootstrap 5 for this project.
            "versions": ["5"],
        },
    },
}

For Plugin Developers

This plugin's autocompletion lists are extracted from

  • Official Bootstrap v2.3.2
  • Official Bootstrap v3.4.1
  • Official Bootstrap v4.6.2
  • Official Bootstrap v5.2.2

with scripts/extract_class_names_auto.sh.

# setup environment
python -m venv .venv
source .venv/Scripts/activate # if on Windows
source .venv/bin/activate # if not on Windows
python -m pip install -U -r requirements.txt

# extract class names
bash "scripts/extract_class_names_auto.sh"