Repository navigation
[Doc]: Install info takes up too much room on new front page #21246
Description
Documentation Link
https://matplotlib.org/devdocs/index.html
Problem
The install info at the top takes ~1/3 of the available vertical space on the front page (before scrolling, but taking into account the fact that the "real" version number will not have a git tag). While important, it is something that most users have to do only once, whereas they (hopefully) will consult the rest of the docs more than once; therefore, it could be made slightly less tall.
Suggested improvement
The current panels:
without scrolling (and with a "released" version), the page cuts on my screen just after "API reference".
A few options (just some quick hacks, certainly better styling is possible):
On my screen, without scrolling, the page cuts after the link to pyplot.figure with the first and last design, and after the link to pyplot.subplots_mosaic after the middle one. I think having these immediately visible is nice to have.
For reference, the rst sources
(comment out the unused ones).. code-block:: bash
# Using conda:
conda install matplotlib
# Or using pip:
pip install matplotlib
.. csv-table::
:widths: 1 3
Using `conda <https://docs.continuum.io/anaconda/>`__,``conda install matplotlib``
Using `pip <https://pypi.org/project/matplotlib>`__,``pip install matplotlib``
.. csv-table::
:widths: 1 2 1 2
Using `conda <https://docs.continuum.io/anaconda/>`__:,``conda install matplotlib``,Using `pip <https://pypi.org/project/matplotlib>`__:,``pip install matplotlib``Matplotlib Version
master
Matplotlib documentation version
(local build)
Activity
jklymak commentedon Oct 1, 2021
I'd vote for your second one (side-by-side)
timhoffm commentedon Oct 1, 2021
Side by side is better. Is it possible to have the code in the table as code-block highlighting like before? I think it's valuable to have the commands stand out a bit more than just another font and color.
anntzer commentedon Oct 1, 2021
I gave it a quick try with
.. raw:: htmlto set up the table and then interspersing.. code-blocks::at the strategic place, but the vertical align is messed up. Probably just needs some more CSS hacking...timhoffm commentedon Oct 7, 2021
See #21313 for a solution. - That can be reused for the front page.
Less verbose install info on index page