Fixes #193: Allowing plug overrides

website/SETTINGS.md

@@ -28,4 +28,19 @@ spaceIgnore: |
    dist
    largefolder
    *.mp4
+# Plug overrides allow you to override any property in a plug manifest at runtime
+# The primary use case of this is to override or define keyboard shortcuts. You can use the . notation, to quickly "dive deep" into the structure
+plugOverrides:
+  core:
+    # Matching this YAML structure:
+    # https://github.com/silverbulletmd/silverbullet/blob/main/plugs/core/core.plug.yaml
+    # and overriding the "key" for centering the cursor
+    functions.centerCursor.command.key: Ctrl-Alt-p
+    # However, it's even possible to define custom slash commands this way without building a plug:
+    functions.todayHeader:
+      redirect: insertTemplateText
+      slashCommand:
+        name: today-header
+        value: |
+          ## {{today}}
 ```