diff --git a/.gitignore b/.gitignore
index c7b0a6d3..294df548 100644
--- a/.gitignore
+++ b/.gitignore
@@ -27,7 +27,7 @@ mydbstub.py*
/bin/waf3-*
/bin/doxygen-*
-/docs/html
+/docs/*
/docs/sphinx/*.txt
/docs/sphinx/*.rst
/docs/sphinx/*.pkl
diff --git a/docs/sphinx/_static/css/phoenix.css b/docs/sphinx/_static/css/phoenix.css
index c94f5072..a0b3402f 100644
--- a/docs/sphinx/_static/css/phoenix.css
+++ b/docs/sphinx/_static/css/phoenix.css
@@ -29,6 +29,11 @@ td.field-body > blockquote {
margin-bottom: 0.5em;
}
+table.docutils.align-default tbody tr td p {
+ margin: 0;
+ padding: 5px 0 05px;
+}
+
/* spacing around example code */
div.highlight > pre {
padding: 2px 5px 2px 5px;
@@ -744,3 +749,11 @@ table.contentstable p.mybiglink {
line-height: 150%;
}
+hr.overloadsep {
+ color: #0000FF;
+ background-color: #0000FF;
+ height: 1px;
+ border: none;
+ width: 50%;
+ float: left;
+}
\ No newline at end of file
diff --git a/etgtools/sphinx_generator.py b/etgtools/sphinx_generator.py
index 61b9c581..8e4cdfc7 100644
--- a/etgtools/sphinx_generator.py
+++ b/etgtools/sphinx_generator.py
@@ -1985,7 +1985,7 @@ class XMLDocString(object):
if hasattr(xml_item, 'deprecated') and xml_item.deprecated and isinstance(xml_item.deprecated, string_base):
element = et.Element('deprecated', kind='deprecated')
element.text = xml_item.deprecated
-
+
deprecated_section = Section(element, None, self.kind, self.is_overload, self.share_docstrings)
self.root.AddSection(deprecated_section)
@@ -2869,15 +2869,13 @@ class XMLDocString(object):
pickleItem(desc, self.current_module, self.class_name, 'class')
if self.overloads:
-
docstrings += '\n\n%s|overload| Overloaded Implementations:\n\n'%spacer
- docstrings += '%s**~~~**\n\n'%spacer
+ docstrings += '%s:html:`
`\n\n'%spacer
for index, over in enumerate(self.overloads):
for line in over.splitlines():
docstrings += spacer + line + '\n'
-
- docstrings += '%s**~~~**\n\n'%spacer
+ docstrings += '%s:html:`
`\n\n'%spacer
if '**Perl Note:**' in docstrings:
index = docstrings.index('**Perl Note:**')
diff --git a/sphinxtools/postprocess.py b/sphinxtools/postprocess.py
index de92f1ec..142ae5a8 100644
--- a/sphinxtools/postprocess.py
+++ b/sphinxtools/postprocess.py
@@ -56,6 +56,9 @@ def makeHeadings():
rel_path = os.path.normpath(rel_path).replace('\\', '/')
text += templates.TEMPLATE_HEADINGS % (name, rel_path, width)
+ # Add custom roles
+ text += "\n.. role:: html(raw)\n :format: html\n\n"
+
writeIfChanged(heading_file, text)
# ----------------------------------------------------------------------- #
@@ -68,7 +71,7 @@ def genIndexes(sphinxDir):
main class index and some clean-up/maintenance of the generated ReST
files.
"""
-
+ print("Generating indexes...")
pklfiles = glob.glob(sphinxDir + '/*.pkl')
for file in pklfiles:
@@ -519,6 +522,7 @@ def makeModuleIndex(sphinxDir, file):
# ----------------------------------------------------------------------- #
def genGallery():
+ print("Generating gallery...")
link = ''
@@ -677,7 +681,6 @@ def postProcess(folder, options):
enum_dict['(
%s)'%enum] = new
for files in fileNames:
-
if "genindex" in files or "modindex" in files:
continue
@@ -694,42 +697,32 @@ def postProcess(folder, options):
else:
text = text.replace('class="headerimage"', 'class="headerimage-noshow"')
- text = text.replace('–
', '– ')
- text = text.replace('
![overload]()
Overloaded Implementations', 'Overloaded Implementations')
- text = text.replace('~~~
', '
')
-
- text = text.replace('
![contributed]()
', '– ')
+ text = text.replace('Overloaded Implementations:', 'Overloaded Implementations:')
for item in HTML_REPLACE:
- text = text.replace('
'%item, '
\n'%item)
+ if item != 'class':
+ text = text.replace(''%item, '\n
\n'%item)
newtext = ''
splitted_text = text.splitlines()
len_split = len(splitted_text)
for index, line in enumerate(splitted_text):
- if ''
-
if index < len_split - 1:
-
if line.strip() == '
' or line.strip() == '
':
next_line = splitted_text[index+1]
stripline = next_line.strip()
+ # repalce the
with a new headline for the first method or first property
if (stripline == '' or stripline == '' \
or stripline == '') and not methods_done:
- line = '
Methods
' + '\n' + line
+ line = '\n
Methods
\n'
methods_done = True
elif stripline == '' and not properties_done:
- line = '
Properties
' + '\n' + line
+ line = '\n
Properties
\n'
properties_done = True
- if ' ' in line and '–' in line:
- line = line.replace(' ', '')
-
newtext += line + '\n'
for old, new in list(enum_dict.items()):