/srv/irclogs.ubuntu.com/2010/01/28/#ubuntu-manual.txt

dutchiehumphreybc: get my "answering machine" messages?00:14
humphreybcsure did00:14
dutchiealso, I fixed the planet00:15
humphreybcyup saw that, sweet as00:15
humphreybcwhat's the new branch dutchie?00:21
humphreybctesting translations?00:21
dutchieI set up auto translation exports00:21
dutchienot going to blat them straight into the main branch until I've tested things out00:22
humphreybchaha fair enough, good thinking00:24
humphreybcso they're auto exports?00:24
dutchieyep00:24
humphreybccool00:24
humphreybchow'd you do that?00:24
dutchieset the launchpad "auto export branch"00:24
humphreybcah00:25
dutchiealmost tempted to try setting a bzr pre-commit hook to update the translations00:26
dutchiebut I'm busy writing now :)00:26
godbykdutchie: Are you the translations guy?00:37
godbykI've been playing with them (on the LaTeX side).00:37
dutchiegodbyk: ah yes?00:37
godbykYeah, I've updated the Makefile to build and compile the translated manual.00:38
godbykAnd that generally works..00:38
godbykBut now I have to find some typefaces that support all the scripts/languages we're translating to.00:38
godbykThat's proving to be more difficult.00:38
* dutchie looks into bzr hooks to update the pot file on each commit00:39
humphreybcIlyaHaykinson: Thomas Cantera has signed on to write chapter 200:45
godbykwhen the translators get an updated file, does it show the diff so they can see what changed? or are they continuously retranslating the same stuff repeatedly?00:45
dutchiegodbyk: I think LP is intelligent enough not to translate the same thing over and over00:46
godbykcool.  was just curious.00:46
humphreybcgodbyk: how do I do a copyright symbol?00:57
humphreybc(For windows)00:57
dutchiedo you really need to?00:58
humphreybcit's the first time we mention it i think00:58
humphreybcin the prologue00:58
dutchieI thought it was enough to credit it somewhere00:58
humphreybcokay00:58
dutchieIANAL etc etc00:58
humphreybcwell i suppose we can figure that out down the track00:58
godbykhumphreybc: \textcopyright{}, I think will do it.00:59
godbykThere's one on the copyright page (in frontmatter/copyright.tex, I think)00:59
godbykOh, you mean a registered trademark symbol or somesuch instead, I think.00:59
godbykdidn't we decide not to use those?01:00
humphreybci think so01:00
humphreybcofftopic, what's the "version 1.0" on the copyright page for?01:00
godbykhumphreybc: Erm.. I think that was left over from the copy/paste from another book I worked on.01:00
humphreybcand is it possible to make the bottom margin a bit smaller? we could probably save a tonne of pages that way01:00
humphreybcokay i'll fix up the copyright thing now01:01
godbykhumphreybc: yeah, yeah.. the whole design is getting a facelift. :-)01:01
humphreybcho?01:01
humphreybcoh*?01:01
godbykyep.01:01
humphreybccool what's changing?01:02
godbykpretty much everything will be redone so it works better with whatever page sizes and fonts we end up using, etc.01:02
humphreybccool01:02
humphreybcwill it save some file size?01:02
godbykeverything that's there now is pretty much just placeholder until I get time to do it right.01:02
godbykI don't know how it'll affect the file size.01:02
humphreybcrighto01:04
humphreybci've got a question01:04
humphreybcwith PDFs01:05
godbykfire away01:05
humphreybcwould there be a difference in file size if you had the same amount of content squeezed into less pages, rather than more pages but the same content?01:05
humphreybclike would adjusting the margins and font size, therefore reducing page count save file size?01:05
godbykWell, there's a little overhead for a new page, but I don't think it'd matter too much.  Just guessing, though.01:06
godbykProbably a little bit.01:06
* dutchie wonders if it's worth pointing out that it should be "fewer pages"01:06
godbykBut compared to loading the PDF with screenshots and embedding fonts, I don't think it'll matter much.01:06
humphreybcokay. well every kilobyte counts01:06
godbykOnce we have all the content, we can see about optimizing the PDFs for size.01:07
humphreybcswell01:07
humphreybcdo you know of any comparable documents on the net, examples etc... that have about 80 pages with screenshots?01:07
humphreybcso that we can get a rough idea of their size01:07
godbykHmm.. not right off.01:08
humphreybcokay well if you come across something similar to ours, then see what the file size is01:09
humphreybcthe "makeuseof.com" Karmic bible has 52 pages, a fair amount of screenshots and it's 1.4mb01:11
humphreybcI think as long as we're under 2mb we should be okay. I'll talk to Jorge Castro, who packages up the example content for Ubuntu, and see what he says. He told me a couple of weeks ago that he could get rid of a lot of crap that's currently example content and put our manual in place01:12
godbykWhat are the limits we're allowed?01:13
godbykThe manual as it stands now is ~500K.01:13
humphreybcthere's no limits on the size01:14
humphreybcbut the smaller it is, the more chance we have of being included on the CD01:14
godbykI see.01:14
humphreybcfor example, pitivi is an entire program and it's only 2.5mb01:15
godbykBtw, dealing with the translations is opening up whole new territory for me with LaTeX.01:15
humphreybcheh well you can add that to your resume :P01:15
godbykHandily, it's forcing me to learn some things I hadn't had an excuse to learn before. :-)01:15
humphreybcbut yeah, file size is paramount if we want to get it on the CD01:16
humphreybcwe might have to pull some tricks like the US military had to do to get a B-52 to take off from a carrier in WW201:16
godbykI think we'll have to wait until we have more of the content (and screenshots) in before we can start looking to optimize for file size.01:16
humphreybcyup01:17
humphreybcit's just something to be aware of01:17
humphreybcanyway i'm going to grab something to eat01:17
godbykSure.  When are we starting to collect the screenshots?01:17
humphreybcum01:17
humphreybcnot sure, probably about beta01:17
humphreybcwe can't take too many too soon because Lucid is still in alpha01:18
humphreybcit'll definitely be a crazy rush for us to get screenshots in so many languages in such a short time01:18
humphreybcthat will be the real test :S01:18
humphreybcgood times :)01:19
godbykI can imagine!01:20
dutchiewe'll also need to freeze writing some time before actual release to allow translations to catch up01:20
humphreybctotally01:20
humphreybcaround beta i'd say01:20
humphreybcthat's why we really need to get the main content done asap01:21
humphreybcallow fine tuning and editing to take place between alpha - beta01:21
humphreybcthen freeze writing at beta, allow translations to catch up, and start sourcing screenshots01:21
humphreybccould someone have a look at the lucid release schedule and see what version of Lucid will be out at our beta?01:21
wolterhey humphreybc01:24
woltersorry for the mail :S01:24
wolteris that in the mail you wrote "You are receiving this mail because (...)"01:25
humphreybcno worries wolter, perhaps i should have made it clearer that I was CC'ing it to everyone01:34
wolterno worries ben :)01:34
humphreybcI was just thinking, if we're going to get on the CD, our manual will only be the english version - we'll have to have a page very near the start, possibly even before the title page, that says "To get this manual in your own language, visit... " and then translate that in 30 languages01:35
humphreybcWe'll also have to have each language PDF version available in the repositories... so package names like ubuntu-manual-fr etc01:35
wolterhaha01:35
humphreybceither that or we just have the source in the repos, and then when installing it picks up what language they're using, and then builds the correct version01:35
woltersounds like easy >> "and then translate in 30 languages"01:35
humphreybcbut that would require a lot of dependencies. thoughts?01:35
humphreybcof course the example content at present is only in english01:36
wolterI think that, as each version of ubuntu has its own per-language version, I think it would be no problem shipping the manual in the cd already built01:36
wolterbut, there is one thing:01:36
wolterif the manual were to come pre-installed, then the manual should be downloadable from ubuntu official repos01:37
humphreybci think they only build one version of the CD, but include many locales and you can choose your language01:37
wolterahh01:37
wolteryes thats true...01:37
humphreybcwe can't include all of the ubuntu manual locales, there wouldn't be enough space01:37
wolterugh.. yes indeed, that sounded so much like windows01:37
humphreybcso what do we do?01:38
godbykIf they're to get it from the repository, it may be just as easy to get it from a nice url (like http://ubuntu-manua.org/)01:38
godbyksince both require internet access anyway.01:38
godbykand the 'download it from the web' step is already familiar to more people than 'get it from this repository thing that we haven't explained yet'01:39
godbykAlso, Ubuntu should just move to DVDs already. :-)01:39
humphreybchaha01:39
humphreybcwell they haven't moved to DVDs yet so unfortunately we have to work with what we've got01:40
humphreybcso, let's say that one version is included as example content01:40
humphreybcthat would be the english version01:40
godbykWe could provide links to the versions in other languages that download it from the web.01:41
humphreybcand for people who set up their computer with another language, they're going to wonder why they still have a manual that's in english when everything else is in their own language01:41
godbykOr maybe a script that snags the right one during install?01:41
humphreybcbut what if they're installing offline?01:41
pererik87english one with links inside01:41
humphreybcperhaps a script that downloads the right one during install, and if they don't have internet access, then it defaults to the english one01:41
pererik87or what he said01:42
godbykpererik87: That's a good idea. We can have hyperlinks to download their language version.01:42
humphreybcalso, if we're going to have it in the repositories/software center... you can't really have 30+ results when you type "ubuntu manual" into the software center search field01:42
wolterhumphreybc, don't they ship desktop help in all languages then?01:42
pererik87i think all ideas combined01:42
humphreybcwolter I think they do yes01:42
woltermaybe we could code a small app that would build the manual01:43
wolterfrom source01:43
wolterlike in the desktop, "Get Ubuntu Manual"01:43
wolteror something01:43
humphreybcYou guys may have heard about that new software center feature where you are able to choose "extras" to install for packages?01:43
wolteri don't know, that could be discussed later01:43
humphreybcwolter, too many dependencies,... latex etc01:43
wolterah.. true01:43
wolteri just thought about what you said earlier01:43
woltermaybe just a download link?01:43
humphreybcwe could just list the Ubuntu Manual as one entry in the software center, and then in the extras drop down box they can choose what language to install... i'd have to talk to the SC guys about that though.01:43
wolteror a download link in the ubuntu download page.01:43
godbyk[]whoops! closed the wrong window.01:44
pererik87script autodetects and downloads for right language. this function is already there for language files. And links inside for different languages.01:44
humphreybcI think it has to be more automated than just a download link01:44
humphreybcokay so a script sounds good01:44
humphreybcand if we can utilize this "extras" thing in the SC then we can just have one listing for the manual, and they can choose what language to install01:44
humphreybcI think multiple languages is a real selling point for us, I don't believe any similar documentation can boast that it's available in 30+ languages.01:45
humphreybc(apart from ubuntu docs)01:45
humphreybcby similar i mean the official ubuntu book, the karmic bible, Keir Thomas' Ubuntu pocket guide etc01:45
wolter'xactly01:48
* godbyk is just thinking how much easier this'll be for the 10.10 release. <sigh>01:49
pererik87packet manager also works by language. if it was added to the repostory. the language would update itself on first update01:49
godbykwhat's packet manager?01:50
pererik87software center if you like thet better01:50
wolterhahah01:51
wolteri think he wanted you to say "package" manager01:51
godbykah! gotcha.01:51
pererik87haha im not native in english, and typing fast isnt helping01:51
godbykI was trying to figure out who would want to manage individual network packets. :-)01:52
humphreybclol01:53
humphreybcgodbyk: heh... yes time is short... but that's okay01:53
humphreybcwe will survive01:53
* humphreybc sings01:53
godbykIt'll be a lot easier the next time because all of this framework stuff will be done.01:53
humphreybcindeed01:54
humphreybcgetting it sorted for 10.10 will be a breeze after this01:54
humphreybci can work on other projects! I will have a life! yay!01:54
wolterhaha01:56
wolter(toolshed!) wooow!01:56
humphreybcheh01:57
humphreybcindeed01:57
humphreybcright i'm going to go and sit outside in the sun, read my book and eat something01:57
humphreybcback later01:57
godbyksee ya01:57
IlyaHaykinsonhumphreybc: re Thomas Cantera signing up for chapter 2... very nice.05:05
humphreybcfor anyone having difficulty explaining bzr, I suggest they check out Ground Control by Martin Owens08:09
humphreybche just released beta version today08:09
humphreybci'm just testing it out at the moment08:09
humphreybchttp://doctormo.wordpress.com/2010/01/27/ground-control-demonstration/08:09
humphreybcis anyone in here at the moment?08:10
humphreybcping godbyk, IlyaHaykinson, jmburgess08:10
godbykI'm here.08:11
humphreybccould you do me a quick favour, make a tiny change and push it08:12
humphreybci just want to test how ground control handles pulling08:12
humphreybcbefore i recommend it to the rest of the team08:12
humphreybcI changed the "P" in project on the first line of the readme to "p"08:14
humphreybcperhaps just change it back to uppercase and push08:14
godbyksure08:16
godbykone sec08:16
humphreybccool08:16
godbykhumphreybc: okay.08:19
godbykI changed some spacing in the readme and pushed.08:19
humphreybcneat08:20
humphreybcyeah ground control is really nice08:21
humphreybcshould make it easy for new contributors to submit things08:22
humphreybci'm not sure how it pulls though... i'll have to talk to martin about it08:22
godbykcool.  I'll have to check it out.08:23
humphreybcwhat's up with this btw? https://edge.launchpad.net/ubuntu-bengali-manual08:24
humphreybci might make a short video tomorrow demonstrating bzr08:25
thorwilhumphreybc: hi! you should really do something about quoting in your email client08:28
humphreybclol how do you mean? I use gmail08:29
thorwilhumphreybc: well, there's nothing that distinguishes quotes from your replies08:29
humphreybcoh okay, I didn't know08:30
humphreybcwhat client are you using08:30
humphreybc?08:30
thorwilhumphreybc: evolution08:30
thorwilhumphreybc: the standard is > on the left of each quoted line08:30
humphreybcgmail probably has a quoting feature but i've never used it08:31
thorwilhumphreybc: i'm rather sure i saw correct quotes in emails from people using gmail08:31
godbykhumphreybc: Are you using plain text or rich text in gmail?  The plain text setting adds the > prefix for quoted lines.  not sure what the rich text version does.08:32
humphreybcrich text08:33
humphreybcrich text looks like it indents and adds a vertical rule next to the quote08:33
humphreybci'm looking into google labs08:33
thorwilhumphreybc: i looked into the html version of your last mail. no indent or anything else there either08:34
humphreybcI found a "Quote selected text" lab thing08:34
thorwilsometimes one could think the gmail makers never used mailing lists08:35
humphreybchmm, maybe it's just evolution not liking gmail's rich text quoting08:36
humphreybcUsually if I quote something in chunks I'll italicize what i'm quoting and use quotation marks around it.08:36
humphreybc(as well as it gets indented for rich text, and for other gmail users, it appears as purple font)08:37
humphreybcthorwil: do you have a blog?08:37
thorwilhumphreybc: i configured it to default to plain text. actually, there is indention in the html version, but not for the quote you placed on the top (manually i guess)08:38
humphreybcah okay, sorry08:38
thorwilthere are no italics08:38
thorwilhumphreybc: http://thorwil.wordpress.com/08:38
humphreybccool08:38
humphreybcdutchie: could you add this feed to the planet? ^^08:39
humphreybcthorwil: this is what I myself and other gmail users see: http://humphreybc.homeip.net/files/quote.png08:39
thorwilhumphreybc: could well be that i don't blog about the manual, or only once after this version is done08:40
humphreybcyour call whether you want to be on the planet or not08:41
thorwilhumphreybc: no idea why the color don't appear in the html. anyway, this doesn't degrade gracefully, so better use >08:41
godbykhumphreybc: With the most recent email you sent, I just see italicized text for quotes.  (I'm using gmail.)08:42
humphreybcrighto08:42
thorwilhumphreybc: i wouldn't mind, if you have no issue with a lack of posts that are directly relevant ;)08:42
humphreybcgo for it08:42
thorwildutchie: so yes, please :)08:43
thorwilanyone seen kolorguild lately?08:43
humphreybcthorwil: refresh that link I gave you and you'll see another example of gmail quoting08:44
humphreybcnope08:44
humphreybca few of the team members have disappeared off the planet08:44
thorwilthat's the quoting style i mean08:45
humphreybcalso thorwil if you have style/design stuff which you'd like to discuss at the meeting, could you put it on the meeting agenda? https://wiki.ubuntu.com/ubuntu-manual/Meetings08:45
godbykhumphreybc: the second quoting style is nicer.08:46
thorwilhumphreybc: will do so in a moment08:47
humphreybccool08:48
humphreybcI think it will be good for you to have your blog on the planet, and any style team announcements or decisions and proposals can be announced there08:48
* vish wonders... where is this manual planet blog?08:49
vishhumphreybc: you neednt italicize the quoted text08:49
humphreybcvish: planet.interesting.co.nz08:50
vishi think thats where stuff gets messed up ;)08:50
humphreybcrighto08:55
humphreybcanyone know how to use memoserv on IRC?08:58
godbykSure: /msg memoserv help08:59
godbyk:-)08:59
om26erhow can I help the ubuntu manual project.09:03
vishom26er: have a look at > https://wiki.ubuntu.com/ubuntu-manual#Contributions09:07
dutchiehah, just missed him09:15
dutchiethorwil: you have been added :)09:22
thorwilty!09:22
dutchiedo you want a photo to go with your feed items?09:22
thorwildutchie: nope09:23
dutchieno problem09:23
dutchiethat's actually easier for me :)09:24
thorwilvish: got something to add/change about the agenda? https://wiki.ubuntu.com/ubuntu-manual/Meetings09:27
* vish checks09:27
vishseriously o.0 > " New to Ubuntu (10.04)? Read this!! "09:28
thorwilvish: i just added all the proposals ;)09:30
thorwilvish: an awful one can still get people to think09:30
vishthe other one which wont work is > "Ubuntu (10.04): A Beginners Guide "09:30
thorwilvish: why? (will you be present on the meeting?)09:31
vish^that plain wrong! its meaning the "Ubuntu" is a beginners guide :/09:31
* vish will try to be present09:32
vishthorwil: the list is for "title" or for "catch phrases" ?09:32
thorwilvish: title and optionally also sub-title09:33
thorwilvish: true, it should rather be A Beginner's Guide to Ubuntu09:35
vishyeah...09:35
thorwiledited09:38
thorwilgodbyk, vish: started to work on an A4 layout template: http://bazaar.launchpad.net/%7Et-w-/%2Bjunk/ubuntu_manual_cover/download/head%3A/layout_a4.svg-20100128134918-yenbpm0zvsr3vg5l-1/layout_a4.svg14:29
* thorwil goes to work in the garden14:29
=== koogee_ is now known as koogee
koogeehi, i'm having trouble with compiling the manual... following instructions on the wiki the 'make' process errors out...any help?16:42
thorwilkoogee: chances that someone can help you increase if you provide the error message17:04
koogeeits a lengthy log...how can i post the entire thing here...17:08
thorwilkoogee: use a pastebin17:08
thorwilkoogee: e.g. http://pastebin.com/17:08
koogeehttp://pastebin.com/m160f387d17:10
thorwilkoogee: i guess that's a matter for godbyk, who might be around in a few hours (not sure what his timezone is)17:16
koogeeokay...thanks for your help anyways...17:17
koogeehttp://pastebin.com/m160f387d17:26
=== koogee_ is now known as koogee

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