85 lines
2.5 KiB
Markdown
85 lines
2.5 KiB
Markdown
# Installation Guide for ASHES Language Support Extension
|
|
|
|
## Quick Installation
|
|
|
|
1. **Copy the extension folder** to your VS Code extensions directory:
|
|
- **Linux**: `~/.vscode/extensions/`
|
|
- **macOS**: `~/.vscode/extensions/`
|
|
- **Windows**: `%USERPROFILE%\.vscode\extensions\`
|
|
|
|
2. **Rename the folder** to `ashes-language-support-0.1.0` (or similar)
|
|
|
|
3. **Reload VS Code** or restart the application
|
|
|
|
4. **Test the extension** by opening any `.esc` file
|
|
|
|
## Alternative Installation (Development Mode)
|
|
|
|
1. **Open VS Code** in the extension directory:
|
|
```bash
|
|
cd vscode-extension
|
|
code .
|
|
```
|
|
|
|
2. **Press F5** to run the extension in a new Extension Development Host window
|
|
|
|
3. **Open a .esc file** in the new window to test the extension
|
|
|
|
## Building from Source
|
|
|
|
1. **Install dependencies**:
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
2. **Compile TypeScript**:
|
|
```bash
|
|
npm run compile
|
|
```
|
|
|
|
3. **Package the extension** (optional):
|
|
```bash
|
|
npx vsce package
|
|
```
|
|
|
|
## Testing the Extension
|
|
|
|
1. **Open the sample file**: `sample.esc` in the extension directory
|
|
2. **Check syntax highlighting**: Events, commands, and variables should be colorized
|
|
3. **Test auto-completion**: Type `say(` and press `Ctrl+Space`
|
|
4. **Test snippets**: Type `event` and press `Tab`
|
|
5. **Test hover**: Hover over commands like `say` or `set_global`
|
|
6. **Test command reference**: Press `Ctrl+Shift+P` and type "ASHES: Show Command Reference"
|
|
|
|
## Features to Test
|
|
|
|
- ✅ Syntax highlighting for events (`:event_name`)
|
|
- ✅ Syntax highlighting for commands (`say`, `set_global`, etc.)
|
|
- ✅ Syntax highlighting for variables (`var`, `global`)
|
|
- ✅ Syntax highlighting for dialog blocks (`?!`)
|
|
- ✅ Auto-completion for commands
|
|
- ✅ Auto-completion for built-in variables
|
|
- ✅ Code snippets for common patterns
|
|
- ✅ Hover information for commands
|
|
- ✅ Smart indentation
|
|
- ✅ Code folding for events
|
|
|
|
## Troubleshooting
|
|
|
|
### Extension not loading
|
|
- Check that the folder is in the correct extensions directory
|
|
- Restart VS Code completely
|
|
- Check the Developer Console for errors (`Help > Toggle Developer Tools`)
|
|
|
|
### Syntax highlighting not working
|
|
- Make sure the file has a `.esc` extension
|
|
- Check that the language is set to "ASHES" in the bottom-right corner of VS Code
|
|
|
|
### Auto-completion not working
|
|
- Press `Ctrl+Space` to manually trigger completion
|
|
- Check that the extension is activated (should show in the Extensions panel)
|
|
|
|
## Uninstalling
|
|
|
|
Simply delete the extension folder from your VS Code extensions directory and restart VS Code.
|