[Qemu-commits] [qemu/qemu] 73e6ae: sphinx: adopt kernel readthedoc theme

[Peter Maydell]

  Branch: refs/heads/staging
  Home:   https://github.com/qemu/qemu
  Commit: 73e6aec6522e1edd63f631c52577b49a39bc234f
      
https://github.com/qemu/qemu/commit/73e6aec6522e1edd63f631c52577b49a39bc234f
  Author: Marc-André Lureau <marcandre.lureau@redhat.com>
  Date:   2021-05-14 (Fri, 14 May 2021)

  Changed paths:
    R docs/_templates/editpage.html
    M docs/conf.py
    R docs/devel/_templates/editpage.html
    R docs/interop/_templates/editpage.html
    M docs/meson.build
    R docs/specs/_templates/editpage.html
    A docs/sphinx-static/theme_overrides.css
    R docs/system/_templates/editpage.html
    R docs/tools/_templates/editpage.html
    R docs/user/_templates/editpage.html
    M tests/docker/dockerfiles/alpine.docker
    M tests/docker/dockerfiles/debian10.docker
    M tests/docker/dockerfiles/fedora.docker
    M tests/docker/dockerfiles/ubuntu.docker
    M tests/docker/dockerfiles/ubuntu1804.docker
    M tests/docker/dockerfiles/ubuntu2004.docker

  Log Message:
  -----------
  sphinx: adopt kernel readthedoc theme

The default "alabaster" sphinx theme has a couple shortcomings:
- the navbar moves along the page
- the search bar is not always at the same place
- it lacks some contrast and colours

The "rtd" theme from readthedocs.org is a popular third party theme used
notably by the kernel, with a custom style sheet. I like it better,
perhaps others do too. It also simplifies the "Edit on Gitlab" links.

Tweak a bit the custom theme to match qemu.org style, use the
QEMU logo, and favicon etc.

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Tested-by: Bin Meng <bmeng.cn@gmail.com>
Message-Id: <20210323115328.4146052-1-marcandre.lureau@redhat.com>
Reviewed-by: John Snow <jsnow@redhat.com>


  Commit: 6d34aa9969ff85ca6eaeb4dc1988a4d4e13e7d79
      
https://github.com/qemu/qemu/commit/6d34aa9969ff85ca6eaeb4dc1988a4d4e13e7d79
  Author: Peter Maydell <peter.maydell@linaro.org>
  Date:   2021-05-14 (Fri, 14 May 2021)

  Changed paths:
    R docs/_templates/editpage.html
    M docs/conf.py
    R docs/devel/_templates/editpage.html
    R docs/interop/_templates/editpage.html
    M docs/meson.build
    R docs/specs/_templates/editpage.html
    A docs/sphinx-static/theme_overrides.css
    R docs/system/_templates/editpage.html
    R docs/tools/_templates/editpage.html
    R docs/user/_templates/editpage.html
    M tests/docker/dockerfiles/alpine.docker
    M tests/docker/dockerfiles/debian10.docker
    M tests/docker/dockerfiles/fedora.docker
    M tests/docker/dockerfiles/ubuntu.docker
    M tests/docker/dockerfiles/ubuntu1804.docker
    M tests/docker/dockerfiles/ubuntu2004.docker

  Log Message:
  -----------
  Merge remote-tracking branch 'remotes/marcandre/tags/rtd-pull-request' into 
staging

Pull request

# gpg: Signature made Fri 14 May 2021 12:12:24 BST
# gpg:                using RSA key 87A9BD933F87C606D276F62DDAE8E10975969CE5
# gpg:                issuer "marcandre.lureau@redhat.com"
# gpg: Good signature from "Marc-André Lureau <marcandre.lureau@redhat.com>" 
[full]
# gpg:                 aka "Marc-André Lureau <marcandre.lureau@gmail.com>" 
[full]
# Primary key fingerprint: 87A9 BD93 3F87 C606 D276  F62D DAE8 E109 7596 9CE5

* remotes/marcandre/tags/rtd-pull-request:
  sphinx: adopt kernel readthedoc theme

Signed-off-by: Peter Maydell <peter.maydell@linaro.org>


Compare: https://github.com/qemu/qemu/compare/499063d00ad3...6d34aa9969ff