Merge pull request #8 from parente/parente/utterances

Add support for utteranc.es

Author: parente

generate.py

@@ -37,6 +37,8 @@
 class Page(TypedDict):
     """A page on the site."""
 
+    # Allow comments on the page
+    allow_comments: NotRequired[bool]
     # Author of the page, if different from SITE_AUTHOR
     author: NotRequired[str]
     # Brief introductory comment above the start of a page *in HTML*
@@ -198,6 +200,8 @@ def execute(self, path: str, page: Page):
             page["author"] = SITE_AUTHOR
         if "excerpt" not in page:
             page["excerpt"] = self._build_excerpt(text)
+        if "allow_comments" not in page:
+            page["allow_comments"] = True
         page["src"] = path
         page["slug"] = self._build_page_slug(page)
         page["html"] = html

pages/20241129-obsidian-webclipper-config/index.md

@@ -66,13 +66,13 @@ PARAMETER temperature 0.25
 1. Click the Obsidian icon in the Firefox toolbar and then click the gear to open the settings screen again.
 2. Click _Interpreter_ and enable it.
 3. Click _Add provider_ and enter details about the local Ollama server.
-   - _Provider_: `Ollama`
-   - _Base URL_: `http://127.0.0.1:11434/api/chat`
-   - _API key_: `ollama`
+    - _Provider_: `Ollama`
+    - _Base URL_: `http://127.0.0.1:11434/api/chat`
+    - _API key_: `ollama`
 4. Click _Add model_ and enter details about the local Ollama server.
-   - _Provider_: `Ollama`
-   - _Display name_: `Llama 3.2 (ctx=32k, t=0.25)`
-   - _Model ID_: `llama3.2:ctx32k-t0.25` (the ID used when running `ollama create` earlier)
+    - _Provider_: `Ollama`
+    - _Display name_: `Llama 3.2 (ctx=32k, t=0.25)`
+    - _Model ID_: `llama3.2:ctx32k-t0.25` (the ID used when running `ollama create` earlier)
 
 ## Create a new template
 

pages/about/index.md

@@ -1,6 +1,7 @@
 ---
 title: About
 excerpt: Who do I say / think I am?
+allow_comments: false
 ---
 
 <img alt="Image of Peter Parente" class="inlineRight profilePic" width="140" height="140" src="https://s.gravatar.com/avatar/c7d6948add10f2d0ea4928e4995d6b32?s=128" />

static/css/site.css

@@ -80,7 +80,6 @@ iframe {
 }
 
 #siteMeta.row {
-    padding-top: 0;
     margin: 0;
 }
 
@@ -89,14 +88,19 @@ iframe {
 }
 
 #siteMeta h3 {
-    margin-top: 30px;
+    margin-top: 0;
 }
 
-#pageMeta {
-    margin-top: 60px;
+
+#siteMeta i {
+    padding-right: 0.25em;
 }
 
-#pageMeta .excerpt {
+#nextRead h3 {
+    margin-top: 0;
+}
+
+#nextRead .excerpt {
     font-style: italic;
 }
 
@@ -114,8 +118,12 @@ iframe {
     margin: 1em 0px;
 }
 
-#siteMeta i {
-    padding-right: 0.25em;
+#mainColumn {
+    margin-bottom: 60px;
+}
+
+#userComments .utterances {
+    max-width: inherit !important;
 }
 
 .footerSection {
@@ -199,6 +207,9 @@ body .gist {
 
 .commentary {
     font-size: 0.8em;
+    color: #999;
+    line-height: 1.1em;
+    margin-bottom: 30px;
 }
 
 .container{

templates/page.mako

@@ -15,14 +15,26 @@
     <p class="pageDate">${page['date'].strftime('%B %d, %Y')}</p>
   % endif
   % if 'author_comment' in page:
-    <p class="commentary"><i class="fa fa-comment-o"></i> ${page['author_comment']}<hr /></p>
+    <p class="commentary"><i class="fa fa-comment-o"></i> ${page['author_comment']}</p>
   % endif
   ${page['html']}
 </%block>
 
 <%block name="pageMeta">
+  % if 'allow_comments' in page:
+  <div class="footerSection" id="userComments">
+    <script src="https://utteranc.es/client.js"
+          repo="parente/blog"
+          issue-term="[${page['slug']}]"
+          label="thread"
+          theme="github-light"
+          crossorigin="anonymous"
+          async>
+    </script>
+  </div>
+  % endif 
   % if 'next' in page:
-    <div class="footerSection" id="pageMeta">
+    <div class="footerSection" id="nextRead">
         <h3>Another Read: <a href="${site_root}/${page['next']['slug']}">${page['next']['title']} &#187;</a></h3>
         <div class="excerpt">${page['next']['excerpt']}</div>
     </div>

templates/shell.mako

@@ -35,9 +35,10 @@
         <%block name="mainColumn" />
       </article>
 
-      <!-- Meta -->
+      <!-- Page Meta -->
       <%block name="pageMeta" />
 
+      <!-- Site Meta -->
       <div class="row footerSection gx-5" id="siteMeta">
 
         <div class="col-md-3" id="social">