GNOME Bugzilla – Bug 694675
gnome-getting-started-docs-3.12 content does not show up properly
Last modified: 2015-08-10 21:59:45 UTC
Mallard content from gnome-getting-started-docs-3.7 is not correctly uploaded to the help.gnome.org website: http://help.gnome.org/users/getting-started/3.7/index.html.en The gnome-getting-started-docs-3.7 tarballs are at: http://ftp.gnome.org/pub/GNOME/sources/gnome-getting-started-docs/3.7/ Issues worth mentioning: * Some .page files are not included on the index.html.en page: browse-web.page, use-search.page, switching-tasks.page) Source .page files can be found here: http://git.gnome.org/browse/gnome-getting-started-docs/tree/getting-started/C?id=3.7.90 * Included SVGs do not show up, eg.: http://help.gnome.org/users/getting-started/3.7/online.html.en Source .page file: http://git.gnome.org/browse/gnome-getting-started-docs/tree/getting-started/C/online.page?id=3.7.90 * Boxes with subtitles shown below the videos are left aligned, eg.: http://help.gnome.org/users/getting-started/3.7/move-windows.html.en
Another issue is that videos (figures/gnome-launching-applications.webm, figures/gnome-task-switching.webm, figures/gnome-responding-to-messages.webm) included in the index.page with ui:overlay and <media> are not shown on the website as expected, that is in overlay mode.
With the recent change of the install dir for getting-started, the getting-started files are now extracted into help.gnome.org/users/gnome-help/, see eg. the getting started landing page: https://help.gnome.org/users/gnome-help/3.8/getting-started.html.en However, the aforementioned issues still occur.
Lots of commits today and I believe this issue is now addressed correctly.
The issue seems to be still present in 3.12: https://help.gnome.org/users/gnome-help/3.12/ There is no link to https://help.gnome.org/users/gnome-help/3.12/getting-started.html.en from the landing page. Although, https://help.gnome.org/users/gnome-help/3.12/getting-started.html.en contains a link to https://help.gnome.org/users/gnome-help/3.12/ as expected.
https://help.gnome.org/users/gnome-help/3.12/index.html.en now has a link to https://help.gnome.org/users/gnome-help/3.12/getting-started.html.en but that page is empty. From a first look I'd say it's because of gnome-getting-started-docs fcaafe86270d281106f5e497e92d64a4eb647d84, as it introduced a condition on the page. +<if:choose> +<if:when test="!platform:gnome-classic">
It looks like being empty was actually an epiphany bug, the page looks fine in chromium.
Checked with Petr, it's now fine.
Sadly, the bug is still present in all recent releases: https://help.gnome.org/users/gnome-help/3.14/ https://help.gnome.org/users/gnome-help/3.12/ https://help.gnome.org/users/gnome-help/3.10/ https://help.gnome.org/users/gnome-help/3.8/ Moreover, https://help.gnome.org/users/gnome-help/3.14/getting-started.html.en is unavailable, so it looks like gnome-getting-started-docs files have not been properly installed on the server. https://help.gnome.org/users/gnome-help/3.12/getting-started.html.en works fine.
Update: after releasing gnome-getting-started-docs 3.14.1, the content is now integrated with and available from the gnome-help landing page: https://help.gnome.org/users/gnome-help/3.14/index.html.en However, the issue has not been fixed for previous releases. I suspect the content gets integrated properly only when we first make a release for gnome-user-docs, and then for gnome-getting-started-docs. When we first release gnome-getting-started-docs and then gnome-user-docs, the gnome-help index page is recreated without integration and the link to getting-started gets overwritten.
Yeah for GUADEC; gnome-getting-started-docs and gnome-user-docs are in different modulesets and they failed to combine. This is now fixed for good. commit 45f831c95e01b058d6148ea2e9a526d103f22118 Author: Frédéric Péters <fpeters@0d.be> Date: Mon Aug 10 16:08:46 2015 +0200 mallard: fix combination of modules from different modulesets https://bugzilla.gnome.org/show_bug.cgi?id=694675