Gnome 3.0 help documentation is based on the new topic-based Mallard documentation format created by Shaun McCance. The Yelp help browser and Gnome documentation utilities already support Mallard format.
Creating a Mallard Document
In this post we will use Shaun's Ten Minute Tour to create a multi-page Mallard document.Mallard documents use a '.page' extension. The 'Beanstalk' application help needs a guide page (index.page) and a topic page (planting.page). Make a new directory named 'beanstalk' and create the two files with following content using your favorite text editor.
# index.page
<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="index">
<title>Beanstalk Help</title>
</page>
# planting.page
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="planting">
<info>
<link type="guide" xref="index"/>
</info>
<title>Planting Beans</title>
<p>By the end of this page, you will be able to plant your magic
beans and nurture them into a bean sprout.</p>
<steps>
<item><p>Dig a hole 5cm deep.</p></item>
<item><p>Place your magic beans in the hole.</p></item>
<item><p>Fill the hole with clean dirt and pat it level.</p></item>
<item><p>Water daily.</p></item>
</steps>
</page>
$yelp file:///tmp/beanstalk/
Adding to Gnome Help system
The next step is make it part of the Gnome help system. Here we are copying the beanstalk help files manually to folder where gnome help file are stored.
$ sudo mkdir /usr/share/gnome/help/beanstalk
$ sudo mkdir /usr/share/gnome/help/beanstalk/C
$ sudo cp beanstalk/ /usr/share/gnome/help/beanstalk/C/ -rfv
`beanstalk/' -> `/usr/share/gnome/help/beanstalk/C'
`beanstalk/index.page' -> `/usr/share/gnome/help/beanstalk/C/index.page'
`beanstalk/planting.page' -> `/usr/share/gnome/help/beanstalk/C/planting.page'
We are done! You can now access beanstalk help by calling 'yelp ghelp:beanstalk' from your application or via Yelp search.
No comments:
Post a Comment
You can leave a comment here using your Google account, OpenID or as an anonymous user.