mirror of
https://github.com/kristoferssolo/solorice.git
synced 2025-10-21 20:10:34 +00:00
119 lines
3.7 KiB
Markdown
119 lines
3.7 KiB
Markdown
# Django extension for Visual Studio Code
|
||
|
||
> Beautiful syntax and scoped snippets for perfectionists with deadlines
|
||
|
||
|
||
|
||
## Features
|
||
|
||
### Go to definition in templates
|
||
|
||
Ctrl-click or press F12 on the template path in a `include` or `extends` tag
|
||
to jump to this template
|
||
|
||
### Snippets
|
||
|
||
- Support for selected text (when inserting snippet from the menu)
|
||
- Support for copied text
|
||
- No unnecessary new lines
|
||
|
||
### Improved syntax
|
||
|
||
- Adds the filetype `django-html`
|
||
- Adds the filetype `django-txt` for email templates.
|
||
- Better syntax with more operators and default keywords:
|
||
- Known default tags and filters
|
||
- Known templatetags namespace from contrib in the {% load %} tag
|
||
- Known keywords in tags, like: `as`, `asvar`, `with`, `trimmed`…
|
||
- Syntax highlighting everywhere in your HTML document:
|
||
- In the HTML tag itself"
|
||
- In the id, class or any attribute
|
||
- In inline CSS or Javascript code
|
||
|
||
## Tricks
|
||
|
||
### Gettext and internationalization
|
||
|
||
Dealing with `django.po` files?
|
||
Consider installing the [Gettext extension](https://marketplace.visualstudio.com/items?itemName=mrorz.language-gettext) by MrOrz.
|
||
|
||
### Emmet
|
||
|
||
Add the following item to the **Emmet: Include Languages** settings:
|
||
|
||
| Item | Value |
|
||
| ------------- | ------ |
|
||
| `django-html` | `html` |
|
||
|
||
## Sponsors
|
||
|
||
<p>
|
||
<a title="Try Duckly for free" href="https://bit.ly/3JdaN3M">
|
||
<img src="https://storage.googleapis.com/gitduck/img/duckly-sponsor-vsc-opt.png" height="50">
|
||
</a><br>
|
||
Easy pair programming with any IDE. Duckly enables you to talk, share your code
|
||
in real-time, server and terminal with people using different IDEs.
|
||
<a href="https://bit.ly/3JdaN3M">Try it out for free</a>
|
||
</p>
|
||
|
||
<p>
|
||
<a title="Try CodeStream" href="https://sponsorlink.codestream.com/?utm_source=vscmarket&utm_campaign=batisteo_django&utm_medium=banner">
|
||
<img src="https://alt-images.codestream.com/codestream_logo_batisteo_django.png" height="50">
|
||
</a><br>
|
||
Manage GitHub PRs & GitLab MRs and conduct code reviews in your IDE with
|
||
full source-tree context. Comment on any line, not just the diffs.
|
||
Use jump-to-definition, your favorite keybindings, and code intelligence
|
||
with more of your workflow.
|
||
<a title="Try CodeStream" href="https://sponsorlink.codestream.com/?utm_source=vscmarket&utm_campaign=batisteo_django&utm_medium=banner">Learn More</a>
|
||
</p>
|
||
|
||
[](https://www.paypal.com/paypalme/batisteo/5)
|
||
[](https://github.com/sponsor/batisteo)
|
||
|
||
## Contributing
|
||
|
||
### Issues
|
||
|
||
Something odd? New feature request?
|
||
Please [create an issue on Github](https://github.com/vscode-django/vscode-django/issues/new).
|
||
|
||
### Setup
|
||
|
||
```bash
|
||
git clone https://github.com/vscode-django/vscode-django
|
||
cd vscode-django
|
||
npm install
|
||
code .
|
||
```
|
||
|
||
It’s better to have [TSlint](https://marketplace.visualstudio.com/items?itemName=eg2.tslint) installed.
|
||
|
||
|
||
### Launching the extension debugger
|
||
|
||
Make sure you have this snippet in `.vscode/launch.json`:
|
||
|
||
```javascript
|
||
{
|
||
"version": "0.2.0",
|
||
"configurations": [
|
||
{
|
||
"name": "Extension",
|
||
"type": "extensionHost",
|
||
"request": "launch",
|
||
"runtimeExecutable": "${execPath}",
|
||
"args": [
|
||
"--extensionDevelopmentPath=${workspaceFolder}"
|
||
]
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
Press <kbd>F5</kbd> or click on Debug then Start (▶️) to launch the extension host window.
|
||
|
||
Hack around
|
||
|
||
Press <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>F5</kbd> or 🔄 to reload.
|
||
|