Re: [sphinx-users] Re: ANN: "insipid" Sphinx theme, release 0.2.0

2020-11-08 Thread Matthias Geier
On Sun, Nov 8, 2020 at 12:49 PM bradley...@gmail.com wrote:
>
> I have tried insipid and I have two questions:
>
> 1. How does on change the  color  used for in-line literal font; e.g., 
> ``test``  ?

There isn't a single setting, multiple CSS classes are used for that,
which are defined there:
https://github.com/mgeier/insipid-sphinx-theme/blob/96fb5c3c155cde3be1f537ee5b1f94b4526b4e97/src/insipid_sphinx_theme/insipid/static/insipid.css_t#L259-L270

Currently, the theme is not prepared to easily support multiple color
themes (i.e. there are no CSS variables defined for the colors). If
you want to help out with that, you can leave a comment at
https://github.com/mgeier/insipid-sphinx-theme/issues/5

> 2. Is there a way to only use titles in the navigation, like read rtd_theme 
> does when titles_only is True; see
> https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html#theme-options

The "insipid" theme uses the navigation/TOC provided by Sphinx, while
"sphinx_rtd_theme" uses custom Python code to generate theirs.
Therefore, it has somewhat different options and behavior.

You might get a similar effect by using the :titlesonly: flag on the
"toctree" directive, see
https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-toctree.

Does that do what you want?

Maybe you can use :maxdepth:?

If not, you are of course free to replace the default template
"globaltoc.html" with your custom version (probably based on the one
from the RTD theme). See also
file:///home/mg/git/insipid-sphinx-theme/build/sphinx/html/configuration.html#confval-html_sidebars

cheers,
Matthias

> On Wednesday, October 21, 2020 at 3:16:47 AM UTC-7 matthia...@gmail.com wrote:
>>
>> Dear list.
>>
>> I've already announced my new Sphinx theme "insipid" right here two months 
>> ago.
>>
>> Since then, I've tuned the colors to make them less annoying and more
>> insipid. I hope you like them!
>>
>> Here's the theme documentation (and at the same time a usage example):
>>
>> https://insipid-sphinx-theme.readthedocs.io/
>>
>> The usage should be really simple:
>>
>> 1. Install the Python package insipid-sphinx-theme
>> 2. Add html_theme = 'insipid' to your conf.py
>> 3. Run Sphinx!
>>
>> It would be great if you could try it out and give feedback (either
>> here on the list or at
>> https://github.com/mgeier/insipid-sphinx-theme/issues)!
>>
>> There are certainly many things that can (and should) be improved, I'd
>> love to hear your suggestions.
>>
>> There aren't a lot of example projects yet, I've just tried it out on
>> a few projects I'm currently working on:
>>
>> https://nbsphinx.readthedocs.io/
>> https://python-sounddevice.readthedocs.io/en/latest/
>> https://python-rtmixer.readthedocs.io/
>> https://jackclient-python.readthedocs.io/
>> https://mg.readthedocs.io/
>> https://jupyter-format.readthedocs.io/
>> https://audioscenedescriptionformat.readthedocs.io/
>> https://splines.readthedocs.io/
>>
>> I've mostly tested the theme on multiple browsers on Linux and
>> Android, it would be great to get some coverage on Windows, macOS, iOS
>> and whatever other OS you are using!
>>
>> cheers,
>> Matthias

-- 
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+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/CAFesC-dcLrHg4XmjYXDiFR5RQ26JmgC85m09JDYH2gpZdnZV9g%40mail.gmail.com.


[sphinx-users] Re: ANN: "insipid" Sphinx theme, release 0.2.0

2020-11-08 Thread bradley...@gmail.com

I have tried insipid and I have two questions:

1. How does on change the  color  used for in-line literal font; e.g., 
``test``  ?

2. Is there a way to only use titles in the navigation, like read rtd_theme 
does when titles_only is True; see
https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html#theme-options

On Wednesday, October 21, 2020 at 3:16:47 AM UTC-7 matthia...@gmail.com 
wrote:

> Dear list.
>
> I've already announced my new Sphinx theme "insipid" right here two months 
> ago.
>
> Since then, I've tuned the colors to make them less annoying and more
> insipid. I hope you like them!
>
> Here's the theme documentation (and at the same time a usage example):
>
> https://insipid-sphinx-theme.readthedocs.io/
>
> The usage should be really simple:
>
> 1. Install the Python package insipid-sphinx-theme
> 2. Add html_theme = 'insipid' to your conf.py
> 3. Run Sphinx!
>
> It would be great if you could try it out and give feedback (either
> here on the list or at
> https://github.com/mgeier/insipid-sphinx-theme/issues)!
>
> There are certainly many things that can (and should) be improved, I'd
> love to hear your suggestions.
>
> There aren't a lot of example projects yet, I've just tried it out on
> a few projects I'm currently working on:
>
> https://nbsphinx.readthedocs.io/
> https://python-sounddevice.readthedocs.io/en/latest/
> https://python-rtmixer.readthedocs.io/
> https://jackclient-python.readthedocs.io/
> https://mg.readthedocs.io/
> https://jupyter-format.readthedocs.io/
> https://audioscenedescriptionformat.readthedocs.io/
> https://splines.readthedocs.io/
>
> I've mostly tested the theme on multiple browsers on Linux and
> Android, it would be great to get some coverage on Windows, macOS, iOS
> and whatever other OS you are using!
>
> cheers,
> Matthias
>

-- 
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+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/9664c5b7-0f1f-49ee-8f38-cd5e97b188b0n%40googlegroups.com.