@geekity/cms 0.39.0 → 0.41.0

package/themes/default/partials/markdown-footer.md.njk

@@ -1,6 +1,8 @@
 {#
   The end of every page's Markdown: the archive on a page that asked for one,
-  then a heading and link lists.
+  what the page is filed under, what links to it, a post's neighbours, the
+  conversation, where the comment and contact forms are, the feeds, then a
+  heading and the site's link lists.
 
   `archiveMonths` is on the context only of a page whose front matter says
   `archive: true`: every published post as `{ month, posts }`, newest month
@@ -8,16 +10,42 @@
   `description` already on one line, written here in the shape a listing's
   Markdown has.
 
+  `categories` and `tags` are a post's, each a `label` (the term as written)
+  and the `url` of its archive. `backlinks` are the site's posts and pages
+  that link to this one, newest first, each a `label`, a `url` and a `date`.
+  This theme leaves them off a homepage that is a page, as its front page
+  layout does; a site theme may print them there.
+  `feeds` are the feeds the HTML head advertises, each a `label` (the feed's
+  title), a `url`, a `format` (`RSS`, `Atom` or `JSON Feed`) and a `type`.
+  `conversation` is on a post or page that has been answered: what
+  `conversation.njk` draws, from the same reader, so nothing the HTML hides
+  is in it. Its `rsvps`, `likes`, `boosts` and `mentions` are people, each a
+  `label` and a `url` when there is one. Its `replies` are threaded as the
+  HTML's are, each a `key`, `source`, `author` (a `label` and a `url`), `url`,
+  `published`, `rsvp`, `text` (its words as Markdown) and its own `replies`,
+  or a `withheld` placeholder with only `replies`. `nest` indents a reply
+  under its list item. `commentForm` and `contactForm` are each the `url` of
+  the form on the HTML page, printed as it is, since a form needs HTML;
+  `commentForm` is absent while comments are closed. `webmention` is there
+  when the site takes webmentions.
+  `thread` is on a comment's own page, as the header describes it: its
+  `comment.replies` are threaded as a conversation's are, and `onPostUrl` is the
+  comment on the post's page.
+  `type` is `post`, `page`, `listing`, `comment` or `status` (a 404, 410,
+  500 or 503 page); a listing's newer and older pages are written by the CMS
+  above this, so only a post's `previous` and `next` are printed here.
+
   `byline` is a post's author, a `label` and the `url` of their archive.
   `navigation` is every item of every menu the site stores, each URL once,
   each a `label` and a `url`; `menus` has them by menu name, as the HTML
-  does. `home`, `previous` and `next` are here too, though the
-  front matter already carries them for a Markdown browser.
+  does. `home`, `previous` and `next` are here too; the front matter carries
+  them as well, for a Markdown browser.
 
   Each link is a line of its own, with its own words, so the same data can be
   written as a Gemini link line. Nothing is printed when there is nothing to
   link.
 #}
+{% import "partials/markdown-reply.md.njk" as conversing with context %}
 {% for group in archiveMonths %}
 ## {{ group.month | escapeMarkdown }}
 
@@ -26,6 +54,96 @@
 {% endfor %}
 
 {% endfor %}
+{% if categories.length or tags.length %}
+## Filed under
+
+{% for link in categories %}
+- [Category: {{ link.label | escapeMarkdown }}]({{ link.url | markdownUrl }})
+{% endfor %}
+{% for link in tags %}
+- [Tag: {{ link.label | escapeMarkdown }}]({{ link.url | markdownUrl }})
+{% endfor %}
+
+{% endif %}
+{% if backlinks.length and not staticFrontPage %}
+## Linked from
+
+{% for entry in backlinks %}
+- [{{ (((entry.date + " ") if entry.date) + entry.label) | escapeMarkdown }}]({{ entry.url | markdownUrl }})
+{% endfor %}
+
+{% endif %}
+{% if type == "post" and (previous or next) %}
+## More posts
+
+{% if previous %}
+- [Previous: {{ previous.label | escapeMarkdown }}]({{ previous.url | markdownUrl }})
+{% endif %}
+{% if next %}
+- [Next: {{ next.label | escapeMarkdown }}]({{ next.url | markdownUrl }})
+{% endif %}
+
+{% endif %}
+{% if conversation %}
+{% for group in conversation.rsvps.concat([{ label: "Likes", people: conversation.likes }, { label: "Boosts", people: conversation.boosts }, { label: "Mentions", people: conversation.mentions }]) %}
+{% if group.people.length %}
+## {{ group.label | escapeMarkdown }} ({{ group.people.length }})
+
+{% for person in group.people %}
+- {{ conversing.named(person) }}
+{% endfor %}
+
+{% endif %}
+{% endfor %}
+{% if conversation.replies.length %}
+## {{ conversation.counts.replies | plural({ one: "One reply", other: "# replies" }, "en") }}
+
+{% for entry in conversation.replies %}
+{{ conversing.reply(entry) | trim }}
+
+{% endfor %}
+{% if not commentForm %}
+Comments are closed.
+
+{% endif %}
+{% endif %}
+{% endif %}
+{% if thread %}
+{% if thread.comment.replies.length %}
+## Replies
+
+{% for entry in thread.comment.replies %}
+{{ conversing.reply(entry) | trim }}
+
+{% endfor %}
+{% endif %}
+[The whole conversation on {{ thread.post.label | escapeMarkdown }}]({{ thread.onPostUrl | markdownUrl }})
+
+{% endif %}
+{% if commentForm %}
+## Leave a comment
+
+[Leave a comment on the web page]({{ commentForm.url }})
+
+{% if webmention %}
+Or reply from your own site and send a [webmention](https://indieweb.org/Webmention).
+
+{% endif %}
+{% endif %}
+{% if contactForm %}
+## Send a message
+
+[Send a message on the web page]({{ contactForm.url }})
+
+{% endif %}
+{% if feeds.length %}
+## Feeds
+
+{% for feed in feeds %}
+- [{{ (feed.label + " (" + feed.format + ")") | escapeMarkdown }}]({{ feed.url | markdownUrl }})
+{% endfor %}
+
+{% endif %}
 {% if byline or navigation.length %}
 ## {{ site.title | escapeMarkdown }}
 

package/themes/default/partials/markdown-header.md.njk

@@ -15,11 +15,91 @@
   and a `url`). `staticFrontPage` is true on a homepage that is a page. This
   theme prints the bio there only when the homepage lists posts, as its HTML
   does (decision-45); a site theme may print it on a static homepage too.
+
+  A post then says what kind it is, with the data its HTML partials read.
+  `event` is an event's `start`, its `end` and its `location`, printed in the
+  site's zone as `event.njk` prints them. `cites` are what it answers or cites,
+  each a `verb`, a `url` and a `name`, as `reply-context.njk` and
+  `citations.njk` name them, with an `author` or `site`, an event's
+  `startDate` (in `startZone` when it has one), a `published` date, a
+  `location`, and a silo `copy`, each only when it is known. `review` is the
+  HTML's review with its words in plain text: `link`, `about`, `by`, `uid`
+  and `details`. `location` is where the post was written, only as far as
+  Settings > Privacy shares it, in the shape `location.njk` reads. `lang` is
+  the post's own language, which its dates are written in.
+
+  Then the post's recording and photos, in the order its HTML draws them.
+  `enclosure` is the object `recording.njk` reads: `player` (`audio` or
+  `video`), `url`, `type`, `length` in bytes (printed through `fileSize`), a
+  `transcript` with `url` and `captions`, and `alternates`, each a `url` and a
+  `type` with a `title` and a `length` when the front matter gives them.
+  `photos` are each a `url` and an `alt`, the alt text `photos.njk` prints.
+
+  `thread` is on a comment's own page, the chain `layouts/comment.njk` draws:
+  `post` (a `label`, a `url`, an `author` with a `label` and a `url`, a
+  `date` and a plain-text `summary`), then `ancestors`, the comments it
+  answers from the top of the thread down, each a reply as the footer's
+  conversation has one or `null` for one a reader may not see, then the
+  `comment` itself. The comment's words are the page's body, below this.
+  `quote` writes Markdown as a blockquote.
 #}
+{% import "partials/markdown-reply.md.njk" as conversing with context %}
 {% if title %}
 # {{ title | escapeMarkdown }}
 
 {% endif %}
+{% if event %}
+When: {{ event.start | date("datetime", none, lang) }}{{ (" to " + (event.end | date("datetime", none, lang))) if event.end }}
+
+{% if event.location %}
+Where: {{ ("Online at [" + (event.location.url | host | escapeMarkdown) + "](" + (event.location.url | markdownUrl) + ")") if event.location.kind == "virtual" else (event.location.name | escapeMarkdown) }}
+
+{% endif %}
+{% endif %}
+{% for cite in cites %}
+{{ cite.verb }} [{{ cite.name | escapeMarkdown }}]({{ cite.url | markdownUrl }}){{ (" by " + (cite.author | escapeMarkdown)) if cite.author }}{{ (" · " + (cite.site | escapeMarkdown)) if cite.site }}{{ (", " + (cite.startDate | date("readable", cite.startZone, lang))) if cite.startDate }}{{ (", " + (cite.published | date("readable", none, lang))) if cite.published }}{{ (", " + (cite.location | escapeMarkdown)) if cite.location }}
+
+{% if cite.copy %}
+Also in reply to [its copy on {{ cite.copy | host | escapeMarkdown }}]({{ cite.copy }})
+
+{% endif %}
+{% endfor %}
+{% if review %}
+Review of {{ ("[" + (review.item.name | escapeMarkdown) + "](" + (review.link | markdownUrl) + ")") if review.link else (review.item.name | escapeMarkdown) }}{{ (" (" + (review.about | join(", ") | escapeMarkdown) + ")") if review.about.length }}{{ (", " + (review.by | escapeMarkdown)) if review.by }}{{ (", " + (review.uid | escapeMarkdown)) if review.uid }}
+
+{% if review.details.length %}
+{{ review.details | join(" ") | escapeMarkdown }}
+
+{% endif %}
+{% if review.rating %}
+Rated {{ review.rating }} out of {{ review.best }}
+
+{% endif %}
+{% endif %}
+{% if location %}
+Location: {% for word in location.words %}{{ word.text | escapeMarkdown }}{{ ", " if not loop.last }}{% endfor %}{{ (location.geo.latitude + ", " + location.geo.longitude) if location.geo and not location.words.length }}
+
+{% endif %}
+{% if enclosure %}
+[Download the {{ "video" if enclosure.player == "video" else "recording" }}]({{ enclosure.url | markdownUrl }}) ({{ enclosure.type }}, {{ enclosure.length | fileSize }})
+
+{% if enclosure.transcript %}
+[{{ "Captions" if enclosure.transcript.captions else "Transcript" }}]({{ enclosure.transcript.url | markdownUrl }})
+
+{% endif %}
+{% if enclosure.alternates.length %}
+Other versions:
+
+{% for alternate in enclosure.alternates %}
+- [{{ (alternate.title or alternate.type) | escapeMarkdown }}]({{ alternate.url | markdownUrl }}){{ (" (" + ([alternate.type if alternate.title, alternate.length | fileSize] | select | join(", ")) + ")") if alternate.title or alternate.length }}
+{% endfor %}
+
+{% endif %}
+{% endif %}
+{% for photo in photos %}
+![{{ photo.alt | escapeMarkdown }}]({{ photo.url | markdownUrl }})
+
+{% endfor %}
 {% if bio and not staticFrontPage %}
 {% if bio.note %}
 {{ bio.note | escapeMarkdown }}
@@ -29,3 +109,25 @@
 - [{{ link.label | escapeMarkdown }}]({{ link.url | markdownUrl }})
 {% endfor %}
 {% endif %}
+{% if thread %}
+On [{{ thread.post.label | escapeMarkdown }}]({{ thread.post.url | markdownUrl }}){{ (" by " + conversing.named(thread.post.author)) if thread.post.author }}{{ (", " + (thread.post.date | date)) if thread.post.date }}
+
+{% if thread.post.summary %}
+{{ thread.post.summary | escapeMarkdown | quote }}
+
+{% endif %}
+{% for step in thread.ancestors %}
+{% if step %}
+In reply to {{ conversing.said(step) }}
+
+{% if step.text %}
+{{ step.text | quote }}
+
+{% endif %}
+{% else %}
+In reply to a comment that is no longer shown.
+
+{% endif %}
+{% endfor %}
+{{ conversing.said(thread.comment) }}
+{% endif %}

package/themes/default/partials/markdown-reply.md.njk

@@ -0,0 +1,31 @@
+{#
+  The macros the Markdown header and footer write a conversation with,
+  imported `with context` so `markdownUrl` gives a page of the site its `.md`.
+
+  `named(person)` is a person as a link, or their name when they have no URL.
+  `said(entry)` is a reply's byline: its author, its date linked to where it
+  can be read, and where it came from when that was not the comment form.
+  `reply(entry)` is a reply as a list item, its words and its own replies
+  indented under it, or the placeholder for a hidden one.
+#}
+{% macro named(person) %}{{ ("[" + (person.label | escapeMarkdown) + "](" + (person.url | markdownUrl) + ")") if person.url else (person.label | escapeMarkdown) }}{% endmacro %}
+{% macro said(entry) %}{{ named(entry.author) }}, {{ ("[" + (entry.published | date) + "](" + (entry.url | markdownUrl) + ")") if entry.url else (entry.published | date) }}{{ ", via webmention" if entry.source == "webmention" }}{{ ", via the fediverse" if entry.source == "activitypub" }}{% endmacro %}
+{% macro reply(entry) %}
+{% if entry.withheld %}
+- This comment is no longer shown.
+{% else %}
+- {{ said(entry) }}
+{% if entry.rsvp %}
+
+  {{ entry.rsvp.label | escapeMarkdown }}
+{% endif %}
+{% if entry.text %}
+
+  {{ entry.text | nest(2) }}
+{% endif %}
+{% endif %}
+{% for child in entry.replies %}
+
+  {{ reply(child) | trim | nest(2) }}
+{% endfor %}
+{% endmacro %}