Full House Templates

Tutorial | Documentation | Showcases

A part of the Logseq13 family of plugins

Summary

Super-configurable, JavaScript-based Logseq Templates for Humans ❤️ focused on UX and simplicity. This is the missing power in your Logseq knowledge base.

⚜️ Features

• 💪 Rendering templates :) Completely replaces standard templates (can render them all)
• 🤘 Accessing to any meta information: pages titles, blocks properties & content, your graph, etc.
• 📅 Full support of dates-work: parsing, formatting, shifting
• 👁‍🗨 Use views (or dynamic templates) to get freshly updated data of your graph
• ☘️ Focusing on UX and simplicity: no more headache on where to add a space to make it work
• 🔗 Easily make a reference to any journal page: relative to now moment, the current page, specific date or whatever you want
• 👻 High configurability with JavaScript logic: vars, conditions, loops (if you know what I mean 😈)
• 🛠 A set of handy template tags to work with

Very quick overview

Create amazing views: Glass Card from Logseq.com landing page

Insert templates from lovely UI 🤗

Set cursor position after template insertion 🔱

Create parametrized data views 🪜

Add logic to templates 📖

                                                   template     →     rendered on page [[Tiago Forte — Building a Second Brain]]

- template:: book
  - ``{ var [ authors, name ] = c.page.name.split(' — ') }``
    alias:: ``[name]``
		author:: ``authors.split(', ').map(ref).join(', ')``
		category:: [[📖/productivity]]
		tags:: book,
  - # Book overview
  - ...
  - rendered with template «``c.template.name``» [→] (``[c.template.block]``)
  - on ``date.now``

Use query language to get pages info 📚

template     →     rendered

``{
var books = query.pages()
  .tags('book')
  .property('likes')
    .value('>', '👍👍')
  .property('year')
    .value('>', 1994)
  .get()
  .sorted((p) => [p.props.likes, -p.props.year])
  .reverse()
  .groupby((p) => p.props.likes)
  .forEach(([likes, objs]) => {
     outn(likes)
     objs.forEach((p) => {
        out('   ' + p.props.year)
        outn(ref(p.propsRefs.alias.at(-1)))
     })
  })
}``

Mix with standard templates syntax 💥

template     →     rendered

- Mixing [./Full House Templates]([[logseq/plugins/Full House Templates]]) and stadard {{renderer(:view,"c.page.namespace.parts[0]")}} templates syntax `'in one template'.bold()`
  template:: mix-syntax
  - Current page:
    - <% current page %>
    - `[c.page]`
    - `ref(c.page)` or `c.page.name`
  - Journal pages:
    - <% tomorrow %>
    - `[tomorrow]` or `date.tomorrow`
  - NLP dates:
    - <% in two days %>
    - `[date.nlp('in two days')]` or `date.nlp('in two days')`

Mix with macros: Inline properties referencing example 🔭

See all plugin features in the Tutorial

If you ❤️ what I'm doing — consider to support my work

Installation

From Logseq Marketplace (recommended way):

• Click «...» and open the «Plugins» section (or press t p)
• Click on the «Marketplace»
• On the «Plugins» tab search for «Full House Templates» plugin and click install
• See the Tutorial to start using your new superpower :)

Manual way (in case of any troubles with recommended way)

• Enable «Developer mode» in «...» → Settings → Advanced
• Download the latest plugin release in a raw .zip archive from here and unzip it
• Go to the «...» → Plugins, click «Load unpacked plugin» and point to the unzipped plugin
• ⚠️ The important point here is: every new plugin release should be updated manually

FAQ

How to fix colors of plugin UI for custom Logseq theme?

1. After the release of Logseq v0.10.5, some issues with plugin UI colors appeared
2. To fix them add following CSS rules to custom.css:

   :root {
      --fht-footer-text: var(--ls-page-inline-code-color);
      --fht-hightlight: var(--ls-page-mark-bg-color);
      --fht-label-text: var(--ls-page-inline-code-color);
      --fht-active: var(--ls-quaternary-background-color);
      --fht-active-text: var(--ls-secondary-text-color);
      --fht-scrollbar-thumb: color-mix(in srgb, var(--ls-scrollbar-thumb-hover-color) 50%, transparent);
      --fht-scrollbar-thumb-hover: var(--ls-scrollbar-thumb-hover-color);
   }

How to insert frequently used templates rapidly fast?

1. Create the :command in config.edn. Hint: to perform fast searches, use any command name, but add a special character (e.g. the dot «.»)

   :commands
    [
    	["psy client session                                             [.]"
            [[:editor/input "{{renderer :template, psy → session, :page [[client ]], :online}}" {:backward-pos 13}]] ],
    ]
   

2. Restart Logseq with ⌘R or Ctrl+R
3. Use /-command to insert template with only 3 key presses (/.↩︎):

How to overcome the bug with new lines when using views?

It's Logseq's issue. Just append additional space «␣» to the end of every middle line.

How to use plugin with :macros?

Short answer: Use the more powerful :template-view command instead, specially designed for this case.

The only reason to use macros is to reduce the length of text to type-in:

{{mymacro ARG1, ARG2}}

versus

{{renderer :template-view mytemplate, ARG1, ARG2}}

But for that purpose it is better to use :commands to make it faster.

Long answer is here.

Alternatives

Credits

• Inspiration:
  • Obsidian Templater by SilentVoid13
  • Logseq SmartBlocks by sawhney17
  • Logseq Assets Plus by xyhp915
• Tech:
  • Eta: Lightweight embedded JS templating engine
  • Day.js: A minimalist JavaScript library for dates and times work
  • fuzzysort: SublimeText-like fuzzy search
  • NeatJSON: Pretty-print JS-objects
• Icon created by monkik

License

MIT License