|
| 1 | +# xit! |
| 2 | + |
| 3 | +This extension provides language support for [xit!](https://xit.jotaen.net/). |
| 4 | + |
| 5 | +- [Syntax Highlighting](#syntax-highlighting) |
| 6 | +- [Shortcuts](#shortcuts) |
| 7 | +- [Snippets](#snippets) |
| 8 | + |
| 9 | +## Syntax Highlighting |
| 10 | + |
| 11 | + |
| 12 | + |
| 13 | +### Customization |
| 14 | + |
| 15 | +If the colors and looks of the syntax highlighting is not correct or as fancy as you want to, you can try to edit the `tokenColorCustomizations` in the user settings. |
| 16 | + |
| 17 | +```json |
| 18 | +{ |
| 19 | + "editor.tokenColorCustomizations": { |
| 20 | + "textMateRules": [{ |
| 21 | + // Replace this with the scope you want to edit. |
| 22 | + // Available scopes are: |
| 23 | + // - markup.other.task.title.xit |
| 24 | + // - markup.other.task.checkbox.open.xit |
| 25 | + // - markup.other.task.checkbox.ongoing.xit |
| 26 | + // - markup.other.task.checkbox.checked.xit |
| 27 | + // - markup.other.task.checkbox.obsolete.xit |
| 28 | + // - markup.other.task.description.closed.xit |
| 29 | + // - markup.other.task.priority.xit |
| 30 | + // - markup.other.task.date.xit |
| 31 | + // - markup.other.task.tag.xit |
| 32 | + "scope": "markup.other.task.checkbox.open.xit", |
| 33 | + "settings": { |
| 34 | + // Customize open checkbox color |
| 35 | + "foreground": "#00FF00", |
| 36 | + // ... and the fontStyle |
| 37 | + "fontStyle": "bold" |
| 38 | + } |
| 39 | + }] |
| 40 | + } |
| 41 | +} |
| 42 | +``` |
| 43 | + |
| 44 | +### Strikethrough Not Working? |
| 45 | + |
| 46 | +If closed tasks (completed/obsolete) are not striketroughed, then you may want to explicitly specify that the strikethrough scope is striketroughed. This is happening because your theme did not specify the striketrough rule. |
| 47 | + |
| 48 | +```json |
| 49 | +{ |
| 50 | + "editor.tokenColorCustomizations": { |
| 51 | + "[Theme That Is Not Working]": { |
| 52 | + "textMateRules": [ |
| 53 | + { |
| 54 | + "scope": "markup.strikethrough", |
| 55 | + "settings": { |
| 56 | + "fontStyle": "strikethrough" |
| 57 | + } |
| 58 | + } |
| 59 | + ] |
| 60 | + } |
| 61 | + } |
| 62 | +} |
| 63 | +``` |
| 64 | + |
| 65 | +## Shortcuts |
| 66 | + |
| 67 | +The extension provides shortcuts for toggling/shuffling checkbox state. The shortcuts are configured by default as shown below: |
| 68 | + |
| 69 | +- `ctrl+space` - Toggle checkboxes if available, else trigger editor suggestions. |
| 70 | +- `ctrl+alt+x` - Toggle all selected checkboxes. |
| 71 | +- `ctrl+alt+d` - Shuffle all selected checkboxes. This will shift the checkbox state to `' ' -> '@' -> '~' -> 'x'`. |
| 72 | + |
| 73 | +## Snippets |
| 74 | + |
| 75 | +- `u` - Unchecked (`[ ] `) |
| 76 | +- `a`/`@` - Ongoing (`[@] `) |
| 77 | +- `o`/`~` - Obsolete (`[~] `) |
| 78 | +- `x` - Unchecked (`[x] `) |
0 commit comments