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

=== nixternal_ [n=nixterna@unaffiliated/nixternal] has joined #ubuntu-doc
=== gaz00 [n=gaz00@S01060015e96c00db.cg.shawcable.net] has joined #ubuntu-doc
=== bimberi [n=bimberi@ubuntu/member/pdpc.active.bimberi] has joined #ubuntu-doc
=== kermitX_ [n=kermit@unaffiliated/cxg] has joined #ubuntu-doc
=== tonyyarusso [n=anthony@dialup-4.159.11.201.Dial1.Chicago1.Level3.net] has joined #ubuntu-doc
LaserJockmdke__: awake?02:45
mvirkkilSeems like I need to do some datamining. I've been playing around with the xslt to do docbook->moinmoin 02:47
mvirkkilThe version I have now, handles most of what the moin->docbook generates, with the single huge omission of graphics.02:47
mvirkkil(because it's a bit complicated)02:47
mvirkkilAny suggestions on how to accomplish, where to start?02:47
LaserJockI'm a simple docbook user so I'm afraid I'm no help :(02:52
mvirkkilLaserJock: What's a "simple docbook user"03:09
LaserJockmeaning, I can write docs with it03:09
LaserJockbut I don't know much about doing stylesheets, etc.03:10
mvirkkilLaserJock: Ahh.. I was asking more like "what are the most important docbook elements", maybe. 03:11
LaserJockmvirkkil: https://help.ubuntu.com/community/DocBookReference has most of what I use03:13
mvirkkilLaserJock: Cool! Since I already handle almost all of that :)03:17
LaserJockyep03:17
LaserJockI actually don't have a graphics in the doc I maintain so I don't have a lot to offer there03:17
LaserJocks/a/any/03:17
mvirkkilHmm.. I don't think all those examples are valid.03:18
mvirkkilyup. the list examples are invalid.03:19
LaserJockcould be, that page is a work in progress I believe03:19
mvirkkilyou must have <listitem><para>text</para></listitem> 03:19
Laser_awayright, I believe so03:19
Laser_awaygotta get home now, bbl03:20
=== gaz00 [n=gaz00@S01060015e96c00db.cg.shawcable.net] has joined #ubuntu-doc
mvirkkilok03:21
=== tristanbob [i=tristanb@137.190.3.107] has joined #ubuntu-doc
=== tristanbob_ [i=tristanb@137.190.3.107] has joined #ubuntu-doc
=== mpt [n=mpt@203-173-177-223.bliink.ihug.co.nz] has joined #ubuntu-doc
nixternalBurgwork: was that you that wanted someone to go through one of the encryption pages on the wiki and see if it works?04:21
=== nixternal [n=nixterna@unaffiliated/nixternal] has joined #ubuntu-doc
robotgeeksomneone pinged me, but my away log was full05:06
=== jsgotangco [n=jsg123@ubuntu/member/jsgotangco] has joined #ubuntu-doc
robotgeekso, i dont know what/who pinged me05:20
=== poningru [n=poningru@ip68-105-165-49.ga.at.cox.net] has joined #ubuntu-doc
=== tonyyarusso [n=anthony@dialup-4.159.11.216.Dial1.Chicago1.Level3.net] has joined #ubuntu-doc
=== [Utah] tristanbob [i=tristanb@137.190.3.107] has joined #ubuntu-doc
=== bimberi_ [n=bimberi@ubuntu/member/pdpc.active.bimberi] has joined #ubuntu-doc
=== Madpilot [n=brian@ubuntu/member/madpilot] has joined #ubuntu-doc
=== robitaille [n=daniel@ubuntu/member/robitaille] has joined #ubuntu-doc
mvirkkiljeffsch: I've been hacking on the xslt.08:40
mvirkkiljeffsch: you mentioned you might be interested in further developing it.08:41
=== jsgotangco waves in the channel
Madpilothi jsgotangco 08:42
jsgotangcoMadpilot: hello brian =)08:42
mvirkkiljeffsch: the docbook->moin xslt, that is. I split it in to smaller chunks, and added support for table attributes (align, valign, morerows, colspan), glosslist support, unlimited depth for lists, and the <section> tag.08:42
mvirkkilSeems like I need to do some datamining. I've been playing around with the xslt to do docbook->moinmoin. Now I need to know what to concentrate on. Any suggestions?08:43
mvirkkilI can't realistically support over 400 elements, so out of necessity, it's going to be a subset.08:44
mdke__Laser_away: now08:45
mdke__morning all08:45
jsgotangcohello mdke =)08:46
Madpilotmorning mdke 08:46
mdkehow are things in docland today?08:52
jsgotangcohmmm08:53
jsgotangcoi sure did some docs today but for the UNDP and published in LP08:53
=== jd_ [n=jd@wikipedia/Meanos] has joined #ubuntu-doc
=== mpt [n=mpt@203-173-177-223.bliink.ihug.co.nz] has joined #ubuntu-doc
mvirkkilmdke: Well, I'm thinking about how to accomplish assessing what docbook stuff I need to support.09:06
mdkemvirkkil: uhuh09:06
mvirkkilmdke: I've basically added support for everything the moin->docbook (article, not book) generates, with the exception of images.09:09
mvirkkilmdke: I think I'll do the "chunking" of a book in to separate smaller parts in python and not xsl.09:10
mvirkkiland for now I'm concentrating on the xsl part.09:10
mdkemvirkkil: sounds very cool.09:14
mdkemvirkkil: if you want to patch what we have in the repository, and for us to test it, give us a shout09:15
=== mdke goes to work
=== mpt_ [n=mpt@203-173-177-223.bliink.ihug.co.nz] has joined #ubuntu-doc
=== mvirkkil shouts
mvirkkilmdke: I'll still add support for images, but after that it would be nice to have you test it.09:56
mvirkkilmdke: Or maybe even before that. What are you planning on using it for?09:58
=== synchronboy [i=synchron@silenceisdefeat.org] has joined #ubuntu-doc
=== synchronboy is now known as matthewrevell
=== ompaul [n=ompaul@ubuntu/member/ompaul] has joined #ubuntu-doc
=== jsgotangco wonders why tables in yelp have no borders..or is it my tags
jsgotangcoit seems to have very faint row colors10:17
=== dsas [n=dean@host86-129-20-199.range86-129.btcentralplus.com] has joined #ubuntu-doc
=== pygi [n=pygi@83-131-253-223.adsl.net.t-com.hr] has joined #ubuntu-doc
mvirkkiljsgotangco: I noticed that bug too. You need to specify borders for each cell separately iirc.10:29
jsgotangcoouchhh10:29
jsgotangcoand docbook tables arent the most beautiful in markup out there10:30
mvirkkiljsgotangco: That's why I prefer writing wikimarkup and converting ;)10:30
jsgotangcohehe yeah i hear ya10:30
jsgotangcoits just that i have to finish up my contract with the UN with this small conversion job10:31
mvirkkil"#Bug in yelp, the two lines below don't affect rendering: self.tgroup.setAttribute('rowsep', '1'); self.tgroup.setAttribute('colsep', '1')"10:33
mvirkkilInstead I do both of those separately for each single entry element.10:34
mvirkkiljsgotangco: What conversion?10:34
=== Seveas [n=seveas@ubuntu/member/seveas] has joined #ubuntu-doc
mdkemvirkkil: putting our guides into the wiki10:59
robhmm, I guess I should file a bug on the packaging guide11:10
robhttps://help.ubuntu.com/ubuntu/packagingguide/C/appendix-chroot.html11:10
jsgotangcorob: do it11:10
jsgotangcoyeah11:10
robthe configure locales part doesn't configure locales11:10
robone needs to also do something like: apt-get install language-pack-en11:11
=== mpt__ [n=mpt@203-173-177-223.bliink.ihug.co.nz] has joined #ubuntu-doc
robok done11:15
rob#5207011:15
mvirkkilmdke: So like install-guide could be an example? https://docteam.ubuntu.com/repos/trunk/generic/installguide/C/installation-guide.xml11:24
mvirkkilmdke: Because that contains almost exclusibely procedures and variablelists, it would seem. And neither is supported or has a clean conversion to wiki.11:26
mdkemvirkkil: well not that one specifically. But certainly guides which contain LOTS of procedures and some variablelists11:27
mvirkkilmdke: hmm.. That's a problem. Any suggestions on how to map those to the wikisyntax?11:29
mdkemvirkkil: well, I don't know how it works technically, but I would have thought that procedures can just be turned into a numbered list, if more than 1 step, and a bulleted list if a single step. Or is that too simplistic11:31
mvirkkilmdke: Actually, most of the other examples I'm seeing in your repo, don't contain procedures or variablelists.11:32
mvirkkilmdke: The problem is, that the wikisyntax doesn't handle anything that isn't a single paragraph with some markup very gracefully. Most steps contains screenshots and several paragraphs of text.11:33
mvirkkilmdke: But it would seem that the installation-guide is just about the only one with many procedures and variablelists. Other docbooks seem to look a lot simpler.11:34
mdkemvirkkil: we hardly have any screenshots. But if you want to see lots of procedures, see trunk/ubuntu/desktopguide/C11:34
mvirkkilmdke: Ahh crap ;) But those aren't as complex steps. Those could be mapped to orderedlists.11:37
mvirkkilmdke: I'll see what I can do :)11:37
mvirkkilmdke: Thanks for the feedback. 11:38
mdkethank you11:40
=== apokryphos [n=apokryph@host-87-74-66-37.bulldogdsl.com] has joined #ubuntu-doc
apokryphosmdke: ping11:49
mdkeapokryphos: hello11:57
apokryphosmdke: hi. I see you changed some things on CommonQuestions (nice stuff), just wondering what you think the advantages are of the new contents page11:58
apokryphosseems a lot more troublesome to me. You  have to go to a section, then keep scrolling down the page to see if you find the answer11:58
mdkeapokryphos: which contents page?11:58
apokryphos(instead of having all the questions in a small list, then clicking on the one you want). That method would work if there were very few questions only, I think.11:58
apokryphosmdke: on CommonQuestions11:58
mdkeah, the table of contents on that page?11:59
mdkeI think the previous table was very ugly and unwieldy11:59
mdkei think keeping it simple is easier11:59
apokryphosnot when there are many questions, though. A user has to go that section, then keep scrolling down the page until he finds the question12:00
apokryphosseeing all the questions as bullet points (and as numbers) would be a lot easier, I think12:00
mdkeas long as the sections are appropriately structured, it should be obvious where the answers are12:00
mdkebut I'd rather discuss it on the list, I don't have much time now12:00
apokryphosa large table isn't bad as long as it's properly organised (and I think your organisation of it might be better ,indeed )12:00
mdkeI opened a thread specifically about this12:00
apokryphosI'm not the subscribed to the list, so I would've missed it. Also I wasn't getting emails about changes to the page (perhaps because of the move)12:01
apokryphosbut I'll post on the list, sure12:01
mdkethanks12:02
=== pygi_ [n=pygi@83-131-241-75.adsl.net.t-com.hr] has joined #ubuntu-doc
=== bimberi [n=bimberi@ubuntu/member/pdpc.active.bimberi] has joined #ubuntu-doc
=== dsas [n=dean@host86-129-22-252.range86-129.btcentralplus.com] has joined #ubuntu-doc
=== pygi [n=pygi@83-131-254-158.adsl.net.t-com.hr] has joined #ubuntu-doc
=== pygi_ [n=pygi@83-131-241-151.adsl.net.t-com.hr] has joined #ubuntu-doc
=== jsgotangco [n=jsg123@ubuntu/member/jsgotangco] has joined #ubuntu-doc
=== cosmolax [n=Cosmolax@219-68-130-176.adsl.dynamic.giga.net.tw] has joined #ubuntu-doc
=== jjesse [n=jjesse@64.186.55.234] has joined #ubuntu-doc
=== cosmolax [n=Cosmolax@219-68-130-176.adsl.dynamic.giga.net.tw] has left #ubuntu-doc []
=== WaterSevenUb [n=WaterSev@azevedo.astro.up.pt] has joined #ubuntu-doc
enricoIs there some free LPI ubuntu training material available?02:41
=== jjesse_ [n=jjesse@64.186.55.234] has joined #ubuntu-doc
=== tuxmaniac [n=aanjhan@unaffiliated/tuxmaniac] has joined #ubuntu-doc
=== pygi_ [n=pygi@83-131-233-71.adsl.net.t-com.hr] has joined #ubuntu-doc
=== pygi [n=pygi@83-131-234-148.adsl.net.t-com.hr] has joined #ubuntu-doc
=== jjesse [n=jjesse@64.186.55.234] has joined #ubuntu-doc
=== joachim-n [n=joachim@ACD856F2.ipt.aol.com] has joined #ubuntu-doc
=== cosmolax [n=Cosmolax@219-68-130-176.adsl.dynamic.giga.net.tw] has joined #ubuntu-doc
=== cosmolax [n=Cosmolax@219-68-130-176.adsl.dynamic.giga.net.tw] has left #ubuntu-doc []
jeffschmvirkkil: hello03:53
jeffschmvirkkil: i only have a couple of minutes, then i have to go for a day, but here is what I'm thinking...03:56
jeffschmvirkkil: I have been thinking about the article->moin stuff03:56
jeffschmvirkkil: Now I remember why I stopped working on it03:56
jeffschmvirkkil: It's because I realized that the best way to do it is to first do docbook->xhtml with xslt, then do xhtml->moin with xslt03:57
jeffschmvirkkil: also, the problem with moin->docbook is that there is a certain minimum level of complexity that is involved due to the nature of mvirkkil: docbook structure and document structure03:58
jeffschoops... that should be...03:59
jeffschmvirkkil: also, the problem with moin->docbook is that there is a certain minimum level of complexity that is involved due to the nature of docbook structure and document structure04:00
jeffschmvirkkil: moin is supposed to be simple, but to make it handle the complexities of a document, you need to make moin not simple04:00
jeffschmvirkkil: for example, the admonition macro in moin: how is it more simple and easy to remember than <tip><title></title><para></para></tip>?04:01
jeffschmvirkkil: the admonition macro is something like [[admonition,tip, title, text] ] , iirc. It might be easier to type, but same difficulty to remember04:01
jeffschmvirkkil: you will need many macros to handle the many docbook tags04:02
jeffschmvirkkil: it's probably easier to remember a hundred docbook tags than it is to remember a hundred moin macros04:02
mvirkkiljeffsch: I'm not striving for 100%, only the 90% that counts :)04:03
jeffschmvirkkil: I think that it might be easier to have a single docbook macro in moin04:03
jeffsch[[docbook] ] , or something04:03
=== linuxmonkey [n=linuxmon@unaffiliated/LinuxMonkey] has joined #ubuntu-doc
jeffschthen the moin formatter can turn the docbook processing over to xslt (or whatever) to produce the html04:04
mvirkkiljeffsch: And I've basically finished my work on moin->docbook. I needed to add Admonition and Insert(into="chapter") macros.04:04
jeffschah cool04:04
mvirkkiljeffsch: That would be too radical a change at this point. People seem to be happy with what the moin->docbook formatter can do at the moment. It's not perfect, but it's good enough.04:04
=== tuxmaniac [n=aanjhan@unaffiliated/tuxmaniac] has joined #ubuntu-doc
jeffschyeah... after we use it for awhile we will have a good idea of where to go 04:05
mvirkkiljeffsch: yeah. The idea people seem to have is to write most of the text in collaboration on a wiki. Then the "official guys" take it, clean it up, and make it ready for primetime.04:06
jeffschmvirkkil: have you tested it on random wiki pages yet?04:07
mvirkkiljeffsch: And this docbook->moin would probably be used for importing half finished projects or projects which need extensive work.04:07
mvirkkiljeffsch: Yeah. Moins SyntaxReference produces a valid docbook (!)04:07
=== mdke_ [n=matt@ubuntu/member/mdke] has joined #ubuntu-doc
mvirkkiljeffsch: Check out http://docbook.wikiwikiweb.de/04:08
mvirkkiljeffsch: Hmm.. Well, except for the fact that one section contains no data. I used to have a workaround which would put an empty para, but it was ugly, so I removed it.04:08
joachim-nah, the eternal wiki->docbook question... :)04:10
mvirkkiljoachim-n: :)04:10
mvirkkiljoachim-n: Any thoughts about the subject?04:10
joachim-nI think there's a gnome summer of coder looking at it too04:10
mvirkkiljoachim-n: That would be me :P04:10
joachim-nah :)04:10
mvirkkiljoachim-n: No wait.04:10
mvirkkiljoachim-n: Sorry.04:10
mvirkkiljoachim-n: I'm the fedora summer coder.04:11
jeffschmvirkkil: ok, i have to go to work... talk to you later, and good work!04:11
joachim-nGoran Raki is the gnome summer coder04:11
mvirkkiljoachim-n: I've talked to the gnome one, but he just wants to make pretty pages from existing docbooks, not edit them much.04:11
mvirkkiljoachim-n: Yup.04:11
joachim-nright. that's the core focus of his project04:11
mvirkkiljoachim-n: I tried brainstorming with him on how we could collaborate, but it didn't seem to work out really...04:12
joachim-nthe thought I had about it was that there's a lot of clues in the text a parser can use04:13
mvirkkiljoachim-n: There's also a php summer of coder working on php-docs<->docbook04:13
mvirkkiljoachim-n: Yeah. I've been thinking about adding support for a heading row in a table, if the first row's text is bolded.04:14
joachim-nyeah04:14
joachim-nI was thinking of things like "choose File->Open... " 04:14
joachim-nwhich the parser can guess is a menu command, and wrap it up in the dozens of tags you need for those04:14
mvirkkiljoachim-n: will only work for one language..04:21
joachim-nah, the "choose" you mean04:22
joachim-njust the -> between words then04:23
=== WaterSevenUb [n=WaterSev@azevedo.astro.up.pt] has joined #ubuntu-doc
=== pygi_ [n=pygi@83-131-234-148.adsl.net.t-com.hr] has joined #ubuntu-doc
jsgotangcociao04:39
=== pygi_ [n=pygi@83-131-234-148.adsl.net.t-com.hr] has joined #ubuntu-doc
=== CarlFK [n=carl@c-67-163-39-124.hsd1.il.comcast.net] has joined #ubuntu-doc
=== robitaille [i=robitail@ubuntu/member/robitaille] has joined #ubuntu-doc
=== glatzor [n=sebi@ppp-82-135-72-134.dynamic.mnet-online.de] has joined #ubuntu-doc
=== jjesse [n=jjesse@64.186.55.234] has joined #ubuntu-doc
nixternalmoins05:37
CarlFKthe ubuntu-user mail list is a bit overwhelming - Where can I suggest some sub-topics like -sound, networking, apps...05:38
enricoIs there some free LPI training material for Ubuntu?05:44
=== ompaul [n=ompaul@ubuntu/member/ompaul] has joined #ubuntu-doc
mdke_hi newz2000. Do you have any view yet on bug 51571? I can walk you through fixing it if you agree05:58
UbugtuMalone bug 51571 in ubuntu-website "Create a bug contact for the ubuntu-website product" [Untriaged,Unconfirmed]  http://launchpad.net/bugs/5157105:58
newz2000ooh, that's a cool feature05:59
newz2000let me look05:59
newz2000ok, I saw that come through, yes06:00
newz2000I'd appreciate any info on this subject06:00
mdke_newz2000: for example?06:00
mdke_you need clarity on what the bug is about?06:01
newz2000mdke_ yes, that would be helpful.06:01
mdke_ok06:01
=== robitaille_ [i=robitail@ubuntu/member/robitaille] has joined #ubuntu-doc
=== jjesse [n=jjesse@64.186.55.234] has joined #ubuntu-doc
=== robotgeek [i=venkat@digital.celebris.net] has joined #ubuntu-doc
=== RichJ [n=nixterna@unaffiliated/nixternal] has joined #ubuntu-doc
=== jjesse_ [n=jjesse@64.186.55.234] has joined #ubuntu-doc
=== glatzor [n=sebi@ppp-82-135-83-247.dynamic.mnet-online.de] has joined #ubuntu-doc
=== froud_ is now known as froud
=== glatzor [n=sebi@ppp-82-135-83-247.dynamic.mnet-online.de] has joined #ubuntu-doc
=== gaz00 [n=gaz00@S01060015e96c00db.cg.shawcable.net] has joined #ubuntu-doc
=== gaz00 [n=gaz00@S01060015e96c00db.cg.shawcable.net] has joined #ubuntu-doc
LaserJockmdke_: still?07:49
=== jjesse [n=jjesse@64.186.55.234] has joined #ubuntu-doc
=== froud [n=froud@dsl-145-7-07.telkomadsl.co.za] has joined #ubuntu-doc
=== pygi [n=pygi@83-131-255-110.adsl.net.t-com.hr] has joined #ubuntu-doc
=== jjesse_ [n=jjesse@64.186.55.234] has joined #ubuntu-doc
nixternaljjesse_: thank you for the email bud!!09:03
=== pygi_ [n=pygi@83-131-224-119.adsl.net.t-com.hr] has joined #ubuntu-doc
jjesse_nixternal: np09:12
jjesse_when does the mtg start?09:13
=== jd_ [n=jd@wikipedia/Meanos] has joined #ubuntu-doc
nixternali dont' think it is scheduled yet09:15
jjesse_ah09:16
nixternalactually..according to -meeting, it is tuesday09:17
nixternalhowever that wasn't on the wiki earlier nor the fridge09:17
=== nixternal investigates ;)
nixternalamarok transfer to ipod is really slow...i dont' know if it is amarok and ipod issue, or the fact i use rockbox..but i don't think rockbox is the issue there09:17
jjesse_agreed really slow09:18
nixternalahh..it is on the wiki now09:18
nixternal11 July 2006, 20:00 UTC09:18
nixternal15:00 for me, 16:00 for you09:18
jjesse_grin09:18
nixternalit is now set in kontact09:21
nixternali might sit in and listen to the Edubuntu Cookbook meeting...the work they do over there is neat..and i have been playing with Edubuntu, trying to get my church to use it in the childrens lab09:22
LaserJockway cool09:24
nixternalrofl..on the fridge, the "i want a pony" pic, you click it and it has a little girl upset and it says no!!09:24
nixternalgahaahaha09:24
nixternalomlord my stomach hurts from that one09:24
LaserJockmdke_: ping?09:42
=== Seveas [n=seveas@ubuntu/member/seveas] has joined #ubuntu-doc
=== pygi_ [n=pygi@83-131-235-55.adsl.net.t-com.hr] has joined #ubuntu-doc
mdke_LaserJock: email... I can't stick around now09:59
LaserJockmdke_: I just wondered if anybody from -doc was going to the dev meeting10:01
LaserJockthat is going on now10:01
mdke_not me...10:02
pygime :)10:02
mvirkkilmdke_: seems I can't browse the docteam trunk10:05
jjesse_i know we talked once before about setting up bzr for ubuntu-docs and iahve access to store it on the doc.ubuntu.com server but i forget how to check it10:05
LaserJockheh10:06
LaserJockjjesse_: what do you want to do exactly?10:06
LaserJockgrab the bzr? or push?10:06
jjesse_yeah grab the bzr10:06
jjesse_just to play a little w/ it10:06
LaserJockbzr branch http://doc.ubuntu.com/bzr/ or you can do checkout instead of branch if you want it svn-like10:07
jjesse_THANKS LaserJock10:08
jjesse_sorry bout the caps10:08
LaserJockbe forwarned though, it is quite old10:13
LaserJockI'll try to freshen it up soon10:13
jjesse_i noticed10:13
=== jd_ [n=jd@wikipedia/Meanos] has joined #ubuntu-doc
=== jd_ [n=jd@wikipedia/Meanos] has joined #ubuntu-doc
=== gaz00 [n=gaz00@S01060015e96c00db.cg.shawcable.net] has joined #ubuntu-doc
mdke_mvirkkil: https://docteam.ubuntu.com/repos11:02
mvirkkilmdke: Yah. That was the one I had trouble connecting to... No problems now. Probably a local network glitch.11:24
=== jrib [n=jasonr@ACA6B7D5.ipt.aol.com] has joined #ubuntu-doc
LaserJockmdke: ok, apparently I'll try to get a brief doc team report at the next distro meeting :/11:42

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