| Message ID | 20201027132015.621733-1-berrange@redhat.com |
|---|---|
| Headers | show |
| Series | Re-design the QEMU home page to better present information | expand |
I am going to apply patches 1-3, so that I can play with doing the final deployment via gitlab pipelines. 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 > >
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 :|
On 13/01/21 15:57, Daniel P. Berrangé wrote: > 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. Done, thanks! Paolo