[dpdk-dev,v1] doc: fix navigation levels in html sidebar
Commit Message
Fix issue where the navigation levels weren't displayed in the
html sidebar with the new read_the_docs theme.
This was due to the :titlesonly: directive in the high level
index.rst and also due to a stray newline in the parsed version
number.
Signed-off-by: John McNamara <john.mcnamara@intel.com>
---
doc/guides/conf.py | 2 +-
doc/guides/index.rst | 1 -
2 files changed, 1 insertion(+), 2 deletions(-)
Comments
2016-01-15 16:35, John McNamara:
> Fix issue where the navigation levels weren't displayed in the
> html sidebar with the new read_the_docs theme.
>
> This was due to the :titlesonly: directive in the high level
> index.rst and also due to a stray newline in the parsed version
> number.
I'm interested to know the relation between titles and version number.
2016-01-15 16:35, John McNamara:
> Fix issue where the navigation levels weren't displayed in the
> html sidebar with the new read_the_docs theme.
>
> This was due to the :titlesonly: directive in the high level
> index.rst and also due to a stray newline in the parsed version
> number.
>
> Signed-off-by: John McNamara <john.mcnamara@intel.com>
Applied, thanks
> -----Original Message-----
> From: Thomas Monjalon [mailto:thomas.monjalon@6wind.com]
> Sent: Friday, January 15, 2016 10:01 PM
> To: Mcnamara, John
> Cc: dev@dpdk.org
> Subject: Re: [PATCH v1] doc: fix navigation levels in html sidebar
>
> 2016-01-15 16:35, John McNamara:
> > Fix issue where the navigation levels weren't displayed in the html
> > sidebar with the new read_the_docs theme.
> >
> > This was due to the :titlesonly: directive in the high level index.rst
> > and also due to a stray newline in the parsed version number.
>
> I'm interested to know the relation between titles and version number.
Hi Thomas,
There isn't any direct relationship I think.
Removing the :titlesonly: directive made the sublevels visible, but only to the first level. Removing the stray newline in the version number made the other levels visible. This may be a bug in the Sphinx RTD theme or just some strange CSS interaction.
Thanks for rebuilding the online docs.
John.
@@ -45,7 +45,7 @@ html_add_permalinks = ""
html_show_copyright = False
highlight_language = 'none'
-version = subprocess.check_output(['make', '-sRrC', '../../', 'showversion']).decode('utf-8')
+version = subprocess.check_output(['make', '-sRrC', '../../', 'showversion']).decode('utf-8').rstrip()
release = version
master_doc = 'index'
@@ -33,7 +33,6 @@ DPDK documentation
.. toctree::
:maxdepth: 1
- :titlesonly:
linux_gsg/index
freebsd_gsg/index