[01:39] hey all [01:40] hey jjesse === issyl0 is now known as Guest81619 === Guest81619 is now known as issyl0 [20:35] 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] i'm getting lost in all the XML [20:40] * achiang wonders if j1mc might have any clues. micahg said you might... [20:42] hi achiang [20:42] hi [20:43] 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] j1mc: well, we can assume it's just for me right now, that it's not really an upstreamable change. [20:45] 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] 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] 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] could you give me the file name? [20:48] j1mc: right, so like i said, this isn't suitable for upstream... [20:50] 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] still, the file name would be helpful [20:51] ah, interesting, there is a file named /usr/share/gnome/help/system-admin-guide/C/system-admin-guide.pdf [20:51] j1mc: we can use the above as an example? [20:52] achiang: i'm looking... thanks for your patience [20:53] j1mc: i appreciate any help you can offer, so thank you! [20:56] achiang: if you want to include your link in the help browser, you'd want to do something like this: [20:57] open the file [20:57] in the native docbook of the ubuntu help [20:58] but yelp isn't set up to look at your home directory by default [20:58] ... so ... i'd be wary of making changes to any text in your /usr directory [20:58] are you doing this just for yourself? [21:00] 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] well, that's one thing, but it's also just not recommended to modify content in the /usr directory [21:01] i mean, for a user to modify content in the /usr directory [21:01] j1mc: right, got it [21:02] j1mc: thank you for your help [21:02] 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] 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] ok [21:05] 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] 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] best of luck... let us know if you have more questions [21:33] hi glatzor [21:33] hi MrChrisDruif [21:33] Aloha j1mc :) [21:34] How's it going? [21:34] :) [21:37] Well? [21:38] just saying hello [21:38] xD [21:38] And I'm just asking how it goes :P [21:39] oh, it is going fine, thanks. :) [21:39] you? [21:40] Pretty good :D