Status: | Merged |
---|---|
Approved by: | Eric Day |
Approved revision: | 12 |
Merged at revision: | 5 |
Proposed branch: | lp:~eday/burrow/start-docs |
Merge into: | lp:burrow |
Diff against target: |
845 lines (+770/-1) 11 files modified
.bzrignore (+3/-0) ChangeLog (+4/-0) MANIFEST.in (+1/-0) burrow/__init__.py (+1/-1) doc/source/_ga/layout.html (+17/-0) doc/source/_static/basic.css (+416/-0) doc/source/_static/tweaks.css (+65/-0) doc/source/_theme/layout.html (+2/-0) doc/source/_theme/theme.conf (+5/-0) doc/source/conf.py (+218/-0) doc/source/index.rst (+38/-0) |
To merge this branch: | bzr merge lp:~eday/burrow/start-docs |
Related bugs: |
Reviewer | Review Type | Date Requested | Status |
---|---|---|---|
Burrow Core Team | Pending | ||
Review via email: mp+56675@code.launchpad.net |
Commit message
Description of the change
Added hooks and templates to build OpenStack themed Sphinx documentation.
To post a comment you must log in.
Preview Diff
[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1 | === added file '.bzrignore' |
2 | --- .bzrignore 1970-01-01 00:00:00 +0000 |
3 | +++ .bzrignore 2011-04-07 00:17:24 +0000 |
4 | @@ -0,0 +1,3 @@ |
5 | +burrow.egg-info |
6 | +dist |
7 | +doc/build/* |
8 | |
9 | === modified file 'ChangeLog' |
10 | --- ChangeLog 2011-04-06 02:03:37 +0000 |
11 | +++ ChangeLog 2011-04-07 00:17:24 +0000 |
12 | @@ -1,3 +1,7 @@ |
13 | +2011-04-05 Eric Day <eday@oddments.org> |
14 | + |
15 | + Added command line tool, start of client class, and HTTP backend. |
16 | + |
17 | 2011-03-30 Eric Day <eday@oddments.org> |
18 | |
19 | Merged burrow and burrowd packages, the interfaces for backend/client can be shared, and this will also allow modular in-process queues. |
20 | |
21 | === modified file 'MANIFEST.in' |
22 | --- MANIFEST.in 2011-03-18 00:47:26 +0000 |
23 | +++ MANIFEST.in 2011-04-07 00:17:24 +0000 |
24 | @@ -1,3 +1,4 @@ |
25 | +graft doc |
26 | graft etc |
27 | graft locale |
28 | include Authors |
29 | |
30 | === modified file 'burrow/__init__.py' |
31 | --- burrow/__init__.py 2011-04-06 02:03:37 +0000 |
32 | +++ burrow/__init__.py 2011-04-07 00:17:24 +0000 |
33 | @@ -22,7 +22,7 @@ |
34 | from burrow.server import Server |
35 | import burrow.config |
36 | |
37 | -__version__ = '0.1' |
38 | +__version__ = '2011.2' |
39 | |
40 | # This installs the _(...) function as a built-in so all other modules |
41 | # don't need to. |
42 | |
43 | === added directory 'doc' |
44 | === added directory 'doc/build' |
45 | === added directory 'doc/source' |
46 | === added directory 'doc/source/_ga' |
47 | === added file 'doc/source/_ga/layout.html' |
48 | --- doc/source/_ga/layout.html 1970-01-01 00:00:00 +0000 |
49 | +++ doc/source/_ga/layout.html 2011-04-07 00:17:24 +0000 |
50 | @@ -0,0 +1,17 @@ |
51 | +{% extends "!layout.html" %} |
52 | + |
53 | +{% block footer %} |
54 | +{{ super() }} |
55 | +<script type="text/javascript"> |
56 | +var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www."); |
57 | +document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E")); |
58 | +</script> |
59 | +<script type="text/javascript"> |
60 | +try { |
61 | +var pageTracker = _gat._getTracker("UA-17511903-4"); |
62 | +pageTracker._setDomainName("none"); |
63 | +pageTracker._setAllowLinker(true); |
64 | +pageTracker._trackPageview(); |
65 | +} catch(err) {}</script> |
66 | +{% endblock %} |
67 | + |
68 | |
69 | === added directory 'doc/source/_static' |
70 | === added file 'doc/source/_static/basic.css' |
71 | --- doc/source/_static/basic.css 1970-01-01 00:00:00 +0000 |
72 | +++ doc/source/_static/basic.css 2011-04-07 00:17:24 +0000 |
73 | @@ -0,0 +1,416 @@ |
74 | +/** |
75 | + * Sphinx stylesheet -- basic theme |
76 | + * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
77 | + */ |
78 | + |
79 | +/* -- main layout ----------------------------------------------------------- */ |
80 | + |
81 | +div.clearer { |
82 | + clear: both; |
83 | +} |
84 | + |
85 | +/* -- relbar ---------------------------------------------------------------- */ |
86 | + |
87 | +div.related { |
88 | + width: 100%; |
89 | + font-size: 90%; |
90 | +} |
91 | + |
92 | +div.related h3 { |
93 | + display: none; |
94 | +} |
95 | + |
96 | +div.related ul { |
97 | + margin: 0; |
98 | + padding: 0 0 0 10px; |
99 | + list-style: none; |
100 | +} |
101 | + |
102 | +div.related li { |
103 | + display: inline; |
104 | +} |
105 | + |
106 | +div.related li.right { |
107 | + float: right; |
108 | + margin-right: 5px; |
109 | +} |
110 | + |
111 | +/* -- sidebar --------------------------------------------------------------- */ |
112 | + |
113 | +div.sphinxsidebarwrapper { |
114 | + padding: 10px 5px 0 10px; |
115 | +} |
116 | + |
117 | +div.sphinxsidebar { |
118 | + float: left; |
119 | + width: 230px; |
120 | + margin-left: -100%; |
121 | + font-size: 90%; |
122 | +} |
123 | + |
124 | +div.sphinxsidebar ul { |
125 | + list-style: none; |
126 | +} |
127 | + |
128 | +div.sphinxsidebar ul ul, |
129 | +div.sphinxsidebar ul.want-points { |
130 | + margin-left: 20px; |
131 | + list-style: square; |
132 | +} |
133 | + |
134 | +div.sphinxsidebar ul ul { |
135 | + margin-top: 0; |
136 | + margin-bottom: 0; |
137 | +} |
138 | + |
139 | +div.sphinxsidebar form { |
140 | + margin-top: 10px; |
141 | +} |
142 | + |
143 | +div.sphinxsidebar input { |
144 | + border: 1px solid #98dbcc; |
145 | + font-family: sans-serif; |
146 | + font-size: 1em; |
147 | +} |
148 | + |
149 | +img { |
150 | + border: 0; |
151 | +} |
152 | + |
153 | +/* -- search page ----------------------------------------------------------- */ |
154 | + |
155 | +ul.search { |
156 | + margin: 10px 0 0 20px; |
157 | + padding: 0; |
158 | +} |
159 | + |
160 | +ul.search li { |
161 | + padding: 5px 0 5px 20px; |
162 | + background-image: url(file.png); |
163 | + background-repeat: no-repeat; |
164 | + background-position: 0 7px; |
165 | +} |
166 | + |
167 | +ul.search li a { |
168 | + font-weight: bold; |
169 | +} |
170 | + |
171 | +ul.search li div.context { |
172 | + color: #888; |
173 | + margin: 2px 0 0 30px; |
174 | + text-align: left; |
175 | +} |
176 | + |
177 | +ul.keywordmatches li.goodmatch a { |
178 | + font-weight: bold; |
179 | +} |
180 | + |
181 | +/* -- index page ------------------------------------------------------------ */ |
182 | + |
183 | +table.contentstable { |
184 | + width: 90%; |
185 | +} |
186 | + |
187 | +table.contentstable p.biglink { |
188 | + line-height: 150%; |
189 | +} |
190 | + |
191 | +a.biglink { |
192 | + font-size: 1.3em; |
193 | +} |
194 | + |
195 | +span.linkdescr { |
196 | + font-style: italic; |
197 | + padding-top: 5px; |
198 | + font-size: 90%; |
199 | +} |
200 | + |
201 | +/* -- general index --------------------------------------------------------- */ |
202 | + |
203 | +table.indextable td { |
204 | + text-align: left; |
205 | + vertical-align: top; |
206 | +} |
207 | + |
208 | +table.indextable dl, table.indextable dd { |
209 | + margin-top: 0; |
210 | + margin-bottom: 0; |
211 | +} |
212 | + |
213 | +table.indextable tr.pcap { |
214 | + height: 10px; |
215 | +} |
216 | + |
217 | +table.indextable tr.cap { |
218 | + margin-top: 10px; |
219 | + background-color: #f2f2f2; |
220 | +} |
221 | + |
222 | +img.toggler { |
223 | + margin-right: 3px; |
224 | + margin-top: 3px; |
225 | + cursor: pointer; |
226 | +} |
227 | + |
228 | +/* -- general body styles --------------------------------------------------- */ |
229 | + |
230 | +a.headerlink { |
231 | + visibility: hidden; |
232 | +} |
233 | + |
234 | +h1:hover > a.headerlink, |
235 | +h2:hover > a.headerlink, |
236 | +h3:hover > a.headerlink, |
237 | +h4:hover > a.headerlink, |
238 | +h5:hover > a.headerlink, |
239 | +h6:hover > a.headerlink, |
240 | +dt:hover > a.headerlink { |
241 | + visibility: visible; |
242 | +} |
243 | + |
244 | +div.body p.caption { |
245 | + text-align: inherit; |
246 | +} |
247 | + |
248 | +div.body td { |
249 | + text-align: left; |
250 | +} |
251 | + |
252 | +.field-list ul { |
253 | + padding-left: 1em; |
254 | +} |
255 | + |
256 | +.first { |
257 | +} |
258 | + |
259 | +p.rubric { |
260 | + margin-top: 30px; |
261 | + font-weight: bold; |
262 | +} |
263 | + |
264 | +/* -- sidebars -------------------------------------------------------------- */ |
265 | + |
266 | +div.sidebar { |
267 | + margin: 0 0 0.5em 1em; |
268 | + border: 1px solid #ddb; |
269 | + padding: 7px 7px 0 7px; |
270 | + background-color: #ffe; |
271 | + width: 40%; |
272 | + float: right; |
273 | +} |
274 | + |
275 | +p.sidebar-title { |
276 | + font-weight: bold; |
277 | +} |
278 | + |
279 | +/* -- topics ---------------------------------------------------------------- */ |
280 | + |
281 | +div.topic { |
282 | + border: 1px solid #ccc; |
283 | + padding: 7px 7px 0 7px; |
284 | + margin: 10px 0 10px 0; |
285 | +} |
286 | + |
287 | +p.topic-title { |
288 | + font-size: 1.1em; |
289 | + font-weight: bold; |
290 | + margin-top: 10px; |
291 | +} |
292 | + |
293 | +/* -- admonitions ----------------------------------------------------------- */ |
294 | + |
295 | +div.admonition { |
296 | + margin-top: 10px; |
297 | + margin-bottom: 10px; |
298 | + padding: 7px; |
299 | +} |
300 | + |
301 | +div.admonition dt { |
302 | + font-weight: bold; |
303 | +} |
304 | + |
305 | +div.admonition dl { |
306 | + margin-bottom: 0; |
307 | +} |
308 | + |
309 | +p.admonition-title { |
310 | + margin: 0px 10px 5px 0px; |
311 | + font-weight: bold; |
312 | +} |
313 | + |
314 | +div.body p.centered { |
315 | + text-align: center; |
316 | + margin-top: 25px; |
317 | +} |
318 | + |
319 | +/* -- tables ---------------------------------------------------------------- */ |
320 | + |
321 | +table.docutils { |
322 | + border: 0; |
323 | + border-collapse: collapse; |
324 | +} |
325 | + |
326 | +table.docutils td, table.docutils th { |
327 | + padding: 1px 8px 1px 0; |
328 | + border-top: 0; |
329 | + border-left: 0; |
330 | + border-right: 0; |
331 | + border-bottom: 1px solid #aaa; |
332 | +} |
333 | + |
334 | +table.field-list td, table.field-list th { |
335 | + border: 0 !important; |
336 | +} |
337 | + |
338 | +table.footnote td, table.footnote th { |
339 | + border: 0 !important; |
340 | +} |
341 | + |
342 | +th { |
343 | + text-align: left; |
344 | + padding-right: 5px; |
345 | +} |
346 | + |
347 | +/* -- other body styles ----------------------------------------------------- */ |
348 | + |
349 | +dl { |
350 | + margin-bottom: 15px; |
351 | +} |
352 | + |
353 | +dd p { |
354 | + margin-top: 0px; |
355 | +} |
356 | + |
357 | +dd ul, dd table { |
358 | + margin-bottom: 10px; |
359 | +} |
360 | + |
361 | +dd { |
362 | + margin-top: 3px; |
363 | + margin-bottom: 10px; |
364 | + margin-left: 30px; |
365 | +} |
366 | + |
367 | +dt:target, .highlight { |
368 | + background-color: #fbe54e; |
369 | +} |
370 | + |
371 | +dl.glossary dt { |
372 | + font-weight: bold; |
373 | + font-size: 1.1em; |
374 | +} |
375 | + |
376 | +.field-list ul { |
377 | + margin: 0; |
378 | + padding-left: 1em; |
379 | +} |
380 | + |
381 | +.field-list p { |
382 | + margin: 0; |
383 | +} |
384 | + |
385 | +.refcount { |
386 | + color: #060; |
387 | +} |
388 | + |
389 | +.optional { |
390 | + font-size: 1.3em; |
391 | +} |
392 | + |
393 | +.versionmodified { |
394 | + font-style: italic; |
395 | +} |
396 | + |
397 | +.system-message { |
398 | + background-color: #fda; |
399 | + padding: 5px; |
400 | + border: 3px solid red; |
401 | +} |
402 | + |
403 | +.footnote:target { |
404 | + background-color: #ffa |
405 | +} |
406 | + |
407 | +.line-block { |
408 | + display: block; |
409 | + margin-top: 1em; |
410 | + margin-bottom: 1em; |
411 | +} |
412 | + |
413 | +.line-block .line-block { |
414 | + margin-top: 0; |
415 | + margin-bottom: 0; |
416 | + margin-left: 1.5em; |
417 | +} |
418 | + |
419 | +/* -- code displays --------------------------------------------------------- */ |
420 | + |
421 | +pre { |
422 | + overflow: auto; |
423 | +} |
424 | + |
425 | +td.linenos pre { |
426 | + padding: 5px 0px; |
427 | + border: 0; |
428 | + background-color: transparent; |
429 | + color: #aaa; |
430 | +} |
431 | + |
432 | +table.highlighttable { |
433 | + margin-left: 0.5em; |
434 | +} |
435 | + |
436 | +table.highlighttable td { |
437 | + padding: 0 0.5em 0 0.5em; |
438 | +} |
439 | + |
440 | +tt.descname { |
441 | + background-color: transparent; |
442 | + font-weight: bold; |
443 | + font-size: 1.2em; |
444 | +} |
445 | + |
446 | +tt.descclassname { |
447 | + background-color: transparent; |
448 | +} |
449 | + |
450 | +tt.xref, a tt { |
451 | + background-color: transparent; |
452 | + font-weight: bold; |
453 | +} |
454 | + |
455 | +h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt { |
456 | + background-color: transparent; |
457 | +} |
458 | + |
459 | +/* -- math display ---------------------------------------------------------- */ |
460 | + |
461 | +img.math { |
462 | + vertical-align: middle; |
463 | +} |
464 | + |
465 | +div.body div.math p { |
466 | + text-align: center; |
467 | +} |
468 | + |
469 | +span.eqno { |
470 | + float: right; |
471 | +} |
472 | + |
473 | +/* -- printout stylesheet --------------------------------------------------- */ |
474 | + |
475 | +@media print { |
476 | + div.document, |
477 | + div.documentwrapper, |
478 | + div.bodywrapper { |
479 | + margin: 0 !important; |
480 | + width: 100%; |
481 | + } |
482 | + |
483 | + div.sphinxsidebar, |
484 | + div.related, |
485 | + div.footer, |
486 | + #top-link { |
487 | + display: none; |
488 | + } |
489 | +} |
490 | |
491 | === added file 'doc/source/_static/tweaks.css' |
492 | --- doc/source/_static/tweaks.css 1970-01-01 00:00:00 +0000 |
493 | +++ doc/source/_static/tweaks.css 2011-04-07 00:17:24 +0000 |
494 | @@ -0,0 +1,65 @@ |
495 | +ul.todo_list { |
496 | + list-style-type: none; |
497 | + margin: 0; |
498 | + padding: 0; |
499 | +} |
500 | + |
501 | +ul.todo_list li { |
502 | + display: block; |
503 | + margin: 0; |
504 | + padding: 7px 0; |
505 | + border-top: 1px solid #eee; |
506 | +} |
507 | + |
508 | +ul.todo_list li p { |
509 | + display: inline; |
510 | +} |
511 | + |
512 | +ul.todo_list li p.link { |
513 | + font-weight: bold; |
514 | +} |
515 | + |
516 | +ul.todo_list li p.details { |
517 | + font-style: italic; |
518 | +} |
519 | + |
520 | +ul.todo_list li { |
521 | +} |
522 | + |
523 | +div.admonition { |
524 | + border: 1px solid #8F1000; |
525 | +} |
526 | + |
527 | +div.admonition p.admonition-title { |
528 | + background-color: #8F1000; |
529 | + border-bottom: 1px solid #8E8E8E; |
530 | +} |
531 | + |
532 | +a { |
533 | + color: #CF2F19; |
534 | +} |
535 | + |
536 | +div.related ul li a { |
537 | + color: #CF2F19; |
538 | +} |
539 | + |
540 | +div.sphinxsidebar h4 { |
541 | + background-color:#8E8E8E; |
542 | + border:1px solid #255E6E; |
543 | + color:white; |
544 | + font-size:1em; |
545 | + margin:1em 0 0.5em; |
546 | + padding:0.1em 0 0.1em 0.5em; |
547 | +} |
548 | + |
549 | +em { |
550 | + font-style: normal; |
551 | +} |
552 | + |
553 | +table.docutils { |
554 | + font-size: 11px; |
555 | +} |
556 | + |
557 | +a tt { |
558 | + color:#CF2F19; |
559 | +} |
560 | \ No newline at end of file |
561 | |
562 | === added directory 'doc/source/_templates' |
563 | === added directory 'doc/source/_theme' |
564 | === added file 'doc/source/_theme/layout.html' |
565 | --- doc/source/_theme/layout.html 1970-01-01 00:00:00 +0000 |
566 | +++ doc/source/_theme/layout.html 2011-04-07 00:17:24 +0000 |
567 | @@ -0,0 +1,2 @@ |
568 | +{% extends "sphinxdoc/layout.html" %} |
569 | +{% set css_files = css_files + ['_static/tweaks.css'] %} |
570 | |
571 | === added file 'doc/source/_theme/theme.conf' |
572 | --- doc/source/_theme/theme.conf 1970-01-01 00:00:00 +0000 |
573 | +++ doc/source/_theme/theme.conf 2011-04-07 00:17:24 +0000 |
574 | @@ -0,0 +1,5 @@ |
575 | +[theme] |
576 | +inherit = sphinxdoc |
577 | +stylesheet = sphinxdoc.css |
578 | +pygments_style = friendly |
579 | + |
580 | |
581 | === added file 'doc/source/conf.py' |
582 | --- doc/source/conf.py 1970-01-01 00:00:00 +0000 |
583 | +++ doc/source/conf.py 2011-04-07 00:17:24 +0000 |
584 | @@ -0,0 +1,218 @@ |
585 | +# Copyright (C) 2011 OpenStack LLC. |
586 | +# |
587 | +# Licensed under the Apache License, Version 2.0 (the "License"); |
588 | +# you may not use this file except in compliance with the License. |
589 | +# You may obtain a copy of the License at |
590 | +# |
591 | +# http://www.apache.org/licenses/LICENSE-2.0 |
592 | +# |
593 | +# Unless required by applicable law or agreed to in writing, software |
594 | +# distributed under the License is distributed on an "AS IS" BASIS, |
595 | +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
596 | +# See the License for the specific language governing permissions and |
597 | +# limitations under the License. |
598 | + |
599 | +# Burrow documentation build configuration file, created by |
600 | +# sphinx-quickstart on Wed Apr 6 13:19:31 2011. |
601 | +# |
602 | +# This file is execfile()d with the current directory set to its containing dir. |
603 | +# |
604 | +# Note that not all possible configuration values are present in this |
605 | +# autogenerated file. |
606 | +# |
607 | +# All configuration values have a default; values that are commented out |
608 | +# serve to show the default. |
609 | + |
610 | +import sys, os |
611 | + |
612 | +# If extensions (or modules to document with autodoc) are in another directory, |
613 | +# add these directories to sys.path here. If the directory is relative to the |
614 | +# documentation root, use os.path.abspath to make it absolute, like shown here. |
615 | +sys.path.append([os.path.abspath('../burrow'), os.path.abspath('..'), os.path.abspath('../bin')]) |
616 | + |
617 | +# -- General configuration ----------------------------------------------------- |
618 | + |
619 | +# Add any Sphinx extension module names here, as strings. They can be extensions |
620 | +# coming with Sphinx (named 'sphinx.ext.*') or your custom ones. |
621 | +extensions = ['sphinx.ext.autodoc', 'sphinx.ext.intersphinx', 'sphinx.ext.todo', 'sphinx.ext.coverage', 'sphinx.ext.pngmath', 'sphinx.ext.ifconfig'] |
622 | +todo_include_todos = True |
623 | + |
624 | +# Add any paths that contain templates here, relative to this directory. |
625 | +templates_path = [] |
626 | +if os.getenv('HUDSON_PUBLISH_DOCS'): |
627 | + templates_path = ['_ga', '_templates'] |
628 | +else: |
629 | + templates_path = ['_templates'] |
630 | + |
631 | +# The suffix of source filenames. |
632 | +source_suffix = '.rst' |
633 | + |
634 | +# The encoding of source files. |
635 | +#source_encoding = 'utf-8' |
636 | + |
637 | +# The master toctree document. |
638 | +master_doc = 'index' |
639 | + |
640 | +# General information about the project. |
641 | +project = u'Burrow' |
642 | +copyright = u'2011, OpenStack, LLC' |
643 | + |
644 | +# The version info for the project you're documenting, acts as replacement for |
645 | +# |version| and |release|, also used in various other places throughout the |
646 | +# built documents. |
647 | +# |
648 | +# The short X.Y version. |
649 | +import burrow |
650 | +version = burrow.__version__.rsplit('.', 1)[0] |
651 | +# The full version, including alpha/beta/rc tags. |
652 | +release = burrow.__version__ |
653 | + |
654 | +# The language for content autogenerated by Sphinx. Refer to documentation |
655 | +# for a list of supported languages. |
656 | +#language = None |
657 | + |
658 | +# There are two options for replacing |today|: either, you set today to some |
659 | +# non-false value, then it is used: |
660 | +#today = '' |
661 | +# Else, today_fmt is used as the format for a strftime call. |
662 | +#today_fmt = '%B %d, %Y' |
663 | + |
664 | +# List of documents that shouldn't be included in the build. |
665 | +#unused_docs = [] |
666 | + |
667 | +# List of directories, relative to source directory, that shouldn't be searched |
668 | +# for source files. |
669 | +exclude_trees = [] |
670 | + |
671 | +# The reST default role (used for this markup: `text`) to use for all documents. |
672 | +#default_role = None |
673 | + |
674 | +# If true, '()' will be appended to :func: etc. cross-reference text. |
675 | +#add_function_parentheses = True |
676 | + |
677 | +# If true, the current module name will be prepended to all description |
678 | +# unit titles (such as .. function::). |
679 | +#add_module_names = True |
680 | + |
681 | +# If true, sectionauthor and moduleauthor directives will be shown in the |
682 | +# output. They are ignored by default. |
683 | +show_authors = True |
684 | + |
685 | +# The name of the Pygments (syntax highlighting) style to use. |
686 | +pygments_style = 'sphinx' |
687 | + |
688 | +# A list of ignored prefixes for module index sorting. |
689 | +modindex_common_prefix = ['burrow.'] |
690 | + |
691 | + |
692 | +# -- Options for HTML output --------------------------------------------------- |
693 | + |
694 | +# The theme to use for HTML and HTML Help pages. Major themes that come with |
695 | +# Sphinx are currently 'default' and 'sphinxdoc'. |
696 | +html_theme = '_theme' |
697 | + |
698 | +# Theme options are theme-specific and customize the look and feel of a theme |
699 | +# further. For a list of options available for each theme, see the |
700 | +# documentation. |
701 | +#html_theme_options = {} |
702 | + |
703 | +# Add any paths that contain custom themes here, relative to this directory. |
704 | +html_theme_path = ['.'] |
705 | + |
706 | +# The name for this set of Sphinx documents. If None, it defaults to |
707 | +# "<project> v<release> documentation". |
708 | +#html_title = None |
709 | + |
710 | +# A shorter title for the navigation bar. Default is the same as html_title. |
711 | +#html_short_title = None |
712 | + |
713 | +# The name of an image file (relative to this directory) to place at the top |
714 | +# of the sidebar. |
715 | +#html_logo = None |
716 | + |
717 | +# The name of an image file (within the static path) to use as favicon of the |
718 | +# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 |
719 | +# pixels large. |
720 | +#html_favicon = None |
721 | + |
722 | +# Add any paths that contain custom static files (such as style sheets) here, |
723 | +# relative to this directory. They are copied after the builtin static files, |
724 | +# so a file named "default.css" will overwrite the builtin "default.css". |
725 | +html_static_path = ['_static'] |
726 | + |
727 | +# If not '', a 'Last updated on:' timestamp is inserted at every page bottom, |
728 | +# using the given strftime format. |
729 | +#html_last_updated_fmt = '%b %d, %Y' |
730 | + |
731 | +# If true, SmartyPants will be used to convert quotes and dashes to |
732 | +# typographically correct entities. |
733 | +#html_use_smartypants = True |
734 | + |
735 | +# Custom sidebar templates, maps document names to template names. |
736 | +#html_sidebars = {} |
737 | + |
738 | +# Additional templates that should be rendered to pages, maps page names to |
739 | +# template names. |
740 | +#html_additional_pages = {} |
741 | + |
742 | +# If false, no module index is generated. |
743 | +#html_use_modindex = True |
744 | + |
745 | +# If false, no index is generated. |
746 | +#html_use_index = True |
747 | + |
748 | +# If true, the index is split into individual pages for each letter. |
749 | +#html_split_index = False |
750 | + |
751 | +# If true, links to the reST sources are added to the pages. |
752 | +#html_show_sourcelink = True |
753 | + |
754 | +# If true, an OpenSearch description file will be output, and all pages will |
755 | +# contain a <link> tag referring to it. The value of this option must be the |
756 | +# base URL from which the finished HTML is served. |
757 | +#html_use_opensearch = '' |
758 | + |
759 | +# If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml"). |
760 | +#html_file_suffix = '' |
761 | + |
762 | +# Output file base name for HTML help builder. |
763 | +htmlhelp_basename = 'burrowdoc' |
764 | + |
765 | + |
766 | +# -- Options for LaTeX output -------------------------------------------------- |
767 | + |
768 | +# The paper size ('letter' or 'a4'). |
769 | +#latex_paper_size = 'letter' |
770 | + |
771 | +# The font size ('10pt', '11pt' or '12pt'). |
772 | +#latex_font_size = '10pt' |
773 | + |
774 | +# Grouping the document tree into LaTeX files. List of tuples |
775 | +# (source start file, target name, title, author, documentclass [howto/manual]). |
776 | +latex_documents = [ |
777 | + ('index', 'Burrow.tex', u'Burrow Documentation', |
778 | + u'OpenStack, LLC', 'manual'), |
779 | +] |
780 | + |
781 | +# The name of an image file (relative to this directory) to place at the top of |
782 | +# the title page. |
783 | +#latex_logo = None |
784 | + |
785 | +# For "manual" documents, if this is true, then toplevel headings are parts, |
786 | +# not chapters. |
787 | +#latex_use_parts = False |
788 | + |
789 | +# Additional stuff for the LaTeX preamble. |
790 | +#latex_preamble = '' |
791 | + |
792 | +# Documents to append as an appendix to all manuals. |
793 | +#latex_appendices = [] |
794 | + |
795 | +# If false, no module index is generated. |
796 | +#latex_use_modindex = True |
797 | + |
798 | +# Example configuration for intersphinx: refer to the Python standard library. |
799 | +intersphinx_mapping = {'python': ('http://docs.python.org/', None), |
800 | + 'glance': ('http://glance.openstack.org', None), |
801 | + 'nova': ('http://nova.openstack.org', None), |
802 | + 'swift': ('http://swift.openstack.org', None)} |
803 | |
804 | === added file 'doc/source/index.rst' |
805 | --- doc/source/index.rst 1970-01-01 00:00:00 +0000 |
806 | +++ doc/source/index.rst 2011-04-07 00:17:24 +0000 |
807 | @@ -0,0 +1,38 @@ |
808 | +.. |
809 | + Copyright (C) 2011 OpenStack LLC. |
810 | + |
811 | + Licensed under the Apache License, Version 2.0 (the "License"); |
812 | + you may not use this file except in compliance with the License. |
813 | + You may obtain a copy of the License at |
814 | + |
815 | + http://www.apache.org/licenses/LICENSE-2.0 |
816 | + |
817 | + Unless required by applicable law or agreed to in writing, software |
818 | + distributed under the License is distributed on an "AS IS" BASIS, |
819 | + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
820 | + See the License for the specific language governing permissions and |
821 | + limitations under the License. |
822 | + |
823 | +Welcome to Burrow's documentation! |
824 | +================================== |
825 | + |
826 | +Burrow is a highly available, distributed, multi-tenant message |
827 | +queue. Burrow can be used in a variety of environments, from simple |
828 | +in-process queues to cloud-based message queue services. |
829 | + |
830 | +This documentation is generated by the Sphinx toolkit and lives in the |
831 | +source tree. Additional documentation on Swift and other components |
832 | +of OpenStack can be found on the `OpenStack wiki`_. |
833 | + |
834 | +.. _`OpenStack wiki`: http://wiki.openstack.org |
835 | + |
836 | +.. toctree:: |
837 | + :maxdepth: 1 |
838 | + |
839 | +Indices and tables |
840 | +================== |
841 | + |
842 | +* :ref:`genindex` |
843 | +* :ref:`modindex` |
844 | +* :ref:`search` |
845 | + |