Skip to content

Use sphinx_rtd documentation theme, added logo and link to source on Gitlab

Agate requested to merge documentation-theme into develop

I'm not really happy with the current theme, so this MR is a proposal to use Read The Docs theme. I tend to think it's easier to parse visually (especially the table of contents, which is really messy on the current theme), for various reasons, including:

  • Better contrast
  • Better separation between content and navigation
  • Links are styled properly when visited

I've also included our logo in the docs and a link to the corresponding source on Gitlab for easier editing.

@Sporiff what do you think?

Current version: https://docs.funkwhale.audio Proposed version: http://funkwhale.pages.funkwhale.audio/-/funkwhale/-/jobs/31043/artifacts/docs-review/index.html

Before

(as seen on https://docs.funkwhale.audio/)

image

image

After

image

image

Peek_2019-10-02_19-21

Edited by Agate

Merge request reports