[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [qemu-web PATCH v2 00/16] Re-design the QEMU home page to better pre
From: |
Daniel P . Berrangé |
Subject: |
Re: [qemu-web PATCH v2 00/16] Re-design the QEMU home page to better present information |
Date: |
Wed, 13 Jan 2021 14:57:12 +0000 |
User-agent: |
Mutt/1.14.6 (2020-07-11) |
On Wed, Jan 13, 2021 at 03:54:51PM +0100, Paolo Bonzini wrote:
> I am going to apply patches 1-3, so that I can play with doing the
> final deployment via gitlab pipelines.
Probably worth taking the 16th patch too, since the CONTRIBUTING
file described how to use the CI results.
>
> On Tue, Oct 27, 2020 at 2:20 PM Daniel P. Berrangé <berrange@redhat.com>
> wrote:
> >
> > This is a v2 of:
> >
> > https://lists.gnu.org/archive/html/qemu-devel/2020-10/msg07025.html
> >
> > This series started off as a desire to add an "Edit page" link to every
> > page on the site. In doing this I felt that the footer would benefit
> > from simplication so that it was not a massive wall of links,
> > duplicating links elsewhere in the navigation or content pages. Then
> > after response to v1, I realized that the home page actually needed
> > alot more design work to better present information to contributors
> > immediately.
> >
> > The key theme was to ensure that the home page of the website has all
> > the important information available on screen without requiring the
> > user to scroll down or otherwise search for it.
> >
> > I also add gitlab CI jobs so that users can push a branch to gitlab and
> > then browse the rendered result.
> >
> > eg see this pipeline:
> >
> > https://gitlab.com/berrange/qemu-web/-/pipelines/208194087
> >
> > and the rendered result of this series:
> >
> > https://berrange.gitlab.io/qemu-web/
> >
> > Or browsable at
> >
> >
> > https://gitlab.com/berrange/qemu-web/-/jobs/814392582/artifacts/browse/publ=
> > ic/
> >
> > Or download ZIP at
> >
> > https://gitlab.com/berrange/qemu-web/-/jobs/814392582/artifacts/download
> >
> > notice how the resulting content needs to cope with being used from a
> > variety of different paths. IOW, we cannot use absolute hyperlinks that
> > assume the root is "/". Jekyll doesn't make this easy, so we use a hack
> > with a custom template that sets a variable we can then reference.
> >
> > The logical next step for this would be to accept merge requests, so
> > that once the user saves their edits in gitlab, they can directly submit
> > a MR, instead of sending via email. I noticed we don't currently have a
> > CONTRIBUTING.md file in qemu-web.git telling people how to submit. So
> > this series includes such a file directing people to send patches via
> > email for now.
> >
> > Daniel P. Berrang=C3=A9 (16):
> > Convert files to UNIX line endings
> > gitlab: introduce a CI job to publish the site content
> > make all links be relative to the root
> > Make page header nav narrower
> > Introduce support for "bxslider" jquery add on
> > Rework display of screenshots to use a carousel slider
> > Compress the two front page headings into one
> > Simplify copyright and integrate into footer
> > Put a full SFC membership blurb in footer of every page
> > Use two column layout to display screenshots and releases
> > Bring contribution links out of the footer into the home page
> > Add recent blog posts to the front page featured content
> > Move wiki link from footer into the header navbar
> > Simplify and restructure the page footer
> > Add link to "page source" for all pages
> > Add a CONTRIBUTING.md file as guidance for contributors
> >
> > .gitlab-ci.yml | 16 +
> > CONTRIBUTING.md | 32 +
> > _config.yml | 1 +
> > _data/screenshots.yml | 14 +-
> > _includes/assets.html | 32 +-
> > _includes/copyright.html | 8 -
> > _includes/footer.html | 33 +-
> > _includes/nav.html | 13 +-
> > _includes/relative_root.html | 12 +
> > _includes/screenshot.html | 8 +-
> > _includes/sidebar.html | 6 +-
> > _layouts/archive.html | 4 +-
> > _layouts/blog.html | 4 +-
> > _layouts/home.html | 2 +-
> > _layouts/page.html | 2 +-
> > assets/css/jquery.bxslider.css | 179 ++++
> > assets/css/style-desktop.css | 581 ++++++------
> > assets/css/style-mobile.css | 720 +++++++-------
> > assets/css/style.css | 1252 +++++++++++++------------
> > assets/js/jquery.bxslider.js | 1607 ++++++++++++++++++++++++++++++++
> > blog/index.html | 4 +-
> > index.html | 195 ++--
> > 22 files changed, 3312 insertions(+), 1413 deletions(-)
> > create mode 100644 .gitlab-ci.yml
> > create mode 100644 CONTRIBUTING.md
> > delete mode 100644 _includes/copyright.html
> > create mode 100644 _includes/relative_root.html
> > create mode 100644 assets/css/jquery.bxslider.css
> > create mode 100644 assets/js/jquery.bxslider.js
> >
> > --=20
> > 2.26.2
> >
> >
>
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 :|