Skip to content

Commit

Permalink
Add a README
Browse files Browse the repository at this point in the history
  • Loading branch information
mickael-menu committed Apr 23, 2021
1 parent e49df0a commit 701cfd0
Show file tree
Hide file tree
Showing 6 changed files with 45 additions and 1 deletion.
42 changes: 42 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
<div align="center">
<h1>zk-vscode</h1>
<h4>A Visual Studio Code extension for <a href="https://github.com/mickael-menu/zk"><code>zk</code></a></h4>
<h5><a href="https://marketplace.visualstudio.com/items?itemName=mickael-menu.zk-vscode"><b>Install from the Marketplace</b></a></h5>
</div>


## Description

[`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.

`zk-vscode` is a Visual Studio Code client extension for `zk`'s Language Server.

### Highlights

* Follow note links (including Wiki-links)

* Complete links ([configure Wiki-links in `zk`'s configuration file](https://github.com/mickael-menu/zk/blob/main/docs/note-format.md))

<img alt="Link completion" width="675px" src="media/screenshots/link-completion.png"/>

* Complete tags

<img alt="Tag completion" width="675px" src="media/screenshots/tag-completion.png"/>

* Preview a note on hover

<img alt="Hover" width="675px" src="media/screenshots/hover.png"/>

* Peek a note with "Peek definition"

<img alt="Peek note" width="675px" src="media/screenshots/peek.png"/>

## Troubleshooting issues

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`:

```json
{
"zk.trace.server": "verbose"
}
```
Binary file added media/screenshots/hover.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added media/screenshots/link-completion.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added media/screenshots/peek.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added media/screenshots/tag-completion.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 3 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,9 @@
"name": "zk-vscode",
"displayName": "zk-vscode",
"description": "Visual Studio Code extension for zk",
"version": "0.0.1",
"publisher": "mickael-menu",
"version": "0.1.0",
"repository": { "type": "git", "url": "https://github.com/mickael-menu/zk-vscode.git" },
"engines": {
"vscode": "^1.55.0"
},
Expand Down

0 comments on commit 701cfd0

Please sign in to comment.