[01:39] <j1mc> hey all
[01:40] <j1mc> hey jjesse
[20:35] <achiang> hello, i'm looking for a pointer on how to properly modify the help displayed by yelp (on an older version, lucid). specifically, i'd like to add a link to a PDF installed somewhere on the system.
[20:35] <achiang> i'm getting lost in all the XML
[20:40]  * achiang wonders if j1mc might have any clues. micahg said you might...
[20:42] <j1mc> hi achiang
[20:42] <achiang> hi
[20:43] <j1mc> achiang: you want the ubuntu help to open a pdf for all ubuntu users, or you just want it on your own system?
[20:44] <achiang> j1mc: well, we can assume it's just for me right now, that it's not really an upstreamable change.
[20:45] <achiang> j1mc: but to talk in terms of code and patches, i'm looking at 04_new_ubuntu_layout.patch in yelp_2.30.0-0ubuntu2, and not seeing how to extend the examples there to add an extra link to a PDF file
[20:46] <achiang> j1mc: i don't want to completely replace the help, actually. just add a new link that says, "hey, check this PDF out for more info"
[20:47] <j1mc> achiang: well, we are really only doing bug-fixes on older releases... but... as for how to do it, i'd need to take a look at the file.
[20:47] <j1mc> could you give me the file name?
[20:48] <achiang> j1mc: right, so like i said, this isn't suitable for upstream...
[20:50] <achiang> j1mc: i guess i don't really have a file name right now, just trying to understand the general technique. i guess we could assume /usr/share/doc/achiang/foo.pdf
[20:50] <j1mc> still, the file name would be helpful
[20:51] <achiang> ah, interesting, there is a file named /usr/share/gnome/help/system-admin-guide/C/system-admin-guide.pdf
[20:51] <achiang> j1mc: we can use the above as an example?
[20:52] <j1mc> achiang: i'm looking... thanks for your patience
[20:53] <achiang> j1mc: i appreciate any help you can offer, so thank you!
[20:56] <j1mc> achiang: if you want to include your link in the help browser, you'd want to do something like this:
[20:57] <j1mc> <ulink url="file://path/to/file.pdf">open the file</ulink>
[20:57] <j1mc> in the native docbook of the ubuntu help
[20:58] <j1mc> but yelp isn't set up to look at your home directory by default
[20:58] <j1mc> ... so ... i'd be wary of making changes to any text in your /usr directory
[20:58] <j1mc> are you doing this just for yourself?
[21:00] <achiang> j1mc: i think i understand what you are saying -- if i change the text in the /usr directory, and point it to a path in my home directory, the link won't work for other users?
[21:00] <j1mc> well, that's one thing, but it's also just not recommended to modify content in the /usr directory
[21:01] <j1mc> i mean, for a user to modify content in the /usr directory
[21:01] <achiang> j1mc: right, got it
[21:02] <achiang> j1mc: thank you for your help
[21:02] <j1mc> do you know how to get the latest docbook sources for what you want to do? are you trying to build this out for other users?
[21:03] <achiang> j1mc: well, i'm kinda working on a derivative distribution of sorts, so... it would be for other users eventually, but not via a PPA or a web page or anything like that
[21:04] <j1mc> ok
[21:05] <achiang> j1mc: i'm actually staring at the yelp package, but not entirely sure what to modify. it sounds like there is separate docbook source i could modify?
[21:05] <j1mc> you can use that ulink feature to link to any file, though. you'd need to modify the docbook to do what you want to do, though.
[21:05] <j1mc> best of luck... let us know if you have more questions
[21:33] <j1mc> hi glatzor
[21:33] <j1mc> hi MrChrisDruif
[21:33] <MrChrisDruif> Aloha j1mc :)
[21:34] <MrChrisDruif> How's it going?
[21:34] <j1mc> :)
[21:37] <MrChrisDruif> Well?
[21:38] <j1mc> just saying hello
[21:38] <MrChrisDruif> xD
[21:38] <MrChrisDruif> And I'm just asking how it goes :P
[21:39] <j1mc> oh, it is going fine, thanks. :)
[21:39] <j1mc> you?
[21:40] <MrChrisDruif> Pretty good :D