3 # Generate docs/options.html
10 # Set this to the path to a test file to get debug output for just that test
11 # file. Can be helpful to figure out why a test is not being shown for a
13 debug_tests
= [] # [ 'tests/zoom.html' ]
15 # Pull options reference JSON out of dygraph.js
18 for line
in file('dygraph-options-reference.js'):
21 elif '</JSON>' in line
:
26 # TODO(danvk): better errors here.
30 # Go through the tests and find uses of each option.
32 docs
[opt
]['tests'] = []
34 # This is helpful for differentiating uses of options like 'width' and 'height'
35 # from appearances of identically-named options in CSS.
37 """Really primitive method to find text inside of {..} braces.
38 Doesn't work if there's an unmatched brace in a string, e.g. '{'. """
50 # Find text followed by a colon. These won't all be options, but those that
51 # have the same name as a Dygraph option probably will be.
52 prop_re
= re
.compile(r
'\b([a-zA-Z0-9]+) *:')
53 tests
= debug_tests
or glob
.glob('tests/*.html')
54 for test_file
in tests
:
55 braced_html
= find_braces(file(test_file
).read())
59 ms
= re
.findall(prop_re
, braced_html
)
61 if debug_tests
: print '\n'.join(ms
)
62 if opt
in docs
and test_file
not in docs
[opt
]['tests']:
63 docs
[opt
]['tests'].append(test_file
)
65 if debug_tests
: sys
.exit(0)
67 # Extract a labels list.
69 for nu
, opt
in docs
.iteritems():
70 for label
in opt
['labels']:
71 if label
not in labels
:
74 print """<!DOCTYPE HTML>
77 <title>Dygraphs Options Reference</title>
78 <link rel="stylesheet" href="style.css">
79 <style type="text/css">
101 <li><a href="index.html">Home</a>
102 <li><a href="data.html">Data Formats</a></li>
103 <li><a href="annotations.html">Annotations</a></li>
105 <h2>Options Reference</h2>
107 <li><a href="#usage">Usage</a>
109 for label
in sorted(labels
):
110 print ' <li><a href="#%s">%s</a>\n' %
(label
, label
)
111 print '</ul>\n</div>\n\n'
114 """Takes 'tests/demo.html' -> 'demo'"""
115 return f
.replace('tests/', '').replace('.html', '')
119 <h2>Options Reference</h2>
120 <p>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.</p>
122 <a name="usage"></a><h3>Usage</h3>
123 <p>You specify options in the third parameter to the dygraphs constructor:</p>
124 <pre>g = new Dygraph(div,
133 <p>After you've created a Dygraph, you can change an option by calling the <code>updateOptions</code> method:</p>
134 <pre>g.updateOptions({
139 <p>And, without further ado, here's the complete list of options:</p>
141 for label
in sorted(labels
):
142 print '<a name="%s"><h3>%s</h3>\n' %
(label
, label
)
144 for opt_name
in sorted(docs
.keys()):
146 if label
not in opt
['labels']: continue
149 examples_html
= '<font color=red>NONE</font>'
151 examples_html
= ' '.join(
152 '<a href="%s">%s</a>' %
(f
, name(f
)) for f
in tests
)
154 if 'parameters' in opt
:
155 parameters
= opt
['parameters']
156 parameters_html
= '\n'.join("<i>%s</i>: %s<br/>" %
(p
[0], p
[1]) for p
in parameters
)
157 parameters_html
= "\n <div class='parameters'>\n%s</div>" %
(parameters_html
);
161 if not opt
['type']: opt
['type'] = '(missing)'
162 if not opt
['default']: opt
['default'] = '(missing)'
163 if not opt
['description']: opt
['description'] = '(missing)'
166 <div class='option'><a name="%(name)s"></a><b>%(name)s</b><br/>
168 <i>Type: %(type)s</i><br/>%(parameters)s
169 <i>Default: %(default)s</i><br/>
170 Examples: %(examples_html)s<br/>
172 """ %
{ 'name': opt_name
,
174 'parameters': parameters_html
,
175 'default': opt
['default'],
176 'desc': opt
['description'],
177 'examples_html': examples_html
}
181 <a name="point_properties"></a><h3>Point Properties</h3>
182 Some callbacks take a point argument. Its properties are:<br/>
184 <li>xval/yval: The data coordinates of the point (with dates/times as millis since epoch)</li>
185 <li>canvasx/canvasy: The canvas coordinates at which the point is drawn.</li>
186 <li>name: The name of the data series to which the point belongs</li>
193 # This page was super-helpful:
194 # http://jsbeautifier.org/