X-Git-Url: https://adrianiainlam.tk/git/?a=blobdiff_plain;f=generate-documentation.py;h=155393b8a32912604f4d80e0b881cc4c56af6ae4;hb=44f29e932dcbe83c1bfaebb8735579392e27a5df;hp=e06c223608c557a2407fd7d9f0fd930730cd438c;hpb=88b1e0523dbc8d0dd9186592e8b633ccb014adbe;p=dygraphs.git diff --git a/generate-documentation.py b/generate-documentation.py index e06c223..155393b 100755 --- a/generate-documentation.py +++ b/generate-documentation.py @@ -48,29 +48,114 @@ for test_file in glob.glob('tests/*.html'): if opt in docs and test_file not in docs[opt]['tests']: docs[opt]['tests'].append(test_file) +# Extract a labels list. +labels = [] +for nu, opt in docs.iteritems(): + for label in opt['labels']: + if label not in labels: + labels.append(label) + +print """ + + + Dygraphs Options Reference + + + + +""" + +print """ +\n\n' + def name(f): """Takes 'tests/demo.html' -> 'demo'""" return f.replace('tests/', '').replace('.html', '') -for opt_name in sorted(docs.keys()): - opt = docs[opt_name] - tests = opt['tests'] - if not tests: - examples_html = 'NONE' - else: - examples_html = ' '.join( - '%s' % (f, name(f)) for f in tests) - - print """ -

%(name)s
-%(desc)s
-Type: %(type)s
-Default: %(default)s

-Examples: %(examples_html)s
-
-""" % { 'name': opt_name, - 'type': opt['type'], - 'default': opt['default'], - 'desc': opt['description'], - 'examples_html': examples_html} +print """ +

+

Options Reference

+

Dygraphs tries to do a good job of displaying your data without any further configuration. But inevitably, you're going to want to tinker. Dygraphs provides a rich set of options for configuring its display and behavior.

+ +

Usage

+

You specify options in the third parameter to the dygraphs constructor: +

g = new Dygraph(div,
+                data,
+                {
+                  option1: value1,
+                  option2: value2,
+                  ...
+                });
+
+ +After you've created a Dygraph, you can change an option by calling the updateOptions method: +
g.updateOptions({
+                  new_option1: value1,
+                  new_option2: value2
+                });
+
+ +

And, without further ado, here's the complete list of options:

+""" +for label in sorted(labels): + print '

%s

\n' % (label, label) + + for opt_name in sorted(docs.keys()): + opt = docs[opt_name] + if label not in opt['labels']: continue + tests = opt['tests'] + if not tests: + examples_html = 'NONE' + else: + examples_html = ' '.join( + '
%s' % (f, name(f)) for f in tests) + + if not opt['type']: opt['type'] = '(missing)' + if not opt['default']: opt['default'] = '(missing)' + if not opt['description']: opt['description'] = '(missing)' + + print """ +

%(name)s
+ %(desc)s
+ Type: %(type)s
+ Default: %(default)s

+ Examples: %(examples_html)s
+
+ """ % { 'name': opt_name, + 'type': opt['type'], + 'default': opt['default'], + 'desc': opt['description'], + 'examples_html': examples_html} + + +print """ +

+ + +""" +# This page was super-helpful: +# http://jsbeautifier.org/