From 906d700ccd1aedf262b8a29b88203c614c105805 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Minh=20Nguy=E1=BB=85n?= <mxn@1ec5.org>
Date: Tue, 20 Dec 2016 17:32:06 -0800
Subject: [PATCH] [ios, macos] Indicate protocols, abstract classes in
 documentation navigation (#7478)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* [ios, macos] Italicize protocols, abstract classes in doc nav

Italicize protocols and abstract classes in the generated documentation’s navigation sidebar.

* [ios, macos] Denote protocols, abstract classes with glosses

Instead of oblique text, use a parenthetical gloss to denote a protocol or abstract class.
---
 .../docs/theme/assets/css/jazzy.css.scss      | 25 +++++++++++++++++++
 .../darwin/docs/theme/templates/nav.mustache  |  2 +-
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/platform/darwin/docs/theme/assets/css/jazzy.css.scss b/platform/darwin/docs/theme/assets/css/jazzy.css.scss
index 9c1f34714..6b4dffc87 100644
--- a/platform/darwin/docs/theme/assets/css/jazzy.css.scss
+++ b/platform/darwin/docs/theme/assets/css/jazzy.css.scss
@@ -51,6 +51,7 @@ $navigation_bg_color: #fbfbfb;
 $navigation_task_color: $link_color;
 
 $section_name_color: $color_darkblue;
+$navigation_gloss_color: #999;
 
 // ----- Content
 
@@ -367,6 +368,30 @@ pre code {
   color: $navigation_task_color;
 }
 
+%nav-group-task-gloss {
+  color: $navigation_gloss_color;
+  font-size: 90%;
+  margin-left: 0.5em;
+}
+
+.nav-group-task[data-url^="Protocols/"] > .nav-group-task-link::after {
+  @extend %nav-group-task-gloss;
+  content: "(Protocol)";
+}
+
+.nav-group-task[data-name="MGLForegroundStyleLayer"],
+.nav-group-task[data-name="MGLMultiPoint"],
+.nav-group-task[data-name="MGLShape"],
+.nav-group-task[data-name="MGLSource"],
+.nav-group-task[data-name="MGLStyleLayer"],
+.nav-group-task[data-name="MGLTileSource"],
+.nav-group-task[data-name="MGLVectorStyleLayer"] {
+  .nav-group-task-link::after {
+    @extend %nav-group-task-gloss;
+    content: "(Abstract Class)";
+  }
+}
+
 .nav-group-name > .small-heading,
 .nav-group-task-link {
   display: block;
diff --git a/platform/darwin/docs/theme/templates/nav.mustache b/platform/darwin/docs/theme/templates/nav.mustache
index 7584f4965..bfbd8e7d7 100644
--- a/platform/darwin/docs/theme/templates/nav.mustache
+++ b/platform/darwin/docs/theme/templates/nav.mustache
@@ -5,7 +5,7 @@
       <a class="small-heading" href="{{path_to_root}}{{section}}.html">{{section}}<span class="anchor-icon" /></a>
       <ul class="nav-group-tasks">
         {{#children}}
-        <li class="nav-group-task" data-name="{{name}}">
+        <li class="nav-group-task" data-name="{{name}}" data-url="{{url}}">
           <a title="{{name}}" class="nav-group-task-link" href="{{path_to_root}}{{url}}">{{name}}</a>
         </li>
         {{/children}}