Skip to content

Re-design the QEMU home page to better present information

Daniel P. Berrangé qemu-devel 2 versions – In review

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v2 Latest16 patches 8 repliesIn review
  2. v17 patches 7 repliesSuperseded

Patches in v2 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/16Convert files to UNIX line endingsassets/css/style-desktop.css assets/css/style-mobile.css assets/css/style.css +1 more+1349 -13491 reply
2/16gitlab: introduce a CI job to publish the site content.gitlab-ci.yml+16 -00 replies
3/16make all links be relative to the root_includes/assets.html _includes/copyright.html _includes/footer.html +9 more+53 -370 replies
4/16Make page header nav narrower_includes/nav.html assets/css/style-desktop.css+3 -21 reply
5/16Introduce support for "bxslider" jquery add on_includes/assets.html assets/css/jquery.bxslider.css assets/js/jquery.bxslider.js+1790 -00 replies
6/16Rework display of screenshots to use a carousel slider_data/screenshots.yml _includes/screenshot.html assets/css/style.css +1 more+41 -272 replies
7/16Compress the two front page headings into oneindex.html+1 -50 replies
8/16Simplify copyright and integrate into footer_includes/copyright.html _includes/footer.html _layouts/blog.html +4 more+16 -290 replies
9/16Put a full SFC membership blurb in footer of every page_includes/footer.html assets/css/style.css index.html+8 -50 replies
10/16Use two column layout to display screenshots and releasesassets/css/style-desktop.css assets/css/style-mobile.css assets/css/style.css +1 more+85 -270 replies
11/16Bring contribution links out of the footer into the home page_includes/footer.html index.html+8 -71 reply
12/16Add recent blog posts to the front page featured contentassets/css/style.css index.html+17 -00 replies
13/16Move wiki link from footer into the header navbar_includes/footer.html _includes/nav.html+1 -10 replies
14/16Simplify and restructure the page footer_includes/footer.html assets/css/style-desktop.css assets/css/style-mobile.css +1 more+21 -610 replies
15/16Add link to "page source" for all pages_includes/footer.html assets/css/style.css+8 -10 replies
16/16Add a CONTRIBUTING.md file as guidance for contributorsCONTRIBUTING.md _config.yml+33 -00 replies

Reviews trailers per patch

3 of 16 patches have a Reviewed-by or Acked-by.

PatchKashyap ChamarthyThomas Huth
1/16
2/16
3/16
4/16R-b
5/16
6/16R-b
7/16
8/16
9/16
10/16
11/16R-b
12/16
13/16
14/16
15/16
16/16

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v2 thread

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

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