Skip to content
This repository has been archived by the owner on May 2, 2019. It is now read-only.

Commit

Permalink
Browse files Browse the repository at this point in the history
Merge branch 'master' of https://github.com/progit/progit
Conflicts:
	zh-tw/01-introduction/01-chapter1.markdown
  • Loading branch information
dodowell committed Mar 27, 2013
2 parents 64a56f0 + 5e404b9 commit e4ddfe1
Show file tree
Hide file tree
Showing 77 changed files with 5,733 additions and 571 deletions.
2 changes: 1 addition & 1 deletion ar/01-introduction/01-chapter1.markdown
Expand Up @@ -184,7 +184,7 @@ Insert 18333fig0107.png

يمكنك تنصيب Git على نظام ويندوز بسهولة. أحد أسهل الطرق هو استخدام مشروع msysGit. يمكنك تنصيب البرنامج من صفحة المشروع على غوغل كود:

http://code.google.com/p/msysgit
http://msysgit.github.com/

بعد التنصيب سيكون لدين نسختين من الأداة للـ command-line في ويندوز (بالإضافة الى أداة SSH والتي ستستفيد منها لاحقاً) والأداة بالواجهة الرسومية الإعتيادية.

Expand Down
2 changes: 1 addition & 1 deletion ar/03-git-branching/01-chapter3.markdown
Expand Up @@ -315,7 +315,7 @@ Notice the `*` character that prefixes the `master` branch: it indicates the bra
* master 7a98805 Merge branch 'iss53'
testing 782fd34 add scott to the author list in the readmes

Another useful option to figure out what state your branches are in is to filter this list to branches that you have or have not yet merged into the branch you’re currently on. The useful `--merged` and `--no-merged` options have been available in Git since version 1.5.6 for this purpose. To see which branches are already merged into the branch you’re on, you can run `git branch merged`:
Another useful option to figure out what state your branches are in is to filter this list to branches that you have or have not yet merged into the branch you’re currently on. The useful `--merged` and `--no-merged` options have been available in Git since version 1.5.6 for this purpose. To see which branches are already merged into the branch you’re on, you can run `git branch --merged`:

$ git branch --merged
iss53
Expand Down
3 changes: 2 additions & 1 deletion ar/08-git-and-other-scms/01-chapter8.markdown
Expand Up @@ -362,7 +362,8 @@ However, the import isn’t perfect; and because it will take so long, you may a

To get a list of the author names that SVN uses, you can run this:

$ svn log --xml | grep author | sort -u | perl -pe 's/.>(.?)<./$1 = /'
$ svn log --xml | grep -P "^<author" | sort -u | \
perl -pe 's/<author>(.*?)<\/author>/$1 = /' > users.txt

That gives you the log output in XML format — you can look for the authors, create a unique list, and then strip out the XML. (Obviously this only works on a machine with `grep`, `sort`, and `perl` installed.) Then, redirect that output into your users.txt file so you can add the equivalent Git user data next to each entry.

Expand Down
4 changes: 2 additions & 2 deletions az/01-introduction/01-chapter1.markdown
Expand Up @@ -176,9 +176,9 @@ You don’t have to add all the extras, but you’ll probably want to include +s

### Installing on Windows ###

Installing Git on Windows is very easy. The msysGit project has one of the easier installation procedures. Simply download the installer exe file from the Google Code page, and run it:
Installing Git on Windows is very easy. The msysGit project has one of the easier installation procedures. Simply download the installer exe file from the GitHub page, and run it:

http://code.google.com/p/msysgit
http://msysgit.github.com/

After it’s installed, you have both a command-line version (including an SSH client that will come in handy later) and the standard GUI.

Expand Down
3 changes: 2 additions & 1 deletion az/08-git-and-other-scms/01-chapter8.markdown
Expand Up @@ -362,7 +362,8 @@ However, the import isn’t perfect; and because it will take so long, you may a

To get a list of the author names that SVN uses, you can run this:

$ svn log --xml | grep author | sort -u | perl -pe 's/.>(.?)<./$1 = /'
$ svn log --xml | grep -P "^<author" | sort -u | \
perl -pe 's/<author>(.*?)<\/author>/$1 = /' > users.txt

That gives you the log output in XML format — you can look for the authors, create a unique list, and then strip out the XML. (Obviously this only works on a machine with `grep`, `sort`, and `perl` installed.) Then, redirect that output into your users.txt file so you can add the equivalent Git user data next to each entry.

Expand Down
4 changes: 2 additions & 2 deletions be/01-introduction/01-chapter1.markdown
Expand Up @@ -176,9 +176,9 @@ Insert 18333fig0107.png

### Усталёўка ў Windows ###

Усталёўка Git на Windows вельмі лёгкая. Працэдура ўсталёўкі праекта msysGit адна з найбольш лёгкіх. Проста спампуйце exe-файл інсталятара са старонкі Google Code, і выканайце яго:
Усталёўка Git на Windows вельмі лёгкая. Працэдура ўсталёўкі праекта msysGit адна з найбольш лёгкіх. Проста спампуйце exe-файл інсталятара са старонкі GitHub, і выканайце яго:

http://code.google.com/p/msysgit
http://msysgit.github.com/

Пасля яго ўсталёўкі вы маеце як кансольную версію (уключаюцы SSH кліент, які спатрэбіцца ў далейшым), так і стандартную графічную.

Expand Down
4 changes: 2 additions & 2 deletions ca/01-introduction/01-chapter1.markdown
Expand Up @@ -176,9 +176,9 @@ You don’t have to add all the extras, but you’ll probably want to include +s

### Installing on Windows ###

Installing Git on Windows is very easy. The msysGit project has one of the easier installation procedures. Simply download the installer exe file from the Google Code page, and run it:
Installing Git on Windows is very easy. The msysGit project has one of the easier installation procedures. Simply download the installer exe file from the GitHub page, and run it:

http://code.google.com/p/msysgit
http://msysgit.github.com/

After it’s installed, you have both a command-line version (including an SSH client that will come in handy later) and the standard GUI.

Expand Down
3 changes: 2 additions & 1 deletion ca/08-git-and-other-scms/01-chapter8.markdown
Expand Up @@ -362,7 +362,8 @@ However, the import isn’t perfect; and because it will take so long, you may a

To get a list of the author names that SVN uses, you can run this:

$ svn log --xml | grep author | sort -u | perl -pe 's/.>(.?)<./$1 = /'
$ svn log --xml | grep -P "^<author" | sort -u | \
perl -pe 's/<author>(.*?)<\/author>/$1 = /' > users.txt

That gives you the log output in XML format — you can look for the authors, create a unique list, and then strip out the XML. (Obviously this only works on a machine with `grep`, `sort`, and `perl` installed.) Then, redirect that output into your users.txt file so you can add the equivalent Git user data next to each entry.

Expand Down
4 changes: 2 additions & 2 deletions cs/01-introduction/01-chapter1.markdown
Expand Up @@ -176,9 +176,9 @@ Není nutné přidávat všechny doplňky, ale pokud budete někdy používat Gi

### Instalace v systému Windows ###

Instalace systému Git v OS Windows je velice nenáročná. Postup instalace projektu msysGit patří k těm nejjednodušším. Ze stránky Google Code stáhněte instalační soubor exe a spusťte ho:
Instalace systému Git v OS Windows je velice nenáročná. Postup instalace projektu msysGit patří k těm nejjednodušším. Ze stránky GitHub stáhněte instalační soubor exe a spusťte ho:

http://code.google.com/p/msysgit
http://msysgit.github.com/

Po dokončení instalace budete mít k dispozici jak verzi pro příkazový řádek (včetně SSH klienta, který se vám bude hodit později), tak standardní grafické uživatelské rozhraní.

Expand Down
1 change: 1 addition & 0 deletions cs/02-git-basics/01-chapter2.markdown
Expand Up @@ -577,6 +577,7 @@ To je jen několik základních parametrů k formátování výstupu pro příka
--relative-date Zobrazí datum v relativním formátu (např. "2 weeks ago", tj. před 2 týdny) místo formátu s úplným datem.
--graph Zobrazí vedle výstupu logu ASCII graf k historii větve a slučování.
--pretty Zobrazí revize v alternativním formátu. Parametry příkazu jsou oneline, short, full, fuller a format (lze zadat vlastní formát).
--oneline Užitečná zkratka pro `--pretty=oneline --abbrev-commit`.

### Omezení výstupu logu ###

Expand Down
33 changes: 16 additions & 17 deletions cs/04-git-server/01-chapter4.markdown
Expand Up @@ -511,7 +511,7 @@ Git se stal hodně populárním v korporátním prostředí, které obvykle mív
[gldpg]: http://sitaramc.github.com/gitolite/progit.html
[gltoc]: http://sitaramc.github.com/gitolite/master-toc.html

Gitolite je autorizační vrstva nad gitem, která při autentizaci spoléhá na sshd nebo httpd. (Připomeňme si: autentizace spočívá v rozpoznání uživatele, autorizací rozumíme rozhodování, zda má povolení k provádění toho, co se provést pokouší.)
Gitolite je autorizační vrstva nad gitem, která při autentizaci spoléhá na `sshd` nebo `httpd`. (Připomeňme si: autentizace spočívá v rozpoznání uživatele, autorizací rozumíme rozhodování, zda má povolení k provádění toho, co se provést pokouší.)

Gitolite umožňuje nastavit přístupová práva nejen na repozitáře (podobně jako Gitosis), ale také na větve a značky v každém repozitáři. To znamená, že lze nastavit, aby určití lidé mohli odesílat jen do určité reference (větve nebo značky) a do jiné ne.

Expand All @@ -523,15 +523,14 @@ Nástroj Gitolite je ve smyslu „serverového“ softwaru poněkud neobvyklý.

Začněte tím, že na serveru vytvoříte uživatele nazvaného `git` a přihlásíte se na něj. Z vaší pracovní stanice nakopírujte svůj veřejný ssh klíč (pokud jste spustili `ssh-keygen` s implicitními hodnotami, jde o soubor `~/.ssh/id_rsa.pub`) a přejmenujte jej na `VaseJmeno.pub`. Potom proveďte následující příkazy:

git clone git://github.com/sitaramc/gitolite
gitolite/install -ln
# předpokládá existenci $HOME/bin a uvedení tohoto adresáře v $PATH
gitolite setup -pk $HOME/VaseJmeno.pub
# já bych například spustil 'gitolite setup -pk $HOME/sitaram.pub'
$ git clone git://github.com/sitaramc/gitolite
$ gitolite/install -ln
# předpokládá existenci $HOME/bin a uvedení tohoto adresáře v $PATH
$ gitolite setup -pk $HOME/scott.pub

Nakonec přejděte zpět na pracovní stanici a spusťte `git clone git@server:gitolite-admin`.
Poslední příkaz vytvoří na serveru nový gitovský repozitář nazvaný `gitolite-admin`.

To je všechno! Nyní máte Gitolite nainstalovaný na serveru a v domácím adresáři vaší pracovní stanice máte také úplně nový repozitář `gitolite-admin`. Své nastavení Gitolite spravujete pomocí provádění změn v tomto repozitáři jejich odesíláním (push).
Nakonec přejděte zpět na pracovní stanici a spusťte `git clone git@gitserver:gitolite-admin`. To je všechno! Nyní máte Gitolite nainstalovaný na serveru a v domácím adresáři vaší pracovní stanice máte také úplně nový repozitář `gitolite-admin`. Své nastavení Gitolite spravujete pomocí provádění změn v tomto repozitáři jejich odesíláním (push).

### Přizpůsobení instalace ###

Expand All @@ -546,18 +545,18 @@ Přepněte se do repozitáře `gitolite-admin` (je umístěn ve vašem domácím
conf/ keydir/
$ find conf keydir -type f
conf/gitolite.conf
keydir/sitaram.pub
keydir/scott.pub
$ cat conf/gitolite.conf

repo gitolite-admin
RW+ = sitaram
RW+ = scott

repo testing
RW+ = @all

Všimněte si, že „sitaram“ (jméno veřejného klíče v dříve použitém příkazu gl-setup) má práva pro čtení i zápis k repozitáři `gitolite-admin` a také stejnojmenný veřejný klíč.
Všimněte si, že „scott“ (jméno veřejného klíče v dříve použitém příkazu `gitolite setup`) má práva pro čtení i zápis k repozitáři `gitolite-admin` a také stejnojmenný veřejný klíč.

Přidávání dalších uživatelů je snadné. Pokud chceme přidat uživatele „alice“, získáme její veřejný klíč, pojmenujeme jej `alice.pub` a umístíme jej do adresáře `keydir`. Je součástí klonu repozitáře gitolite-admin, který jsme právě vytvořili na pracovní stanici. Přidáme, potvrdíme a odešleme změny (add, commit, push). Tím jsme dosáhli přidání uživatele.
Přidávání dalších uživatelů je snadné. Pokud chceme přidat uživatele „alice“, získáme její veřejný klíč, pojmenujeme jej `alice.pub` a umístíme jej do adresáře `keydir`. Je součástí klonu repozitáře `gitolite-admin`, který jsme právě vytvořili na pracovní stanici. Přidáme, potvrdíme a odešleme změny (add, commit, push). Tím jsme dosáhli přidání uživatele.

Syntaxe konfiguračního souboru pro Gitolite je dobře dokumentovaná, takže zde uvedu jen pár zajímavých věcí.

Expand All @@ -566,8 +565,8 @@ Pro usnadnění můžete dávat uživatele i repozitáře do skupin. Jména skup
@oss_repos = linux perl rakudo git gitolite
@secret_repos = fenestra pear

@admins = scott # Adams, not Chacon, sorry :)
@interns = ashok # get the spelling right, Scott!
@admins = scott
@interns = ashok
@engineers = sitaram dilbert wally alice
@staff = @admins @engineers @interns

Expand Down Expand Up @@ -631,17 +630,17 @@ Gitolite vám umožní nadefinovat pro každého vývojáře jmenné prostory s

### „Wildcard“ repozitáře ###

Gitolite vám umožní určit repozitáře zástupnými znaky (wildcards; ve skutečnosti jde o perlovské regulární výrazy) -- například k náhodnému výběru zadání příkladu můžeme použít `assignments/s[0-9][0-9]/a[0-9][0-9]`. Umožní nám též přidělit nový režim oprávnění („C“), který uživatelům povoluje vytvářet repozitáře popsané zástupnými znaky, automaticky přidělí vlastnictví konkrétnímu uživateli, který jej vytvořil, umožní mu přidělit oprávnění R a RW dalším spolupracovníkům atd. Podrobnosti opět hledejte v dokumentaci.
Gitolite vám umožní určit repozitáře zástupnými znaky (wildcards; ve skutečnosti jde o perlovské regulární výrazy) -- například k náhodnému výběru zadání příkladu můžeme použít `assignments/s[0-9][0-9]/a[0-9][0-9]`. Umožní nám též přidělit nový režim oprávnění (`C`), který uživatelům povoluje vytvářet repozitáře popsané zástupnými znaky, automaticky přidělí vlastnictví konkrétnímu uživateli, který jej vytvořil, umožní mu přidělit oprávnění `R` a `RW` dalším spolupracovníkům atd. Podrobnosti opět hledejte v dokumentaci.

### Další vlastnosti ###

Vysvětlení Gitolite završíme přehledem několika vlastností, které jsou detailně popsány v dokumentaci.

**Logování:** Gitolite loguje všechny úspěšné přístupy. Jestliže máte volná pravidla pro přidělování oprávnění vracet změny (práva `RW+`) a stane se, že někdo takto „zkazí“ hlavní větev, je tu ještě log soubor, který vám zachrání život, protože v něm můžete postižené SHA najít.
**Logování:** Gitolite loguje všechny úspěšné přístupy. Jestliže máte volná pravidla pro přidělování oprávnění vracet změny (práva `RW+`) a stane se, že někdo takto „zkazí“ větev `master`, je tu ještě log soubor, který vám zachrání život, protože v něm můžete postižené SHA najít.

**Přehledy uživatelských oprávnění:** Další příjemnou vlastností je to, co se stane, pokud se pouze pokusíte připojit pomocí SSH na server. Gitolite vám ukáže, ke kterým repozitářům máte přístup a s jakoými oprávněními. Příklad:

hello sitaram, this is git@git running gitolite3 v3.01-18-g9609868 on git 1.7.4.4
hello scott, this is git@git running gitolite3 v3.01-18-g9609868 on git 1.7.4.4

R anu-wsd
R entrans
Expand Down
2 changes: 1 addition & 1 deletion cs/08-git-and-other-scms/01-chapter8.markdown
Expand Up @@ -363,7 +363,7 @@ Takový import však není úplně dokonalý a vzhledem k tomu, jak dlouho můž
Chcete-li získat seznam jmen autorů používaných v SVN, spusťte tento příkaz:

$ svn log --xml | grep -P "^<author" | sort -u | \
perl -pe 's/<author>(.*?)<\/author>/$1 = /'
perl -pe 's/<author>(.*?)<\/author>/$1 = /' > users.txt

Vytvoříte tím log ve formátu XML. Můžete v něm vyhledávat autory, vytvořit si vlastní seznam a XML zase vyjmout. (Tento příkaz pochopitelně funguje pouze na počítačích, v nichž je nainstalován `grep`, `sort` a `perl`.) Poté tento výstup přesměrujte do souboru users.txt, abyste mohli vedle každého záznamu přidat stejná data o uživatelích Git.

Expand Down
4 changes: 2 additions & 2 deletions de/01-introduction/01-chapter1.markdown
Expand Up @@ -176,9 +176,9 @@ Du brauchst die optionalen Features natürlich nicht mit zu installieren, aber e

### Installation unter Windows ###

Das msysGit Projekt macht die Installation von Git unter Windows sehr einfach. Lade einfach das Installationsprogramm für Windows von der Google Code Webseite herunter und führe es aus:
Das msysGit Projekt macht die Installation von Git unter Windows sehr einfach. Lade einfach das Installationsprogramm für Windows von der GitHub Webseite herunter und führe es aus:

http://code.google.com/p/msysgit
http://msysgit.github.com/

Danach hast Du sowohl eine Kommandozeilenversion (inklusive eines SSH Clients, der sich später noch als nützlich erweisen wird) als auch die Standard GUI installiert.

Expand Down
2 changes: 1 addition & 1 deletion de/06-git-tools/01-chapter6.markdown
Expand Up @@ -1167,7 +1167,7 @@ Switching branches with submodules in them can also be tricky. If you create a n
$ git status
# On branch master
# Untracked files:
# (use "git add f<ile>..." to include in what will be committed)
# (use "git add <file>..." to include in what will be committed)
#
# rack/

Expand Down
5 changes: 3 additions & 2 deletions de/08-git-and-other-scms/01-chapter8.markdown
Expand Up @@ -487,11 +487,12 @@ Trotzdem ist der Import nicht perfekt. Und weil das ziemlich lange dauern wird,

Um eine Liste der Namen der Autoren bekommen, die SVN benutzen, kannst Du folgendes Kommando ausführen:

$ svn log --xml | grep author | sort -u | perl -pe 's/.>(.?)<./$1 = /'
$ svn log --xml | grep -P "^<author" | sort -u | \
perl -pe 's/<author>(.*?)<\/author>/$1 = /' > users.txt

<!--That gives you the log output in XML format — you can look for the authors, create a unique list, and then strip out the XML. (Obviously this only works on a machine with `grep`, `sort`, and `perl` installed.) Then, redirect that output into your users.txt file so you can add the equivalent Git user data next to each entry.-->

Dies erzeugt Dir die Log-Ausgabe im XML-Format — Du suchst damit nach den Autoren, erzeugst eine Liste ohne doppelte Einträge und wirfst anschließend das überflüssige XML weg. Anschließend wird die Ausgabe in die Datei `users.txt` umgeleitet, so dass Du jedem Eintrag den entsprechenden Git-Benutzer zuordnen kannst.
Dies erzeugt Dir die Log-Ausgabe im XML-Format — Du suchst damit nach den Autoren, erzeugst eine Liste ohne doppelte Einträge und wirfst anschließend das überflüssige XML weg. Leite anschließend die Ausgabe in die Datei `users.txt` um, so dass Du jedem Eintrag den entsprechenden Git-Benutzer zuordnen kannst.

<!--You can provide this file to `git svn` to help it map the author data more accurately. You can also tell `git svn` not to include the metadata that Subversion normally imports, by passing `-\-no-metadata` to the `clone` or `init` command. This makes your `import` command look like this:-->

Expand Down
4 changes: 2 additions & 2 deletions en/01-introduction/01-chapter1.markdown
Expand Up @@ -176,9 +176,9 @@ You don’t have to add all the extras, but you’ll probably want to include +s

### Installing on Windows ###

Installing Git on Windows is very easy. The msysGit project has one of the easier installation procedures. Simply download the installer exe file from the Google Code page, and run it:
Installing Git on Windows is very easy. The msysGit project has one of the easier installation procedures. Simply download the installer exe file from the GitHub page, and run it:

http://code.google.com/p/msysgit
http://msysgit.github.com/

After it’s installed, you have both a command-line version (including an SSH client that will come in handy later) and the standard GUI.

Expand Down

0 comments on commit e4ddfe1

Please sign in to comment.