Red Hat Bugzilla – Bug 836423
Publican 3.0 creates tabs labelled "UNUSED" for unversioned content
Last modified: 2014-10-14 00:10:04 EDT
Description of problem:
When we use the web_version_label: UNUSED parameter to indicate that documentation is not specific to any one particular release of a product, Publican 3.0 creates a tab labelled "UNUSED" on the product navigation page.
Worse, if different documents were created with different product versions and were had web_version_label: UNUSED set, Publican 3.0 creates multiple "UNUSED" tabs.
Version-Release number of selected component (if applicable):
Steps to Reproduce:
1. Set web_version_label: UNUSED on a book, build it, and install it on a Publican-generated website
2. set web_version_label: UNUSED on a book with the same product but a different product version, build it, and install it on a Publican-generated website
3. navigate to the product page
Two tabs labelled "UNUSED", each with one book
Books that are not version-specific should appear on the version tab for each version of that product.
Verified this problem against OpenShift books, which don't use web labels.
Maybe we could do some sort of check to see if the "web_version_label" actually existed in publican.cfg and then create (or not) the Version tab based on that. That way instead of:
Product Documentation > OpenShift > UNUSED > $book_name
we could see the following:
Product Documentation > OpenShift > $book_name
Not sure what to do about the "UNUSED" box in the top right; does it do anything?
It would make sense that unversioned books need some identifying label. Since the web_version_label is now passed through to the Publican website as a literal string value, you could set web_version_label to "All Versions".
It would rely on books with the same string value being rendered in the same version tab.
(In reply to comment #1)
> Product Documentation > OpenShift > $book_name
> Not sure what to do about the "UNUSED" box in the top right; does it do
Based on Rudi's comment above yours ("Books that are not version-specific should appear on the version tab for each version of that product.") it seems we aren't going to get that functionality back.
Does anyone know what item in the Changes file this change (handling web_version_label as a string literal) was listed under? I couldn't see it.
(In reply to comment #3)
> Does anyone know what item in the Changes file this change (handling
> web_version_label as a string literal) was listed under? I couldn't see it.
web_version_label has always been a string literal, web_style_1 has logic to adjust the html style in the nav toc. This logic simply doesn't work on web_style 2.
We're waaaay past this now :)