fix: comment support for pages

config.toml

@@ -16,7 +16,6 @@ toc = true
 use_cdn = false
 favicon = "/icon/favicon.png"
 theme = "toggle"              # light, dark, auto, toggle
-comment = false
 fancy_code = true
 dynamic_note = true           # a note that can be toggled
 mathjax = true

content/posts/_index.md

@@ -4,4 +4,7 @@ title = "Posts"
 sort_by = "date"
 
 insert_anchor_links = "heading"
+
+[extra]
+comment = true
 +++

content/posts/configuration.md

@@ -7,8 +7,11 @@ tags=["documentation"]
 
 [extra]
 repo_view = true
+comment = true
 +++
 
+# Site Configuration
+
 ## Theme Mode (`theme`)
 
 Sets the color theme for your blog.
@@ -20,7 +23,7 @@ Sets the color theme for your blog.
 
 The "toggle" option allows users to switch between light and dark modes, while "auto" typically follows the user's system preferences.
 
-## Menu 
+## Menu
 
 Defines the navigation menu items for your blog.
 
@@ -38,7 +41,7 @@ Defines the navigation menu items for your blog.
 
 ## Socials
 
-Defines the social media links. 
+Defines the social media links.
 
 - Type: Array of objects
 - Default: []
@@ -80,18 +83,6 @@ Specifies the path to the favicon image for your blog.
 
 This sets the small icon that appears in the browser tab for your website.
 
-## Comments (`comment`)
-
-Enables or disables the comment system for posts.
-
-- Type: Boolean
-- Default: false
-- Usage: `comment = false`
-
-After making `comment = true` save your script from [Giscus](https://giscus.app) to `templates/_giscus_script.html`.
-When enabled, this allows readers to leave comments on your blog posts.
-
-
 ## Fancy Code Styling (`fancy_code`)
 
 Enables enhanced styling for code blocks.
@@ -112,6 +103,17 @@ Allows for the creation of togglable note sections in your content.
 
 When enabled, you can create expandable/collapsible note sections in your blog posts.
 
+## Anchor Links
+
+You can add anchor links by adding the following to your `_index.md`:
+```toml
+insert_anchor_links = "heading"
+```
+
+# Page configuration
+
+
+
 ## Source code (`repo_view`)
 
 Do you want to link to the source code of your blog post? You can turn on the `repo_view` inside the `[extra]` section of your blog post.
@@ -124,9 +126,34 @@ repo_url = "https://github.com/not-matthias/apollo/tree/main/content"   # Altern
 
 The `repo_url` can be set in the `[extra]` section or in your `config.toml`.
 
-## Anchor Links
+## Comments (`comment`)
 
-You can add anchor links by adding the following to your `_index.md`:
+Enables or disables the comment system for posts.
+
+- Type: Boolean
+- Default: false
+- Usage: `comment = false`
+
+After making `comment = true` in `[extra]` section of you post, save your script from [Giscus](https://giscus.app) to `templates/_giscus_script.html`.
+When enabled, this allows readers to leave comments on your blog posts. This feature has to be set for each individual post and is not supported at higher levels.
+
+Example configuration in [content/posts/configuration.md](https://github.com/not-matthias/apollo/blob/main/content/posts/configuration.md):
 ```toml
-insert_anchor_links = "heading"
++++
+title = "Configuring Apollo"
+
+[extra]
+comment = true
++++
+```
+
+Comments via [utterances](utteranc.es) can be configured in `template/_giscus_script.html` like this:
+```html
+<script src="https://utteranc.es/client.js"
+        repo="not-matthias/apollo"
+        issue-term="pathname"
+        theme="github-light"
+        crossorigin="anonymous"
+        async>
+</script>
 ```

content/posts/markdown.md

@@ -5,6 +5,9 @@ updated = "2022-05-01"
 
 [taxonomies]
 tags=["example"]
+
+[extra]
+comment = true
 +++
 
 # H1
@@ -80,5 +83,5 @@ fn main() {
 
 ## Code tags
 
-Lorem ipsum `dolor` sit amet, `consectetur adipiscing` elit. 
+Lorem ipsum `dolor` sit amet, `consectetur adipiscing` elit.
 `Lorem ipsum dolor sit amet, consectetur adipiscing elit.`

content/posts/math-symbol.md

@@ -4,6 +4,9 @@ date = "2023-01-06"
 
 [taxonomies]
 tags=["example"]
+
+[extra]
+comment = true
 +++
 
 Note: This requires the `mathjax` and `mathjax_dollar_inline_enable` option set to `true`.

content/posts/shortcode.md

@@ -4,11 +4,14 @@ date = "2024-06-14"
 
 [taxonomies]
 tags=["example"]
+
+[extra]
+comment = true
 +++
 
 
 ## Note
- 
+
 Here is an example of the `note` shortcode:
 
 This one is static!

templates/_giscus_script.html

@@ -0,0 +1,7 @@
+<script src="https://utteranc.es/client.js"
+        repo="not-matthias/apollo"
+        issue-term="pathname"
+        theme="github-light"
+        crossorigin="anonymous"
+        async>
+</script>

templates/base.html

@@ -15,11 +15,16 @@
             Nothing here?!
         {% endblock main_content %}
 
-        {% if config.extra.comment | default(value=false) %}
+        {% if page.extra.comment is defined  %}
+            {% set show_comment = page.extra.comment %}
+        {% else %}
+            {% set show_comment = false %}
+        {% endif %}
+
+        {% if show_comment %}
         <div class="giscus"></div>
         {% include "_giscus_script.html" %}
         {% endif %}
-
     </div>
 </body>