[4025019] | 1 | [epydoc] # Epydoc section marker (required by ConfigParser) |
---|
| 2 | |
---|
| 3 | # The list of objects to document. Objects can be named using |
---|
| 4 | # dotted names, module filenames, or package directory names. |
---|
| 5 | # Alases for this option include "objects" and "values". |
---|
| 6 | modules: park |
---|
| 7 | |
---|
| 8 | # The type of output that should be generated. Should be one |
---|
| 9 | # of: html, text, latex, dvi, ps, pdf. |
---|
| 10 | #output: html |
---|
| 11 | output: pdf |
---|
| 12 | |
---|
| 13 | # The path to the output directory. May be relative or absolute. |
---|
| 14 | target: build/html/ |
---|
| 15 | |
---|
| 16 | # An integer indicating how verbose epydoc should be. The default value is 0 |
---|
| 17 | # Negative values will supress warnings and errors |
---|
| 18 | # Positive values will give more verbose output. |
---|
| 19 | verbosity: 0 |
---|
| 20 | |
---|
| 21 | # A boolean value indicating that Epydoc should show a tracaback |
---|
| 22 | # in case of unexpected error. By default don't show tracebacks |
---|
| 23 | debug: 0 |
---|
| 24 | |
---|
| 25 | # If True, don't try to use colors or cursor control when doing |
---|
| 26 | # textual output. The default False assumes a rich text prompt |
---|
| 27 | simple-term: 0 |
---|
| 28 | |
---|
| 29 | |
---|
| 30 | ### Generation options |
---|
| 31 | |
---|
| 32 | # The default markup language for docstrings, for modules that do |
---|
| 33 | # not define __docformat__. Defaults to epytext. |
---|
| 34 | docformat: restructuredtext |
---|
| 35 | |
---|
| 36 | # Whether or not parsing should be used to examine objects. |
---|
| 37 | parse: yes |
---|
| 38 | |
---|
| 39 | # Whether or not introspection should be used to examine objects. |
---|
| 40 | introspect: yes |
---|
| 41 | |
---|
| 42 | # Don't examine in any way the modules whose dotted name match this |
---|
| 43 | # regular expression pattern. |
---|
| 44 | #exclude |
---|
| 45 | |
---|
| 46 | # Don't perform introspection on the modules whose dotted name match this |
---|
| 47 | # regular expression pattern. |
---|
| 48 | #exclude-introspect |
---|
| 49 | |
---|
| 50 | # Don't perform parsing on the modules whose dotted name match this |
---|
| 51 | # regular expression pattern. |
---|
| 52 | #exclude-parse |
---|
| 53 | |
---|
| 54 | # The format for showing inheritance objects. |
---|
| 55 | # It should be one of: 'grouped', 'listed', 'included'. |
---|
| 56 | inheritance: listed |
---|
| 57 | |
---|
| 58 | # Whether or not to inclue private variables. (Even if included, |
---|
| 59 | # private variables will be hidden by default.) |
---|
| 60 | private: no |
---|
| 61 | |
---|
| 62 | # Whether or not to list each module's imports. |
---|
| 63 | imports: no |
---|
| 64 | |
---|
| 65 | # Whether or not to include syntax highlighted source code in |
---|
| 66 | # the output (HTML only). |
---|
| 67 | sourcecode: yes |
---|
| 68 | |
---|
| 69 | # Whether or not to includea a page with Epydoc log, containing |
---|
| 70 | # effective option at the time of generation and the reported logs. |
---|
| 71 | include-log: no |
---|
| 72 | |
---|
| 73 | |
---|
| 74 | ### Output options |
---|
| 75 | |
---|
| 76 | # The documented project's name. |
---|
| 77 | name: PARK |
---|
| 78 | |
---|
| 79 | # The CSS stylesheet for HTML output. Can be the name of a builtin |
---|
| 80 | # stylesheet, or the name of a file. |
---|
| 81 | css: white |
---|
| 82 | |
---|
| 83 | # The documented project's URL. |
---|
| 84 | url: http://www.reflectometry.org/danse/park |
---|
| 85 | |
---|
| 86 | # HTML code for the project link in the navigation bar. If left |
---|
| 87 | # unspecified, the project link will be generated based on the |
---|
| 88 | # project's name and URL. |
---|
| 89 | link: <a href="http://reflectometry.org/danse">Reflectometry</a> |
---|
| 90 | |
---|
| 91 | # The "top" page for the documentation. Can be a URL, the name |
---|
| 92 | # of a module or class, or one of the special names "trees.html", |
---|
| 93 | # "indices.html", or "help.html" |
---|
| 94 | #top: os.path |
---|
| 95 | |
---|
| 96 | # An alternative help file. The named file should contain the |
---|
| 97 | # body of an HTML file; navigation bars will be added to it. |
---|
| 98 | #help: my_helpfile.html |
---|
| 99 | |
---|
| 100 | # Whether or not to include a frames-based table of contents. |
---|
| 101 | frames: no |
---|
| 102 | |
---|
| 103 | # Whether each class should be listed in its own section when |
---|
| 104 | # generating LaTeX or PDF output. |
---|
| 105 | separate-classes: no |
---|
| 106 | |
---|
| 107 | |
---|
| 108 | ### API linking options |
---|
| 109 | |
---|
| 110 | # Define a new API document. A new interpreted text role will be created |
---|
| 111 | external-api: park |
---|
| 112 | |
---|
| 113 | # Use the records in this file to resolve objects in the API named NAME. |
---|
| 114 | #external-api-file: epydoc:api-objects.txt |
---|
| 115 | |
---|
| 116 | # Use this URL prefix to configure the string returned for external API. |
---|
| 117 | external-api-root: park:http://www.reflectometry.org/danse/park |
---|
| 118 | |
---|
| 119 | |
---|
| 120 | ### Graph options |
---|
| 121 | |
---|
| 122 | # The list of graph types that should be automatically included |
---|
| 123 | # in the output. Graphs are generated using the Graphviz "dot" |
---|
| 124 | # executable. Graph types include: "classtree", "callgraph","umlclasstree". |
---|
| 125 | # Use "all" to include all graph types |
---|
| 126 | graph: umlclasstree |
---|
| 127 | |
---|
| 128 | # The path to the Graphviz "dot" executable, used to generate graphs. |
---|
| 129 | #dotpath: /cygdrive/c/cygwin/usr/local/graphviz/bin/ |
---|
| 130 | |
---|
| 131 | # The name of one or more pstat files (generated by the profile |
---|
| 132 | # or hotshot module). These are used to generate call graphs. |
---|
| 133 | #pstat: profile.out |
---|
| 134 | |
---|
| 135 | # Specify the font used to generate Graphviz graphs. |
---|
| 136 | # (e.g., helvetica or times). |
---|
| 137 | graph-font: Helvetica |
---|
| 138 | |
---|
| 139 | # Specify the font size used to generate Graphviz graphs. |
---|
| 140 | graph-font-size: 10 |
---|
| 141 | graph-image-format: svg |
---|
| 142 | |
---|
| 143 | ### Return value options |
---|
| 144 | |
---|
| 145 | # The condition upon which Epydoc should exit with a non-zero exit status. |
---|
| 146 | # Possible values are error, warning, docstring_warning |
---|
| 147 | fail-on: error |
---|