Skip to content

Commit 37a8f67

Browse files
db-version updates for the past month
1 parent e6b3091 commit 37a8f67

File tree

2 files changed

+18
-13
lines changed

2 files changed

+18
-13
lines changed

db-version-changes.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -38,11 +38,12 @@ High level changes:
3838
* Code blocks, quote blocks and math blocks [have tags](./db-version.md#more-new-tags). Since properties are not are a part of the block content, properties can more naturally be added to these blocks.
3939
* Pdf annotations [have a tag](./db-version.md#more-new-tags). This allows annotations to be viewed across pdfs and to have custom views of annotations while using the pdf viewer.
4040
* Markdown syntax for blocks e.g. a heading or quote is no longer visible or editable. Removing a block's heading is done by right-click on a block and choosing the crossed out H icon.
41+
* Slides have been removed as a feature and we can support it as 3rd party plugin.
4142

4243
WIP changes:
44+
* RTC a.k.a. DB version sync will be enabled later.
45+
* Add back support for dynamic variables.
4346
* Whiteboards are disabled for now and will be enabled later.
44-
* Exports to more formats including markdown.
45-
* Sync and RTC will be enabled later.
4647

4748
Miscelleanous changes:
4849
* Scripts using [nbb-logseq](https://github.com/logseq/nbb-logseq) can read and write graphs. Previously with file graphs, scripts could only read graphs.
@@ -51,8 +52,11 @@ Miscelleanous changes:
5152
* There is no re-index like in file graphs.
5253
* For browsers, currently only one tab can be open. This is a limitation we hope to remove later.
5354
* `All Pages` view can toggle between table and list view.
54-
* Run the command `Customize appearance` to display a modal of appearance related settings.
55-
* For developers, there is a `Validate current graph` command.
55+
* New commands:
56+
* Run the command `Customize appearance` to display a modal of appearance related settings.
57+
* Commands from [property shortcuts](./db-version#property-shortcuts).
58+
* Commands from [edn data export](./db-version.md#edn-data-export).
59+
* For developers, there are `Validate current graph` and `Garbage collect graph` commands.
5660

5761
### Changes by Feature
5862

@@ -96,7 +100,6 @@ Miscelleanous changes:
96100
* The attribute `:block/content` was renamed to `:block/title`. If used in an advanced query including in config.edn's `:default-queries`, change it to use `:block/title` e.g. `[?b :block/content "content"]` -> `[?b :block/title "content"]`
97101
* These advanced query options are deprecated: :title, :group-by-page? and :collapsed?.
98102
* Since block timestamps are available, they display in table view where possible.
99-
* `{{function}}` used with queries is a TODO.
100103

101104
#### Namespaces
102105
* Creating namespaces through `/` in `[[]]` should work as before e.g. `[[foo/bar/baz]]` creates the hierarchy of `foo` > `bar` > `baz`. Unlike before, the reference will turn into `[[baz]]` after it is created.
@@ -109,7 +112,8 @@ Miscelleanous changes:
109112
#### User Config
110113

111114
* A graph's config.edn, custom.js and custom.css files are only editable within Logseq from `Settings`.
112-
* The following config.edn options are no longer used: `:block-hidden-properties, :favorites, :hidden, :ignored-page-references-keywords, :preferred-format, :preferred-workflow, :feature/enable-block-timestamps?, :file/name-format, :org-mode/insert-file-link?, :property/separated-by-commas, :property-pages/enabled?, :property-pages/excludelist`. See [this code](https://github.com/logseq/logseq/blob/043927031e11053a837d8289e3334368e6647bea/src/main/frontend/handler/common/config_edn.cljs#L89-L115) for more details.
115+
* The following config.edn options are no longer used by any graphs: `:ref/linked-references-collapsed-threshold`.
116+
* The following config.edn options are no longer used: `:block-hidden-properties, :default-templates, :favorites, :hidden, :ignored-page-references-keywords, :journals-directory, :pages-directory, :preferred-format, :preferred-workflow, :whiteboards-directory, :feature/enable-block-timestamps?, :file/name-format, :file-sync/ignore-files, :journal/file-name-format, :journal/page-title-format, :logbook/settings, :org-mode/insert-file-link?, :property/separated-by-commas, :property-pages/enabled?, :property-pages/excludelist, :srs/initial-interval, :srs/learning-fraction` in DB graphs. See [this code](https://github.com/logseq/logseq/blob/b0a255f96bfd512d5b87acca52c8d9f958c6a593/deps/common/src/logseq/common/config.cljs#L124-L157) for more details.
113117

114118
#### Search
115119
* When search modal first opens, recently updated pages display at the top.

db-version.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
## Description
22

3-
This page describes DB (database) graph functionality as of April 30th. See [here](https://test.logseq.com/#/) to try the latest stable version. If you're an existing user of Logseq, you'll be interested in [changes with the db version](./db-version-changes.md).
3+
This page describes DB (database) graph functionality as of June 3rd. See [here](https://test.logseq.com/#/) to try the latest stable version. If you're an existing user of Logseq, you'll be interested in [changes with the db version](./db-version-changes.md).
44

55
NOTE: While there is an [automated backup](#automated-backup) for DB graphs, we recommend only using DB graphs for testing purposes.
66

@@ -90,7 +90,7 @@ NOTE: Most shortcuts have a corresponding search command. You can find the comma
9090

9191
### Configure a Property
9292

93-
Properties are configurable wherever they are used by clicking on its name to display a dropdown menu. Press `Cmd` and click to navigate to a property page. Property icons are set by clicking on the property's default icon to the left of its name. Properties can also be configured by navigating to their page with [Search](https://docs.logseq.com/#/page/search) and then clicking on the `Configure property` button below its name.
93+
Properties are configurable wherever they are used by clicking on its name to display a dropdown menu. Press `Cmd` and click to navigate to a property page. Property icons are set by clicking on the property's default icon to the left of its name. Properties can also be configured by navigating to their page with [Search](https://docs.logseq.com/#/page/search) and then clicking on the `Configure` button that appears above when hovering over the name.
9494

9595
Property fields in the dropdown menu:
9696

@@ -147,7 +147,7 @@ To create your first new tag:
147147

148148
For example, say we created a new tag `Person` and added `lastName` and `birthday` tag properties to it. Now when `#Person` is added to a block or page, those two properties automatically display and are editable for them. A powerful thing about new tags is that when its tag properties change those changes immediately show up on all [tagged nodes](#tagged-node).
149149

150-
A new tag can have properties on its own page. By default the `Description` property is available for adding a description and `Hide from node` is available to hide the new tag on tagged nodes that float to the far right. To set these properties you must be on the tag's page, hover over the tag's name and click on `Set page property`.
150+
A new tag can have properties on its own page. By default the `Description` property is available for adding a description and `Hide from node` is available to hide the new tag on tagged nodes that float to the far right. To set these properties go to the tag's page and click on the `Add property` link.
151151

152152
### Create Tags
153153

@@ -174,8 +174,7 @@ A powerful feature of using a parent tag is that the new tag inherits the proper
174174
New tags are configurable from their page. Navigate to their page by using [Search](https://docs.logseq.com/#/page/search) or clicking on their `#` name links. On their page, hover over their name to see the rotating triangle icon to the left. Click on it to see the tag page's properties. Two important properties you'll see for configuring a tag:
175175

176176
* `Parent`: Use this to allow the new tag to inherit its parent's tag properties. By default the parent tag is the `Root Tag` which doesn't have any properties.
177-
* `Tag Properties`: These tag properties are inherited by every node that uses the new tag. Drag one above or below the other to sort them. These properties will then display sorted on the tagged node.
178-
* To the right of each tag property there is an optional block for describing the property. This description also shows up on the property's page.
177+
* `Tag Properties`: These tag properties are inherited by every node that uses the new tag.
179178

180179
### Tagged Node
181180

@@ -353,6 +352,7 @@ A table displays a group of nodes as rows and a node's properties as columns. A
353352
* Drag columns to sort their order.
354353
* Resize columns by dragging the resize handle at a column header's border.
355354
* Bulk actions: When rows in the table are selected, bulk actions appear in the table header. All the bulk actions [described above](#bulk-actions) are available except for the `Three dots menu`.
355+
* Keyboard shortcuts: Use arrow keys to navigate between cells. Press `Enter` to edit a cell and `Esc` to exit editing.
356356

357357
## DB Graph Importer
358358

@@ -451,9 +451,10 @@ DB graphs are scriptable using https://github.com/logseq/nbb-logseq/tree/feat/db
451451

452452
On desktop, it is easy to modify an existing DB graph with a script and see the change in Logseq. To do so:
453453

454-
1. Press Cmd-S to persist a graph to `~/logseq/graphs/GRAPH-NAME/db.sqlite`.
454+
1. Press `Cmd-S` to persist a graph to `~/logseq/graphs/GRAPH-NAME/db.sqlite`.
455455
2. Modify the db.sqlite with a nbb-logseq script.
456456
3. Update the app to use the modified db.sqlite by using the `Replace graph with its db.sqlite file` dev command.
457457

458458
## Additional Links
459-
* https://github.com/C0ntr0lledCha0s/logseq-template-graph - Example graph with useful properties and tags
459+
* https://discuss.logseq.com/t/introducing-newtags-with-examples/32310 - Helpful tutorial on new tags
460+
* https://github.com/C0ntr0lledCha0s/logseq-template-graph - Example graph with useful properties and tags. Import graph as EDN.

0 commit comments

Comments
 (0)