Skip to content

Releases: xwtaidev/obsidian-lattice-plugin

Release list

0.1.1

Choose a tag to compare

@github-actions github-actions released this 03 Oct 06:37

0.1.1

The plugin is now called Lattice Board, and its id is lattice-board.
Nothing else changed.

If you had 0.1.0 installed, remove it before installing this one — the id
changed, so the two show up as separate plugins.

0.1.0

Choose a tag to compare

@github-actions github-actions released this 03 Oct 06:00

A kanban board of your notes. Columns are the values of a property, cards are notes, and dragging a card into a column writes that value back to the note.

Lattice 0.1.0 is the first release. It is a Bases view: a board is a .base file, the Lattice icon in the left ribbon opens it, and that file is kept out of the file explorer so the icon is the only way in that matters.

Requirements

  • Obsidian 1.10.2 or newer — the board is a Bases view and its + uses createFileForView.
  • Core plugin Bases enabled.
  • Built and tested against Obsidian 1.12.4, desktop.

Install

Not in the community directory yet, so this is a manual install:

  1. Download main.js, manifest.json and styles.css from the assets below.
  2. Put all three in <Vault>/.obsidian/plugins/lattice/.
  3. Reload Obsidian, then enable Lattice in Settings → Community plugins.

Getting started

  1. Make a folder named lattice-cards in your vault. Do this first — see the note below.
  2. Copy examples/lattice-board.base from the repository into your vault, and open it. The board renders in place of a table.
  3. After that, use the Lattice icon in the left ribbon. It opens the same file without stacking a second tab.
  4. The example filters to notes tagged #task and groups by status. Point latticeGroupBy at any property to make the columns whatever you want.

What's in 0.1.0

  • Columns are the values of a property. latticeGroupBy names it, and the board collects the values and builds the columns.
  • Drag to write. Drop a card into a column and that value is written back to the note; drag a column header to reorder the columns. Both are remembered in the .base.
  • Cards open in the drawer, so the board stays put. Cmd/Ctrl+click opens the note in a tab instead, and a preview in the sidebar carries a button that moves it to the main area and folds the drawer away.
  • + on a column header makes a note in the .base's newItemFolder and fills in that column's value. The column that collects notes with no value behaves the same, without a value.
  • A card shows its title, the properties the board deals in, when the note was created and last changed, and its opening paragraph clamped to two lines — that last one can be switched off per view.
  • Values are coloured out of Obsidian's own eight theme colours, so they follow your theme.
  • Search reaches titles. What you type in the board's search box is matched against a note's title, not only the property values the card displays.
  • Sort, filter and the view menu are hidden on a board for now. A board has no use for a table's columns, and the view menu can only make a table.

Known limitations

  • The newItemFolder folder has to exist. If it does not, + does nothing at all — no note, no error, no notice. Core writes the file itself and swallows the failure, so Lattice has nothing to report.
  • Renaming or moving the board file leaves Lattice behind. The setting stores a path, and nothing watches for a rename.
  • The board file is hidden only in the main window. A file explorer opened in a pop-out window still lists it.
  • Multi-value properties are not grouped. A property holding several values lands under one column rather than several.
  • A colour comes from the value's text, not from the property option's colour. A status with colours set in Obsidian's property settings keeps Lattice's own colours.
  • An ordinary column disappears once it empties; a column added by hand stays.
  • Hiding a file is a workaround. Core exposes no API for it and no setting does it, so Lattice watches the file tree and marks the row. If the mark misses, the file simply reappears — which is the safe way for it to fail.

License

MIT