asciidocsy-jekyll-theme 0.3.0.pre.dev

data/_includes/path-active.liquid

@@ -0,0 +1,18 @@
+{% assign page_url = page.url | append: "/" | replace:"//","/" %}
+{% assign link_url = include.href | append: "/" | replace:"//","/" %}
+{% assign page_url_array = page_url | split: "/" %}
+{% assign path_to_page_url = page_url_array | pop | join: "/" | append: "/" %}
+{% assign ancestry = page_url | slice: 0, link_url.size %}
+{% assign active = "" %}
+{% assign open   = "" %}
+{% assign parent = "" %}
+{% if include.kids %}
+  {% assign parent = "parent" %}
+{% endif %}
+{% if page_url == link_url %}
+  {% assign active = "active" %}
+  {% assign open = "open" %}
+{% elsif ancestry == link_url %}
+  {% assign open = "open" %}
+  {% assign parent = "proud-ancestor" %}
+{% endif %}

data/_includes/release-hx-change.asciidoc

@@ -0,0 +1,7 @@
+{%- assign i = include.item %}
+{%- assign i_hash_mini = i.hash | truncate: 7, "" %}
+| {% if cl_groupby == "type" %}icon:{{ parts | where:"slug",i.part | map:"icon" }}[title='{{ i.part | capitalize}}']{% else %}{{ types | where:"slug",i.type | first | map:"icon" }}[]{% endif %}
+
+| {{ i.summ }}
+
+| {sp}{% for tag in i.tags -%}{%- assign t = tags | where:"slug",tag | first %} [.cl-tag.text-{{ t.tone | default: 'primary' }}]#icon:{{ t.icon }}[title='{{ t.name }}']# {% endfor %}{% if i.note %}xref:release-note-{{ i_hash_mini }}[icon:sticky-note[] Note,role='cl-tag']{% endif %} {% if i.tick %}link:{{ site.subject_tickets_www }}/{{ i.tick }}[icon:tag[] {{ i.tick }},role='cl-tag']{% endif %} {% if i.hash %}link:{{ site.source_www }}/commit/{{ i.hash }}[icon:github[] {{ i_hash_mini }},role='cl-tag']{% endif %}{% if i.docs %}{% if i.docs.size > 1 -%}xref:release-note-{{ i_hash_mini }}{% else -%}link:{{ i.docs[0]['href'] | default: i.docs[0]['xref'] }}{% endif -%}[icon:book[] Docs,role='cl-tag']{% endif -%}

data/_includes/release-hx-changes-listing.asciidoc

@@ -0,0 +1,14 @@
+[[changelog-{{ rvsn_hash_mini }}]]
+=== Changelog
+{% for grp in cl_groups %}
+{%-  assign entries = rvsn_work | where: cl_groupby, grp.slug | sort: cl_sortby %}
+{%-  if entries.size > 0 or config.cl.empty-group == 'show' %}
+==== {{ grp.verb | default: grp.slug | capitalize }}
+[cols="1a,15a,12a",frame=none,grid=none,stripes=odd]
+|===
+{%     for item in entries %}
+{%       include release-hx-change.asciidoc item=item %}
+{%     endfor %}
+|===
+{%-  endif %}
+{% endfor %}

data/_includes/release-hx-note.asciidoc

@@ -0,0 +1,54 @@
+{%- assign note_hash_mini = item.hash | truncate: 7, "" %}
+{%- capture summary -%}
+{%-   assign note_type = types | where:"slug",item.type | first %}
+{%-   assign note_classes = "" | split: "" %}
+{%-   if item.tags %}
+{%-     assign note_classes = note_classes | concat: item.tags %}
+{%-   endif %}
+{%-   if item.cats %}
+{%-     assign note_classes = note_classes | concat: item.cats %}
+{%-   endif %}
+{%- if note_type.icon %}icon:{{ note_type.icon }}[]{% else %}{{ note_type.name | default: note_type.slug | upcase }}:{% endif %} {{ item.summ }}
+{%- endcapture -%}
+[#release-note-{{ note_hash_mini }},role="card release-note {{ note_type }}{{ note_classes | join:' ' }}"]
+--
+[discrete.note-summary.card-title,id={{ note_hash_mini }}]
+===== {{ summary }}
+
+{{ item.note }}
+
+[horizontal]
+{%- if item.docs %}
+docs::
+{% for doc in item.docs -%}
+{% if item.docs.size > 1 -%}* {% endif -%}
+{%- if doc.href -%}link:{{- doc.href | liquify -}}{% else %}xref:{{ doc.xref | liquify }}#{% endif %}[{{ doc.text | default: "Coverage of this item" | liquify }}]
+{% endfor %}
+{%- endif %}
+{%- if item.tags and sortby != "tags" %}
+tags::
+{%- for tag in item.tags %}
+{%-   assign t = tags | where:"slug",tag | first %}
+[.rn-tag.btn.btn-sm.btn-{{ t.tone | default: 'primary' }}]#icon:{{ t.icon }}[] {{ t.name | default: tag | capitalize }}#
+{%- endfor %}
+{%- endif %}
+{%- if item.cats and rn_groupby != "cats" %}
+categories:: {{ item.cats | array_to_sentence_string }}
+{%- endif %}
+{%- if item.tick %}
+{%-   if config.patterns.item.ticket-link.href %}
+{%-     assign ticket_href = config.patterns.item.ticket-link.href | liquify %}
+{%-   elsif config.patterns.both.ticket-link.href %}
+{%-     assign ticket_href = config.patterns.both.ticket-link.href | liquify %}
+{%-   endif %}
+{%-   if config.patterns.item.ticket-link.text %}
+{%-     assign ticket_text = config.patterns.item.ticket-link.text | liquify %}
+{%-   elsif config.patterns.both.ticket-link.text %}
+{%-     assign ticket_text = config.patterns.both.ticket-link.text | liquify %}
+{%-   endif %}
+ticket:: link:{{ ticket_href }}[{{ ticket_text }}]
+{%- endif %}
+{%- if item.hash %}
+commit:: link:{{ site.source_www }}/commit/{{ item.hash }}[{{ note_hash_mini }}]
+{%- endif %}
+--

data/_includes/release-hx-notes-listing.asciidoc

@@ -0,0 +1,16 @@
+[[release-notes-{{ rvsn_hash_mini }}]]
+=== Release Notes for v{{ rvsn.code }}
+{% for grp in rn_groups %}
+{%-  assign grp_name_def = grp.slug | capitalize %}
+{%-  assign notes = rvsn_work | where: rn_groupby, grp.slug | where_exp:"i","i.note != nil or i.docs.size > 1" %}
+{%-  if notes.size > 0 or config.rn.empty-group == 'show' %}
+==== {{ grp.name | default: grp_name_def | capitalize }} changes in v{{ rvsn.code }}
+{%-    if notes.size > 0 %}
+{%       for item in notes %}
+{%         include release-hx-note.asciidoc %}
+{%-      endfor %}
+{%-    else %}
+No special notes for {{ grp.name }} changes in this release.
+{%-    endif %}
+{%-  endif %}
+{% endfor %}

data/_includes/release-hx-revision.asciidoc

@@ -0,0 +1,86 @@
+{%- assign rvsn  = include.revision %}
+{%- assign code  = rvsn.code %}
+{%- assign vcode = config.patterns.revision.vcode | liquify %}
+{%- assign flags = "" | split:"," %}
+{%- assign tags_map = rvsn.work | map:"tags" %}
+{%- assign is_latest = false %}
+{%- assign download_btn_label = config.patterns.revision.download-label.standard | default: "Get v{{rvsn.code}}" %}
+{%- assign download_btn_tone  = "primary" %}
+{%- assign download_btn_go-to-latest = config.patterns.revision.download-label.go-to-latest %}
+{%- if rvsn.code == latest_release.code %}
+{%-   assign is_latest = true %}
+{%-   assign download_btn_label = config.patterns.revision.download-label.latest | default: "Get v{{rvsn.code}} -- Latest! icon:flag-checkered[]" %}
+{%-   assign download_btn_tone  = "success" %}
+{%- endif %}
+{%- for tags_array in tags_map %}
+{%-   if tags_array.size %}
+{%-     assign flags = flags | concat: tags_array | uniq %}
+{%-   endif %}
+{%- endfor %}
+{%- assign rvsn_hash_mini = rvsn.hash | truncate: 7, "" %}
+{%- assign rvsn_work = rvsn.work %}
+{%- capture memo_def %}
+Release history for v{{ rvsn.code }}.
+{%- endcapture %}
+{%- if include.merge %}
+{%-   assign patch_rvsns = "" | split:"," %}
+{%-   for patch in include.merge %}
+{%-     assign v_code = patch.code | prepend: "v" | split:"," %}
+{%-     assign patch_rvsns = patch_rvsns | concat: v_code %}
+{%-     assign rvsn_work = rvsn_work | concat: patch.work %}
+{%-   endfor %}
+{%-   capture patch_merge_memo %}
+Changes made in patch revisions to previous minor/major release{% if patch_vrsns.size > 1 %}es{% endif %} (*{{ patch_rvsns | array_to_sentence_string }}*) are incorporated here for convenience.
+{%-   endcapture %}
+{%- endif %}
+
+== {{ config.patterns.revision.heading | liquify }}
+
+[center.text-center]
+--
+[big]#link:{{ config.patterns.revision.download-url | liquify }}[icon:download[] {{ download_btn_label | liquify }},role="btn btn-{{download_btn_tone}} btn-download"]#
+{% unless is_latest -%}
+[big]#xref:#release-{{ latest_release.code }}[{{ download_btn_go-to-latest | liquify }},role="btn btn-success btn-download"]#
+{% endunless %}
+--
+
+[NOTE]
+====
+{{ rvsn.memo | default: memo_def | liquify }}
+====
+{% if patch_merge_memo %}
+[NOTE]
+====
+{{ patch_merge_memo }}
+====
+{% endif %}
+{% if flags[0] %}
+[WARNING]
+====
+{{ config.patterns.revision.admonition | liquify }}
+{% for flag in flags %}
+{%-   assign t = tags | where:"slug",flag | first %}
+[.rn-tag.btn.btn-sm.btn-{{ t.tone | default: 'primary' }}]#icon:{{ t.icon }}[{{ t.name | default: tag | capitalize }}] {{ t.name | default: tag | capitalize }}#
+{%- endfor %}
+====
+{% endif %}
+
+{%- assign count = 0 %}
+{% for log in log-order %}
+{%-  if log-order.size > 1 %}
+[.skip-link]
+--
+{%-    if count == 0 %}
+{%-      assign count = count | plus: 1 %}
+xref:{{log-order[1]}}-{{rvsn_hash_mini}}[icon:fast-forward[] Skip to] <<{{log-order[1]}}-{{rvsn_hash_mini}}>>
+{%-    else %}
+xref:{{log-order[0]}}-{{rvsn_hash_mini}}[icon:fast-backward[] Back to] <<{{log-order[0]}}-{{rvsn_hash_mini}}>>
+{%-    endif %}
+--
+{%-  endif %}
+{%-  if log == "release-notes" %}
+{%     include release-hx-notes-listing.asciidoc %}
+{%-  elsif log == "changelog" %}
+{%     include release-hx-changes-listing.asciidoc %}
+{%-  endif %}
+{% endfor %}

data/_includes/release-hx.asciidoc

@@ -0,0 +1,57 @@
+{%- assign config     = site.data.theme.release-hx %}
+{%- assign hx         = include.history    | default: site.data.releases %}
+{%- assign cats       = include.categories | default: config.cats %}
+{%- assign parts      = include.parts      | default: config.parts %}
+{%- assign types      = include.types      | default: config.types %}
+{%- assign tags       = include.tags       | default: config.tags %}
+{%- assign roles      = include.roles      | default: config.roles %}
+{%- assign rn_groupby = include.rn_groupby | default: 'part' %}
+{%- assign rn_sortby  = include.rn_sortby  | default: 'type' %}
+{%- assign cl_groupby = include.cl_groupby | default: 'type' %}
+{%- assign cl_sortby  = include.cl_sortby  | default: 'part' %}
+{%- assign log-order  = include.log-order  | default: "release-notes,changelog" | split: "," %}
+{%- assign patches       = include.patches | default: "nested" %}
+{%- assign rn_groupsby   = rn_groupby | append: "s" %}
+{%- assign cl_groupsby   = cl_groupby | append: "s" %}
+{%- assign rn_groups_def = config[rn_groupsby] %}
+{%- assign cl_groups_def = config[cl_groupsby] %}
+{%- assign rn_groups     = include.groups | default: rn_groups_def %}
+{%- assign cl_groups     = include.groups | default: cl_groups_def %}
+{%- assign patch_pol     = include.patch_policy | default: config.policy.patches | default: "flatten" %}
+{% for revision in hx.revisions %}
+{%-  assign loose_patches = false %}
+{%-  assign merge_patches = false %}
+{%-  assign next_rvsn = forloop.index %}
+// CHECK FOR LOOSE PATCHES TO THE LATEST VERSION
+{%-  if patch_pol == "merge" and forloop.index == 1 %}
+{%-    assign patches = hx.revisions[0]['patches'] %}
+{%-    if patches %}
+{%-      assign loose_patches = true %}
+{%-    endif %}
+{%-  elsif patch_pol == "flatten" %}
+{%-    assign patches = revision['patches'] %}
+{%-  endif %}
+// IF THERE ARE PATCHES AT THE TOP OF THE LISTING...
+{%-  if patch_pol == "flatten" or loose_patches %}
+{%-    assign parent_idx = forloop.index %}
+{%-    assign latest_patch = nil %}
+{%     for patch_rvsn in patches %}
+{%-      if forloop.index == 1 and parent_idx == 1 %}
+{%-        assign latest_patch = patch_rvsn %}
+{%-        assign latest_release = latest_patch %}
+{%-      endif %}
+{%       include release-hx-revision.asciidoc revision=patch_rvsn %}
+{%     endfor %}
+{%     include release-hx-revision.asciidoc revision=revision %}
+{%-  else %}
+{%-    if forloop.index == 1 %}
+{%-      assign latest_release = revision %}
+{%-    endif %}
+{%-    if patch_pol == "merge" and hx.revisions[next_rvsn]['patches'] %}
+{%-      assign patches = hx.revisions[next_rvsn]['patches'] %}
+{%       include release-hx-revision.asciidoc revision=revision merge=patches %}
+{%-    else %}
+{%       include release-hx-revision.asciidoc revision=revision %}
+{%-    endif %}
+{%-  endif %}
+{% endfor %}

data/_includes/scripts.html

@@ -0,0 +1,8 @@
+{% assign spot_scripts = all_scripts[include.spot] | where_exp:"s","page_scripts contains s.slug" %}
+{% for script in spot_scripts %}
+{%   assign script_href = script.href %}
+{%   unless script_href contains "http" %}
+{%     assign script_href = script_href | prepend: scripts_url %}
+{%   endunless %}
+<script src="{{ script_href }}" integrity="{{ script.meta.integrity }}" crossorigin="anonymous"></script>
+{% endfor %}

data/_includes/search-form.html

@@ -0,0 +1,113 @@
+{% assign search_name = include.search %}
+{% assign searchname = include.search | replace:"-","" %}
+{% assign config = site.data.theme.search[searchname] %}
+{% assign id = config.meta.id | default: search_name %}
+{% include hook.liquid template="search-form_html" spot="head" %}
+{% capture algolia_link %}<div class="algolia-credit"><a href="https://www.algolia.com"><img src="{{ images_url }}/search-by-algolia-light-background.svg"></div>{% endcapture %}
+<script>
+var hrefChanged = false;
+</script>
+<div class="aa-input-container" id="aa-input-container">
+  <span class="algolia-autocomplete">
+    <input id="{{ id }}" type="search" class="aa-input-search aa-hint" autocomplete="off" readonly="" aria-hidden="true" spellcheck="false" tabindex="-1"/>
+    <input type="search" id="aa-{{ id }}-input" class="aa-input-search aa-input" placeholder="{{ config.show.text | default: 'Search for keywords…' }}" name="search" autocomplete="off" spellcheck="false" role="combobox" aria-autocomplete="both" aria-expanded="false" aria-owns="algolia-autocomplete-listbox-0" dir="auto"/>
+    <pre aria-hidden="true" style="position: absolute; visibility: hidden; white-space: pre; font-family: &quot;Open Sans&quot;, Arial, &quot;sans serif&quot;; font-size: 13px; font-style: normal; font-variant: normal; font-weight: 400; word-spacing: 0px; letter-spacing: normal; text-indent: 0px; text-rendering: optimizelegibility; text-transform: none;"/>
+    </pre>
+    <span class="aa-dropdown-menu" role="listbox" id="algolia-autocomplete-listbox-0"/>
+      <div class="aa-dataset-1"></div>
+    </span>
+  </span>
+  <svg class="aa-input-icon" viewBox="654 -372 1664 1664">
+    <path d="M1806,332c0-123.3-43.8-228.8-131.5-316.5C1586.8-72.2,1481.3-116,1358-116s-228.8,43.8-316.5,131.5  C953.8,103.2,910,208.7,910,332s43.8,228.8,131.5,316.5C1129.2,736.2,1234.7,780,1358,780s228.8-43.8,316.5-131.5  C1762.2,560.8,1806,455.3,1806,332z M2318,1164c0,34.7-12.7,64.7-38,90s-55.3,38-90,38c-36,0-66-12.7-90-38l-343-342  c-119.3,82.7-252.3,124-399,124c-95.3,0-186.5-18.5-273.5-55.5s-162-87-225-150s-113-138-150-225S654,427.3,654,332  s18.5-186.5,55.5-273.5s87-162,150-225s138-113,225-150S1262.7-372,1358-372s186.5,18.5,273.5,55.5s162,87,225,150s113,138,150,225  S2062,236.7,2062,332c0,146.7-41.3,279.7-124,399l343,343C2305.7,1098.7,2318,1128.7,2318,1164z"></path>
+  </svg>
+</div>
+<!-- Initialize autocomplete menu -->
+<script>
+$( "#aa-{{ search_name }}-input" ).keydown(function(e) {
+  e = e || window.event;
+  if (!hrefChanged && (e.keyCode || e.which) == 13) {
+    // Enter key pressed
+    window.location.href = "/docs/search.html?q=" + $( "#aa-{{ id }}-input" ).val().replace(' ', '+');
+  }
+});
+
+var client = algoliasearch('{{ site.algolia.application_id }}', '{{ site.algolia.search_only_api_key }}');
+var index = client.initIndex('{{ config.meta.index }}');
+// Initialize autocomplete on search input (ID selector must match).
+autocomplete('#aa-{{ id }}-input',
+{ hint: true, autoselect: false }, {
+    source: autocomplete.sources.hits(index, {hitsPerPage: 5, typoTolerance: 'false', advancedSyntax: 'true'}),
+    // Value to be displayed in input control after user's suggestion selection.
+    displayKey: function(suggestion) {
+      var titleValue;
+      if (suggestion.title) {
+        titleValue = suggestion.title;
+      } else {
+        var idx = suggestion.slug.lastIndexOf("_");
+        titleValue = suggestion.slug.substring(idx + 1).replace(/-/g, " ");
+        titleValue = titleValue.charAt(0).toUpperCase() + titleValue.slice(1);
+      }
+
+      return titleValue;
+    },
+    // Hash of templates used when rendering dataset.
+    templates: {
+      empty: function(suggestion) {
+        // Add the see more results option when no suggestion is found...
+        // just in case the user prefers to search in the main search page.
+        var hrefValue = "/search?q=" + document.getElementById('aa-{{ id }}-input').value.replace(' ', '+');
+        return '<div class="aa-suggestion" role="option"><a id="show-more-link" class="suggestion-link" href="' + hrefValue + '">See more results...</a></div>{{ algolia_link }}';
+      },
+      footer: function(suggestion) {
+        // If no result is returned, don't add the show more results option
+        // cause it is added in the empty callback.
+        if (suggestion.isEmpty){
+          return;
+        }
+        var hrefValue = "/search?q=" + document.getElementById('aa-{{ id }}-input').value.replace(' ', '+');
+        return '<div class="aa-suggestion" role="option"><a id="show-more-link" class="suggestion-link" href="' + hrefValue + '">See more results...</a></div>{{ algolia_link }}';
+      },
+      // 'suggestion' templating function used to render a single suggestion.
+      suggestion: function(suggestion) {
+        // Only preview the first 200 characters of the page.
+        var contentValue = "";
+        if (suggestion._highlightResult.content) {
+          contentValue = suggestion._highlightResult.content.value
+          if (suggestion._highlightResult.content.value.length > 200) {
+            contentValue = suggestion._highlightResult.content.value.slice(0, 200) + '...'
+          }
+        }
+
+        // Add a title based on the link to the pages that don't have
+        // a title. The title will get the link's last underscore and
+        // then get the following words... usually that is the name of the page.
+        var titleValue;
+        if (suggestion.title) {
+          titleValue = suggestion.title;
+        } else {
+          var idx = suggestion.slug.lastIndexOf("_");
+          titleValue = suggestion.slug.substring(idx + 1).replace(/-/g, " ");
+          titleValue = titleValue.charAt(0).toUpperCase() + titleValue.slice(1);
+        }
+
+        // Define target link.
+        var linkValue = window.location.href.substring(0, window.location.href.indexOf('{{site.base_url}}') - 1) + suggestion.url;
+
+        return '<a class="suggestion-link" href="' + linkValue + '"><span>' + titleValue + '</span><span>' +
+          contentValue + '</span></a>';
+      }
+    }
+}).on('autocomplete:selected', function(event, suggestion, dataset) {
+  if (event._args.length > 0) {
+    var linkValue;
+    if (suggestion) {
+      linkValue = window.location.href.substring(0, window.location.href.indexOf('{{site.base_url}}') - 1) + suggestion.url;
+    } else {
+      // Show more results.
+      linkValue = "search.html?q=" + document.getElementById('aa-{{ id }}-input').value.replace(' ', '+');
+    }
+    window.location.href = linkValue;
+    hrefChanged = true;
+  }
+});
+</script>

data/_includes/see-also.html

@@ -0,0 +1,17 @@
+{% assign see-also_title = site.data.strings.see-also.title | default: "Related Topics" %}
+{% assign related = "" | split: "," %}
+{% for tag in page.tags %}
+  {% assign related = related | concat: site.pages | where_exp: "p","p.tags contains tag" | where_exp: "p","p.url != page.url" %}
+{% endfor %}
+{% include hook.liquid template="see-also_html" spot="mid" %}
+{% if related.size > 0 %}
+<div class="jumbotron col-4-sm">
+  <i class="icon fa fa-caret-square-o-down fa-4x float-right" style="margin-top: .5em;"></i>
+  <div class="h5">{{ see-also_title }}</div>
+  <ul class="card-text mb-auto list-unstyled">
+  {% for topic in related %}
+    <li><a href="{{ topic.url }}">{{ topic.title }}</a></li>
+  {% endfor %}
+  </ul>
+</div>
+{% endif %}

data/_includes/social-links.html

@@ -0,0 +1,10 @@
+{% assign list-class = include.list-type | default: "list" %}
+<ul class="social-links {{ list-class }} mb-0">
+  {% for link in site.data.social.apps %}
+  <li class="list-inline-item mx-2 h3" data-toggle="tooltip" data-placement="top" title="" aria-label="{{ link.name }}" data-original-title="{{ link.name }}">
+    <a class="text-white" target="_blank" href="{{ link.href }}">
+      <i class="icon {{ link.icon }}"></i>
+    </a>
+  </li>
+  {% endfor %}
+</ul>

data/_includes/string-eval.liquid

@@ -0,0 +1,38 @@
+{% comment %}
+Evaluates a string and returns the valid data object the string is pointing to.
+Used when all we have is a dot-delimited data object route like site.data.theme
+ instead of the object itself.
+{% endcomment %}
+{%- assign data_obj = "" | split: "," %}
+{%- assign route = include.string | split: "." %}
+{%- assign tier1 = route[1] %}
+{%- assign tier2 = route[2] %}
+{%- assign tier3 = route[3] %}
+{%- assign tier4 = route[4] %}
+{%- assign tier5 = route[5] %}
+{%- assign tier6 = route[6] %}
+{%- assign tier7 = route[7] %}
+{%- assign tier8 = route[8] %}
+{%- assign tier9 = route[9] %}
+{%- assign tier10 = route[10] %}
+{%- if tier10 %}
+  {%- assign data_obj = site[tier1][tier2][tier3][tier4][tier5][tier6][tier7][tier8][tier9][tier10] %}
+{%- elsif tier9 %}
+  {%- assign data_obj = site[tier1][tier2][tier3][tier4][tier5][tier6][tier7][tier8][tier9] %}
+{%- elsif tier8 %}
+  {%- assign data_obj = site[tier1][tier2][tier3][tier4][tier5][tier6][tier7][tier8] %}
+{%- elsif tier7 %}
+  {%- assign data_obj = site[tier1][tier2][tier3][tier4][tier5][tier6][tier7] %}
+{%- elsif tier6 %}
+  {%- assign data_obj = site[tier1][tier2][tier3][tier4][tier5][tier6] %}
+{%- elsif tier5 %}
+  {%- assign data_obj = site[tier1][tier2][tier3][tier4][tier5] %}
+{%- elsif tier4 %}
+  {%- assign data_obj = site[tier1][tier2][tier3][tier4] %}
+{%- elsif tier3 %}
+  {%- assign data_obj = site[tier1][tier2][tier3] %}
+{%- elsif tier2 %}
+  {%- assign data_obj = site[tier1][tier2] %}
+{%- elsif tier1 %}
+  {%- assign data_obj = site[tier1] %}
+{%- endif %}

data/_includes/tail.html

@@ -0,0 +1,7 @@
+{% include hook.liquid template="tail_html" spot="head" %}
+{% include scripts.html spot="tail" %}
+<script>
+// invoke anchor.js
+anchors.add('{{ site.data.theme.navigation.anchors.show.list | default: "h2,h3,h4,h5" }}');
+</script>
+{% include hook.liquid template="tail_html" spot="tail" %}

data/_includes/theme-api-object-sub.asciidoc

@@ -0,0 +1,4 @@
+{% for prop in include.sub %}
+[horizontal]
+{{ prop[0] }}:: `{{ prop[1] }}`
+{% endfor %}

data/_includes/theme-api-object.asciidoc

@@ -0,0 +1,35 @@
+{%- comment -%}
+////
+Generates a reference table for documenting an API object.
+////
+{%- endcomment %}
+{% assign obj = include.obj[1] %}
+{% assign name_inferred = include.obj[0] | replace:"-"," " | capitalize  %}
+[cols="1,3",role="api-ref"]
+|===
+2+| [.big]*{{ obj['$doc']['name'] | default: name_inferred }}*{% if obj['$doc'] %}{% if obj['$doc']['desc'] %} +
+{{ obj['$doc']['desc'] }}
+  {% endif %}
+
+  {% if obj['$doc']['tips'] %}
+s|TIPS:
+a|
+    {% for tip in obj['$doc']['tips'] %}
+* {{ tip }}
+    {% endfor %}
+  {% endif %}
+{% endif %}
+{% for prop in obj %}
+  {% unless prop[0] == "$doc" %}
+    {% assign prop_name = prop[0] %}
+s| block: `{{ prop_name }}`
+    {% if prop[1] %}
+a|
+{% assign prop_obj = prop[1] %}
+{% include theme-api-object-sub.asciidoc sub=prop_obj %}
+    {% else %}
+m| {{ prop[1] }}
+    {% endif %}
+  {% endunless %}
+{% endfor %}
+|===