Translating LinuxCNC Documentation

Contents

1. Install Git

2. Configure Git

---

1. Install Git

Install git-core, git-gui and gitk. From a terminal say:

  sudo sudo apt-get install git-core git-gui gitk

2. Configure Git

Once you have git-core, git-gui and gitk installed on your computer you have to configure it.

Open a terminal and do the following with your name and email:

git config --global user.name "Your full name" git config --global user.email "you@example.com"

Next do an anonymous checkout like so:

git clone git://git.linuxcnc.org/git/emc2.git emc2-dev

Then switch to the 2.5 branch like so:

cd emc2-dev git checkout -b v2.5_branch origin/v2.5_branch

to verify you have the 2.5 branch use this command from within a git directory:

git branch

which should say:

  master

• v2.5_branch

the * indicates the current branch.

Now when you open up a _es.txt file to edit you can be sure your editing the correct branches file.

You must be very careful not to change formatting of links, anchors and titles or it will not build. For example:

= Level 0 Title <must be the first line of the text file < must have a blank line here [[cha:level-0-title]] (((Level 0 Title))) <first one is the anchor, second one is the TOC link.

== Level 1 Title <this should be the next thing and you will see this when you open the files.

<<cha:level-0-title,Level 0 Title>> < this is a link and the text after the , can be translated but the text before the , should not unless you are positive you have changed every link and the anchor.

Before translating a file always do a git pull --rebase to make sure your working on the most current file, otherwise the patch may fail.

After translating one txt file build and check for errors before creating a patch... I know this sounds a bit complicated but once you do it a few time it will be automatic.

To build open a terminal and substitute john with your computer name and do the following:

cd emc2-dev/src

./autogen.sh

./configure --enable-build-documentation >> /home/john/Desktop?/configure.txt 2>&1

make >> /home/john/Desktop?/make.txt 2>&1

This creates two files on your desktop, the reason I redirect the output to a file is to not loose any information. After make is done open the make.txt file and search for warning and error. If you have any then fix them before creating a patch.

Next run git-gui in a terminal and you should see the file you changed. Stage the change by either clicking on the file name or the stage changed button. Next enter a description in the Commit Message box.

Docs: translate to german

or similar. Then press Sign Off and notice that it puts your name and email in the commit message box. Next press commit. You can click on repository visualize 2.5 branch history and see your commit.

Next you prepare a patch to send to me. I must check the exact syntax for git format-patch and get back to you on that.

To keep problems small lets work out the work flow with only one file to start.

Thanks John