Logseq/Entity/Key

• Key

  • In this garden, Key pages model a single physical or logical Keyboard/Computer key. These pages are anchor points for expressing Keyshorts along with some optional historical commentary on certain special computer keyboard keys.

  • Examples in this garden

    • Key/Meta — the Meta/Alt modifier key
    • Future instances: Key/Control, Key/Shift, Key/Command, Key/Option, Key/Escape, Key/Return, Key/Tab

  • When we treat something as a Key entity

    • Strong signals: the page represents or refers to a key on a computer keyboard.

    • Good Fit

      • modifier keys (Meta, Control, Shift, Command/Super), special keys (Escape, Return, Tab, Backspace), function keys (F1–F12).

    • Not Key Entity

      • Key combinations, shortcuts, and sequences of multiple keys are modeled by Logseq/Entity/Keyshort.

  • Naming and links

    • Use the most general, cross-platform name as the page name: [[Key/Meta]], [[Key/Control]], [[Key/Shift]].
    • Platform-specific or notation-specific alternate names belong in alias:: on the instance page (e.g. [[Key/Alt]], [[Key/Option]], [[Key/Meta (M-)]]).
    • File on disk: pages/Key___<Name>.md (triple underscores between namespace segments).

  • Finding and deduplicating

    • Before creating a new Key page, grep pages/Key___*.md for the key name and check existing alias:: values for alternate names.
    • Classify: existing, similar (check aliases), new, or blocked (ambiguous name).

  • Frontmatter

    • Standard Logseq/Frontmatter/logseq-entity attribution rules
    • Standard Logseq/Frontmatter/alias rules. Include the symbol/notation form [[Key/Name (symbol)]] when a standard notation exists (e.g. [[Key/Meta (M-)]], [[Key/Control (C-)]], [[Key/Shift (⇧)]]). Common alternate names (e.g. [[Key/Alt]] for Meta) go in only when codekiln asks for them, per My/AI/Rule/Logseq/No Aliases Unless Asked.
      • Platform-specific names go in the alias too: e.g. [[Key/Mac/Command (⌘)]] as the symbol alias for [[Key/Mac/Command]], and [[Key/Alt (⌥)]] as the symbol alias for [[Key/Alt]].

  • Page shape

    • H1 — key name with symbol or notation in parens: # Meta (M-), # Control (C-), # Shift (⇧). Omit parens if no standard symbol exists.
    • One sentence directly under H1: what the key is and its primary use.
    • ## Larger Context — optional; historical origin, OS-specific mapping, terminal emulator notes. Omit when not needed.

  • Relationship to other types

    • Logseq/Entity/Keyshort pages reference Key instances inline to express key combinations (e.g. [[Key/Meta]] 1).
    • A Key page is not itself a shortcut; it models the key component only.