docs(*): customize typedoc theme

christopherthielen · christopherthielen · commit 380a844097f2 · 2015-12-30T15:15:01.000-06:00
diff --git a/Gruntfile.js b/Gruntfile.js
@@ -154,7 +154,7 @@ module.exports = function (grunt) {
 
   grunt.registerTask('docs', 'Generate documentation to _doc', function() { 
     promising(this, 
-      system('./node_modules/typedoc/bin/typedoc --readme ./README.md --name "UI-Router" --theme default --mode modules --module commonjs --target es5 --out _doc  src/params src/path src/resolve src/state src/transition src/url src/view src/ng1')
+      system('./node_modules/typedoc/bin/typedoc --readme ./README.md --name "UI-Router" --theme ./typedoctheme --mode modules --module commonjs --target es5 --out _doc  src/params src/path src/resolve src/state src/transition src/url src/view src/ng1')
     );
   });
 
diff --git a/typedoctheme/assets/css/typedoctheme.css b/typedoctheme/assets/css/typedoctheme.css
@@ -0,0 +1,24 @@
+a.tsd-anchor + h3 { display: none; }
+
+
+.tsd-panel.tsd-member {
+    padding-top: 0;
+}
+
+.tsd-panel .tsd-signature, .tsd-panel .tsd-signatures {
+    background-color: #eee;
+}
+
+.tsd-header {
+    list-style: none;
+    margin: 0 2em;
+    font-weight: bold;
+}
+
+.tsd-header p {
+    margin-top : 0;
+}
+
+.tsd-member .tsd-description .lead {
+    display: none;
+}
diff --git a/typedoctheme/layouts/default.hbs b/typedoctheme/layouts/default.hbs
@@ -8,6 +8,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1">
 
     <link rel="stylesheet" href="{{relativeURL "assets/css/main.css"}}">
+    <link rel="stylesheet" href="{{relativeURL "assets/css/typedoctheme.css"}}">
     <script src="{{relativeURL "assets/js/modernizr.js"}}"></script>
 </head>
 <body>
diff --git a/typedoctheme/partials/member.signature.body.hbs b/typedoctheme/partials/member.signature.body.hbs
@@ -1,7 +1,3 @@
-{{#unless hideSources}}
-    {{> member.sources}}
-{{/unless}}
-
 {{> comment}}
 
 {{#if typeParameters}}
@@ -53,4 +49,9 @@
             {{> parameter}}
         {{/with}}
     {{/if}}
-{{/if}}
+{{/if}}
+
+{{#unless hideSources}}
+    <hr>
+    {{> member.sources}}
+{{/unless}}
diff --git a/typedoctheme/partials/member.signatures.hbs b/typedoctheme/partials/member.signatures.hbs
@@ -1,6 +1,11 @@
 <ul class="tsd-signatures {{cssClasses}}">
     {{#each signatures}}
         <li class="tsd-signature tsd-kind-icon">{{> member.signature.title }}</li>
+        {{#if comment.shortText}}
+            <li class="tsd-header">
+                {{#markdown}} {{{comment.shortText}}} {{/markdown}}
+            </li>
+        {{/if}}
     {{/each}}
 </ul>
 
