add disqus comments

utils/apidoc/apidoc.dart

 // Copyright (c) 2012, 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.
 
 /**
  * This generates the reference documentation for the core libraries that come
  * with dart. It is built on top of dartdoc, which is a general-purpose library
  * for generating docs from any Dart code. This library extends that to include
  * additional information and styling specific to our standard library.
  *
@@ skipping 10 matching lines @@
 #import('../../frog/file_system.dart');
 #import('../../lib/dartdoc/dartdoc.dart', prefix: 'doc');
 
 HtmlDiff _diff;
 
 final GET_PREFIX = 'get:';
 
 void main() {
   final args = new Options().arguments;
 
+  int mode = doc.Dartdoc.MODE_STATIC;
   var outputDir = 'docs';
 
   // Use the output directory if provided.
+/*
   if (args.length > 1) {
     print('Usage: apidoc [--out=<output directory>]');
     return;
   } else if (args.length == 1) {
     final arg = args[0];
     if (arg.startsWith('--out=')) {
       outputDir = arg.substring('--out='.length);
     } else {
       print('Unknown option: $arg');
       return;
     }
   }
+  */
+
+  for (int i = 0; i < args.length - 1; i++) {
+    final arg = args[i];
+
+    switch (arg) {
+      case '--mode=static':
+        mode = doc.Dartdoc.MODE_STATIC;
+        break;
+
+      case '--mode=live-nav':
+        mode = doc.Dartdoc.MODE_LIVE_NAV;
+        break;
+
+      default:
+        if (arg.startsWith('--out=')) {
+          outputDir = arg.substring('--out='.length);
+        } else {
+          print('Unknown option: $arg');
+          return;
+        }
+        break;
+    }
+  }
 
   final frogPath = joinPaths(doc.scriptDir, '../../frog/');
+  final compilerPath = joinPaths(frogPath, 'minfrog');
+  final libDir = joinPaths(frogPath, 'lib');
 
   doc.cleanOutputDirectory(outputDir);
 
   // Compile the client-side code to JS.
   // TODO(bob): Right path.
-  doc.compileScript(frogPath,
-      '${doc.scriptDir}/../../lib/dartdoc/client-live-nav.dart',
-      '${outputDir}/client-live-nav.js');
+
+  final clientScript = (mode == doc.Dartdoc.MODE_STATIC) ? 'static' : 'live-nav';

[Bob Nystrom, 2012/03/28 20:01:21]

Long line.

[sethladd, 2012/03/28 21:52:17]

Done.

+  doc.compileScript(compilerPath, libDir,
+      '${doc.scriptDir}/../../lib/dartdoc/client-$clientScript.dart',
+      '${outputDir}/client-$clientScript.js');
 
   // TODO(rnystrom): Use platform-specific path separator.
   // The basic dartdoc-provided static content.
   doc.copyFiles('${doc.scriptDir}/../../lib/dartdoc/static', outputDir);
 
   // The apidoc-specific static content.
   doc.copyFiles('${doc.scriptDir}/static', outputDir);
 
   var files = new VMFileSystem();
   parseOptions(frogPath, ['', '', '--libdir=$frogPath/lib'], files);
@@ skipping 15 matching lines @@
   world.getOrAddLibrary('dart:dom');
   world.getOrAddLibrary('dart:html');
   world.getOrAddLibrary('dart:io');
   world.getOrAddLibrary('dart:isolate');
   world.getOrAddLibrary('dart:uri');
   world.getOrAddLibrary('dart:utf');
   world.process();
 
   print('Generating docs...');
   final apidoc = new Apidoc(mdn, outputDir);
+  if (mode != null) apidoc.mode = mode;

[Bob Nystrom, 2012/03/28 20:01:21]

Sicne we pass in the output directory, how about passing in the mode too? Also,
the null check isn't needed since it's always initialized.

[sethladd, 2012/03/29 00:15:28]

Done.

   apidoc.document();
 }
 
 class Apidoc extends doc.Dartdoc {
   /** Big ball of JSON containing the scraped MDN documentation. */
   final Map mdn;
 
+  final String disqusShortname = 'dartapidocs';

[Bob Nystrom, 2012/03/28 20:01:21]

Ditch the type annotation since it's obvious from the initializer. Also, make
static?

[sethladd, 2012/03/28 21:52:17]

Done.

+
   /**
    * The URL to the page on MDN that content was pulled from for the current
    * type being documented. Will be `null` if the type doesn't use any MDN
    * content.
    */
   String mdnUrl;
 
   Apidoc(this.mdn, String outputDir) {
     this.outputDir = outputDir;
 
     mainTitle = 'Dart API Reference';
     mainUrl = 'http://dartlang.org';
 
     final note    = 'http://code.google.com/policies.html#restrictions';
     final cca     = 'http://creativecommons.org/licenses/by/3.0/';
     final bsd     = 'http://code.google.com/google_bsd_license.html';
     final tos     = 'http://www.dartlang.org/tos.html';
     final privacy = 'http://www.google.com/intl/en/privacy/privacy-policy.html';
 
     footerText =
         '''
         <p>Except as otherwise <a href="$note">noted</a>, the content of this
         page is licensed under the <a href="$cca">Creative Commons Attribution
         3.0 License</a>, and code samples are licensed under the
         <a href="$bsd">BSD License</a>.</p>
         <p><a href="$tos">Terms of Service</a> |
         <a href="$privacy">Privacy Policy</a></p>
         ''';
 
+    preFooterText =
+        '''
+        <div id="comments">
+        <div id="disqus_thread"></div>
+        <script type="text/javascript">
+            /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
+            var disqus_shortname = "$disqusShortname"; // required: replace example with your forum shortname
+
+            /* * * DON\'T EDIT BELOW THIS LINE * * */
+            (function() {
+                var dsq = document.createElement("script"); dsq.type = "text/javascript"; dsq.async = true;
+                dsq.src = "http://" + disqus_shortname + ".disqus.com/embed.js";
+                (document.getElementsByTagName("head")[0] || document.getElementsByTagName("body")[0]).appendChild(dsq);
+            })();
+        </script>
+        <noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
+        </div> <!-- #comments -->
+        ''';
+
     searchEngineId = '011220921317074318178:i4mscbaxtru';
     searchResultsUrl = 'http://www.dartlang.org/search.html';
   }
 
   void writeHeadContents(String title) {
     super.writeHeadContents(title);
 
     // Include the apidoc-specific CSS.
     // TODO(rnystrom): Use our CSS pre-processor to combine these.
     writeln(
@@ skipping 297 matching lines @@
       return
           '''
           <p class="correspond">This corresponds to $domTypesText in the
           ${a("dom.html", "dart:dom")} library.</p>
           ''';
     }
 
     return '';
   }
 }