Indexes: add people index

make use of the newly linking syntax to create a new index for people
and their relevant mentions in newsletters

Author: kouloumos

_config.yml

@@ -62,10 +62,18 @@ defaults:
       layout: topic
       permalink: /en/topics/:title/
       localizable: false
+  - scope:
+      path: "_people"
+    values:
+      layout: person
+      permalink: /en/people/:title/
+      localizable: false
 
 collections:
   topics:
     output: true
+  people:
+    output: true
 
 languages:
   - code: ja

_layouts/person.html

@@ -0,0 +1,98 @@
+---
+layout: post
+---
+{% capture newline %}
+{% endcapture %}
+{% capture /dev/null %}
+  <!-- Get links for previous and next pages -->
+  {% assign people_list = site.people | natural_sort: "title" %}
+  {% capture first_link %}[{{people_list[0].title}}]({{people_list[0].url}}){% endcapture %}
+  {% capture last_link %}[{{people_list[-1].title}}]({{people_list[-1].url}}){% endcapture %}
+  {% for entry in people_list %}
+    {% capture entry_link %}[{{entry.title}}]({{entry.url}}){% endcapture %}
+    {% if prev_link %}
+      {% assign next_link = entry_link %}
+      {% break %}
+    {% endif %}
+    {% if entry.url == page.url %}
+      {% assign prev_link = prev_entry | default: last_link %}
+    {% endif %}
+    {% assign prev_entry = entry_link %}
+  {% endfor %}
+
+  <!-- Build list of primary sources -->
+  {% for source in page.primary_sources %}
+    {%- if source.link contains 'http://' or source.link contains 'https://' -%}
+      {% capture reference %}[{{source.title}}]({{source.link}}){% endcapture %}
+    {%- else -%}
+      {% capture reference %}[{{source.title}}][{{source.link}}]{% endcapture %}
+    {%- endif -%}
+    {% capture primary_sources %}{{primary_sources}}{{newline}}- {{reference}}{% endcapture %}
+  {% endfor %}
+
+  <!-- Build list of internal optech mentions -->
+  {% assign references = '' %}
+  {% for mention in page.optech_mentions %}
+    {% if mention.feature == true %}
+      {% assign bold = '{:.bold}' %}
+    {% else %}
+      {% assign bold='' %}
+    {% endif %}
+    {% include functions/get-mention-date.md %}
+    {% capture references %}{{references}}{{date}}- [{{mention.title}}]({{mention.url}}){{bold}}ENDENTRY{% endcapture %}
+  {% endfor %}
+
+  <!-- Build list of see also entries -->
+  {% for source in page.see_also %}
+    {%- if source.link contains 'http://' or source.link contains 'https://' -%}
+      {% capture reference %}[{{source.title}}]({{source.link}}){% endcapture %}
+    {%- else -%}
+      {% capture reference %}[{{source.title}}][{{source.link}}]{% endcapture %}
+    {%- endif -%}
+    {% capture see_also %}{{see_also}}{{newline}}- {{reference}}{% endcapture %}
+  {% endfor %}
+
+  <!-- Variable for use in links -->
+  {% capture gh_base %}https://github.com/{{site.github_username}}/{{site.repository_name}}{% endcapture %}
+
+{% endcapture %}
+
+<!-- Actual page content -->
+{% capture content %}
+  {% include references.md %}
+  {{aliases}}
+
+  {{page.excerpt}}
+
+  {{page.content}}
+
+  {{notices | default: newline}}
+
+  {%- if page.optech_mentions and page.optech_mentions != '' -%}
+    ## Optech newsletter mentions
+
+    {% assign sorted_references = references | split: 'ENDENTRY' | sort | reverse %}
+    {%- for reference in sorted_references -%}
+      {%- assign current_ref_year = reference | slice: 0, 4 -%}
+      {%- if current_ref_year != last_ref_year -%}
+        {{newline}}{{newline}}**{{current_ref_year}}**
+      {%- endif -%}
+      {{newline}}{{reference | slice: 10, 9999999999 }}
+      {%- assign last_ref_year = current_ref_year -%}
+    {%- endfor -%}
+  {% endif %}{{newline}}{{newline}}
+
+  {%- if page.see_also and page.see_also != '' -%}
+    ## See also
+
+    {{see_also}}
+  {% endif %}
+
+  <br>{{newline}}{{newline}}
+<span class="float-left" markdown="1">**Previous Person:**<br>{{prev_link}}</span>
+<span class="float-right" markdown="1">**Next Person:**<br>{{next_link | default: first_link }}</span>
+
+  {:.center}
+  [Edit page]({{gh_base}}/edit/master/{{page.path}})<br>
+  [Report Issue]({{gh_base}}/issues/new?body={{'Source file: ' | append: page.path | url_escape }})
+{% endcapture %}{{ content | markdownify }}

_plugins/bidirectional_links_generator.rb

@@ -16,7 +16,7 @@ def generate(site)
       # of all the pages
       pages_with_link_syntax = all_pages.select { |page| page.content.match(/\[\[.*?\]\]/) }
       # indexed pages are the only pages that newsletters might mention
-      indexed_pages = site.collections["topics"].docs
+      indexed_pages = site.collections["topics"].docs + site.collections["people"].docs
 
       # Convert all Wiki/Roam-style double-bracket link syntax to plain HTML
       # anchor tag elements (<a>)

en/people.md

@@ -0,0 +1,48 @@
+---
+title: People
+permalink: /en/people/
+layout: page
+---
+{% capture raw_people_list %}
+{%- for person in site.people -%}
+  <!--{% include functions/sort-rename.md name=topic.title %}-->[{{person.title}}]({{person.url}})ENDTOPIC
+{%- endfor -%}
+{% endcapture %}
+
+{% assign people_list = raw_people_list | split: 'ENDTOPIC' | sort_natural %}
+{% assign number_of_people = site.people | size %}
+
+<div class="center" markdown="1">
+{{number_of_people}} people
+
+{:.center}
+{% assign previous_character = '' %}
+{% for entry in people_list %}
+  {%- assign first_character = entry | remove_first: '<!--' | truncate: 1, '' | downcase -%}{%- comment -%}close html comment for syntax hilite -->{%- endcomment -%}
+  {%- if first_character != previous_character -%}
+    {%- if previous_character != nil -%}
+      [{{first_character | upcase}}](#{{first_character}}){{' '}}
+    {%- endif -%}
+  {%- endif -%}
+  {%- assign previous_character = first_character -%}
+{% endfor %}
+</div>
+
+<div>{% comment %}<!-- enclosing in a div forces this to be interpreted
+as HTML rather than Markdown so indentation over 4 characters doesn't
+produce code blocks -->{% endcomment %}
+
+{% assign previous_character = '' %}
+{% for entry in people_list %}
+  {% assign first_character = entry | remove_first: '<!--' | truncate: 1, '' | downcase %}{%- comment -%}close html comment for syntax hilite -->{%- endcomment %}
+  {% if first_character != previous_character %}
+    {% if previous_character != '' %}</ul>{% endif %}
+    <h3 id="{{first_character}}">{{first_character | upcase}}</h3>
+    <ul>
+  {% endif %}
+  <li>{{entry | markdownify | remove: "<p>" | remove: "</p>" | strip }}</li>
+  {% assign previous_character = first_character %}
+{% endfor %}
+</ul>
+
+</div>