| commit | a446a1313a5b83da1d69f9c1b63b423fa51c2287 | [log] [tgz] |
|---|---|---|
| author | Seth Ladd <sethladd@google.com> | Fri Aug 28 14:03:57 2015 -0700 |
| committer | Seth Ladd <sethladd@google.com> | Fri Aug 28 14:03:57 2015 -0700 |
| tree | b5c976806c62e7fe103138ea527a0c45697167f3 | |
| parent | 1da8b1953fa5b423dc8564ddb2311cf70f434be8 [diff] |
fix build
try workaround
Closes #878
Squashed commit of the following:
commit ebec1a187b93c284bdba6d722076d596d741ef5f
Author: Seth Ladd <sethladd@google.com>
Date: Fri Aug 28 13:43:53 2015 -0700
try workaround
commit 426e3687f2943d898b8543b252819ac93a3c4952
Author: Seth Ladd <sethladd@google.com>
Date: Fri Aug 28 13:36:10 2015 -0700
uncomment
commit 85b10fcb7b80b41983a8e6e5c6522374f53548a5
Author: Seth Ladd <sethladd@google.com>
Date: Fri Aug 28 13:30:30 2015 -0700
fix build
Use dartdoc to generate HTML documentaton for your Dart package.
Note: As of Dart 1.12-dev.5.10, dartdoc is shipped with the Dart SDK and replaces docgen and dartdoc-viewer.
If you want to contribute to the dartdoc project, see the contributor docs. This page contains information about using the dartdoc tool.
Download the Dart SDK, version 1.12-dev.5.10 or later. If not already added, add the SDK's bin directory to your PATH.
You can install the latest version of dartdoc with pub:
$ pub global activate dartdoc
Note: to ensure that this version is run when you type dartdoc on the command line, make sure that ~/.pub-cache/bin is on your PATH, and before the path to the Dart SDK.
Run dartdoc from the root directory of package. For example:
$ dartdoc Generating documentation for 'server_code_lab' into <path-to-server-code-lab>/server_code_lab/doc/api/ parsing lib/client/piratesapi.dart... parsing lib/common/messages.dart... parsing lib/common/utils.dart... parsing lib/server/piratesapi.dart... Parsed 4 files in 8.1 seconds. generating docs for library pirate.messages from messages.dart... generating docs for library pirate.server from piratesapi.dart... generating docs for library pirate.utils from utils.dart... generating docs for library server_code_lab.piratesApi.client from piratesapi.dart... Documented 4 libraries in 9.6 seconds. Success! Open file:///<path-to-server-code-lab>/server_code_lab/doc/api/index.html
By default, the documentation is generated to the doc/api directory as static HTML files.
You can view the generated docs directly from the file system, but if you want to use the search function, you must load them with an HTTP server.
An easy way to run an HTTP server locally is to use the simple_http_server package. For example:
$ pub global activate simple_http_server $ dhttpd --path doc/api
Navigate to localhost:8080 in your browser. The search function should now work.
Command-line options for dartdoc include:
The following options are used only when generating docs for Dart SDK.
Please file reports on the GitHub Issue Tracker.
Please see the dartdoc license.