Label browsing: proof of concept

content/concepts/payment-system-basics/accounts/cryptographic-keys.md

@@ -2,6 +2,9 @@
 html: cryptographic-keys.html
 parent: accounts.html
 blurb: Use cryptographic keys to approve transactions so the XRP Ledger can execute them.
+labels:
+  - Smart Contracts
+  - Security
 ---
 # Cryptographic Keys
 

content/concepts/payment-system-basics/accounts/multi-signing.md

@@ -2,6 +2,9 @@
 html: multi-signing.html
 parent: accounts.html
 blurb: Use multi-signing for greater security sending transactions.
+labels:
+  - Smart Contracts
+  - Security
 ---
 # Multi-Signing
 

content/concepts/payment-types/escrow.md

@@ -2,6 +2,9 @@
 html: escrow.html
 parent: payment-types.html
 blurb: Escrows set aside XRP and deliver it later when certain conditions are met. Escrows can depend on time limits, cryptographic conditions, or both.
+labels:
+  - Escrow
+  - Smart Contracts
 ---
 # Escrow
 

content/references/protocol-reference/ledger-data/ledger-object-types/escrow.md

@@ -2,6 +2,8 @@
 html: escrow-object.html #escrow.html is taken by the concept page
 parent: ledger-object-types.html
 blurb: Contains XRP held for a conditional payment.
+labels:
+  - Escrow
 ---
 # Escrow
 [[Source]](https://github.com/ripple/rippled/blob/c6b6d82a754fe449cc533e18659df483c10a5c98/src/ripple/protocol/impl/LedgerFormats.cpp#L90-L101 "Source")

content/references/protocol-reference/transactions/transaction-types/escrowcancel.md

@@ -2,6 +2,8 @@
 html: escrowcancel.html
 parent: transaction-types.html
 blurb: Reclaim escrowed XRP.
+labels:
+  - Escrow
 ---
 # EscrowCancel
 

content/references/protocol-reference/transactions/transaction-types/escrowcreate.md

@@ -2,6 +2,8 @@
 html: escrowcreate.html
 parent: transaction-types.html
 blurb: Create an escrowed XRP payment.
+labels:
+  - Escrow
 ---
 # EscrowCreate
 

content/references/protocol-reference/transactions/transaction-types/escrowfinish.md

@@ -2,6 +2,8 @@
 html: escrowfinish.html
 parent: transaction-types.html
 blurb: Deliver escrowed XRP to recipient.
+labels:
+  - Escrow
 ---
 # EscrowFinish
 

content/tutorials/production-readiness/set-up-secure-signing.md

@@ -2,6 +2,8 @@
 html: set-up-secure-signing.html
 parent: production-readiness.html
 blurb: Set up an environment where you can submit transactions securely.
+labels:
+  - Security
 ---
 # Set Up Secure Signing
 

content/tutorials/use-specialized-payment-types/use-escrows/cancel-an-expired-escrow.md

@@ -2,6 +2,9 @@
 html: cancel-an-expired-escrow.html
 parent: use-escrows.html
 blurb: Cancel an expired escrow.
+labels:
+  - Escrow
+  - Smart Contracts
 ---
 # Cancel an Expired Escrow
 

content/tutorials/use-specialized-payment-types/use-escrows/look-up-escrows.md

@@ -2,6 +2,9 @@
 html: look-up-escrows.html
 parent: use-escrows.html
 blurb: Look up pending escrows by sender or destination address.
+labels:
+  - Escrow
+  - Smart Contracts
 ---
 # Look up escrows
 

content/tutorials/use-specialized-payment-types/use-escrows/send-a-conditionally-held-escrow.md

@@ -2,6 +2,9 @@
 html: send-a-conditionally-held-escrow.html
 parent: use-escrows.html
 blurb: Create an escrow whose release is based on a condition being fulfilled.
+labels:
+  - Escrow
+  - Smart Contracts
 ---
 # Send a Conditionally-Held Escrow
 

content/tutorials/use-specialized-payment-types/use-escrows/send-a-time-held-escrow.md

@@ -2,6 +2,9 @@
 html: send-a-time-held-escrow.html
 parent: use-escrows.html
 blurb: Create an escrow whose only condition for release is that a specific time has passed.
+labels:
+  - Escrow
+  - Smart Contracts
 ---
 # Send a Time-Held Escrow
 

content/tutorials/use-specialized-payment-types/use-escrows/use-an-escrow-as-a-smart-contract.md

@@ -2,6 +2,9 @@
 html: use-an-escrow-as-a-smart-contract.html
 parent: use-escrows.html
 blurb: Use a cryptographic escrow as a smart contract to ensure a recipient gets paid only if they successfully perform a service.
+labels:
+  - Escrow
+  - Smart Contracts
 ---
 # Use an Escrow as a Smart Contract
 

content/tutorials/use-specialized-payment-types/use-payment-channels.md

@@ -2,6 +2,9 @@
 html: use-payment-channels.html
 parent: use-specialized-payment-types.html
 blurb: Payment Channels are an advanced feature for sending "asynchronous" XRP payments that can be divided into very small increments and settled later. This tutorial walks through the entire process of using a payment channel, with examples using the JSON-RPC API of a local rippled server.
+labels:
+  - Payment Channels
+  - Smart Contracts
 ---
 # Use Payment Channels
 

dactyl-config.yml

@@ -3132,6 +3132,46 @@ pages:
         targets:
             - ja
 
+    # Landing pages for labels
+    -   name: Escrow
+        html: label-escrow.html
+        parent: by-label.html
+        landing_for: Escrow
+        template: template-landing-label.html
+        blurb: All pages relating to the Escrow feature.
+        targets:
+            - en
+            - ja
+
+    -   name: Smart Contracts
+        html: label-smart-contracts.html
+        parent: by-label.html
+        landing_for: Smart Contracts
+        template: template-landing-label.html
+        blurb: Build smart contracts using these advanced on-ledger features.
+        targets:
+            - en
+            - ja
+
+    -   name: Security
+        html: label-security.html
+        parent: by-label.html
+        landing_for: Security
+        template: template-landing-label.html
+        blurb: Protect your digital assets with powerful security.
+        targets:
+            - en
+            - ja
+
+    -   name: Topics By Label
+        html: by-label.html
+        parent: docs.html
+        template: template-all-labels.html
+        blurb: Browse by topic.
+        targets:
+            - en
+            - ja
+
 
 
 # --------------- end "Docs" section -------------------------------------------

tool/template-all-labels.html

@@ -0,0 +1,15 @@
+{% extends "template-base.html" %}
+
+{% block main %}
+  <section class="content">
+    <h1 id="main-page-header">{{ currentpage.name }}</h1>
+
+    <ul class="tag-cloud">
+    {% for page in pages %}
+      {% if page.landing_for is defined %}
+          <li><a href="{% if "//" not in page.html %}{{target.prefix}}{% endif %}{{page.html}}" class="badge badge-primary">{{page.name}}</a></li>
+      {% endif %}
+    {% endfor %}
+  </ul>
+  </section>
+{% endblock %}

tool/template-doc.html

@@ -31,6 +31,7 @@
 
 {% block right_sidebar %}
   <div id="page-toc-wrapper">
+    {% include 'template-label-list.html' %}
     <div class="toc-header">
       <h4>{% trans %}In this document{% endtrans %}</h4>
     </div>

tool/template-label-list.html

@@ -0,0 +1,20 @@
+{% if use_page is undefined %}{% set use_page = currentpage %}{% endif %}
+{% if use_page.labels %}
+<div class="labels-wrap">
+  <ul class="list-inline">
+  {% for label in use_page.labels %}
+  {% set label_landing = pages|selectattr("landing_for", "defined_and_equalto", label)|first %}
+  {% if label_landing %}
+    <li class="list-inline-item">
+      <a href="{% if "//" not in label_landing.html %}{{target.prefix}}{% endif %}{{label_landing.html}}" class="badge badge-primary">{{label}}</a>
+    </li>
+  {% else %}
+    <li class="list-inline-item">
+      <span class="badge badge-secondary">{{label}}</span>
+      <!-- TEMPLATE WARNING: no label landing found for "{{label}}" -->
+    </li>
+  {% endif %}
+  {% endfor %}
+  </ul>
+</div><!--/.labels-wrap-->
+{% endif %}

tool/template-landing-label.html

@@ -0,0 +1,24 @@
+{% extends "template-base.html" %}
+
+{% block main %}
+  <section class="content">
+    {% if content %}
+      {{ content}}
+    {% else %}
+      <h1 id="main-page-header">Label: {{ currentpage.name }}</h1>
+      {% if currentpage.blurb %}<p class="blurb">{{currentpage.blurb}}</p>{% endif %}
+    {% endif %}
+
+    <div class="curated-links">
+      <ul>
+      {% for page in pages %}
+      {% if page.labels is defined and currentpage.landing_for in page.labels %}
+        <li class="level1"><a href="{% if "//" not in page.html %}{{currentpage.prefix}}{% endif %}{{page.html}}">{{page.name}}</a>
+          <p class="blurb child-blurb">{{page.blurb}}</p>
+        </li>
+      {% endif %}
+      {% endfor %}
+      <ul>
+    </div>
+  </section>
+{% endblock %}