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

[Peter Maydell]

  Branch: refs/heads/staging
  Home:   https://github.com/qemu/qemu
  Commit: f1852f5d7e6fc2ead874261c0388b18898257000
      
https://github.com/qemu/qemu/commit/f1852f5d7e6fc2ead874261c0388b18898257000
  Author: Marc-André Lureau <marcandre.lureau@redhat.com>
  Date:   2021-05-10 (Mon, 10 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: 097d659e00d9b55830f545920801dda155067089
      
https://github.com/qemu/qemu/commit/097d659e00d9b55830f545920801dda155067089
  Author: Peter Maydell <peter.maydell@linaro.org>
  Date:   2021-05-13 (Thu, 13 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 Mon 10 May 2021 14:05:12 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/dab59ce03122...097d659e00d9