GNOME Bugzilla – Bug 404234
switch evo user docs to proper menu item markup
Last modified: 2009-07-23 16:26:02 UTC
from the evince docu, for example: "choose <menuchoice><guimenu>File</guimenu><guimenuitem>Properties</guimenuitem></menuchoice>". see those brackets? get rid of the "File > New" stuff, make that <menuchoice><guimenu>File</guimenu><guimenuitem>New</guimenuitem></menuchoice> for better readability.
Evolution user guide is written using FRAMEMAKER 7.0 and export the framefile to XML. When "File > New" [Here at Novell,Doc writers are following Novell Documentation convention,according to which, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path.]in the frame file is exported to XML, it creates "File > New" stuff in the XML file. Let me find out any other possible way to replace ">" symbol in the Doc while refering to actions and cross ref path. Thanks:-)
it's not only about the ">". it's about properly marking menuitems as such.
Please do specify the bugs in the doc:-)
Comment not clear :-(
it is NOT only about changing the ">" stuff. it is about marking commands as command by using markup language, as you can see in comment 0, so they can be rendered differently in yelp.
R&D from my side: Expecting suggestions I was going through the GNOME Style guide and GNOME user doc at http://www.gnome.org/learn/users-guide/2.2/ch02s03.html. It has " Add to Panel → Main Menu " "To add a new launcher to a panel, right-click on a vacant space on the panel, then choose Add to Panel → Launcher" in it. I would like to know you prefer that or just say " Choose Add to Panel and select Launcher"
I also searched in Google to find the location from where I can download the XML source for GNOME User Guide to understand the tag they have used for mark-up. My search ended up in nothing but http://svn.gnome.org/viewvc/. I cannot find what I want;-( Appreciate help here....
(In reply to comment #7) > I also searched in Google to find the location from where I can download the > XML source for GNOME User Guide to understand the tag they have used for > mark-up. > > My search ended up in nothing but http://svn.gnome.org/viewvc/. I cannot find > what I want;-( > > Appreciate help here.... you can view, but you cannot check out from http://svn.gnome.org/viewvc/gnome-user-docs/trunk/gnome2-user-guide/ , you can however check out by using svn.
Thanks a bunch, I could successfully check-out the source. Now I can do a better R&D on tags by comparing the user guides for both Evolution and GNOME..
Bumping version to a stable release.
i'm working on this, along with some other changes.
Any progress Andre? I intended to tackle this (and many other markup tags) after I got the rest of the user docs proofread. Course at the rate I'm going that could be late 2009.
No, no work going on. Matthew: I sent you "what I have" on 16 Apr 2008 which is of course outdated now... :)
Have been working on this for the last week. Going to commit my stuff once Evolution has been branched for 2.27. See bug 588982. *** This bug has been marked as a duplicate of 588982 ***