Red Hat Bugzilla – Bug 647352
RFE: Publican Desktop RPMs --> Enhanced Menuing
Last modified: 2010-12-07 22:49:20 EST
Description of problem: Currently when someone views the documentation on the desktop the entry is placed (for example Install guide and security guide): System => Documentation => Red Hat Enterprise Linux 6: Installation Guide System => Documentation => Red Hat Enterprise Linux 6: Security Guide Is it possible to request an enhancement in the next version of publican where the menuing looks like this: System => Documentation => Red Hat Enterprise Linux 6 => Installation Guide System => Documentation => Red Hat Enterprise Linux 6 => Security Guide Use Case Justification: ====================== With Red Hat Enterprise Linux 6 there will be 23 pieces of documentation and that is a lot of desktop space if the user also has JBoss Enterprise Application Platform 4.3 which has 33 pieces of documentation. Collapsing by ProductVer makes the navigation clearer. Urgency: ======= Low
You need to talk to the desktop team to get the initial requirements of this enabled. The menu is controlled by files in /usr/share/desktop-directories, AIUI you'd need to get a <prod>.directory file for each product, then configure the desktop files to use the right Categories. There maybe another way to do this, but again you'd need to talk to the desktop team to determine the best approach. Cheers, Jeff.
Created attachment 457074 [details] Screenshot of Several Product Documentation Set
Okay, thanks Jeff, will do.
Hi Mike, turns out I was wrong and this can probably be done by: 1: having a menu RPM for each product, containing A: .directory file B: .menu file C: icon 2: adding a parameter to the publican cfg file to set the dep 3: adding a parameter to the publican cfg file to set the Category 4: modify spec xsl to set new parameters It's probably possible to have version level directories as well using this approach.
The approach I took to this was to assume that the menu structure, .directory and .menu files, would be managed outside of publican, and that the user would inform publican what the details are. To achieve this I added two new options to the config file, dt_requires and menu_category. dt_requires would be set to the name of the RPM containing the product menu. menu_category would be set to a Category defined in a .menu file in that RPM. It may be necessary to add some smarts to handle language, versions, etc, but we won't know this until we get feedback from the users. Note: if there is only one entry for a sub-Category on the Documentation menu, then the entry it will appear directly on Documentation menu, not in a sub-menu. e.g. if you had a sub menu name Foo-2.0 then you would need to install 2 or more Foo-2.0 books to get the Foo-2.0 sub menu displayed. FYI I checked in an example of how to make a docs menu package at http://svn.fedorahosted.org/svn/publican/trunk/menu_example Fixed in build: 2.3-0%{?dist}.t45
Publican 2.4 has shipped with a fix for this issue.