From: "Daniel P. Berrangé" <berrange@redhat.com>
To: "Marc-André Lureau" <marcandre.lureau@redhat.com>
Cc: Peter Maydell <peter.maydell@linaro.org>,
bmeng.cn@gmail.com, John Snow <jsnow@redhat.com>,
qemu-devel <qemu-devel@nongnu.org>
Subject: Re: [PATCH v4] sphinx: adopt kernel readthedoc theme
Date: Mon, 22 Mar 2021 12:14:39 +0000 [thread overview]
Message-ID: <YFiKL6AwirjdgSWM@redhat.com> (raw)
In-Reply-To: <CAMxuvazgQ1HGt459VstXB90A3ODD0n1oCFr2oRw7BvspOYdcKw@mail.gmail.com>
On Mon, Mar 22, 2021 at 03:34:23PM +0400, Marc-André Lureau wrote:
> On Mon, Mar 22, 2021 at 2:59 PM Marc-André Lureau <
> marcandre.lureau@redhat.com> wrote:
>
> > Hi
> >
> > On Mon, Mar 22, 2021 at 2:52 PM <marcandre.lureau@redhat.com> wrote:
> >
> >> From: Marc-André Lureau <marcandre.lureau@redhat.com>
> >>
> >> 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 simplify "Edit on Gitlab" links.
> >>
> >> Tweak a bit the custom theme to match qemu.org style, use the
> >> QEMU logo, and favicon etc.
> >>
> >> Screenshot:
> >>
> >> https://i.ibb.co/XWwG1bZ/Screenshot-2021-01-20-Welcome-to-QEMU-s-documentation-QEMU-documentation.png
> >
> >
> > Sorry, this link is outdated now. Here is a more stable one:
> >
> > https://elmarco.fedorapeople.org/Screenshot_2021-03-22%20Welcome%20to%20QEMU%e2%80%99s%20documentation%20%e2%80%94%20QEMU%20documentation.png
> >
> >
> What about simplifying the various section titles?
> https://elmarco.fedorapeople.org/Screenshot_2021-03-22%20Welcome%20to%20QEMU%e2%80%99s%20documentation%20%e2%80%94%20QEMU%20documentation(1).png
I think that makes sense, now that we have everything merged
into one doc, and certainly makes the nav look nicer.
Regards,
Daniel
--
|: https://berrange.com -o- https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org -o- https://fstop138.berrange.com :|
|: https://entangle-photo.org -o- https://www.instagram.com/dberrange :|
next prev parent reply other threads:[~2021-03-22 12:23 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-03-22 10:52 [PATCH v4] sphinx: adopt kernel readthedoc theme marcandre.lureau
2021-03-22 10:59 ` Marc-André Lureau
2021-03-22 11:34 ` Marc-André Lureau
2021-03-22 12:14 ` Daniel P. Berrangé [this message]
2021-03-23 10:27 ` Daniel P. Berrangé
2021-03-23 11:00 ` Peter Maydell
2021-03-23 11:12 ` Marc-André Lureau
2021-03-23 11:29 ` Daniel P. Berrangé
2021-03-23 11:36 ` Peter Maydell
2021-03-23 11:37 ` Marc-André Lureau
2021-03-23 11:05 ` Marc-André Lureau
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=YFiKL6AwirjdgSWM@redhat.com \
--to=berrange@redhat.com \
--cc=bmeng.cn@gmail.com \
--cc=jsnow@redhat.com \
--cc=marcandre.lureau@redhat.com \
--cc=peter.maydell@linaro.org \
--cc=qemu-devel@nongnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).