dartdoc 0.0.2+3

  • README.md
  • Installing
  • Versions
  • --

dartdoc #

A documentation generator for Dart. This tool creates static HTML files generated from Dart source code.

Build Status Build status Coverage Status

Installing dartdoc #

Run pub global activate dartdoc to install dartdoc.

Running dartdoc #

Run dartdoc from the root directory of package. By default, the documentation is geterated to the doc/api/ directory.


What about docgen / dartdocgen / dartdoc-viewer?

This tool intends to replace our existing set of API documentation tools. We'll take the best ideas and implementations from our existing doc tools and fold them into dartdoc.

Can I help? #

Yes! Start by using the tool and filing issues and requests. If you want to contribute, check out the issue tracker and see if there's an issue that you're passionate about. If you want to add a new feature that's not yet in the issue tracker, start by opening an issue. Thanks!

What does the output look like? #

You can see the latest API of dartdoc, generated by dartdoc, here.

Generating documentation for Dart SDK #

If you want to generatr documentation for the SDK, run dartdoc with the following command line arguments:

  • --dart-sdk /pathTo/dart-sdk (optional)
  • --sdk-docs

Issues and bugs #

Please file reports on the GitHub Issue Tracker.

License #

You can view our license here.

0.0.2 #

  • documenation generated in doc/api directory
  • support for readme files in plain text
  • fixed resolving references in library comments
  • generate docs even when output directory exists
  • show inherited operators
  • visually indicate deprecated api


  • handle packages that don't have a readme
  • fixed linking to references from other libraries in comments
  • resolve [new Constructor] in comments
  • link to exported library in comment references
  • visually show library is deprecated
  • fixed one liner documentation


  • add a --package-root option
  • resource handler support for package root


  • do not drop brackets in comments
  • replace ':' in library names with '-'
  • support multiple anonymous libraries
  • show generic information for classes
  • signature of method on same line as name
  • error if command line argument is not recognized
  • fixed href for property accesssor
  • fixed generation of docs for exported libraries

Use this package as an executable

1. Install it

You can install the package from the command line:

$ pub global activate dartdoc

2. Use it

The package has the following executables:

$ dartdoc

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:

  dartdoc: ^0.0.2+3

2. Install it

You can install packages from the command line:

with pub:

$ pub get

Alternatively, your editor might support pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:dartdoc/dartdoc.dart';
Version Uploaded Documentation Archive
0.28.3+2 Apr 16, 2019 Go to the documentation of dartdoc 0.28.3+2 Download dartdoc 0.28.3+2 archive
0.28.3+1 Apr 5, 2019 Go to the documentation of dartdoc 0.28.3+1 Download dartdoc 0.28.3+1 archive
0.28.3 Apr 3, 2019 Go to the documentation of dartdoc 0.28.3 Download dartdoc 0.28.3 archive
0.28.2 Feb 14, 2019 Go to the documentation of dartdoc 0.28.2 Download dartdoc 0.28.2 archive
0.28.1+2 Feb 5, 2019 Go to the documentation of dartdoc 0.28.1+2 Download dartdoc 0.28.1+2 archive
0.28.1+1 Feb 4, 2019 Go to the documentation of dartdoc 0.28.1+1 Download dartdoc 0.28.1+1 archive
0.28.1 Feb 4, 2019 Go to the documentation of dartdoc 0.28.1 Download dartdoc 0.28.1 archive
0.28.0 Jan 14, 2019 Go to the documentation of dartdoc 0.28.0 Download dartdoc 0.28.0 archive
0.27.0 Jan 3, 2019 Go to the documentation of dartdoc 0.27.0 Download dartdoc 0.27.0 archive
0.26.1 Dec 13, 2018 Go to the documentation of dartdoc 0.26.1 Download dartdoc 0.26.1 archive

All 114 versions...

Awaiting analysis to complete.