summaryrefslogtreecommitdiffstats
path: root/docs/source/conf.py
blob: 5577ef65f06de4a8868bccbc67d4ed749681c979 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
# vim:fileencoding=utf-8:noet
from __future__ import (unicode_literals, division, absolute_import, print_function)

import os
import sys


sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(os.getcwd()))))
sys.path.insert(0, os.path.abspath(os.getcwd()))

extensions = [
	'powerline_autodoc', 'powerline_automan',
	'sphinx.ext.todo', 'sphinx.ext.coverage', 'sphinx.ext.viewcode',
]
source_suffix = '.rst'
master_doc = 'index'
project = 'Powerline'
version = 'beta'
release = 'beta'
exclude_patterns = ['_build']
pygments_style = 'sphinx'

html_theme = 'default'
html_static_path = ['_static']
html_show_copyright = False

latex_show_urls = 'footnote'
latex_elements = {
	'preamble': '''
		\\DeclareUnicodeCharacter{22EF}{$\\cdots$}   % Dots
		\\DeclareUnicodeCharacter{2665}{\\ding{170}} % Heart
		\\DeclareUnicodeCharacter{2746}{\\ding{105}} % Snow
		\\usepackage{pifont}
	''',
}

man_pages = []
for doc in os.listdir(os.path.join(os.path.dirname(__file__), 'commands')):
	if doc.endswith('.rst'):
		name = doc[:-4]
		module = 'powerline.commands.{0}'.format(name)
		get_argparser = __import__(str(module), fromlist=[str('get_argparser')]).get_argparser
		parser = get_argparser()
		description = parser.description
		man_pages.append([
			'commands/' + name,
			'powerline' if name == 'main' else 'powerline-' + name,
			description,
			'',
			1
		])

on_rtd = os.environ.get('READTHEDOCS', None) == 'True'

if not on_rtd:  # only import and set the theme if we’re building docs locally
	try:
		import sphinx_rtd_theme
		html_theme = 'sphinx_rtd_theme'
		html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
	except ImportError:
		pass

if on_rtd or html_theme == 'sphinx_rtd_theme':
	html_context = {
		'css_files': [
			'https://media.readthedocs.org/css/sphinx_rtd_theme.css',
			'https://media.readthedocs.org/css/readthedocs-doc-embed.css',
			'_static/css/theme_overrides.css',
		],
	}