/srv/irclogs.ubuntu.com/2010/05/09/#ubuntu-manual.txt

ubuntujenkinswell the dummy package built, how ever ccicons failed again00:15
ubuntujenkinsI think it will try and fix it tomorrow night all00:24
ubuntujenkinswell its already morning here00:25
dakergodbyk, i imported translations from lp03:41
godbykdaker: for the website?03:41
dakeryes03:41
godbykk03:42
IlyaHaykinsongodbyk: ping06:06
ubuntujenkinsmorning all09:39
synergeticmorning ubuntujenkins ^_^09:44
thorwilmorning * :)09:45
ubuntujenkinshello people are wake today09:46
ubuntujenkins*awake09:47
jcisiohello all09:50
jcisiowake up?09:50
jcisionot a good sign: 1169 untranslated yesterday became 1463 untranslated + 300 need reviews, now it is 1463 untranslated + 180 need reviews09:51
jcisiowhere have they gone? !!09:52
jcisiowaiting for a day more, thus, #launchpad seems not very active09:52
ubuntujenkinsjcisio: we are trying our best tor work out what is wrong. #launchpad is usually very good09:53
ubuntujenkins*to09:53
jcisiosure I know ubuntujenkins09:54
jcisiojust see that it is not good timing, and UDS comes close09:54
jcisionice weekend all, bb09:55
Dakergodbyk, any reponse from launchpad ?11:14
godbykdaker: No response yet. I just re-broadcast my request for help. We'll see if anyone's around yet.13:06
godbykI think most the launchpad folks are en route to Belgium at the moment.13:07
godbykwgrant responded yesterday from an airport, but he said he doesn't know much about the translation part of Launchpad, so he couldn't help.13:07
dakerhumphreybc too ?13:07
godbykYep, humpreybc is on his way to Belgium right now.13:07
dutchiehumphrebc has arrived13:07
godbykOh, has he?13:07
ubuntujenkinsyep13:07
godbykHe IMed me when he got on the plane, but I haven't heard from him since.13:07
dutchiehttp://twitter.com/humphreybc/status/1366301006713:07
godbykCool.  I haven't checked my twitter feed yet today.13:08
dutchieyou haven't updated it in a while13:09
dutchieas in 6 months13:10
dutchie:)13:10
godbykheh.. yeah, I don't really tweet.13:10
godbykI don't blog much either.13:10
godbykI should write more. :)13:10
synergeticgodbyk: the reason i switched to twitter was because my family were worried i'd died because i stopped blogging. twitter is lazy blogging, only takes a couple seconds.13:12
godbykI'm going to get a glass of water and then sort through all these UDS sessions and figure out which ones I should attend (remotely) and when I can actually sleep.13:12
godbyksynergetic: That's true. I have trouble compressing my thoughts into 140 characters.  My IRC messages are often longer than that! ;-)13:13
synergeticthe only thing that makes me post at all is to let my family overseas know what i'm up to13:13
godbykMy friends do tend to panic when they see I've been offline for a day or more, though.13:13
synergeticgodbyk: ah, but it forces you to revise until you are able to explain yourself succinctly13:13
synergeticwhich is REALLY good practice13:13
godbykAnd my mother discovered Skype last week.  Not a particularly good thing for me. :)13:13
synergeticonce upon a time you had telegrams and you had to get to the point. these are modern day public telegrams ^_^13:14
godbyksynergetic: True, though I suspect in most cases it causes people to instead simply dismiss the thought of posting anything of substance.13:14
synergeticooooh tough. why my mum discovered instant messenger, she'd message me, then again less than 30 seconds later "are you there???" and less than 5 minutes later she'd be typing caps lock about how i'm ignoring her and don't i want to talk to her13:15
synergeticwhen i was in the other room cooking dinner or something13:15
godbyksynergetic: Almost! If you had to pay per tweet, there'd be a lot less noise and I'd be more likely to read my twitter feed more than once a week.13:15
dutchiei've heard twitter called the UDP of social media13:15
godbykHa! My mom does that with phone calls, though I've weened her off of that.  Now she's discovered Skype (with the webcam, no less!), so she's calling all the time again.13:16
synergeticyeah. well. i have friends who follow me but who i don't follow because they tweet too much. and i'd tell them that i wasn't going to follow them for that reason and to not take it personally13:16
godbykdutchie: So true!13:16
dakergodbyk, i closed the website's translations13:16
dakerhttps://translations.launchpad.net/ubuntu-manual/lucid-e1/+pots/ubu-man-website-translations13:16
synergeticmm yeah. my mum does'nt call me very much. but thank you for reminding me, it's mother's day! i should call her!13:17
godbykdaker: That closed the manual's translations, too.13:17
dakerah o.O13:17
godbykI spoke to my mom yesterday.  She asked me (again) about Netflix and Hulu.13:18
dakeri just set it for the website template13:18
godbykOh, and scanners.13:18
godbykdaker: it affects the entire series, apparently.13:18
godbykdaker: https://translations.launchpad.net/ubuntu-manual/13:18
dakershould i set it as Open ?13:20
godbykI think it was Structured before.13:23
dakerhttps://translations.launchpad.net/ubuntu-manual/lucid-e1/+templates13:24
dakernow it's inactive13:24
godbykdaker: Okay.  You may want to email the list and let them know that if they want to translate the website to go to https://translations.launchpad.net/ubuntu-manual-website13:26
dakeroki13:27
godbykHey, dutchie: https://bugs.launchpad.net/ubuntu-manual/+bug/57773913:28
dutchiei blame l[p13:28
dutchie-[13:28
quickshotdevsdutchie: Error: Missing "]".  You may want to quote your arguments with double quotes in order to prevent extra brackets from being evaluated as nested commands.13:28
dutchiehmm13:29
godbykI'm guessing it's po4a that should set it.13:29
godbykbut I'm not really sure.13:29
dutchiepo4a has set Project-Id-Version containing PACKAGE and VERSION13:30
* godbyk installs gtranslator13:31
synergeticgodbyk: my mum just keeps telling me that skype is broken - so i have to (over the phone) walk through how to fix it. and then it works and then she "breaks" the same way the next time. it's humourous to a point, but only to a point. skype needs a manual.13:36
ubuntujenkinshow does she break skype?13:36
godbykI think lots of things need manuals.  I share the sentiments as a lot of the people mentioned in that article you linked me to.13:36
* godbyk gives up on gtranslator because the interface is so absolutely miserable.13:37
synergeticshe breaks it by switching into the phone tab rather than the skype tab - so she keeps trying to call my mobile phone rather than skype13:38
synergetici because it's still a big greet CALL button so she doesn't notice the change13:38
ubuntujenkinsare I see13:38
synergeticone says CALL PHONE and the other just says CALL so i'm not surprised she gets confused13:38
ubuntujenkinsmakes sense13:39
synergeticbut she doesn't have skype credit so she gets upset that skype won't let her call13:39
synergeticgodbyk: my grandfather buys the manual for everything. it's really funny because he's got just stacks of books on how to use windows, how to use google, how to use a digital camera, everything.13:40
synergeticand he just pores over them - i can't switch him to ubuntu until there's a comprehensive manual13:40
dutchieaha :)13:41
godbyksynergetic: Ah, yeah. I have a grandfather who's the same way.  Unfortunately, most of the manuals he buys are absolutely abysmal.13:41
synergeticgodbyk: oh, they ARE horrible, i've had a thumb through them. but he's so damned independent that he won't ask me or my brother for suggestions13:41
synergetiche'll just get whatever comes up first on amazon13:42
ubuntujenkinshas the skype gui been made open yet?13:42
godbykUgh.  My grandmother (on the other side of my family) is using Ubuntu. She hasn't had too many issues, but I never hear from her when she has problems.13:42
godbykI have to hear from other family members that she was complaining that this or that wasn't working.13:43
godbykI've finally got my mom trained that I'll help her with her Ubuntu issues, but she's on her own with her Windows problems (as I haven't used it in so long, I don't know the answers anymore).13:43
synergeticyeah. only person in my family who uses linux is me - my dad is stopped by the skypephone he has which has windows-only drivers but he gives CDs to everyone13:44
synergeticmy mum refuses to switch because she's had XP since it was new and she doesn't want to learn something new when what she's got serves her fine13:45
godbykI have my mother, grandmother, and brother using it. (Though my brother doesn't use his computer at all at the moment.)13:45
synergeticand my grandfather is determined to having the newest version of whatever MS produce, because that's what most people use13:45
godbykMy mom has a netbook with windows on it, too, now.13:45
godbykI got those family members to switch because I told them that while I was happy to help with with any linux issues they had, I couldn't help them with windows problems anymore.13:46
synergeticyeah. my brother did ubuntu for a month or so but then went back to windows for his games13:46
godbykNeedless to say, there's been a drastic reduction in support calls over the past couple years. :)13:47
synergeticthat's i think why my family don't ask me about computers - because i just tell them to switch to ubuntu.13:47
synergetic^_^13:47
godbykGames! My other brother, who would otherwise probably like linux, has stuck with windows solely because he plays so many games.13:47
synergeticexactly13:47
godbykAnd my two sisters are using windows because they have to run software for school and work that's windows-only.13:48
synergeticah! the mum of one of my old flatmates got her a 10" netbook, put ubuntu NBR on it for her, set it up so she could quickly get to email and internet13:48
synergeticshe was over the moon, because it was such a simple interface13:48
godbyknice!13:48
godbykI haven't played with ubuntu unr yet, but the idea of it appeals to me.13:48
synergeticit's easier to give people who've really used computers much ubuntu to start with - it's the people who use windows just because that's what they've always used that're hard to convert13:49
synergetici'm using NBR with the computer i'm on just now (EeePC901) and it's absolutely fabulous13:49
godbykAgreed.13:49
godbykUsually I've had those folks switch to Ubuntu when they're having so many issues with Windows.13:49
synergeticmy bf uses NBR on his media computer because it's easy to see from a distance13:49
godbykAnd usually they just need Internet a and email.13:50
synergeticyeah - i switched to kubuntu because i'd had so many issues with windows, then switched to ubuntu when they went to KDE4 - i really hate KDE413:50
godbykI used to use KDE eons ago, but there were so many preferences and options scattered all over the place.  I came back to GNOME.13:51
godbykI haven't tried KDE4.13:51
synergeticthe friends i convert at uni switch because they use open office anyway and then they can also get things like Xournal and can more easily get at things on campus through SSH and FTP13:52
godbykCool.13:53
synergeticuhm. i know there was some talk about wanting to do quick getting-started guides - i have a bi-fold flier i made for an install day last year if it would help the cause any13:53
synergetici should have it kicking around here -somewhere-13:54
godbykCool.  Yeah, I'm not sure what all humphreybc has in mind for those.13:54
godbykI think we're also going to try to work with the learning team on some of that material, too.13:54
synergeticcool. it's a PDF if there's anywhere you guys put communal documents? or i can just put it in my dropbox public folder or something in the meantime13:55
synergeticmaybe for inspiration if nothing else, somewhere to start from?13:56
godbykwe don't have a repository yet for it, but if you'd like to put it in your dropbox or email it to me <kevin@ubuntu-manual.org> I can put it up someplace.13:56
synergeticrighto ^_^13:57
synergeticgodbyk: took two tries but i sent it >.< touchpad fail14:12
* ubuntujenkins succes ccicons has built14:12
godbyksynergetic: received it. thanks!14:14
godbykubuntujenkins: awesome! how are the other packages doing?14:14
ubuntujenkinsI am unistalling everything to work out what gets pulled in but is not in the ppa.That way i can wok out what else i need to add to the ppa for pre lucid ubuntu14:15
ubuntujenkinsI think we will have a ppa by next week end easily14:19
godbykcool14:19
c7phello14:41
godbykHey, c7p14:43
ubuntujenkinshello c7p14:44
dakergodbyk, someone want to join https://launchpad.net/~ubuntu-manual-website/+member/xuacusk814:49
godbykdaker: okay14:49
godbykdaker: He's the Asturian translation editor.14:50
dakergodbyk, try to see that https://translations.launchpad.net/ubuntu-manual-website/trunk/+lang/fr14:54
dakerthere are 2 templates14:54
daker????!!!14:54
godbykI see two templates, yeah.14:55
dakerthere is only one pot file in the branch14:55
godbykdaker: there are two:14:55
godbyk./test/includes/languages/ubu_man_website_translations.pot14:55
godbyk./main/includes/languages/ubu_man_website_translations.pot14:55
dakerah14:55
dakerhow to remove the first one ?14:58
dakerhttps://translations.launchpad.net/ubuntu-manual-website/trunk/+lang/fr14:59
dakershould i remove the pot file ?14:59
godbykI think removing the pot file would do it, but I'm not sure.14:59
godbykremember that our current live site is the test/ directory.15:00
dakeri will remove the one in the main folder15:01
godbykokay15:01
ubuntujenkinswho has lucid with no latex/texlive installed? I would like some other testers for the ppa15:08
godbykmy lucid box has the upstream TL2009 installed.15:10
ubuntujenkinsI might do an install on my external disk to test15:12
dutchievirtual machine?15:14
ubuntujenkinsthey are always slow, but that may mean that i can do work at the same time.15:14
dakergodbyk, i can't setup the Priority15:18
dakerhttps://translations.launchpad.net/ubuntu-manual-website/trunk/+templates15:18
godbykdaker: what do you want to set it to?15:20
godbykthe inactive translation has 0 priority, and the other translation has priority 1.15:20
dakeryes that's enough ?15:22
godbykProbably.15:23
godbykI think the priorities only matter in relation to the other translations for that project.15:23
dakerWow the branch history files is big than the website it self15:44
ubuntujenkinswhat has anyone listened to todays full circle podcast? they said we released a quick start guide15:47
godbykubuntujenkins: yeah, I noticed. maybe the docs team released something?15:50
ubuntujenkinsI am not aware of the doc team releasing something like that.15:51
godbykneither am I15:52
ubuntujenkinsfor the dummy package ubuntu-manual-tex do we want bzr as a dependency? That way people have it so they can pull the branch. Or it is not relevant to the latex stuff and we don't want it. The two arguments thoughts godbyk ?15:56
godbykhmm..15:57
godbykmaybe have the -tex package depend only on tex-related stuff15:57
godbykwe could have another dummy package for our tools like bzr, I guess.15:57
ubuntujenkinsthat was more my thoughts but what other tools do we need?15:58
dutchiepo4a15:58
ubuntujenkinsthats need to make the manual so i put it in the -tex dummy package15:59
ubuntujenkinsgodbyk: I am right in thinking this suggests i am missing a font? http://paste.ubuntu.com/43060716:22
ubuntujenkinsI can't find anything in synaptic called pzdr or pzd16:23
godbykubuntujenkins: well, it means that tex can't find it.16:23
godbykubuntujenkins: it comes from the zapfding package, I think.16:23
godbykor the collection-fontsrecommended collection of packages.16:24
ubuntujenkinsI am trying texlive-fonts-recomended16:25
ubuntujenkinsyey as soon as i add texlive-fonts-recomended to the dummy package we have lucid package support16:28
godbykcool16:29
ubuntujenkinsI should at it to a ppa under the project rather than under my name16:30
godbykyeah, that'd probably be better.16:31
godbykI assume you have access/rights to do so?16:31
ubuntujenkinsthere is only one way to find out16:32
ubuntujenkinshmm well i can't make a new ppa the existing one is called ppa:ubuntu-manual/beginnersmanual . I need a team admin to make a new one16:35
ubuntujenkinsI can delete the ppa that is there but not make one by the looks of it16:36
godbykubuntujenkins: let me see what I can do16:36
godbykwhere would I go to create a ppa?16:38
ubuntujenkinson this page https://edge.launchpad.net/~ubuntu-manual under the existing ppa there should be an "add ppa option" I think ben is the only one who can16:38
ubuntujenkinshe appears to be the only group admin16:38
godbykShould I just re-enable the Ubuntu Manual PPA that's there?16:39
ubuntujenkinsI can do that but the name of is "beginnersmanual" is that ok for the tex stuff16:40
godbykew.16:40
godbyknah.16:40
godbykthere are other admins, though.16:40
ubuntujenkinsexcactly16:41
godbyklooks like it doesn't include me, however.16:41
godbykdutchie: you around?16:41
ubuntujenkinsgodbyk: look at https://edge.launchpad.net/~ubuntu-manual/+members and click the status heading only ben is admin16:42
dutchiegodbyk: yes?16:42
godbykdutchie: hook me up with some admin rights on the https://edge.launchpad.net/~ubuntu-manual/+members and/or help us set up a new ppa16:42
ubuntujenkinsdutchie: are you able to make a new ppa on https://edge.launchpad.net/~ubuntu-manual ?16:42
godbykubuntujenkins: he's just the the only admin on that page.16:43
godbykit's only sorting that single page of the list.16:43
ubuntujenkinsare makes sense16:43
dutchiehmm16:45
dutchiecan't work out how to adminify people16:46
ubuntujenkinsdutchie: on the page https://edge.launchpad.net/~ubuntu-manual/+members you should see a yellow circle with a ! click that and you can change it then16:47
dutchiehttps://edge.launchpad.net/~ubuntu-manual/+member/godbyk16:47
ubuntujenkinsi can't view it16:48
godbykfrom here: https://help.launchpad.net/Teams/CreatingAndRunning it sounds like only owners can make admins.16:48
godbykheh.. I can't view that page either.16:48
godbykNow I want to know what it says about me! :)16:48
ubuntujenkinsonce we have a ppa I have made a script to transfer the packages17:04
ubuntujenkinsdutchie: are you able to make a ppa please?17:05
dutchiesure17:05
ubuntujenkinswhat should we call it?17:05
ubuntujenkinsgodbyk: ^17:05
godbykwhat all is going to be in the ppa?17:06
ubuntujenkinssame stuff as in https://edge.launchpad.net/~ubuntujenkins/+archive/ubuntu-manual/+packages and anything needed for earlier versions of ubuntu17:06
godbykshould we just call it ubuntu-manual and put all our packages in there?  what are the benefits of having multiple PPAs?17:07
dutchiestill needs a name17:08
ubuntujenkinsWe could have a release ppa and a daily build one if we wished17:08
dutchieand a display name17:08
godbykhow about ubuntu-manual for the release versions of stuff and ubuntu-manual-daily for the daily builds of things?17:09
ubuntujenkinswhat about the tex stuff? I am not building that daily17:09
ubuntujenkinsput that in ubtuntu-manual17:09
godbykyeah, just drop that in ubuntu-manual, I'd think.17:09
godbykunless you think it should be segregated into its own ppa.17:10
dutchieand the display name?17:10
godbykUbuntu Manual Releases and Ubuntu Manual Daily Builds?17:10
ubuntujenkinsUbuntu Manual Releases is fine don't worry about dailies yet17:11
godbyksounds like a plan.17:11
ubuntujenkinswe have nothing for the dailies17:11
godbykI figure we can always change it up later if we really need to17:11
godbykyeah, nothing for dailies yet.17:11
ubuntujenkinsyep17:11
godbykthough I could start building daily PDFs.17:11
godbyknot sure if it'd be helpful for anyone or not.17:12
ubuntujenkinsnot helpfull untill i have made the ubuntu-manual program17:12
dutchiehttps://edge.launchpad.net/~ubuntu-manual/+archive/ubuntu-manual17:12
ubuntujenkinsthansk dutchie17:13
dutchienp17:13
ubuntujenkinsand i am able to upload stuff to it17:16
godbykcool17:17
ubuntujenkinshow are we going to promote / suggest the ppa?19:01
ubuntujenkinsI should mail the list i assume19:01
ubuntujenkinshey SunK how are you?19:01
godbykI'd mail the list and have a couple people test it out.19:03
ubuntujenkinswhat is the correct way to remove upstream tex if they have it?19:03
godbykI've been just suggesting 'apt-get remove texlive-*' but that leaves behind a few things in packages named otherwise.19:04
godbykshouldn't our packages have larger version numbers, so it'd just be an upgrade?19:04
ubuntujenkinsI ment the one the website curently suggests. I will double check but it think i set the version numbers higher.19:05
dutchiethere is a thing on ppa versioning19:05
ubuntujenkins*the way of instaling tex that the website suggests19:06
dutchiehttps://help.launchpad.net/Packaging/PPA/BuildingASourcePackage#versioning19:06
ubuntujenkinsok i need to change the version numbers19:08
ubuntujenkinsI finish my matlab then i will fix it19:09
=== Daker is now known as daker
IlyaHaykinsonping godbyk19:23
godbykIlyaHaykinson: pong19:26
IlyaHaykinsoni wanted to start the discussion about file formats for maverick19:27
godbyksure19:27
IlyaHaykinsoni've been looking at DocBook, and i think it could do everything we need, especially if we greatly limit the subset of allowed tags19:27
IlyaHaykinsonfrom there, we can write a converter into our LaTeX commands19:28
IlyaHaykinsonfor the web site, we can make the system manipulate a database of docbook snippets19:28
godbykbe with you in just a moment.19:29
IlyaHaykinsonok19:29
godbykskyping with the parents.19:29
godbyk:-/19:29
godbyk(still on skype) daker forwarded this link to me the other day: http://doc-book.sourceforge.net/homepage/19:41
godbykokay, off skype now.19:42
IlyaHaykinsonbrt19:42
godbykI think the docbook wiki site looks like what we want (heavily modified, of course)19:42
godbykwe'd need to give it a UI overhaul, change it so the wiki is more moderated19:43
godbykbut it stores the underlying data in docbook format.19:43
godbykyou might also look at mallard: http://projectmallard.org/19:43
godbykthat's what the gnome docs are headed to.19:43
godbykin any case, I think we will want an online GUI editor so that no one has to mess with the underlying markup language.19:44
dakertinymce ?19:45
godbykhttp://tinymce.moxiecode.com/19:46
godbykI'll look at it.19:46
godbykbrb19:46
godbykback now.19:49
IlyaHaykinsonam back19:49
dakergodbyk, what about tinymce ?19:49
godbykdaker: How does it store the text? html?19:50
dakerthere 2 choices plain text(with tags) or html19:50
dakerare*19:50
godbykwe'd have to modify it to use some custom tags, too.19:51
godbyk(for screenshots, for instance.)19:51
dakerwe can19:51
IlyaHaykinsoni think mallard is a little more immature than docbook, which has a lot more semantic markup possibilities19:53
godbykOnce we have an idea of what we're doing, I think we're going to have to get some more people to help with this new website.  daker may go crazy trying to do it all by himself. :)19:53
godbykmallard is younger than docbook, that's for sure.19:53
dakergodbyk, :D19:53
godbykbut since all the gnome docs (and presumably the ubuntu docs) are headed that direction, if it's robust enough for our needs, it would make interoperability a bit easier.19:54
ubuntujenkinswhich one are the docs team are using? mallard or docbook?19:54
IlyaHaykinsonmost gnome docs are in docbook though19:54
godbyk(though it would hopefully not be too difficult to translate the mallard xml to and from the docbook xml)19:54
IlyaHaykinsonfor example, here's evolution: http://svn.gnome.org/viewvc/evolution/trunk/help/C/evolution.xml?revision=37459&view=markup19:54
godbykwell, mallard is what yelp will be using.19:54
godbykso when you go to System > Help and Support.. that stuff will (eventually) be mallard-based.19:55
IlyaHaykinsonand mallard claims to specifically be for topic-oriented (non-linear) help19:55
godbykyeah, that's true.19:55
IlyaHaykinsonhonestly, mallard seems like it's not much better than authoring in a subset of HTML19:55
IlyaHaykinsonthere are very few tags, which means that the semantic meaning is often lost19:56
godbykfair enough.19:56
IlyaHaykinsonwhereas authoring in docbook appears to be more complex because of the hundreds of tags, but on the other hand carries over a lot of meaning19:56
godbykdoes docbook handle everything we need?19:56
IlyaHaykinsonso far as far as i can see, yes.19:56
godbykokay.19:56
IlyaHaykinsonmaybe except for screenshotTODO19:56
IlyaHaykinsonand not sure about todo itself19:56
godbyksurely it's not too difficult to add tags...19:57
IlyaHaykinsonbut it even has markup equivalent to \menu{foo\thenbar}19:57
godbyknice.19:57
IlyaHaykinsonwell, adding tags -- of course not hard. though if possible, we should strive to stick with the standard19:57
godbykif we use docbook as our base, we'll need to make sure we have great tools to hide that underlying markup.19:58
IlyaHaykinsoni think a lot of it could be hidden by allowing text->docbook transformation19:58
godbykso we have some control over the tags used (for consistency) and make it as easy as possible for people to write and edit content without getting caught up in all the markup.19:58
godbykgoing from docbook to tex is easy enough.. an xslt could do that.19:59
IlyaHaykinsonyeah; writing markup is certainly not as friendly as writing LaTeX, even19:59
godbykwe'll just have to add in an editing step on the generated .tex file to make sure everything looks great typographically.19:59
godbyk(though that step is already there.19:59
IlyaHaykinsonnod.19:59
godbykI did it with the english version19:59
godbykand we're going to have to do it for the translated versions, too.)19:59
shriniteam20:01
shrinineed help20:01
shrinihow to work on translating the website?20:01
godbykHey, shrini. What's up?20:01
shrinigodbyk: hi20:01
shrinihow are you?20:01
shrinitook so long to hang here20:02
shrini:-)20:02
godbykshrini: Head over to https://translations.launchpad.net/ubuntu-manual-website, select your language.20:02
IlyaHaykinsongodbyk: there's a question of storage, too; one way is to have each "page" on the site be a file in bazaar; we'd allow editing on a per-paragraph basis (<para> in docbook) and just make the change directly to the underlying xml file20:03
IlyaHaykinsonthen queue up the change for review20:03
IlyaHaykinsonanother option is to have a database of paragraph / step snippets20:03
godbykIlyaHaykinson: I think we may want to have a database sitting in the someplace to assist with searching/indexing.20:04
IlyaHaykinsonand have _all_ work use this system, perhaps generating a complete xml file as a result20:04
godbykright.20:04
shrinigodbyk: thanks20:04
IlyaHaykinsonthe downside, though, is that when authoring we'd need a lot more tools20:04
shrinigot it20:04
IlyaHaykinsonto allow writing multiple paragraphs at once20:04
godbykshrini: no problem. let us know if you have any other questions or run into problems.20:04
thorwilgodbyk: do you have experience with xslt?20:04
shrinisure godbyk. thanks a lot20:05
godbykthorwil: a tiny, tiny bit.20:05
godbykthorwil: at this point, I'd have to relearn it all, I think. it's been quite a while.20:05
shrinigot my brother to work on translating to tamil20:05
shrinihe finished exams20:05
godbykshrini: awesome!20:05
IlyaHaykinsoni've done a bunch of xslt work a while ago too...20:05
IlyaHaykinsonbeen ~4 years though, probably20:05
godbykwow.. it's probably been about that long for me, too.20:06
thorwilok. otherwise i would have to warn you that xslt is a ... thing of its own20:06
godbykall my transforms were pretty simple, too, as I recall.20:06
* godbyk makes a note that thorwil is now the resident xslt expert.20:06
IlyaHaykinsonmeh. i was doing transforms from XML into a text-based EDI data format (ANSI 837), yuck.20:07
godbykoh, <gag>20:07
thorwilgodbyk: i only looked at it long enough to become frustrated20:07
godbykIlyaHaykinson: I think the database-backend approach may give us more benefits, and we can always generate xml files from that.20:08
godbykFile backends almost never turn out to be a good idea.20:08
godbykespecially when they're as linear as xml is.20:08
IlyaHaykinsonyes, though we would need to then accommodate a lot of different types of data20:09
IlyaHaykinsoni.e. paragraphs, lists of steps20:09
IlyaHaykinsonwhere each would be a stored unit20:09
IlyaHaykinsoni suppose each could then be a unit of translation, too20:09
godbykright.20:11
godbykif we had our own translation stuff, we wouldn't have to worry about launchpad's shortcomings (just our own).20:12
godbykbut it'd allow us to do nicer string manipulations (comparisons, parsing, etc.)20:12
thorwil_we should use a unit tested no-sql distributed cloud storage solution with an enterprise level object-node mapper with a collaborative realtime editing ajay/comet low-latency frontend20:13
godbykthorwil_: Whatever, Mr. XSLT!20:14
thorwil_lol20:15
IlyaHaykinsonwe could just use pootle20:16
IlyaHaykinsonespecially so if we write the new system on top of Django or something like that20:16
godbykSomething fancy we could do fairly easily: Pull all the translated strings from the software we're documenting.  When a translator is working on the section about F-Spot, for instance, we could auto-translate the \menu, \button, and other GUI elements using the strings from the F-Spot translations.20:16
godbykyeah, pootle looks fairly comparable to launchpad's translations stuff.20:16
IlyaHaykinsonnifty idea.20:16
IlyaHaykinsonthorwil_: true, could use a nosql store, though perhaps then we'd lose some of the indexing / searching approaches20:17
godbykinstead of suggesting paragraphs at a time, we could actually do sentence segmentation and suggest each sentence. this would help when we, say, combine two paragraphs into one para.20:17
IlyaHaykinsonthat said, both mongodb and couchdb have some indexing support20:17
IlyaHaykinsoni think paragraphs are more logical units, though.20:18
godbykwe could also show the diff between the suggested fuzzy string's source and the source of the current to-be-translated string, so the translator can see what change she'd have to make in her translation.20:18
thorwil_IlyaHaykinson: it was just a buzz word collection :/20:18
IlyaHaykinsonthere are so many sentences...20:18
IlyaHaykinsonthorwil_: ;-)20:18
godbykI think paragraphs are a good unit, yes.20:18
godbykthe sentence segmentation is primarily to help with fuzzy translation string matching.20:19
IlyaHaykinsonwell, we could just segment out things that are marked up20:19
godbykto reduce the amount of time the translators spend retranslating nearly identical text over and over again20:19
thorwil_sentences are not useful as unit when it comes to translations20:19
IlyaHaykinsoni.e. menu names would be in some sort of <menu> tags.20:19
godbykit sucks that they currently have to retranslate the entire paragraph when we, say, add or remove a single comma.20:19
IlyaHaykinsonwell, we could add change detection.20:20
godbykyeah.20:20
IlyaHaykinsonso that if it's a minor change, we don't flag the para for retranslation20:20
IlyaHaykinsonperhaps merely for review20:20
godbykbasically, any small thing we can do to help the translators would go a long way.20:20
IlyaHaykinsonalso, we would match units within the paragraph20:20
godbykand highlight the change, so it's obvious.20:20
godbykyes, that's what I was referring to with the sentence-segmentation talk.20:21
IlyaHaykinsonso if the text is "....<menu>blah</menu>..." then the <menu> could have an id attribute20:21
IlyaHaykinsonand then we would auto-translate those based on the previous translation20:21
thorwil_it's rather obvious what you could do to ease translations, but it gets very complicated regarding implementation soon20:21
IlyaHaykinsonbut i think this could work at the para level, not just sentences20:21
godbykIlyaHaykinson: I agree.20:22
godbykthorwil_: perhaps. but anything worth doing is complicated. :)20:22
godbykIn general, software should be a heck of a lot smarter than it currently is.20:22
godbykAs programmers, we too often take the easy way out.20:22
godbykSometimes citing lack of information/data to make the right decision (instead present an option to the user).20:23
godbykSometimes just claiming it's too hard or it'll take too long.20:23
godbykBut in the end, it all results in the same thing: dumb software.20:23
dutchiegodbyk's suddenly come over all philosophical20:23
godbyk</suspends rant>20:23
thorwil_godbyk: my fingers are itching to have a go with smalltalk/seaside or scala/lift, but what i have in mind would be a job for 2 or 3 competent developers, at least20:24
godbykI hear ya.20:24
godbykI think if we're setting out to do this thing, we'd best do it well.20:24
godbykOtherwise, we'll be just another website with documentation on it.20:25
thorwil_and all the technological choices that look good to me also cut out a lot of people who would run with php, rails or django20:25
godbykAside from failing to attract contributors (developers, editors, authors, translators, et al.), it's also *boring*. :)20:25
IlyaHaykinsoni wouldn't mind having a go with it being in, say, django.20:26
IlyaHaykinsonthough yes, a scala-based system could be nifty20:26
godbykthorwil_: We're also currently hampered a bit by my web host. We can't do anything CPU intensive. And any non-standard software means I have to compile it myself and let it reside in my home directory. (I don't have root access.)20:26
godbykIt we start getting too crazy, we'll need to find another hosting solution.20:26
thorwil_vserver at least :/20:26
godbykRight.20:27
godbykI'm willing to manage a vserver, but we'd have to figure out how to pay hosting fees.20:27
IlyaHaykinsoni don't think this would be too big of a problem20:27
IlyaHaykinsoni have a machine we could use, for some time at the very least20:27
godbykIlyaHaykinson: duly noted.20:27
thorwil_one can have one for very few euros/month, but i have no clue about actual needs (cpu/ram/space)20:27
IlyaHaykinsondatacenter hosted; a bit old but usable.20:27
IlyaHaykinsonand it's a phyiscal box20:27
IlyaHaykinsonphysical, even20:28
godbyknice!20:28
godbykSo are we fairly convinced that docbook is the way to go for the underlying markup of the master doc?20:28
IlyaHaykinsonalso, after benjamin builds connections with the ubuntu folks, he should be able to swing us a canonical-owned server or something like that20:29
thorwil_godbyk: i think that if xml is of advantage, docbook is the way20:29
godbykIlyaHaykinson: That'd be quite nice.20:29
IlyaHaykinsoni think so far, docbook seems the best20:29
godbykSounds like a plan then.20:29
godbykSo what's next?20:30
ubuntujenkinsapt-get install doc-book20:30
ubuntujenkins:)20:30
godbykheh20:30
ubuntujenkinsnot sure thats the right name20:30
godbykno hyphen20:30
godbykand there are a ton of docbook* packages.20:30
godbykoh, cute. there's a docbookwiki package, too.20:31
ubuntujenkinstheres no docbook-full20:31
* thorwil_ goes back to drawing20:31
ubuntujenkinshmm so how do we write docbook? I only learnt latex since starting the project20:32
godbykubuntujenkins: well, docbook is somewhat akin to html.20:33
godbykbut more semantic markup.20:33
ubuntujenkinsI don't think i will get time to help write this release but I would like to know how to do it so that i can help others20:34
IlyaHaykinsonhttp://svn.gnome.org/viewvc/evolution/trunk/help/C/evolution.xml?revision=37459&view=markup20:34
IlyaHaykinsonas an example of a complete manual in docbook20:34
IlyaHaykinsonhttp://www.docbook.org/tdg5/en/html/ch02.html for a more structured introduction20:34
ubuntujenkinswow that looks harder to lean than latex would our translators have to learn it?20:35
godbykubuntujenkins: that's why we're gonna have to write a web-based editor that hides all the markup and has pretty buttons to click on.20:37
godbykkinda like: http://tinymce.moxiecode.com/examples/full.php20:37
godbykbut with semantic markup instead of low-level formatting.20:37
ubuntujenkinssounds good to me i wasn't really reading irc much20:38
* ubuntujenkins hmm I have just filled our ppa to its limit20:38
godbykuh oh20:39
godbykdidn't they just increase the limits the other day, too? :)20:40
ubuntujenkinsits all good, I will just remove them and then add them from my ppa.20:40
ubuntujenkinsits they way that i am changing the version number that is causing it20:41
* ubuntujenkins now to wait untill my package deletion request is done20:43
IlyaHaykinsonactually i'm not sure we need to write a web editor20:45
IlyaHaykinsoni think we can allow just text-bsaed entry20:45
IlyaHaykinsonbe back in an hour20:48
IlyaHaykinsongodbyk: ping22:34
godbykIlyaHaykinson: pong22:34
IlyaHaykinsonto continue the discussion about docbook...22:35
godbyksure22:35
IlyaHaykinsoni think we have two different modes of editing22:35
IlyaHaykinsonone is for writing lots of content (the style of writing/editing we had for lucid-e1)22:35
IlyaHaykinsonone is for making corrections on the website, typically one para at a time22:35
dakerthe second one is better i think22:36
IlyaHaykinsonwell, i think both are necessary22:36
IlyaHaykinsonat different times.22:36
godbykRight.22:36
IlyaHaykinsonif we have small units on which we allow people to work (paragraphs for example), we allow the second use case.22:36
IlyaHaykinsonbut make the first one rather tough22:36
IlyaHaykinsonbecause then we need the ability to insert, append, prepend sections22:36
IlyaHaykinsonand to select section types22:36
IlyaHaykinsonand rearrange sections22:37
IlyaHaykinsonetc.22:37
godbykYep22:37
IlyaHaykinsonand every long piece of text becomes a pain to write22:37
IlyaHaykinsonon the other hand, if you treat the entire document as one big unit22:37
godbykFor writing content, it should be a free-form editor that allows for multiple paragraphs.22:37
godbykThe finer details and translations can be handled per paragraph, I think.22:37
IlyaHaykinsonthen writing lots of text becomes easy, but smaller scale editing is a (text processing) pain22:37
IlyaHaykinsonso how about this...22:37
IlyaHaykinsonwe store data at the paragraph (or other similarly sized section) level22:38
IlyaHaykinsonbut we allow a one-time import of large amounts of text which we parse into paragraph units22:38
dutchiewe'd probably also need a high level interface for shifting content around22:38
IlyaHaykinsonright, and then provide some ability to rearrange stuff22:38
dutchieand modify sections/chapters22:38
IlyaHaykinsonand also a way to replace several paragraphs at once with another larger-file reimport22:39
godbykThat sounds like it'd work, IlyaHaykinson22:39
IlyaHaykinsonwe'll likely need a few different types of "units"22:39
IlyaHaykinsonparagraphs, steps, screenshots, terminal examples22:39
IlyaHaykinsonso ok. next problem.22:39
IlyaHaykinsoni think it's way over-ambitious to create a tinymce-like editor for docbook22:40
IlyaHaykinsoni'd just come out and say that it won't happen.22:40
IlyaHaykinsonso, what about a slightly-content-aware plain text editor22:40
IlyaHaykinsonso basically, let's say you're editing a paragraph that looks like the following:22:40
dutchiewe have enough over-ambition on this team ;)22:40
IlyaHaykinson"abc def <menu>File<submenu>Save</submenu></menu> ghi jkl"22:41
IlyaHaykinsonwhen you try to edit it, we just show you "abc def File Save ghi jkl"22:41
godbykI looked at the TinyMCE and they do have something that allows it to output bbcode in addition to html.22:41
IlyaHaykinsonthen, we look at what you've changed. if you change things before or after the <menu> nodes, then we allow the change to go through22:41
godbykSo it may be easy to have it dump docbook, too.22:41
godbykI'm not sure.22:41
IlyaHaykinsonif you change File or Save then we match up the tokens to the original ones22:42
IlyaHaykinsonif we can22:42
IlyaHaykinsonand if we don't know what happened, we turn it into plain text22:42
IlyaHaykinson_BUT_, at the same time, each change is stored as a revision22:42
godbykthat gets a bit tricky, because then we have to track things like' should this empty element exist? or did they mean to remove it?22:42
IlyaHaykinsonright.22:42
IlyaHaykinsonbut we provide a level of perceived risk with each changeset22:42
godbykhere's the tinymce bbcode example: http://tinymce.moxiecode.com/examples/example_09.php#22:43
IlyaHaykinsonso let's say we know for sure that "abc" changed to "zzz" but nothing else got touched22:43
IlyaHaykinsonin that case, we allow the change to take place22:43
godbykI'll have to download the tinymce code and look at it to see how easy/hard it'd be to bend it to our will.22:43
IlyaHaykinsonhowever, if the change affected the original layout, we mark it as high risk and require docbook-level recoding22:43
godbykso have human-editor intervention?22:44
IlyaHaykinsonwell, the thing is, i don't know if we should allow "the public" to write pure docbook code22:44
godbykfor handling markup?22:44
IlyaHaykinsoni would rather take changes that have no markup22:44
IlyaHaykinsonand re-mark it up22:44
IlyaHaykinsonor, as i was suggesting, apply some smarts and in some cases re-mark it up automatically if we can be sure that the changes didn't affect the markup22:44
godbykif they can't do it easily (gui/wysiwyg), then yeah, it's probably better if a human editor intervenes with the docbook markup22:44
IlyaHaykinsonright.22:45
IlyaHaykinsonand we can always allow an option, while editing, to edit the raw markup code (for those who know it)22:45
IlyaHaykinsonthis way the general public can submit changes without knowing any of the complexity of docbook22:45
IlyaHaykinsonwhich is the biggest problem with docbook, imho.22:45
godbykI agree.22:46
IlyaHaykinson(there are so many tags that while semantic knowledge is retained, human editing becomes tough)22:46
godbykthat's why I was hoping to avoid docbook for as long as possible. :)22:46
IlyaHaykinsonnod. but if we can make two rules22:46
IlyaHaykinson1) we only use a subset of docbook as per a style guide, and22:46
IlyaHaykinson2) mere mortals (non-UMP members) are not expected to know docbook22:46
IlyaHaykinsonthen i think we'll be able to use the full power of docbook22:47
IlyaHaykinsonwithout incurring the cost of complexity for casual editors22:47
IlyaHaykinsonover time, as we have more development time, maybe we can allow some super-simple markup in the editor22:47
IlyaHaykinsonbut initially we'd just take raw text22:47
godbykthat sounds like a plan.22:48
godbykI've looked at the bbcode plugin for tinymce22:48
godbykand it's just doing a find/replace on the generated html to convert it to bbcode tags.22:48
IlyaHaykinsonnod. i figured it'd be something like that.22:49
IlyaHaykinsontinymce is really oriented at HTML, from what i can see22:49
godbykI'll also have to look at how easy/difficult it'd be to add our own semantic markup buttons to the editor.22:49
godbykyeah, it is.22:49
IlyaHaykinsonok, let me put together a quick document of this idea -- i'll mail something out later tonight22:50
IlyaHaykinsoni think we can make it work.22:50
godbykokay, sounds good.22:50
godbykI think we should definitely jump in and get started on this stuff -- especially if we're going to try to pull it off in time for maverick.22:51
godbyksomething else I'd like to see in our editor (plain text or otherwise) is some as-you-type checks against our style guide rules.22:51
godbykcheck for spelling, grammar, usage, etc. as much as possible.22:51
IlyaHaykinsonwell, perhaps instead of as-you-type, just at <Submit> time or whatnot22:53
IlyaHaykinsoni.e. a quick check once you send the snippet to the backend22:53
godbykDoes anyone know, the UDS schedule (for example: http://summit.ubuntu.com/uds-m/track/community/) -- are those times UTC or Belgium local?22:53
godbykSure.22:53
godbykJust something that can be done at the time of editing/writing.22:53
godbykSo we can avoid revisiting that text if possible.22:54
IlyaHaykinsoni'm sure they're local. brussels is UTC+2, so otherwise the sessions would start at 7am22:54
IlyaHaykinsoner, 11am.22:54
godbykThat's what I figured.22:54
godbykwell, this week will be fun for me, then, I guess. :)22:56
IlyaHaykinsonyou're going to stay up to participate by irc?22:56
godbykI'm gonna try.22:56
IlyaHaykinsoni don't think they have live streaming...22:56
godbykThere are a few sessions I want to hit up.22:56
godbykI thought they were supposed to have live streaming.22:56
ubuntujenkinsI think that they have live streaming icecast.ubuntu.com iirc22:57
godbykSome UX sessions and some sessions related to the manual (docs and translators).22:57
ubuntujenkinsI don't think i can make many due to lots of lectures and tones of uni work :(22:58
dutchieAHA22:58
dutchiei know what happened to the translations22:58
ubuntujenkinswhat?22:59
godbykdutchie: do tell!22:59
dutchiethe translation focus got set to lucid-e2 a little while back, and they must have been done on that22:59
godbykwhat?!22:59
dutchiethen when I switched it back to lucid-e1, they didn't get backported22:59
dutchieor they did, but only as suggestinos22:59
ubuntujenkins+1 to godbyk22:59
quickshotdevsFactoid '1 to godbyk' not found22:59
dutchiedon't know how it happened22:59
dutchiei was looking at them for some reaso23:00
dakerubuntujenkins, the link doesn't work23:00
godbykweird.23:00
godbykI wonder how/when it got switched to lucid-e2.23:00
godbykmost of the translators reported that the flood of suggestions occurred just a day or two ago.23:00
godbykwhen did you change the focus back to e1, dutchie?23:00
dutchieweek or two ago23:00
dutchiehmm23:00
dutchiemaybe it's not23:01
dutchie:(23:01
ubuntujenkinsdaker: I just rememberd that I don't actually know it have a look on the wiki somewhere23:01
godbyk(Getting more hate mail from translators.)23:01
ubuntujenkinsyep seen it23:01
godbykI haven't got a useful response on #launchpad yet.23:01
godbykwgrant wrote me back and said he didn't know anything about the translation side of launchpad.23:02
godbykother than that, no responses.23:02
godbykThe translations look really messed up right now: https://translations.launchpad.net/ubuntu-manual23:04
godbykSort by status.23:04
godbykI think there used to be a lot more of them that were farther along than that previously.23:04
ubuntujenkinsI think that it would be easier to paste the po file in etherpad and have the translators translate in that23:04
ubuntujenkinsI would agree with that godbyk23:05
godbykwtf?23:05
godbykthis is getting frustrating.23:05
godbykI'll ping #launchpad with our problem again, but I'm not holding my breath.23:06
dutchiestupid uds23:06
dutchieanyway, i have an early morning23:07
dutchienight23:07
godbykWe should send humpreybc out to track the launchpad guys down and demand answers.23:07
godbykg'night, dutchie23:07
ubuntujenkinsnight dutchie23:07
dakergodbyk, yes23:08
IlyaHaykinsongodbyk:  i'm going to work on a doc to describe the docbook proposal; do you want to try to craft a mini-sample of some short chapter (or other section) from our current manual in docbook format?23:09
IlyaHaykinsonit may help to have an example23:09
godbykIlyaHaykinson: I can try, yeah.23:09
IlyaHaykinsonif you have time, that'd be awesome.23:10
godbykI'm just glancing through the pootle site right now... Wondering if we wouldn't be better off cutting our losses and migrating translations to our own installation of that or something.23:10
IlyaHaykinsoni looked at pootle earlier. seemed like it can totally do our work.23:11
IlyaHaykinsonthe creative commons uses it23:11
IlyaHaykinsonhttp://translate.creativecommons.org/23:12
godbykcool23:13
godbykthe interface looks nice23:13
godbykI think it'll take a bit of time to get it set up properly.23:13
godbykWhat would we lose by ditching Launchpad for translations?23:14
IlyaHaykinsonauth23:14
godbykLess tightly-integrated bzr?23:14
godbykauth23:14
godbykkarma23:14
IlyaHaykinsonyeah, but, well, screw karma23:14
godbykshared strings with other projects (though we don't have any of those, I bet)23:14
IlyaHaykinsonif it means getting rid of these headaches23:15
godbykno doubt23:15
IlyaHaykinsonhm, well, we can always query launchpad for other translations23:15
IlyaHaykinsonwe just couldn't be a source for them23:15
IlyaHaykinsonbut, well, neither is any of the gnome stuff23:15
godbykshared strings isn't much of an argument as I could probably seed those strings for pootle anyway23:15
IlyaHaykinsonnod23:17
godbykall right.  I'll add that to my list of things to look into this week, I guess.23:17
godbyklemme see if I can find the docbook tags and whatnot and convert some tex for ya23:17
IlyaHaykinsonhttp://www.docbook.org/tdg5/en/html/ch02.html is a good start23:22
godbykthanks23:23
godbykI have entirely too many windows open.23:23
godbykI think I'm going to cheat and just create a couple more workspaces. :)23:23
godbykIlyaHaykinson: are you wanting just some interior text or do you want the document structure and stuff, too?23:24
IlyaHaykinsonmore the text, i think23:25
dakerIlyaHaykinson, http://www.writingopensource.com/forums/tech-and-tools/online-docbook-editor23:25
dakerhttps://edit.php.net/23:26
dakerhere is the branch http://cvs.php.net/viewvc.cgi/doc-editor/23:26
IlyaHaykinsonnod. looks unmaintained though23:28
godbykoh, daker: we can probably remove the vrac mirror now that things have settled down.  we can add it back in later if we need to.23:29
dakeroki23:29
xuacuhi!23:30
ubuntujenkinshello xuacu23:30
IlyaHaykinsonalright, gtg, bbl23:40
ubuntujenkinsnight IlyaHaykinson23:40
ubuntujenkinsnight all23:51

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