Skip to content

Commit 701cfd0

Browse files
committed
Add a README
1 parent e49df0a commit 701cfd0

File tree

6 files changed

+45
-1
lines changed

6 files changed

+45
-1
lines changed

README.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
<div align="center">
2+
<h1>zk-vscode</h1>
3+
<h4>A Visual Studio Code extension for <a href="https://github.com/mickael-menu/zk"><code>zk</code></a></h4>
4+
<h5><a href="https://marketplace.visualstudio.com/items?itemName=mickael-menu.zk-vscode"><b>Install from the Marketplace</b></a></h5>
5+
</div>
6+
7+
8+
## Description
9+
10+
[`zk`](https://github.com/mickael-menu/zk) is a command-line tool helping you to maintain a plain text [Zettelkasten](https://zettelkasten.de/introduction/) or [personal wiki](https://en.wikipedia.org/wiki/Personal_wiki). It provides a Language Server to augment LSP-compatible editors with many features such as auto-completion and navigation.
11+
12+
`zk-vscode` is a Visual Studio Code client extension for `zk`'s Language Server.
13+
14+
### Highlights
15+
16+
* Follow note links (including Wiki-links)
17+
18+
* Complete links ([configure Wiki-links in `zk`'s configuration file](https://github.com/mickael-menu/zk/blob/main/docs/note-format.md))
19+
20+
<img alt="Link completion" width="675px" src="media/screenshots/link-completion.png"/>
21+
22+
* Complete tags
23+
24+
<img alt="Tag completion" width="675px" src="media/screenshots/tag-completion.png"/>
25+
26+
* Preview a note on hover
27+
28+
<img alt="Hover" width="675px" src="media/screenshots/hover.png"/>
29+
30+
* Peek a note with "Peek definition"
31+
32+
<img alt="Peek note" width="675px" src="media/screenshots/peek.png"/>
33+
34+
## Troubleshooting issues
35+
36+
If you experience issues with `zk-vscode`, you can peek at the Language Server logs with the **zk: Show Logs** VS Code command. To get more detailed logs, set the verbose mode in your `settings.json`:
37+
38+
```json
39+
{
40+
"zk.trace.server": "verbose"
41+
}
42+
```

media/screenshots/hover.png

177 KB
Loading
147 KB
Loading

media/screenshots/peek.png

191 KB
Loading
88.6 KB
Loading

package.json

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22
"name": "zk-vscode",
33
"displayName": "zk-vscode",
44
"description": "Visual Studio Code extension for zk",
5-
"version": "0.0.1",
5+
"publisher": "mickael-menu",
6+
"version": "0.1.0",
7+
"repository": { "type": "git", "url": "https://github.com/mickael-menu/zk-vscode.git" },
68
"engines": {
79
"vscode": "^1.55.0"
810
},

0 commit comments

Comments
 (0)