[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH 4/4] docs: add "page source" link to sphinx documentation
From: |
Daniel P . Berrangé |
Subject: |
Re: [PATCH 4/4] docs: add "page source" link to sphinx documentation |
Date: |
Mon, 2 Nov 2020 14:23:43 +0000 |
User-agent: |
Mutt/1.14.6 (2020-07-11) |
On Mon, Nov 02, 2020 at 01:52:04PM +0000, Peter Maydell wrote:
> On Mon, 2 Nov 2020 at 13:09, Daniel P. Berrangé <berrange@redhat.com> wrote:
> >
> > Add a link to the top of the sidebar in every docs page that takes the
> > user back to the source code in gitlab.
>
> This doesn't exactly link back to the source code, which is a bit
> confusing I think. Eg the 'page source' link in
> https://berrange.gitlab.io/qemu/system/quickstart.html
> goes to
> https://gitlab.com/qemu-project/qemu/-/blob/master/docs/system/quickstart.rst
>
> which is a gitlab rendered version of the rST, not a view of
> the actual sources. Is it possible to link directly to an
> "actually the source code" view?
At the top of that page there are two buttons for switching between the
rendered view and source view. I don't think they're directly linkable
as it is switched with javascript.
At least the user can see exactly what source filename is involved though,
which was the key goal I had.
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 :|
- Re: [PATCH 2/4] gitlab: force enable docs build in Fedora, Ubuntu, Debian, (continued)
- [PATCH 3/4] docs: show stdout/stderr when meson fails build test, Daniel P . Berrangé, 2020/11/02
- [PATCH 4/4] docs: add "page source" link to sphinx documentation, Daniel P . Berrangé, 2020/11/02
- Re: [PATCH 0/4] Publish docs as GitLab Pages, Philippe Mathieu-Daudé, 2020/11/02
- Re: [PATCH 0/4] Publish docs as GitLab Pages, Thomas Huth, 2020/11/09