OMF files

Thom May thom at ubuntu.com
Wed Mar 2 19:47:37 UTC 2005


Hi there,
I've been looking at the OMF situation to try and track down why yelp isn't
displaying docs, and noticed some problems:
The major one is that you're installing OMF files as
/usr/share/omf/foo/bar.omf . Best practice is to encode the language code 
into the OMF file, so you can handle translations; eg:
/usr/share/omf/ubuntu-docs/about-ubuntu-C.omf
Also, you need to make use of `scrollkeeper-get-content-list C` to ensure
that your documents are going to be listed where you expect by scrollkeeper,
if at all.
The following patch to about-ubuntu.omf gets the About Ubuntu document into
Yelp.
Cheers,
-Thom

Index: debian/about-ubuntu.omf
===================================================================
--- debian/about-ubuntu.omf     (revision 639)
+++ debian/about-ubuntu.omf     (working copy)
@@ -8,7 +8,7 @@
     <title>About Ubuntu</title>
     <date>2005-02-28</date>
     <version identifier="0.9" date="2005-02-28" description="First release for Ubuntu 5.4 Hoary"/>
-    <subject category="Core|Distributions|General|Introductory"/>
+    <subject category="General|Linux|Distributions|Other"/>
     <description>Short description of the Hoary Ubuntu system</description>
     <type>introduction</type>
     <format mime="text/xml" dtd="-//OASIS//DTD DocBook XML V4.1.2//EN"/>




More information about the ubuntu-doc mailing list