html ubuntu.xsl file non-existant class

Bug #1417906 reported by Doug Smythies on 2015-02-04
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Ubuntu Documentation
Status tracked in Trunk
Precise
Undecided
Doug Smythies
Trunk
Undecided
Doug Smythies
Trusty
Undecided
Doug Smythies
Utopic
Undecided
Doug Smythies
Ubuntu Server Guide
Undecided
Doug Smythies

Bug Description

Within the html page definitions template in html/ubuntu.xsl for desktop help and in libs/ubuntu.xsl for the serverguide exist div definitions where
there is no related build definition that ends up in the css file.
Therefore the lines are useless, leading to added confusion with something that is already almost impossible to understand.

Examples:

(Desktop-help only):
<div class="subheader-menu">
</div>

(Both)
<div id="leftbanner">
</div>

(Both)
<div id="rightbanner">
</div>

The ripple efffect, includes the help.ubuntu.com glue files and the clouddocs files which have taken the resulting html as a template for their manual coding.

This needs to be cleaned up.

If possible, the basic template code should be identical for the desktop help and the serverguide. Beyond the above mentioned "subheader-menu", which will be deleted, that leaves only <div id="subheader">, which while defined in the rsulting css file, remains unclear as to why it is needed. (i.e. serverguide rendering seems identical to desktop help without it.)And note that if it is added to the serverguide, the resulting css file still doesn't end up with the definition. (keep in mind the html build stuff is a little different between the two projects.)

Changed in ubuntu-docs:
status: New → In Progress
assignee: nobody → Doug Smythies (dsmythies)
description: updated
Changed in serverguide:
status: New → In Progress
assignee: nobody → Doug Smythies (dsmythies)
Doug Smythies (dsmythies) wrote :

Among other things in the ubuntu.xsl files, the basic html page template seems to have been copied from the helpwiki-light-moin-theme code on or about 2011.10. I don't know that it was ever reviewed for needed or not needed content. Anyway, it bears little resemblance now.

Beyond style sheet usage, other uses for div tags with "id"s are later references by a hyperlink or applet or other automated processes. I just don't see those uses in these cases as being practical. So, I believe these things started as a mess and have continued to propagate as a mess. Now some do make sense, i.e.:

<div id="pagebottom">
</div>

If it is actually referenced or not, I don't know, but the plan is to leave it (and similar ones).

Changed in serverguide:
status: In Progress → Fix Committed
Changed in serverguide:
status: Fix Committed → Fix Released
To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers