[FEATURE] Explicit summary directive alignment about autodocsumm HOT 6 CLOSED

hey @vepain! thanks for your input! I am not sure about this. Wouldn't this be something that is configured by the sphinx template that you use? you could add some custom css, here is an example: https://docs.readthedocs.io/en/stable/guides/adding-custom-css.html

from autodocsumm.

Thank you @Chilipp for your answer!

It seems that only a few customisations are allowed by furo theme (see https://pradyunsg.me/furo/customisation/).

Moreover, it seems that tables are centered by default by Sphinx, and I can't find a way to align local table not by default (see sphinx-doc/sphinx#4550)
In the html source file, the tables produced by .. autosummary:: directive are under the following class:

<table class="autosummary longtable docutils align-default">
...
</table>

Here the align-default key seems to be the issue.

Why not allow for one .. autosummary:: directive detail the table alignment like this?

.. autosummary::

    :alig: left
    
    ...

that would produce something like this:

<table class="autosummary longtable docutils align-left">
...
</table>

I don't have enough CSS and HTML knowledge, so perhaps I miss some points.
The idea is not to change the align-default (that will change all the alignment globally).
And even though I wanted to do this, I can't find in Sphinx doc a way to change the default table alignment.

Thank you for your help!

from autodocsumm.

Sorry for the second message,

I find https://docutils.sourceforge.io/docs/ref/rst/directives.html#tables where the directive .. table:: has the option :align: left (e.g.)

Why not get inspired of that for the table generation of .. autosummary:: directive?

from autodocsumm.

the problem here @vepain is that the .. autosummary directive that is used here does not come from the autodocsumm extension. it is coming from the builtin sphinx extension autosummary. autodocsumm is just using this directive. So if you want to change anything on the underlying autosummary directive, you'd need to head over to the main sphinx repo at https://github.com/sphinx-doc/sphinx/ and open an issue there. When this option is implemented, in autosummary, we can add an additional option here

from autodocsumm.

my suggestion would have been to add a custom css file

html_css_files = [
    'css/custom.css',
]

and then in custom.css have something like

table.autosummary {
    /** add some alignment css here **/
}

from autodocsumm.

My bad, I confused your extension with the sphinx builtin.
Thank you for your help, I will write an issue at the right place...
Have a nice day!

from autodocsumm.