Rewrite breadcrumbs: always include a link to the pub package page.

Author: isoos

app/lib/dartdoc/customization.dart

@@ -27,7 +27,35 @@ class DartdocCustomizer {
 
   String customizeHtml(String html) {
     final doc = html_parser.parse(html);
+    final breadcrumbs = doc.body.querySelector('.breadcrumbs');
+    if (breadcrumbs != null) {
+      _addPubPackageLink(breadcrumbs);
+    }
     return doc.outerHtml;
   }
-}
 
+  void _addPubPackageLink(Element breadcrumbs) {
+    final pubPackageLink =
+        'https://pub.dartlang.org/packages/$packageName/versions/$packageVersion';
+    final pubPackageText = '$packageName package';
+    if (breadcrumbs.children.length == 1) {
+      // we are on the index page
+      final firstLink = breadcrumbs.querySelector('a');
+      firstLink.attributes['href'] = pubPackageLink;
+      firstLink.text = pubPackageText;
+    } else if (breadcrumbs.children.isNotEmpty) {
+      // we are inside
+      final firstLink = breadcrumbs.querySelector('a');
+      firstLink.text = 'documentation';
+
+      final lead = new Element.tag('li');
+      final leadLink = new Element.tag('a');
+      leadLink.attributes['href'] = pubPackageLink;
+      leadLink.text = pubPackageText;
+      lead.append(leadLink);
+
+      breadcrumbs.insertBefore(lead, breadcrumbs.firstChild);
+      breadcrumbs.insertBefore(new Text('\n    '), breadcrumbs.firstChild);
+    }
+  }
+}

app/test/dartdoc/golden/pana_0.10.2_index.out.html

@@ -20,7 +20,7 @@
 
 <header id="title">
   <ol class="breadcrumbs gt-separated dark hidden-xs">
-    <li><a href="https://github.com/dart-lang/pana">pana package</a></li>
+    <li><a href="https://pub.dartlang.org/packages/pana/versions/0.10.2">pana package</a></li>
   </ol>
   <div class="self-name">pana</div>
   <form class="search navbar-right" role="search">

app/test/dartdoc/golden/pana_0.10.2_license_file_class.out.html

@@ -22,7 +22,8 @@
 <header id="title">
   <button id="sidenav-left-toggle" type="button">&nbsp;</button>
   <ol class="breadcrumbs gt-separated dark hidden-xs">
-    <li><a href="index.html">pana</a></li>
+    <li><a href="https://pub.dartlang.org/packages/pana/versions/0.10.2">pana package</a></li>
+    <li><a href="index.html">documentation</a></li>
     <li><a href="pana/pana-library.html">pana</a></li>
     <li class="self-crumb">LicenseFile class</li>
   </ol>

app/test/dartdoc/golden/pana_0.10.2_license_file_constructor.out.html

@@ -22,7 +22,8 @@
 <header id="title">
   <button id="sidenav-left-toggle" type="button">&nbsp;</button>
   <ol class="breadcrumbs gt-separated dark hidden-xs">
-    <li><a href="index.html">pana</a></li>
+    <li><a href="https://pub.dartlang.org/packages/pana/versions/0.10.2">pana package</a></li>
+    <li><a href="index.html">documentation</a></li>
     <li><a href="pana/pana-library.html">pana</a></li>
     <li><a href="pana/LicenseFile-class.html">LicenseFile</a></li>
     <li class="self-crumb">LicenseFile constructor</li>

app/test/dartdoc/golden/pana_0.10.2_license_file_name_field.out.html

@@ -22,7 +22,8 @@
 <header id="title">
   <button id="sidenav-left-toggle" type="button">&nbsp;</button>
   <ol class="breadcrumbs gt-separated dark hidden-xs">
-    <li><a href="index.html">pana</a></li>
+    <li><a href="https://pub.dartlang.org/packages/pana/versions/0.10.2">pana package</a></li>
+    <li><a href="index.html">documentation</a></li>
     <li><a href="pana/pana-library.html">pana</a></li>
     <li><a href="pana/LicenseFile-class.html">LicenseFile</a></li>
     <li class="self-crumb">name property</li>

app/test/dartdoc/golden/pana_0.10.2_pretty_json.out.html

@@ -22,7 +22,8 @@
 <header id="title">
   <button id="sidenav-left-toggle" type="button">&nbsp;</button>
   <ol class="breadcrumbs gt-separated dark hidden-xs">
-    <li><a href="index.html">pana</a></li>
+    <li><a href="https://pub.dartlang.org/packages/pana/versions/0.10.2">pana package</a></li>
+    <li><a href="index.html">documentation</a></li>
     <li><a href="pana/pana-library.html">pana</a></li>
     <li class="self-crumb">prettyJson function</li>
   </ol>