People.
A person in Paperkites is a note with a type. There's no contacts table and no form to fill in: everything about someone is prose in their note, and @username in any other note mentions them.
A person note
Each person is a markdown file in the people/ folder of your vault, named after their username: ~/notes/people/dasha.md.
---
type: person
username: dasha
aliases: [dk]
---
# Dasha Komsa
Met at the soil workshop. Runs the community garden on Elm Street.| Key | Required | What it is |
|---|---|---|
type: person | yes | makes the note a person |
username | yes | what you type after @ |
aliases | no | other names that resolve to the same person |
The body starts with # Their Name. There's nothing beyond those three keys; write whatever you like below the name.
Making a person
While typing a mention, press ⌃n in the @ completion list to make a new person. You can also write the file yourself, in Paperkites or any other editor.
Mentions
Type @ and a name in any note.
@followed by a letter is a person:@dasha.@followed by a digit is a date, not a person.- Email addresses (
[email protected]) and code are neither. - An alias works like the username:
@dkmentions Dasha too.
A mention shows in the person colour. If no person file has that name, the mention has a dotted underline. Paperkites never makes a person or rewrites a mention for you.
@ completion
Rows read Dasha Komsa @dasha, with how many times they've been mentioned.
| Key | Inserts |
|---|---|
| ⏎ | the mention: @dasha |
| ⇥ | the name and the mention |
| ⌃n | makes a new person |
The person page
Opening a person shows:
- their name and username
- your note about them
- Mentioned in: every sentence that mentions them, newest first
- Often with: the people and tags that appear in the same notes
Getting to people
| Key or command | Does |
|---|---|
| gd or gp | in a note, open the person under the caret |
| K | peek at the person without leaving the note |
| gp | outside a note, the people list in ⌘K |
| @ first in ⌘K | people only |
@dasha in a / search | search only notes that mention Dasha |
| gr on a person | the graph, showing who and what is within two links of them |
The sidebar (⌘\) lists your people too. There's no separate "all people" page; @ in ⌘K is that.
Renaming
To change someone's username, open ⌘K, type @, select the person and press ⌃r. Paperkites renames the username in every file and renames the person's file, as one operation. :undo reverts it.