/srv/irclogs.ubuntu.com/2007/07/06/#ubuntu-doc.txt

=== 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
wakrhello05:24
=== 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
Admiral_Chicagohey there fijam10:50
Admiral_Chicagohave you been able to understand anything of the documentation  / writing it?10:51
fijamI do not quite get the rules of making the output html files out of docbook10:52
fijamAnd is it e.g supposed to work in yelp, or should it just work in a browser10:52
fijamI 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:54
Admiral_Chicagofijam: both10:55
Admiral_Chicagoit works with anything that can handle HTML10:55
fijam'cause as it is now, the links to chapters in yelp won't work10:56
fijamneither for ubuntu, nor for xubuntu10:56
fijamI am working on a clean svn pull, and I doubt if I was already able to screw something up.10:57
fijamand 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:00
fijamAdmiral_Chicago, how is it supposed to work then?11:02
Admiral_Chicagofijam: give me  a second11:07
fijamsure.11:07
Admiral_Chicagofijam: right now, we had the docs working by pulling them in Firefox11:08
Admiral_Chicagothis is probably broken as we recently moved the Ubuntu docs to the Xubuntu folder11:08
Admiral_Chicagoi don't know if it is broken though11:08
fijamSince 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:11
fijamTo 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:14
fijamAnd if it's not, how the links should be fixed.11:15
fijamdoes it make sense?11:15
Admiral_Chicagofijam: all you need to do is svn diff > mypatchforsection.diff11:18
Admiral_Chicagoif it is a simple change11:18
Admiral_Chicagoof course validating is also important if you are committing. if not, it isn't (but it is a good practice to follow)11:19
fijamcertainly.11:20
Admiral_Chicagothe 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 file11:20
Admiral_Chicagofijam: to answer your question docbook/xml is both11:21
fijamso we need to fix the links.11:21
Admiral_Chicagoah i see your question11:27
Admiral_Chicagoi'll have to think about that, i think you're question is a non issue though11:28
fijamwhat do you mean?11:28
Admiral_Chicagoafaik, this is all done when the docs are compiled (maybe by the MAKE file) which may not be how you are doing it11:29
fijamAdmiral_Chicago, output html files are fine. I just wonder what about raw docbook files.11:32
=== jono [n=jono@ubuntu/member/jono] has joined #ubuntu-doc
Admiral_Chicagohmm dunno fijam11:39
fijamI'll ask on the ML.11:40
Admiral_Chicagookay11:44
Admiral_Chicagogood idea11:44
=== Knightlust [n=Dax@ubuntu/member/knightlust] has joined #ubuntu-doc
ian_brasilhow did you output html from the docbook??12:33
ian_brasilthe make files for me failed due to the move to the topic based help system12:34
ian_brasil(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 output12:36
ian_brasilany ideas??12:36
ian_brasili built the pdf with dblatex not xml2pdf01:10
=== 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

Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!