You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: db-version-changes.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,9 +13,10 @@ This page describes changes for existing Logseq features on the [database versio
13
13
The following changes affect both file and the new db graphs:
14
14
* To simplify editor `/` commands, [Commands](https://docs.logseq.com/#/page/commands) and [Advanced Commands](https://docs.logseq.com/#/page/advanced%20commands) are merged together under `/`.
15
15
* A good amount of the UI is rewritten to use [shadcn](https://github.com/shadcn-ui/ui). This means a more beautiful, consistent and powerful UI!
16
-
* The application performance is better - loading faster and handling larger graphs. For DB graphs, our last performance test exercised 30k+ pages.
16
+
* The application performance is better - loading faster, handling larger graphs and large tables. See https://github.com/logseq/logseq/pull/11774 for latest details.
17
17
* On desktop, the graph cache directory `~/.logseq/graphs/` has moved to `~/logseq/graphs`. See [DB Graph Directories](#db-graph-directories) for how they are used for DB graphs.
18
18
* Plugins can be used from the web. For security reasons only [plugins configured with no "effect"](https://github.com/logseq/marketplace#how-to-submit-your-plugin) are usable. We will gradually open up effect plugins to certified/trustworthy plugins.
19
+
* On browser, multiple tabs can be opened and kept in sync, even when offline. Syncing between tabs _does not_ require a sync server.
19
20
* The visibility of left sidebar items are configurable. To configure, hover over the `Navigations` header and click on the filter icon to open a dropdown for toggling visibility of sidebar items.
20
21
21
22
## DB Graph Changes
@@ -125,6 +126,7 @@ Miscelleanous changes:
125
126
126
127
## File Graph Changes
127
128
129
+
* File graphs are no longer supported in browser.
128
130
* There is no longer a [conversion feature for filename formats](https://docs.logseq.com/#/page/filename%20format)
129
131
* Attribute changes:
130
132
* 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"]`
Copy file name to clipboardExpand all lines: db-version.md
+11-7Lines changed: 11 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
## Description
2
2
3
-
This page describes DB (database) graph functionality as of Feb 12th. 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 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).
4
4
5
5
NOTE: While there is an [automated backup](#automated-backup) for DB graphs, we recommend only using DB graphs for testing purposes.
6
6
@@ -84,6 +84,7 @@ A property itself can have properties on its property page. By default the `Desc
84
84
*`p t` toggles displaying all the current node's properties below it. This is useful to quickly view properties that are hidden or in a different position.
85
85
*`p i` opens the icon picker to set an icon for the current node.
86
86
* See [task shortcuts](#task-shortcuts) for task specific ones.
87
+
* To navigate between property values across nodes, use the up and down arrow keys.
87
88
88
89
NOTE: Most shortcuts have a corresponding search command. You can find the command for a given shortcut's keys keybinding by using `Settings > Keymap`, clicking the keystroke filter and typing the keys.
89
90
@@ -119,7 +120,7 @@ A property type determines what type a property's property values can have. Ther
119
120
*`Date`: This is for dates and is editable with a date picker. When a date property value is used, it correctly links to the journal page. This property type can be used with [repeated nodes](#repeated-tasks-and-nodes).
120
121
*`DateTime`: This is for date times and is editable with a datetime picker. See the `Due` property in [cards](#cards) for an example property that uses this. This property type can be used with [repeated nodes](#repeated-tasks-and-nodes).
121
122
*`Checkbox`: This is used to set or unset a property value and displays as a checkbox. To engineers this type is known as a boolean.
122
-
*`Url`: This limits text to only allow urls e.g. `https://logseq.com`. This does not behave like `Text` e.g. no referencing or child blocks.
123
+
*`Url`. This limits text to only allow urls e.g. `https.//logseq.com`. This does not behave like `Text` e.g. no referencing or child blocks.
123
124
*`Node`: This allows a property value to link to other nodes i.e. pages or blocks. When first configuring this, you are prompted to select a new tag. You can choose to skip a tag if you don't care about limiting the available nodes. When a tag is selected or created, only nodes with that tag will appear as options for the property. For example, if you define the property `Author`, you could create a new tag `#Person` that only allows nodes tagged with `#Person` as values. Also worth noting that tag selection works for all child tags of the chosen new tag. Using the previous example, if `#Actor` is a child of `#Person`, nodes tagged with `#Person` or `#Actor` are allowed values.
124
125
125
126
### Property Choices
@@ -405,9 +406,10 @@ To export a DB graph, click on the three dots menu in the upper right corner, se
405
406
406
407
1.`Export SQLite DB` - Export graph as a [SQLite](https://sqlite.org/) .db file.
407
408
2.`Export both SQLite DB and assets` - Export graph as a .zip file containing the DB file and the graph's assets.
408
-
3.`Export debug transit file` - Export graph as a transit file to be shared with the Logseq team for debugging. Any personal sensitive data is removed.
409
-
4.`Export EDN file` - Export graph as EDN described in [EDN Data Export](#edn-data-export). This feature is not yet recommended as the only means to backup a graph.
409
+
3.`Export EDN file` - Export graph as EDN described in [EDN Data Export](#edn-data-export). This is the only export type that fully captures a graph's data and is editable. This export is not yet recommended as the only means to backup a graph.
410
+
4.`Export as standard Markdown (no block properties)` - Export graph as standard markdown, not Logseq markdown. Since this export is unlikely to ever export timestamps or all properties, it cannot capture all data in a graph. See the EDN export for an export type that captures all data and is editable.
410
411
5.`Export public pages` - Export graph in order to publish it on the web. See https://docs.logseq.com/#/page/publishing for more.
412
+
6.`Export debug transit file` - Export graph as a transit file to be shared with the Logseq team for debugging. Any personal sensitive data is removed.
411
413
412
414
### Graph Import
413
415
@@ -422,18 +424,20 @@ To import the exported .sqlite file, click on the three dots menu in the upper r
422
424
423
425
### EDN Data Export
424
426
425
-
Exported EDN data allows any DB graph content to be shared between users as text. With this text, a user can then import it to replicate the same visible and behavioral content including the content's properties, tags. This is important as it gives users control of their content and enables some workflows that aren't possible with file graphs. This feature is available with the following commands:
427
+
Exported [EDN data](https://github.com/edn-format/edn) allows any DB graph content to be shared between users as text. With this text, a user can then import it to replicate the same visible and behavioral content including the content's properties and tags. This is important as it gives users control of their content and enables some workflows that aren't possible with file graphs. This feature is available with the following commands:
426
428
427
429
*`Export block EDN data` - Run this command on the current block to copy it to the clipboard. When this data is imported, it will overwrite the current block.
428
430
*`Export page EDN data` - Run this command on the current page to copy it to the clipboard. When this is imported to an existing page, it will append to the existing page.
429
431
*`Export graph's tags and properties EDN data` - Run this command to copy the entire graph's tags and properties. This is useful for sharing your workflows with others without sharing your graph-specific data. This is an example of a workflow that was not possible with file graphs.
430
432
*`Import EDN data` - Run this command to import any of the above exported data. If importing a block, you must have focus on the block you want to import into.
431
433
432
-
This feature is also available for the whole graph using the `Export EDN file` and `EDN to DB graph` options described above.
434
+
This feature is also available:
435
+
* for the whole graph using the `Export EDN file` and `EDN to DB graph` options described above.
436
+
* from any [view](#views) as a header action. For example, go to the `All pages` view and filter it to only export the viewable pages.
437
+
* for multiple selected nodes with the `Copy / Export as` modal.
433
438
434
439
For developers, this shareable EDN data can also be used in scripts to create or modify existing graphs. For example, a page's data could be passed to [this script](https://github.com/logseq/logseq/blob/feat/db/deps/db/script/create_graph.cljs) to create a new DB graph with that page.
435
440
436
-
437
441
## Scripting
438
442
439
443
DB graphs are scriptable using https://github.com/logseq/nbb-logseq/tree/feat/db. Scripts can both read and _write any_ data in a DB graph. To write your own script, you'll need a package.json and nbb.edn. Use [this example package.json](https://github.com/logseq/publish-spa/blob/feat/db/package.json) and [this example nbb.edn](https://github.com/logseq/publish-spa/blob/feat/db/nbb.edn). Some example scripts:
0 commit comments