From bf09d11f3d229586ff76835124562db191eeff6c Mon Sep 17 00:00:00 2001
From: jethrokuan <jethrokuan95@gmail.com>
Date: Thu, 20 Jan 2022 19:20:12 +0000
Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20=20@=206f5d6?=
 =?UTF-8?q?5abd9e707b3fdb10092a9fef3b739e143dd=20=F0=9F=9A=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 manual.html   | 13 +++++++------
 org-roam.org  | 13 +++++++------
 org-roam.texi | 13 +++++++------
 3 files changed, 21 insertions(+), 18 deletions(-)

diff --git a/manual.html b/manual.html
index 26a50d5..eb3155d 100644
--- a/manual.html
+++ b/manual.html
@@ -917,14 +917,15 @@ closure is evaluated and the return value is used as the
 template. The closure must evaluate to a valid template string.
 </p></dd></dl>
 
-<p>The default template is optimized for vertical completion frameworks, such as
-Ivy and Selectrum. The additional space injected into the node completions may
-confuse users that aren&rsquo;t using these frameworks. To remove the additional
-spacing from the completions, set the node display template to something
-simpler, such as:
+<p>If you&rsquo;re using a vertical completion framework, such as Ivy and Selectrum,
+Org-roam supports the generation of an aligned, tabular completion interface.
+For example, to include a column for tags up to 10 character widths wide, one
+can set <code>org-roam-node-display-template</code> as such:
 </p>
 <div class="lisp">
-<pre class="lisp">(setq org-roam-node-display-template &quot;${title}&quot;)
+<pre class="lisp">(setq org-roam-node-display-template
+      (concat &quot;${title:*} &quot;
+              (propertize &quot;${tags:10}&quot; 'face 'org-tag)))
 </pre></div>
 
 <hr>
diff --git a/org-roam.org b/org-roam.org
index d1926a0..5ce7b55 100644
--- a/org-roam.org
+++ b/org-roam.org
@@ -455,14 +455,15 @@ through `org-roam-node-read`. The presentation of these nodes are governed by
   closure is evaluated and the return value is used as the
   template. The closure must evaluate to a valid template string.
 
-The default template is optimized for vertical completion frameworks, such as
-Ivy and Selectrum. The additional space injected into the node completions may
-confuse users that aren't using these frameworks. To remove the additional
-spacing from the completions, set the node display template to something
-simpler, such as:
+If you're using a vertical completion framework, such as Ivy and Selectrum,
+Org-roam supports the generation of an aligned, tabular completion interface.
+For example, to include a column for tags up to 10 character widths wide, one
+can set ~org-roam-node-display-template~ as such:
 
 #+begin_src emacs-lisp
-  (setq org-roam-node-display-template "${title}")
+  (setq org-roam-node-display-template
+        (concat "${title:*} "
+                (propertize "${tags:10}" 'face 'org-tag)))
 #+end_src
 
 * Customizing Node Caching
diff --git a/org-roam.texi b/org-roam.texi
index 5ea3341..fc4dbb0 100644
--- a/org-roam.texi
+++ b/org-roam.texi
@@ -750,14 +750,15 @@ closure is evaluated and the return value is used as the
 template. The closure must evaluate to a valid template string.
 @end defvar
 
-The default template is optimized for vertical completion frameworks, such as
-Ivy and Selectrum. The additional space injected into the node completions may
-confuse users that aren't using these frameworks. To remove the additional
-spacing from the completions, set the node display template to something
-simpler, such as:
+If you're using a vertical completion framework, such as Ivy and Selectrum,
+Org-roam supports the generation of an aligned, tabular completion interface.
+For example, to include a column for tags up to 10 character widths wide, one
+can set @code{org-roam-node-display-template} as such:
 
 @lisp
-(setq org-roam-node-display-template "$@{title@}")
+(setq org-roam-node-display-template
+      (concat "$@{title:*@} "
+              (propertize "$@{tags:10@}" 'face 'org-tag)))
 @end lisp
 
 @node Customizing Node Caching