sphinx-doc/alabaster

Logo theme variable does not seem to work?

Closed this issue · 4 comments

I've tried a few different things at this point in terms of a $PROJECT/_static/ relative path but can't get an img tag to show up anywhere (this is after grepping html files of course).

It appears there is an open question on stackoverflow by someone else who is having the exact same problem.

I've had to fall back to using a html_logo = '_static/img/logo.png' declaration for now.

Any help or suggestions that you can provide would be greatly appreciated :)

This seems to be related to #86.

I've looked at Alabaster's conf.py file and it specifes its own structure for the sidebar.
So far this is the simplest solution I have come to.

html_sidebars = {
    '**': [
        'about.html',
        'navigation.html',
        'searchbox.html',
    ]}

You basically specify the structure of the sidebar yourself. Here about.html contains
the templates for logo and logo_name, hence if it is not included then it won't be displayed.

The sphinx documentation has more information on html_sidebars.

This is definitely a bug in alabaster.

Ok, I've got a bit closer now to what I originally wanted. I've looked at layout.html of the original basic theme (which alabaster extends) and this setup is the closest to what the basic navigation bar looks like, but with the logo support working as expected.

html_sidebars = {
    '**': [
        'about.html',
        'localtoc.html',
        'relations.html',
        'sourcelink.html',
        'searchbox.html',
    ]
}

Let's say this is part of #86, since it seems to be the same issue. Will post an update there. thanks!