OLD | NEW |
1 Dartdoc generates static HTML documentation from Dart code. | 1 Dartdoc generates static HTML documentation from Dart code. |
2 | 2 |
3 To use it, from this directory, run: | 3 To use it, from this directory, run: |
4 | 4 |
5 $ dartdoc <path to .dart file> | 5 $ dartdoc <path to .dart file> |
6 | 6 |
7 This will create a "docs" directory with the docs for your libraries. | 7 This will create a "docs" directory with the docs for your libraries. |
8 | 8 |
9 | 9 |
10 How docs are generated | 10 How docs are generated |
(...skipping 27 matching lines...) Expand all Loading... |
38 /// * And can have multiple items. | 38 /// * And can have multiple items. |
39 /// 1. You can nest lists. | 39 /// 1. You can nest lists. |
40 /// 2. Like this numbered one. | 40 /// 2. Like this numbered one. |
41 /// | 41 /// |
42 /// --- | 42 /// --- |
43 /// | 43 /// |
44 /// Three dashes, underscores, or tildes on a line by themselves create a | 44 /// Three dashes, underscores, or tildes on a line by themselves create a |
45 /// horizontal rule. | 45 /// horizontal rule. |
46 /// | 46 /// |
47 /// to.get(a.block + of.code) { | 47 /// to.get(a.block + of.code) { |
48 /// indent(it, 4.lines); | 48 /// indent(it, 4.spaces); |
49 /// like(this); | 49 /// like(this); |
50 /// } | 50 /// } |
51 /// | 51 /// |
52 /// There are a few inline styles you can apply: *emphasis*, **strong**, | 52 /// There are a few inline styles you can apply: *emphasis*, **strong**, |
53 /// and `inline code`. You can also use underscores for _emphasis_ and | 53 /// and `inline code`. You can also use underscores for _emphasis_ and |
54 /// __strong__. | 54 /// __strong__. |
55 /// | 55 /// |
56 /// An H1 header using equals on the next line | 56 /// An H1 header using equals on the next line |
57 /// ========================================== | 57 /// ========================================== |
58 /// | 58 /// |
(...skipping 16 matching lines...) Expand all Loading... |
75 is understood to be the name of some member or type that's in the scope of the | 75 is understood to be the name of some member or type that's in the scope of the |
76 member where that comment appears. Dartdoc will automatically figure out what | 76 member where that comment appears. Dartdoc will automatically figure out what |
77 the name refers to and generate an approriate link to that member or type. | 77 the name refers to and generate an approriate link to that member or type. |
78 | 78 |
79 | 79 |
80 Attribution | 80 Attribution |
81 ----------- | 81 ----------- |
82 | 82 |
83 dartdoc uses the delightful Silk icon set by Mark James. | 83 dartdoc uses the delightful Silk icon set by Mark James. |
84 http://www.famfamfam.com/lab/icons/silk/ | 84 http://www.famfamfam.com/lab/icons/silk/ |
OLD | NEW |