added option to set a page as home; added options to hide title or share button in post

README.md

@@ -43,6 +43,12 @@ summaryLength = 70  # number of words for article summaries
     extraContentDirs = []  # other content directories to render similarly to the home page
     showcaseDir = "showcase"  # create a content directory that shows a special showcase section in the home page
 
+    # shows a specified single page as a home page, instead of the traditional articles list
+    # requires setting `homeSinglePage`
+    # goes well with extraContentDirs
+    showSinglePageAsHome = false
+    homeSinglePage = "/home"
+
     # It's best to put these icons in the "static" folder of your site
     logo = "/logo.svg"
     favicon = "/favicon.png"  # 32x32
@@ -249,6 +255,8 @@ Every post can have various parameters in the frontmatter, here are some that yo
 - `featured`: boolean, indicate if the post should be shown as featured
 - `comments`: boolean, if true it enables comments for the current post, if false it disables them (default is true)
 - `showDate`: boolean, true by default, if false hides the date. Useful for non-article pages where the date isn't important
+- `showTitle`: boolean, true by default, if false hides the title.
+- `showShare`: boolean, true by default, if false hides the share button.
 - `norss`: boolean, if set to true the page will be skipped in the rss feed
 - `nosearch`: boolean, if set to true the page won't show up in searches
 - `toc`: boolean, if set to true a table of contents will be shown for the article

layouts/_default/single.html

@@ -1,41 +1,3 @@
 {{ define "main" }}
-    {{- partial "inject/content-before.html" . -}}
-    <article class="card single">
-        <h1>{{ .Title }}</h1>
-        {{ if (.Params.showDate | default true) }}
-            <p class="date">
-                <span title='{{ i18n "date" }}'> </span>
-                {{- partial "date.html" .Date -}}
-            </p>
-        {{ end }}
-        {{ if .Params.Image }}
-        <img src="{{ .Params.Image }}" alt="" />
-        {{ end }}
-        {{ if (.Params.toc | default false) }}
-            <div class="articleToc">
-                {{ .TableOfContents }}
-                <hr />
-            </div>
-        {{ end }}
-        <div>{{ .Content }}</div>
-    </article>
-    {{ if .Params.tags }}
-        {{ if not .Site.Params.paperCards }}<hr />{{ end }}
-        <p class="articleTagsContainer">
-            <span> </span>
-            <strong>{{ i18n "tagsColumn" }}</strong>
-            {{ range sort .Params.tags }}
-                <a
-                    {{ if site.Params.buttonTags | default false }}
-                    class="buttonTag"
-                    {{ end }}
-                    href="/tags/{{ . | urlize }}">#{{ . }}</a>
-            {{ end }}
-        </p>
-    {{ end }}
-    {{- partial "inject/content-after.html" . -}}
-    {{- partial "share_on_fediverse.html" . -}}
-    {{- partial "commento.html" . -}}
-    {{- partial "cactus_chat.html" . -}}
-    {{- partial "related_articles.html" . -}}
+    {{- partial "single_post.html" . -}}
 {{ end }}

layouts/index.html

@@ -4,6 +4,12 @@
     {{ $postsDir := .Site.Params.Posts | default (slice "posts" "post") }}
     {{ $allPostsList := where (where site.RegularPages "Section" "in" $postsDir) "Section" "!=" "" }}
     {{- partial "showcase.html" . -}}
+    {{ if and .Site.Params.showSinglePageAsHome (ne .Site.Params.homeSinglePage "") }}
+        {{ with .Site.GetPage .Site.Params.homeSinglePage }}
+            {{- partial "single_post.html" . -}}
+        {{ end }}
+    {{ else }}
         {{- partial "home_post_list.html" (dict "Ctx" . "AllPostsList" $allPostsList) -}}
+    {{ end }}
 
 {{ end }}

layouts/partials/single_post.html

@@ -0,0 +1,43 @@
+{{- partial "inject/content-before.html" . -}}
+<article class="card single">
+    {{ if .Params.showTitle | default true }}
+        <h1>{{ .Title }}</h1>
+    {{ end }}
+    {{ if (.Params.showDate | default true) }}
+        <p class="date">
+            <span title='{{ i18n "date" }}'> </span>
+            {{- partial "date.html" .Date -}}
+        </p>
+    {{ end }}
+    {{ if .Params.Image }}
+    <img src="{{ .Params.Image }}" alt="" />
+    {{ end }}
+    {{ if (.Params.toc | default false) }}
+        <div class="articleToc">
+            {{ .TableOfContents }}
+            <hr />
+        </div>
+    {{ end }}
+    <div>{{ .Content }}</div>
+</article>
+{{ if .Params.tags }}
+    {{ if not .Site.Params.paperCards }}<hr />{{ end }}
+    <p class="articleTagsContainer">
+        <span> </span>
+        <strong>{{ i18n "tagsColumn" }}</strong>
+        {{ range sort .Params.tags }}
+            <a
+                {{ if site.Params.buttonTags | default false }}
+                class="buttonTag"
+                {{ end }}
+                href="/tags/{{ . | urlize }}">#{{ . }}</a>
+        {{ end }}
+    </p>
+{{ end }}
+{{- partial "inject/content-after.html" . -}}
+{{ if .Params.showShare | default true }}
+    {{- partial "share_on_fediverse.html" . -}}
+{{ end }}
+{{- partial "commento.html" . -}}
+{{- partial "cactus_chat.html" . -}}
+{{- partial "related_articles.html" . -}}