=== ubotu [n=ubotu@ubuntu/bot/ubotu] has joined #ubuntu-doc === jono_ [n=jono@88-107-9-30.dynamic.dsl.as9105.com] has joined #ubuntu-doc === merriam_ [n=merriam@84-12-20-189.dyn.gotadsl.co.uk] has joined #ubuntu-doc === bodhi_zazen [n=bodhizaz@stpete.helmednet.org] has joined #ubuntu-doc === jjesse [n=jjesse@adsl-69-209-105-90.dsl.klmzmi.ameritech.net] has joined #ubuntu-doc === bhuvan [n=bhuvan@ubuntu/member/bhuvan] has joined #ubuntu-doc === jjesse [n=jjesse@adsl-69-209-105-90.dsl.klmzmi.ameritech.net] has joined #ubuntu-doc === Admiral_Chicago_ [n=Freddy@adsl-68-72-80-116.dsl.chcgil.ameritech.net] has joined #ubuntu-doc === Admiral_Chicago_ [n=Freddy@adsl-68-72-80-116.dsl.chcgil.ameritech.net] has joined #ubuntu-doc === wakr [n=Diwaker@116.68.208.84] has joined #ubuntu-doc [05:24] hello === wakr [n=Diwaker@116.68.208.84] has left #ubuntu-doc [] === Madpilot [n=brian@ubuntu/member/madpilot] has joined #ubuntu-doc === BORG [n=kerric@c-68-36-179-163.hsd1.pa.comcast.net] has joined #ubuntu-doc === willvdl [n=will@dsl-145-216-235.telkomadsl.co.za] has joined #ubuntu-doc === fijam [n=fijam@unaffiliated/fijam] has joined #ubuntu-doc [10:50] hey there fijam [10:51] have you been able to understand anything of the documentation / writing it? [10:52] I do not quite get the rules of making the output html files out of docbook [10:52] And is it e.g supposed to work in yelp, or should it just work in a browser [10:54] I should have posted my questions to the mailing list I guess, but had no time/mind to do this. Next week I should finally have plenty of time. [10:55] fijam: both [10:55] it works with anything that can handle HTML [10:56] 'cause as it is now, the links to chapters in yelp won't work [10:56] neither for ubuntu, nor for xubuntu [10:57] I am working on a clean svn pull, and I doubt if I was already able to screw something up. [11:00] and since the links currently point to .html files, instead of .xml files, I bagan to thing that only html output matters. Apparently, I was wrong. [11:02] Admiral_Chicago, how is it supposed to work then? [11:07] fijam: give me a second [11:07] sure. [11:08] fijam: right now, we had the docs working by pulling them in Firefox [11:08] this is probably broken as we recently moved the Ubuntu docs to the Xubuntu folder [11:08] i don't know if it is broken though [11:11] Since documentation in 'ubuntu' behaves in the same way, I presume that is how it works. As far as I managed to figure it out, the process of making a patch boils down to editing the xml file, validating it, building it to a .html file, checking if it's right and finally using diff to make a patch. I'd be happy though if someone could say how wrong I am. [11:14] To cut the long story short, my biggest concern is whether documentation should be usable in a docbook viewer or is just docbook format a tool of storing and managing the documentation under development. [11:15] And if it's not, how the links should be fixed. [11:15] does it make sense? [11:18] fijam: all you need to do is svn diff > mypatchforsection.diff [11:18] if it is a simple change [11:19] of course validating is also important if you are committing. if not, it isn't (but it is a good practice to follow) [11:20] certainly. [11:20] the docbook format is really a syntax for writing. It should be used to write it but because we are using docbook / XML, we can easily export it to a HTML file [11:21] fijam: to answer your question docbook/xml is both [11:21] so we need to fix the links. [11:27] ah i see your question [11:28] i'll have to think about that, i think you're question is a non issue though [11:28] what do you mean? [11:29] afaik, this is all done when the docs are compiled (maybe by the MAKE file) which may not be how you are doing it [11:32] Admiral_Chicago, output html files are fine. I just wonder what about raw docbook files. === jono [n=jono@ubuntu/member/jono] has joined #ubuntu-doc [11:39] hmm dunno fijam [11:40] I'll ask on the ML. [11:44] okay [11:44] good idea === Knightlust [n=Dax@ubuntu/member/knightlust] has joined #ubuntu-doc [12:33] how did you output html from the docbook?? [12:34] the make files for me failed due to the move to the topic based help system [12:36] (I have copied the serverguide and changed it to mobileguide , edited the xml and validated using the script and yelp...i then built the pdf with xml2pdf but i am not sure about how to do html output [12:36] any ideas?? [01:10] i built the pdf with dblatex not xml2pdf === glatzor [i=renate@88.134.194.194] has joined #ubuntu-doc === Admiral_Chicago_ [n=FreddyM@adsl-68-72-109-250.dsl.chcgil.ameritech.net] has joined #ubuntu-doc === bhuvan [n=bhuvan@ubuntu/member/bhuvan] has joined #ubuntu-doc === jjesse [n=jjesse@64.186.55.234] has joined #ubuntu-doc === tck [n=tck@212.2.183.124] has joined #ubuntu-doc === tck [n=tck@212.2.183.124] has joined #ubuntu-doc === Admiral_Chicago [n=FreddyM@adsl-68-72-109-250.dsl.chcgil.ameritech.net] has joined #ubuntu-doc === bodhi_zazen [n=bodhizaz@stpete.helmednet.org] has joined #ubuntu-doc === glatzor [n=renate@ppp-82-135-6-74.dynamic.mnet-online.de] has joined #ubuntu-doc === guglielf [n=guglielf@unaffiliated/guglielf] has joined #ubuntu-doc === fijam_ [n=fijam@unaffiliated/fijam] has joined #ubuntu-doc === glatzor [n=renate@p57AEE38D.dip.t-dialin.net] has joined #ubuntu-doc === fijam_ is now known as fijam === munckfish [n=munckfis@82-41-13-152.cable.ubr02.edin.blueyonder.co.uk] has joined #ubuntu-doc === jjesse [n=jjesse@adsl-69-209-105-90.dsl.klmzmi.ameritech.net] has joined #ubuntu-doc