Update the styles for the analysis server specification.

pkg/analysis_server/tool/spec/to_html.dart

 // Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 /**
  * Code for displaying the API as HTML.  This is used both for generating a
  * full description of the API as a web page, and for generating doc comments
  * in generated code.
  */
 library to.html;
 
 import 'dart:convert';
 
 import 'package:analyzer/src/codegen/html.dart';
 import 'package:analyzer/src/codegen/tools.dart';
 import 'package:html/dom.dart' as dom;
 
 import 'api.dart';
 import 'from_html.dart';
 
 /**
  * Embedded stylesheet
  */
 final String stylesheet = '''
 body {
-  font-family: sans-serif, serif;
-  padding-left: 5%;
-  padding-right: 5%;
+  font-family: 'Roboto', sans-serif;
+  max-width: 800px;
+  margin: 0 auto;
+  padding: 0 16px;
+  font-size: 16px;
+  line-height: 1.5;
+  color: #111;
+  background-color: #fdfdfd;
+  font-weight: 300;
+  -webkit-font-smoothing: auto;
 }
+
 h1 {
   text-align: center;
 }
+
+h2, h3, h4, h5 {
+  margin-bottom: 0;
+}
+
 h2.domain {
-  border-bottom: 3px solid rgb(160, 160, 160);
+  border-bottom: 1px solid rgb(200, 200, 200);
+  margin-bottom: 0.5em;
 }
+
+h4 {
+  font-size: 18px;
+}
+
+h5 {
+  font-size: 16px;
+}
+
+p {
+  margin-top: 0;
+}
+
 pre {
-  margin: 0px;
+  margin: 0;
+  font-family: 'Source Code Pro', monospace;
+  font-size: 15px;
 }
+
 div.box {
-  border: 1px solid rgb(0, 0, 0);
-  background-color: rgb(207, 226, 243);
-  padding: 0.5em;
+  background-color: rgb(240, 245, 240);
+  border-radius: 4px;
+  padding: 4px 12px;
+  margin: 16px 0;
 }
+
 div.hangingIndent {
   padding-left: 3em;
   text-indent: -3em;
 }
+
+dl dt {
+  font-weight: bold;
+}
+
+dl dd {
+  margin-left: 16px;
+}
+
 dt {
   margin-top: 1em;
-  margin-bottom: 1em;
 }
+
 dt.notification {
   font-weight: bold;
 }
+
 dt.refactoring {
   font-weight: bold;
 }
+
 dt.request {
   font-weight: bold;
 }
+
 dt.typeDefinition {
   font-weight: bold;
 }
 
-*/
-* Styles for index
-*/
+a {
+  text-decoration: none;
+}
+
+a:focus, a:hover {
+  text-decoration: underline;
+}
+
+/* Styles for index */
 
 .subindex {
 }
 
 .subindex ul {
-  padding-left: 0px;
-  margin-left: 0px;
+  padding-left: 0;
+  margin-left: 0;
 
-  -webkit-margin-before: 0px;
-  -webkit-margin-start: 0px;
-  -webkit-padding-start: 0px;
+  -webkit-margin-before: 0;
+  -webkit-margin-start: 0;
+  -webkit-padding-start: 0;
 
   list-style-type: none;
 }
 '''
     .trim();
 
 final GeneratedFile target =
     new GeneratedFile('doc/api.html', (String pkgPath) {
   ToHtmlVisitor visitor = new ToHtmlVisitor(readApi(pkgPath));
   dom.Document document = new dom.Document();
@@ skipping 260 matching lines @@
           translateHtml(node, squashParagraphs: squashParagraphs);
           continue;
         }
         switch (node.localName) {
           case 'domain':
             visitDomain(apiMappings.domains[node]);
             break;
           case 'head':
             head(() {
               translateHtml(node, squashParagraphs: squashParagraphs);
+              element('link', {
+                'rel': 'stylesheet',
+                'href': 'https://fonts.googleapis.com/css?family=Source+Code+Pro|Roboto:500,400italic,300,400',
+                'type': 'text/css'
+                });
               element('style', {}, () {
                 writeln(stylesheet);
               });
             });
             break;
           case 'refactorings':
             visitRefactorings(api.refactorings);
             break;
           case 'types':
             visitTypes(api.types);
@@ skipping 29 matching lines @@
     });
   }
 
   @override
   void visitDomain(Domain domain) {
     if (domain.experimental) {
       return;
     }
     h2('domain', () {
       anchor('domain_${domain.name}', () {
-        write('Domain: ${domain.name}');
+        write('${domain.name} domain');
       });
     });
     translateHtml(domain.html);
     if (domain.requests.isNotEmpty) {
       h3(() {
         write('Requests');
       });
       dl(() {
         domain.requests.forEach(visitRequest);
       });
@@ skipping 19 matching lines @@
         write('#');
       });
       write(')');
     });
     dd(() {
       box(() {
         showType(
             'notification', notification.notificationType, notification.params);
       });
       translateHtml(notification.html);
-      describePayload(notification.params, 'Parameters');
+      describePayload(notification.params, 'parameters:');
     });
   }
 
   @override
   visitRefactoring(Refactoring refactoring) {
     dt('refactoring', () {
       write(refactoring.kind);
     });
     dd(() {
       translateHtml(refactoring.html);
-      describePayload(refactoring.feedback, 'Feedback', force: true);
-      describePayload(refactoring.options, 'Options', force: true);
+      describePayload(refactoring.feedback, 'Feedback:', force: true);
+      describePayload(refactoring.options, 'Options:', force: true);
     });
   }
 
   @override
   void visitRefactorings(Refactorings refactorings) {
     translateHtml(refactorings.html);
     dl(() {
       super.visitRefactorings(refactorings);
     });
   }
@@ skipping 10 matching lines @@
       });
       write(')');
     });
     dd(() {
       box(() {
         showType('request', request.requestType, request.params);
         br();
         showType('response', request.responseType, request.result);
       });
       translateHtml(request.html);
-      describePayload(request.params, 'Parameters');
-      describePayload(request.result, 'Returns');
+      describePayload(request.params, 'parameters:');
+      describePayload(request.result, 'returns:');
     });
   }
 
   @override
   void visitTypeDefinition(TypeDefinition typeDefinition) {
     if (typeDefinition.experimental) {
       return;
     }
     dt('typeDefinition', () {
       anchor('type_${typeDefinition.name}', () {
@@ skipping 51 matching lines @@
   void visitTypeObject(TypeObject typeObject) {
     dl(() {
       super.visitTypeObject(typeObject);
     });
   }
 
   @override
   void visitTypeObjectField(TypeObjectField typeObjectField) {
     dt('field', () {
       b(() {
-        i(() {
-          write(typeObjectField.name);
-          if (typeObjectField.value != null) {
-            write(' = ${JSON.encode(typeObjectField.value)}');
-          } else {
-            write(' ( ');
-            if (typeObjectField.optional) {
-              gray(() {
-                write('optional');
-              });
-              write(' ');
-            }
-            TypeVisitor typeVisitor = new TypeVisitor(api, short: true);
-            addAll(typeVisitor.collectHtml(() {
-              typeVisitor.visitTypeDecl(typeObjectField.type);
-            }));
-            write(' )');
+        write(typeObjectField.name);
+        if (typeObjectField.value != null) {
+          write(' = ${JSON.encode(typeObjectField.value)}');
+        } else {
+          write(' (');
+          if (typeObjectField.optional) {
+            gray(() {
+              write('optional');
+            });
+            write(' ');
           }
-        });
+          TypeVisitor typeVisitor = new TypeVisitor(api, short: true);
+          addAll(typeVisitor.collectHtml(() {
+            typeVisitor.visitTypeDecl(typeObjectField.type);
+          }));
+          write(')');
+        }
       });
     });
     dd(() {
       translateHtml(typeObjectField.html);
     });
   }
 
   @override
   void visitTypeReference(TypeReference typeReference) {}
 
@@ skipping 116 matching lines @@
     bool verticalBarNeeded = false;
     for (TypeDecl choice in typeUnion.choices) {
       if (verticalBarNeeded) {
         write(' | ');
       }
       visitTypeDecl(choice);
       verticalBarNeeded = true;
     }
   }
 }