Re: [qemu-web PATCH v2 00/16] Re-design the QEMU home page to better present information

[Daniel P . Berrangé]

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 :|