| missaugustina | Howdy! I need some help with bzr | 19:19 |
|---|---|---|
| missaugustina | I created a branch in lp and I'm trying to create the branch on my system. | 19:19 |
| missaugustina | When I run the bzr branch command it keeps saying "Error not a branch" | 19:19 |
| missaugustina | This is my branch: https://code.launchpad.net/~missaugustina/ubuntu-docs/usb-creator | 19:20 |
| missaugustina | I need to create a local branch so I can push my changes to it | 19:21 |
| missaugustina | bzr: ERROR: Not a branch: "bzr+ssh://bazaar.launchpad.net/~missaugustina/ubuntu-docs/usb-creator/". | 19:23 |
| missaugustina | bzr: ERROR: Not a branch: "https://code.launchpad.net/~missaugustina/ubuntu-docs/". | 19:24 |
| missaugustina | ok nm i have to create it as a new branch, i was following the wrong instructions | 19:26 |
| missaugustina | Alright! got it working! https://code.launchpad.net/~missaugustina/ubuntu-docs/usb-creator | 20:44 |
| missaugustina | I'll have the docbook tagged stuff up there soon. | 20:44 |
| mdke | missaugustina: nice, I'll take a look when it is ready | 22:13 |
| mdke | probably this weekend so we can get it into the ubuntu-docs branch | 22:13 |
| mdke | missaugustina: probably the simplest way for you to do it would be to create a branch from the ubuntu-docs karmic branch, add your document using the same structure/format as similar documents (about-ubuntu is probably a good example) and then push that branch so that it can be easily merged | 22:15 |
| mdke | that will also allow you to check it using our validate tool (scripts/validate.sh in the branch) | 22:16 |
| missaugustina | OK I will definitely need help to make sure I'm doing it right. | 22:16 |
| missaugustina | I created my own usb-creator branch just to have a place to put the tagged doc. | 22:17 |
| mdke | missaugustina: no problem, I'm happy to help, and I'm sure others will be too | 22:17 |
| missaugustina | Right now just the text is up there, untagged, in OpenOffice format | 22:17 |
| mdke | yep | 22:17 |
| mdke | do you also have a local copy of the ubuntu-docs karmic branch? | 22:17 |
| missaugustina | yeah I am re-dowloading that now | 22:17 |
| mdke | awesome | 22:17 |
| missaugustina | I had to reinstall my system and getting bazaar re-set up took all morning haha | 22:18 |
| mdke | ouch | 22:18 |
| missaugustina | There are so many great quickstart guides for bazaar out there but nothing specific for ubuntu-docs, unless I just don't know where it is | 22:18 |
| missaugustina | The version of bazaar I had from the repositories was incompatible so I had to re-set up from the Bazaar PPA | 22:19 |
| missaugustina | I'm writing something up for myself as a reminder in case I ever have to do this again and can post it to the wiki somewhere when I'm done | 22:19 |
| mdke | the bzr guide should be here - https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Repository | 22:19 |
| mdke | if there is something you think could be added, feel free to suggest - we can always improve the info | 22:20 |
| mdke | hmm, annoying that you couldn't use the ordinary bzr. I wonder if that is our fault | 22:20 |
| missaugustina | k I will definitely. 2 things offhand is a quick note on how to back up from an existing rsa key. I backed mine up when I reinstalled so I didn't have to set that stuff up again. | 22:21 |
| missaugustina | Second thing is setting up the Bzr PPA | 22:21 |
| missaugustina | Since the versions were incompatible, or i was getting errors when trying to get the ubuntu docs branch | 22:21 |
| mdke | the second thing is more worrying, for me. we're doing something wrong if the branch isn't compatible | 22:22 |
| mdke | on the first thing, it's maybe a marginal user case, or something which we could link to another document for | 22:22 |
| missaugustina | I will post the errors I got, I'm on Jaunty and was running Bzr .98 | 22:22 |
| missaugustina | or whatever is in the repositories | 22:22 |
| missaugustina | KeyError: 'Bazaar repository format 2a (needs bzr 1.16 or later)\n' | 22:23 |
| mdke | hmm | 22:23 |
| === lukjad007 is now known as ShadowChild | ||
| missaugustina | Looks like it was Bazaar 1.13 | 22:23 |
| mdke | we should definitely fix that | 22:23 |
| mdke | thanks for pointing it out | 22:23 |
| missaugustina | NP I just thought we were supposed to be using the Bazaar PPA, not the official repositories and thought wow why isn't that documented anywhere?? | 22:24 |
| mdke | one way or the other we should fix it :) | 22:25 |
| missaugustina | That wiki you linked is perfect, I think it's what I used the first time I set everything up. | 22:25 |
| missaugustina | Yay finally got it all downloaded. OK so you were saying I should make my branch look like "about-ubuntu" | 22:28 |
| mdke | I think that you should make changes directly to the branch you just downloaded | 22:28 |
| === ShadowChild is now known as lukjad007 | ||
| mdke | so you would add a directory "usb-creator" | 22:28 |
| mdke | and then you put your document in usb-creator/C/usb-creator.xml | 22:29 |
| missaugustina | Oh right and the tools create the other docs | 22:29 |
| mdke | how do you mean? | 22:29 |
| missaugustina | In about-ubuntu there's a "po" folder | 22:30 |
| mdke | oh yeah, don't worry about that | 22:30 |
| missaugustina | with a *.pot document | 22:30 |
| mdke | I'll deal with it | 22:30 |
| missaugustina | What are those? | 22:30 |
| mdke | those are for translations | 22:30 |
| missaugustina | Ah ok | 22:30 |
| missaugustina | And the *.omf file in the C directory ? | 22:31 |
| mdke | that's used by yelp to show documents - you can create that too if you fancy giving it a go, otherwise I'm happy to do that | 22:31 |
| missaugustina | I'll give it a shot | 22:31 |
| mdke | about-ubuntu.xml is a good document to use as an example for yours because it is an <article> and will show you the header format that we use for our documents | 22:32 |
| missaugustina | Where is the Doc Book tagging guide for Ubuntu docs? | 22:32 |
| missaugustina | Yeah that's what I was going to draw from | 22:32 |
| mdke | there is a sort of basic intro here: https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Editing | 22:32 |
| mdke | and here for checking: https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Checking | 22:32 |
| missaugustina | I know HTML and I used Docbook like 10 yrs ago so it's just figuring out what tags you guys use | 22:33 |
| missaugustina | Excellent! Thanks | 22:33 |
| mdke | details of the tags are here: https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/DocbookConventions | 22:33 |
| mdke | that's not entirely complete, unfortunately, but if you read it, you're in good shape :) | 22:33 |
| mdke | thanks very much for your work on this | 22:34 |
| missaugustina | hey no problem! thx for letting me contribute! | 22:35 |
| mdke | we love contributions :) | 22:35 |
| mdke | ok, i'm off to bed, catch you again soon | 22:36 |
| missaugustina | Thx for your help! Gnite! | 22:36 |
Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!