html_static_path/html_logo

15 views
Skip to first unread message

Louis King

unread,
Sep 8, 2022, 8:10:30 PMSep 8
to sphinx-users
Hi all,
Trying to embellish the documentation on two programs on different system I am using sphinx ver 5.0.0 on one and 5.1.1 on the other. Both act the same. In my conf.py file the
html_static_path = ['../_static'] directive does not affect the html_logo = 'logo.png' directive.

For context the file structure is:
test1.png
Following what documentation indicates is a correct way to include a logo in sphix html output:
test2.png
results in the following results from make html
test3.png
NOTE the warning.
Changing the conf.py file to not use html_static_path
test4.png
works just fine.
test5.png
And the document is as expected.
If I include an intentional error, for example html__static_path = ['../_staticx'] the results are as expected:
test6.png
Obvious workaround but...  Am I missing something?
Lou

Ibrar Ch

unread,
Sep 9, 2022, 3:22:03 AMSep 9
to sphinx...@googlegroups.com

--
You received this message because you are subscribed to the Google Groups "sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/0b93ef4a-4924-4b50-942c-be466d7e54fbn%40googlegroups.com.

Steevie

unread,
Sep 9, 2022, 6:41:17 AMSep 9
to sphinx...@googlegroups.com
On Thu, 8 Sep 2022 17:10:30 -0700 (PDT), Louis King wrote:

> Hi all,
> Trying to embellish the documentation on two programs on different
> system I am using sphinx ver 5.0.0 on one and 5.1.1 on the other. Both
> act the same.
> In my conf.py file the html_static_path = ['../_static'] directive does
> not affect the html_logo =
> 'logo.png' directive.

> Obvious workaround but... Am I missing something?

The logo file should be relative to the source directory of conf.py, so
probably:

# The name of an image file (relative to this directory) to place at the
top
# of the sidebar.
html_logo = '../static/logo.png'


Louis King

unread,
Sep 11, 2022, 4:30:14 PMSep 11
to sphinx-users
Need to work on my critical reading.Thanks.
Reply all
Reply to author
Forward
0 new messages