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: docs/faq.html
+16-1Lines changed: 16 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -31,6 +31,17 @@ <h2 id="does-hindsite-support-themes">Does hindsite support themes?</h2>
31
31
<p>Themes are baked in, every <ahref="/hindsite/index.html#projects">project template directory</a>
32
32
is a theme and the <ahref="/hindsite/index.html#init-command">init command</a> is the “theme”
33
33
installer.</p>
34
+
<h2id="why-does-the-serve-command-sometimes-fail-a-live-reload">Why does the <code>serve</code> command sometimes fail a live reload?</h2>
35
+
<p>Some text editors create temporary and backup files when documents are saved and
36
+
created, you need to exclude these files from document processing. Failure to do
37
+
so can result in rebuild false positives and premature watcher reloads.</p>
38
+
<p>For example, the Vim editor creates tilda prefixed backup files and temporary
39
+
<ahref="https://github.com/neovim/neovim/issues/3460"><code>4913</code> files</a> so you need to add
40
+
them to the <ahref="/hindsite/index.html#configuration-parameters"><code>exclude</code></a> configuration
41
+
parameter in the templates directory root <ahref="/hindsite/index.html#configuration-files">configuration
42
+
file</a>.</p>
43
+
<p>TOML example:</p>
44
+
<pre><code>exclude = "*~|4913"</code></pre>
34
45
<h2id="disqus-howto">How do I include Disqus comments in my website?</h2>
35
46
<p>The recipe described below is taken from the hindsite <ahref="https://github.com/srackham/hindsite/tree/master/builtin/blog/template">built-in <code>blog</code>
36
47
project</a>.
@@ -67,7 +78,11 @@ <h2 id="disqus-howto">How do I include Disqus comments in my website?</h2>
67
78
</li><li>Include the Disqus template in your web pages by adding this line to the end
68
79
of the HTML body in your document footer template:<pre><code>{{template "disqus" .}}</code></pre>
69
80
</li><li>Add a <code>user</code><code>shortname</code> entry to the project <ahref="/hindsite/index.html#configuration"><code>config</code>
70
-
file</a>.</li></ol><p>That's it, all published documents with a non-blank <ahref="/hindsite/index.html#document-id">document
0 commit comments