denotesrv/README.md

56 lines
1.3 KiB
Markdown

# denotesrv
9P server for [denote](https://protesilaos.com/emacs/denote) notes.
## Dependencies
- [plan9port](https://github.com/lneely/plan9port) (wayland-9pfuse-truncate branch required for `9pfuse` truncate fix)
## Installation
```sh
mk install
```
## Usage
```sh
denotesrv start # background
denotesrv fgstart # foreground
denotesrv status
denotesrv stop
```
On startup, the server automatically mounts at `~/mnt/denote` via 9pfuse.
Use `-mount /path` to override the mount location.
## Environment
| Variable | Default | Description |
|----------|---------|-------------|
| `DENOTE_DIR` | `~/Documents/notes` | Notes directory |
| `NAMESPACE` | `/tmp/ns.$USER.:0` | 9P namespace |
## 9P Filesystem
```
denote/
ctl (write) filter <query>, cd <path>, refresh
event (read) Event stream
index (read) Note metadata (respects filter)
new (write) Create note: "'title' tag1,tag2"
n/
<id>/
backlinks (read) Notes linking to this note
body (rw) File content
ctl (write) 'd' to delete
keywords (rw) Tags
path (rw) Filesystem path
signature (rw) Note signature
title (rw) Note title
```
## See Also
- [acme-denote](https://github.com/lneely/acme-denote) — Acme frontend