To upload my advanced of Cheese documentation in real life, I have to text somewhere… so, it is good idea to put the docs in Gitorious branch.
With the help of Phil Bull, I created my Gitorious account and upload my public SSH key. I got my ssh key doing cat ~/.shh/id_rsa.pub
It’s like git.gnome.org, but we use it for documentation that’s currently being heavily developed. We can put all of our ‘work in progress’stuff in that branch and it lets you (people who have access to Gitorious and want to review the doc)
Clone the Glitorious doing: git clone firstname.lastname@example.org:cheese-docs/cheese-docs.git
Ready to start! https://gitorious.org/cheese-docs/cheese-docs [yulys@yulys ~]$ cd cheese/cheese/help/C [yulys@yulys C]$ yelp-new task index "Cheese Webcam Booth"
This will create a file called index.page, with the title “Cheese Webcam Booth”. You can then edit that file and write content in it.
* Alternative Scenarios:
1. If you have a denied permission message,
[yulys@yulys C]$ yelp-new task index “Cheese Webcam Booth”
/usr/bin/yelp-new: line 129: index.page: Permission denied
a) Check the permission doing:
ls -lH cheese/cheese/help
If it looks like: drwxr-xr-x 5 root root …blah blah… C
you’ll have to change the owner of the directory back to you, or at least make it read-write.
b) Give the permission:
[root@yulys ~]# chown -R yulys.yulys /home/yulys/cheese/cheese/.git
I did it as a root , because I got this: [yulys@yulys help]$ sudo chown yulys.yulys -R * .
[sudo] password for yulys:
yulys is not in the sudoers file. This incident will be reported.
c) Look for the entry for “C”. It should look something like this:
drwxr-xr-x. 3 yulys yulys 4096 Jun 21 14:31 C
2. If you got a fatal message while doing some git thing,
[yulys@yulys ~]$ git checkout
fatal: Not a git repository (or any parent up to mount parent ) Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).
Make sure that you are in the correct folder:
[yulys@yulys ~]$ cd cheese/cheese/help [yulys@yulys help]$ gedit index.page [yulys@yulys help]$ git checkout M help/index.page Your branch is ahead of 'origin/master' by 1 commit.
3. If you got a fatal message after doing some git push in gitorious:
[yulys@yulys help]$ git add index.page [yulys@yulys help]$ git commit -a [master a9d4bd5] This is the index for Cheese 1 files changed, 2 insertions(+), 2 deletions(-) [yulys@yulys help]$ git push origin master fatal: The remote end hung up unexpectedly
Make sure you are using gitorious’s repos instead of git repos and what the branch is
[yulys@yulys help]$ git remote -v origin git://git.gnome.org/cheese (fetch) origin git://git.gnome.org/cheese (push)