|
2 | 2 | paths: |
3 | 3 | - '{journals,pages}/*.md' |
4 | 4 | --- |
5 | | -# How a Person is tracked in this Logseq knowledge garden |
6 | | -This is an extension to the logseq-flavored-markdown rule for recording information about a person. |
7 | | - |
8 | | -A person entry is a logseq page where the page title matches one of the following patterns: |
9 | | -- [[People/Full Name]] (corresponds to `pages/People___Full Name.md`) |
10 | | -- [[Person/Full Name]] (corresponds to `pages/Person___Full Name.md`) |
11 | | -- [[<AnyNamespace>/People/Full Name]] (e.g., `pages/HU___People___Full Name.md`) |
12 | | -- [[<AnyNamespace>/Person/Full Name]] (e.g., `pages/AI___Person___Full Name.md`) |
13 | | - |
14 | | -### When to Create a Person Page |
15 | | - |
16 | | -Person pages should only be created for individuals who meet one or more of these criteria: |
17 | | -- Known across multiple platforms (e.g., GitHub, Twitter, Stack Overflow) |
18 | | -- Have a confirmed real identity |
19 | | -- Are significant contributors or maintainers |
20 | | -- Have a substantial online presence |
21 | | -- Are key figures in their field |
22 | | - |
23 | | -For other users, use site-specific namespaces: |
24 | | -- `[[CursorAI/Forum/User/Username]]` for Cursor Forum users |
25 | | -- `[[Reddit/User/Username]]` for Reddit users |
26 | | -- `[[StackOverflow/User/Username]]` for Stack Overflow users |
27 | | -- `[[ForumName/User/Username]]` for other forum users |
28 | | - |
29 | | -### Creating a Person Page |
30 | | - |
31 | | -If you are asked to make an entry for a person, you should: |
32 | | - |
33 | | -1. **Search First - CRITICAL for Deduplication** |
34 | | - - **Before creating or referencing a person page, you MUST search thoroughly:** |
35 | | - - Search in `pages/People___*.md`, `pages/Person___*.md`, and in any file matching `pages/**___People___*.md` or `pages/**___Person___*.md` |
36 | | - - Search by full name, partial name, username/handle, and common variations |
37 | | - - Check aliases in existing person pages (read the `alias::` frontmatter) |
38 | | - - Look for name variations (e.g., "Shawn Wang" vs "Shawn @swyx Wang" vs "@swyx") |
39 | | - - **If a person page already exists:** |
40 | | - - **DO NOT create a new page** - update the existing entry instead |
41 | | - - **When referencing the person, use the canonical page name** (the actual filename), NOT aliases |
42 | | - - Example: If page is `Person___Shawn @swyx Wang.md` with alias `[[Person/Shawn Wang]]`, reference it as `[[Person/Shawn @swyx Wang]]`, not `[[Person/Shawn Wang]]` |
43 | | - - **A single person should NEVER have more than one person page** - this is a critical deduplication rule |
44 | | - |
45 | | -2. **Verify Significance** |
46 | | - - Confirm the person meets the criteria for a person page |
47 | | - - If not, use the appropriate site-specific namespace instead |
48 | | - |
49 | | -3. **Create/Update Page** |
50 | | - - If a new person page is needed, create it under `[[Person/Full Name]]` by default |
51 | | - - If the person is referenced in other contexts/namespaces (e.g., `[[People/Full Name]]`, `[[HU/Person/Full Name]]`), add aliases in the frontmatter to those contexts using `alias::` (not `aliases::`) |
52 | | - - Look up the person on the internet |
53 | | - - Create a person page for them if they meet the criteria |
54 | | - - Link the person and a bit of their bio in their page |
55 | | - - If possible add an image link |
56 | | - - Include relevant external links (GitHub, LinkedIn, etc.) |
57 | | - |
58 | | -4. **Referencing Existing Person Pages** |
59 | | - - **Always use the canonical page name** when creating references in content |
60 | | - - The canonical name is the actual page filename (e.g., `Person___Shawn @swyx Wang.md` → `[[Person/Shawn @swyx Wang]]`) |
61 | | - - **Do NOT use aliases** when referencing - aliases are for backward compatibility, not for new references |
62 | | - - If unsure of the canonical name, search for the person page first and use the exact page title |
63 | | - |
64 | | -5. **Journal Entry** |
65 | | - - If the person page is new, make an entry in today's journal page that links to that person |
66 | | - - Use the canonical page name in the journal entry |
| 5 | +# Person entities (router) |
| 6 | + |
| 7 | +- **Authoritative SOP:** `[[Logseq/Entity/person]]` — how we recognize person **hub** pages (`[[Person/Full Name]]` only), namespace vs entity type, `logseq-entity::`, aliases, dedup, and SCM child pages. |
| 8 | +- **Workflow:** Use the **logseq-entity** skill: read `[[Logseq/Entity]]` and the person type page, dedupe before creating, then create or update pages per that SOP (fallback: `.rulesync/config/logseq-entity.md` section **person**). |
| 9 | +- **This rule file** stays short; do not reintroduce legacy `[[People/...]]` title or alias patterns here or in new pages. |
| 10 | +- **Search before create:** `rg` / glob on `pages/Person___*.md`, name variants, and `alias::` lines; one hub per human; canonical link text must match the real page title. |
| 11 | +- **Tags:** Never modify, add, or remove **`tags::`** on existing pages unless a separate human instruction explicitly overrides garden tagging rules. |
| 12 | +- **Journal:** When filing a new person hub from a session, follow `logseq-journal-updates` (link under `[[Filed]]`, etc.). |
0 commit comments