=== WW [~wweckesse@67-138-144-192.dsl1.nor.ny.frontiernet.net] has joined #ubuntu-doc [04:07] WW, hi [04:34] pl0vs: Hey there. I was away lighting the fire. [04:51] just finished cleaning up some more pages [04:53] I noticed! Looks like you're keeping busy :) [04:54] there is still a lot to be done before we have really good docs [04:56] we still have lots of empty pages [04:57] What happened to your "minimalist" Front Page? [04:57] upstream preferred a less minimalistic approach [04:58] it's not too bad, a little full but well, that;s how it is [04:58] Ah. I haven't check what most of the links contain, but it looks like a lot of it should be static content on the regular web page. [04:58] the philosophy is, within 3 links you are on the destination, that is hard with very little links [04:59] So the preference is wide, shallow trees. [04:59] yes, like nautilus [05:00] i am more used to deeper trees, but i can see the logic [05:00] at least i got icons :) [05:01] "Policies & Procedures", "Promotion & Events", "Releases"... would it make sense for these to be on the main page? [05:01] how is the faq going? [05:02] Procedures, is used by devs [05:02] Releases, has lots of docs behind it [05:02] Well, whatever, I'm sure there are good reasons... [05:03] Promotions & Events is empty, but lulu insisted on it, we can always (re)move it later if it does not get used [05:03] no 1 reason, we needed a new page fast, that's done [05:04] The FAQ, however, seems to have moved down the tree a bit... but I guess it is still within three clicks to get to it. :) [05:04] but it used to be twice as long [05:04] Maybe Lulu should google for YAGNI. [05:04] the FAQ needs to be on the frontpage [05:05] i like kiss [05:06] What's the latest on macros (or something equivalent) in ReST or moin or whatever... [05:06] it will balance out over time, i think some things will move to support, and FrontPage will shrink to nice and minimal [05:07] they *still* have not finished installing the site, it still is slow, and caches badly, so no time to code :( [05:07] ReST hast some sort of TOC but it is turned of [05:07] I have a couple small things that I would add to the FAQ, but without some sort of TOC, the page is already too long. [05:08] i will bug lulu (again) on monday [05:08] maybe an idea is to remove some stuff, as it is also covered somewhere else [05:08] like mono, maybe a link will do [05:09] mp3 has a page as well [05:09] i think you should add (good) points, gives us more reasons for a TOC [05:11] and feel free to make remarks about the FrontPage, it is not yet finished, a wiki never is [05:11] (just as long you don't ditch all my icons) [05:11] ...otherwise it wouldn't be a wiki! :) [05:11] :) [05:11] right! [05:11] no reason to be overly attached to some page [05:11] Have you just been collecting icons from the web, snagging whatever looks good? [05:12] no, it is all legal [05:12] (and is free, of course) [05:12] i spoke with jimmac and the gnome people [05:12] it is all theirs, and Aaron made one icon [05:13] Ah, cool. [05:13] https://www.ubuntulinux.org/wiki/IconsPage [05:13] i especially like http://jimmac.musichall.cz/ikony.php3 [05:13] i really like the way jimmac draws [05:14] it is my absolute favourite, better then mac kde anything (i think) [05:14] I agree, pretty slick. [05:15] but again, feel free to make recommendations etc, just don't steel icons from apple or so ;) they get easily aggitated [05:15] and add your own off course [05:15] Right. [05:16] what you might do is add a toc by hand in ReST [05:17] it is a pain off course but better then nothing maybe, i don't know [05:17] I thought about doing that (like the test I put in the WikiSandBox), but a simple TableOfContents macro would make all the work instantly obsolete! [05:17] [[TableOfContents] ] we miss you [05:17] That's why I've been waiting to see what happens. [05:18] don't hold your breath, things move slooow [05:19] Also, I suspect completely rewriting the FAQ in ReST might make some people unhappy. [05:19] i believe in meritocracy [05:20] you work, you choose [05:20] i only make ReST pages [05:20] if people don't like it, then they should type faster [05:20] i think you are the only one touching the FAQ atm [05:20] And you know, the FAQ hasn't changed in quite a while... maybe it [05:21] it's time for a shake-up. [05:21] just make it as clear as possible, maybe like: https://www.ubuntulinux.org/wiki/TechnicalBoardAgenda [05:22] look in the source [05:22] I'll take a look... [05:22] if somebody complains, tell them to complain in the doc-list [05:23] and i will definately flame them for it === WW [~wweckesse@67-138-144-192.dsl1.nor.ny.frontiernet.net] has left #ubuntu-doc [] === netjoined: irc.freenode.net -> burroughs.freenode.net === plovs_work [~plovs@195.13.248.82] has joined #ubuntu-doc === netjoined: irc.freenode.net -> burroughs.freenode.net === plovs_work [~plovs@195.13.248.82] has joined #ubuntu-doc === WW [~wweckesse@67-138-144-192.dsl1.nor.ny.frontiernet.net] has joined #ubuntu-doc === WW [~wweckesse@67-138-144-192.dsl1.nor.ny.frontiernet.net] has left #ubuntu-doc [] [10:39] morning folks :) [10:40] sivang: moin === ChrisH is off to go shopping with wife and kids [10:40] Have fun ChrishH [10:43] morning pl0vs [12:43] Heck. Those other customers in the supermarket behave like it's the last day they every can buy something. [01:09] ChrisH : this happens in germeny also ??? [01:09] I thought this was centric to Israel only haha === hornbeck [~hornbeck@adsl-70-241-240-225.dsl.okcyok.swbell.net] has joined #ubuntu-doc [02:26] hi, hornbeck :) [02:27] Hey ChrisH [02:27] I just got done with your great backlog [02:27] Hi JOHN! [02:27] what;s up? [02:28] I was pretty surprised that it still worked this morning. :) [02:28] hey sivang [02:28] what do you think of our newly addition to the doc team? the amazing ChrisH :) ? [02:28] I think he is great [02:28] sivang: Put down the "Applause" sign, please. :) [02:28] haha [02:28] sorry I have not been around === sivang really likes the backlog [02:28] I had a hot water tank bust, had to tear out a wall to get to it, and still am not done [02:28] Any features that you would like to see in the log? [02:28] ah [02:29] I should be back to full speed monday [02:29] no problem, [02:29] after all it *is* the weekend [02:29] :) [02:29] well this crap has been going on since wednesday [02:29] :-) [02:29] one crappy weekend [02:30] does anyone else use a laptop with Ubuntu? [02:30] Yes. [02:30] does it drain your battery fast? [02:30] I have dual battery and it just goes fast [02:30] Toshiba Satellite - works well. The Toshiba Tecra at work doesn't do power management and has audio trouble though. Already told mjg59. [02:31] Didn't try it that long though. KDE on Debian Sarge worked a lot better IMHO. [02:31] I am on a dell 600m and everything works just uses alot of power [02:31] But laptops and linux is a hard issue. [02:31] yeah it is [02:32] hornbeck : uptill now, it has drained my battery, [02:32] heat up the system [02:32] work slow as HELLLL [02:32] :) [02:32] I reverted to debian sarge on the laptop for the meanwhile [02:32] ahh [02:32] But I might give another chance for Ubuntu on the laptop, [02:32] using only ext3 filesystem. [02:33] And I also have Sid still on this PC because I need to do debian package maintenance. There are fewer workstations on ubuntu than I wanted to have. [02:33] Hoary made my laptop heat up fast [02:33] there have been reports that XFS / resierfs have several issues [02:33] unclosed ones :) [02:33] which might cause excessive disk activity etc. [02:33] I have all my stuff on Ubuntu at the moment [02:33] ChrisH : I have only one desktop system (the strongest of them all here) with Ubuntu. [02:33] yeah I reverted to ext3 and it works alittle better [02:33] Isn't reiserfs going commercial anyway? [02:33] everything else is using debian [02:34] commercial? [02:34] you mean, they change thier license? [02:34] I thought I read something that reiserfs4 is no longer bsd/gpl. [02:34] I thought they were to stay GPL [02:34] reiserfs has two licenses [02:34] reiserfs has screwed a lot of data here. I'm staying on ext3 although xfs is really fast on the proxys. [02:34] gpl, and a I won't tell if you are using it license [02:36] as soon as XFS gets more stable , [02:36] for a more wide range of hardware - e.g. laptops etc. [02:36] that would be cool. [02:36] I am using reiserfs for / [02:36] XFS for /home [02:36] and ext3 for /boot [02:36] on this desktop [02:37] with full fledged Ubuntu. [02:37] but this is a 2.6Gigs HT 512MB machine [02:37] with 2 7200RPM, ATA100 harddrives. [02:37] ubuntu nearly "killed" the dell inspiron 8200 :) [02:37] btw, why is there no german home page for ubuntu yet? ubuntulinux.de has already been registered. Could I help with that? [02:38] Ubuntu is slowly becoming famous over here. [02:38] ChrisH : talk to mako, he is your man. oh, and lulu ofcourse. [02:38] There are quite some very nice germen people already on the project, which might help you set up it [02:38] boy, you have to love coffee === ChrisH will post on -doc [02:39] mako deals with everything community, and lulu is the site(s) admin :) [02:39] I love REDMUG [02:39] mako also from canonical? [02:39] yes [02:39] k [02:40] he's the community guy [02:41] brb, reading the gnome planet site [02:45] hornbeck : you on black coffe there? === ChrisH is on cappuccino [02:47] ah cappuccino is great, although bit expansive here comapred to other stuff [02:47] sivang: alittle milk, alittle suger [02:49] on the black? I prefer it traditional arabic black, we call it "mud" coffe here - because it sinks to the bottom of the glass and looks like mud :) [02:49] there is also an arabic/hindo spice there - "Hel" [02:49] it adds bits of bitterness and spice to the coffe [02:49] we have coffee [02:50] I never buy different coffee [02:50] folgers is what I buy [02:51] can you send a link ? pic ? [02:52] of the coffee? [02:52] yes [02:52] :) [02:52] or the package [02:52] http://www.folgers.com/ [02:53] We should open #ubuntu-coffee for the morning chitchat. :) [02:53] yes [02:54] yeah :) [02:56] ah cool [02:56] you seen this: [02:56] http://www.folgers.com/blend/index.shtml [02:58] no I don't really look around coffee sites much [03:00] I am folgers french roast [03:02] well I am going to be out for a second to read email [03:02] back in about ten minutes [03:06] who are the other guy besides sparkes that is no longer on the doc team? [03:09] is John Levin still with us? [03:10] or was it ben edwards who signed off ? [03:17] ben edwards [03:17] he said he may start helping again when he has time [03:18] ok, no prob. [03:18] so Levin still with us? [03:18] you happen to have his email? (I am working on the main site docteam page) [03:19] let me see if I can pull it up real quick [03:20] john@technolalia.org [03:20] damn that will be logged and posted to a website [03:21] why is that a problem? [03:21] :) [03:21] damn spam spiders [03:22] oh shit [03:22] I didn't realize [03:22] :( [03:22] yeah [03:22] ChrisH : you have an idea ? [03:22] how we might protect ourselves ? [03:22] hornbeck@SPAMFREEfreeshell.org [03:22] oh [03:23] or hornbeck at freeshell dot org [03:23] we should be foastering this way of discussion URLs agreed [03:24] huh? [03:27] well guys I am off for now, have to get this hotwater tank in [03:27] I will try to get back on and get some work done later [03:27] c'ya ! [03:27] monday starts "get the book going good" week :-) [03:27] later [04:01] sivang: if you use an email account on my server you will hardly get any spam [04:01] sivang: I'm an active in the "anti-spam scene" and have built up good measures to block off spammers. [04:02] sivang: half of my incoming emails are spam. But I only get one spam per day and 100 ham mails. [04:03] sivang: I could as well create sivang@member.of.ubuntu.and.sick.of.spam.workaround.org :) But that's probably overkill. [04:03] yes it would be an overkill :) === WW [~wweckesse@67-138-144-192.dsl1.nor.ny.frontiernet.net] has joined #ubuntu-doc [04:11] hey WW [04:15] Hi there [04:16] If you have a minute, take a look at NewFAQTest on the wiki (and compare to FrequentlyAskedQuestions). [04:19] I will, later, I have to go for about 30 minutes :) === WW [~wweckesse@67-138-144-192.dsl1.nor.ny.frontiernet.net] has left #ubuntu-doc [] [06:16] boy, the new FAQ by WW sure looks good, have you given it a look ChrisH ? === kmulligan [~kevin@pcp01065952pcs.rome01.tn.comcast.net] has joined #ubuntu-doc [06:16] hey kevin! [06:16] I'm sorry I havn't been responsive to your inquiries, [06:16] greets [06:16] sivang: I have. Two broken links. But looks good otherwise. [06:16] kmulligan: Cheers. [06:17] Greets all :) [06:17] kmulligan : if you'd like, mail me at sivan@workaround.org, with stuff you require from me and I will follow it item by item :) [06:17] what do you mean stuff i require? [06:20] hmm, in relation to linuxinto primerily [06:20] we "talked" a bit on the wiki [06:21] Oh, and I thought it would be better clarify that the LinuxInto / StartingTheJoureny doesn't intend to be a practical guide, [06:22] I inted to discuss the background a user needs to know prior to even using a howto or a tutorial for practical benefits. [06:22] but, the input you provided could very well serve me on a sequal to that doc, [06:22] ah [06:23] in a form of something more practical or get merged into FirstSteps which is currently very very basic [06:23] oh [06:27] and I recalled you asked me something about making special keyboard keys work under X [06:27] I will momentarily send you a nice link, [06:27] sec. [06:27] i think it was just how to switch workspaces [06:27] i found it and put it on linuxintrowishes [06:27] ctrl + alt + <-- or --> [06:28] the only other thing than that was getting mouse 3/4/5 to work [06:31] yes, [06:31] well this part invloves some 2 utilities from X. [06:31] one in which you capture the key codes the keys on the mouse would produce, [06:32] the other sets up a specific program or alike to react to it, [06:34] ok [06:34] frankyl, I have used it mostly in XMMS as the reciving application has to implement some kind of interaction with the fireing up process from X [06:44] hi guys [06:45] plovs: skol [06:46] greets [06:47] kmulligan, so you found your way to irc? [06:47] indeed [06:47] nie! [06:47] nice! [06:48] ive used it before, just didn't know if one came loaded [06:48] Is there another place than the IRC? === ChrisH has changed the irclog URL to something easier: http://irclog.workaround.org === ..[topic/#ubuntu-doc:ChrisH] : Ubuntu Doc Team - general discussion - backlog at http://irclog.workaround.org [06:51] ChrisH, nie very usefull, i love irce [06:52] IRC is easy to get addicted to. [06:52] hi plovs, what's up? [06:52] I [06:52] Have started to move thing into main site [06:53] sivang, good! [06:53] i am just looking at what's new, i like the FAQ [06:53] WW is doing a nice job [06:54] NewFAQTest [06:57] I think we should move the faq by WW to be official faq, it's very nice [06:58] Is there someone following ubuntu-doc and putting that up in the faq? [06:58] yes, he did a good job, looks much better, allthough it needs some more cleaning, some stuff is double in the wiki [06:58] Errr. s/ubuntu-doc/ubuntu-users/ [06:58] ChrisH, ah, ok [06:58] ChrisH, i read only the interisting pieces, it is too much === WW [~wweckesse@67-138-144-192.dsl1.nor.ny.frontiernet.net] has joined #ubuntu-doc [06:59] WW, hi! [06:59] Hey there. [06:59] kust talkning about you [06:59] ChrisH: I noticed. That irclog is awesome. [06:59] :) === plovs says: man, i can't type and eat in the same time [07:00] WW: Bloody lurker! Thanks. :) [07:00] plovs: We need to be careful when bashing WW. He's reading us. ;) [07:01] ;) [07:01] ChrisH: Nah, not lurking, just joined and then decided to see what was up. [07:01] WW what is your name ? (I am not sure if I know who you are) [07:01] ww, but, nice the new faq [07:02] sivang: Warren, but I also use WW on the wiki. [07:02] ah ok [07:06] WW, you have no icons on your FAQ? === sivang notes that plovs has an icon fever === plovs thinks life would not be worth living without icons [07:07] Does anyone know how to use the own portrait directly in the wiki? I didn't found that documented anywhere. [07:07] No, I didn't add any icons. Just converting it to ReST and getting rid of errors was a chore. [07:08] But hey, it's a wiki. Just Fix It (tm). [07:08] ChrisH, no, you can link it back to your homepage, but that's all [07:08] ChrisH, name-linking doesn't work either yet [07:08] in the changes page i mean [07:09] So I would still put the graphics up somewhere else. Okay. === sivang suggests writing to the mailing list in order to approve WW's new faq for official site [07:10] you can link it (using ReST) with .. image:: IconSambaShares [07:10] sivang, good idea, do it [07:10] and then preplace IconSambaShares with the link to your head [07:11] Have to check that out. === plovs needs a hackergotchi [07:11] ChrisH, http://docutils.sourceforge.net/docs/ref/rst/directives.html#images [07:12] Thanks for the link. ReST can be tricky. :) [07:13] WW : what's your real name for sake of list email ? :) [07:13] sivang: Warren Weckesser [07:14] WW: thanks. also have you already incorporated the main site [07:14] site's issues into your new wiki? [07:14] this is what I am talking about : http://www.ubuntulinux.org/support/documentation/faq/faqfolder_view/ [07:14] sivang: I'm not sure what you mean? [07:15] I mean, were you intending to have your FAQ as the wiki FAQ, or a main support FAQ ? [07:16] sivang: It isn't "my" FAQ. i just converted the existing wiki page FrequentlyAskedQuestions to ReST, so it could have a table of contents. [07:16] oh ok :) sorry about the misunderstanding. [07:17] sivang: I expect the policy would stay the same... someone from Ubuntu could grab whatever they like from the wiki faq and move it to the main site when they find something they like. [07:17] sivang, i still do not understand why we should have two faqs [07:17] plovs : me neither. [07:17] sivang, i think we can do that ourselves actually (move it) [07:17] Ok, I am going to release a post to the list, saying we want WW's [07:17] faq as the official one. [07:18] if I don't get any canonical response, [07:18] I am going to move it there. [07:18] sivang, WW, good idea! what do you think about this: [07:18] the current one, is *ahhem* sh*t ? [07:18] sivang, agreed [07:18] oopst [07:18] this is documented on ChrisH logs... [07:18] :) === ChrisH looks forward to canonical read it :) [07:18] ;) [07:18] sivang: The only problem with the current one is that the TableOfContents macro no longer works. [07:19] I hope nobody notices that ... [07:19] sivang: If that macro worked, I would never have done the conversion. [07:19] ChrisH : could you remove this form the log? :-) [07:19] moving the faq to the official one, putting to the wiki: StuffToBePutInTheOfficialWiki [07:19] No problem if you want to have some lines removed. Just remember to send your name and expiry date, too. And btw, I don't take American Express any more. [07:19] but siriously, let's take a quick look at http://www.ubuntulinux.org/support/documentation/faq/faqfolder_view/ [07:19] ChrisH : hahaha [07:20] No, I stand behind what I just said. [07:20] :) [07:20] sivang: Although I do agree that the current Ubuntu FAQ need to be reorganized. [07:20] does anybody think a linux distro FAQ should likke like? [07:20] It has just two categories, "Ubuntu" and "Support", which seem meaningless. [07:21] and i *really* don't think it is anyway comparable to http://www.ubuntulinux.org/wiki/NewFAQTest [07:21] with all do respect. [07:21] Oppinions people? flame? :) [07:21] a faq should be short Frequently does not mean every single possible question [07:21] that's right plovs, [07:22] but do you think some new people can be benefited from using http://www.ubuntulinux.org/support/documentation/faq/faqfolder_view/ as a start point? [07:22] off course *we* have to figure out how to do it right [07:22] I have a hunch they won't.. [07:22] sivang, i have never seen it referred to in #ubuntu or the list [07:23] plovs : you mean nobody even noticed it ? It's linked from Ubuntu's main apge [07:23] page [07:23] sivang: I agree. A new user asks "How do I get Java to work?" , not "What are the unsupported formats and tools?" [07:23] but if we would incorperate WW's FAQ with this faq and link it to the wiki for missing stuff, so it would be one thing then it would be ok [07:23] he doesn't even KNOW what those puzzled words like "restcited format" mean in the context of Ubuntu [07:23] sivang, correct [07:24] I think it's doing a great diservice for peopole just wanting to make *something* work. [07:24] sivang, *I* never read it, btw until just now [07:24] I didn't want to say anything about it, [07:24] i do not like the support section, it is redundant and out-dated [07:25] as I was sure someone from canonical would take care of making it something more similar to the wiki's form of FAQs.. [07:25] but now as I look it, [07:25] it's considered as nothing IMHO. [07:25] i think it is considered to be doc-team's job [07:25] meaning yours ;) [07:26] no problem. I will ad this to my TODO :) [07:26] so we would incorporate WW's with what already there, with links to the wiki where applicable ? [07:27] i would like that, ask for consensus on the list, though [07:27] and if WW agrees, off course [07:27] yes ofcourse, [07:27] nothing gets done on the doc team with the consensus thingy :) [07:28] what about a page: StuffToBePutInTheOfficialWiki ? [07:28] plovs : yes, thank you. without all sorts of notes everywhere I get lost :) [07:29] OfficialSite [07:29] and then no faq in the wiki, only one faq [07:29] :) [07:29] yes!!! [07:29] WW, would you like to be the FAQ-man? [07:29] WW : yes, since you've done such a good work, would you? [07:30] plovs: But if you simply change the name of StuffToBePutInTheOfficialWiki to FrequentlyAskedQuestions, you end up with the current policy. :) Which is fine with me. [07:30] well, i think we should move all the good stuff to thr 'real' faq-page and empty this one [07:31] Ah, well, if you guys are able to edit the real FAQ, then go for it. [07:31] not only *we*, we are thinking about *you* [07:31] WW, that is [07:32] on the official FAQ [07:32] yes, that would be way cool [07:32] WW, the offical FAQ-representative [07:32] plovs: Sorry, I don't think I can be FAQ-man. I don't have the time or ambition for that kind of committment. [07:32] ah, ok [07:32] plovs : and also adopt the wiki's devide and conquer approahc [07:33] Didn't follow it. Are you guys planning to do the FAQ in Docbook or Wiki? The latter is probably hard to handle. [07:33] ChrisH, can we put docbook in the site? [07:33] if we can then docbook would be my #1 choice [07:34] but we need something that shows up on the web as well [07:34] I don't know if we needed to just link the XHTML output from Docbook or if it can produce Wiki language. [07:34] Is there a way to upload HTML directly instead of using the wiki? [07:34] ChrisH, yes [07:34] Wiki is collaborative and nice. But handling large FAQs with TOCs, links and footnotes can become ugly. [07:35] Is docbook easy to use? One point of the wiki FAQ is that anyone can add to it. [07:35] WW, the official faq should be 'locked down' the StuffToBePut.. is open, wiki style [07:35] WW: That would not work with Docbook. So it depends on we want it ugly and collaborative or neat and restrictive. [07:36] plovs: I agree. A FaqProposedUpdates wiki page would still be needed and would serve as the input for the FAQ man. [07:36] ChrisH, do you have some test docbook file? [07:36] ChrisH : The online official FAQ can be edited with an WYSIWYG editor, very slick [07:36] ChrisH: Main ubuntu site: neat and restrictive. Wiki FAQ: easy but occasionally messy. (IMHO) [07:36] ChrisH : for the offline FAQ manual, ofcourse I support DocBook [07:36] plovs: I'm currently writing the Docbook tutorial I plan to have online in about an hour. That would perhaps give all here a better idea of how it looks. [07:37] ChrisH, is it in docbook? [07:37] plovs: the tutorial itself is not in docbook because I intend to wiki it. === sivang awaits the arrival of ChrisH's DocBook tutorial [07:37] sivang: Would be nice to have the FAQ be easily added to Gnome Help and shipped. [07:37] the reason i asked is, you can use html on the site === ChrisH carefully offers to maintain a docbook faq [07:38] if we will do the official documentation in docbook then i would love to have a faq about it [07:38] plovs: sounds a little recursive ;) [07:39] you do perl, you must like that kind of stuff [07:39] ;) [07:39] ChrisH : yes ofcourse. I'm planning of taking all the online docs and pacakge them for yelp [07:39] plovs: well... :) [07:39] sivang: wiki2yelp? [07:39] ChrisH : huh? [07:39] I'll split hairs here... I think you might need a docbook HowTo. After all, how frequently are people asking about using docbook (not counting those crazy doc-team members :) [07:39] ChrisH : you mean from docutlils ? [07:39] ChrisH, docbook2yelp [07:39] sivang: How do you plan to do that? [07:40] sivang: Just a wild guess. I didn't even know html2yelp exists. :) [07:40] plovs: Is there such a thing? [07:40] yes, i *think* so let me find it, brb [07:40] ChrisH : well, hopefully to be assisted by the ReST --> XML script [07:40] then, [07:40] i need beagle [07:41] That's the whole trouble with Wikis. It's hard to convert it into anything but HTML. [07:41] https://www.ubuntulinux.org/wiki/HowDoc [07:41] Yelp reads DocBook. OMF files. [07:41] go manual over stuff the didn't go well, [07:41] and then packages it for scrollkeeper [07:41] ChrisH, a question about docbook: [07:42] i can do docbook2html, right? [07:42] ChrisH : if you use ReST on the wiki, it could be *realtively* easy to convert it to xml [07:42] sivang, but there is (not yet) an xml2docbook converter [07:43] so what were all the talking about the easy way to convert from the wiki to docbook ? [07:43] :) [07:43] I need tomboy, [07:43] anybody know how I can find tseng's repo? [07:44] :) in the faq? [07:44] https://www.ubuntulinux.org/wiki/BreakMyUbuntu/view?searchterm=tseng [07:44] plovs: yes, docbook to html is trivial. Look at my tutorials at http://workaround.org [07:44] tomboy is really nice, i use it every day [07:45] ok, and we can post html on the site [07:45] that means that we should use docbook for bg things and then convert it and upload it [07:45] IMHO it would be nice to have Wiki for most pages ("who is in the doc team", "welcome to ubuntu" and "restricted formats") but use DocBook on larger articles that are potentially needed to be converted. [07:45] and those things can then be used with yelp [07:45] plovs: seconded [07:45] cool [07:46] sivang, find it? [07:46] not yet, [07:46] ChrisH, i intend to study docbook today (my wife is out of town, i have free time) [07:46] searching... [07:47] sivang, https://www.ubuntulinux.org/wiki/BreakMyUbuntu [07:47] ChrisH, what do you use to write docbook, emacs? [07:47] emacs is great at docbook [07:47] but I think he's using VI :) [07:48] plovs: There is a reasonably nice plugin for XML in the vim. [07:48] nice, i use vim [07:48] plovs: You may even want to take a look at conglomerate. [07:48] ChrisH, conglomerate crashed on me === plovs installs conglomerate again [07:50] ChrisH, article, book or set? [07:51] plovs: article [07:51] Darn, am in the middle of hoary upgrade [07:51] pkg file is locked [07:51] plovs : found it , thanks. [07:51] Let me put up the first part of the Wiki entry already. Looks like it could prove helpful already. [07:52] ChrisH : wiki entry of what? :) [07:52] ChrisH: Where are you putting it? [07:52] ChrisH: wait, nevermind... [07:52] sivang: DocBook [07:52] ChrisH, that would be nice [07:52] ChrisH : oh, it's finished ? [07:53] sivang: Nearly. The first part would allow everyone here to understand the abbreviations and get a "hello world" document compiled. [07:54] i'll write a doc, and publish it to the wiki, see if it's as good as they say it is ;) [07:54] plovs : about what? [07:55] as a test, probably about something important [07:55] about icons, i think === sivang LOLs [07:56] ChrisH : I would also appriciate a tutorial for doing docbook in VIM, using "reasonably nice plugin for XML in the vim." [07:56] :) [07:56] if it's not already how you're tutorial is put , as a vim guy [07:59] sivang: No problem. :) already here in draft form [07:59] Can anybody tell me how to use something like
...
in ReST? [08:00] Ah... literal block I guess. "::" [08:00] plovs is our rest expert [08:00] :) [08:01] I have yet to do a single doc in it, [08:01] I might as well start with DocBook altogether === ChrisH proudly presents http://www.ubuntulinux.org/wiki/DocBook [08:25] Anyone reading it? :) [08:25] ChrisH: Looks like a nice start. For those of us too lazy to install everything right away, is it possible to add a link to the HTML version of you Hello World example? [08:26] looks very nice [08:26] WW: Sure. Where shall I put it? [08:26] sivang: tnx [08:27] ChrisH: Can you make 'test.html' a link right there in the page? [08:27] WW: To another wiki page? [08:27] ChrisH: I don't know. Is it possible to upload the html file to the wiki? [08:29] I haven't tried uploading a complete html file to the wiki... don't know if you can do that. Anybody? [08:29] hoary is crawling into my system..... [08:29] WW: I have put it on workaround.org - who cares [08:29] WW : there's an option when you edit main site pages === pl0vs [~knoppix@195.13.248.82] has joined #ubuntu-doc [08:35] ChrisH: Thanks. I'll be using your page when I start experimenting with DocBook for a project of mine. [08:36] Time to go... but who knows, maybe I'll be lurking... :) [08:36] WW: DocBook has own tags for generating FAQs. Should I provide an example for out internal use? [08:36] *our [08:36] arggh [08:37] sivang: okay, okay, I won't, I promise! [08:37] hoary started to break things for me, I'm headed to a reboot :) [08:37] ChrisH: That would be interesting to see. [08:37] ok, back online [08:37] that wasn't intented for you ChrisH :) [08:37] Later, y'all. [08:37] sivang: I know. :) [08:37] WW: l8r [08:37] see ya WW [08:37] I arrgheed at hoary breaking my mozilla-firefox [08:37] C'ya WW === WW [~wweckesse@67-138-144-192.dsl1.nor.ny.frontiernet.net] has left #ubuntu-doc [] [08:38] ChrisH, nice to see that the log now has autoscroll as well. Super! [08:38] pl0vs: for the lazy of us :) [08:39] sivang, you are going to the conference? [08:41] I wish, I am not sure yet for the travel expanses if I can handle them, [08:41] but I am checking possibilities. [08:42] Which conference is it? [08:42] well, if you go say hi from the doc-team [08:43] ofcourse! [08:43] I would represent us [08:43] there. [08:43] ChrisH, you can escape wiki names with ! like LaTeX [08:44] pl0vs: so they don't become links? [08:45] yes [08:46] pl0vs: ic [08:56] ChrisH, it is easier if commands (xslt etc) are in a box as well, beginning with "bash:~$ " BeagleInstallHowto has nice layout [08:57] easier to copy/paste [08:57] pl0vs: Okay... I will just finish it. (A dozen more lines.) Then I'll clean it up. [08:57] pl0vs: Your original text is still there (commented out) in case you want it included. [08:59] ChrisH, nono, yours is much better (despite the fact that it does not have *any* icons whatsover) [08:59] ChrisH : there is going to be a hoary conference in spain on december [09:00] ChrisH, i tried it, i'm inpressed [09:00] ChrisH : It would be 2 weeks of hacking, talks etc [09:00] now i'll copy it to thw wiki [09:00] sivang, sounds really nice [09:01] sivang: I didn't know there was an Ubuntu conference. :) [09:01] what are you working on now fellas ? [09:01] ChrisH : all canonical employees are going to be there, together with a bunch of interested folks and related [09:01] ChrisH, it's on the frontpage of ubuntulinux and in the wiki in Conference [09:02] sivang: Two weeks? That's a long time. Is there so much to discuss? [09:02] ChrisH, it's in spain, it's warm, has beaches... [09:03] pl0vs: I know spain well. But in December it will hardly be that warm. Northern hemisphere. :) [09:03] ChrisH : I am not sure, but I'm sure mako would have better answers about this, just write to him. [09:05] sivang: Not that much on the Agenda, yet. [09:05] ChrisH, still 20+ in the south, atm [09:05] btw checkout: https://www.ubuntulinux.org/wiki/DocbookTestHtml [09:05] he said on the conference page that he would wlecome any questions etc. [09:05] i think the ubuntu guys just want to meet, they might never have met before [09:05] sivang: I can surely not attend. Both work and family won't allow that. I was very surprised that last year my boss paid the travel for a coworker and me to the LinuxTag. [09:06] ChrisH : what company do you work for ? [09:06] sivang: www.otto.com / www.otto.de [09:06] really? my mum buys there [09:07] pl0vs: I have been to the CCCongress for five years until 1999. But with the time there was less hacking (in the productive meaning) but more pr0n leeching. :( [09:07] ChrisH, at otto or linuxtag ? [09:07] pl0vs: I'm in the network security team there. Usually it's fun. But out management is laying off 25% of all employees. :( [09:08] pl0vs: LinuxTag. :) [09:08] management, firing people and wanting more work done in the same memo! [09:08] bah! [09:09] on a more positive note, docbook works great! [09:09] pl0vs: Currently no one is doing serious work there. Everybody is waiting who will get fired. We will know that in 03/2005. Gnarr. [09:09] i put the html output in the wiki, and it renders ok [09:09] pl0vs : have you followed ChrisH new tutorial? === sivang also wants to know what is all the fun about :) [09:10] pl0vs: Cool. And with the stylesheet it looks decent. :) [09:10] sivang, yes, test.html: https://www.ubuntulinux.org/wiki/DocbookTestHtml , renders fine [09:10] which means we could write real docs in docbook and then use xslt and put it in the site [09:11] ChrisH, can you add a links section? with the docbook site etc [09:11] pl0vs: just that people needed to know that the source is docbook so they would not start changing the html code [09:11] pl0vs: Yes. [09:12] At first I found that DocBook/XML was a bad joke. Mostly because most of the programs I got recommended did not work at all. Where couldn't there just be a "do this and that" and a few pointers? [09:12] we would put that stuff not in the wiki but in the support section [09:12] pl0vs: (excuse my ignorance) support section? [09:13] Great advantage of DocBook: we could have it checked in and out in CVS or SVN because it's plain text. [09:13] https://www.ubuntulinux.org/support the 'official' documentation [09:14] hornbeck is setting up svn/cvs for us (doc-team) [09:14] Fedora uses it as well, they have graet looking docs [09:14] with one style-sheet it all looks the same, really good === pl0vs dreams about having icons all over the documentation ... [09:15] Who has permissions to edit the support page? Only canonical? [09:16] doc-team as well, meaning we do [09:16] Perhaps one day I qualify for edit access, too. No hurry. :) [09:17] you already have edit-access [09:17] everybody has [09:17] pl0vs: not for the support area [09:17] it's just not common knowledge [09:18] you have [09:18] yes, everybody has [09:18] :) [09:18] Do you see an "Edit" button at https://www.ubuntulinux.org/support ? Or do I need to use the "secret edit link"? [09:19] go to documentation/howto's [09:19] you need to create an account [09:19] and then log in [09:20] There I get an edit link. Just not for the parent pages it seems. [09:20] no only admin can edit those [09:20] after you logged in, [09:21] canonical probably does not want a kid to screw the main support page. [09:26] sec, checking [09:28] I seem to be able to edit all support pages :) [09:28] which page do you want to edit? [09:28] Tell me what you want to edit and I will add it, ChrisH [09:29] Nothing concrete. Just looking for a place to insert WW's Docbookified FAQ later. [09:30] strange. [09:30] I could edit those last night [09:30] it seems locked now [09:30] my "edit" bar is gone!!! === sivang cries [09:30] maybe someone saw how I referenced the current official faq ? :) [09:31] sivang: Thanks a lot, sivang. You screwed for all of us! ;) [09:32] ahh, found it [09:32] it was all my human error [09:32] :) [09:32] :) [09:32] this is how to do it [09:32] : [09:33] from https://www.ubuntulinux.org/support/documentation/ [09:33] click on the specific square you're interested in, [09:33] then you can edit it [09:33] you can even add a new item to it === pl0vs is smiling stupidly at his creation, tags work! important === sivang joines pl0vs in the joyness of creation and has sympathy for such emotions [09:38] ChrisH, and it works great with vim as well [09:38] pl0vs: Did you install the xmledit plugin? === sivang wants some of the DocBook fun in VIM!! [09:39] ChrisH, yes [09:40] ChrisH, would a page like: https://www.ubuntulinux.org/wiki/BitTorrent be possible with docbook? [09:40] pl0vs: Why not? What is special about it? [09:41] code, looks like code, a note is a note etc? [09:41] pl0vs: Look at http://workaround.org/articles/ispmail-sarge/ [09:42] pl0vs: I used my own style sheet. But basically there are notes (even different ones: warnings, important, notices) and terminal input. [09:43] i read that one already ;) this is nice stuff indeed [09:44] they have good looking stuff: http://fedora.redhat.com/projects/docs/ [09:44] I'm currently putting together this extra page: http://www.ubuntulinux.org/wiki/DocBookReference [09:44] they also use docbook i noticed [09:45] ChrisH, nice [09:45] pl0vs: Yes [09:45] pl0vs: And it fits nicely into the rest of my workaround.org pages [09:45] pl0vs: So it does not necessarily need to look as ugly as the debian documentation. :P [09:46] that is what i was wondering about, redhat looks great but is not high quality, debian the other way around [09:47] i would like to be a bit of both [09:47] No, the other bit! [09:47] Documentation is fine. But ugly documentation is not funny to read. [09:47] ChrisH : it looks again, superb [09:47] I wanna do DocBook also, waiting for my mentor to finish up with his first student :) === ChrisH bows before the kind audience [09:47] ChrisH, will you explain the meaning of the tags somewhere? or is there a good doc somewhere? [09:48] pl0vs: http://www.ubuntulinux.org/wiki/DocBookReference [09:48] eg keywordset [09:48] pl0vs: incomplete though. I'll include links to the "real" docs [09:48] reading http://www.ubuntulinux.org/wiki/DocBookReference atm [09:48] This is the real link: http://www.docbook.org/tdg/en/html/ [09:49] understand everything except keywordset [09:50] pl0vs: why? [09:50] what is it used for? [09:50] keywordset [09:51] pl0vs: In HTML the keywords in the header will be generated from that. [09:51] ok [09:52] btw you have a space too many before all the lines in the example in http://www.ubuntulinux.org/wiki/DocBookReference [09:52] it doesn't parse, until you remove the space [09:53] pl0vs: haven't saved for a while :) [09:53] ok [09:58] sivang, where you working on the debian documentation or only horbeck? [09:59] pl0vs : hornbeck and the other new guy, I just suggested we should try and put in shape already shipping docs [09:59] and give back to debian on colliding areas [10:00] I'm done with http://www.ubuntulinux.org/wiki/DocBookReference - does it look reasonable to you? [10:00] looks nice [10:00] i reloaded the page already [10:01] i am still missing notes, definitions [10:02] pl0vs: Notes are like ... [10:02] pl0vs: I'll add them. [10:03] ChrisH, see http://fedora.redhat.com/participate/documentation-guide/s1-xml-admon.html [10:03] or can we just use that? [10:04] pl0vs: done... what else? [10:05] ChrisH : which pages did you want to go on the front support page ? new xml howto and ? [10:05] maybe better like this: [10:06] NoteBody of text goes here. [10:06] ? [10:06] pl0vs: done :) [10:06] sivang: uh? [10:06] i can't reload this fast! [10:06] ChrisH : wanted to link from "latest" howtos to your new docbook one [10:07] niiice! [10:07] I start to get a hang on ReST markup. :) [10:08] nice page , I'm stunned [10:09] I would write more but I have no idea of dragons really. :) [10:11] now we need a list of stuff they want to be done for yelp [10:12] pl0vs : we need to first see if the already shipping stuff is current, and make a new start page for the first yelp doc that is presented when you fire it up [10:12] pl0vs: to convert docbook to yelp? [10:12] yelp is using docbook, [10:12] just with some custom XSLT [10:12] natively? [10:12] yes [10:12] ah, ok [10:12] :) === ChrisH is preparing a DocBook FAQ test page [10:13] yelp uses docbook imo [10:13] you can just check out some gnom [10:13] docs sources [10:13] for example, the controversial gnome2-user-guide [10:13] :) [10:13] sivang, how, what from where? [10:13] using cvs? [10:13] pl0vs : also, [10:14] howto? [10:14] and you can just look it in your system - although that would be the 2.6 docs afaik [10:14] lemme see where is the scrollkeeper conf files.. [10:15] or where are the actual docbook file for this manual. [10:17] /usr/share/gnome/help/user-guide/C/user-guide.xml [10:18] I am not sure if XSLT is the right word for what it uses, [10:18] it's standard DocBOok, [10:18] but yelp has it's own way of rendering stuff [10:18] XSLT defines the way the resulting page looks? [10:20] There is probably an XSLT to transform the DocBook/XML into yelp format. [10:20] Same procedure as with html [10:20] XSLT defines in which images/ rendering the resulting page should use? [10:21] for example, if a "note" should use once icon in standard docbook, and another on yelp's format? [10:21] XML + XSLT => output format [10:22] You can toggle whether icons are used or just text. [10:22] http://www.sagehill.net/docbookxsl/Icons.html#d0e4990 [10:38] this is a docbook FAQ: http://workaround.org/ubuntu/faq.html [10:38] feedback? [10:39] (Still needs some nice stylesheet of course. Just plain HTML.) [10:42] nice [10:42] we should use the main site's style sheet [10:42] looks good, what does the docbook source look like? [10:42] ChrisH, anyway I'm starting with your docbook tutorial, does it say there how to use vim for docbook? [10:43] sivang: yup [10:43] k, great [10:43] pl0vs: see workaround.org/ubuntu/faq.xml [10:44] pl0vs: By the way... the xmledit plugin has nice features. Enter ">" in insert mode. :) [10:44] ChrisH, i don't think so... [10:44] pl0vs: ? [10:45] ChrisH, nice para>> [10:45] ChrisH, it gives text only [10:45] pl0vs: Use the source, Luke. :) [10:45] duh [10:46] very nice,maybe this is a better solution for longer docs indeed [10:47] pl0vs: especially the automatic generation of the question list with correct links... you had to do that all manually in the wiki [10:47] yes, so we only need a good stylesheet then [10:47] Should I continue converting the current FAQ? [10:47] pl0vs: If you just import the HTML into the wiki? Doesn't it use the stylesheet by default? [10:48] pl0vs: Or how did you do it last hour? [10:48] https://www.ubuntulinux.org/wiki/DocbookTestHtml does, but we should test it with question/answer and note etc [10:49] pl0vs: would you upload the faq test page? [10:49] working on it as we speak [10:49] Very good, Sir. [10:51] no, doesn't work [10:51] https://www.ubuntulinux.org/wiki/DocbookTestHtml [10:51] But it's plain HTML? What did you do differently? [10:53] i'll put in the test again, and then the faq again [10:57] Tricky... what would we do with FAQ entries that just point to other Wiki pages? That would not work in the Gnome Help. [11:00] it does not work anymore ??? [11:00] strange [11:04] I'm not that sure that having a heavily wiki-linked FAQ is a good thing to be put into Docbook. Opinions? [11:06] it works... human error .... === pl0vs bows his head in shame [11:07] why do the links not work? [11:07] they do here [11:08] ah, ok so the faq should be self-supportive for using it in gnome-help [11:08] well, then we have to 1) put those pages in help as well or 2) remove the links eg answer in the faq [11:09] btw it lokks like ... not so good https://www.ubuntulinux.org/wiki/DocbookTestHtml [11:09] Putting the whole wiki in the help? Hmmm. Don't like the idea. [11:09] well, the linked pages, the top 10 [11:11] Perhaps we should find a consensus on where the FAQ will be. If it's just a link farm to other Wiki pages then it would make hardly any sense outside of the wiki. [11:12] if it needs to be in gnome-help then that won't do... [11:12] i'll write to the mailinglist [11:12] good [11:13] IMHO an FAQ should be self-contained without too many external links [11:16] off=course wiki-links can be just external links, that would work: eg https://www.ubuntulinux.org/wiki/DocBook [11:16] I did it like that before. If that's what "people" want... okay. [11:19] there will always be outside links like: "for more info on working with docbook see: https://www.ubuntulinux.org/wiki/DocBook" [11:19] or does that look bad [11:19] does it work in yelp btw? external links? [11:19] Good question. [11:20] As i said... I'd always try to make it self-contained. [11:21] it does work [11:21] it has an outside link to the gpl atm [11:21] But is it what we want? [11:22] maybe not, it kindoff defeats the whole purpose of putting it in yelp [11:22] if you have outside links, you might just ass well use a web-browser [11:22] for the whole thing [11:23] ...and use the Wiki FAQ :) [11:23] right... i'll put it in the question to the list [11:23] k [11:25] ok, sent [11:27] there is something about writing yelp stuff in yelp: Writing ScrollKeeper OMF Files [11:27] it looks like docbook, to my untrained eye [11:28] ChrisH, are yo urunning ubuntu? atm [11:29] pl0vs: not on this PC - but on the laptop [11:30] i have this funny thing in yelp, in system - synaptic docs, they show up in spanish? [11:30] oops? [11:31] that's too bad since it looks like good documentation, better then we have in the wiki [11:33] i'll check [11:34] this yelp is quite nice! [11:35] it even has the python tutorial [11:36] my docs are in english [11:36] (synaptic) [11:37] then maybe it is because i am running remote X through knoppix etc [11:38] you see how nice it looks in yelp, with icons and all for notes and warnings? [11:39] pl0vs: and still docbook :) [11:40] pl0vs: do you know if there is a wysiwyg editor for gnome help documents? I know there is an XSLT but I wonder how developers write their docs [11:41] the redhat guys use (and advise to use) emacs [11:41] ChrisH : they use emacs :) [11:42] Eeek. I quit! [11:43] sivang, do you know where the yelp "home-page" is? on my computer i mean, the first page yelp opens [11:43] ChrisH, we can advise vim, for ubuntu [11:45] what if we try to make yelp open on first boot, showing the ubuntu-faq, that would be a great help i think [11:47] pl0vs: Isn't the link in the panel pointing to it? [11:47] I think we would be better off letting the user choose when he wants "help!" :) [11:47] This could create much annoyance in some larger, non newbie, already linux familiar audience of Ubuntu. === sivang is back for some more work. === ChrisH is slowly getting tired (unusually diligent today) [11:50] what have you fine fellows doc team of me been working on my 1hr absence? more docbook stuff? [11:50] but only on first bootup, like the kde config wizard [11:50] not a good idea? [11:50] sivang, only docbook here [11:50] k [11:51] ChrisH : I am sure we could use some wysiwyg editor and have it render yelp's XSLT on the fly , what do you say? [11:51] (we need not stick to emacs as the gnome doc people) [11:52] sivang: You want to quickly write an editor for yelp? Nice. [11:52] sivang: Done already? ;) [11:52] nono :) [11:53] I thought we could just have some WYSIWYG xml editor use yelp's XSLT and render it for us as a gui editor.. [11:53] it isn't possible ? [11:53] Wouldn't know how. [11:54] anyway, back again to your DocBook howto [11:56] do you think it would be easy to convert /wiki/StartingTheJourney to docbook? it [11:56] plain MoinMoin markup [11:56] ChrisH, if you make an alias between ChristophHaas and Christoph Haas then your name becomes clickable [11:57] sivang: trivial [11:57] pl0vs: you mean in the signature? how? [11:58] sivang: why not try it yourself after you have read the mini-tutorial? [11:58] this is what I intend to do :) [11:58] in your homepage: https://www.ubuntulinux.org/wiki/ChristophHaas add an alias "Christoph Haas" [11:58] sivang: I assume your document is quite complete... [11:59] pl0vs: Hmmm. How would I set such an alias? [11:59] ChrisH, press aliases? [11:59] pl0vs: I'm so dumb. :) === sivang just looks at ChrisH list of maintained packages - cream brings back nice memories of some long ago IRC chat on #debian-mentors with Ben Armstrong and ChrisH himself..