Universal-Assembly-Syntax-Highlighting/README.md

## Обзор 🛠️

Это расширение для Visual Studio Code обеспечивает полноценную подсветку синтаксиса для ассемблера x86, x64 и ARM с использованием синтаксиса Intel. Оно создано для улучшения читаемости и понимания ассемблерного кода, включая вывод компиляторов.

## Возможности ✨

- Подсветка синтаксиса инструкций ассемблера x86, x64 и ARM 💻
- Поддержка синтаксиса Intel 🧠
- Подсветка регистров, операндов памяти и числовых констант 🔍
- Распознавание стандартных директив ассемблера ⚙️
- Правильная подсветка меток и имён функций 🏷️
- Поддержка возможностей ассемблерного вывода компиляторов (например, CFI директивы) 🛡️
- **Поддержка языка КВС** — ассемблера с русским синтаксисом для x86-64 🇷🇺

## Установка 🚀

### Способ 1: Установка из маркета расширений

1. Откройте Visual Studio Code
2. Перейдите в раздел расширений (Ctrl+Shift+X или Cmd+Shift+X на macOS)
3. Найдите "Universal Assembly Syntax Highlighting"
4. Нажмите Установить

### Способ 2: Ручная установка

1. Склонируйте или скачайте репозиторий расширения
2. Откройте командную палитру (Ctrl+Shift+P)
3. Выполните команду `Developer: Open Extensions Folder`
4. Скопируйте папку с расширением в открывшуюся директорию
5. Перезапустите VS Code

## Использование 💡

После установки расширение будет автоматически подсвечивать синтаксис файлов со следующими расширениями:

- `.asm`
- `.s`
- `.S`
- `.nasm`
- `.asmx`
- `.inc`
- `.квс` — файлы ассемблера КВС

Если вы работаете с файлом, имеющим другое расширение, но содержащим код ассемблера x86/x64, вы можете вручную установить режим языка:

1. Нажмите на индикатор языка в правом нижнем углу VS Code
2. Выберите "x86/x64 Assembly" из списка языков

## Подсвечиваемые элементы 🎨

Это расширение обеспечивает подсветку синтаксиса для:

- Инструкций (например, `mov`, `push`, `call`) 📝
- Регистров (например, `eax`, `rbp`, `r15`) 📟
- Операндов памяти (например, `DWORD PTR`, `QWORD PTR`) 📋
- Числовых констант (десятичных и шестнадцатеричных) 🔢
- Меток и имён функций 🏷️
- Директив ассемблера (например, `.section`, `.globl`) 🧭
- CFI директив (например, `.cfi_startproc`, `.cfi_endproc`) 🛡️
- Комментариев (строки, начинающиеся с `;`) 💬
- **Русских инструкций КВС** (например, `переместить_имм`, `вызов_системы`) 🇷🇺
- **Русских регистров КВС** (например, `раикс`, `рдиай`, `ал`) 🇷🇺
- **Русских секций КВС** (`.текст`, `.данные`, `.бнд`) 🇷🇺
- **Русских директив КВС** (`.глобал`, `.строка`, `.байт`) 🇷🇺

## Настройка 🎨

### Цвета подсветки синтаксиса

Вы можете настроить цвета подсветки синтаксиса, изменив цветовую тему VS Code. Добавьте или измените записи в вашем файле `settings.json` в разделе `"editor.tokenColorCustomizations"`.

Например:

```json
"editor.tokenColorCustomizations": {
    "textMateRules": [
        {
            "scope": "keyword.control.instruction.x86asm",
            "settings": {
                "foreground": "#C678DD"
            }
        },
        {
            "scope": "variable.language.register.x86asm",
            "settings": {
                "foreground": "#E06C75"
            }
        }
    ]
}
```

### Символы комментариев

Вы можете настроить символы для комментариев в соответствии с вашим ассемблером. Добавьте эти настройки в ваш `settings.json`:

```json
{
  "assembly.comments.lineComment": "#",
  "assembly.comments.blockComment": ["/*", "*/"]
}
```

**Распространённые конфигурации:**

- **GNU Assembler (as)**: Используйте `#` для однострочных комментариев
- **NASM/MASM**: Используйте `;` для однострочных комментариев (по умолчанию)
- **Ассемблер КВС**: Используйте `;` для однострочных комментариев

Расширение автоматически обновит поведение комментариев при изменении этих настроек.

## Вклад в проект 🤝

Если вы нашли ошибки или у вас есть предложения по улучшению, пожалуйста, создайте обращение или отправьте запрос на включение изменений в GitHub репозитории.

## Лицензия 📄

Это расширение распространяется под лицензией MIT. Подробности см. в файле LICENSE.

## Благодарности 🙌

Спасибо всем участникам и пользователям, которые предоставили отзывы и предложения по улучшению этого расширения.