From a3028cfcd47e168f6f66aca68be36bf2d63528db Mon Sep 17 00:00:00 2001 From: jethrokuan Date: Thu, 9 Jul 2020 04:56:54 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20=20@=20ca4a7?= =?UTF-8?q?421bc9111da16136d75dbbe609518c075a1=20=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- manual/The-Templating-System.html | 23 +++++++++++++---------- org-roam.org | 23 +++++++++++++---------- org-roam.texi | 23 +++++++++++++---------- 3 files changed, 39 insertions(+), 30 deletions(-) diff --git a/manual/The-Templating-System.html b/manual/The-Templating-System.html index b079a33..3374b32 100644 --- a/manual/The-Templating-System.html +++ b/manual/The-Templating-System.html @@ -69,8 +69,9 @@ Next:

6 The Templating System

-

Rather than creating blank files on ‘org-roam-insert’ and ‘org-roam-find-file’, it -may be desirable to prefill the file with templated content. This may include: +

Rather than creating blank files on org-roam-insert and org-roam-find-file, +it may be desirable to prefill the file with templated content. This may +include:

This requires a complex template insertion system. Fortunately, Org ships with a -powerful one: ‘org-capture’. However, org-capture was not designed for such use. -Org-roam abuses ‘org-capture’, extending its syntax. To first understand how -org-roam’s templating system works, it may be useful to look into basic usage of -‘org-capture’. +powerful one: org-capture (see (org)capture). However, org-capture was not +designed for such use. Org-roam abuses org-capture, extending its syntax and +capabilities. To first understand how org-roam’s templating system works, it may +be useful to look into basic usage of org-capture.

-

Org-roam’s templates can be customized by modifying the variable -‘org-roam-capture-templates’. Just like the base ‘org-capture’ this variable can -contain multiple templates, in which case you will be prompted on which one to -use when capturing a new note. +

For these reasons, Org-roam capture templates are not compatible with regular +org-capture. Hence, Org-roam’s templates can be customized by instead +modifying the variable org-roam-capture-templates. Just like +org-capture-templates, org-roam-capture-templates can contain multiple +templates. If org-roam-capture-templates only contains one template, there +will be no prompt for template selection.

• Template Walkthrough:   diff --git a/org-roam.org b/org-roam.org index 48cd450..e096676 100644 --- a/org-roam.org +++ b/org-roam.org @@ -349,8 +349,9 @@ The backlinks buffer will show any cites of this key: e.g. [[file:images/org-ref-citelink.png]] * The Templating System -Rather than creating blank files on =org-roam-insert= and =org-roam-find-file=, it -may be desirable to prefill the file with templated content. This may include: +Rather than creating blank files on ~org-roam-insert~ and ~org-roam-find-file~, +it may be desirable to prefill the file with templated content. This may +include: - Time of creation - File it was created from @@ -358,15 +359,17 @@ may be desirable to prefill the file with templated content. This may include: - Any other data you may want to input manually This requires a complex template insertion system. Fortunately, Org ships with a -powerful one: =org-capture=. However, org-capture was not designed for such use. -Org-roam abuses =org-capture=, extending its syntax. To first understand how -org-roam's templating system works, it may be useful to look into basic usage of -=org-capture=. +powerful one: ~org-capture~ (see info:org#capture). However, org-capture was not +designed for such use. Org-roam abuses ~org-capture~, extending its syntax and +capabilities. To first understand how org-roam's templating system works, it may +be useful to look into basic usage of ~org-capture~. -Org-roam's templates can be customized by modifying the variable -=org-roam-capture-templates=. Just like the base =org-capture= this variable can -contain multiple templates, in which case you will be prompted on which one to -use when capturing a new note. +For these reasons, Org-roam capture templates are not compatible with regular +~org-capture~. Hence, Org-roam's templates can be customized by instead +modifying the variable ~org-roam-capture-templates~. Just like +~org-capture-templates~, ~org-roam-capture-templates~ can contain multiple +templates. If ~org-roam-capture-templates~ only contains one template, there +will be no prompt for template selection. ** Template Walkthrough diff --git a/org-roam.texi b/org-roam.texi index ec1691d..e7476d0 100644 --- a/org-roam.texi +++ b/org-roam.texi @@ -525,8 +525,9 @@ The backlinks buffer will show any cites of this key: e.g. @node The Templating System @chapter The Templating System -Rather than creating blank files on @samp{org-roam-insert} and @samp{org-roam-find-file}, it -may be desirable to prefill the file with templated content. This may include: +Rather than creating blank files on @code{org-roam-insert} and @code{org-roam-find-file}, +it may be desirable to prefill the file with templated content. This may +include: @itemize @item @@ -540,15 +541,17 @@ Any other data you may want to input manually @end itemize This requires a complex template insertion system. Fortunately, Org ships with a -powerful one: @samp{org-capture}. However, org-capture was not designed for such use. -Org-roam abuses @samp{org-capture}, extending its syntax. To first understand how -org-roam's templating system works, it may be useful to look into basic usage of -@samp{org-capture}. +powerful one: @code{org-capture} (see @ref{capture,,,org,}). However, org-capture was not +designed for such use. Org-roam abuses @code{org-capture}, extending its syntax and +capabilities. To first understand how org-roam's templating system works, it may +be useful to look into basic usage of @code{org-capture}. -Org-roam's templates can be customized by modifying the variable -@samp{org-roam-capture-templates}. Just like the base @samp{org-capture} this variable can -contain multiple templates, in which case you will be prompted on which one to -use when capturing a new note. +For these reasons, Org-roam capture templates are not compatible with regular +@code{org-capture}. Hence, Org-roam's templates can be customized by instead +modifying the variable @code{org-roam-capture-templates}. Just like +@code{org-capture-templates}, @code{org-roam-capture-templates} can contain multiple +templates. If @code{org-roam-capture-templates} only contains one template, there +will be no prompt for template selection. @menu * Template Walkthrough::