diff --git a/website/CHANGELOG.md b/website/CHANGELOG.md index b2f7a0b4..faac5b79 100644 --- a/website/CHANGELOG.md +++ b/website/CHANGELOG.md @@ -9,6 +9,7 @@ _These features are not yet properly released, you need to use [the edge builds] * [[Page Picker#Keyboard shortcuts]]: allow folder completion using Shift-Space (by [Marek S. Łukasiewicz](https://github.com/silverbulletmd/silverbullet/pull/961)) * New [[Page Decorations]]: ability to hide pages from the page picker and auto complete (by [Marek S. Łukasiewicz](https://github.com/silverbulletmd/silverbullet/pull/962)) * The [[Expression Language]] now supports decimal numbers 🤯 (e.g. `3.14`) +* Non-existing pages that have been previously linked to (so effectively: broken links) now appear in the [[Page Picker]] (with a “Create page” hint) as well as in [[Links]] auto complete (marked as “Linked but not created”). This should make it easier to “fill in the gaps”: you can liberally create page links, and create those pages later easily via the page picker. * Added Ruby [[Markdown/Syntax Highlighting]] (by [Bo Jeanes](https://github.com/silverbulletmd/silverbullet/pull/966)) * **Fix**: Due to some race conditions some situations pages would disappear from the index (e.g. from the [[Page Picker]]), this should now be fixed * New [[SETTINGS]]: `pwaOpenLastPage` and `useSmartQuotes` (latter by [Marek S. Łukasiewicz](https://github.com/silverbulletmd/silverbullet/pull/960)) diff --git a/website/Page Picker.md b/website/Page Picker.md index 048eacab..b5d127c3 100644 --- a/website/Page Picker.md +++ b/website/Page Picker.md @@ -1,4 +1,9 @@ -The page picker functions as the primary way to navigate between [[Pages]], as well as a way to create new ones. +The page picker has two main functions: + +1. Enables quick navigation between [[Pages]] +2. Enables creation of new pages + * Based on the entered name + * Based on [[Links|linked]] to, but not yet created page names The page picker can be invoked by clicking the 📔 icon in the top bar, or by pressing `Cmd-k` on Mac, or `Ctrl-k` on Windows/Linux. @@ -9,7 +14,12 @@ If the filter phrase contains `#tags` the results will be filtered based on matc > **note** Note > [[Templates]], even though technically regular pages, do not appear in the page picker. To navigate to them, use the [[Meta Picker]] instead. -Pressing the `Enter` key will open/create the selected page. Pressing `Shift-Enter` will always open or create (if it doesn't already exist) the page _exactly matching_ the filter phrase. Therefore, if you intend to create a new page, simply type the name of the new page and hit `Shift-Enter`. +#ProTip To cycle between the three pickers [[Page Picker]], [[Meta Picker]] and [[All Pages Picker]], type `^` in the filter phrase box. + +Pressing the `Enter` key will open/create the selected page. +Pressing `Shift-Enter` will always open or create (if it doesn't already exist) the page _exactly matching_ the filter phrase. + +Therefore, if you _intend to create a new page_, simply type the name of the new page and hit `Shift-Enter`. # Result ordering When no filter phrase is entered, pages are ordered by either _last opened_, or _last modified_ date in descending order. This makes it convenient to switch between recently edited pages. @@ -17,13 +27,13 @@ When no filter phrase is entered, pages are ordered by either _last opened_, or When entering a filter phrase, the best matches should appear closer to the top, however the second option will always be an option to create a new page with _exactly_ the page name entered as the filter phrase. # Keyboard shortcuts -* `Enter`: selects the highlighted page from the list and navigate there. If that page is marked with “Create” it will create that page. +* `Enter`: selects the highlighted page from the list and navigate there. If that page is marked with “Create page” it will create that page. * `Shift-Enter`: navigate to the page entered in as the filter phrase. * `Space`: with an empty filter phrase will attempt to do something intelligent: * If the currently opened page is nested in a [[Folders|folder]], it will auto complete the current folder name in its place. * If the currently opened page name starts with an emoji, it will complete that emoji in its place. * Otherwise, it will complete the full page name of the currently open page. -* `Shift-Space`: auto complete folder from highlighted page: +* `Shift-Space`: auto complete folder from the highlighted page: * If the currently highlighted page is nested in a [[Folders|folder]], it will auto complete its folder name * Otherwise, it will auto complete that page name with a `/` added at the end * `ArrowUp`/`ArrowDown`: move up and down the highlighted page list @@ -34,5 +44,5 @@ When entering a filter phrase, the best matches should appear closer to the top, * Typing `^` when filter phrase is empty will cycle to the next picker, first [[Meta Picker]], then [[All Pages Picker]] # Mouse/touch operation -You can obviously scroll and select an item from the list by clicking with the mouse, as well as close the page picker by clicking outside of it. +You can scroll and select an item from the list by clicking with the mouse, as well as close the page picker by clicking outside of it.