pytroll / pyorbital

Orbital and astronomy computations in python
http://pyorbital.readthedocs.org/
GNU General Public License v3.0
220 stars 75 forks source link

Prettify the RTD pages #137

Closed adybbroe closed 7 months ago

adybbroe commented 7 months ago

This PR seeks to update the presentation of the on-line documentation (the Readthedoc) pages to something more nicer looking. The pages are a bit old and are using an old (default) Sphinx theme.

Here is how the current pages looks for me in Firefox:

Screenshot from 2023-12-14 13-56-28

Would be nice to have something coherent across all Pytroll RTD pages, so copying configurations from Satpy's RTD documentation.

codecov[bot] commented 7 months ago

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Comparison is base (86bb368) 87.50% compared to head (4ccdde8) 87.50%.

Additional details and impacted files ```diff @@ Coverage Diff @@ ## main #137 +/- ## ======================================= Coverage 87.50% 87.50% ======================================= Files 14 14 Lines 2209 2209 ======================================= Hits 1933 1933 Misses 276 276 ``` | [Flag](https://app.codecov.io/gh/pytroll/pyorbital/pull/137/flags?src=pr&el=flags&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=pytroll) | Coverage Δ | | |---|---|---| | [unittests](https://app.codecov.io/gh/pytroll/pyorbital/pull/137/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=pytroll) | `87.50% <ø> (ø)` | | Flags with carried forward coverage won't be shown. [Click here](https://docs.codecov.io/docs/carryforward-flags?utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=pytroll#carryforward-flags-in-the-pull-request-comment) to find out more.

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

coveralls commented 7 months ago

Coverage Status

coverage: 87.556%. remained the same when pulling 4ccdde8993e065738c1fa595974604ce7a565c08 on adybbroe:rtd_facelift into 86bb368bd3d0b2027bd35ecb5605cb34e6741b91 on pytroll:main.

djhoese commented 7 months ago

Were the Makefile changes caused by copying Makefile from Satpy to here? It looks like Satpy's Makefile (and therefore sphinx project) may have been older. I see a lot of build options removed.

adybbroe commented 7 months ago

Off-line and locally the pages look like this for me now: Screenshot from 2023-12-15 08-30-29