#sphinx-doc

Hey @bilb_ono I have customised an existing theme

I would always recommend starting from one of the existing ones, just so you know you haven't missed anything out in the initial case. Once you are confident, then you can divorce it from the existing theme and make it a standalone.

nicola_fm: thanks good advice

yeah I just got to the point where its building and loading my css stylesheet

but I don’t know what all I need

in the stylesheet

If you're extending, the only things you put in the stylesheet is stuff you want to override.

When trying to update styles, I mostly inspected the webpage, found the tags and classes, and used that to update the css.

There's no documentation for all possible tags/classes to update. That way lies madness.

nicola_fm: so I want to basically use all of alabaster, but I need to use Gotham font (so I need a @font-face property with the source font)

yeah I was trying all possible tags/classes to update and feeling really lost

does it make sense for me to make a custom theme, basically use the alabaster.css file and then just change whatever I wan thtere?

ok, so you make an exts/themes/mytheme directory

In mytheme you put a theme.conf file

check and check

In that file you want to say:

Or whatever theme you're inheriting.

Then that stylesheet link points to your set of overrides.

Then I'd have a body declaration that overrides the font class

nicola_fm: how do you use _static? I am getting; effor file not found :///Users/conduce-laptop/src/conduce-python-api/doc/build/html/_static/static/conduce-style.css

my css file is in Users/conduce-laptop/src/conduce-python-api/doc/source/conduce-theme/static/conduce-style.css

and in theme.conf I have stylesheet = static/conduce-style.css

but its throwing in that extra _static…

oh in conf.py I have html_static_path = ['_static’]. So should I change this then to say html_static_path = [‘conduce-theme/static’] ?

Ummm. I stepped away from my desk. Just futz with it til things are where you expect. Check the help for what that stylrshert option in theme.conf is meant for.

If you’re a slack user, there’s more folks around on #sphinx in writethedocs.slack.org

nicola_fm: ok thanks. when you say Then that stylesheet link points to your set of overrides what do you mean?

you mean just like entries like div.body h1 { font-family: ‘Gotham’ }, etc.

in the my custom stylesheet?

or is there a specific way to override?

Just body { font-family: 'Gotham' } ... yep

In a meeting now so can't respond further at this time.

ok np, thanks for all the help nicola_fm

No worries! Good luck. :)

[02sphinx] 07jfbu pushed 031 commit to 03stable [+0/-0/±1] 13https://git.io/vbcKi

[02sphinx] 07jfbu 0321d1025 - Update CHANGES for PR #4268 modified: CHANGES

[02sphinx] 07jfbu pushed 031 commit to 03stable [+0/-0/±1] 13https://git.io/vbcPA

[02sphinx] 07jfbu 0390ee039 - Avoid № in CHANGES, as PDF built with language="ja" does not render it