diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 00000000..cd6f15ad --- /dev/null +++ b/.travis.yml @@ -0,0 +1,34 @@ +language: ruby +sudo: false +git: + depth: false +cache: bundler +before_install: + - wget https://raw.githubusercontent.com/progit/progit2-pub/master/bootstrap.sh + - sh bootstrap.sh +script: bundle exec rake book:build +after_success: bundle exec rake book:tag +deploy: + provider: releases + file_glob: true + file: + - progit*.epub + - progit*.mobi + - progit*.pdf + skip_cleanup: true + on: + tags: true + api-key: $GITHUB_API_TOKEN +branches: + only: + - master + - /^2\.1(\.\d+)+$/ + +addons: + apt: + packages: + - epubcheck +notifications: + email: + on_success: never + on_failure: always diff --git a/book/A-git-in-other-environments/1-git-other-environments.asc b/A-git-in-other-environments.asc similarity index 66% rename from book/A-git-in-other-environments/1-git-other-environments.asc rename to A-git-in-other-environments.asc index acf392fe..31991559 100644 --- a/book/A-git-in-other-environments/1-git-other-environments.asc +++ b/A-git-in-other-environments.asc @@ -1,3 +1,4 @@ +[#A-git-in-other-environments] //// Laatst bijgewerkt van progit/progit2 referentie: 6528f318 //// @@ -12,19 +13,19 @@ Maar daarmee houdt het verhaal niet op; Git wordt normaalgesproken gebruikt als We zullen nu een kijkje nemen naar andere soorten omgevingen waar Git nuttig kan zijn, en hoe andere applicaties (inclusief de jouwe) zij aan zij samenwerken met Git. -include::sections/guis.asc[] +include::book/A-git-in-other-environments/sections/guis.asc[] -include::sections/visualstudio.asc[] +include::book/A-git-in-other-environments/sections/visualstudio.asc[] -include::sections/eclipse.asc[] +include::book/A-git-in-other-environments/sections/eclipse.asc[] -include::sections/bash.asc[] +include::book/A-git-in-other-environments/sections/bash.asc[] -include::sections/zsh.asc[] +include::book/A-git-in-other-environments/sections/zsh.asc[] -include::sections/powershell.asc[] +include::book/A-git-in-other-environments/sections/powershell.asc[] === Samenvatting Je hebt gezien hoe de kracht van Git kan worden aangewend vanuit de gereedschappen die je in je dagelijkse - werkzaamheden gebruikt, en ook hoe je de Git repositories kunt benaderen vanuit je eigen programmatuur. \ No newline at end of file + werkzaamheden gebruikt, en ook hoe je de Git repositories kunt benaderen vanuit je eigen programmatuur. diff --git a/book/B-embedding-git/1-embedding-git.asc b/B-embedding-git.asc similarity index 76% rename from book/B-embedding-git/1-embedding-git.asc rename to B-embedding-git.asc index 75a87e36..692b8987 100644 --- a/book/B-embedding-git/1-embedding-git.asc +++ b/B-embedding-git.asc @@ -1,3 +1,4 @@ +[#B-embedding-git] //// Laatst bijgewerkt van progit/progit2 referentie: a113612f //// @@ -12,8 +13,8 @@ Zelfs applicaties voor niet-ontwikkelaars, zoals document editors, kunnen potent Als je Git wilt integreren met je applicatie, heb je eigenlijk drie opties: een shell openen en de Git commando-regel tool gebruiken; Libgit2; en JGit. -include::sections/command-line.asc[] +include::book/B-embedding-git/sections/command-line.asc[] -include::sections/libgit2.asc[] +include::book/B-embedding-git/sections/libgit2.asc[] -include::sections/jgit.asc[] +include::book/B-embedding-git/sections/jgit.asc[] diff --git a/book/C-git-commands/1-git-commands.asc b/C-git-commands.asc similarity index 65% rename from book/C-git-commands/1-git-commands.asc rename to C-git-commands.asc index 19c13bb0..226aa469 100644 --- a/book/C-git-commands/1-git-commands.asc +++ b/C-git-commands.asc @@ -1,3 +1,4 @@ +[#C-git-commands] //// Laatst bijgewerkt van progit/progit2 referentie: a113612f //// @@ -27,21 +28,21 @@ Git heeft een standaard manier om vele honderden dingen te doen. Voor veel van d Het `git config` commando is in ongeveer elk hoofdstuk van dit boek gebruikt. -In <<_first_time>> hebben we het gebruikt om onze naam, email adres en editor voorkeuren aan te geven voordat we +In <> hebben we het gebruikt om onze naam, email adres en editor voorkeuren aan te geven voordat we zelfs waren beginnen met Git te gebruiken. -In <<_git_aliases>> hebben we laten zien hoe je het kon gebruiken om commando-afkortingen te maken die lange optie +In <> hebben we laten zien hoe je het kon gebruiken om commando-afkortingen te maken die lange optie reeksen vervingen zodat je ze niet elke keer hoefde in te typen. -In <<_rebasing>> hebben we het gebruikt om `--rebase` de standaard manier te maken als je `git pull` aanroept. +In <> hebben we het gebruikt om `--rebase` de standaard manier te maken als je `git pull` aanroept. -In <<_credential_caching>> hebben we het gebruikt om een standaard bewaarplaats in te richten voor je HTTP +In <> hebben we het gebruikt om een standaard bewaarplaats in te richten voor je HTTP wachtwoorden. -In <<_keyword_expansion>> lieten we zien hoe besmeur en opschoon filters op te zetten op gegevens die Git in en uit +In <> lieten we zien hoe besmeur en opschoon filters op te zetten op gegevens die Git in en uit gaan. -Tenslotte is heel <<_git_config>> toegewijd aan dit commando. +Tenslotte is heel <> toegewijd aan dit commando. ==== git help @@ -49,8 +50,8 @@ Het `git help` commando wordt gebruikt om je alle documentatie over elk commando Git. Hoewel we een grof overzicht van de meer populaire commando's laten zien in deze appendix, kan je voor een volledige opsomming van alle mogelijke opties en vlaggen voor elk commando altijd `git help ` aanroepen. -We hebben het `git help` commando in <<_git_help>> geïntroduceerd, en je laten zien hoe het te gebruiken om meer - informatie te verkrijgen over de `git shell` in <<_setting_up_server>>. +We hebben het `git help` commando in <> geïntroduceerd, en je laten zien hoe het te gebruiken om meer + informatie te verkrijgen over de `git shell` in <>. === Projecten ophalen en maken @@ -63,14 +64,14 @@ Er zijn twee manieren om een Git repository op te halen. Een is om het te kopië Om een directory te nemen en het in een nieuwe Git repository te veranderen zodat je kunt beginnen met versiebeheer, kan je simpelweg `git init` aanroepen. -We hebben dit voor het eerst gebruikt in <<_getting_a_repo>>, waar we laten zien hoe een gloednieuwe repository +We hebben dit voor het eerst gebruikt in <>, waar we laten zien hoe een gloednieuwe repository gemaakt wordt om ermee te werken. -We hebben kort besproken hoe je de standaard branch van ``master'' kunt wijzigen in <<_remote_branches>>. +We hebben kort besproken hoe je de standaard branch van ``master'' kunt wijzigen in <>. -We gebruiken dit commando om een lege bare repository te maken voor een server in <<_bare_repo>>. +We gebruiken dit commando om een lege bare repository te maken voor een server in <>. -Tot slot, we leiden je door een paar details over wat er achter de schermen gebeurt in <<_plumbing_porcelain>>. +Tot slot, we leiden je door een paar details over wat er achter de schermen gebeurt in <>. ==== git clone @@ -82,14 +83,14 @@ Het `git clone` commando is eigenlijk een soort wrapper om een aantal andere com Het `git clone` commando wordt in tientallen plaatsen in het boek gebruikt, maar we zullen een paar interessante plaatsen opnoemen. -Het wordt kort geïntroduceerd en uitgelegd in <<_git_cloning>>, waar we een aantal voorbeelden behandelen. +Het wordt kort geïntroduceerd en uitgelegd in <>, waar we een aantal voorbeelden behandelen. -In <<_git_on_the_server>> bekijken we het gebruik van de `--bare` optie om een kopie van een Git repository te maken +In <> bekijken we het gebruik van de `--bare` optie om een kopie van een Git repository te maken zonder een werk directory. -In <<_bundling>> gebruiken we het om een gebundelde Git repository te ontbundelen. +In <> gebruiken we het om een gebundelde Git repository te ontbundelen. -Tenslotte, in <<_cloning_submodules>> hebben we de `--recursive` optie laten zien waarmee het clonen van een +Tenslotte, in <> hebben we de `--recursive` optie laten zien waarmee het clonen van een repository met submodules iets eenvoudiger te maken. Alhoewel het in vele andere plaatsen in dit boek wordt gebruikt, zijn dit de toepassingen die nogal uniek zijn, of @@ -110,14 +111,14 @@ Het `git add` commando voegt inhoud van de werk directory toe aan de staging are Dit commando is een ongelofelijk belangrijk commando in Git en het wordt tientallen keren genoemd of gebruikt in dit boek. We zullen heel kort een aantal van de meer ongebruikelijke gebruiken benoemen die kunnen worden gevonden. -We hebben `git add` voor het eerst geïntroduceerd en in detail uitgelegd in <<_tracking_files>>. +We hebben `git add` voor het eerst geïntroduceerd en in detail uitgelegd in <>. -We beschrijven hoe we het moeten gebruiken om merge conflicten op te lossen in <<_basic_merge_conflicts>>. +We beschrijven hoe we het moeten gebruiken om merge conflicten op te lossen in <>. We behandelen het gebruik ervan om interactief alleen specifieke delen van een gewijzigde bestand te stagen in - <<_interactive_staging>>. + <>. -Tot slot emuleren we het op een laag niveau in <<_tree_objects>>, zodat je een idee krijgt van wat het achter de +Tot slot emuleren we het op een laag niveau in <>, zodat je een idee krijgt van wat het achter de schermen doet. ==== git status @@ -126,7 +127,7 @@ Het `git status` commando laat je de verschillende stadia zien van bestanden in Welke bestanden er zijn gewijzigd en nog niet gestaged en welke er zijn gestaged maar nog niet gecommit. In zijn normale vorm, laat het je ook een aantal hints zien over hoe bestanden tussen deze stadia te verplaatsen. -We behandelen `status` voor het eerst in <<_checking_status>>, zowel in zijn basis en versimpelde vormen. Alhoewel we +We behandelen `status` voor het eerst in <>, zowel in zijn basis en versimpelde vormen. Alhoewel we het door het hele boek heen gebruiken, wordt vrijwel alles wat je met het `git status` commando kunt doen daar behandeld. @@ -136,46 +137,46 @@ Het `git diff` commando wordt gebruikt als je de verschillen wilt zien tussen el zijn tussen je werk omgeving en je staging area (`git diff` op zichzelf), tussen je staging area en je laatste commit (`git diff --staged`), of tussen twee commits (`git diff master branchB`). -We kijken eerst naar de basis gebruiken van `git diff` in <<_git_diff_staged>>, waar we laten zien hoe je kunt zien +We kijken eerst naar de basis gebruiken van `git diff` in <>, waar we laten zien hoe je kunt zien welke wijzigingen er zijn gestaged en welke nog niet. We gebruiken het om te kijken of er mogelijke witruimte problemen zijn voor we committen met de `--check` optie in - <<_commit_guidelines>>. + <>. We zien hoe we de verschillen tussen branches efficiënter kunnen controleren met de `git diff A...B` syntax in - <<_what_is_introduced>>. + <>. We gebruiken het om de witruimte verschillen weg te filteren met `-b` en hoe de verschillende stadia van - conflicterende bestanden te vergelijken met `--theirs`, `--ours` en `--base` in <<_advanced_merging>>. + conflicterende bestanden te vergelijken met `--theirs`, `--ours` en `--base` in <>. En tot slot, gebruiken we het om efficiënt submodule wijzigingen te vergelijjken met `--submodule` in - <<_starting_submodules>>. + <>. ==== git difftool Het `git difftool` commando roept simpelweg een externe tool aan om je de verschillen te tonen tussen twee trees in het geval dat je iets anders wilt gebruiken dan het ingebouwde `git diff` commando. -We vermelden dit slechts kort in <<_git_diff_staged>>. +We vermelden dit slechts kort in <>. ==== git commit Het `git commit` commando neemt alle bestandsinhoud die zijn gestaged met `git add` en slaat een nieuwe permanente snapshot in de database op en verplaatst daarna de branch verwijzer op de huidige branch ernaar. -We behandelen eerst de basis van committen in <<_committing_changes>>. Daar laten we ook zien hoe je de `-a` vlag +We behandelen eerst de basis van committen in <>. Daar laten we ook zien hoe je de `-a` vlag kunt gebruiken om de `git add` stap over te slaan in de dagelijkse workflows en hoe je de `-m` vlag kunt gebruiken om een commit bericht uit de commando regel kunt doorgeven in plaats van een editor te laten opstarten. -In <<_undoing>> behandelen we het gebruik van de `--amend` optie om de meest recente commit over te doen. +In <> behandelen we het gebruik van de `--amend` optie om de meest recente commit over te doen. -In <<_git_branches_overview>>, gaan we met veel meer detail in op wat `git commit` doet en waarom het doet wat het +In <>, gaan we met veel meer detail in op wat `git commit` doet en waarom het doet wat het doet. -We keken naar hoe commits cryptografisch te tekenen met de `-S` vlag in <<_signing_commits>>. +We keken naar hoe commits cryptografisch te tekenen met de `-S` vlag in <>. Tot slot, nemen we een kijkje naar wat het `git commit` commando op de achtergrond doet en hoe het echt is - geïmplementeerd in <<_git_commit_objects>>. + geïmplementeerd in <>. ==== git reset @@ -185,13 +186,13 @@ Het `git reset` commando is voornamelijk gebruikt om zaken terug te draaien, zoa commando je werk te verliezen als je het niet juist gebruikt, dus verzeker je ervan dat je het goed begrijpt voordat je het gebruikt. -We hebben feitelijk het eenvoudigste gebruik van `git reset` in <<_unstaging>> behandeld, waar we het hebben gebruikt +We hebben feitelijk het eenvoudigste gebruik van `git reset` in <> behandeld, waar we het hebben gebruikt om een bestand te unstagen waar we `git add` op hadden gebruikt. -We behandelen het daarna in behoorlijk meer detail in <<_git_reset>>, die volledig is gewijd aan de uitleg van dit +We behandelen het daarna in behoorlijk meer detail in <>, die volledig is gewijd aan de uitleg van dit commando. -We gebruiken `git reset --hard` om een merge af te breken in <<_abort_merge>>, waar we ook `git merge --abort` +We gebruiken `git reset --hard` om een merge af te breken in <>, waar we ook `git merge --abort` gebruiken, wat een vorm van een wrapper is voor het `git reset` commando. ==== git rm @@ -199,11 +200,11 @@ We gebruiken `git reset --hard` om een merge af te breken in <<_abort_merge>>, w Het `git rm` commando wordt gebruikt om bestanden te verwijderen van de staging area en de werk directory voor Git. Het lijkt op `git add` in die zin dat het de verwijdering van een bestand staged voor de volgende commit. -We behandelen het `git rm` commando gedetailleerd in <<_removing_files>>, inclusief het recursief verwijderen van +We behandelen het `git rm` commando gedetailleerd in <>, inclusief het recursief verwijderen van bestanden en alleen bestanden verwijderen van de staging area en ze in de werk directory ongemoeid te laten met `--cached`. -Het enige andere alternatieve gebruik van `git rm` in het boek is in <<_removing_objects>> waar we het even gebruiken +Het enige andere alternatieve gebruik van `git rm` in het boek is in <> waar we het even gebruiken en de `--ignore-unmatch` uitleggen als we `git filter-branch` aanroepen, wat ervoor zorgt dat we niet met een fout eindigen als het bestand die we proberen te verwijderen niet bestaat. Dit kan nuttig zijn bij het maken van scripts. @@ -212,14 +213,14 @@ Het enige andere alternatieve gebruik van `git rm` in het boek is in <<_removing Het `git mv` commando is een kleine gemaks-commando om een bestand te verplaatsen en dan `git add` aan te roepen op het nieuwe bestand en `git rm` op het oude bestand. -We noemen dit commando heel kort in <<_git_mv>>. +We noemen dit commando heel kort in <>. ==== git clean Het `git clean` commando wordt gebruikt om ongewenste bestanden te verwijderen uit je werk directory. Dit zou het verwijderen van tijdelijke bouw-artefacten kunnen inhouden of merge conflict bestanden. -We hebben veel van de opties en scenario's besproken waar je het clean commando zou kunnen gebruiken in <<_git_clean>>. +We hebben veel van de opties en scenario's besproken waar je het clean commando zou kunnen gebruiken in <>. === Branchen en mergen @@ -230,54 +231,54 @@ Er zijn maar een handjevol commando's die de meeste van de branch en merge funct Het `git branch` commando is eigenlijk een soort branch beheer gereedschap. Het kan de branches die je hebt uitlijsten, een nieuwe branch aanmaken, branches verwijderen en hernoemen. -Het grootste gedeelte van <<_git_branching>> is gewijd aan het `branch` commando en het wordt door het gehele - hoofdstuk gebruikt. We introduceren het eerst in <<_create_new_branch>> en we behandelen de meeste van de andere - mogelijkheden (uitlijsten en verwijderen) in <<_branch_management>>. +Het grootste gedeelte van <> is gewijd aan het `branch` commando en het wordt door het gehele + hoofdstuk gebruikt. We introduceren het eerst in <> en we behandelen de meeste van de andere + mogelijkheden (uitlijsten en verwijderen) in <>. -In <<_tracking_branches>> gebruiken we de `git branch -u` optie om een tracking branch op te zetten. +In <> gebruiken we de `git branch -u` optie om een tracking branch op te zetten. -Tot slot, behandelen we een aantal dingen die het op de achtergrond doet in <<_git_refs>>. +Tot slot, behandelen we een aantal dingen die het op de achtergrond doet in <>. ==== git checkout Het `git checkout` commando wordt gebruikt om branches te wisselen en inhoud uit te cheken in je werk directory. -We komen het commando voor het eerst tegen in <<_switcing_branches>> samen met de `git branch` commando. +We komen het commando voor het eerst tegen in <> samen met de `git branch` commando. -We zien hoe het te gebruiken om tracking branches te starten met de `--track` vlag in <<_tracking_branches>>. +We zien hoe het te gebruiken om tracking branches te starten met de `--track` vlag in <>. -We gebruiken het om bestandsconflicten te herintroduceren met `--conflict=diff3` in <<_checking_out_conflicts>>. +We gebruiken het om bestandsconflicten te herintroduceren met `--conflict=diff3` in <>. -We behandelen het in nog meer detail in verband met haar relatie met `git reset` in <<_git_reset>>. +We behandelen het in nog meer detail in verband met haar relatie met `git reset` in <>. -Tot slot, behandelen we een aantal implementatie details in <<_the_head>>. +Tot slot, behandelen we een aantal implementatie details in <>. ==== git merge Het `git merge` tool wordt gebruikt om een of meerdere branches te mergen naar de branch die je hebt uitgechecked. Het zal daarna de huidige branch voortbewegen naar het resultaat van de merge. -Het `git merge` commando werd voor het eerst geïntroduceerd in <<_basic_branching>>. Hoewel het op diverse plaatsen +Het `git merge` commando werd voor het eerst geïntroduceerd in <>. Hoewel het op diverse plaatsen in het boek wordt gebruikt, zijn er over het algemeen erg weinig variaties op het `merge` commando, normaalgesproken alleen `git merge ` met de naam van de enkele branch die je wilt inmergen. We hebben behandeld hoe een squashed merge te doen (waar Git het werk merged maar doet alsof het niet meer dan een - nieuwe commit is zonder de historie van de branch die je in merged op te slaan) aan het einde van <<_public_project>>. + nieuwe commit is zonder de historie van de branch die je in merged op te slaan) aan het einde van <>. We hebben veel behandeld over het merge proces en commando, inclusief het `-Xignore-space-change` commando en de - `--abort` vlag om een problematische merge af te breken in <<_advanced_merging>>. + `--abort` vlag om een problematische merge af te breken in <>. -We hebben gezien hoe handtekeningen te verifiëren als je project GPG tekenen gebruikt in <<_signing_commits>>. +We hebben gezien hoe handtekeningen te verifiëren als je project GPG tekenen gebruikt in <>. -Tot slot, hebben we Subtree mergen behandeld in <<_subtree_merge>>. +Tot slot, hebben we Subtree mergen behandeld in <>. ==== git mergetool Het `git mergetool` commando roept simpelweg een externe merge help aan in het geval dat je problemen hebt met een merge in Git. -We hebben het kort genoemd in <<_basic_merge_conflicts>> en behandelen met detail hoe je je eigen externe merge tool - kunt implementeren in <<_external_merge_tools>>. +We hebben het kort genoemd in <> en behandelen met detail hoe je je eigen externe merge tool + kunt implementeren in <>. ==== git log @@ -289,30 +290,30 @@ Het `git log` commando wordt gebruikt om de bereikbare opgeslagen historie van e Dit commando wordt in vrijwel elk hoofdstuk van het boek gebruikt om de historie van het project te tonen. -We introduceren het commando en behandelen het met nogal wat detail in <<_viewing_history>>. Daar nemen we een kijkje +We introduceren het commando en behandelen het met nogal wat detail in <>. Daar nemen we een kijkje naar de `-p` en `--stat` opties om een idee te krijgen van wat er was geïntroduceerd in elke commit en de `--pretty` en `--oneline` opties om de historie meer bekopt te bekijken, samen met wat eenvoudige datum en auteur filter opties. -In <<_create_new_branch>> gebruiken we het met de `--decorate` optie om eenvoudig te laten zien waar onze branch +In <> gebruiken we het met de `--decorate` optie om eenvoudig te laten zien waar onze branch verwijzingen zijn en we gebruiken ook de `--graph` optie om te zien hoe uiteenlopende histories eruit zien. -In <<_private_team>> en <<_commit_ranges>> behandelen we de `branchA..branchB` syntax om het `git log` commando te +In <> en <> behandelen we de `branchA..branchB` syntax om het `git log` commando te gebruiken om te zien welke commits er uniek zijn voor een branch in vergelijking met een andere branch. In - <<_commit_ranges>> behandelen we dit redelijk uitgebreid. + <> behandelen we dit redelijk uitgebreid. -In <<_merge_log>> en <<_triple_dot>> behandelen we het gebruik van het `branchA...branchB` formaat en de - `--left-right` syntax om te zien wat er in een branch zit of de andere, maar niet in beide. In <<_merge_log>> +In <> en <> behandelen we het gebruik van het `branchA...branchB` formaat en de + `--left-right` syntax om te zien wat er in een branch zit of de andere, maar niet in beide. In <> kijken we ook naar hoe de `--merge` optie te gebruiken als hulp om een merge conflict te debuggen en ook het gebruik van de `--cc` optie om naar merge conflicten te kijken in je historie. -In <<_git_reflog>> gebruiken we de `-g` optie om de Git reflog te bekijken via dit gereedschap in plaats van branch +In <> gebruiken we de `-g` optie om de Git reflog te bekijken via dit gereedschap in plaats van branch navigatie te doen. -In <<_seraching>> kijken we naar het gebruik van de `-S` en `-L` opties om een redelijk gevorderde zoekopdrachten uit +In <> kijken we naar het gebruik van de `-S` en `-L` opties om een redelijk gevorderde zoekopdrachten uit te voeren naar iets dat historisch heeft plaatsgevonden in de code, zoals het bekijken van de geschiedenis van een functie. -In <<_signing_commits>> zien we hoe `--show-signature` te gebruiken om een validatie tekenreeks toe te voegen aan +In <> zien we hoe `--show-signature` te gebruiken om een validatie tekenreeks toe te voegen aan elke commit in de `git log` uitvoer afhankelijk van of het valide is getekend of niet. ==== git stash @@ -320,18 +321,18 @@ In <<_signing_commits>> zien we hoe `--show-signature` te gebruiken om een valid Het `git stash` commando wordt gebruikt om tijdelijk niet-gecommit werk op te slaan, zodat je werk directory opgeschoond wordt; hierdoor hoef je geen onvolledig werk te committen naar een branch. -Dit wordt eigenlijk in zijn geheel behandeld in <<_git_stashing>>. +Dit wordt eigenlijk in zijn geheel behandeld in <>. ==== git tag Het `git tag` commando wordt gebruikt om een blijvende boekwijzer te geven aan een specifiek punt in de code historie. Over het algemeen wordt dit gebruikt voor zaken zoals releases. -Dit commando wordt geïntroduceerd en in detail behandeld in <<_git_tagging>> en we gebruiken het in de praktijk in - <<_tagging_releases>>. +Dit commando wordt geïntroduceerd en in detail behandeld in <> en we gebruiken het in de praktijk in + <>. We behandelen ook hoe een GPG getekende tag te maken met de `-s` vlag en verifiëren er een met de `-v` vlag in - <<_signing>>. + <>. === Projecten delen en bijwerken @@ -345,16 +346,16 @@ Er zijn niet veel commando's in Git die het netwerk benaderen, bijna alle comman Het `git fetch` commando communiceert met een remote repository en haalt alle informatie binnen die in die repository zit die nog niet in je huidige zit en bewaart dit in je lokale database. -We nemen voor het eerst een kijkje naar dit commando in <<_fetching_and_pulling>> en we vervolgen met het kijken naar - voorbeelden van het gebruik in <<_remote_branches>>. +We nemen voor het eerst een kijkje naar dit commando in <> en we vervolgen met het kijken naar + voorbeelden van het gebruik in <>. -We gebruiken het ook in diverse voorbeelden in <<_contributing_project>>. +We gebruiken het ook in diverse voorbeelden in <>. -We gebruiken het om een enkele specifieke refentie op te halen die buiten de standaard ruimte is in <<_pr_refs>> en - we zien hoe we iets uit een bundel kunnen halen in <<_bundling>>. +We gebruiken het om een enkele specifieke refentie op te halen die buiten de standaard ruimte is in <> en + we zien hoe we iets uit een bundel kunnen halen in <>. We richten een aantal zeer eigen refspecs in om `git fetch` iets op een net andere manier te laten doen dan standaard - in <<_refspec>>. + in <>. ==== git pull @@ -362,16 +363,16 @@ Het `git pull` commando is feitelijk een combinatie van de `git fetch` en `git m remote die je opgeeft gaat ophalen en daarna direct probeert het opgehaalde te mergen in de branch waar je op dat moment op zit. -We stellen je het kort voor in <<_fetching_and_pulling>> en laten zien hoe je kunt bekijken wat het zal gaan mergen - als je het aanroept in <<_inspecting_remote>>. +We stellen je het kort voor in <> en laten zien hoe je kunt bekijken wat het zal gaan mergen + als je het aanroept in <>. -We laten ook zien hoe het te gebruiken als hulp met bij problemen met rebasen in <<_rebase_rebase>>. +We laten ook zien hoe het te gebruiken als hulp met bij problemen met rebasen in <>. We laten zien hoe het te gebruiken met een URL om wijzigingen op een eenmalige manier te pullen in - <<_checking_out_remotes>>. + <>. Tot slot, vermelden we heel snel dat je de `--verify-signature` optie kunt gebruiken om te verifiëren dat commits die je - binnenhaalt met GPG getekend zijn in <<_signing_commits>>. + binnenhaalt met GPG getekend zijn in <>. ==== git push @@ -379,24 +380,24 @@ Het `git push` commando wordt gebruikt om te communiceren met een andere reposit heeft en de remote niet, en daarna de verschillen te pushen naar de andere repository. Het vereist wel dat je schrijfrechten hebt op de andere repository en normaalgesproken is dit dus op de een of andere manier geautenticeerd. -We nemen een eerste kijkje naar het `git push` commando in <<_pushing_remotes>>. Hier behandelen we de basisprincipes - van het pushen van een branch naar een remote repository. In <<_pushing_branches>> gaan we iets dieper in op het - pushen van specifieke branches en in <<_tracking_branches>> zien we hoe tracking branches worden opgezet om - automatisch naar te pushen. In <<_delete_branches>> gebruiken we de `--delete` vlag om een branch te verwijderen op +We nemen een eerste kijkje naar het `git push` commando in <>. Hier behandelen we de basisprincipes + van het pushen van een branch naar een remote repository. In <> gaan we iets dieper in op het + pushen van specifieke branches en in <> zien we hoe tracking branches worden opgezet om + automatisch naar te pushen. In <> gebruiken we de `--delete` vlag om een branch te verwijderen op de server met een `git push`. -Door heel <<_contributing_project>> heen zien we een aantal voorbeelden van het gebruik van `git push` om werk op +Door heel <> heen zien we een aantal voorbeelden van het gebruik van `git push` om werk op branches te delen middels meerdere remotes. -We zien hoe we het gebruiken om tags te delen die je gemaakt hebt met de `--tags` optie in <<_sharing_tags>>. +We zien hoe we het gebruiken om tags te delen die je gemaakt hebt met de `--tags` optie in <>. -In <<_publishing_submodules>> gebruiken we de `--recurse-submodules` optie om te controleren dat al onze submodule +In <> gebruiken we de `--recurse-submodules` optie om te controleren dat al onze submodule werk is gepubliceerd voordat we het superproject pushen, wat zeer behulpzaam kan zijn als je submodules gebruikt. -In <<_other_client_hooks>> bespreken we kort de `pre-push` hook, wat een script is die we kunnen opzetten om te +In <> bespreken we kort de `pre-push` hook, wat een script is die we kunnen opzetten om te draaien voordat een push voltooid is, om te verifiëren dat pushen hiervan toegestaan is. -Tot slot, in <<_pushing_refspecs>> kijken we naar pushen met een volledige refspect in plaats van de generieke +Tot slot, in <> kijken we naar pushen met een volledige refspect in plaats van de generieke afkortingen die we normaalgesproken gebruiken. Dit kan je helpen om heel specifiek te zijn over welk werk je wilt delen. @@ -407,7 +408,7 @@ Het `git remote` commando is een beheertool voor jouw administratie van remote r kunt er een aantal van hebben en het `git remote` commando wordt gebruikt om ze toe te voegen, te wijzigen en te verwijderen. -Dit commando wordt in detail behandeld <<_remote_repos>>, inclusief het uitlijsten, toevoegen, verwijderen en het +Dit commando wordt in detail behandeld <>, inclusief het uitlijsten, toevoegen, verwijderen en het hernoemen. Het wordt daarnaast in bijna elk daaropvolgend hoofdstuk van het boek gebruikt, maar altijd in de standaard `git @@ -417,7 +418,7 @@ Het wordt daarnaast in bijna elk daaropvolgend hoofdstuk van het boek gebruikt, Het `git archive` commando wordt gebruikt om een archiefbestand te maken van een specifieke snapshot van het project. -We gebruiken `git archive` om een tarball te maken van een project om het te delen in <<_preparing_release>>. +We gebruiken `git archive` om een tarball te maken van een project om het te delen in <>. ==== git submodule @@ -425,7 +426,7 @@ Het `git submodule` commando wordt gebruikt om externe repositories te beheren b zijn voor libraries of andere tyepen gedeelde hulpmiddelen. Het `submodule` commando heeft een aantal sub-commando's (`add`, `update`, `sync`, etc) om deze hulpmiddelen te beheren. -Dit commando wordt alleen benoemd en volledig behandeld in <<_git_submodules>>. +Dit commando wordt alleen benoemd en volledig behandeld in <>. === Inspectie en vergelijking @@ -434,12 +435,12 @@ Dit commando wordt alleen benoemd en volledig behandeld in <<_git_submodules>>. Het `git show` commando kan een Git object in een eenvoudige en voor een mens leesbare manier laten zien. Normaalgesproken gebruik je dit om de informatie over een tag of een commit te laten zien. -We gebruiken het eerst om informatie van een geannoteeerde tag te laten zien in <<_annotated_tags>>. +We gebruiken het eerst om informatie van een geannoteeerde tag te laten zien in <>. -Late gebruiken we het redelijk veel in <<_revision_selection>> om de commits te tonen waar verscheidene van onze +Late gebruiken we het redelijk veel in <> om de commits te tonen waar verscheidene van onze revisie selecties naar toe worden vertaald. -Een van de meer interessante dingen die we met `git show` doen is in <<_manual_remerge>> waar we specifieke +Een van de meer interessante dingen die we met `git show` doen is in <> waar we specifieke bestandsinhoud ophalen uit verschillende stadia gedurende een merge conflict. ==== git shortlog @@ -448,7 +449,7 @@ Het `git shortlog` commando wordt gebruikt om de uitvoer van `git log` samen te dezelfde opties als het `git log` commando maar zal, in plaats van alle commits uit te lijsten, een samenvatting presenteren van de commits gegroepeerd per auteur. -We hebben laten zien hoe het te gebruiken om een mooie changelog te maken in <<_the_shortlog>>. +We hebben laten zien hoe het te gebruiken om een mooie changelog te maken in <>. ==== git describe @@ -456,7 +457,7 @@ Het `git describe` commando wordt gebruikt om alles te pakken wat naar een commi tekenreeks die redelijk mens leesbaar is en niet zal veranderen. Het is een manier om een omschrijving van een commit te krijgen die net zo eenduidig is als een SHA-1, maar meer begrijpbaar. -We gebruiken `git describe` in <<_build_number>> en <<_preparing_release>> om een tekenreeks te verkrijgen om onze +We gebruiken `git describe` in <> en <> om een tekenreeks te verkrijgen om onze release bestand naar te vernoemen. @@ -470,7 +471,7 @@ Git heeft een aantal commando's die als hulp worden gebruikt bij het debuggen va Het `git bisect` gereedschap is een ongelofelijk behulpzaam debugging tool die gebruikt wordt om uit te vinden welke specifieke commit de eerste was om een bug of probleem te bevatten door middel van een automatische binaire zoekactie. -Het wordt volledig behandeld in <<_binary_search>> en wordt alleen in dat gedeelte genoemd. +Het wordt volledig behandeld in <> en wordt alleen in dat gedeelte genoemd. ==== git blame @@ -478,14 +479,14 @@ Het `git blame` commando markeert de regels van elk bestand met welke commit de invoerde bij elke regel in het bestand en welke persoon de auteur was van die commit. Dit is handig bij het uitzoeken van de persoon zodat er meer informatie kan worden gevraagd over een specifiek gedeelte van je code. -Dit wordt behandeld in <<_file_annotation>> en wordt alleen in dat gedeelte genoemd. +Dit wordt behandeld in <> en wordt alleen in dat gedeelte genoemd. ==== git grep Het `git grep` commando kan je helpen elke willekeurige tekenreeks of regular expressie te vinden in elk bestand in je broncode, zelfs oudere versies van je project. -Het wordt behandeld in <<_git_grep>> en wordt alleen in dat gedeelte genoemd. +Het wordt behandeld in <> en wordt alleen in dat gedeelte genoemd. === Patchen @@ -500,29 +501,29 @@ Het `git cherry-pick` commando wordt gebruikt om de wijziging die in een enkele selectief een of twee commits te nemen van een branch in plaats van de hele branch in te mergen, waarbij alle wijzigingen worden genomen. -Cherry picking wordt beschreven en gedemonstreerd in <<_rebase_cherry_pick>>. +Cherry picking wordt beschreven en gedemonstreerd in <>. ==== git rebase Het `git rebase` commando is eigenlijk een geautomatiseerde `cherry-pick`. Het bepaald een reeks van commits en gaat deze dan een voor een in dezelfde volgorde elders cherry-picken. -Rebasen wordt in detail behandeld in <<_rebasing>>, inclusief het behandelen van de samenwerkings problematiek waar +Rebasen wordt in detail behandeld in <>, inclusief het behandelen van de samenwerkings problematiek waar je mee te maken krijgt als je al publieke branches gaat rebasen. We gebruiken het in de praktijk tijdens een voorbeeld van het splitsen van je historie in twee aparte repositores in - <<_replace>>, waarbij we ook de `--onto` vlag gebruiken. + <>, waarbij we ook de `--onto` vlag gebruiken. -We behandelen het in een merge conflict geraken tijdens rebasen in <<_rerere>>. +We behandelen het in een merge conflict geraken tijdens rebasen in <>. -We gebruiken het ook in een interactieve script modus met de `-i` optie in <<_changing_multiple>>. +We gebruiken het ook in een interactieve script modus met de `-i` optie in <>. ==== git revert Het `git revert` commando is feitelijk een omgekeerde `git cherry-pick`. Het maakt een nieuwe commit die de exacte tegenhanger van de wijziging die in de commit zit die je aanwijst toepast, en deze effectief ontdoet of terugdraait. -We gebruiken het in <<_reverse_commit>> om een merge commit terug te draaien. +We gebruiken het in <> om een merge commit terug te draaien. === Email @@ -536,7 +537,7 @@ Veel Git projecten, inclusief Git zelf, worden volledig onderhouden via mail-lij Het `git apply` commando past een patch toe die met het `git diff` of zelfs GNU diff commando is gemaakt. Dit is vergelijkbaar met wat het `patch` commando zou kunnen doen met een paar kleine verschillen. -We laten het gebruik zien en de omstandigheden waarin je het zou kunnen toepassen in <<_patches_from_email>>. +We laten het gebruik zien en de omstandigheden waarin je het zou kunnen toepassen in <>. ==== git am @@ -544,14 +545,14 @@ Het `git am` commando wordt gebruikt om patches toe te passen vanuit een email i mbox is geformatteerd. Dit is handig voor het ontvangen van patches via email en deze eenvoudig op je project toe te passen. -We hebben de workflow en gebruik rond `git am` behandeld in <<_git_am>> inclusief het gebruik van de `--resolved`, `-i` +We hebben de workflow en gebruik rond `git am` behandeld in <> inclusief het gebruik van de `--resolved`, `-i` en `-3` opties. Er zijn ook een aantal hooks die je kunt gebruiken als hulp in de workflow rond `git am` en ze worden allemaal - behandeld in <<_email_hooks>>. + behandeld in <>. We hebben het ook gebruikt om GitHub Pull Request wijzigingen die als patch zijn geformatteerd toe te passen in - <<_email_notifications>>. + <>. ==== git format-patch @@ -559,21 +560,21 @@ Het `git format-patch` commando wordt gebruikt om een reeks van patches te gener gebruiken om ze juist geformatteerd naar een mail lijst te sturen. We behandelen een voorbeeld van een bijdrage leveren aan een project met gebruik van het `git format-patch` tool in - <<_project_over_email>>. + <>. ==== git imap-send Het `git imap-send` commando zendt een mailbox gegenereerd met `git format-patch` naar een IMAP drafts folder. We behandelen een voorbeeld van het bijdragen tot een project door het sturen van patches met de `git imap-send` tool in - <<_project_over_email>>. + <>. ==== git send-email Het `git send-email` commando wordt gebruikt om patches via email te sturen die zijn gegenereerd met `git format-patch`. We behandelen een voorbeeld van aan een project bijdragen door middel van het sturen van patches met het - `git send-email` tool in <<_project_over_email>>. + `git send-email` tool in <>. ==== git request-pull @@ -582,7 +583,7 @@ Het `git request-pull` commando wordt eenvoudigweg gebruikt om een voorbeeld ber geïntegreerd zonder de patches via email te versturen, kan je dit commando aanroepen en de uitvoer sturen naar de persoon die je de wijzigingen wilt laten pullen. -We laten het gebruik van `git request-pull` om een pull message te laten genereren in <<_public_project>>. +We laten het gebruik van `git request-pull` om een pull message te laten genereren in <>. === Externe systemen @@ -592,13 +593,13 @@ Git wordt geleverd met een aantal commando's om te integreren met andere versieb Het `git svn` commando wordt gebruikt om als client te communiceren met het Subversion versiebeheer systeem. Dit houdt in dat je Git kunt gebruiken om checkouts en commits te doen naar en van een Subversion server. -Dit commando wordt gedetailleerd behandeld in <<_git_svn>>. +Dit commando wordt gedetailleerd behandeld in <>. ==== git fast-import Voor andere versiebeheer systemen of het impoteren van bijna elk formaat, kan je `git fast-import` gebruiken om snel het andere formaat te mappen op iets wat Git eenvoudig kan vastleggen. -Dit commando wordt gedetailleerd behandeld in <<_custom_importer>>. +Dit commando wordt gedetailleerd behandeld in <>. === Beheer @@ -608,40 +609,40 @@ Als je een Git repository beheert of iets uitgebreids moet repareren, geeft Git Het `git gc` commando roept ``vuilnis ophalen'' (``garbage collection'') aan op je repository, waarbij onnodige bestanden in je database worden verwijderd en de overgebleven bestanden in een meer efficiënte manier worden opgeslagen. -Dit commando wordt normaalgesproken in de achtergrond voor jou aangeroepen, maar je kunt het handmatig aanroepen als je dat wilt. We behandelen een paar voorbeelden in <<_git_gc>>. +Dit commando wordt normaalgesproken in de achtergrond voor jou aangeroepen, maar je kunt het handmatig aanroepen als je dat wilt. We behandelen een paar voorbeelden in <>. ==== git fsck Het `git fsck` commando wordt gebruikt om de interne database te controleren op problemen of inconsistenties. -We behandelen het slechts een keer heel kort in <<_data_recovery>> om te zoeken naar bungelende (dangling) objecten. +We behandelen het slechts een keer heel kort in <> om te zoeken naar bungelende (dangling) objecten. ==== git reflog Het `git reflog` commando neemt een log door waar in staat waar alle heads van al je branches hebben gestaan als je op zoek bent naar commits die je misschien bent verloren bij het herschrijven van histories. -We behandelen dit commando voornamelijk in <<_git_reflog>>, waar we het normale gebruik laten zien en hoe `git log -g` te gebruiken om dezelfde informatie te laten zien als in de `git log` uitvoer. +We behandelen dit commando voornamelijk in <>, waar we het normale gebruik laten zien en hoe `git log -g` te gebruiken om dezelfde informatie te laten zien als in de `git log` uitvoer. -We behandelen ook een praktisch voorbeeld van het herstellen van zo'n verloren branch in <<_data_recovery>>. +We behandelen ook een praktisch voorbeeld van het herstellen van zo'n verloren branch in <>. ==== git filter-branch Het `git filter-branch` commando wordt gebruikt om grote hoeveelheden commits te herschrijven volgens een bepaald patroon, zoals het overal verwijderen van een bestand of een hele repository terug te brengen tot een enkele subdirectory voor het extraheren van een project. -In <<_removing_file_every_commit>> leggen we het commando uit en verkennen een aantal verschillende opties zoals `--commit-filter`, `--subdirectory-filter` en `--tree-filter`. +In <> leggen we het commando uit en verkennen een aantal verschillende opties zoals `--commit-filter`, `--subdirectory-filter` en `--tree-filter`. -In <<_git_p4>> en <<_git_tfs>> gebruiken we dit om geïmporteerde externe repositories te op te schonen. +In <> en <> gebruiken we dit om geïmporteerde externe repositories te op te schonen. === Binnenwerk commando's (plumbing commando's) -Er zijn ook nog een behoorlijk aantal meer technische binnenwerk commano's die we zijn tegengekomen in het boek. +Er zijn ook nog een behoorlijk aantal meer technische binnenwerk commano's die we zijn tegengekomen in het boek. -De eerste die we tegenkomen is `ls-remote` in <<_pr_refs>> waar we het gebruiken om te kijken naar de rauwe referenties op de server. +De eerste die we tegenkomen is `ls-remote` in <> waar we het gebruiken om te kijken naar de rauwe referenties op de server. -We gebruiken `ls-files` in <<_manual_remerge>>, <<_rerere>> en <<_the_index>> om een meer technische kijk te nemen naar hoe je staging gebied er eigenlijk uit ziet. +We gebruiken `ls-files` in <>, <> en <> om een meer technische kijk te nemen naar hoe je staging gebied er eigenlijk uit ziet. -We gebruiken `rev-parse` in <<_branch_references>> om zo ongeveer elke tekenreeks te nemen en het in een object SHA-1 te veranderen. +We gebruiken `rev-parse` in <> om zo ongeveer elke tekenreeks te nemen en het in een object SHA-1 te veranderen. -Echter, de meeste van de technische binnenwerk commando's die we behandelen staan in <<_git_internals>>, wat meteen het belangrijkste onderwerp is waar dit hoofdstuk zich op richt. -We hebben geprobeeerd het gebruik van deze commando's in de rest van het boek te vermijden. \ No newline at end of file +Echter, de meeste van de technische binnenwerk commando's die we behandelen staan in <>, wat meteen het belangrijkste onderwerp is waar dit hoofdstuk zich op richt. +We hebben geprobeeerd het gebruik van deze commando's in de rest van het boek te vermijden. diff --git a/Gemfile b/Gemfile index d7bd9122..c29231e0 100644 --- a/Gemfile +++ b/Gemfile @@ -1,16 +1,21 @@ source 'https://rubygems.org' gem 'rake' -gem 'asciidoctor', '1.5.0' +gem 'asciidoctor', '1.5.6.1' gem 'json' gem 'awesome_print' -gem 'asciidoctor-epub3', '1.0.0.alpha.2' -gem 'asciidoctor-pdf', '1.5.0.alpha.5' +gem 'asciidoctor-epub3', :git => 'https://github.com/asciidoctor/asciidoctor-epub3' +gem 'asciidoctor-pdf', '1.5.0.alpha.16' +gem 'asciidoctor-pdf-cjk', '~> 0.1.3' +gem 'asciidoctor-pdf-cjk-kai_gen_gothic', '~> 0.1.1' gem 'coderay' gem 'pygments.rb' gem 'thread_safe' -gem 'epubcheck' +gem 'epubcheck-ruby' gem 'kindlegen' + +gem 'octokit' +gem 'github_changelog_generator', github: 'Furtif/github-changelog-generator' diff --git a/Gemfile.lock b/Gemfile.lock index 72029ced..3c4cbba8 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,74 +1,139 @@ +GIT + remote: git://github.com/Furtif/github-changelog-generator.git + revision: efa960ce1c189cd999753713fcfbfb6b7514ab45 + specs: + github_changelog_generator (1.14.3) + activesupport + faraday-http-cache + multi_json + octokit (~> 4.6) + rainbow (>= 2.2.1) + rake (>= 10.0) + retriable (~> 3.0) + +GIT + remote: https://github.com/asciidoctor/asciidoctor-epub3 + revision: ba930925a1df617312f986c7599b5162473b716f + specs: + asciidoctor-epub3 (1.5.0.alpha.9.dev) + asciidoctor (~> 1.5.0) + gepub (~> 0.6.9.2) + thread_safe (~> 0.3.6) + GEM remote: https://rubygems.org/ specs: - Ascii85 (1.0.2) + Ascii85 (1.0.3) + activesupport (5.2.0) + concurrent-ruby (~> 1.0, >= 1.0.2) + i18n (>= 0.7, < 2) + minitest (~> 5.1) + tzinfo (~> 1.1) + addressable (2.5.2) + public_suffix (>= 2.0.2, < 4.0) afm (0.2.2) - asciidoctor (1.5.0) - asciidoctor-epub3 (1.0.0.alpha.2) - asciidoctor (>= 1.5.0, < 1.6.0) - gepub (~> 0.6.9.2) - thread_safe (~> 0.3.4) - asciidoctor-pdf (1.5.0.alpha.5) - asciidoctor (~> 1.5.0) - prawn (= 1.2.1) - prawn-svg (= 0.16.0) - prawn-table (= 0.1.1) - prawn-templates (= 0.0.3) + asciidoctor (1.5.6.1) + asciidoctor-pdf (1.5.0.alpha.16) + asciidoctor (>= 1.5.0) + prawn (>= 1.3.0, < 2.3.0) + prawn-icon (= 1.3.0) + prawn-svg (>= 0.21.0, < 0.28.0) + prawn-table (= 0.2.2) + prawn-templates (>= 0.0.3, <= 0.1.1) + safe_yaml (~> 1.0.4) + thread_safe (~> 0.3.6) treetop (= 1.5.3) - awesome_print (1.2.0) - coderay (1.1.0) - epubcheck (3.0.1) + asciidoctor-pdf-cjk (0.1.3) + asciidoctor-pdf (~> 1.5.0.alpha.8) + asciidoctor-pdf-cjk-kai_gen_gothic (0.1.1) + asciidoctor-pdf-cjk (~> 0.1.2) + awesome_print (1.8.0) + coderay (1.1.2) + concurrent-ruby (1.0.5) + css_parser (1.6.0) + addressable + epubcheck-ruby (4.0.2.1) + faraday (0.15.0) + multipart-post (>= 1.2, < 3) + faraday-http-cache (2.0.0) + faraday (~> 0.8) gepub (0.6.9.2) nokogiri (~> 1.6.1) rubyzip (>= 1.1.1) - hashery (2.1.1) - json (1.8.1) - kindlegen (2.9.4) - mini_portile (0.6.0) - nokogiri (1.6.3.1) - mini_portile (= 0.6.0) - pdf-core (0.2.5) - pdf-reader (1.3.3) + hashery (2.1.2) + i18n (1.0.1) + concurrent-ruby (~> 1.0) + json (2.1.0) + kindlegen (3.0.3) + rake + rubyzip + mini_portile2 (2.1.0) + minitest (5.11.3) + multi_json (1.13.1) + multipart-post (2.0.0) + nokogiri (1.6.8.1) + mini_portile2 (~> 2.1.0) + octokit (4.8.0) + sawyer (~> 0.8.0, >= 0.5.3) + pdf-core (0.7.0) + pdf-reader (2.1.0) Ascii85 (~> 1.0.0) - afm (~> 0.2.0) + afm (~> 0.2.1) hashery (~> 2.0) ruby-rc4 ttfunk polyglot (0.3.5) - posix-spawn (0.3.9) - prawn (1.2.1) - pdf-core (~> 0.2.5) - ttfunk (~> 1.2.0) - prawn-svg (0.16.0) - prawn (>= 0.8.4) - prawn-table (0.1.1) - prawn-templates (0.0.3) - pdf-reader (~> 1.3) - prawn (>= 0.15.0) - pygments.rb (0.6.0) - posix-spawn (~> 0.3.6) - yajl-ruby (~> 1.1.0) - rake (10.3.2) + prawn (2.2.2) + pdf-core (~> 0.7.0) + ttfunk (~> 1.5) + prawn-icon (1.3.0) + prawn (>= 1.1.0, < 3.0.0) + prawn-svg (0.27.1) + css_parser (~> 1.3) + prawn (>= 0.11.1, < 3) + prawn-table (0.2.2) + prawn (>= 1.3.0, < 3.0.0) + prawn-templates (0.1.1) + pdf-reader (~> 2.0) + prawn (~> 2.2) + public_suffix (3.0.2) + pygments.rb (1.2.1) + multi_json (>= 1.0.0) + rainbow (3.0.0) + rake (12.3.1) + retriable (3.1.1) ruby-rc4 (0.1.5) - rubyzip (1.1.6) - thread_safe (0.3.4) + rubyzip (1.2.1) + safe_yaml (1.0.4) + sawyer (0.8.1) + addressable (>= 2.3.5, < 2.6) + faraday (~> 0.8, < 1.0) + thread_safe (0.3.6) treetop (1.5.3) polyglot (~> 0.3) - ttfunk (1.2.2) - yajl-ruby (1.1.0) + ttfunk (1.5.1) + tzinfo (1.2.5) + thread_safe (~> 0.1) PLATFORMS ruby DEPENDENCIES - asciidoctor (= 1.5.0) - asciidoctor-epub3 (= 1.0.0.alpha.2) - asciidoctor-pdf (= 1.5.0.alpha.5) + asciidoctor (= 1.5.6.1) + asciidoctor-epub3! + asciidoctor-pdf (= 1.5.0.alpha.16) + asciidoctor-pdf-cjk (~> 0.1.3) + asciidoctor-pdf-cjk-kai_gen_gothic (~> 0.1.1) awesome_print coderay - epubcheck + epubcheck-ruby + github_changelog_generator! json kindlegen + octokit pygments.rb rake thread_safe + +BUNDLED WITH + 1.16.1 diff --git a/Rakefile b/Rakefile index 60238672..9cbfebc1 100644 --- a/Rakefile +++ b/Rakefile @@ -1,30 +1,250 @@ -namespace :book do - desc 'prepare build' - task :prebuild do - Dir.mkdir 'images' unless Dir.exists? 'images' - Dir.glob("book/*/images/*").each do |image| - FileUtils.copy(image, "images/" + File.basename(image)) - end +# coding: utf-8 +require 'octokit' +require 'github_changelog_generator' + +def exec_or_raise(command) + puts `#{command}` + if (! $?.success?) + raise "'#{command}' failed" + end +end + +module GitHubChangelogGenerator + + #OPTIONS = %w[ user project token date_format output + # bug_prefix enhancement_prefix issue_prefix + # header merge_prefix issues + # add_issues_wo_labels add_pr_wo_labels + # pulls filter_issues_by_milestone author + # unreleased_only unreleased unreleased_label + # compare_link include_labels exclude_labels + # bug_labels enhancement_labels + # between_tags exclude_tags exclude_tags_regex since_tag max_issues + # github_site github_endpoint simple_list + # future_release release_branch verbose release_url + # base configure_sections add_sections] + + def get_log(&task_block) + options = Parser.default_options + yield(options) if task_block + + options[:user],options[:project] = ENV['TRAVIS_REPO_SLUG'].split('/') + options[:token] = ENV['GITHUB_API_TOKEN'] + options[:unreleased] = false + + generator = Generator.new options + generator.compound_changelog end + module_function :get_log +end + +namespace :book do desc 'build basic book formats' - task :build => :prebuild do + task :build do + + puts "Generating contributors list" + exec_or_raise("git shortlog -s --all $translation_origin | grep -v -E '(Straub|Chacon)' | cut -f 2- | sort | column -c 110 > book/contributors.txt") + + # detect if the deployment is using glob + travis = File.read(".travis.yml") + version_string = ENV['TRAVIS_TAG'] || '0' + if travis.match(/file_glob/) + progit_v = "progit_v#{version_string}" + else + progit_v = "progit" + end + text = File.read('progit.asc') + new_contents = text.gsub("$$VERSION$$", version_string).gsub("$$DATE$$", Time.now.strftime("%Y-%m-%d")) + File.open("#{progit_v}.asc", "w") {|file| file.puts new_contents } + puts "Converting to HTML..." - `bundle exec asciidoctor progit.asc` - puts " -- HTML output at progit.html" + exec_or_raise("bundle exec asciidoctor #{progit_v}.asc") + puts " -- HTML output at #{progit_v}.html" puts "Converting to EPub..." - `bundle exec asciidoctor-epub3 progit.asc` - puts " -- Epub output at progit.epub" + exec_or_raise("bundle exec asciidoctor-epub3 #{progit_v}.asc") + puts " -- Epub output at #{progit_v}.epub" + + exec_or_raise("epubcheck #{progit_v}.epub") puts "Converting to Mobi (kf8)..." - `bundle exec asciidoctor-epub3 -a ebook-format=kf8 progit.asc` - puts " -- Mobi output at progit.mobi" + exec_or_raise("bundle exec asciidoctor-epub3 -a ebook-format=kf8 #{progit_v}.asc") + # remove the fake epub that would shadow the really one + exec_or_raise("rm progit*kf8.epub") + puts " -- Mobi output at #{progit_v}.mobi" + repo = ENV['TRAVIS_REPO_SLUG'] puts "Converting to PDF... (this one takes a while)" - `bundle exec asciidoctor-pdf progit.asc 2>/dev/null` - puts " -- PDF output at progit.pdf" + if (repo == "progit/progit2-zh") + exec_or_raise("asciidoctor-pdf-cjk-kai_gen_gothic-install") + exec_or_raise("bundle exec asciidoctor-pdf -r asciidoctor-pdf-cjk -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicCN #{progit_v}.asc") + elsif (repo == "progit/progit2-ja") + exec_or_raise("asciidoctor-pdf-cjk-kai_gen_gothic-install") + exec_or_raise("bundle exec asciidoctor-pdf -r asciidoctor-pdf-cjk -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicJP #{progit_v}.asc") + elsif (repo == "progit/progit2-zh-tw") + exec_or_raise("asciidoctor-pdf-cjk-kai_gen_gothic-install") + exec_or_raise("bundle exec asciidoctor-pdf -r asciidoctor-pdf-cjk -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicTW #{progit_v}.asc") + elsif (repo == "progit/progit2-ko") + exec_or_raise("asciidoctor-pdf-cjk-kai_gen_gothic-install") + exec_or_raise("bundle exec asciidoctor-pdf -r asciidoctor-pdf-cjk -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicKR #{progit_v}.asc") + else + exec_or_raise("bundle exec asciidoctor-pdf #{progit_v}.asc 2>/dev/null") + end + puts " -- PDF output at #{progit_v}.pdf" + end + + desc 'tag the repo with the latest version' + task :tag do + api_token = ENV['GITHUB_API_TOKEN'] + if ((api_token) && (ENV['TRAVIS_PULL_REQUEST'] == 'false')) + repo = ENV['TRAVIS_REPO_SLUG'] + @octokit = Octokit::Client.new(:access_token => api_token) + begin + last_version=@octokit.latest_release(repo).tag_name + rescue + last_version="2.1.-1" + end + new_patchlevel= last_version.split('.')[-1].to_i + 1 + new_version="2.1.#{new_patchlevel}" + if (ENV['TRAVIS_BRANCH']=='master') + obj = @octokit.create_tag(repo, new_version, "Version " + new_version, + ENV['TRAVIS_COMMIT'], 'commit', + 'Automatic build', 'automatic@no-domain.org', + Time.now.utc.iso8601) + begin + @octokit.create_ref(repo, "tags/#{new_version}", obj.sha) + rescue + p "the ref already exists ???" + end + p "Created tag #{last_version}" + elsif (ENV['TRAVIS_TAG']) + version = ENV['TRAVIS_TAG'] + changelog = GitHubChangelogGenerator.get_log do |config| + config[:since_tag] = last_version + end + credit_line = "\\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*" + changelog.gsub!(credit_line, "") + @octokit.create_release(repo, new_version, {:name => "v#{new_version}", :body => changelog}) + p "Created release #{new_version}" + else + p 'This only runs on a commit to master' + end + else + p 'No interaction with GitHub' + end + end + + desc 'convert book to asciidoctor compatibility' + task:convert do + `cp -aR ../progit2/images .` + `sed -i -e 's!/images/!!' .gitignore` + `git add images` + `git rm -r book/*/images` + + chapters = [ + ["01", "introduction" ], + ["02", "git-basics" ], + ["03", "git-branching" ], + ["04", "git-server" ], + ["05", "distributed-git" ], + ["06", "github" ], + ["07", "git-tools" ], + ["08", "customizing-git" ], + ["09", "git-and-other-scms" ], + ["10", "git-internals" ], + ["A", "git-in-other-environments" ], + ["B", "embedding-git" ], + ["C", "git-commands" ] + ] + + crossrefs = {} + chapters.each { | num, title | + if num =~ /[ABC]/ + chap = "#{num}-#{title}" + else + chap = "ch#{num}-#{title}" + end + Dir[File.join ["book","#{num}-#{title}" , "sections","*.asc"]].map { |filename| + File.read(filename).scan(/\[\[(.*?)\]\]/) + }.flatten.each { |ref| + crossrefs[ref] = "#{chap}" + } + } + + headrefs = {} + chapters.each { | num, title | + if num =~ /[ABC]/ + chap = "#{num}-#{title}" + else + chap = "ch#{num}-#{title}" + end + Dir[File.join ["book","#{num}-#{title}", "*.asc"]].map { |filename| + File.read(filename).scan(/\[\[([_a-z0-9]*?)\]\]/) + }.flatten.each { |ref| + headrefs[ref] = "#{chap}" + } + } + + # transform all internal cross refs + chapters.each { | num, title | + if num =~ /[ABC]/ + chap = "#{num}-#{title}" + else + chap = "ch#{num}-#{title}" + end + files = Dir[File.join ["book","#{num}-#{title}" , "sections","*.asc"]] + + Dir[File.join ["book","#{num}-#{title}" ,"1-*.asc"]] + p files + files.each { |filename| + content = File.read(filename) + new_contents = content.gsub(/\[\[([_a-z0-9]*?)\]\]/, '[[r\1]]').gsub( + "→", "→").gsub(/<<([_a-z0-9]*?)>>/) { |match| + ch = crossrefs[$1] + h = headrefs[$1] + # p " #{match} -> #{ch}, #{h}" + if ch + # if local do not add the file + if ch==chap + "<>" + else + "<<#{ch}#r#{$1}>>" + end + elsif h + if h==chap + "<<#{chap}>>" + else + "<<#{h}##{h}>>" + end + else + p "could not match xref #{$1}" + "<<#{$1}>>" + end + } + File.open(filename, "w") {|file| file.puts new_contents } + } + } + + chapters.each { | num, title | + if num =~ /[ABC]/ + chap = "#{num}-#{title}" + else + chap = "ch#{num}-#{title}" + end + Dir[File.join ["book","#{num}-#{title}" ,"1*.asc"]].map { |filename| + content = File.read (filename) + new_contents = content.gsub(/include::(.*?)asc/) {|match| + "include::book/#{num}-#{title}/#{$1}asc"} + `git rm -f #{filename}` + File.open("#{chap}.asc", "w") {|file| + file.puts "[##{chap}]\n" + file.puts new_contents } + `git add "#{chap}.asc"` + } + } end end + + task :default => "book:build" diff --git a/book/01-introduction/images/areas.png b/book/01-introduction/images/areas.png deleted file mode 100644 index 209bc197..00000000 Binary files a/book/01-introduction/images/areas.png and /dev/null differ diff --git a/book/01-introduction/images/centralized.png b/book/01-introduction/images/centralized.png deleted file mode 100644 index e8d103ab..00000000 Binary files a/book/01-introduction/images/centralized.png and /dev/null differ diff --git a/book/01-introduction/images/deltas.png b/book/01-introduction/images/deltas.png deleted file mode 100644 index b914131e..00000000 Binary files a/book/01-introduction/images/deltas.png and /dev/null differ diff --git a/book/01-introduction/images/distributed.png b/book/01-introduction/images/distributed.png deleted file mode 100644 index 572552cd..00000000 Binary files a/book/01-introduction/images/distributed.png and /dev/null differ diff --git a/book/01-introduction/images/git-osx-installer.png b/book/01-introduction/images/git-osx-installer.png deleted file mode 100644 index 7490d693..00000000 Binary files a/book/01-introduction/images/git-osx-installer.png and /dev/null differ diff --git a/book/01-introduction/images/local.png b/book/01-introduction/images/local.png deleted file mode 100644 index abb473d0..00000000 Binary files a/book/01-introduction/images/local.png and /dev/null differ diff --git a/book/01-introduction/images/snapshots.png b/book/01-introduction/images/snapshots.png deleted file mode 100644 index 82eb324f..00000000 Binary files a/book/01-introduction/images/snapshots.png and /dev/null differ diff --git a/book/01-introduction/sections/about-version-control.asc b/book/01-introduction/sections/about-version-control.asc index caac7ae9..b5b4d31f 100644 --- a/book/01-introduction/sections/about-version-control.asc +++ b/book/01-introduction/sections/about-version-control.asc @@ -83,4 +83,4 @@ image::images/distributed.png[Diagram van een gedistribueerd versiebeheersysteem Bovendien kunnen veel van deze systemen behoorlijk goed omgaan met meerdere (niet-lokale) repositories tegelijk, zodat je met verschillende groepen mensen op verschillende manieren tegelijk aan hetzelfde project kan werken. Hierdoor kan je verschillende werkprocessen ('workflows') zoals hiërarchische modellen opzetten die niet mogelijk - waren geweest met gecentraliseerde systemen. \ No newline at end of file + waren geweest met gecentraliseerde systemen. diff --git a/book/01-introduction/sections/basics.asc b/book/01-introduction/sections/basics.asc index bab79316..a26772b6 100644 --- a/book/01-introduction/sections/basics.asc +++ b/book/01-introduction/sections/basics.asc @@ -36,7 +36,7 @@ Hierdoor moest Git bijna elk aspect van versiebeheer heroverwegen, terwijl de me Dit maakt Git meer een soort mini-bestandssysteem met een paar ongelooflijk krachtige gereedschappen, in plaats van niets meer of minder dan een VCS. We zullen een paar van de voordelen die je krijgt als je op die manier over data denkt gaan onderzoeken, als we - 'branchen' (gesplitste ontwikkeling) toelichten in <<_git_branching>>. + 'branchen' (gesplitste ontwikkeling) toelichten in <>. ==== Bijna alle handelingen zijn lokaal @@ -97,7 +97,7 @@ Zoals met elke VCS kun je veranderingen verliezen of verhaspelen als je deze nog Dit maakt het gebruik van Git zo plezierig omdat je weet dat je kunt experimenteren zonder het gevaar te lopen jezelf behoorlijk in de nesten te werken. -Zie <<_undoing>> voor een iets diepgaandere uitleg over hoe Git gegevens bewaart en hoe je de gegevens die verloren +Zie <> voor een iets diepgaandere uitleg over hoe Git gegevens bewaart en hoe je de gegevens die verloren lijken kunt terughalen. ==== De drie toestanden @@ -139,5 +139,5 @@ De algemene workflow met Git gaat ongeveer zo: Als een bepaalde versie van een bestand in de Git directory staat, wordt het beschouwd als gecommit. Als het is aangepast, maar wel al aan de staging area is toegevoegd, is het gestaged. En als het veranderd is sinds het was uitgechecked maar niet gestaged is, is het aangepast. -In <<_git_basics_chapter>> leer je meer over deze toestanden en hoe je er je voordeel mee kunt doen, maar ook hoe je het - stagen helemaal over kunt slaan. \ No newline at end of file +In <> leer je meer over deze toestanden en hoe je er je voordeel mee kunt doen, maar ook hoe je het + stagen helemaal over kunt slaan. diff --git a/book/01-introduction/sections/command-line.asc b/book/01-introduction/sections/command-line.asc index 010ae170..0b67469b 100644 --- a/book/01-introduction/sections/command-line.asc +++ b/book/01-introduction/sections/command-line.asc @@ -14,4 +14,4 @@ Als laatste: de keuze van grafisch hulpmiddel is een kwestie van persoonlijke sm We gaan er dus van uit dat je weet hoe een Terminal in Mac te openen of een Command Prompt of Powershell in Windows. Als je niet weet waar we het hier over hebben, is het wellicht verstandig om hier te even stoppen en dit op te zoeken - zodat je de rest van de voorbeelden en beschrijvingen in dit boek kunt volgen. \ No newline at end of file + zodat je de rest van de voorbeelden en beschrijvingen in dit boek kunt volgen. diff --git a/book/01-introduction/sections/first-time-setup.asc b/book/01-introduction/sections/first-time-setup.asc index 178788dc..cc80cdb6 100644 --- a/book/01-introduction/sections/first-time-setup.asc +++ b/book/01-introduction/sections/first-time-setup.asc @@ -1,4 +1,4 @@ -[[_first_time]] +[[r_first_time]] === Git klaarmaken voor eerste gebruik Nu je Git op je computer hebt staan, is het handig dat je een paar dingen doet om je Gitomgeving aan jouw voorkeuren diff --git a/book/01-introduction/sections/help.asc b/book/01-introduction/sections/help.asc index 4fe98f8a..88d1dba1 100644 --- a/book/01-introduction/sections/help.asc +++ b/book/01-introduction/sections/help.asc @@ -1,4 +1,4 @@ -[[_git_help]] +[[r_git_help]] === Hulp krijgen Als je ooit hulp nodig hebt met het gebruik van Git, zijn er drie manieren om de gebruiksaanwijzing (manpage) voor elk @@ -23,4 +23,4 @@ Deze commando's zijn prettig omdat je ze overal kunt opvragen, zelfs als je offl Als de manpage en dit boek niet genoeg zijn en je persoonlijke hulp nodig hebt, kan je de kanalen `#git` of `#github` (beiden Engelstalig) op het Freenode IRC netwerk (irc.freenode.net) proberen. In deze kanalen zijn regelmatig honderden mensen aangemeld die allemaal zeer ervaren zijn met Git en vaak bereid om te - helpen.(((IRC))) \ No newline at end of file + helpen.(((IRC))) diff --git a/book/01-introduction/sections/history.asc b/book/01-introduction/sections/history.asc index c5644b64..80c0dc58 100644 --- a/book/01-introduction/sections/history.asc +++ b/book/01-introduction/sections/history.asc @@ -25,4 +25,4 @@ Een paar van de doelen die ze hadden voor het nieuwe systeem waren als volgt: Sinds het ontstaan in 2005 is Git gegroeid tot zijn huidige vorm: het is eenvoudig te gebruiken en heeft toch die oorspronkelijke eigenschappen behouden. Het is ongelofelijk snel, enorm efficiënt met grote projecten en bezit een ongeëvenaard branch-systeem voor het - ondersteunen van niet-lineaire ontwikkelen (zie <<_git_branching>>). \ No newline at end of file + ondersteunen van niet-lineaire ontwikkelen (zie <>). diff --git a/book/02-git-basics/images/lifecycle.png b/book/02-git-basics/images/lifecycle.png deleted file mode 100644 index 1ef9e684..00000000 Binary files a/book/02-git-basics/images/lifecycle.png and /dev/null differ diff --git a/book/02-git-basics/sections/aliases.asc b/book/02-git-basics/sections/aliases.asc index f936c5ae..bfa1e11d 100644 --- a/book/02-git-basics/sections/aliases.asc +++ b/book/02-git-basics/sections/aliases.asc @@ -1,4 +1,4 @@ -[[_git_aliases]] +[[r_git_aliases]] === Git aliassen (((aliasen))) diff --git a/book/02-git-basics/sections/getting-a-repository.asc b/book/02-git-basics/sections/getting-a-repository.asc index dab910cc..e518c8c4 100644 --- a/book/02-git-basics/sections/getting-a-repository.asc +++ b/book/02-git-basics/sections/getting-a-repository.asc @@ -1,4 +1,4 @@ -[[_getting_a_repo]] +[[r_getting_a_repo]] === Een Git repository verkrijgen Je kunt op twee manieren een Git project verkrijgen. @@ -16,7 +16,7 @@ $ git init ---- Dit maakt een nieuwe subdirectory met de naam `.git` aan, die alle noodzakelijke repository bestanden bevat, een Git - repository raamwerk. Op dit moment wordt nog niets in je project gevolgd. (Zie <<_git_internals>> voor meer + repository raamwerk. Op dit moment wordt nog niets in je project gevolgd. (Zie <> voor meer informatie over welke bestanden er precies in de `.git` directory staan, die je zojuist gemaakt hebt.)(((git commando's, git commando's,init))) @@ -35,7 +35,7 @@ $ git commit -m 'initial project version' We zullen zodadelijk beschrijven wat deze commando's doen. Op dit punt heb je een Git repository met gevolgde (tracked) bestanden en een initiële commit. -[[_git_cloning]] +[[r_git_cloning]] ==== Een bestaande repository klonen Als je een kopie wilt van een bestaande Git repository, bijvoorbeeld een project waaraan je wilt bijdragen, dan is @@ -48,7 +48,7 @@ Elke versie van ieder bestand in de hele geschiedenis van een project wordt stan aanroept. In feite kun je, als de schijf van de server kapot gaat, een kloon van een willekeurig werkstation gebruiken om de server terug in de status te brengen op het moment van klonen (al zou je wel wat hooks aan de kant van de server en - dergelijke verliezen, maar alle versies van alle bestanden zullen er zijn; zie <<_git_on_the_server>> voor meer + dergelijke verliezen, maar alle versies van alle bestanden zullen er zijn; zie <> voor meer informatie). Je kloont een repository met `git clone [url]`.(((git commando's, clone))) @@ -76,5 +76,5 @@ Dat commando doet hetzelfde als het vorige, maar dan heet de doeldirectory `myli Git heeft een aantal verschillende transport protocollen die je kunt gebruiken. Het vorige voorbeeld maakt gebruik van het `https://` protocol, maar je kunt ook `git://` of `gebruiker@server:/pad/naar/repo.git` tegenkomen, dat het SSH transport protocol gebruikt. -<<_git_on_the_server>> zal alle beschikbare opties introduceren die de server kan aanbieden om je toegang tot de Git - repositories te geven, met daarbij de voors en tegens van elk. \ No newline at end of file +<> zal alle beschikbare opties introduceren die de server kan aanbieden om je toegang tot de Git + repositories te geven, met daarbij de voors en tegens van elk. diff --git a/book/02-git-basics/sections/recording-changes.asc b/book/02-git-basics/sections/recording-changes.asc index f63c0173..24852921 100644 --- a/book/02-git-basics/sections/recording-changes.asc +++ b/book/02-git-basics/sections/recording-changes.asc @@ -19,7 +19,7 @@ Je staged deze gewijzigde bestanden en commit al je gestagede wijzigingen, en de .De levenscyclus van de status van je bestanden. image::images/lifecycle.png[De levenscyclus van de status van je bestanden.] -[[_checking_status]] +[[r_checking_status]] ==== De status van je bestanden controleren Het commando dat je voornamelijk zult gebruiken om te bepalen welk bestand zich in welke status bevindt is `git @@ -39,7 +39,7 @@ Git ziet ook geen untracked bestanden, anders zouden ze hier getoond worden. Als laatste vertelt het commando op welke tak (branch) je nu zit en informeert je dat het niet is afgeweken van dezelfde branch op de server. Voor nu is deze branch altijd `master`, dat is de standaard; besteed daar voor nu nog geen aandacht aan. -In <<_git_branching>> wordt gedetaileerd ingegaan op branches en referenties. +In <> wordt gedetaileerd ingegaan op branches en referenties. Stel dat je een nieuw bestand toevoegt aan je project, een simpel README bestand. Als het bestand voorheen nog niet bestond, en je doet `git status`, dan zul je het niet getrackte bestand op deze @@ -66,7 +66,7 @@ Dit wordt zo gedaan zodat je niet per ongeluk gegenereerde binaire bestanden toe had willen toevoegen. Je wilt dit README bestand in het vervolg wel meenemen, dus laten we het gaan tracken. -[[_tracking_files]] +[[r_tracking_files]] ==== Nieuwe bestanden volgen (tracking) Om een nieuw bestand te beginnen te tracken, gebruik je het commando `git add`.(((git commando's, add))) @@ -210,7 +210,7 @@ in de uitvoer is het `README` bestand gewijzigd in de werk directory maar nog ni `lib/simplegit.rb` bestand gewijzigd en gestaged is. `Rakefile` is gewijzigd, gestaged en weer gewijzigd, dus er zijn daar wijzigingen die zowel gestaged als ongestaged zijn. -[[_ignoring]] +[[r_ignoring]] ==== Bestanden negeren Vaak zul je een klasse bestanden hebben waarvan je niet wilt dat Git deze automatisch toevoegt of zelfs maar als @@ -279,7 +279,7 @@ GitHub onderhoudt een redelijk uitgebreide lijst van goede voorbeeld `.gitignore https://github.com/github/gitignore[] als je een goed beginpunt voor jouw project wilt hebben. ==== -[[_git_diff_staged]] +[[r_git_diff_staged]] ==== Je staged en unstaged wijzigingen zien Als het `git status` commando te vaag is voor je - je wilt precies weten wat je veranderd hebt en niet alleen welke @@ -422,7 +422,7 @@ Araxis, emerge, vimdiff en meer zien. Gebruik `git difftool --tool-help` om te z systeem. ==== -[[_committing_changes]] +[[r_committing_changes]] ==== Je wijzigingen committen Nu je staging area gevuld is zoals jij het wilt, kun je de wijzigingen committen. @@ -442,7 +442,7 @@ $ git commit Dit start de door jou gekozen editor op. (Dit wordt bepaald door de `$EDITOR` omgevingsvariabele in je shell, meestal vim of emacs, alhoewel je kunt instellen op welke editor je wilt gebruiken met het `git config --global core.editor` commando zoals je hier - <<_getting_started>> gezien hebt).(((editor, standaard wijzigen)))(((git commando's, config))) + <> gezien hebt).(((editor, standaard wijzigen)))(((git commando's, config))) De editor laat de volgende tekst zien (dit voorbeeld is een Vim scherm): @@ -519,7 +519,7 @@ $ git commit -a -m 'added new benchmarks' Merk op dat je nu geen `git add` op het ``CONTRIBUTING.md'' bestand hoeft te doen voordat je commit. -[[_removing_files]] +[[r_removing_files]] ==== Bestanden verwijderen (((bestanden, verwijderen))) @@ -598,7 +598,7 @@ $ git rm \*~ Dit commando verwijdert alle bestanden die eindigen met `~`. -[[_git_mv]] +[[r_git_mv]] ==== Bestanden verplaatsen (((bestanden, verplaatsen))) @@ -644,4 +644,4 @@ Git komt er impliciet achter dat het om een hernoemd bestand gaat, dus het maakt Het enige echte verschil is dat het `mv` commando slechts één commando is in plaats van drie - het is een gemaksfunctie. Belangrijker nog is dat je iedere applicatie kunt gebruiken om een bestand te hernoemen, en de add/rm later kunt - afhandelen voordat je commit. \ No newline at end of file + afhandelen voordat je commit. diff --git a/book/02-git-basics/sections/remotes.asc b/book/02-git-basics/sections/remotes.asc index 6b52766e..abee6ee6 100644 --- a/book/02-git-basics/sections/remotes.asc +++ b/book/02-git-basics/sections/remotes.asc @@ -1,4 +1,4 @@ -[[_remote_repos]] +[[r_remote_repos]] === Werken met remotes Om samen te kunnen werken op eender welke Git project, moet je weten hoe je jouw remote repositories moet beheren. @@ -68,7 +68,7 @@ We zouden ook toestemming kunnen hebben om naar een of meerdere van deze te kunn niet zien. Merk ook op dat deze remotes een veelheid aan protocollen gebruiken, we zullen hierover meer behandelen in -<<_git_on_the_server>>. +<>. ==== Remote repositories toevoegen @@ -107,9 +107,9 @@ From https://github.com/paulboone/ticgit De master branch van Paul is lokaal toegankelijk als `pb/master`; je kunt het in een van jouw branches mergen, of je kunt een lokale branch uitchecken op dat punt als je het wil zien. -(We zullen in meer detail zien wat branches precies zijn, en hoe je ze moet gebruiken in <<_git_branching>>.) +(We zullen in meer detail zien wat branches precies zijn, en hoe je ze moet gebruiken in <>.) -[[_fetching_and_pulling]] +[[r_fetching_and_pulling]] ==== Van je remotes fetchen en pullen Zoals je zojuist gezien hebt, kun je om data van je remote projecten te halen dit uitvoeren:(((git commando's, fetch))) @@ -131,7 +131,7 @@ Het is belangrijk om te weten dat het fetch commando de data naar je locale repo Je moet het handmatig met jouw werk mergen wanneer je er klaar voor bent. Als je een branch geconfigureerd hebt om een remote branch te volgen (tracken) (zie de volgende paragraaf en - <<_git_branching>> voor meer informatie), dan kun je het `git pull` commando gebruiken om automatisch een remote + <> voor meer informatie), dan kun je het `git pull` commando gebruiken om automatisch een remote branch te fetchen en mergen in je huidige branch.(((git commando's, pull))) Dit kan makkelijker of een meer comfortabele workflow zijn voor je; en standaard stelt het `git clone` commando je lokale master branch zo in dat het de remote master branch van de server waarvan je gekloond hebt volgt (of hoe de @@ -139,7 +139,7 @@ standaard branch ook heet). Over het algemeen zal een `git pull` data van de server waarvan je origineel gekloond hebt halen en proberen het automatisch in de code waar je op dat moment aan zit te werken te mergen. -[[_pushing_remotes]] +[[r_pushing_remotes]] ==== Naar je remotes pushen Wanneer je binnen jouw project op een punt zit waarop je het wilt delen, dan moet je het stroomopwaarts pushen. @@ -157,9 +157,9 @@ Dit commando werkt alleen als je gekloond hebt van een server waarop je schrijfr Als jij en iemand anders op hetzelfde tijdstip gekloond hebben en zij pushen eerder stroomopwaarts dan jij, dan zal je push terecht geweigerd worden. Je zult eerst hun werk moeten pullen en in jouw werk verwerken voordat je toegestaan wordt te pushen. -Zie <<_git_branching>> voor meer gedetailleerde informatie over hoe je naar remote servers moet pushen. +Zie <> voor meer gedetailleerde informatie over hoe je naar remote servers moet pushen. -[[_inspecting_remote]] +[[r_inspecting_remote]] ==== Een remote inspecteren Als je meer informatie over een bepaalde remote wilt zien, kun je het `git remote show [remote-name]` commando diff --git a/book/02-git-basics/sections/tagging.asc b/book/02-git-basics/sections/tagging.asc index 06a364a0..beda6c61 100644 --- a/book/02-git-basics/sections/tagging.asc +++ b/book/02-git-basics/sections/tagging.asc @@ -1,4 +1,4 @@ -[[_git_tagging]] +[[r_git_tagging]] === Taggen (Labelen) (((tags))) @@ -54,7 +54,7 @@ Ze worden gechecksumd, bevatten de naam van de tagger, e-mail en datum, hebben e Het wordt over het algemeen aangeraden om annotated tags te maken zodat je deze informatie hebt; maar als je een tijdelijke tag wilt of om een of andere reden de andere informatie niet wilt houden, dan zijn er lightweight tags. -[[_annotated_tags]] +[[r_annotated_tags]] ==== Annotated tags (((tags, annotated)))(((tags, beschreven))) @@ -180,7 +180,7 @@ Date: Sun Apr 27 20:43:35 2008 -0700 ... ---- -[[_sharing_tags]] +[[r_sharing_tags]] ==== Tags delen Standaard zal het `git push` commando geen tags naar remote servers versturen.(((git commando's, push))) @@ -228,4 +228,4 @@ Switched to a new branch 'version2' ---- Je kunt dit natuurlijk doen en dan een commit uitvoeren, jouw `version2` branch zal een klein beetje afwijken van je -`v2.0.0` tag omdat het je met nieuwe wijzigingen mee zal bewegen, dus wees voorzichtig. \ No newline at end of file +`v2.0.0` tag omdat het je met nieuwe wijzigingen mee zal bewegen, dus wees voorzichtig. diff --git a/book/02-git-basics/sections/undoing.asc b/book/02-git-basics/sections/undoing.asc index 17dc0cb8..a64861d6 100644 --- a/book/02-git-basics/sections/undoing.asc +++ b/book/02-git-basics/sections/undoing.asc @@ -1,4 +1,4 @@ -[[_undoing]] +[[r_undoing]] === Dingen ongedaan maken Op enig moment wil je misschien iets ongedaan maken. @@ -35,7 +35,7 @@ $ git commit --amend Na deze drie commando's eindig je met één commit; de tweede commit vervangt de resultaten van de eerste. -[[_unstaging]] +[[r_unstaging]] ==== Een gestaged bestand unstagen De volgende twee paragrafen laten zien hoe je de staging area en veranderingen in je werkdirectories aanpakt. @@ -93,7 +93,7 @@ alleen je staging area. Voor nu is deze toverspreuk alles wat je hoeft te weten van het `git reset` commando. We zullen nog veel meer details behandelen over wat `reset` doet en hoe dit onder te knie te krijgen zodat je werkelijke heel interessante dingen - kunt doen in <>. + kunt doen in <>. ==== Een gewijzigd bestand weer ongewijzigd maken @@ -137,9 +137,9 @@ Gebruik dit commando dan ook nooit, tenzij je heel zeker weet dat je het bestand ===== Als je het voor nu alleen maar even uit de weg wilt hebben, gebruik dan branching of stashing wat we behandelen in -<<_git_branching>>; dit zijn vaak de betere opties. +<>; dit zijn vaak de betere opties. Onthoud, alles dat in Git __gecommit__ is kan bijna altijd weer hersteld worden. Zelfs commits die op reeds verwijderde branches gedaan zijn, of commits die zijn overschreven door een `--amend` - commit, kunnen weer hersteld worden (zie <<_data_recovery>> voor data herstel). -Maar, alles wat je verliest dat nog nooit was gecommit is waarschijnlijk voor altijd verloren. \ No newline at end of file + commit, kunnen weer hersteld worden (zie <> voor data herstel). +Maar, alles wat je verliest dat nog nooit was gecommit is waarschijnlijk voor altijd verloren. diff --git a/book/02-git-basics/sections/viewing-history.asc b/book/02-git-basics/sections/viewing-history.asc index d05c3565..cfe979a1 100644 --- a/book/02-git-basics/sections/viewing-history.asc +++ b/book/02-git-basics/sections/viewing-history.asc @@ -1,4 +1,4 @@ -[[_viewing_history]] +[[r_viewing_history]] === De commit geschiedenis bekijken Nadat je een aantal commits gemaakt hebt, of als je een repository met een bestaande commit-geschiedenis gekloond @@ -167,9 +167,9 @@ ca82a6d - Scott Chacon, 6 years ago : changed the version number a11bef0 - Scott Chacon, 6 years ago : first commit ---- -<> toont een aantal handige opties die aan format gegeven kunnen worden. +<> toont een aantal handige opties die aan format gegeven kunnen worden. -[[pretty_format]] +[[rpretty_format]] .Nuttige opties voor `git log --pretty=format` [cols="1,4",options="header"] |================================ @@ -196,7 +196,7 @@ De auteur is de persoon die het werk oorspronkelijk geschreven heeft, terwijl de als laatste heeft toegepast. Dus als je een patch naar een project stuurt en een van de kernleden past de patch toe, krijgen jullie beiden de eer, jij als de auteur en het kernlid als de committer. -We gaan hier wat verder op in in <<_distributed_git>>. +We gaan hier wat verder op in in <>. De oneline en format opties zijn erg handig in combinatie met een andere `log` optie genaamd `--graph`. Deze optie maakt een mooie ASCII grafiek waarin je branch- en merge-geschiedenis getoond worden: @@ -219,10 +219,10 @@ $ git log --pretty=format:"%h %s" --graph Dit type uitvoer zal interessanter worden als we branching en merging gaan behandelen in het volgende hoofdstuk. Dit zijn slechts een paar simpele uitvoer formaat opties voor `git log`; er zijn er nog veel meer. -<> toont de opties waarover we het tot nog toe gehad hebben, en wat veelvoorkomende formaat opties die +<> toont de opties waarover we het tot nog toe gehad hebben, en wat veelvoorkomende formaat opties die handig kunnen zijn, samen met hoe ze de uitvoer van het `log` commando veranderen. -[[log_options]] +[[rlog_options]] .Gebruikelijke opties bij `git log` [cols="1,4",options="header"] |================================ @@ -281,9 +281,9 @@ Als je een directory of bestandsnaam opgeeft, kun je de log output limiteren tot Dit is altijd de laatste optie en wordt over het algemeen vooraf gegaan door dubbele streepjes (`--`) om de paden van de opties te scheiden. -In <> laten we deze en een paar andere veel voorkomende opties zien als referentie. +In <> laten we deze en een paar andere veel voorkomende opties zien als referentie. -[[limit_options]] +[[rlimit_options]] .Opties om de uitvoer van `git log` te beperken [cols="2,4",options="header"] |================================ @@ -312,4 +312,4 @@ d1a43f2 - reset --hard/read-tree --reset -u: remove unmerged new paths b0ad11e - pull: allow "git pull origin $something:$current_branch" into an unborn branch ---- -Van de bijna 40.000 commits in de Git broncode historie, laat dit commando de 6 zien die aan deze criteria voldoen. \ No newline at end of file +Van de bijna 40.000 commits in de Git broncode historie, laat dit commando de 6 zien die aan deze criteria voldoen. diff --git a/book/03-git-branching/images/advance-master.png b/book/03-git-branching/images/advance-master.png deleted file mode 100644 index b789feda..00000000 Binary files a/book/03-git-branching/images/advance-master.png and /dev/null differ diff --git a/book/03-git-branching/images/advance-testing.png b/book/03-git-branching/images/advance-testing.png deleted file mode 100644 index 35d05811..00000000 Binary files a/book/03-git-branching/images/advance-testing.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-branching-1.png b/book/03-git-branching/images/basic-branching-1.png deleted file mode 100644 index b49b9f4c..00000000 Binary files a/book/03-git-branching/images/basic-branching-1.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-branching-2.png b/book/03-git-branching/images/basic-branching-2.png deleted file mode 100644 index 329c9f52..00000000 Binary files a/book/03-git-branching/images/basic-branching-2.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-branching-3.png b/book/03-git-branching/images/basic-branching-3.png deleted file mode 100644 index 688addac..00000000 Binary files a/book/03-git-branching/images/basic-branching-3.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-branching-4.png b/book/03-git-branching/images/basic-branching-4.png deleted file mode 100644 index c1f1f477..00000000 Binary files a/book/03-git-branching/images/basic-branching-4.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-branching-5.png b/book/03-git-branching/images/basic-branching-5.png deleted file mode 100644 index 1d4c0642..00000000 Binary files a/book/03-git-branching/images/basic-branching-5.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-branching-6.png b/book/03-git-branching/images/basic-branching-6.png deleted file mode 100644 index b93918b5..00000000 Binary files a/book/03-git-branching/images/basic-branching-6.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-merging-1.png b/book/03-git-branching/images/basic-merging-1.png deleted file mode 100644 index 08b923f3..00000000 Binary files a/book/03-git-branching/images/basic-merging-1.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-merging-2.png b/book/03-git-branching/images/basic-merging-2.png deleted file mode 100644 index b1c58b23..00000000 Binary files a/book/03-git-branching/images/basic-merging-2.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-rebase-1.png b/book/03-git-branching/images/basic-rebase-1.png deleted file mode 100644 index bc804f6a..00000000 Binary files a/book/03-git-branching/images/basic-rebase-1.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-rebase-2.png b/book/03-git-branching/images/basic-rebase-2.png deleted file mode 100644 index c75bf386..00000000 Binary files a/book/03-git-branching/images/basic-rebase-2.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-rebase-3.png b/book/03-git-branching/images/basic-rebase-3.png deleted file mode 100644 index a18e34f9..00000000 Binary files a/book/03-git-branching/images/basic-rebase-3.png and /dev/null differ diff --git a/book/03-git-branching/images/basic-rebase-4.png b/book/03-git-branching/images/basic-rebase-4.png deleted file mode 100644 index 277b9257..00000000 Binary files a/book/03-git-branching/images/basic-rebase-4.png and /dev/null differ diff --git a/book/03-git-branching/images/branch-and-history.png b/book/03-git-branching/images/branch-and-history.png deleted file mode 100644 index ba2734e0..00000000 Binary files a/book/03-git-branching/images/branch-and-history.png and /dev/null differ diff --git a/book/03-git-branching/images/checkout-master.png b/book/03-git-branching/images/checkout-master.png deleted file mode 100644 index db052e6a..00000000 Binary files a/book/03-git-branching/images/checkout-master.png and /dev/null differ diff --git a/book/03-git-branching/images/commit-and-tree.png b/book/03-git-branching/images/commit-and-tree.png deleted file mode 100644 index 65289ae8..00000000 Binary files a/book/03-git-branching/images/commit-and-tree.png and /dev/null differ diff --git a/book/03-git-branching/images/commits-and-parents.png b/book/03-git-branching/images/commits-and-parents.png deleted file mode 100644 index e0c9bbea..00000000 Binary files a/book/03-git-branching/images/commits-and-parents.png and /dev/null differ diff --git a/book/03-git-branching/images/head-to-master.png b/book/03-git-branching/images/head-to-master.png deleted file mode 100644 index 5086d0fb..00000000 Binary files a/book/03-git-branching/images/head-to-master.png and /dev/null differ diff --git a/book/03-git-branching/images/head-to-testing.png b/book/03-git-branching/images/head-to-testing.png deleted file mode 100644 index 5422a8ed..00000000 Binary files a/book/03-git-branching/images/head-to-testing.png and /dev/null differ diff --git a/book/03-git-branching/images/interesting-rebase-1.png b/book/03-git-branching/images/interesting-rebase-1.png deleted file mode 100644 index 410287e6..00000000 Binary files a/book/03-git-branching/images/interesting-rebase-1.png and /dev/null differ diff --git a/book/03-git-branching/images/interesting-rebase-2.png b/book/03-git-branching/images/interesting-rebase-2.png deleted file mode 100644 index ac274080..00000000 Binary files a/book/03-git-branching/images/interesting-rebase-2.png and /dev/null differ diff --git a/book/03-git-branching/images/interesting-rebase-3.png b/book/03-git-branching/images/interesting-rebase-3.png deleted file mode 100644 index 91f46473..00000000 Binary files a/book/03-git-branching/images/interesting-rebase-3.png and /dev/null differ diff --git a/book/03-git-branching/images/interesting-rebase-4.png b/book/03-git-branching/images/interesting-rebase-4.png deleted file mode 100644 index 89af34f5..00000000 Binary files a/book/03-git-branching/images/interesting-rebase-4.png and /dev/null differ diff --git a/book/03-git-branching/images/interesting-rebase-5.png b/book/03-git-branching/images/interesting-rebase-5.png deleted file mode 100644 index 0bc02243..00000000 Binary files a/book/03-git-branching/images/interesting-rebase-5.png and /dev/null differ diff --git a/book/03-git-branching/images/lr-branches-1.png b/book/03-git-branching/images/lr-branches-1.png deleted file mode 100644 index 3d26562f..00000000 Binary files a/book/03-git-branching/images/lr-branches-1.png and /dev/null differ diff --git a/book/03-git-branching/images/lr-branches-2.png b/book/03-git-branching/images/lr-branches-2.png deleted file mode 100644 index acfb23db..00000000 Binary files a/book/03-git-branching/images/lr-branches-2.png and /dev/null differ diff --git a/book/03-git-branching/images/perils-of-rebasing-1.png b/book/03-git-branching/images/perils-of-rebasing-1.png deleted file mode 100644 index ce92ce97..00000000 Binary files a/book/03-git-branching/images/perils-of-rebasing-1.png and /dev/null differ diff --git a/book/03-git-branching/images/perils-of-rebasing-2.png b/book/03-git-branching/images/perils-of-rebasing-2.png deleted file mode 100644 index e9b643fa..00000000 Binary files a/book/03-git-branching/images/perils-of-rebasing-2.png and /dev/null differ diff --git a/book/03-git-branching/images/perils-of-rebasing-3.png b/book/03-git-branching/images/perils-of-rebasing-3.png deleted file mode 100644 index e049cbcd..00000000 Binary files a/book/03-git-branching/images/perils-of-rebasing-3.png and /dev/null differ diff --git a/book/03-git-branching/images/perils-of-rebasing-4.png b/book/03-git-branching/images/perils-of-rebasing-4.png deleted file mode 100644 index 669fc812..00000000 Binary files a/book/03-git-branching/images/perils-of-rebasing-4.png and /dev/null differ diff --git a/book/03-git-branching/images/perils-of-rebasing-5.png b/book/03-git-branching/images/perils-of-rebasing-5.png deleted file mode 100644 index 9ba97480..00000000 Binary files a/book/03-git-branching/images/perils-of-rebasing-5.png and /dev/null differ diff --git a/book/03-git-branching/images/remote-branches-1.png b/book/03-git-branching/images/remote-branches-1.png deleted file mode 100644 index 394234f0..00000000 Binary files a/book/03-git-branching/images/remote-branches-1.png and /dev/null differ diff --git a/book/03-git-branching/images/remote-branches-2.png b/book/03-git-branching/images/remote-branches-2.png deleted file mode 100644 index cd9e9d27..00000000 Binary files a/book/03-git-branching/images/remote-branches-2.png and /dev/null differ diff --git a/book/03-git-branching/images/remote-branches-3.png b/book/03-git-branching/images/remote-branches-3.png deleted file mode 100644 index f2a2d163..00000000 Binary files a/book/03-git-branching/images/remote-branches-3.png and /dev/null differ diff --git a/book/03-git-branching/images/remote-branches-4.png b/book/03-git-branching/images/remote-branches-4.png deleted file mode 100644 index 9047854e..00000000 Binary files a/book/03-git-branching/images/remote-branches-4.png and /dev/null differ diff --git a/book/03-git-branching/images/remote-branches-5.png b/book/03-git-branching/images/remote-branches-5.png deleted file mode 100644 index 78b10d28..00000000 Binary files a/book/03-git-branching/images/remote-branches-5.png and /dev/null differ diff --git a/book/03-git-branching/images/topic-branches-1.png b/book/03-git-branching/images/topic-branches-1.png deleted file mode 100644 index 5463092b..00000000 Binary files a/book/03-git-branching/images/topic-branches-1.png and /dev/null differ diff --git a/book/03-git-branching/images/topic-branches-2.png b/book/03-git-branching/images/topic-branches-2.png deleted file mode 100644 index 320e4e88..00000000 Binary files a/book/03-git-branching/images/topic-branches-2.png and /dev/null differ diff --git a/book/03-git-branching/images/two-branches.png b/book/03-git-branching/images/two-branches.png deleted file mode 100644 index 01b385c3..00000000 Binary files a/book/03-git-branching/images/two-branches.png and /dev/null differ diff --git a/book/03-git-branching/sections/basic-branching-and-merging.asc b/book/03-git-branching/sections/basic-branching-and-merging.asc index 44c20be8..afdc54c5 100644 --- a/book/03-git-branching/sections/basic-branching-and-merging.asc +++ b/book/03-git-branching/sections/basic-branching-and-merging.asc @@ -17,7 +17,7 @@ Je zult het volgende doen: . Nadat het getest is de hotfix-branch mergen, en dat naar productie pushen. . Terugswitchen naar je originele verhaal en doorgaan met werken. -[[_basic_branching]] +[[r_basic_branching]] ==== Eenvoudig branchen (((branches, basis workflow))) @@ -71,7 +71,7 @@ Maar voordat je dat doet, weet dat als je werk-directory of staging area wijzigi gecommit zijn en conflicteren met de branch die je gaat uitchecken, Git je niet laat omschakelen. Het beste is om een schone werkstatus te hebben als je tussen branches gaat schakelen. Er zijn manieren om hier mee om te gaan (te weten, stashen en commit ammending) die we later gaan behandelen in - <<_git_stashing>>. + <>. Voor nu laten we aannemen dat je alle wijzigingen gecommit hebt, zodat je kunt switchen naar je master-branch: [source,console] @@ -163,7 +163,7 @@ Als je dat binnen moet halen, dan kun je de `master`-branch in de `iss53`-branch te voeren, of je kunt wachten met die wijzigingen te integreren tot het moment dat je het besluit neemt de `iss53`-branch in de `master` te trekken. -[[_basic_merging]] +[[r_basic_merging]] ==== Eenvoudig mergen (samenvoegen) (((branches, mergen)))(((branches, samenvoegen)))(((merging)))(((mergen))) @@ -212,7 +212,7 @@ Je kunt deze verwijderen en daarna handmatig de ticket in het ticket-volgsysteem $ git branch -d iss53 ---- -[[_basic_merge_conflicts]] +[[r_basic_merge_conflicts]] ==== Eenvoudige merge conflicten (((merging, conflicts)))(((merge, conflicten))) @@ -313,7 +313,7 @@ Type de naam van de applicatie die je liever gebruikt. [NOTE] ==== Als je een meer geavanceerde applicatie wilt gebruiken om ingewikkelde merge conflicten op te lossen: we behandelen -merging uitgebreider in <<_advanced_merging>>. +merging uitgebreider in <>. ==== Nadat je de merge applicatie afsluit, vraagt Git je of de merge succesvol was. @@ -362,4 +362,4 @@ Conflicts: Je kunt dat bericht aanpassen met details over hoe je het conflict opgelost hebt, als je denkt dat dat behulpzaam zal zijn voor anderen die in de toekomst naar deze merge kijken - waarom je hebt gedaan wat je gedaan hebt, als dat - niet vanzelfsprekend is. \ No newline at end of file + niet vanzelfsprekend is. diff --git a/book/03-git-branching/sections/branch-management.asc b/book/03-git-branching/sections/branch-management.asc index 0fd8caa8..0ed98ea2 100644 --- a/book/03-git-branching/sections/branch-management.asc +++ b/book/03-git-branching/sections/branch-management.asc @@ -1,4 +1,4 @@ -[[_branch_management]] +[[r_branch_management]] === Branch-beheer (((branches, managing))) @@ -63,4 +63,4 @@ If you are sure you want to delete it, run 'git branch -D testing'. ---- Als je de branch echt wilt verwijderen en dat werk wilt verliezen, dan kun je het forceren met `-D`, zoals het - behulpzame bericht je al meldt. \ No newline at end of file + behulpzame bericht je al meldt. diff --git a/book/03-git-branching/sections/nutshell.asc b/book/03-git-branching/sections/nutshell.asc index fa75a23b..48ddd11d 100644 --- a/book/03-git-branching/sections/nutshell.asc +++ b/book/03-git-branching/sections/nutshell.asc @@ -1,9 +1,9 @@ -[[_git_branches_overview]] +[[r_git_branches_overview]] === Branches in vogelvlucht Om de manier waarop Git brancht echt te begrijpen, moeten we een stap terug doen en onderzoeken hoe Git zijn gegevens opslaat. -Zoals je je misschien herinnert van <<_getting_started>>, slaat Git zijn gegevens niet op als een reeks van +Zoals je je misschien herinnert van <>, slaat Git zijn gegevens niet op als een reeks van wijzigingen of delta's, maar in plaats daarvan als een serie snapshots. Als je in Git commit, dan slaat Git een commit object op dat een verwijzing bevat naar het snapshot van de inhoud @@ -14,7 +14,7 @@ Dit object bevat ook de auteur- en bericht-metagegevens, en nul of meer verwijzi Om dit te visualiseren, gaan we aannemen dat je een directory hebt met drie bestanden, en je staget en commit ze allemaal. -Door de bestanden te stagen krijgen ze allemaal een checksum (de SHA-1 hash waar we het in <<_getting_started>> over +Door de bestanden te stagen krijgen ze allemaal een checksum (de SHA-1 hash waar we het in <> over hadden), worden die versies de bestanden in het Git repository (Git noemt ze blobs) opgeslagen, en worden die checksums aan de staging area toegevoegd: @@ -58,7 +58,7 @@ De enige reden waarom vrijwel elke repository er een heeft is dat de `git init` .Een branch en zijn commit-historie image::images/branch-and-history.png[Een branch en zijn commit-historie.] -[[_create_new_branch]] +[[r_create_new_branch]] ==== Een nieuwe branch maken (((branches, creating))) @@ -103,7 +103,7 @@ f30ab (HEAD, master, testing) add feature #32 - ability to add new Je kunt de ``master'' en ``testing'' branches zien die direct naast de `f30ab` commit staan. -[[_switching_branches]] +[[r_switching_branches]] ==== Tussen branches schakelen (switching) (((branches, switching))) @@ -170,14 +170,14 @@ $ vim test.rb $ git commit -a -m 'made other changes' ---- -Nu is je project historie uiteengelopen (zie <>). +Nu is je project historie uiteengelopen (zie <>). Je hebt een branch gemaakt en bent er naartoe overgeschakeld, hebt er wat werk op gedaan, en bent toen teruggeschakeld naar je hoofd-branch en hebt nog wat ander werk gedaan. Al die veranderingen zijn geïsoleerd van elkaar in aparte branches: je kunt heen en weer schakelen tussen de branches en ze mergen als je klaar bent. En je hebt dat alles gedaan met eenvoudige `branch`, `checkout` en `commit` commando's. -[[divergent_history]] +[[rdivergent_history]] .Uiteengelopen histories image::images/advance-master.png[Uiteengelopen histories.] @@ -209,4 +209,4 @@ Daarbij komt dat, omdat we de ouders bijhouden als we een commit maken, het vind merge proces automatisch voor ons gedaan is en dit doorgaans eenvoudig te doen is. Deze kenmerken helpen ontwikkelaars aan te moedigen om vaak en veel branches aan te maken. -Laten we eens kijken waarom je dat zou moeten doen. \ No newline at end of file +Laten we eens kijken waarom je dat zou moeten doen. diff --git a/book/03-git-branching/sections/rebasing.asc b/book/03-git-branching/sections/rebasing.asc index 3b019b2f..ebabd3a6 100644 --- a/book/03-git-branching/sections/rebasing.asc +++ b/book/03-git-branching/sections/rebasing.asc @@ -1,4 +1,4 @@ -[[_rebasing]] +[[r_rebasing]] === Rebasen (((rebasing)))(((rebasen))) @@ -9,7 +9,7 @@ In deze paragraaf ga je leren wat rebasen is, hoe je dat moet doen, waarom het e ==== De simpele rebase -Als je het eerdere voorbeeld van <<_basic_merging>> erop terugslaat, dan zul je zien dat je werk is uiteengelopen en +Als je het eerdere voorbeeld van <> erop terugslaat, dan zul je zien dat je werk is uiteengelopen en dat je commits hebt gedaan op de twee verschillende branches. .Eenvoudige uiteengelopen historie @@ -77,13 +77,13 @@ Rebasen speelt veranderingen van een werklijn opnieuw af op een andere, in de vo ==== Interessantere rebases Je kunt je rebase ook opnieuw laten afspelen op iets anders dan de rebase doel branch. -Pak een historie zoals in <>, bijvoorbeeld. +Pak een historie zoals in <>, bijvoorbeeld. Je hebt een topic branch afgesplitst (`server`) om wat server-kant functionaliteit toe te voegen aan je project en toen een keer gecommit. Daarna heb je daar vanaf gebranched om de client-kant wijzigingen te doen (`client`) en een paar keer gecommit. Als laatste, ben je teruggegaan naar je server branch en hebt nog een paar commits gedaan. -[[rbdiag_e]] +[[rrbdiag_e]] .Een historie met een topic branch vanaf een andere topic branch image::images/interesting-rebase-1.png[Een historie met een topic branch vanaf een andere topic branch.] @@ -104,7 +104,7 @@ Het is een beetje ingewikkeld, maar het resultaat, getoond in Figuur 3-32, is er .Een topic branch rebasen vanaf een andere topic branch image::images/interesting-rebase-2.png[Een topic branch rebasen vanaf een andere topic branch.] -Nu kun je een fast-forward doen van je master branch (zie <>): +Nu kun je een fast-forward doen van je master branch (zie <>): [source,console] ---- @@ -112,7 +112,7 @@ $ git checkout master $ git merge client ---- -[[rbdiag_g]] +[[rrbdiag_g]] .Je master branch fast-forwarden om de client branch wijzigingen mee te nemen image::images/interesting-rebase-3.png[Je master branch fast-forwarden om de client branch wijzigingen mee te nemen.] @@ -126,9 +126,9 @@ Je kunt de server branch rebasen op de master branch zonder het eerst te hoeven $ git rebase master server ---- -Dit speelt het `server` werk opnieuw af op het `master` werk, zoals getoond in <>. +Dit speelt het `server` werk opnieuw af op het `master` werk, zoals getoond in <>. -[[rbdiag_h]] +[[rrbdiag_h]] .Je server branch op je master branch rebasen image::images/interesting-rebase-4.png[Je server branch op je master branch rebasen.] @@ -141,7 +141,7 @@ $ git merge server ---- Je kunt de `client` en `server` branches verwijderen, omdat al het werk geïntegreerd is en je ze niet meer nodig - hebt, en de historie voor het hele proces ziet eruit zoals in <>: + hebt, en de historie voor het hele proces ziet eruit zoals in <>: [source,console] ---- @@ -149,11 +149,11 @@ $ git branch -d client $ git branch -d server ---- -[[rbdiag_i]] +[[rrbdiag_i]] .Uiteindelijke commit historie image::images/interesting-rebase-5.png[Uiteindelijke commit historie.] -[[_rebase_peril]] +[[r_rebase_peril]] ==== De gevaren van rebasen (((rebasen, gevaren van))) @@ -186,7 +186,7 @@ Daarna, beslist de persoon die het werk gepusht heeft om erop terug te komen en rebasen; hij voert een `git push --force` uit om de historie op de server te herschrijven. Je pullt daarna van die server, waarbij je de nieuwe commits binnen krijgt. -[[_pre_merge_rebase_work]] +[[r_pre_merge_rebase_work]] .Iemand pusht gerebasede commits, daarbij commits buitenspel zettend waar jij werk op gebaseerd hebt image::images/perils-of-rebasing-3.png["Iemand pusht gerebasede commits, daarbij commits buitenspel zettend waar jij werk op gebaseerd hebt."] @@ -194,7 +194,7 @@ Nu zitten jullie beiden met een probleem. Als jij een `git pull` doet, ga je een commit merge maken waar beide tijdslijnen in zitten, en je repository zal er zo uit zien: -[[_merge_rebase_work]] +[[r_merge_rebase_work]] .Je merget hetzelfde werk opnieuw in een nieuwe merge commit image::images/perils-of-rebasing-4.png[Je merget hetzelfde werk opnieuw in een nieuwe merge commit.] @@ -205,7 +205,7 @@ Daarnaast, als je deze historie naar de server terug pusht, zal je al deze gereb Het is redelijk veilig om aan te nemen dat de andere ontwikkelaar `C4` en `C6` niet in de historie wil, dat is juist de reden waarom ze heeft gerebased. -[[_rebase_rebase]] +[[r_rebase_rebase]] ==== Rebaset spullen rebasen *Mocht* je in zo'n situatie belanden, heeft Git nog wat tovertrucs in petto die je kunnen helpen. Als iemand of een @@ -219,17 +219,17 @@ Als je werk pullt die was herschreven en deze rebased op de nieuwe commits van j uitvinden wat specifiek van jou is en deze opnieuw afspelen op de nieuwe branch. Bijvoorbeeld in het vorige scenario, als in plaats van een merge te doen we in een situatie zijn die beschreven is in -<<_pre_merge_rebase_work>> en we `git rebase teamone/master` aanroepen, zal Git: +<> en we `git rebase teamone/master` aanroepen, zal Git: * Bepalen welk werk uniek is in onze branch (C2, C3, C4, C6, C7) * Bepalen welke geen merge commits zijn (C2, C3, C4) * Bepalen welke nog niet herschreven zijn in de doel-branch (alleen C2 en C3, omdat C4 dezelfde patch is als C4') * Deze commits op `teamone/master` afspelen -Dus in plaats van het resultaat dat we zien in <<_merge_rebase_work>>, zouden we eindigen met iets wat meer lijkt op - <<_rebase_rebase_work>>. +Dus in plaats van het resultaat dat we zien in <>, zouden we eindigen met iets wat meer lijkt op + <>. -[[_rebase_rebase_work]] +[[r_rebase_rebase_work]] .Rebase op een force-pushed rebase werk. image::images/perils-of-rebasing-5.png[Rebase op een force-pushed rebase werk.] @@ -278,4 +278,4 @@ Nu je weet hoe beide werken, is het aan jou om te besluiten welke het beste is v Om het beste van beide aanpakken te krijgen is het over het algemeen het beste om lokale wijzigingen die je nog niet gedeeld hebt te rebasen voordat je ze pusht zodat je verhaal het schoonste blijft, maar nooit iets te rebasen wat je -elders gepusht hebt. \ No newline at end of file +elders gepusht hebt. diff --git a/book/03-git-branching/sections/remote-branches.asc b/book/03-git-branching/sections/remote-branches.asc index 804903cf..95f81f9b 100644 --- a/book/03-git-branching/sections/remote-branches.asc +++ b/book/03-git-branching/sections/remote-branches.asc @@ -1,4 +1,4 @@ -[[_remote_branches]] +[[r_remote_branches]] === Branches op afstand (Remote branches) (((branches, remote)))(((references, remote)))(((referenties, remote))) @@ -59,7 +59,7 @@ Om het hebben van meerdere remote servers te demonstreren en hoe remote branches een van je sprint teams. Deze server bevindt zich op `git.team1.ourcompany.com`. Je kunt het als een nieuwe remote referentie toevoegen aan het project waar je nu aan werkt door het `git remote - add` commando uit te voeren, zoals we behandeld hebben in <<_git_basics_chapter>>. + add` commando uit te voeren, zoals we behandeld hebben in <>. Noem deze remote `teamone`, wat jouw afkorting voor die hele URL wordt. .Een andere server toevoegen als remote @@ -74,7 +74,7 @@ Omdat die server een subset heeft van de gegevens die jouw `origin` server op di .Remote tracking branch voor `teamone/master` image::images/remote-branches-5.png[Remote tracking branch voor `teamone/master`.] -[[_pushing_branches]] +[[r_pushing_branches]] ==== Pushen (((pushen))) @@ -104,7 +104,7 @@ To https://github.com/schacon/simplegit Dit is een beetje de bocht afsnijden. Git zal de `serverfix` branchnaam automatisch expanderen naar `refs/heads/serverfix:refs/heads/serverfix`, wat staat voor "Neem mijn lokale serverfix branch en push die om de serverfix branch van de remote te vernieuwen.". -We zullen het `refs/heads` gedeelte gedetaileerd behandelen in <<_git_internals>>, maar je kunt het normaalgesproken +We zullen het `refs/heads` gedeelte gedetaileerd behandelen in <>, maar je kunt het normaalgesproken weglaten. Je kun ook `git push origin serverfix:serverfix` doen, wat hetzelfde doet. Dit staat voor "Neem mijn serverfix en maak het de serverfix van de remote." @@ -124,7 +124,7 @@ Als je dit niet elke keer wilt intypen als je pusht, kan je een ``credential cac het gewoon in het geheugen te houden voor een aantal minuten. Dit kan je simpel opzetten door `git config --global credential.helper cache` aan te roepen. -Voor meer informatie over de verschillende beschikbare credential caching opties, zie <<_credential_caching>>. +Voor meer informatie over de verschillende beschikbare credential caching opties, zie <>. ==== De volgende keer dat één van je medewerkers van de server fetcht zal deze een referentie krijgen naar de versie van @@ -158,7 +158,7 @@ Switched to a new branch 'serverfix' Dit maakt een lokale branch aan waar je op kunt werken, die begint waar `origin/serverfix` is. -[[_tracking_branches]] +[[r_tracking_branches]] ==== Tracking branches (((branches, tracking)))(((branches, upstream)))(((branches, stroomopwaarts))) @@ -253,7 +253,7 @@ Als je een tracking branch opgezet hebt zoals in de vorige paragraaf getoond, ex Over het algemeen is het beter om de `fetch` en `merge` commando's expliciet te gebruiken omdat de magie van `git pull` vaak verwarrend kan zijn. -[[_delete_branches]] +[[r_delete_branches]] ==== Remote branches verwijderen (((branches, remote verwijderen))) @@ -271,4 +271,4 @@ To https://github.com/schacon/simplegit Alles wat dit doet is de pointer van de server verwijderen. De Git server zal over het algemeen de gegevens nog een poos houden totdat de garbage collection draait, dus als het per ongeluk verwijderd is, is het vaak eenvoudig terug - te halen. \ No newline at end of file + te halen. diff --git a/book/03-git-branching/sections/workflows.asc b/book/03-git-branching/sections/workflows.asc index adb894fd..fd935b6c 100644 --- a/book/03-git-branching/sections/workflows.asc +++ b/book/03-git-branching/sections/workflows.asc @@ -31,7 +31,7 @@ image::images/lr-branches-1.png[Een lineare kijk op progressief-stabiliteits bra Ze zijn misschien makkelijker voor te stellen als werksilo's, waar sets van commits stapsgewijs naar een meer stabiele silo worden gepromoveerd als ze volledig getest zijn. -[[lrbranch_b]] +[[rlrbranch_b]] .Een ``silo'' kijk op progressief-stabiliteits branchen image::images/lr-branches-2.png[Een ``silo'' kijk op progressief-stabiliteits branchen.] @@ -43,7 +43,7 @@ Zodra ze een stabieler niveau bereiken, worden ze in de branch boven hen gemerge Nogmaals, het hebben van langlopende branches is niet noodzakelijk, maar het helpt vaak wel; in het bijzonder als je te maken hebt met zeer grote of complexe projecten. -[[_topic_branch]] +[[r_topic_branch]] ==== Topic branches (((branches, topic))) @@ -83,9 +83,9 @@ Je historie ziet er dan uit volgt: image::images/topic-branches-2.png[Historie na het mergen van `dumbidea` en `iss91v2`.] We zullen in meer detail behandelen wat de verschillende mogelijke workflows zijn voor jouw Git project in - <<_distributed_git>>, dus voordat je besluit welk branching schema je voor jouw volgende project wilt gebruiken, + <>, dus voordat je besluit welk branching schema je voor jouw volgende project wilt gebruiken, zorg dat je dat hoofdstuk gelezen hebt. Het is belangrijk om te beseffen dat tijdens al deze handelingen, al deze branches volledig lokaal zijn. Als je aan het branchen of mergen bent, dan wordt alles alleen in jouw Git repository gedaan - dus er vindt geen - server communicatie plaats. \ No newline at end of file + server communicatie plaats. diff --git a/book/04-git-server/images/bitnami.png b/book/04-git-server/images/bitnami.png deleted file mode 100644 index b7929f48..00000000 Binary files a/book/04-git-server/images/bitnami.png and /dev/null differ diff --git a/book/04-git-server/images/git-instaweb.png b/book/04-git-server/images/git-instaweb.png deleted file mode 100644 index 6c56b710..00000000 Binary files a/book/04-git-server/images/git-instaweb.png and /dev/null differ diff --git a/book/04-git-server/images/gitlab-broadcast.png b/book/04-git-server/images/gitlab-broadcast.png deleted file mode 100644 index 5658f4e0..00000000 Binary files a/book/04-git-server/images/gitlab-broadcast.png and /dev/null differ diff --git a/book/04-git-server/images/gitlab-groups.png b/book/04-git-server/images/gitlab-groups.png deleted file mode 100644 index 486b4441..00000000 Binary files a/book/04-git-server/images/gitlab-groups.png and /dev/null differ diff --git a/book/04-git-server/images/gitlab-menu.png b/book/04-git-server/images/gitlab-menu.png deleted file mode 100644 index 902a7f96..00000000 Binary files a/book/04-git-server/images/gitlab-menu.png and /dev/null differ diff --git a/book/04-git-server/images/gitlab-users.png b/book/04-git-server/images/gitlab-users.png deleted file mode 100644 index 4e2b2090..00000000 Binary files a/book/04-git-server/images/gitlab-users.png and /dev/null differ diff --git a/book/04-git-server/sections/generating-ssh-key.asc b/book/04-git-server/sections/generating-ssh-key.asc index 888331dd..33581cba 100644 --- a/book/04-git-server/sections/generating-ssh-key.asc +++ b/book/04-git-server/sections/generating-ssh-key.asc @@ -1,4 +1,4 @@ -[[_generate_ssh_key]] +[[r_generate_ssh_key]] === Je publieke SSH sleutel genereren (((SSH keys))) @@ -60,4 +60,4 @@ NrRFi9wrf+M7Q== schacon@mylaptop.local ---- Voor een uitgebreidere tutorial over het aanmaken van een SSH sleutel op meerdere operating systemen, verwijzen we - je naar de GitHub handleiding over SSH sleutels op https://help.github.com/articles/generating-ssh-keys[]. \ No newline at end of file + je naar de GitHub handleiding over SSH sleutels op https://help.github.com/articles/generating-ssh-keys[]. diff --git a/book/04-git-server/sections/git-daemon.asc b/book/04-git-server/sections/git-daemon.asc index 21abcb30..97a3d56c 100644 --- a/book/04-git-server/sections/git-daemon.asc +++ b/book/04-git-server/sections/git-daemon.asc @@ -72,4 +72,4 @@ $ cd /path/to/project.git $ touch git-daemon-export-ok ---- -Het feit dat dit bestand er is geeft aan dat Git dat project zonder authenticatie kan verspreiden. \ No newline at end of file +Het feit dat dit bestand er is geeft aan dat Git dat project zonder authenticatie kan verspreiden. diff --git a/book/04-git-server/sections/git-on-a-server.asc b/book/04-git-server/sections/git-on-a-server.asc index 5082b897..d65d3ac6 100644 --- a/book/04-git-server/sections/git-on-a-server.asc +++ b/book/04-git-server/sections/git-on-a-server.asc @@ -1,4 +1,4 @@ -[[_git_on_the_server]] +[[r_git_on_the_server]] === Git op een server krijgen We gaan nu het inrichten van een Git service op je eigen server behandelen waarin deze protocols worden gebuikt. @@ -38,7 +38,7 @@ $ cp -Rf my_project/.git my_project.git Er zijn een paar kleine verschillen in het configuratie bestand, maar het komt op hetzelfde neer. Het neemt de Git repository zelf, zonder een werkdirectory, en maakt een directory specifiek hiervoor aan. -[[_bare_repo]] +[[r_bare_repo]] ==== De kale repository op een server zetten Nu je een kale kopie van je repository hebt, is het enige dat je moet doen het op een server zetten en je @@ -125,4 +125,4 @@ Dit tast de commit data op geen enkele manier aan - de SSH gebruiker waarmee je Een andere manier waarop je het kunt doen is je SSH server laten authenticeren middels een LDAP server of een andere gecentraliseerde authenticatie bron, die misschien al ingericht is. Zolang iedere gebruiker shell toegang kan krijgen op de machine, zou ieder SSH authenticatie mechanisme dat je kunt - bedenken moeten werken. \ No newline at end of file + bedenken moeten werken. diff --git a/book/04-git-server/sections/gitlab.asc b/book/04-git-server/sections/gitlab.asc index 5a247e5d..8af39626 100644 --- a/book/04-git-server/sections/gitlab.asc +++ b/book/04-git-server/sections/gitlab.asc @@ -19,10 +19,10 @@ Er zijn een aantal methoden die je kunt volgen om GitLab te installeren. Om iets snel in de lucht te krijgen, kan je een image van een virtuele machine downloaden of een klik op de knop installatie programma van https://bitnami.com/stack/gitlab[], en de configuratie wat bijstellen voor jouw specifieke omgeving.(((bitnami))) -Bitnami heeft een prettig detail toegevoegd endat is het login scherm (bereikbaar door alt-→ te typen); het +Bitnami heeft een prettig detail toegevoegd endat is het login scherm (bereikbaar door alt-→ te typen); het geeft je het IP adres en standaard gebruikersnaam en wachtwoord voor de geïnstalleerde GitLab. -[[bitnami]] +[[rbitnami]] .Het Bitnami GitLab virtual machine login scherm. image::images/bitnami.png[Het Bitnami GitLab virtual machine login scherm.] @@ -41,7 +41,7 @@ De standaard gebruikersnaam is `admin@local.host`, en het standaard wachtwoord i herinnerd om dit te wijzigen zodra je het intypt). Zodra je aangemeld bent, klik op het ``Admin area'' icoon in het menu rechts boven. -[[gitlab_menu]] +[[rgitlab_menu]] .Het ``Admin area'' item in het GitLab menu. image::images/gitlab-menu.png[Het ``Admin area'' item in het GitLab menu.] @@ -54,7 +54,7 @@ Elke gebruiker heeft een *namespace*, wat een logische groepering van projecten Als de gebruiker +jane+ een project genaamd +project+ zou hebben, zou de URL van dat project http://server/jane/project[] zijn. -[[gitlab_users]] +[[rgitlab_users]] .Het GitLab gebruiker beheer scherm. image::images/gitlab-users.png[Het GitLab gebruiker beheer scherm.] @@ -68,14 +68,14 @@ Alle projecten en gegevens in de namespace worden verwijderd, en alle groepen di worden ook verwijderd. Dit is duidelijk een aktie met meer permanente en vernietigende gevolgen, en het wordt ook zelden gebruikt. -[[_gitlab_groups_section]] +[[r_gitlab_groups_section]] ===== Groepen Een GitLag groep is een verzameling van projecten, samen met gegevens hoe gebruikers deze projecten kunnen benaderen. Elke groep heeft een project namespace (op gelijke manier waarop gebruikers dit hebben), dus als de groep +training+ een project genaamd +materials+ heeft, zou de url http://server/training/materials[] zijn. -[[gitlab_groups]] +[[rgitlab_groups]] .Het GitLab groep beheer scherm. image::images/gitlab-groups.png[Het GitLab groep beheer scherm.] @@ -146,7 +146,7 @@ De eenvoudigste manier van samenwerken op een GitLab project is door een andere geven tot de Git repository. Je kunt een gebruiker aan een project toevoegen door naar het ``Members'' (leden) gedeelte te gaan van de instellingen van dat project, en de nieuwe gebruiker een toegangsniveau toe te wijzen (de verschillende niveaus -worden een beetje besproken in <<_gitlab_groups_section>>). +worden een beetje besproken in <>). Door een gebruiker een toegangsniveau van ``Developer'' of hoger te geven, kan die gebruiker commits pushen en straffeloos branches direct aan de repository toevoegen. @@ -171,4 +171,4 @@ biedt het vele andere mogelijkheden om je team samen te laten werken, zoals proj instrumenten. Een voordeel van GitLab is dat, zodra de server is ingericht en loopt, je nauwelijks nog aanpassingen aan de configuratie bestand hoeft te doen of de server via SSH moet benaderen. De meeste beheer en generieke -gebruikshandelingen kunnen via de browser interface plaatsvinden. \ No newline at end of file +gebruikshandelingen kunnen via de browser interface plaatsvinden. diff --git a/book/04-git-server/sections/gitweb.asc b/book/04-git-server/sections/gitweb.asc index 03ad7af2..2af57f9a 100644 --- a/book/04-git-server/sections/gitweb.asc +++ b/book/04-git-server/sections/gitweb.asc @@ -5,7 +5,7 @@ Nu je gewone lees/schrijf en alleen-lezen toegang tot je project hebt, wil je mi web-gebaseerde visualisatie instellen. Git levert een CGI script genaamd GitWeb mee, dat soms hiervoor gebruikt wordt. -[[gitweb]] +[[rgitweb]] .De GitWeb web-based gebruikers interface. image::images/git-instaweb.png[De GitWeb web-based gebruikers interface.] diff --git a/book/04-git-server/sections/hosted.asc b/book/04-git-server/sections/hosted.asc index 63662839..02c23787 100644 --- a/book/04-git-server/sections/hosted.asc +++ b/book/04-git-server/sections/hosted.asc @@ -12,6 +12,6 @@ Vandaag de dag heb je een groot aantal hosting opties waaruit je kunt kiezen, el Om een recentelijk bijgewerkte lijst te zien, kijk even op de GitHosting pagine van de hoofd Git wiki op https://git .wiki.kernel.org/index.php/GitHosting[] -We zullen het gebruik van GitHub tot in detail bespreken in <<_github>>, daar dit zo'n beetje de grootste Git host is +We zullen het gebruik van GitHub tot in detail bespreken in <>, daar dit zo'n beetje de grootste Git host is die er is en je waarschijnlijk toch in aanraking zult komen met projecten die daar gehost worden; maar er zijn nog tientallen waar je uit kunt kiezen als je niet je eigen Git server wilt inrichten. diff --git a/book/04-git-server/sections/protocols.asc b/book/04-git-server/sections/protocols.asc index c2a6df20..1361f942 100644 --- a/book/04-git-server/sections/protocols.asc +++ b/book/04-git-server/sections/protocols.asc @@ -40,7 +40,7 @@ Als je `file://` specificeert, dan start Git de processen die het normaal gespro transporteren over een netwerk, wat over het algemeen een minder efficiënte methode is om gegevens over te dragen. De belangrijkste reden om `file://` wel te specificeren is als je een schone kopie van de repository wilt met de systeemvreemde referenties of objecten eruit gelaten; over het algemeen na een import uit een ander versiebeheer - systeem of iets dergelijks (zie <<_git_internals>> voor onderhoudstaken). + systeem of iets dergelijks (zie <> voor onderhoudstaken). We zullen het normale pad hier gebruiken, omdat het bijna altijd sneller is om het zo te doen. Om een lokale repository aan een bestaand Git project toe te voegen, kun je iets als het volgende uitvoeren: @@ -60,7 +60,7 @@ Als je al een gedeeld bestandssysteem hebt waar het hele team al toegang toe hee heel gemakkelijk. Je stopt de kale repository ergens waar iedereen gedeelde toegang tot heeft, en stelt de lees- en schrijfrechten in zoals je dat bij iedere andere gedeelde directory zou doen. -In de volgende paragraaf <<_git_on_the_server>> bespreken we hoe je een kopie van een kale repository kunt +In de volgende paragraaf <> bespreken we hoe je een kopie van een kale repository kunt exporteren voor dit doeleinde. Dit is ook een prettige optie om snel werk uit een repository van iemand anders te pakken. @@ -119,7 +119,7 @@ Als de server niet werkt met een Git HTTP slimme service, zal de Git client teru Het domme protocol verwacht dat de kale Git repository moet worden verspreid als gewone bestanden van de web server. Het mooie van het domme HTTP protocol is de eenvoud van het inrichten. Alles wat je hoeft te doen is een kale Git repository onder je HTTP document-root neer te zetten en een speciale -`post-update` hook in te richten, en je bent klaar (Zie <<_git_hooks>>). +`post-update` hook in te richten, en je bent klaar (Zie <>). Vanaf dat moment, kan iedereen die de webserver waarop je de repository hebt gezet kan bereiken ook je repository clonen. Om lees-toegang tot je repository toe te staan over HTTP, kan je iets als dit doen: @@ -146,7 +146,7 @@ $ git clone https://example.com/gitproject.git In dit specifieke geval gebruiken we het `/var/www/htdocs` pad dat gebruikelijk is voor Apache setups, maar je kunt elke statische web server gebruiken; zet gewoon de kale repository in het pad. -De Git data wordt verspreid als gewone statische bestanden (zie <<_git_internals>> voor details hoe precies het wordt +De Git data wordt verspreid als gewone statische bestanden (zie <> voor details hoe precies het wordt verspreid). Over het algemeen zou je kunnen kiezen om een lees/schrijf slimme HTTP server te draaien of om de bestanden @@ -181,7 +181,7 @@ HTTP protocol om Git te bedienen. Als je HTTP gebruikt voor geauthenticeerde pushen, is het invullen van credentials (gebruikersnaam en wachtwoord) soms ingewikkelder dan het gebruik sleutels via SSH. Er zijn echter een aantal credential caching tools die je kunt gebruiken, waaronder Keychain toegang op OSX en Credential Manager op Windows om dit redelijk gladjes te laten -verlopen. Lees <<_credential_caching>> om te zien hoe veilige HTTP wachtwoord caching op jouw systeem op te zetten. +verlopen. Lees <> om te zien hoe veilige HTTP wachtwoord caching op jouw systeem op te zetten. ==== Het SSH Protocol diff --git a/book/04-git-server/sections/setting-up-server.asc b/book/04-git-server/sections/setting-up-server.asc index 214f7412..d5bf32e3 100644 --- a/book/04-git-server/sections/setting-up-server.asc +++ b/book/04-git-server/sections/setting-up-server.asc @@ -1,4 +1,4 @@ -[[_setting_up_server]] +[[r_setting_up_server]] === De server opzetten Laten we het opzetten van SSH toegang aan de server kant eens doorlopen. diff --git a/book/04-git-server/sections/smart-http.asc b/book/04-git-server/sections/smart-http.asc index d008d0b7..efca3b30 100644 --- a/book/04-git-server/sections/smart-http.asc +++ b/book/04-git-server/sections/smart-http.asc @@ -82,4 +82,4 @@ We willen ons niet te veel bochten wringen om de specifieke zaken van Apache con ==== Voor meer informatie over het configureren van authenticatie in Apache, verwijzen we je naar de volgende Apache documentatie: http://httpd.apache.org/docs/current/howto/auth.html[] -==== \ No newline at end of file +==== diff --git a/book/05-distributed-git/images/benevolent-dictator.png b/book/05-distributed-git/images/benevolent-dictator.png deleted file mode 100644 index a742a2ed..00000000 Binary files a/book/05-distributed-git/images/benevolent-dictator.png and /dev/null differ diff --git a/book/05-distributed-git/images/centralized_workflow.png b/book/05-distributed-git/images/centralized_workflow.png deleted file mode 100644 index 4f10782f..00000000 Binary files a/book/05-distributed-git/images/centralized_workflow.png and /dev/null differ diff --git a/book/05-distributed-git/images/git-diff-check.png b/book/05-distributed-git/images/git-diff-check.png deleted file mode 100644 index 5dc9ae40..00000000 Binary files a/book/05-distributed-git/images/git-diff-check.png and /dev/null differ diff --git a/book/05-distributed-git/images/integration-manager.png b/book/05-distributed-git/images/integration-manager.png deleted file mode 100644 index c877f592..00000000 Binary files a/book/05-distributed-git/images/integration-manager.png and /dev/null differ diff --git a/book/05-distributed-git/images/large-merges-1.png b/book/05-distributed-git/images/large-merges-1.png deleted file mode 100644 index b4910f2d..00000000 Binary files a/book/05-distributed-git/images/large-merges-1.png and /dev/null differ diff --git a/book/05-distributed-git/images/large-merges-2.png b/book/05-distributed-git/images/large-merges-2.png deleted file mode 100644 index 0fa474d1..00000000 Binary files a/book/05-distributed-git/images/large-merges-2.png and /dev/null differ diff --git a/book/05-distributed-git/images/managed-team-1.png b/book/05-distributed-git/images/managed-team-1.png deleted file mode 100644 index 84c6f1fb..00000000 Binary files a/book/05-distributed-git/images/managed-team-1.png and /dev/null differ diff --git a/book/05-distributed-git/images/managed-team-2.png b/book/05-distributed-git/images/managed-team-2.png deleted file mode 100644 index 677e095d..00000000 Binary files a/book/05-distributed-git/images/managed-team-2.png and /dev/null differ diff --git a/book/05-distributed-git/images/managed-team-3.png b/book/05-distributed-git/images/managed-team-3.png deleted file mode 100644 index b2f3e07c..00000000 Binary files a/book/05-distributed-git/images/managed-team-3.png and /dev/null differ diff --git a/book/05-distributed-git/images/managed-team-flow.png b/book/05-distributed-git/images/managed-team-flow.png deleted file mode 100644 index 9e4d93f5..00000000 Binary files a/book/05-distributed-git/images/managed-team-flow.png and /dev/null differ diff --git a/book/05-distributed-git/images/merging-workflows-1.png b/book/05-distributed-git/images/merging-workflows-1.png deleted file mode 100644 index 54a96fc0..00000000 Binary files a/book/05-distributed-git/images/merging-workflows-1.png and /dev/null differ diff --git a/book/05-distributed-git/images/merging-workflows-2.png b/book/05-distributed-git/images/merging-workflows-2.png deleted file mode 100644 index 6417c3de..00000000 Binary files a/book/05-distributed-git/images/merging-workflows-2.png and /dev/null differ diff --git a/book/05-distributed-git/images/merging-workflows-3.png b/book/05-distributed-git/images/merging-workflows-3.png deleted file mode 100644 index 1cb18c84..00000000 Binary files a/book/05-distributed-git/images/merging-workflows-3.png and /dev/null differ diff --git a/book/05-distributed-git/images/merging-workflows-4 2.png b/book/05-distributed-git/images/merging-workflows-4 2.png deleted file mode 100644 index 88a696a3..00000000 Binary files a/book/05-distributed-git/images/merging-workflows-4 2.png and /dev/null differ diff --git a/book/05-distributed-git/images/merging-workflows-4.png b/book/05-distributed-git/images/merging-workflows-4.png deleted file mode 100644 index d2f079e6..00000000 Binary files a/book/05-distributed-git/images/merging-workflows-4.png and /dev/null differ diff --git a/book/05-distributed-git/images/merging-workflows-5.png b/book/05-distributed-git/images/merging-workflows-5.png deleted file mode 100644 index 2eb25720..00000000 Binary files a/book/05-distributed-git/images/merging-workflows-5.png and /dev/null differ diff --git a/book/05-distributed-git/images/public-small-1.png b/book/05-distributed-git/images/public-small-1.png deleted file mode 100644 index afc27b29..00000000 Binary files a/book/05-distributed-git/images/public-small-1.png and /dev/null differ diff --git a/book/05-distributed-git/images/public-small-2.png b/book/05-distributed-git/images/public-small-2.png deleted file mode 100644 index 8632c0c3..00000000 Binary files a/book/05-distributed-git/images/public-small-2.png and /dev/null differ diff --git a/book/05-distributed-git/images/public-small-3.png b/book/05-distributed-git/images/public-small-3.png deleted file mode 100644 index c2c33f14..00000000 Binary files a/book/05-distributed-git/images/public-small-3.png and /dev/null differ diff --git a/book/05-distributed-git/images/rebasing-1.png b/book/05-distributed-git/images/rebasing-1.png deleted file mode 100644 index a66f47cd..00000000 Binary files a/book/05-distributed-git/images/rebasing-1.png and /dev/null differ diff --git a/book/05-distributed-git/images/rebasing-2.png b/book/05-distributed-git/images/rebasing-2.png deleted file mode 100644 index 7be83863..00000000 Binary files a/book/05-distributed-git/images/rebasing-2.png and /dev/null differ diff --git a/book/05-distributed-git/images/small-team-1.png b/book/05-distributed-git/images/small-team-1.png deleted file mode 100644 index f821bf6a..00000000 Binary files a/book/05-distributed-git/images/small-team-1.png and /dev/null differ diff --git a/book/05-distributed-git/images/small-team-2.png b/book/05-distributed-git/images/small-team-2.png deleted file mode 100644 index 33e88eac..00000000 Binary files a/book/05-distributed-git/images/small-team-2.png and /dev/null differ diff --git a/book/05-distributed-git/images/small-team-3.png b/book/05-distributed-git/images/small-team-3.png deleted file mode 100644 index 9cddbb43..00000000 Binary files a/book/05-distributed-git/images/small-team-3.png and /dev/null differ diff --git a/book/05-distributed-git/images/small-team-4.png b/book/05-distributed-git/images/small-team-4.png deleted file mode 100644 index abaeee34..00000000 Binary files a/book/05-distributed-git/images/small-team-4.png and /dev/null differ diff --git a/book/05-distributed-git/images/small-team-5.png b/book/05-distributed-git/images/small-team-5.png deleted file mode 100644 index ef3bba19..00000000 Binary files a/book/05-distributed-git/images/small-team-5.png and /dev/null differ diff --git a/book/05-distributed-git/images/small-team-6.png b/book/05-distributed-git/images/small-team-6.png deleted file mode 100644 index 16f429be..00000000 Binary files a/book/05-distributed-git/images/small-team-6.png and /dev/null differ diff --git a/book/05-distributed-git/images/small-team-7.png b/book/05-distributed-git/images/small-team-7.png deleted file mode 100644 index ee6934d8..00000000 Binary files a/book/05-distributed-git/images/small-team-7.png and /dev/null differ diff --git a/book/05-distributed-git/images/small-team-flow.png b/book/05-distributed-git/images/small-team-flow.png deleted file mode 100644 index 846e2c30..00000000 Binary files a/book/05-distributed-git/images/small-team-flow.png and /dev/null differ diff --git a/book/05-distributed-git/sections/contributing.asc b/book/05-distributed-git/sections/contributing.asc index ff5cd6da..ae9501f4 100644 --- a/book/05-distributed-git/sections/contributing.asc +++ b/book/05-distributed-git/sections/contributing.asc @@ -1,4 +1,4 @@ -[[_contributing_project]] +[[r_contributing_project]] === Bijdragen aan een project (((contributing))) @@ -43,7 +43,7 @@ zullen gaan. Je zou in staat moeten zijn om de specifieke workflows die je in jouw praktijk nodig hebt te kunnen herleiden naar deze voorbeelden. -[[_commit_guidelines]] +[[r_commit_guidelines]] ==== Commit richtlijnen Voordat we gaan kijken naar de specifieke gebruiksscenario's, volgt hier een kort stukje over commit berichten. @@ -69,13 +69,13 @@ Probeer, als het je lukt, om je wijzigingen verteerbaar te houden - ga niet het Zelfs als je gedurende het weekend niet commit, gebruik dan het staging gebied op maandag om je werk in ten minste één commit per probleem op te splitsen, met een bruikbaar bericht per commit. Als een paar van de wijzigingen hetzelfde bestand betreffen, probeer dan `git add --patch` te gebruiken om bestanden - gedeeltelijk te stagen (in detail behandeld in <<_interactive_staging>>). + gedeeltelijk te stagen (in detail behandeld in <>). De snapshot aan de kop van het project is gelijk of je nu één commit doet of vijf, zolang alle wijzigingen op een gegeven moment maar toegevoegd zijn, probeer dus om het je mede-ontwikkelaars makkelijk te maken als ze je wijzigingen moeten bekijken. Deze aanpak maakt het ook makkelijker om één wijziging eruit te selecteren of terug te draaien, mocht dat later nodig zijn. -<<_rewriting_history>> beschrijft een aantal handige Git trucs om geschiedenis te herschrijven en bestanden +<> beschrijft een aantal handige Git trucs om geschiedenis te herschrijven en bestanden interactief te stagen - gebruik deze instrumenten als hulp om een schone en begrijpelijke historie op te bouwen voordat deze naar iemand anders wordt gestuurd. @@ -121,7 +121,7 @@ In de volgende voorbeelden en verder door de rest van dit boek, zijn omwille van netjes geformateerd als dit; in plaats daarvan gebruiken we de `-m` optie voor `git commit`. Doe wat wij zeggen, niet wat wij doen. -[[_private_team]] +[[r_private_team]] ==== Besloten klein team (((contributing, private small team))) @@ -281,7 +281,7 @@ Date: Fri May 29 16:01:27 2009 -0700 De `issue54..origin/master` syntax is een log filter dat Git vraagt om alleen de lijst van commits te tonen die op de laatstgenoemde branch (in dit geval `origin/master`) staan die niet in de eerstegenoemde (in dit geval `issue54`) - staan. We zullen deze syntax in detail bespreken in <<_commit_ranges>>. + staan. We zullen deze syntax in detail bespreken in <>. Nu zien we in de uitvoer dat er een commit is die John gemaakt heeft die Jessica nog niet gemerged heeft. Als ze `origin/master` merged, is dat de enkele commit die haar lokale werk zal wijzigen. @@ -467,7 +467,7 @@ To jessica@githost:simplegit.git ----- Dit wordt een _refspec_ genoemd. -Zie <<_refspec>> voor een meer gedetailleerde behandeling van Git refspecs en de verschillende dingen die je daarmee +Zie <> voor een meer gedetailleerde behandeling van Git refspecs en de verschillende dingen die je daarmee kan doen. Meer ook de `-u` vlag op; dit is een verkorte notatie voor `-set-upstream`, wat de branches voor eenvoudigere pushen en pullen op een later moment inricht. @@ -544,7 +544,7 @@ De volgorde van de workflow die je hier zag is ongeveer dit: .Eenvoudige volgorde in de workflow van dit aangestuurde team. image::images/managed-team-flow.png[Eenvoudige volgorde in de workflow van dit aangestuurde team.] -[[_public_project]] +[[r_public_project]] ==== Klein openbaar project (((contributing, public small project))) @@ -578,7 +578,7 @@ $ git commit ==== Je kunt eventueel besluiten `rebase -i` te gebruiken om je werk in één enkele commit samen te persen (squash), of het werk in de commits te herschikken om de patch eenvoudiger te kunnen laten reviewen door de beheerders - zie - <<_rewriting_history>> voor meer informatie over het interactief rebasen. + <> voor meer informatie over het interactief rebasen. ==== Als je werk op de branch af is, en je klaar bent om het over te dragen aan de beheerders, ga je naar de originele @@ -607,7 +607,7 @@ $ git push -u myfork featureA (((git commando's, request-pull))) Als jouw werk gepusht is naar jouw fork, dan moet je de beheerder inlichten. Dit wordt een pull request (haal-binnen-verzoek) genoemd, en je kunt deze via de website genereren - GitHub heeft - een eigen Pull Request mechanisme die we verder zullen behandelen in <<_github>> of je roept het `git request-pull` + een eigen Pull Request mechanisme die we verder zullen behandelen in <> of je roept het `git request-pull` commando aan en stuurt een mail met de uitvoer handmatig naar de projectbeheerder mailen. Het `request-pull` commando neemt de basis branch waarin je de topic branch gepulled wil hebben, en de URL van de @@ -676,9 +676,9 @@ $ git rebase origin/master $ git push -f myfork featureA ----- -Dit herschrijft je historie zodat die eruit ziet als in <>. +Dit herschrijft je historie zodat die eruit ziet als in <>. -[[psp_b]] +[[rpsp_b]] .Commit historie na werk van `featureA`. image::images/public-small-2.png[Commit historie na werk van `featureA`.] @@ -715,7 +715,7 @@ Je kunt de beheerder nu een bericht sturen dat je de gevraagde wijzigingen gemaa .Commit historie na het `featureBv2` werk. image::images/public-small-3.png[Commit historie na het `featureBv2` werk.] -[[_project_over_email]] +[[r_project_over_email]] ==== Openbaar project per e-mail (((contributing, public large project))) @@ -886,4 +886,4 @@ In dit hoofdstuk is een aantal veel voorkomende workflows behandeld, die je kunt een aantal zeer verschillende typen Git projecten die je misschien zult tegenkomen. En er zijn een aantal nieuwe gereedschappen geïntroduceerd die je helpen om dit proces te beheren. Wat hierna volgt zal je laten zien hoe je aan de andere kant van de tafel werkt: een Git project beheren. Je zult - leren hoe een welwillende dictator of integratie manager te zijn. \ No newline at end of file + leren hoe een welwillende dictator of integratie manager te zijn. diff --git a/book/05-distributed-git/sections/distributed-workflows.asc b/book/05-distributed-git/sections/distributed-workflows.asc index c1cc7488..96f98f22 100644 --- a/book/05-distributed-git/sections/distributed-workflows.asc +++ b/book/05-distributed-git/sections/distributed-workflows.asc @@ -45,7 +45,7 @@ Deze workflow spreekt veel mensen aan omdat het een werkwijze is waarmee veel me Deze workflow is echter niet beperkt tot alleen kleine teams. Met het branching model van Git, is het mogelijk om dat honderden ontwikkelaars tegelijktijdig met succes te werken op een enkel project middels tientallen branches. -[[_integration_manager]] +[[r_integration_manager]] ==== Integratie-manager workflow (((workflows, integratie manager))) @@ -57,7 +57,7 @@ Om bij te kunnen dragen tot dat project, maak je je eigen publieke clone van het Daarna stuur je een verzoek naar de eigenaar van het hoofdproject om jouw wijzigingen binnen te halen. Hij kan je repository toevoegen als een remote, je wijzigingen lokaal testen, ze in zijn branch mergen, en dan naar zijn repository pushen. -Het proces werkt als volgt (zie <>): +Het proces werkt als volgt (zie <>): 1. De projecteigenaar pusht naar de publieke repository. 2. Een bijdrager cloned die repository en maakt wijzigingen. @@ -66,7 +66,7 @@ Het proces werkt als volgt (zie <>): 5. De eigenaar voegt de repo van de bijdrager toe als een remote en merged lokaal. 6. De eigenaar pusht de gemergde wijzigingen terug in de hoofdrepository. -[[wfdiag_b]] +[[rwfdiag_b]] .Integratie-manager workflow. image::images/integration-manager.png[Integratie-manager workflow.] @@ -86,7 +86,7 @@ Het wordt over het algemeen gebruikt bij enorme grote projecten met honderden bi Een aantal integrators geven de leiding over bepaalde delen van de repository, zij worden luitenanten genoemd. Alle luitenanten hebben één integrator die bekend staat als de welwillende dictator (benevolent dictator). De repository van de welwillende dictator dient als het referentierepository vanwaar alle bijdragers dienen te pullen. -Het proces werkt als volgt (zie <>): +Het proces werkt als volgt (zie <>): 1. Reguliere ontwikkelaars werken op hun eigen onderwerp (topic) branch en rebasen hun werk op de `master`. De `master` branch is die van de dictator. @@ -95,7 +95,7 @@ Het proces werkt als volgt (zie <>): 4. De dictator pusht zijn `master` branch terug naar het referentierepository zodat de andere ontwikkelaars op deze kunnen rebasen. -[[wfdiag_c]] +[[rwfdiag_c]] .Benevolent dictator workflow. image::images/benevolent-dictator.png[Benevolent dictator workflow.] @@ -111,4 +111,4 @@ zien dat er veel variaties mogelijk zijn om ze te laten passen bij jouw specifie Nu dat je (naar we hopen) in staat bent om te bepalen welke combinatie van workflows voor jou werkt, zullen we wat specifiekere voorbeelden behandelen hoe je de belangrijkste rollen kunt vervullen die in de verschillende workflows voorkomen. -In de volgende paragraaf zal je kennis maken met een aantal reguliere patronen voor het bijdragen aan een project. \ No newline at end of file +In de volgende paragraaf zal je kennis maken met een aantal reguliere patronen voor het bijdragen aan een project. diff --git a/book/05-distributed-git/sections/maintaining.asc b/book/05-distributed-git/sections/maintaining.asc index 258a4c96..a3b61922 100644 --- a/book/05-distributed-git/sections/maintaining.asc +++ b/book/05-distributed-git/sections/maintaining.asc @@ -38,7 +38,7 @@ $ git checkout -b sc/ruby_client master Nu ben je klaar om het bijgedragen werk in deze topic branch toe te voegen, en te bepalen of je het wilt mergen in je meer permanente branches. -[[_patches_from_email]] +[[r_patches_from_email]] ==== Patches uit e-mail toepassen (((email, patches applyen vanuit))) @@ -84,7 +84,7 @@ Als er geen uitvoer is, dan zou de patch netjes moeten passen. Dit commando retourneert ook een niet-nul status als de controle faalt, zodat je het kunt gebruiken in scripts als je dat zou willen. -[[_git_am]] +[[r_git_am]] ===== Een patch met `am` toepassen (((git commando's, am))) @@ -219,7 +219,7 @@ Dit is prettig als je een aantal patches bewaard hebt, omdat je de patch eerst k Als alle patches voor je topic branch zijn toegepast en gecommit zijn op je branch, kan je besluiten of en hoe ze te integreren in een branch met een langere looptijd. -[[_checking_out_remotes]] +[[r_checking_out_remotes]] ==== Remote branches uitchecken (((branches, remote))) @@ -267,7 +267,7 @@ From https://github.com/onetimeguy/project Merge made by recursive. ----- -[[_what_is_introduced]] +[[r_what_is_introduced]] ==== Bepalen wat geïntroduceerd is geworden (((branches, diffing))) @@ -366,14 +366,14 @@ In dit scenario heb je een `master` branch die feitelijk de stabiele code bevat. Als je werk in een topic branch hebt waaraan je gewerkt hebt, of dat iemand anders heeft bijgedragen en je hebt dat nagekeken, dan merge je het in de master branch, verwijdert de topic branch en vervolgt het proces. Als we een repository hebben met werk in twee branches genaamd `ruby_client` en `php_client`, wat eruit ziet zoals - <> en mergen eerst `ruby_client` en daarna `php_client`, dan zal je historie er uit gaan zien zoals in - <>. + <> en mergen eerst `ruby_client` en daarna `php_client`, dan zal je historie er uit gaan zien zoals in + <>. -[[merwf_a]] +[[rmerwf_a]] .Historie met een aantal topic branches. image::images/merging-workflows-1.png[Historie met een aantal topic branches.] -[[merwf_b]] +[[rmerwf_b]] .Na het mergen van een topic branch. image::images/merging-workflows-2.png[Na het mergen van een topic branch.] @@ -384,18 +384,18 @@ Als je belangrijkere projecten hebt, zou je kunnen denken aan een twee-fasen mer In dit scenario heb je twee langlopende branches, `master` en `develop`, waarin je bepaalt dat `master` alleen wordt geupdate als een hele stabiele release wordt gemaakt en alle nieuwe code is geintegreerd in de `develop` branch. Je pusht beide branches regelmatig naar de publieke repository. -Elke keer heb je een nieuwe topic branch om in te mergen (<>), je merged deze in `develop` (<>); - daarna, als je een release tagged, fast-forward je `master` naar waar de nu stabiele `develop` branch is (<>). +Elke keer heb je een nieuwe topic branch om in te mergen (<>), je merged deze in `develop` (<>); + daarna, als je een release tagged, fast-forward je `master` naar waar de nu stabiele `develop` branch is (<>). -[[merwf_c]] +[[rmerwf_c]] .Voor de merge van een topic branch. image::images/merging-workflows-3.png[Voor de merge van een topic branch.] -[[merwf_d]] +[[rmerwf_d]] .Na de merge van een topic branch. image::images/merging-workflows-4.png[Na de merge van een topic branch.] -[[merwf_e]] +[[rmerwf_e]] .Na een project release. image::images/merging-workflows-5.png[Na een project release.] @@ -418,7 +418,7 @@ Hier worden de topics geëvalueerd om te bepalen of ze veilig zijn en klaar voor Als ze veilig zijn, worden ze in `next` gemerged, en wordt die branch gepusht zodat iedereen de geïntegreerde topics kan uitproberen. -[[merwf_f]] +[[rmerwf_f]] .Een complexe reeks van parallelle bijgedragen topic branches beheren. image::images/large-merges-1.png[Een complexe reeks van parallelle bijgedragen topic branches beheren.] @@ -438,7 +438,7 @@ Dus als je de Git repository cloned, dan heb je vier branches die je kunt uitche stadia van ontwikkeling te evalueren, afhankelijk van hoe nieuw je alles wilt hebben of hoe je wil bijdragen. En de beheerders hebben een gestructureerde workflow om ze te helpen nieuwe bijdragen aan de tand te voelen. -[[_rebase_cherry_pick]] +[[r_rebase_cherry_pick]] ===== Rebasende en cherry pick workflows (((workflows, rebasen en cherry-picking))) @@ -508,15 +508,15 @@ Als het op zich aangeroepen wordt, zal Git de database met oplossingen controler voor alle huidige merge conflicten en deze proberen op te lossen (alhoewel dit automatisch wordt gedaan als `rerere .enabled` op `true` is gezet). Er zijn ook sub-commando's om te zien wat er opgeslagen gaat worden, om specifieke oplossingen uit de cache te - verwijderen, en om de gehele cache te legen. We zullen rerere meer gedetailleerd behandelen in <<_rerere>>. + verwijderen, en om de gehele cache te legen. We zullen rerere meer gedetailleerd behandelen in <>. -[[_tagging_releases]] +[[r_tagging_releases]] ==== Je releases taggen (((tags)))(((tags, signing)))(((tags, tekenen))) Als je hebt besloten om een release te maken, zul je waarschijnlijk een tag willen aanmaken zodat je die release op elk moment in de toekomst opnieuw kunt maken. -Je kunt een nieuwe tag maken zoals ik heb beschreven in <<_git_basics_chapter>>. +Je kunt een nieuwe tag maken zoals ik heb beschreven in <>. Als je besluit om de tag als de beheerder te signeren, dan ziet het taggen er wellicht zo uit: [source,console] @@ -573,7 +573,7 @@ Ze kunnen die sleutel gebruiken om al je gesigneerde tags te verifiëren. En als je instructies in het tag bericht zet, dan zal `git show ` je eindgebruikers meer specifieke instructies geven over tag verificatie. -[[_build_number]] +[[r_build_number]] ==== Een bouw nummer genereren (((build numbers)))(((git commando's, describe))) @@ -602,7 +602,7 @@ afhankelijk is van de verkorte SHA-1 waarde aan het einde, dus het zou niet voor Als voorbeeld, de Linux kernel sprong recentelijk van 8 naar 10 karakters om er zeker van de zijn dat de SHA-1 uniek zijn, oudere `git describe` commando uitvoernamen werden daardoor ongeldig. -[[_preparing_release]] +[[r_preparing_release]] ==== Een release voorbereiden (((releasen)))(((git commando's, archive))) @@ -630,7 +630,7 @@ $ git archive master --prefix='project/' --format=zip > `git describe master`.zi Je hebt nu een mooie tarball en een zip archief van je project release, die je kunt uploaden naar je website of naar mensen kunt e-mailen. -[[_the_shortlog]] +[[r_the_shortlog]] ==== De shortlog (((git commando's, shortlog))) @@ -660,4 +660,4 @@ Tom Preston-Werner (4): ----- Je krijgt een opgeschoonde samenvatting van alle commits sinds v1.0.1, gegroepeerd op auteur, die je naar de lijst - kunt e-mailen. \ No newline at end of file + kunt e-mailen. diff --git a/book/06-github/images/2fa-1.png b/book/06-github/images/2fa-1.png deleted file mode 100644 index 20a6e599..00000000 Binary files a/book/06-github/images/2fa-1.png and /dev/null differ diff --git a/book/06-github/images/account-settings.png b/book/06-github/images/account-settings.png deleted file mode 100644 index 622171a6..00000000 Binary files a/book/06-github/images/account-settings.png and /dev/null differ diff --git a/book/06-github/images/avatar-crop.png b/book/06-github/images/avatar-crop.png deleted file mode 100644 index cd1671ae..00000000 Binary files a/book/06-github/images/avatar-crop.png and /dev/null differ diff --git a/book/06-github/images/blink-01-start.png b/book/06-github/images/blink-01-start.png deleted file mode 100644 index be140e19..00000000 Binary files a/book/06-github/images/blink-01-start.png and /dev/null differ diff --git a/book/06-github/images/blink-02-pr.png b/book/06-github/images/blink-02-pr.png deleted file mode 100644 index 96816571..00000000 Binary files a/book/06-github/images/blink-02-pr.png and /dev/null differ diff --git a/book/06-github/images/blink-03-pull-request-open.png b/book/06-github/images/blink-03-pull-request-open.png deleted file mode 100644 index 70350865..00000000 Binary files a/book/06-github/images/blink-03-pull-request-open.png and /dev/null differ diff --git a/book/06-github/images/blink-04-email.png b/book/06-github/images/blink-04-email.png deleted file mode 100644 index af3090e7..00000000 Binary files a/book/06-github/images/blink-04-email.png and /dev/null differ diff --git a/book/06-github/images/blink-04-pr-comment.png b/book/06-github/images/blink-04-pr-comment.png deleted file mode 100644 index 4e31e773..00000000 Binary files a/book/06-github/images/blink-04-pr-comment.png and /dev/null differ diff --git a/book/06-github/images/blink-05-general-comment.png b/book/06-github/images/blink-05-general-comment.png deleted file mode 100644 index 1c3f4f3e..00000000 Binary files a/book/06-github/images/blink-05-general-comment.png and /dev/null differ diff --git a/book/06-github/images/blink-06-final.png b/book/06-github/images/blink-06-final.png deleted file mode 100644 index 06dc9de6..00000000 Binary files a/book/06-github/images/blink-06-final.png and /dev/null differ diff --git a/book/06-github/images/blink-pull-request-open copy.png b/book/06-github/images/blink-pull-request-open copy.png deleted file mode 100644 index ad7976e3..00000000 Binary files a/book/06-github/images/blink-pull-request-open copy.png and /dev/null differ diff --git a/book/06-github/images/blink-pull-request-open.png b/book/06-github/images/blink-pull-request-open.png deleted file mode 100644 index 3c43df3c..00000000 Binary files a/book/06-github/images/blink-pull-request-open.png and /dev/null differ diff --git a/book/06-github/images/collaborators.png b/book/06-github/images/collaborators.png deleted file mode 100644 index ba126100..00000000 Binary files a/book/06-github/images/collaborators.png and /dev/null differ diff --git a/book/06-github/images/email-settings.png b/book/06-github/images/email-settings.png deleted file mode 100644 index 0291aeac..00000000 Binary files a/book/06-github/images/email-settings.png and /dev/null differ diff --git a/book/06-github/images/emoji.png b/book/06-github/images/emoji.png deleted file mode 100644 index 83c8cd21..00000000 Binary files a/book/06-github/images/emoji.png and /dev/null differ diff --git a/book/06-github/images/forkbutton.png b/book/06-github/images/forkbutton.png deleted file mode 100644 index 9bc4c798..00000000 Binary files a/book/06-github/images/forkbutton.png and /dev/null differ diff --git a/book/06-github/images/hubot.png b/book/06-github/images/hubot.png deleted file mode 100644 index 510b265f..00000000 Binary files a/book/06-github/images/hubot.png and /dev/null differ diff --git a/book/06-github/images/maint-01-email.png b/book/06-github/images/maint-01-email.png deleted file mode 100644 index 1477b36d..00000000 Binary files a/book/06-github/images/maint-01-email.png and /dev/null differ diff --git a/book/06-github/images/maint-02-merge.png b/book/06-github/images/maint-02-merge.png deleted file mode 100644 index 69efa4b6..00000000 Binary files a/book/06-github/images/maint-02-merge.png and /dev/null differ diff --git a/book/06-github/images/maint-03-email-resp.png b/book/06-github/images/maint-03-email-resp.png deleted file mode 100644 index dbd3e648..00000000 Binary files a/book/06-github/images/maint-03-email-resp.png and /dev/null differ diff --git a/book/06-github/images/maint-04-target.png b/book/06-github/images/maint-04-target.png deleted file mode 100644 index 0b153962..00000000 Binary files a/book/06-github/images/maint-04-target.png and /dev/null differ diff --git a/book/06-github/images/maint-05-mentions.png b/book/06-github/images/maint-05-mentions.png deleted file mode 100644 index 35b60f3d..00000000 Binary files a/book/06-github/images/maint-05-mentions.png and /dev/null differ diff --git a/book/06-github/images/maint-06-unsubscribe.png b/book/06-github/images/maint-06-unsubscribe.png deleted file mode 100644 index eaf6e2cf..00000000 Binary files a/book/06-github/images/maint-06-unsubscribe.png and /dev/null differ diff --git a/book/06-github/images/maint-07-notifications.png b/book/06-github/images/maint-07-notifications.png deleted file mode 100644 index 7d07a4b2..00000000 Binary files a/book/06-github/images/maint-07-notifications.png and /dev/null differ diff --git a/book/06-github/images/maint-08-notifications-page.png b/book/06-github/images/maint-08-notifications-page.png deleted file mode 100644 index d4998614..00000000 Binary files a/book/06-github/images/maint-08-notifications-page.png and /dev/null differ diff --git a/book/06-github/images/maint-09-contrib.png b/book/06-github/images/maint-09-contrib.png deleted file mode 100644 index f6d9af3c..00000000 Binary files a/book/06-github/images/maint-09-contrib.png and /dev/null differ diff --git a/book/06-github/images/maint-10-default-branch.png b/book/06-github/images/maint-10-default-branch.png deleted file mode 100644 index bd251d6c..00000000 Binary files a/book/06-github/images/maint-10-default-branch.png and /dev/null differ diff --git a/book/06-github/images/maint-11-transfer.png b/book/06-github/images/maint-11-transfer.png deleted file mode 100644 index 5dc5724c..00000000 Binary files a/book/06-github/images/maint-11-transfer.png and /dev/null differ diff --git a/book/06-github/images/markdown-01-example.png b/book/06-github/images/markdown-01-example.png deleted file mode 100644 index 10bbf18c..00000000 Binary files a/book/06-github/images/markdown-01-example.png and /dev/null differ diff --git a/book/06-github/images/markdown-02-tasks.png b/book/06-github/images/markdown-02-tasks.png deleted file mode 100644 index 6dafbc73..00000000 Binary files a/book/06-github/images/markdown-02-tasks.png and /dev/null differ diff --git a/book/06-github/images/markdown-03-task-summary.png b/book/06-github/images/markdown-03-task-summary.png deleted file mode 100644 index 536aa094..00000000 Binary files a/book/06-github/images/markdown-03-task-summary.png and /dev/null differ diff --git a/book/06-github/images/markdown-04-fenced-code.png b/book/06-github/images/markdown-04-fenced-code.png deleted file mode 100644 index ca3482f9..00000000 Binary files a/book/06-github/images/markdown-04-fenced-code.png and /dev/null differ diff --git a/book/06-github/images/markdown-05-quote.png b/book/06-github/images/markdown-05-quote.png deleted file mode 100644 index 02a8451a..00000000 Binary files a/book/06-github/images/markdown-05-quote.png and /dev/null differ diff --git a/book/06-github/images/markdown-06-emoji-complete.png b/book/06-github/images/markdown-06-emoji-complete.png deleted file mode 100644 index ce949200..00000000 Binary files a/book/06-github/images/markdown-06-emoji-complete.png and /dev/null differ diff --git a/book/06-github/images/markdown-07-emoji.png b/book/06-github/images/markdown-07-emoji.png deleted file mode 100644 index b535756d..00000000 Binary files a/book/06-github/images/markdown-07-emoji.png and /dev/null differ diff --git a/book/06-github/images/markdown-08-drag-drop.png b/book/06-github/images/markdown-08-drag-drop.png deleted file mode 100644 index 1dfb3b98..00000000 Binary files a/book/06-github/images/markdown-08-drag-drop.png and /dev/null differ diff --git a/book/06-github/images/mentions-01-syntax.png b/book/06-github/images/mentions-01-syntax.png deleted file mode 100644 index c960b0c9..00000000 Binary files a/book/06-github/images/mentions-01-syntax.png and /dev/null differ diff --git a/book/06-github/images/mentions-02-render.png b/book/06-github/images/mentions-02-render.png deleted file mode 100644 index 5b4bfee3..00000000 Binary files a/book/06-github/images/mentions-02-render.png and /dev/null differ diff --git a/book/06-github/images/mentions-03-closed.png b/book/06-github/images/mentions-03-closed.png deleted file mode 100644 index cf3ef9e2..00000000 Binary files a/book/06-github/images/mentions-03-closed.png and /dev/null differ diff --git a/book/06-github/images/new-repo.png b/book/06-github/images/new-repo.png deleted file mode 100644 index 485515bd..00000000 Binary files a/book/06-github/images/new-repo.png and /dev/null differ diff --git a/book/06-github/images/neworg.png b/book/06-github/images/neworg.png deleted file mode 100644 index db47fff0..00000000 Binary files a/book/06-github/images/neworg.png and /dev/null differ diff --git a/book/06-github/images/newrepo.png b/book/06-github/images/newrepo.png deleted file mode 100644 index cd508f16..00000000 Binary files a/book/06-github/images/newrepo.png and /dev/null differ diff --git a/book/06-github/images/newrepoform.png b/book/06-github/images/newrepoform.png deleted file mode 100644 index 28fa6a7e..00000000 Binary files a/book/06-github/images/newrepoform.png and /dev/null differ diff --git a/book/06-github/images/notifications.png b/book/06-github/images/notifications.png deleted file mode 100644 index 6768db4d..00000000 Binary files a/book/06-github/images/notifications.png and /dev/null differ diff --git a/book/06-github/images/orgs-01-page.png b/book/06-github/images/orgs-01-page.png deleted file mode 100644 index 149773fe..00000000 Binary files a/book/06-github/images/orgs-01-page.png and /dev/null differ diff --git a/book/06-github/images/orgs-02-teams.png b/book/06-github/images/orgs-02-teams.png deleted file mode 100644 index 46f5f2ce..00000000 Binary files a/book/06-github/images/orgs-02-teams.png and /dev/null differ diff --git a/book/06-github/images/orgs-03-audit.png b/book/06-github/images/orgs-03-audit.png deleted file mode 100644 index 4f063989..00000000 Binary files a/book/06-github/images/orgs-03-audit.png and /dev/null differ diff --git a/book/06-github/images/pr-01-fail.png b/book/06-github/images/pr-01-fail.png deleted file mode 100644 index 80331c1d..00000000 Binary files a/book/06-github/images/pr-01-fail.png and /dev/null differ diff --git a/book/06-github/images/pr-02-merge-fix.png b/book/06-github/images/pr-02-merge-fix.png deleted file mode 100644 index 9da16322..00000000 Binary files a/book/06-github/images/pr-02-merge-fix.png and /dev/null differ diff --git a/book/06-github/images/reposettingslink.png b/book/06-github/images/reposettingslink.png deleted file mode 100644 index 45e60162..00000000 Binary files a/book/06-github/images/reposettingslink.png and /dev/null differ diff --git a/book/06-github/images/scripting-01-services.png b/book/06-github/images/scripting-01-services.png deleted file mode 100644 index 07c20103..00000000 Binary files a/book/06-github/images/scripting-01-services.png and /dev/null differ diff --git a/book/06-github/images/scripting-02-email-service.png b/book/06-github/images/scripting-02-email-service.png deleted file mode 100644 index 209bfe76..00000000 Binary files a/book/06-github/images/scripting-02-email-service.png and /dev/null differ diff --git a/book/06-github/images/scripting-03-webhook.png b/book/06-github/images/scripting-03-webhook.png deleted file mode 100644 index 103eb92a..00000000 Binary files a/book/06-github/images/scripting-03-webhook.png and /dev/null differ diff --git a/book/06-github/images/scripting-04-webhook-debug.png b/book/06-github/images/scripting-04-webhook-debug.png deleted file mode 100644 index 617e41ee..00000000 Binary files a/book/06-github/images/scripting-04-webhook-debug.png and /dev/null differ diff --git a/book/06-github/images/scripting-05-access-token.png b/book/06-github/images/scripting-05-access-token.png deleted file mode 100644 index 17507717..00000000 Binary files a/book/06-github/images/scripting-05-access-token.png and /dev/null differ diff --git a/book/06-github/images/scripting-06-comment.png b/book/06-github/images/scripting-06-comment.png deleted file mode 100644 index 52448174..00000000 Binary files a/book/06-github/images/scripting-06-comment.png and /dev/null differ diff --git a/book/06-github/images/scripting-07-status.png b/book/06-github/images/scripting-07-status.png deleted file mode 100644 index a34314d9..00000000 Binary files a/book/06-github/images/scripting-07-status.png and /dev/null differ diff --git a/book/06-github/images/signup.png b/book/06-github/images/signup.png deleted file mode 100644 index 916a882c..00000000 Binary files a/book/06-github/images/signup.png and /dev/null differ diff --git a/book/06-github/images/ssh-keys.png b/book/06-github/images/ssh-keys.png deleted file mode 100644 index b9dec471..00000000 Binary files a/book/06-github/images/ssh-keys.png and /dev/null differ diff --git a/book/06-github/images/your-profile.png b/book/06-github/images/your-profile.png deleted file mode 100644 index 50fa0c1e..00000000 Binary files a/book/06-github/images/your-profile.png and /dev/null differ diff --git a/book/06-github/sections/1-setting-up-account.asc b/book/06-github/sections/1-setting-up-account.asc index 18eeb1cd..9a5543c5 100644 --- a/book/06-github/sections/1-setting-up-account.asc +++ b/book/06-github/sections/1-setting-up-account.asc @@ -31,7 +31,7 @@ Echter, om eenvoudigweg openbare projecten te clonen hoef je niet eens in te sch gemaakt hebben gaat een rol spelen als we straks projecten gaan forken en als naar onze forks gaan pushen. Als je SSH remotes wilt gebruiken, zal je een publieke sleutel moeten configureren. -(Als je er nog geen hebt, zie <<_generate_ssh_key>>.) +(Als je er nog geen hebt, zie <>.) Open je account instellingen met de link rechtsboven op het scherm: .De ``Account settings'' link. @@ -52,7 +52,7 @@ Zorg ervoor de je je SSH sleuten een naam geeft die je kunt onthouden. Je kunt e hebben. ==== -[[_personal_avatar]] +[[r_personal_avatar]] ==== Jouw avatar Daarna kan je, als je dat wilt, de gegenereerde avatar vervangen met een afbeelding van jouw keuze. Ga eerst naar de @@ -78,11 +78,11 @@ De manier waarop GitHub je Git commits koppelt aan je gebruiker is via het email adressen gebruikt in je commits en je wilt dat GitHub ze juist koppelt, moet je alle email adressen die je gebruikt hebt toevoegen aan de Emails sectie van de admin sectie. -[[_add_email_addresses]] +[[r_add_email_addresses]] .Voeg email adressen toe image::images/email-settings.png[Voeg al je email adressen toe.] -In <<_add_email_addresses>> kunnen we een aantal van de verschillende stadia zien die mogelijk zijn. +In <> kunnen we een aantal van de verschillende stadia zien die mogelijk zijn. Het bovenste adres is geverifiëerd en is gezet als het primaire adres, wat inhoudt dat notificaties en nota's naar dit adres gestuurd zullen worden. Het tweede adres is geverifiëerd en kan dus als primair worden gekozen als je ze zou willen wisselen. @@ -108,4 +108,4 @@ Als je de ``Set up two-factor authentication'' knop klikt, zal dit je naar een c tijdsgerelateerde eenmalig wachtwoord), of je kunt GitHub elke keer als je moet inloggen een code laten SMSsen. Nadat je een voorkeursmethode hebt gekozen en de instructies volgt voor het instellen van 2FA, zal je account iets - veiliger zijn en zal je een aanvullende code moeten opgeven bij je wachtwoord elke keer als je in GitHub inlogt. \ No newline at end of file + veiliger zijn en zal je een aanvullende code moeten opgeven bij je wachtwoord elke keer als je in GitHub inlogt. diff --git a/book/06-github/sections/2-contributing.asc b/book/06-github/sections/2-contributing.asc index 1d984ec0..d27a67ff 100644 --- a/book/06-github/sections/2-contributing.asc +++ b/book/06-github/sections/2-contributing.asc @@ -32,14 +32,14 @@ image::images/forkbutton.png[De ``Fork'' knop.] Na enkele seconden zal je naar jouw nieuwe projectpagina worden geleid, met je eigen schrijfbare kopie van de code. -[[_github_flow]] +[[r_github_flow]] ==== De GitHub flow (((GitHub, Flow))) GitHub is ontworpen rond een specifieke samenwerkings workflow die draait om pull verzoeken (Pull Requests). Deze workflow werkt of je nu samenwerkt met een hecht team in een enkel gedeelde repository of een bedrijf dat wereldwijd verspreid is of een netwerk van onbekenden die bijdragen aan een project door middel van vele forks. -Het is gericht op de <<_topic_branch>> workflow die behandeld is in <<_git_branching>>. +Het is gericht op de <> workflow die behandeld is in <>. Hier is hoe het over het algemeen werkt: @@ -50,7 +50,7 @@ Hier is hoe het over het algemeen werkt: 5. Bespreek en blijf committen zo je wilt. 6. De project eigenaar mergt of sluit de Pull Request. -Dit is eigenlijk de Integratie Manager workflow zoals deze behandeld is in <<_integration_manager>>, maar in plaats +Dit is eigenlijk de Integratie Manager workflow zoals deze behandeld is in <>, maar in plaats van mail te gebruiken om te communiceren en wijzigingen te reviewen, gebruiken teams de web-gebaseerde instrumenten van GitHub. @@ -165,7 +165,7 @@ Op dit moment kan de project eigenaar naar de voorgedragen wijziging kijken en d reageren. Laten we zeggen dat het idee hem aanspreekt, maar dat hij het lichtje iets langer uit wil hebben dan aan. Waar deze discussie via mail zou kunnen plaatsvinden in de workflows die we hebben laten zien in - <<_distributed_git>>, heeft het bij GitHub online plaats. De project eigenaar kan de unified diff bekijken en een + <>, heeft het bij GitHub online plaats. De project eigenaar kan de unified diff bekijken en een commentaar achterlaten door op een of meer regels te klikken. .Commentariëren op een specifieke code regel in een Pull Request @@ -175,15 +175,15 @@ Als de onderhouder dit commentaar eenmaal heeft gemaakt zal de persoon die de Pu iedereen die deze repository volgt) een berichtje krijgen. We zullen straks de manier waarop dit kan worden aangepast behandelen, maar als hij email notificaties aan heeft staan, zou Tony een mail zoals deze krijgen: -[[_email_notificatie]] +[[r_email_notificatie]] .Comments sent as email notifications image::images/blink-04-email.png[Email notificatie] -Het is iedereen toegestaan om algemene commentaren op het Pull Request te maken. In <<_pr_discussion>> kunnen we een +Het is iedereen toegestaan om algemene commentaren op het Pull Request te maken. In <> kunnen we een voorbeeld zien van de project eigenaar die zowel een regel code becommentariëert en daarna een algemeen commentaar achterlaat in het discussie gedeelte. Je kunt zien dat de code commentaren ook in de conversatie worden gevoegd. -[[_pr_discussion]] +[[r_pr_discussion]] .Pull Request discussie pagina image::images/blink-05-general-comment.png[PR discussie pagina] @@ -195,14 +195,14 @@ Als de bijdragen dat doet zal de project eigenaar opnieuw een berichtje krijgen ze zien dat het behandelt is. En omdat een regel gewijzigd is die becommentarieerd was, merkt GitHub dit op en klapt de achterhaalde diff dicht. -[[_pr_final]] +[[r_pr_final]] .Pull Request finaal image::images/blink-06-final.png[PR finaal] Een interessant iets om op te merken is dat wanneer je de ``Files Changed'' tab klikt op deze Pull Request, je de ``unified'' diff krijgt -- daarmee wordt het geaggregeerde verschil bedoeld die geintroduceerd wordt met je hoofd branch al deze topic branch zou zijn gemerged. In `git diff` terminologie, het laat feitelijk automatisch de `git - diff master...` zien voor de branch waar deze Pull Request op is gebaseerd. Zie <<_what_is_introduced>> voor + diff master...` zien voor de branch waar deze Pull Request op is gebaseerd. Zie <> voor meer informatie over dit type diff. Het andere wat je zult zien is dat GitHub controleert of de Pull Request goed zou mergen en een knop biedt om de @@ -245,7 +245,7 @@ Dit is een belangrijk onderscheid, omdat de wijziging over het algemeen wordt vo reeks patches niet opnieuw samengesteld, maar daarentegen wordt het verschil gepushed als een nieuwe commit op de branch, waarbij de conversatie doorgaat met behoud van de context van het vorige werk. -Bijvoorbeeld, als je <<_pr_final>> erop terugslaat, zal je zien dat de bijdrager zijn commit niet heeft gerebased en +Bijvoorbeeld, als je <> erop terugslaat, zal je zien dat de bijdrager zijn commit niet heeft gerebased en een andere Pull Request heeft gestuurd. In plaats daarvan zijn er nieuwe commits toegevoegd en deze zijn naar de bestaande branch gepushed. Op deze manier kan je in de toekomst teruggaan naar deze Pull Request en alle context terugvinden waarop besluiten zijn genomen. De ``Merge'' knop indrukken op de site maakt opzettelijk een merge commit @@ -258,11 +258,11 @@ Als je Pull Request veroudert raakt of om een andere reden niet schoon merged, z onderhouder deze eenvoudig kan mergen. GitHub zal dit voor je controlere en je aan de onderkant van elke Pull Request laten weten of de merge triviaal is of niet. -[[_pr_fail]] +[[r_pr_fail]] .Pull Request zal niet netjes mergen image::images/pr-01-fail.png[PR merge faalt] -Als je zoiets als <<_pr_fail>> ziet, zal je jouw branch willen repareren zodat het groen wordt en de onderhouder geen +Als je zoiets als <> ziet, zal je jouw branch willen repareren zodat het groen wordt en de onderhouder geen extra werk heoft te doen. Je hebt twee voor de hand liggende opties om dit te doen. Je kunt je branch rebasen op waar de target branch is @@ -322,7 +322,7 @@ To https://github.com/tonychacon/blink Als je dat gedaan hebt zal de Pull Request automatisch geupdate worden en opnieuw gecontroleerd of het zuiver merged. -[[_pr_merge_fix]] +[[r_pr_merge_fix]] .Pull Request merged goed image::images/pr-02-merge-fix.png[PR gerepareerd] @@ -332,7 +332,7 @@ Een van de geweldige dingen aan Git is dat je dat constant kunt blijven doen. Al Als je perse de branch wilt rebasen om het op te schonen, kan je dat zeker doen, maar het wordt je sterk aangeraden om niet te force pushen naar de branch waar al een Pull Request op is geopend. Als andere mensen deze hebben gepulld - en er op zijn gaan doorwerken, krijg je te maken met alle problemen die zijn genoemd in <<_rebase_peril>>. In plaats + en er op zijn gaan doorwerken, krijg je te maken met alle problemen die zijn genoemd in <>. In plaats daarvan push je de rebased branch naar een nieuwe branch op GitHub en open je een gloednieuwe Pull Request waarin je aan de oude refereert, en sluit daarna het orginele request. @@ -352,15 +352,15 @@ Laten we beginnen met hoe naar een andere Pull Request of Issue te verwijzen. Al Laten we naar een voorbeeld kijken. Stel we hebben de branch in het vorige voorbeeld gerebased, een nieuwe pull request ervoor gemaakt en nu willen we verwijzen naar de oude pull request vanuit de nieuwe. We willen ook refereren naar een issue in de fork van de repository in ene heel ander project. We maken de beschrijving als in - <<_pr_references>>. + <>. -[[_pr_references]] +[[r_pr_references]] .Verwijzingen in een Pull Request. image::images/mentions-01-syntax.png[PR verwijzingen] -Als we deze pull request indienen, zien we dit alles getoond als <<_pr_references_render>>. +Als we deze pull request indienen, zien we dit alles getoond als <>. -[[_pr_references_render]] +[[r_pr_references_render]] .Verwijzingen getoond in een Pull Request. image::images/mentions-02-render.png[PR verwijzingen getoond] @@ -369,9 +369,9 @@ Merk op dat de volledige GitHub URL die we erin gezet hebben afgekort is tot all Als Tony nu het orginele Pull Request gaat sluiten, zien we dit doordat we het vermelden in de nieuwe, GitHub heeft automatisch een terugslag gebeurtenis aangemaakt in de tijdslijn van het Pull Request. Dit betekent dat iedereen die dit Pull Request bezoekt en ziet dat het is gesloten eenvoudig kan teruglinken naar degene die het overschrijft. De - link zal eruit zien als <<_pr_closed>>. + link zal eruit zien als <>. -[[_pr_closed]] +[[r_pr_closed]] .Verwijzing getoond in een Pull Request. image::images/mentions-03-closed.png[PR gesloten] @@ -388,10 +388,10 @@ In Issue en Pull Request omschrijvingen, commentaren, code commentaren en andere Flavored Markdown'' (Markdown met een GitHub smaakje) gebruiken. Markdown is als schrijven in platte tekst maar wat met meer functionaliteit wordt getoond. -Zie <<_example_markdown>> voor een voorbeeld van hoe comemntaar of tekst kan worden geschreven en daarna getoond met +Zie <> voor een voorbeeld van hoe comemntaar of tekst kan worden geschreven en daarna getoond met Markdown. -[[_example_markdown]] +[[r_example_markdown]] .Een voorbeeld van Markdown zoals geschreven en getoond. image::images/markdown-01-example.png[Voorbeeld Markdown] @@ -416,9 +416,9 @@ Je kunt op deze manier een taaklijst maken: - [ ] Document the code ---- -Als we deze in de omschrijving van een Pull Request of Issue zetten, zullen we het als <<_task_lists>> getoond zien +Als we deze in de omschrijving van een Pull Request of Issue zetten, zullen we het als <> getoond zien -[[_task_lists]] +[[r_task_lists]] .Taaklijsten zoals getoond een Markdown commentaar. image::images/markdown-02-tasks.png[voorbeel taaklijst] @@ -430,9 +430,9 @@ En er is meer: GitHub zal naar taaklijsten zoeken in je Issues en Pull Requesten tonen die ze bevatten. Bijvoorbeeld, als je een Pull Request hebt met taken en je kijkt naar de overzichtspagina van alle Pull Requesten, kan je zien in hoeverre het klaar is. Dit helpt mensen om Pull Requests in te delen naar subtaken en andere mensen om de voortgang van de branch te volgen. Je kunt een voorbeeld hiervan zien in - <<_task_list_progress>>. + <>. -[[_task_list_progress]] +[[r_task_list_progress]] .Samenvatting van taaklijsten in de Pull Request lijst. image::images/markdown-03-task-summary.png[Voorbeeld taaklijst] @@ -459,9 +459,9 @@ for(int i=0 ; i < 5 ; i++) ---- Als je de naam van de taal toevoegt, zoals we hier met 'java' gedaan hebben, zal GitHub proberen ook de syntax te - markeren. In het bovenstaande voorbeeld zou het worden getoond als <<_md_code>>. + markeren. In het bovenstaande voorbeeld zou het worden getoond als <>. -[[_md_code]] +[[r_md_code]] .Getoonde omsloten code voorbeeld. image::images/markdown-04-fenced-code.png[Getoonde omsloten code] @@ -482,9 +482,9 @@ De citaten zien er zo ongeveer uit: How big are these slings and in particular, these arrows? ---- -Zodra getoond, zal het commentaar er als <<_md_quote>> uitzien. +Zodra getoond, zal het commentaar er als <> uitzien. -[[_md_quote]] +[[r_md_quote]] .Getoond citaat voorbeeld. image::images/markdown-05-quote.png[Getoonde citaat] @@ -495,7 +495,7 @@ Als laatste, kan je ook zgn. emoji in je commentaar gebruiken. Dit wordt eigenli commentaar intypt en je begint met een `:` teken, zal een automatische voltooihulp je komen helpen met vinden wat je zoekt. -[[_md_emoji_auto]] +[[r_md_emoji_auto]] .Emoji voltooi hulp in actie. image::images/markdown-06-emoji-complete.png[Emoji voltooi hulp] @@ -512,9 +512,9 @@ I :eyes: that :bug: and I :cold_sweat:. :clap::tada::panda_face: ---- -Als het wordt getoond, komt het er als <<_md_emoji>> uit te zien. +Als het wordt getoond, komt het er als <> uit te zien. -[[_md_emoji]] +[[r_md_emoji]] .Zwaar emoji commentaar. image::images/markdown-07-emoji.png[Emoji] @@ -535,9 +535,9 @@ Technisch gezien is het geen GitHub smaak van Markdown, maar het is erg handig. plaatjes links aan commentaar, waarvan het moeilijk kan zijn om URLs voor te vinden en in te voegen, staat GitHub je toe om plaatjes te slepen en lossen (drag & drop) in tekstgebieden om de in te voegen. -[[_md_drag]] +[[r_md_drag]] .Slepen en lossen van plaatjes om ze te uploaden en automatisch in te voegen. image::images/markdown-08-drag-drop.png[Plaatjes slepen en lossen] -Als je terugkijkt naar <<_pr_references>>, kan je een kleine ``Parsed as Markdown'' hint boven het tekstgebied zien. -Als je hierop klikt zal dit je een complete spiekbrief laten zien van alles wat met met Markdown in GitHub kunt doen. \ No newline at end of file +Als je terugkijkt naar <>, kan je een kleine ``Parsed as Markdown'' hint boven het tekstgebied zien. +Als je hierop klikt zal dit je een complete spiekbrief laten zien van alles wat met met Markdown in GitHub kunt doen. diff --git a/book/06-github/sections/3-maintaining.asc b/book/06-github/sections/3-maintaining.asc index 40ca65a1..c8a8bdbb 100644 --- a/book/06-github/sections/3-maintaining.asc +++ b/book/06-github/sections/3-maintaining.asc @@ -1,4 +1,4 @@ -[[_maintaining_gh_project]] +[[r_maintaining_gh_project]] === Een project onderhouden Nu we ons op ons gemak voelen bij te dragen aan een project, laten we het eens van de andere kant bekijken: je eigen @@ -8,12 +8,12 @@ Nu we ons op ons gemak voelen bij te dragen aan een project, laten we het eens v Laten we eens een nieuwe repository aanmaken waarmee we de code van ons project delen. Begin met het klikken op de ``New repository'' knop aan de rechterkant van het dashboard, of vanaf de `+` knop in de - bovenste toolbar naast je gebruikersnaam zoals te zien is in <<_new_repo_dropdown>>. + bovenste toolbar naast je gebruikersnaam zoals te zien is in <>. .Het ``Your repositories'' gebied. image::images/newrepo.png[Het ``Your repositories'' gebied.] -[[_new_repo_dropdown]] +[[r_new_repo_dropdown]] .De ``New repository'' dropdown. image::images/new-repo.png[De ``New repository'' dropdown.] @@ -28,7 +28,7 @@ Voor nu klik je gewoon de ``Create Repository'' knop en boem - je hebt een nieuw Omdat er nog geen code is, zal GitHub je aanwijzigen geven hoe je een gloednieuwe Git repository maakt, of verbindt met een bestaand Git project. -We zullen het hier nog niet uitwerken, als je een opfrisser nodig hebt kijk dan nog eens naar <<_git_basics_chapter>>. +We zullen het hier nog niet uitwerken, als je een opfrisser nodig hebt kijk dan nog eens naar <>. Nu je project op GitHub gehost wordt, kan je het URL aan iedereen geven waarmee je je project wilt delen. Elk project op GitHub is toegankelijk via HTTP als `https://github.com//`, en via SSH als @@ -78,13 +78,13 @@ Pull Requests kunnen komen van een branch in een fork van jouw repository of ze Voor de volgende voorbeelden, laten we aannemen dat jij ``tonychacon'' bent en dat je een nieuwe Arduino code project genaamd ``fade'' gemaakt hebt. -[[_email_notifications]] +[[r_email_notifications]] ===== Email berichten Er is nu iemand die een wijziging op je code gemaakt heeft en die je een Pull Request stuurt. Je zou een email - bericht moeten krijgen die je over het nieuwe Pull Request bericht en die er ongeveer zo uitziet als <<_email_pr>>. + bericht moeten krijgen die je over het nieuwe Pull Request bericht en die er ongeveer zo uitziet als <>. -[[_email_pr]] +[[r_email_pr]] .Email bericht van een nieuwe Request. image::images/maint-01-email.png[Pull Request email bericht] @@ -93,7 +93,7 @@ Er zijn een aantal dingen te zien aan deze email. Het geeft je een kleine diffst Het geeft je ook een aantal URLs die je vanaf de commando regel kunt gebruiken. Als je de regel bekijkt waar `git pull patch-1` staat, is dit een eenvoudige manier om een remote branch te - mergen zonder een remote toe te voegen. We hebben dit kort behandeld in <<_checking_out_remotes>>. + mergen zonder een remote toe te voegen. We hebben dit kort behandeld in <>. Als je wilt, kan je een topic branch maken en ernaar switchen en dit commando aanroepen om de Pull Request wijzigingen erin te mergen. @@ -107,7 +107,7 @@ $ curl http://github.com/tonychacon/fade/pull/1.patch | git am ===== Samenwerken op basis van de Pull Request -Zoals behandeld in <<_github_flow>>, kan je nu een conversatie voeren met de persoon die de Pull Request geopend +Zoals behandeld in <>, kan je nu een conversatie voeren met de persoon die de Pull Request geopend heeft. Je kunt commentaar geven op specifieke regels code, commentaar geven op hele commits of commentaar geven over de gehele Pull Request; waarbij de GitHub smaak van Markdown overal gebruikt kan worden. @@ -124,27 +124,27 @@ Zodra de code goed genoeg is en je het wilt mergen, kan je ofwel de code lokaal Als de merge triviaal is, kan je ook gewoon de ``Merge'' knop op de GitHub site klikken. Dit zal een ``non-fast-forward'' merge uitvoeren, waardoor een merge commit wordt gemaakt zelfs als er een fast-forward merge mogelijk was. Dit houdt in dat hoe dan ook, elke keer als je de merge knop klikt een merge commit gemaakt wordt. - Zoals je kunt zien in <<_merge_button>>, geeft GitHub je al deze informatie als je de hint link klikt. + Zoals je kunt zien in <>, geeft GitHub je al deze informatie als je de hint link klikt. -[[_merge_button]] +[[r_merge_button]] .Merge knop en instructies hoe je een Pull Request handmatig merged. image::images/maint-02-merge.png[Merge knop] Als je besluit dat je het niet wilt mergen, kan je ook gewoon het Pull Request sluiten en de persoon die het geopend heeft krijgt een berichtje. -[[_pr_refs]] +[[r_pr_refs]] ===== Pull Request Refs (Pull Request referenties) Als je te maken hebt met *veel* Pull Requests en niet elke keer een aantal remotes wilt toevoegen of eenmalige pulls wilt doen, is er een aardige truuk die GitHub je toestaat te doen. Dit is een beetje een truuk voor gevorderden en - we zullen de details beter behandelen in <<_refspec>>, maar het kan behoorlijk handig zijn. + we zullen de details beter behandelen in <>, maar het kan behoorlijk handig zijn. GitHub presenteert de Pull Request branches voor een repository als een soort van pseudo-branches op de server. Standaard zal je ze niet krijgen als je cloont, maar ze zijn er wel op een verborgen manier en je kunt ze op een redelijk eenvoudige wijze benaderen. Om dit te demonstreren, zullen we een low-level (laag niveau) commando (waar vaak aan wordt gerefereerd als een - ``sanitaire voorziening'' (plumbing) commando, waar we meer over zullen lezen in <<_plumbing_porcelain>>) genaamd + ``sanitaire voorziening'' (plumbing) commando, waar we meer over zullen lezen in <>) genaamd `ls-remote` gebruiken. Dit commando wordt over het algemeen niet gebruikt in de dagelijks Git operaties maar het is handig om te laten zien welke referenties er zich op de server bevinden. @@ -264,7 +264,7 @@ Als je een Pull Request opent, is er een invoerveld bovenaan op de pagina die aa pullen en welke je het van wilt laten pullen. Als je de ``Edit'' knop rechts van dat invoerveld klikt kan je niet alleen de branches wijzigen, maar ook welke fork. -[[_pr_targets]] +[[r_pr_targets]] .Handmatig de Pull Request doelfork en -branch wijzigen. image::images/maint-04-target.png[PR doelen] @@ -315,10 +315,10 @@ De twee keuzes zijn om de berichten via ``Email'' en via ``Web'' te ontvangen en Web meldingen bestaan alleen binnen GitHub en je kunt ze alleen op GitHub controleren. Als je deze optie geselecteerd hebt in je voorkeuren en een bericht wordt voor je gemaakt, zie je een kleine blauwe stip boven je meldingen ikoon - boven in je scherm zoals getoond in <<_not_center>>. - icon at the top of your screen as seen in <<_not_center>>. + boven in je scherm zoals getoond in <>. + icon at the top of your screen as seen in <>. -[[_not_center]] +[[r_not_center]] .Notification center. image::images/maint-08-notifications-page.png[Notification center] @@ -334,7 +334,7 @@ gebruikers zullen eenvoudigweg alle email berichten uitschakelen en al hun meldi ====== Email meldingen Email meldingen zijn de andere manier waarop je berichten kunt afhandelen via GitHub. Als je deze ingeschakeld hebt, - krijg je per melding een email. We hebben hiervan voorbeelden gezien in <<_email_notification>> en <<_email_pr>>. De + krijg je per melding een email. We hebben hiervan voorbeelden gezien in <> en <>. De emails zullen ook juist geketend (threaded) worden, wat handig is als jee een zgn. threading email client gebruikt. emails will also be threaded properly, which is nice if you're using a threading email client. @@ -342,7 +342,7 @@ Er zit ook een behoorlijk aantal metadata in de headers van de emails die GitHub zijn voor het inrichten van zelfgemaakte filters en regels. Bijvoorbeeld, als we een kijkje nemen naar de daadwerkelijke email headers die aan Tony zijn gestuurd in de email in - <<_email_pr>>, zullen we hetvolgende zien in de gestuurde gegevens: + <>, zullen we hetvolgende zien in de gestuurde gegevens: [source,mbox] ---- @@ -392,10 +392,10 @@ Omdat GitHub dit bestand toont, kan je plaatjes of links er in opnemen voor het ==== CONTRIBUTING Het andere speciale bestand dat GitHub herkent is het `CONTRIBUTING` bestand. Als je een bestand genaamd - `CONTRIBUTING` met een willekeurige extentie, zal GitHub <<_contrib_file>> tonen als iemand een Pull Request gaat + `CONTRIBUTING` met een willekeurige extentie, zal GitHub <> tonen als iemand een Pull Request gaat openen. -[[_contrib_file]] +[[r_contrib_file]] .Een Pull Request openen als er een CONTRIBUTING file bestaan. image::images/maint-09-contrib.png[Contributing melding] @@ -414,7 +414,7 @@ Als je een branch anders dan ``master'' gebruikt als je standaard branch waarvan op openen of die ze standaard zien, kan je dat in de instellingen pagina van je repository wijzigen onder de ``Options'' tab. -[[_default_branch]] +[[r_default_branch]] .De default branch van een project wijzigen. image::images/maint-10-default-branch.png[Standaard branch] @@ -427,7 +427,7 @@ Als je een project wilt overdragen aan een andere gebruiker of organisatie in Gi ownership'' optie onderaan dezelfde ``Options'' tab van de instellingen pagina van je repository die je dat kan laten doen. -[[_transfer_project]] +[[r_transfer_project]] .Draag een project over aan een andere GitHub gebruiker of organisatie. image::images/maint-11-transfer.png[Overdragen] @@ -436,4 +436,4 @@ Dit is handig als je een project verlaat en iemand anders wilt het overnemen, of Niet alleen verplaatst dit de repostory met al zijn volgers en sterren naar een andere plaats, het richt ook een redirect (doorverwijzing) van jouw URL naar de nieuwe plaats. Het zal ook de clones en fetches van Git doorverwijzen, - niet alleen de web-aanvragen. \ No newline at end of file + niet alleen de web-aanvragen. diff --git a/book/06-github/sections/4-managing-organization.asc b/book/06-github/sections/4-managing-organization.asc index 7c59cf41..091afbd8 100644 --- a/book/06-github/sections/4-managing-organization.asc +++ b/book/06-github/sections/4-managing-organization.asc @@ -1,4 +1,4 @@ -[[_github_orgs]] +[[r_github_orgs]] === Een organisatie beheren (((GitHub, organisaties))) @@ -30,7 +30,7 @@ Als een eigenaar in een organisatie, als je een repository forkt, hebt je de keu onder een van de organisaties waar je een eigenaar van bent. Je ``volgt'' ook automatisch elke nieuwe repository die onder deze organisaties wordt aangemaakt. -Net als in <<_personal_avatar>>, kan je een avatar uploaden voor je organisatie om het een persoonlijk tintje te +Net als in <>, kan je een avatar uploaden voor je organisatie om het een persoonlijk tintje te geven. En ook net zoals bij persoonlijke accounts heb je een landingspagina voor de organisatie die een lijst bevat van al je repositories en die door andere mensen kunnen worden bekeken. @@ -50,17 +50,17 @@ Met teams wordt dit makkelijk, zonder de medewerkers voor elke individuele repos De Organization pagina laat je een eenvoudig dashboard van al de repositories, gebruikers en teams zien die onder deze organisatie vallen. -[[_org_page]] +[[r_org_page]] .De Organization pagina. image::images/orgs-01-page.png[] -Om je teams te beheren, kan je op de Teams kolom aan de rechterkant van de pagina in <<_org_page>> klikken. Dit leidt +Om je teams te beheren, kan je op de Teams kolom aan de rechterkant van de pagina in <> klikken. Dit leidt je naar een pagina die je kunt gebruiken om leden aan het team toe te voegen, repositories aan het team toe te voegen of de instellingen en toegangsniveaus voor het team te beheren. Elk team kan alleen lees-, lees-/schrijf- of - beheertoegang tot de repositories hebben. Je kunt dat niveau wijzigen door de ``Settings'' knop in <<_team_page>> te + beheertoegang tot de repositories hebben. Je kunt dat niveau wijzigen door de ``Settings'' knop in <> te klikken. -[[_team_page]] +[[r_team_page]] .De Team pagina. image::images/orgs-02-teams.png[] @@ -80,8 +80,8 @@ Organisaties geven eigenaren ook toegang tot alle informatie over wat binnen die 'Audit Log' tab gaan en zien welke gebeurtenissen er hebben plaatsgevonden op een organisationeel niveau, wie ze in gang heeft gezet en waar in de wereld dit gebeurde. -[[_audit_log]] +[[r_audit_log]] .De audit log. image::images/orgs-03-audit.png[] -Je kunt ook specifieke gebeurtenissen selecteren, specifieke plaatsen of specifieke mensen. \ No newline at end of file +Je kunt ook specifieke gebeurtenissen selecteren, specifieke plaatsen of specifieke mensen. diff --git a/book/06-github/sections/5-scripting.asc b/book/06-github/sections/5-scripting.asc index bdc2d28c..9dc4a98c 100644 --- a/book/06-github/sections/5-scripting.asc +++ b/book/06-github/sections/5-scripting.asc @@ -16,18 +16,18 @@ Het Hooks en Services deel van het GitHub repository beheer is de eenvoudigste m Eerst zullen we naar Services kijken. Zowel Hooks als Services integratie kunnen in het Settings gedeelte van je repository gevonden worden, waar we eerder naar gekeken hebben bij het toevoegen van medewerkers en het wijzigen van - de standaard branch van je project. Onder de ``Webhooks and Services'' tab zul je iets als <<_services_hooks>> zien. + de standaard branch van je project. Onder de ``Webhooks and Services'' tab zul je iets als <> zien. -[[_services_hooks]] +[[r_services_hooks]] .Services and Hooks configuratie deel. image::images/scripting-01-services.png[Services en hooks] Er zijn tientallen services waar je uit kunt kiezen, de meeste zijn integraties naar andere commerciele en open source systemen. De meeste daarvan zijn Continuous Integration services, bug en issue trackers, chat room systemen en documentatie systemen. We zullen je door het opzetten van een eenvoudige leiden: de email-hook. Als je ``email - kiest uit de ``Add Service'' dropdown, krijg je een configuratie scherm zoals <<_service_config>>. + kiest uit de ``Add Service'' dropdown, krijg je een configuratie scherm zoals <>. -[[_service_config]] +[[r_service_config]] .Email service configuratie. image::images/scripting-02-email-service.png[Email service] @@ -49,10 +49,10 @@ Als je iets meer specifieker nodig hebt, of je wilt een service of site integrer Hoe dit in het algemeen werkt is dat je een kleine web service kunt opzetten die naar een GitHub hook payload luistert en dan iets met de gegevens doet als het is ontvangen. -Om een hook aan te zetten, klik je de ``Add webhook'' knop in <<_services_hooks>>. Dit leidt je naar een pagina die -eruit ziet als <<_web_hook>>. +Om een hook aan te zetten, klik je de ``Add webhook'' knop in <>. Dit leidt je naar een pagina die +eruit ziet als <>. -[[_web_hook]] +[[r_web_hook]] .Web hook configuratie. image::images/scripting-03-webhook.png[Web hook] @@ -111,7 +111,7 @@ Om zoiets te kunnen ontwikkelen en testen, heb je een nette ontwikkelaarsscherm Voor elke hook kan je uitvinden wanneer het was afgeleverd, of dit succesvol was en de body en headers voor zowel de vraag en het antwoord. Dit maakt het ongelovelijk eenvoudig om je hooks te testen en te debuggen. -[[_web_hook_debug]] +[[r_web_hook_debug]] .Web hook debug informatie. image::images/scripting-04-webhook-debug.png[Webhook debug] @@ -191,7 +191,7 @@ Er zijn verschillende manieren om je te authenticeren. Je kunt eenvoudige authen (access token) te gebruiken. Deze kan je genereren vanaf de ``Applications'' tab van je instellingen pagina. -[[_access_token]] +[[r_access_token]] .Genereer je access token vanaf de ``Applications'' tab op je instellingen pagina. image::images/scripting-05-access-token.png[Access Token] @@ -233,9 +233,9 @@ $ curl -H "Content-Type: application/json" \ } ---- -Als je nu naar dat issue gaat, kan je de reactie zien dat we zojuist succesvol gepost hebben in <<_api_comment>>. +Als je nu naar dat issue gaat, kan je de reactie zien dat we zojuist succesvol gepost hebben in <>. -[[_api_comment]] +[[r_api_comment]] .Een commentaar gepost via de GitHub API. image::images/scripting-06-comment.png[Reactie via API] @@ -310,9 +310,9 @@ In dit geval kan je een status ('success', 'failure', 'error') sturen, een omsch ook een status aangeven -- het ``context'' veld maakt hierin het onderscheid. Als iemand een nieuwe Pull Request op GitHub opent en deze hook is opgezet, kan je misschien iets zoals -<<_commit_status>> zien. +<> zien. -[[_commit_status]] +[[r_commit_status]] .Commit status via de API. image::images/scripting-07-status.png[Commit status] diff --git a/book/07-git-tools/images/double-dot.png b/book/07-git-tools/images/double-dot.png deleted file mode 100644 index a95ba68a..00000000 Binary files a/book/07-git-tools/images/double-dot.png and /dev/null differ diff --git a/book/07-git-tools/images/replace1.png b/book/07-git-tools/images/replace1.png deleted file mode 100644 index 100610c5..00000000 Binary files a/book/07-git-tools/images/replace1.png and /dev/null differ diff --git a/book/07-git-tools/images/replace2.png b/book/07-git-tools/images/replace2.png deleted file mode 100644 index 58fb531d..00000000 Binary files a/book/07-git-tools/images/replace2.png and /dev/null differ diff --git a/book/07-git-tools/images/replace3.png b/book/07-git-tools/images/replace3.png deleted file mode 100644 index 3fafe80a..00000000 Binary files a/book/07-git-tools/images/replace3.png and /dev/null differ diff --git a/book/07-git-tools/images/replace4.png b/book/07-git-tools/images/replace4.png deleted file mode 100644 index 021319ef..00000000 Binary files a/book/07-git-tools/images/replace4.png and /dev/null differ diff --git a/book/07-git-tools/images/replace5.png b/book/07-git-tools/images/replace5.png deleted file mode 100644 index 74b8523e..00000000 Binary files a/book/07-git-tools/images/replace5.png and /dev/null differ diff --git a/book/07-git-tools/images/rerere1.png b/book/07-git-tools/images/rerere1.png deleted file mode 100644 index 06bcef32..00000000 Binary files a/book/07-git-tools/images/rerere1.png and /dev/null differ diff --git a/book/07-git-tools/images/rerere2.png b/book/07-git-tools/images/rerere2.png deleted file mode 100644 index 36021e32..00000000 Binary files a/book/07-git-tools/images/rerere2.png and /dev/null differ diff --git a/book/07-git-tools/images/rerere3.png b/book/07-git-tools/images/rerere3.png deleted file mode 100644 index 83e29b75..00000000 Binary files a/book/07-git-tools/images/rerere3.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-checkout.png b/book/07-git-tools/images/reset-checkout.png deleted file mode 100644 index 69b2f892..00000000 Binary files a/book/07-git-tools/images/reset-checkout.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-ex1.png b/book/07-git-tools/images/reset-ex1.png deleted file mode 100644 index b1adbfe9..00000000 Binary files a/book/07-git-tools/images/reset-ex1.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-ex2.png b/book/07-git-tools/images/reset-ex2.png deleted file mode 100644 index 6cac4be0..00000000 Binary files a/book/07-git-tools/images/reset-ex2.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-ex3.png b/book/07-git-tools/images/reset-ex3.png deleted file mode 100644 index e29b78c4..00000000 Binary files a/book/07-git-tools/images/reset-ex3.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-ex4.png b/book/07-git-tools/images/reset-ex4.png deleted file mode 100644 index 0fb210a9..00000000 Binary files a/book/07-git-tools/images/reset-ex4.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-ex5.png b/book/07-git-tools/images/reset-ex5.png deleted file mode 100644 index 11b00201..00000000 Binary files a/book/07-git-tools/images/reset-ex5.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-ex6.png b/book/07-git-tools/images/reset-ex6.png deleted file mode 100644 index 091285ee..00000000 Binary files a/book/07-git-tools/images/reset-ex6.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-hard.png b/book/07-git-tools/images/reset-hard.png deleted file mode 100644 index f2f8e003..00000000 Binary files a/book/07-git-tools/images/reset-hard.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-mixed.png b/book/07-git-tools/images/reset-mixed.png deleted file mode 100644 index d6ae60ab..00000000 Binary files a/book/07-git-tools/images/reset-mixed.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-path1.png b/book/07-git-tools/images/reset-path1.png deleted file mode 100644 index 0036c409..00000000 Binary files a/book/07-git-tools/images/reset-path1.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-path2.png b/book/07-git-tools/images/reset-path2.png deleted file mode 100644 index ca117fb7..00000000 Binary files a/book/07-git-tools/images/reset-path2.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-path3.png b/book/07-git-tools/images/reset-path3.png deleted file mode 100644 index a6cb5d43..00000000 Binary files a/book/07-git-tools/images/reset-path3.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-soft.png b/book/07-git-tools/images/reset-soft.png deleted file mode 100644 index aab1fe6b..00000000 Binary files a/book/07-git-tools/images/reset-soft.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-squash-r1.png b/book/07-git-tools/images/reset-squash-r1.png deleted file mode 100644 index 7bd260ad..00000000 Binary files a/book/07-git-tools/images/reset-squash-r1.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-squash-r2.png b/book/07-git-tools/images/reset-squash-r2.png deleted file mode 100644 index 46f9ea4e..00000000 Binary files a/book/07-git-tools/images/reset-squash-r2.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-squash-r3.png b/book/07-git-tools/images/reset-squash-r3.png deleted file mode 100644 index 23f82730..00000000 Binary files a/book/07-git-tools/images/reset-squash-r3.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-start.png b/book/07-git-tools/images/reset-start.png deleted file mode 100644 index bbfa8eab..00000000 Binary files a/book/07-git-tools/images/reset-start.png and /dev/null differ diff --git a/book/07-git-tools/images/reset-workflow.png b/book/07-git-tools/images/reset-workflow.png deleted file mode 100644 index 43bd27f3..00000000 Binary files a/book/07-git-tools/images/reset-workflow.png and /dev/null differ diff --git a/book/07-git-tools/images/undomerge-reset.png b/book/07-git-tools/images/undomerge-reset.png deleted file mode 100644 index 99bd7f79..00000000 Binary files a/book/07-git-tools/images/undomerge-reset.png and /dev/null differ diff --git a/book/07-git-tools/images/undomerge-revert.png b/book/07-git-tools/images/undomerge-revert.png deleted file mode 100644 index 1f32a63e..00000000 Binary files a/book/07-git-tools/images/undomerge-revert.png and /dev/null differ diff --git a/book/07-git-tools/images/undomerge-revert2.png b/book/07-git-tools/images/undomerge-revert2.png deleted file mode 100644 index af9e5887..00000000 Binary files a/book/07-git-tools/images/undomerge-revert2.png and /dev/null differ diff --git a/book/07-git-tools/images/undomerge-revert3.png b/book/07-git-tools/images/undomerge-revert3.png deleted file mode 100644 index c1e8e8ba..00000000 Binary files a/book/07-git-tools/images/undomerge-revert3.png and /dev/null differ diff --git a/book/07-git-tools/images/undomerge-start.png b/book/07-git-tools/images/undomerge-start.png deleted file mode 100644 index 5891cbed..00000000 Binary files a/book/07-git-tools/images/undomerge-start.png and /dev/null differ diff --git a/book/07-git-tools/sections/advanced-merging.asc b/book/07-git-tools/sections/advanced-merging.asc index 5ad20ca4..6e21245f 100644 --- a/book/07-git-tools/sections/advanced-merging.asc +++ b/book/07-git-tools/sections/advanced-merging.asc @@ -1,4 +1,4 @@ -[[_advanced_merging]] +[[r_advanced_merging]] === Mergen voor gevorderden Mergen met Git is normaalgesproken redelijk eenvoudig. Omdat Git het je gemakkelijk maakt om meerdere malen de ene @@ -19,7 +19,7 @@ In dit hoofdstuk zullen we een aantal van die situaties kunnen zijn en welke ins ==== Merge conflicten -We hebben een aantal beginselen van het oplossen van merge conflicten in <<_basic_merge_conflicts>> behandeld, voor +We hebben een aantal beginselen van het oplossen van merge conflicten in <> behandeld, voor meer complexe conflicten geeft Git je een aantal instrumenten om uit te vinden wat er aan de hand is en hoe beter met het conflict om te gaan. @@ -113,7 +113,7 @@ CONFLICT (content): Merge conflict in hello.rb Automatic merge failed; fix conflicts and then commit the result. ---- -[[_abort_merge]] +[[r_abort_merge]] ===== Een merge afbreken We kunnen nu kiezen. Als eerste, laten we bekijken hoe we uit deze situatie kunnen komen. Als je geen conflicten had @@ -168,7 +168,7 @@ Omdat in dit geval de eigenlijke bestandswijzigingen niet conflicteren, zal het Dit bespaart je veel werk als je iemand in je team hebt die regelmatig graag alles herformateert van spaties naar tabs of omgekeerd. -[[_manual_remerge]] +[[r_manual_remerge]] ===== Handmatig bestanden opnieuw mergen Hoewel Git het voorbewerken van witruimtes redelijk goed doet, zijn er andere soorten van wijzigingen waar Git @@ -327,7 +327,7 @@ Removing hello.ours.rb Removing hello.theirs.rb ---- -[[_checking_out_conflicts]] +[[r_checking_out_conflicts]] ===== Conflicten beter bekijken Misschien zijn we om de een of andere reden niet tevreden met de huidige oplossing, of misschien werkt het handmatig @@ -432,7 +432,7 @@ Dit is in het bijzonder handig voor conflicten tussen binaire bestanden waar je alleen bepaalde bestanden wilt mergen van een andere branch - je kunt de merge uitvoeren en dan bepaalde bestanden bekijken dan een of de andere kant voordat je commit. -[[_merge_log]] +[[r_merge_log]] ===== Merge log Een ander nuttig instrument bij het oplossen van merge conflicten is `git log`. Dit kan je helpen bij het verkrijgen @@ -440,7 +440,7 @@ Een ander nuttig instrument bij het oplossen van merge conflicten is `git log`. waarom twee ontwikkelingen dezelfde gebieden raakten kan soms erg behulpzaam zijn. Om een complete lijst te krijgen van alle unieke commits die in elk van beide branches zitten en die betrokken zijn - bij deze merge, kunnen we de ``drievoudige punt'' syntax gebruiken die we geleerd hebben in <<_triple_dot>>. + bij deze merge, kunnen we de ``drievoudige punt'' syntax gebruiken die we geleerd hebben in <>. [source,console] ---- @@ -568,7 +568,7 @@ index 0399cd5,59727f0..e1d0799 hello() ---- -[[_undoing_merges]] +[[r_undoing_merges]] ==== Merges ongedaan maken Nu je weet hoe merge commits te maken, zal je waarschijnlijk er een aantal perongeluk maken. @@ -594,7 +594,7 @@ In de meeste gevallen, als je de foutieve `git merge` opvolgt met `git reset --h .Historie na `git reset --hard HEAD~` image::images/undomerge-reset.png[Historie na `git reset --hard HEAD~`.] -We hebben `reset` in <<_git_reset>> behandeld, dus het zou niet al te moeilijk uit te vinden wat hier gebeurt. +We hebben `reset` in <> behandeld, dus het zou niet al te moeilijk uit te vinden wat hier gebeurt. Hier is een snelle opfrisser: `reset --hard` volgt normaalgesproken de volgende drie stappen: . Verplaats de branch waar HEAD naar wijst @@ -603,12 +603,12 @@ Hier is een snelle opfrisser: `reset --hard` volgt normaalgesproken de volgende . Laat de werk directory eruit zien als de index. Het nadeel van deze aanpak is dat het de historie herschrijft, wat problematisch kan zijn met een gedeelde repository. -Bestudeer <<_rebase_peril>> om te zien wat er dan gebeuren kan; in het kort houd het in dat als andere mensen de +Bestudeer <> om te zien wat er dan gebeuren kan; in het kort houd het in dat als andere mensen de commits hebben die jij aan het herschrijven bent, je `reset` eigenlijk wilt vermijden. Deze aanpak zal ook niet werken als er andere commits gemaakt zijn sinds de merge; het verplaatsen van de referenties doet deze wijzigingen ook teniet. -[[_reverse_commit]] +[[r_reverse_commit]] ===== De commit terugdraaien Als het verplaatsen van de branch verwijzingen niet gaat werken voor je, geeft Git je de optie van het maken van een diff --git a/book/07-git-tools/sections/bundling.asc b/book/07-git-tools/sections/bundling.asc index e74fe6d6..2504d1c9 100644 --- a/book/07-git-tools/sections/bundling.asc +++ b/book/07-git-tools/sections/bundling.asc @@ -1,4 +1,4 @@ -[[_bundling]] +[[r_bundling]] === Bundelen Alhoewel we de reguliere manieren om Git data over een netwerk te transporteren al behandeld hebben (HTTP, SSH, etc), @@ -86,7 +86,7 @@ Eerst moeten we de reeks van commits vaststellen die we in de bundel willen stop handmatig uitvinden. Je kunt natuurlijk hier hetzelfde doen en de gehele repository bundelen, en dat zou werken, maar het is beter om alleen het verschil te bundelen - alleen de drie commits die we zojuist lokaal gemaakt hebben. -Om dat te doen, moet je het verschil berekenen. Zoals we hebben beschreven in <<_commit_ranges>>, kan je op +Om dat te doen, moet je het verschil berekenen. Zoals we hebben beschreven in <>, kan je op verschillende manieren een reeks van commits aangeven. Om de drie commits te krijgen die we in onze master branch hebben die niet in de originele gecloonde branch zaten, kunnen we zoiets als `origin/master..master` of `master ^origin/master` gebruiken. Je kunt dat verifiëren met het `log` commando. diff --git a/book/07-git-tools/sections/credentials.asc b/book/07-git-tools/sections/credentials.asc index 82635324..922d5fc1 100644 --- a/book/07-git-tools/sections/credentials.asc +++ b/book/07-git-tools/sections/credentials.asc @@ -1,4 +1,4 @@ -[[_credential_caching]] +[[r_credential_caching]] === Het opslaan van inloggegevens (((credentials))) @@ -231,4 +231,4 @@ $ git config --global credential.helper read-only --file /mnt/shared/creds ---- Zoals je kunt zien, is het uitbreiden van dit systeem redelijk eenvoudig, en we kunnen een aantal gebruikelijke -problemen voor jou en je team oplossen. \ No newline at end of file +problemen voor jou en je team oplossen. diff --git a/book/07-git-tools/sections/debugging.asc b/book/07-git-tools/sections/debugging.asc index 2816f702..6af91924 100644 --- a/book/07-git-tools/sections/debugging.asc +++ b/book/07-git-tools/sections/debugging.asc @@ -4,7 +4,7 @@ Git levert ook een aantal instrumenten om je te helpen met het debuggen van prob Omdat Git is ontworpen om te werken met bijna alle soorten projecten, zijn deze instrumenten redelijk generiek, maar ze kunnen je vaak helpen om een fout op te sporen of een schuldige aan te wijzen als dingen fout gaan. -[[_file_annotation]] +[[r_file_annotation]] ==== Bestands annotatie Als je op zoek bent naar een bug in je code en je wilt weten wanneer deze er in is geslopen en waarom, is bestands @@ -74,7 +74,7 @@ Normaalgesproken krijg je als de oorspronkelijke commit, de commit waar je de co dat de eerste keer is dat je deze regels in dit bestand hebt aangeraakt. Git geeft je de oorspronkelijke commit waarin je deze regels hebt geschreven, zelfs als dat in een ander bestand was. -[[_binary_search]] +[[r_binary_search]] ==== Binair zoeken Een bestand annoteren helpt je als je meteen al weet waar het probleem is. @@ -170,4 +170,4 @@ $ git bisect run test-error.sh Door dit te doen zal `test-error.sh` automatisch aanroepen voor elke uitgecheckte commit totdat Git de eerste kapotte commit vindt. Je kunt ook zoiets als `make` of `make tests` aanroepen of wat je ook maar hebt dat geautomatiseerde tests voor je - uitvoert. \ No newline at end of file + uitvoert. diff --git a/book/07-git-tools/sections/interactive-staging.asc b/book/07-git-tools/sections/interactive-staging.asc index eafdfd81..42ce6af9 100644 --- a/book/07-git-tools/sections/interactive-staging.asc +++ b/book/07-git-tools/sections/interactive-staging.asc @@ -1,4 +1,4 @@ -[[_interactive_staging]] +[[r_interactive_staging]] === Interactief stagen Git wordt geleverd met een aantal scripts die enkele command-line taken eenvoudiger maken. @@ -218,4 +218,4 @@ Je hoeft overigens niet in de interactieve toevoeg modues te zijn om het stagen Bovendien kan je de patch modus gebruiken om bestanden deels te resetten met het `reset --patch` commando, om delen van bestanden out te checken met het `checkout --patch` commando en om delen van bestanden te stashen met het `stash save --patch` commando. We zullen meer details geven van elk van deze als we de meer gevorderde toepassingen van - deze commando's gaan behandelen. \ No newline at end of file + deze commando's gaan behandelen. diff --git a/book/07-git-tools/sections/replace.asc b/book/07-git-tools/sections/replace.asc index 7ed3f090..81289caa 100644 --- a/book/07-git-tools/sections/replace.asc +++ b/book/07-git-tools/sections/replace.asc @@ -1,4 +1,4 @@ -[[_replace]] +[[r_replace]] === Vervangen Git objecten kunnen niet worden gewijzigd, maar Git heeft een interessante manier om te doen alsof objecten in haar @@ -104,7 +104,7 @@ Het `commit-tree` commando is een uit de reeks van commando's die gewoonlijk 'bi worden genoemd. Dit zijn commando's die niet direct voor normaal gebruik bedoeld zijn, maar die in plaats daarvan door **andere** Git commando's worden gebruikt om kleinere taken uit te voeren. Bij tijd en wijle, als we wat vreemdere zaken als dit uitvoeren, stellen ze ons in staat om echt 'lage' dingen uit te voeren maar ze zijn niet - bedoeld voor dagelijks gebruik. Je kunt meer over deze plumbing commando's lezen in <<_plumbing_porcelain>>. + bedoeld voor dagelijks gebruik. Je kunt meer over deze plumbing commando's lezen in <>. ===== image::images/replace3.png[] @@ -225,4 +225,4 @@ c6e1e95051d41771a649f3145423f8809d1a74d4 commit refs/replace/81a708dd0e167a3f691 Dit houdt in dat het eenvoudig is om onze vervanging met anderen te delen, omdat we deze naar onze server kunnen pushen en andere mensen het eenvoudig kunnen downloaden. Dit is niet zo nuttig in het scenario van historie-enten welke we hier nu behandeld hebben (omdat iedereen beide histories nu zou gaan downloaden, waarom zouden we ze dan - gaan splitsen) maar het kan handig zijn in andere omstandigheden. \ No newline at end of file + gaan splitsen) maar het kan handig zijn in andere omstandigheden. diff --git a/book/07-git-tools/sections/rerere.asc b/book/07-git-tools/sections/rerere.asc index 832196a6..48b403cf 100644 --- a/book/07-git-tools/sections/rerere.asc +++ b/book/07-git-tools/sections/rerere.asc @@ -1,4 +1,4 @@ -[[_rerere]] +[[r_rerere]] === Rerere De functionaliteit van `git rerere` is een beetje onbekend. De naam staat voor ``reuse recorded resolution'' @@ -158,7 +158,7 @@ Je kunt zien aan de boodschap "Recorded resolution for FILE" zien dat het de res image::images/rerere2.png[] Laten we nu die merge eens ongedaan maken, en in plaats daarvan deze op onze master branch gaan rebasen. We kunnen - onze branch terugzetten door `reset` te gebruiken zoals we zagen in <<_git_reset>>. + onze branch terugzetten door `reset` te gebruiken zoals we zagen in <>. [source,console] ---- @@ -237,7 +237,7 @@ def hello end ---- -We zagen hier eerder een voorbeeld van in <<_advanced_merging>>. +We zagen hier eerder een voorbeeld van in <>. Voor nu echter, laten we het opnieuw oplossen door eenvoudigweg weer `rerere` aan te roepen: [source,console] @@ -263,4 +263,4 @@ Applying: i18n one word ---- Dus, als je vaak opnieuw merged, of je wilt een topic branch up-to-date houden met je master branch zonder talloze - merges, of als je vaak rebased, kan je `rerere` aanzetten om je leven wat aangenamer te maken. \ No newline at end of file + merges, of als je vaak rebased, kan je `rerere` aanzetten om je leven wat aangenamer te maken. diff --git a/book/07-git-tools/sections/reset.asc b/book/07-git-tools/sections/reset.asc index 0a8d254b..1533ec5c 100644 --- a/book/07-git-tools/sections/reset.asc +++ b/book/07-git-tools/sections/reset.asc @@ -1,4 +1,4 @@ -[[_git_reset]] +[[r_git_reset]] === Reset ontrafeld Voordat we doorgaan naar de meer gespecialiseerde instrumenten, laten we eerst `reset` en `checkout` bespreken. @@ -53,7 +53,7 @@ De `cat-file` en `ls-tree` commando's zijn `binnenwerk` (plumbing) commando's di functies en niet echt gebruikt worden in dagelijkse toepassingen, maar ze helpen ons om te zien wat er eigenlijk gebeurt. -[[_the_index]] +[[r_the_index]] ===== De index De index is je *voorstel voor de volgende commit*. We hebben hieraan ook gerefereerd als de `staging area` van Git, @@ -183,7 +183,7 @@ Als je `git commit` aanroept, maakt Git een nieuwe commit en verplaatst de branc Als je naar `HEAD~` (de ouder van HEAD) terug `reset`, verplaats je de branch terug naar waar het was, zonder de Index of werk directory te wijzigen. Je kunt de Index nu bijwerken en `git commit` nogmaals aanroepen om te bereiken wat `git commit --amend` gedaan zou - hebben (zie <<_git_amend>>). + hebben (zie <>). ===== Stap 2: De Index bijwerken (--mixed) @@ -255,7 +255,7 @@ image::images/reset-path2.png[] Dit is de reden waarom de uitvoer van het `git status` commando je aanraadt om dit aan te roepen om een bestand te unstagen. -(Zie <<_unstaging>> voor meer hierover.) +(Zie <> voor meer hierover.) We hadden net zo makkelijk Git niet laten aannemen dat we ``haal de data van HEAD'' door een specifieke commit op te geven om die versie van het bestand vandaan te halen. @@ -281,7 +281,7 @@ Laten we nu kijken hoe we iets interessants kunnen doen met deze vers ontdekte k Stel dat je een reeks van commits met berichten als ``oops.'', ``WIP'' en ``dit bestand vergeten''. Je kunt `reset` gebruiken om deze snel en makkelijk in een enkele commit te samenpersen waardoor je ontzettend slim zult lijken. -(<<_squashing>> laat je een andere manier zien om dit te doen, maar in dit voorbeeld is het makkelijker om `reset` te +(<> laat je een andere manier zien om dit te doen, maar in dit voorbeeld is het makkelijker om `reset` te gebruiken.) Stel dat je een project hebt waar de eerste commit een bestand heeft, de tweede commit een nieuw bestan toevoegde en diff --git a/book/07-git-tools/sections/revision-selection.asc b/book/07-git-tools/sections/revision-selection.asc index a4a51566..4fdcf4cc 100644 --- a/book/07-git-tools/sections/revision-selection.asc +++ b/book/07-git-tools/sections/revision-selection.asc @@ -1,4 +1,4 @@ -[[_revision_selection]] +[[r_revision_selection]] === Revisie Selectie Git laat je op verschillende manieren specifieke commits of een reeks van commits aangeven. @@ -96,7 +96,7 @@ Er is een grotere kans dat elk lid van je programmeerteam wordt aangevallen en g gebeurtenissen op dezelfde avond. ==== -[[_branch_references]] +[[r_branch_references]] ==== Branch referenties De meest directe manier om een commit aan te duiden vereist dat je een branch referentie ernaar hebt wijzen. @@ -112,7 +112,7 @@ $ git show topic1 Als je wilt zien anar welke specifieke SHA-1 een branch wijst, of als je wilt zien waar elk van deze voorbeelden op neerkomt in termen van SHA-1s, kan je het Git binnenwerk instrument (plumbing tool) geheten `rev-parse` gebruiken. -Je kunt <<_git_internals>> bekijken voor meer informatie over plumbing tools; het komt erop neer dat `rev-parse` er +Je kunt <> bekijken voor meer informatie over plumbing tools; het komt erop neer dat `rev-parse` er is voor onder-water operaties en dat het niet bedoeld is voor het dagelijks gebruik. Dit gezegd hebbende, het kan soms handig zijn als het nodig is om te zien wat er echt gebeurt. Hier kan je `rev-parse` op je branch laten lopen. @@ -123,7 +123,7 @@ $ git rev-parse topic1 ca82a6dff817ec66f44342007202690a93763949 ---- -[[_git_reflog]] +[[r_git_reflog]] ==== RefLog verkorte namen Een van de dingen die Git op de achtergrond doet als je aan het werk bent is een ``reflog'' bijhouden - een logboek @@ -284,7 +284,7 @@ Date: Fri Nov 7 13:47:59 2008 -0500 Je kunt deze syntaxen ook combineren; je kunt de tweede ouder van de vorige referentie krijgen (aangenomen dat het een merge commit was) door `HEAD~3^2` te gebruiken, en zo voort. -[[_commit_ranges]] +[[r_commit_ranges]] ==== Commit reeksen Nu dat je individuele commits kunt aanwijzen, laten we eens kijken hoe je een reeks van commits kunt aanduiden. @@ -296,9 +296,9 @@ Dit is in het bijzonder nuttig voor het beheren van je branches, als je veel bra De meest gebruikte reeks specificatie is de tweevoudige punt (double-dot) syntax. Dit vraagt Git gewoon om een reeks commits op te halen die bereikbaar zijn van de ene commit maar niet vanaf een andere. -Bijvoorbeeld, stel dat je een commit historie hebt die eruit ziet als <>. +Bijvoorbeeld, stel dat je een commit historie hebt die eruit ziet als <>. -[[double_dot]] +[[rdouble_dot]] .Voorbeeld historie voor reeks selectie. image::images/double-dot.png[Voorbeeld historie voor reeks selectie.] @@ -365,12 +365,12 @@ $ git log refA refB --not refC Dit vormt een hele krachtige revisie uitvraag systeem die je kan helpen om uit te vinden wat er in je branches zit. -[[_triple_dot]] +[[r_triple_dot]] ===== Drievoudige punt De laatste belangrijke reeks-selectie syntax is de drievoudige punt (triple dot) syntax, welke alle commits aanduidt die door een van beide referenties bereikbaar is maar niet door beide. -Kijk even terug naar het voorbeeld van commit historie in <>. +Kijk even terug naar het voorbeeld van commit historie in <>. Als je wilt zien wat in `master` of `experiment` zit maar geen gedeelde referenties kan je dit laten lopen [source,console] @@ -398,4 +398,4 @@ $ git log --left-right master...experiment > C ---- -Met deze instrumenten kan je eenvoudiger Git laten weten welke commit of commits je wilt onderzoeken. \ No newline at end of file +Met deze instrumenten kan je eenvoudiger Git laten weten welke commit of commits je wilt onderzoeken. diff --git a/book/07-git-tools/sections/rewriting-history.asc b/book/07-git-tools/sections/rewriting-history.asc index 3b8acb68..18d8adec 100644 --- a/book/07-git-tools/sections/rewriting-history.asc +++ b/book/07-git-tools/sections/rewriting-history.asc @@ -1,4 +1,4 @@ -[[_rewriting_history]] +[[r_rewriting_history]] === Geschiedenis herschrijven Vaak zal je, als je met Git werkt, je commit geschiedenis om een of andere reden willen aanpassen. @@ -13,7 +13,7 @@ Dit kan bijvoorbeeld de volgorde van de commits betreffen, berichten of bestande In deze paragraaf zal je leren hoe je deze handige taken uitvoert, zodat je jouw commit geschiedenis er uit kunt laten zien zoals jij dat wilt, voordat je het met anderen deelt. -[[_git_amend]] +[[r_git_amend]] ==== De laatste commit veranderen De laatste commit veranderen is waarschijnlijk de meest voorkomende geschiedenis wijziging die je zult doen. @@ -41,7 +41,7 @@ Je staged de wijzigingen die je wilt door een bestand te wijzigen en `git add` e Je moet wel oppassen met deze techniek, omdat het amenden de SHA-1 van de commit wijzigt. Het is vergelijkbaar met een hele kleine rebase: niet je laatste commit wijzigen als je deze al gepusht hebt. -[[_changing_multiple]] +[[r_changing_multiple]] ==== Meerdere commit berichten wijzigen Om een commit te wijzigen die verder terug in je geschiedenis ligt, moet je meer complexe instrumenten gebruiken. @@ -189,7 +189,7 @@ Als je dan opslaat en de editor sluit, zal Git je branch terugzetten naar de oud en dan `f7f3f6d` toepassen, en dan stoppen. Feitelijk verander je de volgorde van die commits en verwijder je de `added cat-file` commit volledig. -[[_squashing]] +[[r_squashing]] ==== Een commit samenpersen (squashing) Het is ook mogelijk een serie commits te pakken en ze in één enkele commit samen te persen (squash) met de @@ -308,7 +308,7 @@ Dit commando heet `filter-branch` en het kan grote gedeelten van je geschiedenis Echter het kan heel handig zijn. Je zult een paar veel gebruikte toepassingen zien zodat je een idee krijgt waar het toe in staat is. -[[_removing_file_every_commit]] +[[r_removing_file_every_commit]] ===== Een bestand uit iedere commit verwijderen Dit gebeurt nog wel eens. @@ -375,4 +375,4 @@ $ git filter-branch --commit-filter ' Dit gaat alle commits door en herschrijft ze zodat deze jouw nieuwe adres bevatten. Om dat commits de SHA-1 waarde van hun ouders bevatten, zal dit commando iedere commit SHA in jouw geschiedenis - veranderen, niet alleen diegene die het gezochte e-mailadres bevatten. \ No newline at end of file + veranderen, niet alleen diegene die het gezochte e-mailadres bevatten. diff --git a/book/07-git-tools/sections/searching.asc b/book/07-git-tools/sections/searching.asc index 06d2f756..99f1db18 100644 --- a/book/07-git-tools/sections/searching.asc +++ b/book/07-git-tools/sections/searching.asc @@ -1,4 +1,4 @@ -[[_searching]] +[[r_searching]] === Zoeken Met zo ongeveer elke formaat codebase, zal je vaak de behoeft hebben om uit te zoeken waar een functie wordt @@ -6,7 +6,7 @@ Met zo ongeveer elke formaat codebase, zal je vaak de behoeft hebben om uit te z snel en eenvoudig door de code en commits die in de database staan te zoeken. We zullen er hier een aantal behandelen. -[[_git_grep]] +[[r_git_grep]] ==== Git Grep Git wordt geleverd met een commando genaamd `grep` wat je in staat stelt om eenvoudig door elke gecommitte @@ -171,4 +171,4 @@ diff --git a/zlib.c b/zlib.c Als Git niet kan uitvinden hoe een functie of methode in jouw programmeertaal kan worden gevonden, kan je het ook een regex meegeven. Bijvoorbeeld, dit zou tot hetzelfde resultaat geleid hebben: `git log -L '/unsigned long git_deflate_bound/',/^}/:zlib.c`. Je kunt het ook een aantal regels als grens meegeven - of een enkele regelnummer en je zult een vergelijkbare uitvoer krijgen. \ No newline at end of file + of een enkele regelnummer en je zult een vergelijkbare uitvoer krijgen. diff --git a/book/07-git-tools/sections/signing.asc b/book/07-git-tools/sections/signing.asc index 90f4cb62..c1cb9a31 100644 --- a/book/07-git-tools/sections/signing.asc +++ b/book/07-git-tools/sections/signing.asc @@ -1,4 +1,4 @@ -[[_signing]] +[[r_signing]] === Je werk tekenen Git is cryptografisch veilig, maar beschermt je niet tegen dommigheden. Als je werk overneemt van anderen op @@ -112,7 +112,7 @@ gpg: Can't check signature: public key not found error: could not verify the tag 'v1.4.2.1' ---- -[[_signing_commits]] +[[r_signing_commits]] ==== Commits tekenen In meer recente versie van Git (v1.7.9 en later), kan je ook individuele commits tekenen. @@ -210,4 +210,4 @@ Merge made by the 'recursive' strategy. Tags en commits tekenen is geweldig, maar als je besluit dit te gaan gebruiken in je reguliere workflow, moet je er zeker van zijn dat iedereen in je team begrijpt hoe dit te doen. Als je dat niet doet, ga je erg veel tijd kwijt zijn met het uitleggen aan mensen hoe ze hun commits moeten vervangen met getekende versies. Zorg ervoor dat je GPG - begrijpt en het voordeel van getekende dingen voordat je dit gaat gebruiken als onderdeel van je reguliere workflow. \ No newline at end of file + begrijpt en het voordeel van getekende dingen voordat je dit gaat gebruiken als onderdeel van je reguliere workflow. diff --git a/book/07-git-tools/sections/stashing-cleaning.asc b/book/07-git-tools/sections/stashing-cleaning.asc index 3dedd861..f414b09d 100644 --- a/book/07-git-tools/sections/stashing-cleaning.asc +++ b/book/07-git-tools/sections/stashing-cleaning.asc @@ -1,4 +1,4 @@ -[[_git_stashing]] +[[r_git_stashing]] === Stashen en opschonen Vaak, als je aan het werk bent geweest aan een deel van je project, zaken in een rommelige staat en wil je naar @@ -229,7 +229,7 @@ Dropped refs/stash@{0} (f0dfc4d5dc332d1cee34a634182e168c4efc3359) Dit is een mooie manier om gestashde werk eenvoudig terug te halen en eraan te werken in een nieuwe branch. -[[_git_clean]] +[[r_git_clean]] ==== Je werk directory opschonen Als laatste wil je misschien bepaald werk of sommige bestanden in je werk directory stashen, maar dit simpelweg @@ -298,4 +298,4 @@ Would remove the following items: What now> ---- -Op deze manier kan je alle bestanden een voor een afgaan of bepaalde patronen voor verwijdering aangeven. \ No newline at end of file +Op deze manier kan je alle bestanden een voor een afgaan of bepaalde patronen voor verwijdering aangeven. diff --git a/book/07-git-tools/sections/submodules.asc b/book/07-git-tools/sections/submodules.asc index 9147d858..29a37a2c 100644 --- a/book/07-git-tools/sections/submodules.asc +++ b/book/07-git-tools/sections/submodules.asc @@ -1,4 +1,4 @@ -[[_git_submodules]] +[[r_git_submodules]] === Submodules Het gebeurt vaak dat terwijl je aan het werk bent op het ene project, je van daar uit een ander project moet gebruiken. @@ -22,7 +22,7 @@ Git adresseert dit probleem met behulp van submodules. Submodules staan je toe om een Git repository als een subdirectory van een andere Git repository op te slaan. Dit stelt je in staat om een andere repository in je eigen project te clonen en je commits apart te houden. -[[_starting_submodules]] +[[r_starting_submodules]] ==== Beginnen met submodules We zullen een voorbeeld nemen van het ontwikkelen van een eenvoudig project die is opgedeeld in een hoofd project en @@ -139,7 +139,7 @@ Merk de `160000` mode op voor de `DbConnector` entry. Dat is een speciale mode in Git wat gewoon betekent dat je een commit opslaat als een directory entry in plaats van een subdirectory of een bestand. -[[_cloning_submodules]] +[[r_cloning_submodules]] ==== Een project met submodules clonen Hier zullen we een project met een submodule erin gaan clonen. @@ -515,7 +515,7 @@ Unable to merge 'c75e92a2b3855c9e5b66f915308390d9db204aca' in submodule path 'Db Je kunt in de directory van de submodule gaan en de conflicten oplossen op dezelfde manier zoals je anders ook zou doen. -[[_publishing_submodules]] +[[r_publishing_submodules]] ===== Submodule wizigingen publiceren We hebben nu een aantal wijzigingen in onze submodule directory. Sommige van deze zijn van stroomopwaarts @@ -826,7 +826,7 @@ Hier kunnen we zien dat we een functie aan het definieren zijn in een submodule Je wilt misschien een aantal aliassen maken voor een aantal van deze commando's omdat ze redelijk lang kunnen zijn en je geen configuratie opties voor de meeste van deze kunt instellen om ze standaard te maken. We hebben het opzetten - van Git aliassen in <<_git_aliases>> behandeld, maar hier is een voorbeeld van iets wat je misschien zou willen + van Git aliassen in <> behandeld, maar hier is een voorbeeld van iets wat je misschien zou willen opzetten als je van plan bent veel met submodules in Git te werken. [source,console] @@ -963,4 +963,4 @@ Het is belangrijk om op te merken dat submodules vandaag de dag al hun Git data directory niet tot verlies van enig commit of branches die je had. Met al deze gereedschappen, kunnen submodules een redelijk eenvoudig en effectieve manier zijn om een aantal - gerelateerde maar toch aparte projecten tegelijk te ontwikkelen. \ No newline at end of file + gerelateerde maar toch aparte projecten tegelijk te ontwikkelen. diff --git a/book/07-git-tools/sections/subtree-merges.asc b/book/07-git-tools/sections/subtree-merges.asc index 9634e882..9768d815 100644 --- a/book/07-git-tools/sections/subtree-merges.asc +++ b/book/07-git-tools/sections/subtree-merges.asc @@ -1,4 +1,4 @@ -[[_subtree_merge]] +[[r_subtree_merge]] ===== Het mergen van subtrees Het idee achter de subtree merge is dat je twee projecten hebt, en een van de projecten verwijst naar een @@ -52,7 +52,7 @@ Dit is een beetje een raar concept. Het is niet verplicht dat alle branches in j In dit geval willen we het Rack project in onze `master` project binnenhalen (pull) als een subdirectory. We kunnen dat in Git doen met `git read-tree`. -Je zult meer over `read-tree` en zijn vriendjes leren in <<_git_internals>>, maar neem voor nu aan dat het de root +Je zult meer over `read-tree` en zijn vriendjes leren in <>, maar neem voor nu aan dat het de root tree van een branch naar je huidige staging area en werk dirctory inleest. We zijn zojuist teruggeschakeld naar de `master` branch, en we pullen de `rach_branch` in de `rack` subdirectory van de `master` branch van ons hoofdproject: @@ -92,7 +92,7 @@ Je kunt ook het tegenovergestelde doen - de wijzigingen in de `rack` subdirector later naar je `rack_branch` branch mergen om ze dan in te dienen bij de beheerders of ze stroomopwaarts te pushen. Dit is een manier om een workflow te krijgen die lijkt op de submodule workflow zonder submodules te gebruiken (wat - we in <<_git_submodules>> zullen behandelen). We kunnen in onze repository branches aanmaken met andere gerelateerde + we in <> zullen behandelen). We kunnen in onze repository branches aanmaken met andere gerelateerde projecten en ze bij tijd en wijle subtree mergen in ons project. Dit is in sommige opzichten handig, bijvoorbeeld omdat alle code op een enkele plaats wordt gecommit. Het heeft echter ook nadelen in de zin dat het iets complexer is en gevoeliger voor fouten in het herintegreren van wijzigingen of abusievelijk een branch te pushen naar een niet diff --git a/book/08-customizing-git/images/clean.png b/book/08-customizing-git/images/clean.png deleted file mode 100644 index eed88a53..00000000 Binary files a/book/08-customizing-git/images/clean.png and /dev/null differ diff --git a/book/08-customizing-git/images/p4merge.png b/book/08-customizing-git/images/p4merge.png deleted file mode 100644 index b051b7a6..00000000 Binary files a/book/08-customizing-git/images/p4merge.png and /dev/null differ diff --git a/book/08-customizing-git/images/smudge.png b/book/08-customizing-git/images/smudge.png deleted file mode 100644 index 1edd3866..00000000 Binary files a/book/08-customizing-git/images/smudge.png and /dev/null differ diff --git a/book/08-customizing-git/sections/attributes.asc b/book/08-customizing-git/sections/attributes.asc index 0572e902..0fa333a1 100644 --- a/book/08-customizing-git/sections/attributes.asc +++ b/book/08-customizing-git/sections/attributes.asc @@ -170,7 +170,7 @@ index 88839c4..4afcb7c 100644 Je kunt eenvoudig zien dat de bestandsgrootte en de dimensies van je afbeelding beide zijn veranderd. -[[_keyword_expansion]] +[[r_keyword_expansion]] ==== Sleutelwoord expansie (Keyword expansion) (((keyword expansion))) @@ -211,15 +211,15 @@ Als je keyword substitutie in CVS of Subversion gebruikt hebt, kan je een datest Je kunt echter je eigen filters schrijven om substituties in bestanden doen bij commit/checkout. Dit worden ``clean'' (kuis) en ``smudge'' (besmeur) filters genoemd. In het `.gitattributes` bestand kan je een filter instellen voor specifieke paden en scripts maken die de bestanden - bewerken vlak voordat ze worden uitgechecked (``smudge'', zie <>) en vlak voordat ze worden gestaged - (``clean'', zie <>). + bewerken vlak voordat ze worden uitgechecked (``smudge'', zie <>) en vlak voordat ze worden gestaged + (``clean'', zie <>). Deze filters kunnen worden verteld om allerhande leuke dingen te doen. -[[filters_a]] +[[rfilters_a]] .Het ``smudge'' filter wordt bij checkout aangeroepen. image::images/smudge.png[Het ``smudge'' filter wordt bij checkout aangeroepen.] -[[filters_b]] +[[rfilters_b]] .Het ``clean'' filter wordt aangeroepen als bestanden worden gestaged. image::images/clean.png[Het ``clean'' filter wordt aangeroepen als bestanden worden gestaged.] @@ -408,4 +408,4 @@ Auto-merging database.xml Merge made by recursive. ---- -In dit geval blijft database.xml staan op de versie die je oorspronkelijk al had. \ No newline at end of file +In dit geval blijft database.xml staan op de versie die je oorspronkelijk al had. diff --git a/book/08-customizing-git/sections/config.asc b/book/08-customizing-git/sections/config.asc index 07149c73..f3e330db 100644 --- a/book/08-customizing-git/sections/config.asc +++ b/book/08-customizing-git/sections/config.asc @@ -1,8 +1,8 @@ -[[_git_config]] +[[r_git_config]] === Git configuratie (((git commando's, config))) -Zoals je al kort heb kunnen zien in <<_getting_started>>, kan je Git configuratie settings aangeven met het `git +Zoals je al kort heb kunnen zien in <>, kan je Git configuratie settings aangeven met het `git config` commando. Een van de eerste dingen die je hebt gedaan was het inrichten van je naam en e-mail adres: @@ -141,7 +141,7 @@ Als je dat aanroept, zal Git de gehele uitvoer van alle commando's tonen, onafha ===== `user.signingkey` (((GPG))) -Als je getekende geannoteerde tags aanmaakt (zoals behandeld in <<_signing>>), zal het inrichten van je GPG +Als je getekende geannoteerde tags aanmaakt (zoals behandeld in <>), zal het inrichten van je GPG handtekening als configuratie setting dingen eenvoudiger maken. Stel jouw sleutel ID als volgt in: @@ -161,7 +161,7 @@ $ git tag -s (((excludes)))(((.gitignore))) Je kunt patronen in het `.gitignore` bestand van je project zetten om Git deze niet als untracked bestanden te laten - beschouwen of deze zal proberen te stagen als je `git add` op ze aanroept, zoals beschreven in <<_ignoring>>. + beschouwen of deze zal proberen te stagen als je `git add` op ze aanroept, zoals beschreven in <>. Maar soms wil je bepaalde bestanden negeren voor alle repositories waar je in werkt. Als je computer onder Mac OS X draait, ben je waarschijnlijk bekend met `.DS_Store` bestanden. @@ -258,7 +258,7 @@ Je kunt de kleur instellen op elk van de volgende waarden: `normal`, `black`, `r Als je een attribuut als vetgedrukt (bold) in het vorige voorbeeld wilt, kan je kiezen uit `bold`, `dim` (minder helder), `ul` (onderstrepen, underline), `blink` (knipperen), en `reverse` (verwissel voor- en achtergrond). -[[_external_merge_tools]] +[[r_external_merge_tools]] ==== Externe merge en diff tools (((mergetool)))(((difftool))) @@ -574,4 +574,4 @@ $ git config --system receive.denyDeletes true Dit weigert het verwijderen van branches of tags - geen enkele gebruiker kan dit doen. Om remote branches te verwijderen, moet je de ref-bestanden handmatig van de server verwijderen. Er zijn nog meer interessante manieren om dit te doen op een gebruikersgerichte manier via ACL's, zoals je zult zien - in <<_an_example_git_enforced_policy>>. \ No newline at end of file + in <>. diff --git a/book/08-customizing-git/sections/hooks.asc b/book/08-customizing-git/sections/hooks.asc index d2dd159e..a5540622 100644 --- a/book/08-customizing-git/sections/hooks.asc +++ b/book/08-customizing-git/sections/hooks.asc @@ -1,4 +1,4 @@ -[[_git_hooks]] +[[r_git_hooks]] === Git Hooks (((hooks))) @@ -34,7 +34,7 @@ Deze paragraaf verdeelt ze in hooks voor een committing-workflow, scripts voor e ==== Het is belangrijk om op te merken dat hooks bij werkstations *niet* worden gekopieerd als je een repository cloont. Als het de bedoeling is van deze scripts om een beleid af te dwingen, moet je dat waarschijnlijk aan de kant van de - server doen; zie het voorbeeld in <<_an_example_git_enforced_policy>>. + server doen; zie het voorbeeld in <>. ==== ===== Committing-Workflow Hooks @@ -73,7 +73,7 @@ Deze krijgt geen enkele parameter, maar je kunt de laatste commit eenvoudig te p aan te roepen. Meestal wordt dit script gebruikt voor het doen van meldingen of iets vergelijkbaars. -[[_email_hooks]] +[[r_email_hooks]] ===== E-mail workflow hooks Je kunt drie hooks aan de kant van het werkstation inrichten voor een op e-mail gebaseerde workflow. @@ -99,7 +99,7 @@ De laatste hook die wordt aangeroepen met een `git am` operatie is `post-applypa Je kunt deze gebruiken om een groep of de auteur van de patch een bericht te sturen van dat je de patch hebt gepulled. Je kunt het patching proces niet stoppen met dit script. -[[_other_client_hooks]] +[[r_other_client_hooks]] ===== Overige werkstation hooks De `pre-rebase` hook wordt aangeroepen voordat je ook maar iets rebased en kan het proces stoppen door met niet-nul @@ -173,4 +173,4 @@ Voorbeelden omvatten het mailen naar een lijst, continuous integratie services n systeem bij werken - je kunt zelfs de commit berichten doorlezen om te zien of er tickets geopend, gewijzigd of gesloten moeten worden. Dit script kan het push proces niet stoppen, maar het werkstation zal de verbinding niet verbreken voordat dit script - geëindigd is, dus wees voorzichtig als je iets probeert te doen wat veel tijd in beslag neemt. \ No newline at end of file + geëindigd is, dus wees voorzichtig als je iets probeert te doen wat veel tijd in beslag neemt. diff --git a/book/08-customizing-git/sections/policy.asc b/book/08-customizing-git/sections/policy.asc index 75a4faa3..79d53e00 100644 --- a/book/08-customizing-git/sections/policy.asc +++ b/book/08-customizing-git/sections/policy.asc @@ -1,4 +1,4 @@ -[[_an_example_git_enforced_policy]] +[[r_an_example_git_enforced_policy]] === Een voorbeeld van Git-afgedwongen beleid (((beleid voorbeeld))) @@ -46,7 +46,7 @@ puts "(#{$refname}) (#{$oldrev[0,6]}) (#{$newrev[0,6]})" Ja, dat zijn globale variabelen. Niets zeggen - het is eenvoudiger om op deze manier dingen te tonen. -[[_enforcing_commit_message_format]] +[[r_enforcing_commit_message_format]] ===== Een specifiek commit-bericht formaat afdwingen Je eerste uitdaging is afdwingen dat elke commit bericht moet voldoen aan een specifiek formaat. @@ -77,7 +77,7 @@ Je kunt die uitvoer pakken, door elk van die commit SHA's heen lopen, de boodsch Je moet uit zien te vinden hoe je de commit boodschap kunt krijgen van alle te testen commits. Om de echte commit gegevens te krijgen, kun je een andere binnenwerk commando genaamd `git cat-file` gebruiken. -We zullen alle binnenwerk commando's in detail behandelen in <<_git_internals>>, maar voor nu is dit wat het +We zullen alle binnenwerk commando's in detail behandelen in <>, maar voor nu is dit wat het commando je geeft: [source,console] @@ -498,4 +498,4 @@ Je bent op zoek naar een commit die bereikbaar is vanuit de laatste commit op de Het grote nadeel van deze aanpak is dat het erg traag kan zijn en vaak onnodig is, als je de push niet probeert te forceren met de `-f` optie, dan zal de server je al waarschuwen en de push niet accepteren. Maar, het is een aardige oefening en kan je in theorie helpen om een rebase te voorkomen die je later zult moeten - herstellen. \ No newline at end of file + herstellen. diff --git a/book/09-git-and-other-scms/images/git-fusion-boot.png b/book/09-git-and-other-scms/images/git-fusion-boot.png deleted file mode 100644 index 07bdbbeb..00000000 Binary files a/book/09-git-and-other-scms/images/git-fusion-boot.png and /dev/null differ diff --git a/book/09-git-and-other-scms/images/git-fusion-perforce-graph.png b/book/09-git-and-other-scms/images/git-fusion-perforce-graph.png deleted file mode 100644 index 0883befb..00000000 Binary files a/book/09-git-and-other-scms/images/git-fusion-perforce-graph.png and /dev/null differ diff --git a/book/09-git-and-other-scms/images/git-tfs-ct.png b/book/09-git-and-other-scms/images/git-tfs-ct.png deleted file mode 100644 index e6311fe1..00000000 Binary files a/book/09-git-and-other-scms/images/git-tfs-ct.png and /dev/null differ diff --git a/book/09-git-and-other-scms/sections/client-hg.asc b/book/09-git-and-other-scms/sections/client-hg.asc index e3d18d7b..49531c88 100644 --- a/book/09-git-and-other-scms/sections/client-hg.asc +++ b/book/09-git-and-other-scms/sections/client-hg.asc @@ -424,4 +424,4 @@ Dit kan *erg* verwarrend worden voor je teamgenoten die Mercurial gebruiken, dus Git en Mercurial zijn gelijk genoeg dat het werken over deze grenzen redelijk goed gaat. Als je het wijzigen van historie die achterblijft op je machine vermijdt (zoals over het algemeen aangeraden wordt), - zou je niet eens kunnen zeggen dat Mercurial aan de andere kant staat. \ No newline at end of file + zou je niet eens kunnen zeggen dat Mercurial aan de andere kant staat. diff --git a/book/09-git-and-other-scms/sections/client-p4.asc b/book/09-git-and-other-scms/sections/client-p4.asc index bd286153..b1176b6a 100644 --- a/book/09-git-and-other-scms/sections/client-p4.asc +++ b/book/09-git-and-other-scms/sections/client-p4.asc @@ -15,7 +15,7 @@ De eerste die we gaan behandelen is de ``Git Fusion'' bridge van de makers van P De tweede is git-p4, een bridge op het werkstation die je Git als een Perforce client laat werken, zonder een herconfiguratie van de Perforce server af te dwingen. -[[_p4_git_fusion]] +[[r_p4_git_fusion]] ===== Git Fusion (((Perforce, Git Fusion))) @@ -667,7 +667,7 @@ Dit houdt in dat je zonder problemen branches kunt maken, erop werken, weggooien bang te zijn dat je historie op de een of andere manier niet meer compatible is met Perforce. Als je het kunt rebasen, kan je het insturen naar een Perforce server. -[[_git_p4_branches]] +[[r_git_p4_branches]] ====== Branchen Als je Perforce project meerdere branches heeft, is niet alles voor je verloren; git-p4 kan het op een manier @@ -754,4 +754,4 @@ Wees vooral erg voorzichtig om Git commits te delen; als je een remote hebt die Als je vrijelijk zowel de Perforce en Git clients tegelijk wilt gebruiken voor broncode beheer, en je kunt de beheerder van de server ervan overtuigen om het te installeren, zal Git Fusion Git een eersterangs versiebeheer - client maken voor een Perforce server. \ No newline at end of file + client maken voor een Perforce server. diff --git a/book/09-git-and-other-scms/sections/client-svn.asc b/book/09-git-and-other-scms/sections/client-svn.asc index 21b5c2f2..8e50a416 100644 --- a/book/09-git-and-other-scms/sections/client-svn.asc +++ b/book/09-git-and-other-scms/sections/client-svn.asc @@ -1,4 +1,4 @@ -[[_git_svn]] +[[r_git_svn]] ==== Git en Subversion (((Subversion)))(((Samenwerking met andere VCSen, Subversion))) @@ -576,4 +576,4 @@ Probeer, om niet in de problemen te komen, de volgende richtlijnen te volgen: Als je deze richtlijnen volgt, wordt het werken met een Subversion server misschien dragelijker. Echter, als het ook maar enigszins mogelijk is om naar een echte Git server te gaan, zal dit je team veel meer - opleveren. \ No newline at end of file + opleveren. diff --git a/book/09-git-and-other-scms/sections/client-tfs.asc b/book/09-git-and-other-scms/sections/client-tfs.asc index 28f9b13e..0cfc9873 100644 --- a/book/09-git-and-other-scms/sections/client-tfs.asc +++ b/book/09-git-and-other-scms/sections/client-tfs.asc @@ -469,4 +469,4 @@ Als je op Windows werkt (wat waarschijnlijk is als je team TFS gebruikt), zal je gebruiken, omdat deze de meest complete functionaliteit biedt, maar als je op een ander platform werkt, zal je git-tf gebruiken die beperkter is. Zoals de meeste gereedschappen in dit hoofdstuk, zal je een van deze versie-beheer systemen als leidend kiezen, en de - andere in een volgende rol gebruiken - Git of TFVC moet het middelpunt van de samenwerking zijn, niet beide. \ No newline at end of file + andere in een volgende rol gebruiken - Git of TFVC moet het middelpunt van de samenwerking zijn, niet beide. diff --git a/book/09-git-and-other-scms/sections/import-custom.asc b/book/09-git-and-other-scms/sections/import-custom.asc index fbbbc6e5..5f2eae07 100644 --- a/book/09-git-and-other-scms/sections/import-custom.asc +++ b/book/09-git-and-other-scms/sections/import-custom.asc @@ -1,4 +1,4 @@ -[[_custom_importer]] +[[r_custom_importer]] ==== Importeren op maat (((git commando's, fast-import))) @@ -10,7 +10,7 @@ Als geen van die tools voor jouw geschikt zijn, je hebt een heel obscure tool, o meer aangepaste importeer proces nodig, dan moet je `git fast-import` gebruiken. Dit commando leest eenvoudige instructies van stdin om specifieke Git gegevens te schrijven. Het is veel eenvoudiger om op deze manier Git objecten aan te maken dan de rauwe Git commando's te gebruiken of om - zelf de rauwe objecten te schrijven (zie <<_git_internals>> voor meer informatie). + zelf de rauwe objecten te schrijven (zie <> voor meer informatie). Met dit middel kan je een import script schrijven die de benodigde informatie uit het te importeren systeem leest en op stdout eenvoudige instructies afdrukt. Je kunt dit programma dan aanroepen en de uitvoer doorgeven aan `git fast-import` met een pipe-instructie. @@ -38,7 +38,7 @@ Alles wat je hoeft te doen is `fast-import` te vertellen wat de snapshots van de Je strategie zal zijn om een voor een door de snapshots te gaan en commits te maken met de inhoud van elke directory, en elke commit terug te laten verwijzen naar de vorige. -Zoals we in <<_an_example_git_enforced_policy>> gedaan hebben, schrijven we dit in Ruby, omdat dit is waar we +Zoals we in <> gedaan hebben, schrijven we dit in Ruby, omdat dit is waar we gewoonlijk mee werken en het redelijk eenvoudig te lezen is. Je kunt dit voorbeeld redelijk eenvoudig in iets schrijven waar je bekend mee bent - het moet gewoon de juiste informatie naar `stdout` uitvoeren. @@ -409,4 +409,4 @@ README.md main.rb Je kunt nog veel meer doen met het `fast-import` gereedschap - verschillende modes behandelen, binaire gegevens, meerdere branches en mergen, tags, voortgangs-indicators en meer. Een aantal voorbeelden van meer ingewikkelde scenarios zijn beschikbaar in de `contrib/fast-import` directory van de -Git broncode. \ No newline at end of file +Git broncode. diff --git a/book/09-git-and-other-scms/sections/import-p4.asc b/book/09-git-and-other-scms/sections/import-p4.asc index 0990a077..08b22e6f 100644 --- a/book/09-git-and-other-scms/sections/import-p4.asc +++ b/book/09-git-and-other-scms/sections/import-p4.asc @@ -1,4 +1,4 @@ -[[_perforce_import]] +[[r_perforce_import]] ==== Perforce (((Perforce)))(((Importeren, uit Perforce))) @@ -10,12 +10,12 @@ Zoals hierboven besproken, zijn er twee manieren om Git en Perforce met elkaar t Met Git Fusion verloopt dit proces vrijwel pijnloos. Configureer alleen je project settings, user mappings en branches met behulp van een configuratie bestand (zoals - behandeld in <<_p4_git_fusion>>), en clone de repository. + behandeld in <>), en clone de repository. Git Fusion geeft je iets wat eruit ziet als een echte Git repository, die dan klaar is om naar een reguliere Git host te pushen als je dat wilt. Je kunt zelfs Perforce als je Git host gebruiken als je dat wilt. -[[_git_p4]] +[[r_git_p4]] ===== Git-p4 Git-p4 kan ook als een importeer gereedschap werken. @@ -51,7 +51,7 @@ Importing revision 9957 (100%) Dit specifieke project heeft maar een branch, maar als je branches hebt die geconfigureerd zijn met branch views (of alleen een set directories), kan je de `--detect-branches` vlag gebruiken bij `git p4 clone` om alle branches van het project ook te importeren. -Zie <<_git_p4_branches>> voor wat meer diepgang op dit onderwerp. +Zie <> voor wat meer diepgang op dit onderwerp. Op dit punt ben je bijna klaar. Als je naar de `p4import` directory gaat en `git log` aanroept, kan je je geïmporteerde werk zien: @@ -109,4 +109,4 @@ Date: Tue Jul 7 01:35:51 2009 -0800 Fix spelling error on Jam doc page (cummulative -> cumulative). ---- -Je import is klaar om te worden gepushed naar je nieuwe Git server. \ No newline at end of file +Je import is klaar om te worden gepushed naar je nieuwe Git server. diff --git a/book/09-git-and-other-scms/sections/import-svn.asc b/book/09-git-and-other-scms/sections/import-svn.asc index 230c5aeb..a2985b81 100644 --- a/book/09-git-and-other-scms/sections/import-svn.asc +++ b/book/09-git-and-other-scms/sections/import-svn.asc @@ -117,4 +117,4 @@ Omdat al je branches en tags ernaar wilt sturen, kan je nu dit aanroepen: $ git push origin --all ---- -Al je branches en tags zouden nu op je nieuwe Git server moeten staan in een mooie, schone import. \ No newline at end of file +Al je branches en tags zouden nu op je nieuwe Git server moeten staan in een mooie, schone import. diff --git a/book/09-git-and-other-scms/sections/import-tfs.asc b/book/09-git-and-other-scms/sections/import-tfs.asc index 47e49973..b6085b59 100644 --- a/book/09-git-and-other-scms/sections/import-tfs.asc +++ b/book/09-git-and-other-scms/sections/import-tfs.asc @@ -1,4 +1,4 @@ -[[_git_tfs]] +[[r_git_tfs]] ==== TFS (((TFS)))(((Importeren, uit TFS))) @@ -68,4 +68,4 @@ Dit gebruikt het `sed` commando van de Git-bash omgeving om elke regel die begin vervangen, dit Git vervolgens dan zal negeren. Als dit eenmaal gedaan is, ben je klaar om een nieuwe remote toe te voegen, al je branches te pushen, en je team is - klaar om met Git te gaan werken. \ No newline at end of file + klaar om met Git te gaan werken. diff --git a/book/10-git-internals/images/data-model-1.png b/book/10-git-internals/images/data-model-1.png deleted file mode 100644 index d11b69c0..00000000 Binary files a/book/10-git-internals/images/data-model-1.png and /dev/null differ diff --git a/book/10-git-internals/images/data-model-2.png b/book/10-git-internals/images/data-model-2.png deleted file mode 100644 index ca6b9ba6..00000000 Binary files a/book/10-git-internals/images/data-model-2.png and /dev/null differ diff --git a/book/10-git-internals/images/data-model-3.png b/book/10-git-internals/images/data-model-3.png deleted file mode 100644 index 8f76ae1f..00000000 Binary files a/book/10-git-internals/images/data-model-3.png and /dev/null differ diff --git a/book/10-git-internals/images/data-model-4.png b/book/10-git-internals/images/data-model-4.png deleted file mode 100644 index ea9734f2..00000000 Binary files a/book/10-git-internals/images/data-model-4.png and /dev/null differ diff --git a/book/10-git-internals/sections/environment.asc b/book/10-git-internals/sections/environment.asc index 96616fa4..029e5145 100644 --- a/book/10-git-internals/sections/environment.asc +++ b/book/10-git-internals/sections/environment.asc @@ -255,7 +255,7 @@ Het is waarschijnlijk makkelijker om gewoon het `~/.ssh/config` bestand hiervoor *`GIT_ASKPASS`* overschrijft de waarde van de `core.askpass` configuratie waarde. Dit is het programma dat wordt aangeroepen elke keer als Git de gebruiker moet vragen om de aanloggegevens, die een tekst prompt mag verwachten als een commando-regel argument, en het antwoord meto teruggeven op `stdout`. -(Zie <<_credential_caching>> voor meer over dit subsysteem.) +(Zie <> voor meer over dit subsysteem.) *`GIT_NAMESPACE`* bepaalt de toegang tot refs in een namespace, en is gelijjkwaardig aan de `--namespace` vlag. Dit wordt is voornamelijk nuttig aan de kant van de server, waar je misschien meerdere forks wilt opslaan van een diff --git a/book/10-git-internals/sections/maintenance.asc b/book/10-git-internals/sections/maintenance.asc index 4975502c..87b4ea8c 100644 --- a/book/10-git-internals/sections/maintenance.asc +++ b/book/10-git-internals/sections/maintenance.asc @@ -4,7 +4,7 @@ Bij tijd en wijle, moet je wat opschonen - een repository iets compacter maken, opschonen of verloren gegane werk herstellen. Deze paragraaf zal een aantal van deze scenarios behandelen. -[[_git_gc]] +[[r_git_gc]] ==== Onderhoud Op gezette tijden roept Git automatisch een commando genaamd ``auto gc'' aan. @@ -64,7 +64,7 @@ Let even op de laatste regel van het bestand, die begint met een `^`. Dit geeft aan dat de tag directory erboven een geannoteerde tag is, en deze regel de commit is waar de geannoteerde tag naar verwijst. -[[_data_recovery]] +[[r_data_recovery]] ==== Gegevensherstel Op een bepaald punt in je Git reis, kan je per ongeluk een commit kwijt raken. @@ -109,7 +109,7 @@ Vaak is de snelste manier om een instrument genaamd `git reflog` te gebruiken. Als je aan het werk bent, houdt Git stilletjes bij wat je HEAD was elke keer als je het verandert. Elke keer als je commit, of branches wijzigt, wordt de reflog bijgewerkt. De reflog wordt ook bijgewerkt door het `git update-ref` commando, wat nog een reden is om dit te gebruiken in plaats - van alleen de SHA-1 waarden naar je ref bestanden te schrijven, zoals we besproken hebben in <<_git_refs>>. + van alleen de SHA-1 waarden naar je ref bestanden te schrijven, zoals we besproken hebben in <>. Je kunt zien waar je op enig moment geweest bent door `git reflog` aan te roepen: [source,console] @@ -191,7 +191,7 @@ dangling blob 7108f7ecb345ee9d0084193f147cdad4d2998293 In dit geval kan je de ontbrekende commit zien achter de tekst ``dangling commit''. Je kunt het op dezelfde manier herstellen, door een branch toe te voegen die wijst naar die SHA-1. -[[_removing_objects]] +[[r_removing_objects]] ==== Objecten verwijderen Er zijn ontzettend veel goede dingen met Git, maar een eigenschap die problemen kan veroorzaken is het feit dat een @@ -295,7 +295,7 @@ dadf7258d699da2c8d89b09ef6670edb7d5f91b4 commit 229 159 12 Het grote object staat onderaan: 5MB. Om uit te vinden welk bestand dit is, ga je het `rev-list` commando gebruiken, die je al eventjes gebruikt hebt in - <<_enforcing_commit_message_format>>. + <>. Als je `--objects` doorgeeft aan `rev-list`, laat het alle SHA-1s zien van commits en ook de blob SHA-1s met het bestandspad die ermee verbonden is. Je kunt dit gebruiken om de naam van jouw blob te vinden: @@ -318,7 +318,7 @@ dadf725 oops - removed large tarball Je moet alle commits herschrijven die stroomafwaarts van `7b30847` liggen om dit bestand volledig uit je Git historie te verwijderen. -Om dit te doen, gebruik je `filter-branch`, die je gebruikt hebt in <<_rewriting_history>>: +Om dit te doen, gebruik je `filter-branch`, die je gebruikt hebt in <>: [source,console] ---- @@ -329,7 +329,7 @@ Rewrite dadf7258d699da2c8d89b09ef6670edb7d5f91b4 (2/2) Ref 'refs/heads/master' was rewritten ---- -De `--index-filter` optie is gelijk aan de `--tree-filter` optie zoals gebruikt in <<_rewriting_history>>, behalve +De `--index-filter` optie is gelijk aan de `--tree-filter` optie zoals gebruikt in <>, behalve dat in plaats van een commando door te geven die bestanden wijzigt die op schijf zijn uitgechecked, je elke keer het staging gebied of index wijzigt. diff --git a/book/10-git-internals/sections/objects.asc b/book/10-git-internals/sections/objects.asc index 52207059..9369ecfc 100644 --- a/book/10-git-internals/sections/objects.asc +++ b/book/10-git-internals/sections/objects.asc @@ -1,4 +1,4 @@ -[[_objects]] +[[r_objects]] === Git objecten Git is een op inhoud-adresseerbaar bestandssysteem. @@ -124,7 +124,7 @@ $ git cat-file -t 1f7a7a472abf3dd9643fd615f6da379c4acb3e3a blob ---- -[[_tree_objects]] +[[r_tree_objects]] ==== Boom objecten (tree objects) Het volgende type waar we naar gaan kijken is de tree, wat het probleem oplost van het opslaan van bestandsnamen en @@ -252,7 +252,7 @@ Je kunt de gegevens die Git bevat voor deze structuren als volgt weergeven: .De inhoudsstructuur van je huidige Git gegevens. image::images/data-model-2.png[De inhoudsstructuur van je huidige Git gegevens.] -[[_git_commit_objects]] +[[r_git_commit_objects]] ==== Commit objecten Je hebt drie trees die de verschillende snapshots weergeven van je project die je wilt volgen, maar het eerdere @@ -438,4 +438,4 @@ Dat is alles - je hebt een valide Git blob object gemaakt. Alle Git objecten worden op dezelfde manier opgeslagen, alleen met andere types - in plaats van de tekenreeks blob, begint de header met commit of tree. Daarnaast, alhoewel de inhoud van een blob zo ongeveer alles kan zijn, is de inhoud van een commit en tree zeer - specifiek geformatteerd. \ No newline at end of file + specifiek geformatteerd. diff --git a/book/10-git-internals/sections/packfiles.asc b/book/10-git-internals/sections/packfiles.asc index 6e4afa4f..fae18b96 100644 --- a/book/10-git-internals/sections/packfiles.asc +++ b/book/10-git-internals/sections/packfiles.asc @@ -180,4 +180,4 @@ Wat ook interessant is, is dat de tweede versie van het bestaand degene is die i Het echte leuke van dit is, is dat het op elk gewenste moment weer opnieuw kan worden ingepakt. Git zal van op gezette tijden je database automatisch opnieuw inpakken, altijd met het doel nog meer ruimte te - besparen, maar je kunt ook handmatig opnieuw laten inpakken door `git gc` zelf aan te roepen. \ No newline at end of file + besparen, maar je kunt ook handmatig opnieuw laten inpakken door `git gc` zelf aan te roepen. diff --git a/book/10-git-internals/sections/plumbing-porcelain.asc b/book/10-git-internals/sections/plumbing-porcelain.asc index fa983899..b98b353b 100644 --- a/book/10-git-internals/sections/plumbing-porcelain.asc +++ b/book/10-git-internals/sections/plumbing-porcelain.asc @@ -1,4 +1,4 @@ -[[_plumbing_porcelain]] +[[r_plumbing_porcelain]] === Binnenwerk en koetswerk (plumbing and porcelain) Dit boek behandelt hoe Git te gebruiken met ongeveer 30 werkwoorden als `checkout`, `branch`, `remote`, enzovoort. @@ -39,11 +39,11 @@ Het `description` bestand wordt alleen gebruikt door het GitWeb programma, dus m Het `config` bestand bevat jouw project-specifieke configuratie opties, en de `info` directory bevat een globale exclude bestand (((excludes))) voor genegeerde patronen die je niet wilt tracken in een .gitignore bestand. De `hooks` directory bevat de hook-scripts voor de werkstation of server kant, waar we dieper op zijn ingegaan in - <<_git_hooks>>. + <>. Resten vier belangrijke regels: de `HEAD` en (nog te maken) `index` bestanden, en de `objects` en `refs` directories. Dit zijn de kern-onderdelen van Git. De `objects` directory bevat alle inhoud voor jouw database, de `refs` directory bevat verwijzingen naar commit objecten in die gegevens (branches), het `HEAD` bestand verwijst naar de branch die je op dit moment uitgechecked hebt, en het `index` bestand is waar Git de informatie over je staging gebied bewaart. -We zullen hierna dieper ingaan op elk van deze onderdelen om te zien hoe Git werkt. \ No newline at end of file +We zullen hierna dieper ingaan op elk van deze onderdelen om te zien hoe Git werkt. diff --git a/book/10-git-internals/sections/refs.asc b/book/10-git-internals/sections/refs.asc index fdb1b5ba..d73d2a57 100644 --- a/book/10-git-internals/sections/refs.asc +++ b/book/10-git-internals/sections/refs.asc @@ -1,4 +1,4 @@ -[[_git_refs]] +[[r_git_refs]] === Git Referenties Je kunt iets als `git log 1a410e` aanroepen om door je hele geschiedenis te laten kijken, maar je moet nog steeds @@ -72,7 +72,7 @@ Als je commando's aanroept zoals `git branch (branchnaam)`, roept Git feitelijk SHA-1 van de laatste commit op de branch waar je op zit te plaatsten in de referentie die je op dat moment wilt aanmaken. -[[_the_head]] +[[r_the_head]] ==== De HEAD De vraag is nu, als je `git branch (branchnaam)` aanroept, hoe weet Git de SHA-1 van de laatste commit? @@ -134,7 +134,7 @@ Het belangrijkste verschil is dat een tag object over het algemeen verwijst naar Het lijkt op een branch referentie, maar het zal nooit bewegen - het verwijst altijd naar dezelfde commit, maar geeft het een vriendelijkere naam. -Zoals besproken in <<_git_basics_chapter>>, zijn er twee soorten tags: geannoteerd en lichtgewicht. +Zoals besproken in <>, zijn er twee soorten tags: geannoteerd en lichtgewicht. Je kunt een lichtgewicht tag aanmaken door iets als het volgende aan te roepen: [source,console] @@ -220,4 +220,4 @@ Referenties van remotes verschillen van branches (`refs/heads` referenties) voor 'alleen-lezen' worden beschouwd. Je kunt naar een `git checkout` doen, maar Git zal HEAD nooit naar een laten verwijzen, dus je zult er een kunnen bijwerken met een `commit` commando. -Git gebruikt ze als boekleggers naar de laatst bekende staat van waar deze branches op stonden op die servers. \ No newline at end of file +Git gebruikt ze als boekleggers naar de laatst bekende staat van waar deze branches op stonden op die servers. diff --git a/book/10-git-internals/sections/refspec.asc b/book/10-git-internals/sections/refspec.asc index 1c090089..bd258878 100644 --- a/book/10-git-internals/sections/refspec.asc +++ b/book/10-git-internals/sections/refspec.asc @@ -1,4 +1,4 @@ -[[_refspec]] +[[r_refspec]] === De Refspec In dit hele boek hebben we eenvoudige verbanden (mappings) gebruikt tussen remote branches naar lokale referenties, maar @@ -103,7 +103,7 @@ Als je een complexe workflow proces hebt waarbij een QA team branches pushed, wa integratie teams die pushen naar en samenwerken op remote branches, kan je ze eenvoudig namespaces toewijzen op deze manier. -[[_pushing_refspecs]] +[[r_pushing_refspecs]] ==== Refspecs pushen Het is leuk dat je namespaced referenties op deze manier kunt fetchen, maar hoe krijgt het QA team om te beginnen hun @@ -141,4 +141,4 @@ $ git push origin :topic ---- Omdat de refspec `:` is zal, door het weglaten van het `` gedeelte, dit eigenlijk zeggen dat de topic - branch van de remote niets moet worden, waarmee het wordt verwijderd. \ No newline at end of file + branch van de remote niets moet worden, waarmee het wordt verwijderd. diff --git a/book/10-git-internals/sections/transfer-protocols.asc b/book/10-git-internals/sections/transfer-protocols.asc index fc4d0086..b7e4737c 100644 --- a/book/10-git-internals/sections/transfer-protocols.asc +++ b/book/10-git-internals/sections/transfer-protocols.asc @@ -323,4 +323,4 @@ Deze paragraaf bevat een zeer basale overzicht van de uitwisselings-protocollen. Het protocol omvat vele andere mogelijkheden, zoals `multi_ack` of `side-band` mogelijkheden, maar de behandeling hiervan valt buiten het bestek van dit boek. We hebben geprobeerd je een idee te geven van het globale over-en-weer tussen werkstation en server; als je meer - kennis nodig hebt hierover, dan kan je bijvoorbeeld een kijkje nemen in de Git broncode. \ No newline at end of file + kennis nodig hebt hierover, dan kan je bijvoorbeeld een kijkje nemen in de Git broncode. diff --git a/book/A-git-in-other-environments/images/branch_widget_mac.png b/book/A-git-in-other-environments/images/branch_widget_mac.png deleted file mode 100644 index 73b00b35..00000000 Binary files a/book/A-git-in-other-environments/images/branch_widget_mac.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/branch_widget_win.png b/book/A-git-in-other-environments/images/branch_widget_win.png deleted file mode 100644 index 285195ed..00000000 Binary files a/book/A-git-in-other-environments/images/branch_widget_win.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/egit.png b/book/A-git-in-other-environments/images/egit.png deleted file mode 100644 index 284ebe7f..00000000 Binary files a/book/A-git-in-other-environments/images/egit.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/git-bash.png b/book/A-git-in-other-environments/images/git-bash.png deleted file mode 100644 index 59f00bb8..00000000 Binary files a/book/A-git-in-other-environments/images/git-bash.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/git-gui.png b/book/A-git-in-other-environments/images/git-gui.png deleted file mode 100644 index 9c988047..00000000 Binary files a/book/A-git-in-other-environments/images/git-gui.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/github_mac.png b/book/A-git-in-other-environments/images/github_mac.png deleted file mode 100644 index acd59cfe..00000000 Binary files a/book/A-git-in-other-environments/images/github_mac.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/github_win.png b/book/A-git-in-other-environments/images/github_win.png deleted file mode 100644 index 1780863d..00000000 Binary files a/book/A-git-in-other-environments/images/github_win.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/gitk.png b/book/A-git-in-other-environments/images/gitk.png deleted file mode 100644 index 9fac838d..00000000 Binary files a/book/A-git-in-other-environments/images/gitk.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/posh-git.png b/book/A-git-in-other-environments/images/posh-git.png deleted file mode 100644 index 0d087574..00000000 Binary files a/book/A-git-in-other-environments/images/posh-git.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/vs-1.png b/book/A-git-in-other-environments/images/vs-1.png deleted file mode 100644 index 5c4e9291..00000000 Binary files a/book/A-git-in-other-environments/images/vs-1.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/vs-2.png b/book/A-git-in-other-environments/images/vs-2.png deleted file mode 100644 index a70ff9f0..00000000 Binary files a/book/A-git-in-other-environments/images/vs-2.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/zsh-oh-my.png b/book/A-git-in-other-environments/images/zsh-oh-my.png deleted file mode 100644 index 15cac3a9..00000000 Binary files a/book/A-git-in-other-environments/images/zsh-oh-my.png and /dev/null differ diff --git a/book/A-git-in-other-environments/images/zsh-prompt.png b/book/A-git-in-other-environments/images/zsh-prompt.png deleted file mode 100644 index cf609fb3..00000000 Binary files a/book/A-git-in-other-environments/images/zsh-prompt.png and /dev/null differ diff --git a/book/A-git-in-other-environments/sections/bash.asc b/book/A-git-in-other-environments/sections/bash.asc index fd9c44ae..6e67b6ef 100644 --- a/book/A-git-in-other-environments/sections/bash.asc +++ b/book/A-git-in-other-environments/sections/bash.asc @@ -44,4 +44,4 @@ Nu zal je bash prompt er zo uit zien als je ergens in een door Git beheerd proje image::images/git-bash.png[Aangepaste `bash` prompt.] Al deze scripts hebben behulpzame documentatie; neem een kijkje in de documentatie van `git-completion.bash` en - `git-prompt.sh` voor meer informatie. \ No newline at end of file + `git-prompt.sh` voor meer informatie. diff --git a/book/A-git-in-other-environments/sections/guis.asc b/book/A-git-in-other-environments/sections/guis.asc index 064db58a..98c35fc0 100644 --- a/book/A-git-in-other-environments/sections/guis.asc +++ b/book/A-git-in-other-environments/sections/guis.asc @@ -146,7 +146,7 @@ ALs je al een lokale repository hebt, kan je de directory hiervan vanuit de Find Als het eenmaal is geïnstalleerd en geconfigureerd, kan je de GitHub client voor veel reguliere Git taken gebruiken. De tool is gemaakt met de workflow die ``GitHub Flow'' heet in gedachten. -We zullen dit in meer detail behandelen in <<_github_flow>>, maar de achterliggende gedachte is dat (a) je naar een +We zullen dit in meer detail behandelen in <>, maar de achterliggende gedachte is dat (a) je naar een branch gaat committen, en (b) dat je vrij regelmatig met een remote repository zult gaan synchroniseren. Branch beheer is een van de gebieden waar deze twee tools afwijken. diff --git a/book/A-git-in-other-environments/sections/powershell.asc b/book/A-git-in-other-environments/sections/powershell.asc index 9ff30105..19f2b6d1 100644 --- a/book/A-git-in-other-environments/sections/powershell.asc +++ b/book/A-git-in-other-environments/sections/powershell.asc @@ -1,4 +1,4 @@ -[[_git_powershell]] +[[r_git_powershell]] === Git in Powershell (((powershell)))(((tab completion, powershell)))(((shell prompts, powershell))) diff --git a/book/A-git-in-other-environments/sections/visualstudio.asc b/book/A-git-in-other-environments/sections/visualstudio.asc index c3dbd51d..33f90724 100644 --- a/book/A-git-in-other-environments/sections/visualstudio.asc +++ b/book/A-git-in-other-environments/sections/visualstudio.asc @@ -17,12 +17,12 @@ image::images/vs-1.png[Verbinding maken met een Git repository vanuit Team Explo Visual Studio onthoudt alle door Git beheerde projecten die je geopend hebt, en ze zijn beschikbaar in de lijst onderop. Als je het gewenste project daar niet ziet, klik dan op de "Add" link en type het pad naar de werk directory. -Dubbel klikken op een van de lokale Git repositories resulteert in de Home view, die eruit ziet als <>. +Dubbel klikken op een van de lokale Git repositories resulteert in de Home view, die eruit ziet als <>. Dit is een centrale plaats voor het uitvoeren van Git acties; als je code aan het _schrijven_ bent, zal je waarschijnlijk de meeste tijd doorbrengen in de "Changes" view, maar wanneer het tijd wordt om wijzigingen die je teamgenoten hebben gemaakt te pullen, zal je de "Unsynched Commits" en "Branches" views gebruiken. -[[vs_home]] +[[rvs_home]] .De "Home" view voor een Git repository in Visual Studio. image::images/vs-2.png[De Home view voor een Git repository in Visual Studio.] diff --git a/book/A-git-in-other-environments/sections/zsh.asc b/book/A-git-in-other-environments/sections/zsh.asc index 85b65fca..df1d8584 100644 --- a/book/A-git-in-other-environments/sections/zsh.asc +++ b/book/A-git-in-other-environments/sections/zsh.asc @@ -42,8 +42,8 @@ Zsh is krachtig genoeg dat er complete frameworks aan zijn gewijd om het beter t Een van deze heet "oh-my-zsh", en deze staat op https://github.com/robbyrussell/oh-my-zsh[]. In het plugin systeem van oh-my-zsh zit een krachtige git tab-voltooing, en het heeft een rijke verzameling prompt "themes", en vele daarvan tonen versie-beheer gegevens. -<> is maar een voorbeeld van wat gedaan kan worden met dit systeem. +<> is maar een voorbeeld van wat gedaan kan worden met dit systeem. -[[oh_my_zsh_git]] +[[roh_my_zsh_git]] .Een voorbeeld van een oh-my-zsh thema. image::images/zsh-oh-my.png[Een voorbeeld van een oh-my-zsh thema.] diff --git a/book/B-embedding-git/sections/jgit.asc b/book/B-embedding-git/sections/jgit.asc index 1f14634a..fad896f2 100644 --- a/book/B-embedding-git/sections/jgit.asc +++ b/book/B-embedding-git/sections/jgit.asc @@ -116,7 +116,7 @@ Ref objecten worden ook gebruikt om tag refs en objecten te vertegenwoordigen, d De tweede regel haalt het doel van de `master` referentie op, die wordt teruggegeven als een ObjectId instantie. ObjectId vertegenwoordigt de SHA-1 hash van een object, die al dan niet kan bestaan in de object database van Git. De derde regel is vergelijkbaar, maar laat zien hoe JGit omgaat met de rev-parse syntax (meer hierover in - <<_branch_references>>); je kunt er elke object specificatie aan doorgeven die Git begrijpt, en JGit geeft een + <>); je kunt er elke object specificatie aan doorgeven die Git begrijpt, en JGit geeft een geldige ObjectId terug voor dat object, of `null`. De volgende twee regels laten zien hoe de rauwe inhoud van een object wordt ingeladen. diff --git a/book/B-embedding-git/sections/libgit2.asc b/book/B-embedding-git/sections/libgit2.asc index e657a58e..de40db18 100644 --- a/book/B-embedding-git/sections/libgit2.asc +++ b/book/B-embedding-git/sections/libgit2.asc @@ -37,7 +37,7 @@ Dit is de eenvoudigste manier, voor als je het exacte pad naar de werk directory Er is ook `git_repository_open_ext` die opties voor zoeken in zich heeft, `git_clone` en z'n vriendjes voor het maken van een lokale clone van een remote repository, en `git_repository_init` voor het maken van een hele nieuwe repository. -Het tweede stuk code gebruikt rev-parse syntax (zie <<_branch_references>> voor meer details) om de commit te +Het tweede stuk code gebruikt rev-parse syntax (zie <> voor meer details) om de commit te krijgen waar HEAD uiteindelijk naar wijst. Het type dat je terugkrijgt is een `git_object` pointer, wat staat voor iets dat bestaat in de Git object database voor een repository. @@ -118,7 +118,7 @@ commit = repo.lookup(commit_id) # <8> te krijgen. De code in Ruby is mooi en schoon, maar omdat Libgit2 het zware werk doet, zal deze code ook redelijk snel draaien. -Als je niet zo'n Rubyist bent, we behandelen nog een aantal andere bindings in <<_libgit2_bindings>>. +Als je niet zo'n Rubyist bent, we behandelen nog een aantal andere bindings in <>. ==== Functionaliteit voor gevorderden @@ -198,7 +198,7 @@ De initialisatie functie alloceert wat geheugen voor de structure, richt de eige Neem een kijkje in het `include/git2/sys/odb_backend.h` bestand in de Libgit2 broncode voor een volledige set van aanroep-signatures; jou specifieke use-case helpt je bepalen welke van deze je wilt ondersteunen. -[[_libgit2_bindings]] +[[r_libgit2_bindings]] ==== Andere bindings Libgit2 heeft bindings voor vele talen. diff --git a/book/dedication.asc b/book/dedication.asc new file mode 100644 index 00000000..faff8051 --- /dev/null +++ b/book/dedication.asc @@ -0,0 +1,8 @@ +[dedication] +== Opdrachten + +_Aan mijn vrouw, Becky, zonder wie dit avontuur nooit zou zijn begonnen. — Ben_ + +_Deze uitgave draag ik op aan mijn meisjes. +Aan mijn vrouw Jessica die me al deze jaren heeft gesteund en aan mijn dochter Josephine, +die mij zal ondersteunen als ik te oud ben om te beseffen wat er gebeurt. — Scott_ diff --git a/book/license.asc b/book/license.asc new file mode 100644 index 00000000..490603e1 --- /dev/null +++ b/book/license.asc @@ -0,0 +1,4 @@ +[preface] +== Licence + +include::../LICENSE.asc[] diff --git a/book/preface_ben.asc b/book/preface_ben.asc new file mode 100644 index 00000000..c42eceac --- /dev/null +++ b/book/preface_ben.asc @@ -0,0 +1,8 @@ +[preface] +== Voorwoord door Ben Straub + +De eerste editie van dit boek is wat me verslaafd maakte aan Git. Dit was mijn introductie in een manier van software maken die natuurlijker aanvoelde dan alles wat ik daarvoor gezien had. Ik had al een aantal jaren ervaring als ontwikkelaar achter de rug, maar dit boek was mijn reisgids naar een veel interessantere weg dan die waar ik me eerst op bevond. + +Nu, jaren later, lever ik een bijdrage aan een belangrijke Git implementatie, ik ben gaan werken voor het grootste Git hosting bedrijf, en ik heb de wereld rondgereisd om mensen te leren over Git. Toen Scott me vroeg of ik interesse had om aan de tweede uitgave mee te werken, hoefde ik geen seconde na te denken. + +Het was me een groot plezier en een voorrecht om aan dit boek te werken. Ik hoop dat het jou net zoveel zal helpen als het mij gedaan heeft. diff --git a/book/preface.asc b/book/preface_scott.asc similarity index 75% rename from book/preface.asc rename to book/preface_scott.asc index 583b8841..66d1386b 100644 --- a/book/preface.asc +++ b/book/preface_scott.asc @@ -1,10 +1,3 @@ -Pro Git -======= -:doctype: book -:docinfo: -:toc: -:toclevels: 2 - [preface] == Voorwoord door Scott Chacon @@ -37,21 +30,3 @@ De andere grote wijziging sinds de tijd van de laatste publicatie is de ontwikke Het is prachtig om Git in de afgelopen paar jaar te hebben zien groeien van een relatief obscure versiebeheer systeem tot iets wat commerciële versies en open source versiebeheer domineert. Ik ben blij dat Pro Git het zo goed gedaan heeft en dat het in staat is geweest om een van de weinige verkrijgbare technische boeken te zijn die zowel redelijk succesvol als volledig open source is. Ik hoop dat je van deze bijgewerkte versie van Pro Git zult genieten. - -[preface] -== Voorwoord door Ben Straub - -De eerste editie van dit boek is wat me verslaafd maakte aan Git. Dit was mijn introductie in een manier van software maken die natuurlijker aanvoelde dan alles wat ik daarvoor gezien had. Ik had al een aantal jaren ervaring als ontwikkelaar achter de rug, maar dit boek was mijn reisgids naar een veel interessantere weg dan die waar ik me eerst op bevond. - -Nu, jaren later, lever ik een bijdrage aan een belangrijke Git implementatie, ik ben gaan werken voor het grootste Git hosting bedrijf, en ik heb de wereld rondgereisd om mensen te leren over Git. Toen Scott me vroeg of ik interesse had om aan de tweede uitgave mee te werken, hoefde ik geen seconde na te denken. - -Het was me een groot plezier en een voorrecht om aan dit boek te werken. Ik hoop dat het jou net zoveel zal helpen als het mij gedaan heeft. - -[preface] -== Opdrachten - -_Aan mijn vrouw, Becky, zonder wie dit avontuur nooit zou zijn begonnen. — Ben_ - -_Deze uitgave draag ik op aan mijn meisjes. -Aan mijn vrouw Jessica die me al deze jaren heeft gesteund en aan mijn dochter Josephine, -die mij zal ondersteunen als ik te oud ben om te beseffen wat er gebeurt. — Scott_ \ No newline at end of file diff --git a/book/01-introduction/1-introduction.asc b/ch01-introduction.asc similarity index 67% rename from book/01-introduction/1-introduction.asc rename to ch01-introduction.asc index 0865de41..19d4bba4 100644 --- a/book/01-introduction/1-introduction.asc +++ b/ch01-introduction.asc @@ -1,8 +1,9 @@ +[#ch01-introduction] //// Laatst bijgewerkt van progit/progit2 referentie: a113612f //// -[[_getting_started]] +[[r_getting_started]] == Aan de slag In dit hoofdstuk wordt uitgelegd hoe je aan de slag kunt gaan met Git. @@ -12,23 +13,23 @@ We zullen beginnen met wat achtergrondinformatie over versiebeheersystemen te ge Aan het einde van dit hoofdstuk zou je moeten kunnen begrijpen waarom Git er is, waarom je het zou moeten gebruiken en zal je helemaal klaar zijn om er mee aan de slag te gaan. -include::sections/about-version-control.asc[] +include::book/01-introduction/sections/about-version-control.asc[] -include::sections/history.asc[] +include::book/01-introduction/sections/history.asc[] -include::sections/basics.asc[] +include::book/01-introduction/sections/basics.asc[] -include::sections/command-line.asc[] +include::book/01-introduction/sections/command-line.asc[] -include::sections/installing.asc[] +include::book/01-introduction/sections/installing.asc[] -include::sections/first-time-setup.asc[] +include::book/01-introduction/sections/first-time-setup.asc[] -include::sections/help.asc[] +include::book/01-introduction/sections/help.asc[] === Samenvatting Je zou nu een beetje een idee moeten hebben wat Git is en op welke manieren het verschilt van het versiebeheersysteem dat je misschien eerder gebruikte. Je zou nu ook een werkende versie van Git op je systeem moeten hebben dat is ingesteld met jouw identiteit. -Nu is het tijd om een aantal grondbeginselen van Git te gaan leren. \ No newline at end of file +Nu is het tijd om een aantal grondbeginselen van Git te gaan leren. diff --git a/book/02-git-basics/1-git-basics.asc b/ch02-git-basics.asc similarity index 72% rename from book/02-git-basics/1-git-basics.asc rename to ch02-git-basics.asc index 18b29684..386615ca 100644 --- a/book/02-git-basics/1-git-basics.asc +++ b/ch02-git-basics.asc @@ -1,8 +1,9 @@ +[#ch02-git-basics] //// Laatst bijgewerkt van progit/progit2 referentie: a113612f //// -[[_git_basics_chapter]] +[[r_git_basics_chapter]] == Git Basics Als je slechts één hoofdstuk kunt lezen om met Git aan de slag te gaan, dan is deze het. @@ -14,22 +15,22 @@ We laten ook zien hoe je Git kunt instellen zodat het bepaalde bestanden en best vergissingen snel en gemakkelijk ongedaan kunt maken, hoe je de geschiedenis van je project kan doorlopen en wijzigingen tussen commits kunt zien, en hoe je kunt pushen en pullen van en naar repositories. -include::sections/getting-a-repository.asc[] +include::book/02-git-basics/sections/getting-a-repository.asc[] -include::sections/recording-changes.asc[] +include::book/02-git-basics/sections/recording-changes.asc[] -include::sections/viewing-history.asc[] +include::book/02-git-basics/sections/viewing-history.asc[] -include::sections/undoing.asc[] +include::book/02-git-basics/sections/undoing.asc[] -include::sections/remotes.asc[] +include::book/02-git-basics/sections/remotes.asc[] -include::sections/tagging.asc[] +include::book/02-git-basics/sections/tagging.asc[] -include::sections/aliases.asc[] +include::book/02-git-basics/sections/aliases.asc[] === Samenvatting Op dit punt kun je alle basis locale Git operaties doen: een repository creëren of clonen, wijzigingen maken, de wijzigingen stagen en committen en de historie bekijken van alle veranderingen die de repository ondergaan heeft. -Als volgende gaan we de beste eigenschap van Git bekijken: het branching model. \ No newline at end of file +Als volgende gaan we de beste eigenschap van Git bekijken: het branching model. diff --git a/book/03-git-branching/1-git-branching.asc b/ch03-git-branching.asc similarity index 79% rename from book/03-git-branching/1-git-branching.asc rename to ch03-git-branching.asc index bcf0b0e0..83e00c02 100644 --- a/book/03-git-branching/1-git-branching.asc +++ b/ch03-git-branching.asc @@ -1,8 +1,9 @@ +[#ch03-git-branching] //// Laatst bijgewerkt van progit/progit2 referentie: a113612f //// -[[_git_branching]] +[[r_git_branching]] == Branchen in Git (((branches))) @@ -22,17 +23,17 @@ In tegenstelling tot vele andere VCS's, moedigt Git juist een workflow aan waarb Deze eigenschap begrijpen en de techniek beheersen geeft je een krachtig en uniek gereedschap en kan letterlijk de manier waarop je ontwikkelt veranderen. -include::sections/nutshell.asc[] +include::book/03-git-branching/sections/nutshell.asc[] -include::sections/basic-branching-and-merging.asc[] +include::book/03-git-branching/sections/basic-branching-and-merging.asc[] -include::sections/branch-management.asc[] +include::book/03-git-branching/sections/branch-management.asc[] -include::sections/workflows.asc[] +include::book/03-git-branching/sections/workflows.asc[] -include::sections/remote-branches.asc[] +include::book/03-git-branching/sections/remote-branches.asc[] -include::sections/rebasing.asc[] +include::book/03-git-branching/sections/rebasing.asc[] === Samenvatting @@ -42,4 +43,4 @@ Je zou je op je gemak moeten voelen met het maken en omschakelen naar nieuwe bra Je zou ook in staat moeten zijn om je branches te delen door ze naar een gedeelde server te pushen, met anderen op gedeelde branches samen te werken en je branches te rebasen voordat ze gedeeld zijn. In het volgende deel gaan we de materie behandelen wat je nodig gaat hebben om jouw eigen Git repository-hosting -servier op te zetten. \ No newline at end of file +servier op te zetten. diff --git a/book/04-git-server/1-git-server.asc b/ch04-git-server.asc similarity index 84% rename from book/04-git-server/1-git-server.asc rename to ch04-git-server.asc index f20b151e..a6fa4ec7 100644 --- a/book/04-git-server/1-git-server.asc +++ b/ch04-git-server.asc @@ -1,3 +1,4 @@ +[#ch04-git-server] //// Laatst bijgewerkt van progit/progit2 referentie: a113612f //// @@ -32,23 +33,23 @@ Omdat de repository alleen gebruikt wordt als een samenwerkingspunt, is er geen te hebben; het is alleen de Git data. Een kale repository is eenvoudigweg de inhoud van de `.git` directory in je project, en niets meer. -include::sections/protocols.asc[] +include::book/04-git-server/sections/protocols.asc[] -include::sections/git-on-a-server.asc[] +include::book/04-git-server/sections/git-on-a-server.asc[] -include::sections/generating-ssh-key.asc[] +include::book/04-git-server/sections/generating-ssh-key.asc[] -include::sections/setting-up-server.asc[] +include::book/04-git-server/sections/setting-up-server.asc[] -include::sections/git-daemon.asc[] +include::book/04-git-server/sections/git-daemon.asc[] -include::sections/smart-http.asc[] +include::book/04-git-server/sections/smart-http.asc[] -include::sections/gitweb.asc[] +include::book/04-git-server/sections/gitweb.asc[] -include::sections/gitlab.asc[] +include::book/04-git-server/sections/gitlab.asc[] -include::sections/hosted.asc[] +include::book/04-git-server/sections/hosted.asc[] === Samenvatting @@ -61,4 +62,4 @@ Als je je gegevens op een beheerde server plaatst, is het eenvoudig in te stelle wel willen dat je code op de server van een derde opgeslagen is, en sommige organisaties staan dit niet toe. Het zou redelijk eenvoudig moeten zijn om te bepalen welke oplossing of combinatie van oplossingen van toepassing is - op jou en je organisatie. \ No newline at end of file + op jou en je organisatie. diff --git a/book/05-distributed-git/1-distributed-git.asc b/ch05-distributed-git.asc similarity index 82% rename from book/05-distributed-git/1-distributed-git.asc rename to ch05-distributed-git.asc index 677357a7..75e4c031 100644 --- a/book/05-distributed-git/1-distributed-git.asc +++ b/ch05-distributed-git.asc @@ -1,8 +1,9 @@ +[#ch05-distributed-git] //// Laatst bijgewerkt van progit/progit2 referentie: a113612f //// -[[_distributed_git]] +[[r_distributed_git]] == Gedistribueerd Git (((distributed git))) @@ -17,11 +18,11 @@ Dat wil zeggen, je zult leren hoe je succesvol code kunt bijdragen aan een proje waar een aantal ontwikkelaars aan bijdragen. -include::sections/distributed-workflows.asc[] +include::book/05-distributed-git/sections/distributed-workflows.asc[] -include::sections/contributing.asc[] +include::book/05-distributed-git/sections/contributing.asc[] -include::sections/maintaining.asc[] +include::book/05-distributed-git/sections/maintaining.asc[] === Samenvatting @@ -29,4 +30,4 @@ Je zou je nu redelijk op je gemak moeten voelen om aan een project bij te dragen project te beheren of de bijdragen van andere gebruikers te integreren. Gefeliciteerd, je bent nu een effectieve Git ontwikkelaar! In het volgende hoofdstuk zullen we je vertellen hoe de grootste en meest populaire Git hosting service te -gebruiken: GitHub. \ No newline at end of file +gebruiken: GitHub. diff --git a/book/06-github/1-github.asc b/ch06-github.asc similarity index 84% rename from book/06-github/1-github.asc rename to ch06-github.asc index ce9d0ad2..036a8a16 100644 --- a/book/06-github/1-github.asc +++ b/ch06-github.asc @@ -1,8 +1,9 @@ +[#ch06-github] //// Laatst bijgewerkt van progit/progit2 referentie: a113612f //// -[[_github]] +[[r_github]] == GitHub (((GitHub))) @@ -20,7 +21,7 @@ We zullen het inschrijven en het beheren van een account, het maken en gebruiken te maken. Als je niet geïnteresseerd bent in het gebruik van GitHub als host voor je eigen projecten of om samen te werken met -andere projecten die op GitHub zijn gehost, kan je zonder problemen doorgaan naar <<_git_tools>>. +andere projecten die op GitHub zijn gehost, kan je zonder problemen doorgaan naar <>. [WARNING] .Interfaces veranderen @@ -32,15 +33,15 @@ Hopelijk komt het algemene beeld van wat we hier proberen te bereiken nog steeds kunnen bevatten. ==== -include::sections/1-setting-up-account.asc[] +include::book/06-github/sections/1-setting-up-account.asc[] -include::sections/2-contributing.asc[] +include::book/06-github/sections/2-contributing.asc[] -include::sections/3-maintaining.asc[] +include::book/06-github/sections/3-maintaining.asc[] -include::sections/4-managing-organization.asc[] +include::book/06-github/sections/4-managing-organization.asc[] -include::sections/5-scripting.asc[] +include::book/06-github/sections/5-scripting.asc[] === Samenvatting @@ -48,4 +49,4 @@ Je bent nu een GitHub gebruiker. Je weet hoe je een account aanmaakt, een organisatie kunt onderhouden, repositories aanmaken en pushen, hoe je bijdraagt aan projecten van anderen en bijdragen van anderen kunt accepteren. In het volgende hoofdstuk zal je kennismaken met krachtigere instrumenten en tips krijgen hoe met complexe situaties -om te gaan waarna je een echte meester zult zijn in het gebruik van Git. \ No newline at end of file +om te gaan waarna je een echte meester zult zijn in het gebruik van Git. diff --git a/book/07-git-tools/1-git-tools.asc b/ch07-git-tools.asc similarity index 58% rename from book/07-git-tools/1-git-tools.asc rename to ch07-git-tools.asc index b5b8cffc..8adea7aa 100644 --- a/book/07-git-tools/1-git-tools.asc +++ b/ch07-git-tools.asc @@ -1,8 +1,9 @@ +[#ch07-git-tools] //// Laatst bijgewerkt van progit/progit2 referentie: a113612f //// -[[_git_tools]] +[[r_git_tools]] == Git Tools Op dit moment heb je de meeste van de alledaagse commando's en workflows geleerd die je nodig hebt om een Git @@ -13,33 +14,33 @@ Je hebt de basale taken van tracken en committen van bestanden volbracht, en je Nu zal je een aantal erg krachtige dingen die Git kan doen onderzoeken die je niet perse elke dag zult doen maar die je op een gegeven moment wel nodig kunt hebben. -include::sections/revision-selection.asc[] +include::book/07-git-tools/sections/revision-selection.asc[] -include::sections/interactive-staging.asc[] +include::book/07-git-tools/sections/interactive-staging.asc[] -include::sections/stashing-cleaning.asc[] +include::book/07-git-tools/sections/stashing-cleaning.asc[] -include::sections/signing.asc[] +include::book/07-git-tools/sections/signing.asc[] -include::sections/searching.asc[] +include::book/07-git-tools/sections/searching.asc[] -include::sections/rewriting-history.asc[] +include::book/07-git-tools/sections/rewriting-history.asc[] -include::sections/reset.asc[] +include::book/07-git-tools/sections/reset.asc[] -include::sections/advanced-merging.asc[] +include::book/07-git-tools/sections/advanced-merging.asc[] -include::sections/rerere.asc[] +include::book/07-git-tools/sections/rerere.asc[] -include::sections/debugging.asc[] +include::book/07-git-tools/sections/debugging.asc[] -include::sections/submodules.asc[] +include::book/07-git-tools/sections/submodules.asc[] -include::sections/bundling.asc[] +include::book/07-git-tools/sections/bundling.asc[] -include::sections/replace.asc[] +include::book/07-git-tools/sections/replace.asc[] -include::sections/credentials.asc[] +include::book/07-git-tools/sections/credentials.asc[] === Samenvatting @@ -49,4 +50,4 @@ Als je problemen ziet, zou je in staat moeten zijn om eenvoudig uit te vinden we en wie dit gedaan heeft. Als je subprojecten wilt gebruiken in je project, heb je geleerd hoe deze een plaats te geven. Vanaf nu zou je in staat moeten zijn om de meeste dingen in Git te doen die je dagelijks op de command line nodig hebt - en dit met een gemakkelijk gevoel te doen. \ No newline at end of file + en dit met een gemakkelijk gevoel te doen. diff --git a/book/08-customizing-git/1-customizing-git.asc b/ch08-customizing-git.asc similarity index 77% rename from book/08-customizing-git/1-customizing-git.asc rename to ch08-customizing-git.asc index 4077d91b..d558caf8 100644 --- a/book/08-customizing-git/1-customizing-git.asc +++ b/ch08-customizing-git.asc @@ -1,8 +1,9 @@ +[#ch08-customizing-git] //// Laatst bijgewerkt van progit/progit2 referentie: a113612f //// -[[_customizing_git]] +[[r_customizing_git]] == Git aanpassen Tot dusver hebben we de grondbeginselen behandeld van de werking van Git en hoe het te gebruiken, en we hebben een @@ -12,13 +13,13 @@ In dit hoofdstuk, zullen we laten zien hoe je Git op een meer aangepaste manier Met deze gereedschapppen is het eenvoudig om Git te laten werken op de manier waarop jij, je bedrijf of je groep het nodig heeft. -include::sections/config.asc[] +include::book/08-customizing-git/sections/config.asc[] -include::sections/attributes.asc[] +include::book/08-customizing-git/sections/attributes.asc[] -include::sections/hooks.asc[] +include::book/08-customizing-git/sections/hooks.asc[] -include::sections/policy.asc[] +include::book/08-customizing-git/sections/policy.asc[] === Samenvatting @@ -26,4 +27,4 @@ We hebben de meeste van de belangrijkste manieren behandeld waarop je jouw Git w zodat deze jouw workflow en projecten het beste ondersteunt. Je hebt over allerhande soorten configuratie settings kunnen lezen, bestands-gebaseerde attributen en event hooks, en je hebt een voorbeeld van een beleidsbewakende server gebouwd. -Je zou nu in staat moeten zijn om Git in bijna alle soorten workflows die je kunt verzinnen in te passen. \ No newline at end of file +Je zou nu in staat moeten zijn om Git in bijna alle soorten workflows die je kunt verzinnen in te passen. diff --git a/book/09-git-and-other-scms/1-git-and-other-scms.asc b/ch09-git-and-other-scms.asc similarity index 78% rename from book/09-git-and-other-scms/1-git-and-other-scms.asc rename to ch09-git-and-other-scms.asc index 00e8ac80..62cb60ea 100644 --- a/book/09-git-and-other-scms/1-git-and-other-scms.asc +++ b/ch09-git-and-other-scms.asc @@ -1,3 +1,4 @@ +[#ch09-git-and-other-scms] //// Laatst bijgewerkt van progit/progit2 referentie: 6528f318 //// @@ -21,15 +22,15 @@ Git biedt zo'n prettige ervaring voor ontwikkelaars dat veel mensen een manier h Er zijn een aantal van deze adapters, die ``bridges'' worden genoemd, beschikbaar. Ze zullen hier degenen behandelen die je het meest waarschijnlijk in het wild zult tegenkomen. -include::sections/client-svn.asc[] +include::book/09-git-and-other-scms/sections/client-svn.asc[] -include::sections/client-hg.asc[] +include::book/09-git-and-other-scms/sections/client-hg.asc[] -include::sections/client-p4.asc[] +include::book/09-git-and-other-scms/sections/client-p4.asc[] -include::sections/client-tfs.asc[] +include::book/09-git-and-other-scms/sections/client-tfs.asc[] -[[_migrating]] +[[r_migrating]] === Migreren naar Git (((Migreren naar Git))) @@ -41,19 +42,19 @@ Je zult kunnen lezen hoe gegevens uit een aantal van de grote professionele SCM leeuwendeel van de gebruikers vormen die overgaan, en omdat het eenvoudig is om instrumenten van hoge kwaliteit te pakken te krijgen. -include::sections/import-svn.asc[] +include::book/09-git-and-other-scms/sections/import-svn.asc[] -include::sections/import-hg.asc[] +include::book/09-git-and-other-scms/sections/import-hg.asc[] -include::sections/import-p4.asc[] +include::book/09-git-and-other-scms/sections/import-p4.asc[] -include::sections/import-tfs.asc[] +include::book/09-git-and-other-scms/sections/import-tfs.asc[] -include::sections/import-custom.asc[] +include::book/09-git-and-other-scms/sections/import-custom.asc[] === Samenvatting Je zou je op je gemak moeten voelen om Git als een client te gebruiken voor andere versiebeheer systemen, of bijna ieder bestaand repository te importeren in een Git versie zonder gegevens te verliezen. Het volgende hoofdstuk zal het ruwe binnenwerk van Git behandelen, zodat je iedere byte kunt bewerken, als dat nodig - is. \ No newline at end of file + is. diff --git a/book/10-git-internals/1-git-internals.asc b/ch10-git-internals.asc similarity index 84% rename from book/10-git-internals/1-git-internals.asc rename to ch10-git-internals.asc index 6e37d295..bc537364 100644 --- a/book/10-git-internals/1-git-internals.asc +++ b/ch10-git-internals.asc @@ -1,7 +1,8 @@ +[#ch10-git-internals] //// Laatst bijgewerkt van progit/progit2 referentie: a113612f //// -[[_git_internals]] +[[r_git_internals]] == Git Binnenwerk Je bent misschien meteen doorgegaan naar dit hoofdstuk vanuit een eerder hoofdstuk, of je bent misschien hier beland @@ -29,21 +30,21 @@ Het op inhoud-adresseerbare bestandssysteemlaag is ongelofelijk cool, dus we zul behandelen; daarna zullen je vertellen over de transport mechanismen en het taken voor onderhoud van de repository waar je op den duur mee te maken kunt krijgen. -include::sections/plumbing-porcelain.asc[] +include::book/10-git-internals/sections/plumbing-porcelain.asc[] -include::sections/objects.asc[] +include::book/10-git-internals/sections/objects.asc[] -include::sections/refs.asc[] +include::book/10-git-internals/sections/refs.asc[] -include::sections/packfiles.asc[] +include::book/10-git-internals/sections/packfiles.asc[] -include::sections/refspec.asc[] +include::book/10-git-internals/sections/refspec.asc[] -include::sections/transfer-protocols.asc[] +include::book/10-git-internals/sections/transfer-protocols.asc[] -include::sections/maintenance.asc[] +include::book/10-git-internals/sections/maintenance.asc[] -include::sections/environment.asc[] +include::book/10-git-internals/sections/environment.asc[] === Samenvatting @@ -59,4 +60,4 @@ Git als een op inhoud-adresseerbaar bestandssysteem is een zeer krachtig gereeds voor meer dan alleen een versiebeheersysteem. We hopen dat je je pasverworven kennis over het binnenwerk van Git kunt gebruiken om je eigen coole toepassing van deze technologie te implementeren en je meer op je gemak te voelen bij het gebruik van Git op meer geavanceerde - manieren. \ No newline at end of file + manieren. diff --git a/images/2fa-1.png b/images/2fa-1.png new file mode 100644 index 00000000..5abd7437 Binary files /dev/null and b/images/2fa-1.png differ diff --git a/images/account-settings.png b/images/account-settings.png new file mode 100644 index 00000000..ea9ef1b1 Binary files /dev/null and b/images/account-settings.png differ diff --git a/images/advance-master.png b/images/advance-master.png new file mode 100644 index 00000000..c3a7ebe6 Binary files /dev/null and b/images/advance-master.png differ diff --git a/images/advance-testing.png b/images/advance-testing.png new file mode 100644 index 00000000..312e65e1 Binary files /dev/null and b/images/advance-testing.png differ diff --git a/images/areas.png b/images/areas.png new file mode 100644 index 00000000..da98fb03 Binary files /dev/null and b/images/areas.png differ diff --git a/images/avatar-crop.png b/images/avatar-crop.png new file mode 100644 index 00000000..622e05d8 Binary files /dev/null and b/images/avatar-crop.png differ diff --git a/images/basic-branching-1.png b/images/basic-branching-1.png new file mode 100644 index 00000000..acc3866f Binary files /dev/null and b/images/basic-branching-1.png differ diff --git a/images/basic-branching-2.png b/images/basic-branching-2.png new file mode 100644 index 00000000..c3f14914 Binary files /dev/null and b/images/basic-branching-2.png differ diff --git a/images/basic-branching-3.png b/images/basic-branching-3.png new file mode 100644 index 00000000..ebc9ca95 Binary files /dev/null and b/images/basic-branching-3.png differ diff --git a/images/basic-branching-4.png b/images/basic-branching-4.png new file mode 100644 index 00000000..ab8f2228 Binary files /dev/null and b/images/basic-branching-4.png differ diff --git a/images/basic-branching-5.png b/images/basic-branching-5.png new file mode 100644 index 00000000..947133f7 Binary files /dev/null and b/images/basic-branching-5.png differ diff --git a/images/basic-branching-6.png b/images/basic-branching-6.png new file mode 100644 index 00000000..6023d694 Binary files /dev/null and b/images/basic-branching-6.png differ diff --git a/images/basic-merging-1.png b/images/basic-merging-1.png new file mode 100644 index 00000000..e1bcc27f Binary files /dev/null and b/images/basic-merging-1.png differ diff --git a/images/basic-merging-2.png b/images/basic-merging-2.png new file mode 100644 index 00000000..a2438266 Binary files /dev/null and b/images/basic-merging-2.png differ diff --git a/images/basic-rebase-1.png b/images/basic-rebase-1.png new file mode 100644 index 00000000..44ea49e3 Binary files /dev/null and b/images/basic-rebase-1.png differ diff --git a/images/basic-rebase-2.png b/images/basic-rebase-2.png new file mode 100644 index 00000000..c82140cd Binary files /dev/null and b/images/basic-rebase-2.png differ diff --git a/images/basic-rebase-3.png b/images/basic-rebase-3.png new file mode 100644 index 00000000..a1afaef6 Binary files /dev/null and b/images/basic-rebase-3.png differ diff --git a/images/basic-rebase-4.png b/images/basic-rebase-4.png new file mode 100644 index 00000000..e97c1685 Binary files /dev/null and b/images/basic-rebase-4.png differ diff --git a/images/benevolent-dictator.png b/images/benevolent-dictator.png new file mode 100644 index 00000000..aeb47e7c Binary files /dev/null and b/images/benevolent-dictator.png differ diff --git a/images/bitnami.png b/images/bitnami.png new file mode 100644 index 00000000..9852e727 Binary files /dev/null and b/images/bitnami.png differ diff --git a/images/blink-01-start.png b/images/blink-01-start.png new file mode 100644 index 00000000..ccf06e7c Binary files /dev/null and b/images/blink-01-start.png differ diff --git a/images/blink-02-pr.png b/images/blink-02-pr.png new file mode 100644 index 00000000..ec9f08c5 Binary files /dev/null and b/images/blink-02-pr.png differ diff --git a/images/blink-03-pull-request-open.png b/images/blink-03-pull-request-open.png new file mode 100644 index 00000000..442a3294 Binary files /dev/null and b/images/blink-03-pull-request-open.png differ diff --git a/images/blink-04-email.png b/images/blink-04-email.png new file mode 100644 index 00000000..52b61378 Binary files /dev/null and b/images/blink-04-email.png differ diff --git a/images/blink-04-pr-comment.png b/images/blink-04-pr-comment.png new file mode 100644 index 00000000..46402d55 Binary files /dev/null and b/images/blink-04-pr-comment.png differ diff --git a/images/blink-05-general-comment.png b/images/blink-05-general-comment.png new file mode 100644 index 00000000..7cf1205f Binary files /dev/null and b/images/blink-05-general-comment.png differ diff --git a/images/blink-06-final.png b/images/blink-06-final.png new file mode 100644 index 00000000..155a5ef4 Binary files /dev/null and b/images/blink-06-final.png differ diff --git a/images/blink-pull-request-open copy.png b/images/blink-pull-request-open copy.png new file mode 100644 index 00000000..5e40c6d9 Binary files /dev/null and b/images/blink-pull-request-open copy.png differ diff --git a/images/blink-pull-request-open.png b/images/blink-pull-request-open.png new file mode 100644 index 00000000..223144c2 Binary files /dev/null and b/images/blink-pull-request-open.png differ diff --git a/images/branch-and-history.png b/images/branch-and-history.png new file mode 100644 index 00000000..2b4ab17e Binary files /dev/null and b/images/branch-and-history.png differ diff --git a/images/branch_widget_mac.png b/images/branch_widget_mac.png new file mode 100644 index 00000000..3361dca4 Binary files /dev/null and b/images/branch_widget_mac.png differ diff --git a/images/branch_widget_win.png b/images/branch_widget_win.png new file mode 100644 index 00000000..11e2f1c4 Binary files /dev/null and b/images/branch_widget_win.png differ diff --git a/images/centralized.png b/images/centralized.png new file mode 100644 index 00000000..9aa3e902 Binary files /dev/null and b/images/centralized.png differ diff --git a/images/centralized_workflow.png b/images/centralized_workflow.png new file mode 100644 index 00000000..d5d660f5 Binary files /dev/null and b/images/centralized_workflow.png differ diff --git a/images/checkout-master.png b/images/checkout-master.png new file mode 100644 index 00000000..06e98787 Binary files /dev/null and b/images/checkout-master.png differ diff --git a/images/clean.png b/images/clean.png new file mode 100644 index 00000000..ec8fcaa5 Binary files /dev/null and b/images/clean.png differ diff --git a/images/collaborators.png b/images/collaborators.png new file mode 100644 index 00000000..01a480d5 Binary files /dev/null and b/images/collaborators.png differ diff --git a/images/commit-and-tree.png b/images/commit-and-tree.png new file mode 100644 index 00000000..3ddf1cd5 Binary files /dev/null and b/images/commit-and-tree.png differ diff --git a/images/commits-and-parents.png b/images/commits-and-parents.png new file mode 100644 index 00000000..d5639726 Binary files /dev/null and b/images/commits-and-parents.png differ diff --git a/images/data-model-1.png b/images/data-model-1.png new file mode 100644 index 00000000..9331e915 Binary files /dev/null and b/images/data-model-1.png differ diff --git a/images/data-model-2.png b/images/data-model-2.png new file mode 100644 index 00000000..eb1d48e1 Binary files /dev/null and b/images/data-model-2.png differ diff --git a/images/data-model-3.png b/images/data-model-3.png new file mode 100644 index 00000000..317acbb0 Binary files /dev/null and b/images/data-model-3.png differ diff --git a/images/data-model-4.png b/images/data-model-4.png new file mode 100644 index 00000000..38136440 Binary files /dev/null and b/images/data-model-4.png differ diff --git a/images/deltas.png b/images/deltas.png new file mode 100644 index 00000000..47904edb Binary files /dev/null and b/images/deltas.png differ diff --git a/images/distributed.png b/images/distributed.png new file mode 100644 index 00000000..53cfcaeb Binary files /dev/null and b/images/distributed.png differ diff --git a/images/double-dot.png b/images/double-dot.png new file mode 100644 index 00000000..53175c15 Binary files /dev/null and b/images/double-dot.png differ diff --git a/images/egit.png b/images/egit.png new file mode 100644 index 00000000..27a7011a Binary files /dev/null and b/images/egit.png differ diff --git a/images/email-settings.png b/images/email-settings.png new file mode 100644 index 00000000..b073ded3 Binary files /dev/null and b/images/email-settings.png differ diff --git a/images/emoji.png b/images/emoji.png new file mode 100644 index 00000000..42b01fb0 Binary files /dev/null and b/images/emoji.png differ diff --git a/images/forkbutton.png b/images/forkbutton.png new file mode 100644 index 00000000..8ce7ff22 Binary files /dev/null and b/images/forkbutton.png differ diff --git a/images/git-bash.png b/images/git-bash.png new file mode 100644 index 00000000..a0bbfb23 Binary files /dev/null and b/images/git-bash.png differ diff --git a/images/git-diff-check.png b/images/git-diff-check.png new file mode 100644 index 00000000..20161b20 Binary files /dev/null and b/images/git-diff-check.png differ diff --git a/images/git-fusion-boot.png b/images/git-fusion-boot.png new file mode 100644 index 00000000..79272afe Binary files /dev/null and b/images/git-fusion-boot.png differ diff --git a/images/git-fusion-perforce-graph.png b/images/git-fusion-perforce-graph.png new file mode 100644 index 00000000..022293cd Binary files /dev/null and b/images/git-fusion-perforce-graph.png differ diff --git a/images/git-gui.png b/images/git-gui.png new file mode 100644 index 00000000..6d05a94c Binary files /dev/null and b/images/git-gui.png differ diff --git a/images/git-instaweb.png b/images/git-instaweb.png new file mode 100644 index 00000000..c1ba06cf Binary files /dev/null and b/images/git-instaweb.png differ diff --git a/images/git-osx-installer.png b/images/git-osx-installer.png new file mode 100644 index 00000000..8224b4a1 Binary files /dev/null and b/images/git-osx-installer.png differ diff --git a/images/git-tfs-ct.png b/images/git-tfs-ct.png new file mode 100644 index 00000000..d081f272 Binary files /dev/null and b/images/git-tfs-ct.png differ diff --git a/images/github_mac.png b/images/github_mac.png new file mode 100644 index 00000000..5e3aea0d Binary files /dev/null and b/images/github_mac.png differ diff --git a/images/github_win.png b/images/github_win.png new file mode 100644 index 00000000..33134562 Binary files /dev/null and b/images/github_win.png differ diff --git a/images/gitk.png b/images/gitk.png new file mode 100644 index 00000000..16ee0e27 Binary files /dev/null and b/images/gitk.png differ diff --git a/images/gitlab-broadcast.png b/images/gitlab-broadcast.png new file mode 100644 index 00000000..8d3f690d Binary files /dev/null and b/images/gitlab-broadcast.png differ diff --git a/images/gitlab-groups.png b/images/gitlab-groups.png new file mode 100644 index 00000000..6dde95eb Binary files /dev/null and b/images/gitlab-groups.png differ diff --git a/images/gitlab-menu.png b/images/gitlab-menu.png new file mode 100644 index 00000000..868ef912 Binary files /dev/null and b/images/gitlab-menu.png differ diff --git a/images/gitlab-users.png b/images/gitlab-users.png new file mode 100644 index 00000000..ebc226b7 Binary files /dev/null and b/images/gitlab-users.png differ diff --git a/images/head-to-master.png b/images/head-to-master.png new file mode 100644 index 00000000..86c7ae85 Binary files /dev/null and b/images/head-to-master.png differ diff --git a/images/head-to-testing.png b/images/head-to-testing.png new file mode 100644 index 00000000..08352d60 Binary files /dev/null and b/images/head-to-testing.png differ diff --git a/images/hubot.png b/images/hubot.png new file mode 100644 index 00000000..b057f1de Binary files /dev/null and b/images/hubot.png differ diff --git a/images/integration-manager.png b/images/integration-manager.png new file mode 100644 index 00000000..fd0d531e Binary files /dev/null and b/images/integration-manager.png differ diff --git a/images/interesting-rebase-1.png b/images/interesting-rebase-1.png new file mode 100644 index 00000000..ed58a06c Binary files /dev/null and b/images/interesting-rebase-1.png differ diff --git a/images/interesting-rebase-2.png b/images/interesting-rebase-2.png new file mode 100644 index 00000000..95c30681 Binary files /dev/null and b/images/interesting-rebase-2.png differ diff --git a/images/interesting-rebase-3.png b/images/interesting-rebase-3.png new file mode 100644 index 00000000..45aeeca2 Binary files /dev/null and b/images/interesting-rebase-3.png differ diff --git a/images/interesting-rebase-4.png b/images/interesting-rebase-4.png new file mode 100644 index 00000000..44b6ca5f Binary files /dev/null and b/images/interesting-rebase-4.png differ diff --git a/images/interesting-rebase-5.png b/images/interesting-rebase-5.png new file mode 100644 index 00000000..aa0745db Binary files /dev/null and b/images/interesting-rebase-5.png differ diff --git a/images/large-merges-1.png b/images/large-merges-1.png new file mode 100644 index 00000000..d3ee025a Binary files /dev/null and b/images/large-merges-1.png differ diff --git a/images/large-merges-2.png b/images/large-merges-2.png new file mode 100644 index 00000000..2d23e691 Binary files /dev/null and b/images/large-merges-2.png differ diff --git a/images/lifecycle.png b/images/lifecycle.png new file mode 100644 index 00000000..922b02c0 Binary files /dev/null and b/images/lifecycle.png differ diff --git a/images/local.png b/images/local.png new file mode 100644 index 00000000..1779acfb Binary files /dev/null and b/images/local.png differ diff --git a/images/lr-branches-1.png b/images/lr-branches-1.png new file mode 100644 index 00000000..ad7c9c9a Binary files /dev/null and b/images/lr-branches-1.png differ diff --git a/images/lr-branches-2.png b/images/lr-branches-2.png new file mode 100644 index 00000000..8db4bc08 Binary files /dev/null and b/images/lr-branches-2.png differ diff --git a/images/maint-01-email.png b/images/maint-01-email.png new file mode 100644 index 00000000..6de46981 Binary files /dev/null and b/images/maint-01-email.png differ diff --git a/images/maint-02-merge.png b/images/maint-02-merge.png new file mode 100644 index 00000000..62ba7f74 Binary files /dev/null and b/images/maint-02-merge.png differ diff --git a/images/maint-03-email-resp.png b/images/maint-03-email-resp.png new file mode 100644 index 00000000..0d2a096c Binary files /dev/null and b/images/maint-03-email-resp.png differ diff --git a/images/maint-04-target.png b/images/maint-04-target.png new file mode 100644 index 00000000..1a6476fa Binary files /dev/null and b/images/maint-04-target.png differ diff --git a/images/maint-05-mentions.png b/images/maint-05-mentions.png new file mode 100644 index 00000000..4660bbc7 Binary files /dev/null and b/images/maint-05-mentions.png differ diff --git a/images/maint-06-unsubscribe.png b/images/maint-06-unsubscribe.png new file mode 100644 index 00000000..e0689451 Binary files /dev/null and b/images/maint-06-unsubscribe.png differ diff --git a/images/maint-07-notifications.png b/images/maint-07-notifications.png new file mode 100644 index 00000000..a8665093 Binary files /dev/null and b/images/maint-07-notifications.png differ diff --git a/images/maint-08-notifications-page.png b/images/maint-08-notifications-page.png new file mode 100644 index 00000000..3008539b Binary files /dev/null and b/images/maint-08-notifications-page.png differ diff --git a/images/maint-09-contrib.png b/images/maint-09-contrib.png new file mode 100644 index 00000000..bb2a1726 Binary files /dev/null and b/images/maint-09-contrib.png differ diff --git a/images/maint-10-default-branch.png b/images/maint-10-default-branch.png new file mode 100644 index 00000000..4fed6970 Binary files /dev/null and b/images/maint-10-default-branch.png differ diff --git a/images/maint-11-transfer.png b/images/maint-11-transfer.png new file mode 100644 index 00000000..a55e385c Binary files /dev/null and b/images/maint-11-transfer.png differ diff --git a/images/managed-team-1.png b/images/managed-team-1.png new file mode 100644 index 00000000..489b6322 Binary files /dev/null and b/images/managed-team-1.png differ diff --git a/images/managed-team-2.png b/images/managed-team-2.png new file mode 100644 index 00000000..25c2db2b Binary files /dev/null and b/images/managed-team-2.png differ diff --git a/images/managed-team-3.png b/images/managed-team-3.png new file mode 100644 index 00000000..a8a08a70 Binary files /dev/null and b/images/managed-team-3.png differ diff --git a/images/managed-team-flow.png b/images/managed-team-flow.png new file mode 100644 index 00000000..6d83ac4d Binary files /dev/null and b/images/managed-team-flow.png differ diff --git a/images/markdown-01-example.png b/images/markdown-01-example.png new file mode 100644 index 00000000..455fe32a Binary files /dev/null and b/images/markdown-01-example.png differ diff --git a/images/markdown-02-tasks.png b/images/markdown-02-tasks.png new file mode 100644 index 00000000..00cf536e Binary files /dev/null and b/images/markdown-02-tasks.png differ diff --git a/images/markdown-03-task-summary.png b/images/markdown-03-task-summary.png new file mode 100644 index 00000000..8168ed12 Binary files /dev/null and b/images/markdown-03-task-summary.png differ diff --git a/images/markdown-04-fenced-code.png b/images/markdown-04-fenced-code.png new file mode 100644 index 00000000..c9335f5c Binary files /dev/null and b/images/markdown-04-fenced-code.png differ diff --git a/images/markdown-05-quote.png b/images/markdown-05-quote.png new file mode 100644 index 00000000..83f62d39 Binary files /dev/null and b/images/markdown-05-quote.png differ diff --git a/images/markdown-06-emoji-complete.png b/images/markdown-06-emoji-complete.png new file mode 100644 index 00000000..840d7014 Binary files /dev/null and b/images/markdown-06-emoji-complete.png differ diff --git a/images/markdown-07-emoji.png b/images/markdown-07-emoji.png new file mode 100644 index 00000000..e94cc138 Binary files /dev/null and b/images/markdown-07-emoji.png differ diff --git a/images/markdown-08-drag-drop.png b/images/markdown-08-drag-drop.png new file mode 100644 index 00000000..983b9f96 Binary files /dev/null and b/images/markdown-08-drag-drop.png differ diff --git a/images/mentions-01-syntax.png b/images/mentions-01-syntax.png new file mode 100644 index 00000000..87a22a0a Binary files /dev/null and b/images/mentions-01-syntax.png differ diff --git a/images/mentions-02-render.png b/images/mentions-02-render.png new file mode 100644 index 00000000..9cbd2b7b Binary files /dev/null and b/images/mentions-02-render.png differ diff --git a/images/mentions-03-closed.png b/images/mentions-03-closed.png new file mode 100644 index 00000000..202563bd Binary files /dev/null and b/images/mentions-03-closed.png differ diff --git a/images/merging-workflows-1.png b/images/merging-workflows-1.png new file mode 100644 index 00000000..461de6e2 Binary files /dev/null and b/images/merging-workflows-1.png differ diff --git a/images/merging-workflows-2.png b/images/merging-workflows-2.png new file mode 100644 index 00000000..5a0d1fcf Binary files /dev/null and b/images/merging-workflows-2.png differ diff --git a/images/merging-workflows-3.png b/images/merging-workflows-3.png new file mode 100644 index 00000000..f3a32367 Binary files /dev/null and b/images/merging-workflows-3.png differ diff --git a/images/merging-workflows-4 2.png b/images/merging-workflows-4 2.png new file mode 100644 index 00000000..32ae908e Binary files /dev/null and b/images/merging-workflows-4 2.png differ diff --git a/images/merging-workflows-4.png b/images/merging-workflows-4.png new file mode 100644 index 00000000..2ad04c13 Binary files /dev/null and b/images/merging-workflows-4.png differ diff --git a/images/merging-workflows-5.png b/images/merging-workflows-5.png new file mode 100644 index 00000000..151cbd27 Binary files /dev/null and b/images/merging-workflows-5.png differ diff --git a/images/new-repo.png b/images/new-repo.png new file mode 100644 index 00000000..4e4f1623 Binary files /dev/null and b/images/new-repo.png differ diff --git a/images/neworg.png b/images/neworg.png new file mode 100644 index 00000000..a4491c40 Binary files /dev/null and b/images/neworg.png differ diff --git a/images/newrepo.png b/images/newrepo.png new file mode 100644 index 00000000..952cb2fb Binary files /dev/null and b/images/newrepo.png differ diff --git a/images/newrepoform.png b/images/newrepoform.png new file mode 100644 index 00000000..dc49a50b Binary files /dev/null and b/images/newrepoform.png differ diff --git a/images/notifications.png b/images/notifications.png new file mode 100644 index 00000000..31e05951 Binary files /dev/null and b/images/notifications.png differ diff --git a/images/orgs-01-page.png b/images/orgs-01-page.png new file mode 100644 index 00000000..82006b79 Binary files /dev/null and b/images/orgs-01-page.png differ diff --git a/images/orgs-02-teams.png b/images/orgs-02-teams.png new file mode 100644 index 00000000..7183746e Binary files /dev/null and b/images/orgs-02-teams.png differ diff --git a/images/orgs-03-audit.png b/images/orgs-03-audit.png new file mode 100644 index 00000000..3a353af3 Binary files /dev/null and b/images/orgs-03-audit.png differ diff --git a/images/p4merge.png b/images/p4merge.png new file mode 100644 index 00000000..776b74f5 Binary files /dev/null and b/images/p4merge.png differ diff --git a/images/perils-of-rebasing-1.png b/images/perils-of-rebasing-1.png new file mode 100644 index 00000000..013e04bf Binary files /dev/null and b/images/perils-of-rebasing-1.png differ diff --git a/images/perils-of-rebasing-2.png b/images/perils-of-rebasing-2.png new file mode 100644 index 00000000..2c14ccdf Binary files /dev/null and b/images/perils-of-rebasing-2.png differ diff --git a/images/perils-of-rebasing-3.png b/images/perils-of-rebasing-3.png new file mode 100644 index 00000000..505407a0 Binary files /dev/null and b/images/perils-of-rebasing-3.png differ diff --git a/images/perils-of-rebasing-4.png b/images/perils-of-rebasing-4.png new file mode 100644 index 00000000..01b9dbba Binary files /dev/null and b/images/perils-of-rebasing-4.png differ diff --git a/images/perils-of-rebasing-5.png b/images/perils-of-rebasing-5.png new file mode 100644 index 00000000..20a18929 Binary files /dev/null and b/images/perils-of-rebasing-5.png differ diff --git a/images/posh-git.png b/images/posh-git.png new file mode 100644 index 00000000..f66505cf Binary files /dev/null and b/images/posh-git.png differ diff --git a/images/pr-01-fail.png b/images/pr-01-fail.png new file mode 100644 index 00000000..2337656a Binary files /dev/null and b/images/pr-01-fail.png differ diff --git a/images/pr-02-merge-fix.png b/images/pr-02-merge-fix.png new file mode 100644 index 00000000..cc2bafdf Binary files /dev/null and b/images/pr-02-merge-fix.png differ diff --git a/images/public-small-1.png b/images/public-small-1.png new file mode 100644 index 00000000..efcb90d6 Binary files /dev/null and b/images/public-small-1.png differ diff --git a/images/public-small-2.png b/images/public-small-2.png new file mode 100644 index 00000000..9dd40631 Binary files /dev/null and b/images/public-small-2.png differ diff --git a/images/public-small-3.png b/images/public-small-3.png new file mode 100644 index 00000000..fa06f77e Binary files /dev/null and b/images/public-small-3.png differ diff --git a/images/rebasing-1.png b/images/rebasing-1.png new file mode 100644 index 00000000..cd3efa16 Binary files /dev/null and b/images/rebasing-1.png differ diff --git a/images/rebasing-2.png b/images/rebasing-2.png new file mode 100644 index 00000000..55ca410b Binary files /dev/null and b/images/rebasing-2.png differ diff --git a/images/remote-branches-1.png b/images/remote-branches-1.png new file mode 100644 index 00000000..759538f4 Binary files /dev/null and b/images/remote-branches-1.png differ diff --git a/images/remote-branches-2.png b/images/remote-branches-2.png new file mode 100644 index 00000000..14cfe56c Binary files /dev/null and b/images/remote-branches-2.png differ diff --git a/images/remote-branches-3.png b/images/remote-branches-3.png new file mode 100644 index 00000000..6d1993e4 Binary files /dev/null and b/images/remote-branches-3.png differ diff --git a/images/remote-branches-4.png b/images/remote-branches-4.png new file mode 100644 index 00000000..b4183bf1 Binary files /dev/null and b/images/remote-branches-4.png differ diff --git a/images/remote-branches-5.png b/images/remote-branches-5.png new file mode 100644 index 00000000..be228239 Binary files /dev/null and b/images/remote-branches-5.png differ diff --git a/images/replace1.png b/images/replace1.png new file mode 100644 index 00000000..f5a23f7f Binary files /dev/null and b/images/replace1.png differ diff --git a/images/replace2.png b/images/replace2.png new file mode 100644 index 00000000..5b03076c Binary files /dev/null and b/images/replace2.png differ diff --git a/images/replace3.png b/images/replace3.png new file mode 100644 index 00000000..5c3191cd Binary files /dev/null and b/images/replace3.png differ diff --git a/images/replace4.png b/images/replace4.png new file mode 100644 index 00000000..553820c0 Binary files /dev/null and b/images/replace4.png differ diff --git a/images/replace5.png b/images/replace5.png new file mode 100644 index 00000000..41e7cd7b Binary files /dev/null and b/images/replace5.png differ diff --git a/images/reposettingslink.png b/images/reposettingslink.png new file mode 100644 index 00000000..a3f0db44 Binary files /dev/null and b/images/reposettingslink.png differ diff --git a/images/rerere1.png b/images/rerere1.png new file mode 100644 index 00000000..34ab3b7b Binary files /dev/null and b/images/rerere1.png differ diff --git a/images/rerere2.png b/images/rerere2.png new file mode 100644 index 00000000..85dd47f4 Binary files /dev/null and b/images/rerere2.png differ diff --git a/images/rerere3.png b/images/rerere3.png new file mode 100644 index 00000000..b299ac74 Binary files /dev/null and b/images/rerere3.png differ diff --git a/images/reset-checkout.png b/images/reset-checkout.png new file mode 100644 index 00000000..fe036345 Binary files /dev/null and b/images/reset-checkout.png differ diff --git a/images/reset-ex1.png b/images/reset-ex1.png new file mode 100644 index 00000000..2ffd68b2 Binary files /dev/null and b/images/reset-ex1.png differ diff --git a/images/reset-ex2.png b/images/reset-ex2.png new file mode 100644 index 00000000..f4ffd2a7 Binary files /dev/null and b/images/reset-ex2.png differ diff --git a/images/reset-ex3.png b/images/reset-ex3.png new file mode 100644 index 00000000..74274933 Binary files /dev/null and b/images/reset-ex3.png differ diff --git a/images/reset-ex4.png b/images/reset-ex4.png new file mode 100644 index 00000000..3cfbf7fc Binary files /dev/null and b/images/reset-ex4.png differ diff --git a/images/reset-ex5.png b/images/reset-ex5.png new file mode 100644 index 00000000..c21a2534 Binary files /dev/null and b/images/reset-ex5.png differ diff --git a/images/reset-ex6.png b/images/reset-ex6.png new file mode 100644 index 00000000..c64cc38f Binary files /dev/null and b/images/reset-ex6.png differ diff --git a/images/reset-hard.png b/images/reset-hard.png new file mode 100644 index 00000000..a9da7ced Binary files /dev/null and b/images/reset-hard.png differ diff --git a/images/reset-mixed.png b/images/reset-mixed.png new file mode 100644 index 00000000..0266fe51 Binary files /dev/null and b/images/reset-mixed.png differ diff --git a/images/reset-path1.png b/images/reset-path1.png new file mode 100644 index 00000000..1672e02b Binary files /dev/null and b/images/reset-path1.png differ diff --git a/images/reset-path2.png b/images/reset-path2.png new file mode 100644 index 00000000..08308e5e Binary files /dev/null and b/images/reset-path2.png differ diff --git a/images/reset-path3.png b/images/reset-path3.png new file mode 100644 index 00000000..e01f80ae Binary files /dev/null and b/images/reset-path3.png differ diff --git a/images/reset-soft.png b/images/reset-soft.png new file mode 100644 index 00000000..831d9f6f Binary files /dev/null and b/images/reset-soft.png differ diff --git a/images/reset-squash-r1.png b/images/reset-squash-r1.png new file mode 100644 index 00000000..e703a309 Binary files /dev/null and b/images/reset-squash-r1.png differ diff --git a/images/reset-squash-r2.png b/images/reset-squash-r2.png new file mode 100644 index 00000000..8b3bd443 Binary files /dev/null and b/images/reset-squash-r2.png differ diff --git a/images/reset-squash-r3.png b/images/reset-squash-r3.png new file mode 100644 index 00000000..87e44cbe Binary files /dev/null and b/images/reset-squash-r3.png differ diff --git a/images/reset-start.png b/images/reset-start.png new file mode 100644 index 00000000..70b3fb06 Binary files /dev/null and b/images/reset-start.png differ diff --git a/images/reset-workflow.png b/images/reset-workflow.png new file mode 100644 index 00000000..1c01e0d5 Binary files /dev/null and b/images/reset-workflow.png differ diff --git a/images/scripting-01-services.png b/images/scripting-01-services.png new file mode 100644 index 00000000..3af65a12 Binary files /dev/null and b/images/scripting-01-services.png differ diff --git a/images/scripting-02-email-service.png b/images/scripting-02-email-service.png new file mode 100644 index 00000000..b1e59497 Binary files /dev/null and b/images/scripting-02-email-service.png differ diff --git a/images/scripting-03-webhook.png b/images/scripting-03-webhook.png new file mode 100644 index 00000000..bf90bcb7 Binary files /dev/null and b/images/scripting-03-webhook.png differ diff --git a/images/scripting-04-webhook-debug.png b/images/scripting-04-webhook-debug.png new file mode 100644 index 00000000..e91c9e29 Binary files /dev/null and b/images/scripting-04-webhook-debug.png differ diff --git a/images/scripting-05-access-token.png b/images/scripting-05-access-token.png new file mode 100644 index 00000000..f4041423 Binary files /dev/null and b/images/scripting-05-access-token.png differ diff --git a/images/scripting-06-comment.png b/images/scripting-06-comment.png new file mode 100644 index 00000000..7dd27911 Binary files /dev/null and b/images/scripting-06-comment.png differ diff --git a/images/scripting-07-status.png b/images/scripting-07-status.png new file mode 100644 index 00000000..b0dad61e Binary files /dev/null and b/images/scripting-07-status.png differ diff --git a/images/signup.png b/images/signup.png new file mode 100644 index 00000000..73e8d9a6 Binary files /dev/null and b/images/signup.png differ diff --git a/images/small-team-1.png b/images/small-team-1.png new file mode 100644 index 00000000..d13654ec Binary files /dev/null and b/images/small-team-1.png differ diff --git a/images/small-team-2.png b/images/small-team-2.png new file mode 100644 index 00000000..1af62787 Binary files /dev/null and b/images/small-team-2.png differ diff --git a/images/small-team-3.png b/images/small-team-3.png new file mode 100644 index 00000000..3b01de8b Binary files /dev/null and b/images/small-team-3.png differ diff --git a/images/small-team-4.png b/images/small-team-4.png new file mode 100644 index 00000000..b5e8c00b Binary files /dev/null and b/images/small-team-4.png differ diff --git a/images/small-team-5.png b/images/small-team-5.png new file mode 100644 index 00000000..e0215e4f Binary files /dev/null and b/images/small-team-5.png differ diff --git a/images/small-team-6.png b/images/small-team-6.png new file mode 100644 index 00000000..35794441 Binary files /dev/null and b/images/small-team-6.png differ diff --git a/images/small-team-7.png b/images/small-team-7.png new file mode 100644 index 00000000..6bbbc2d8 Binary files /dev/null and b/images/small-team-7.png differ diff --git a/images/small-team-flow.png b/images/small-team-flow.png new file mode 100644 index 00000000..c8589ba6 Binary files /dev/null and b/images/small-team-flow.png differ diff --git a/images/smudge.png b/images/smudge.png new file mode 100644 index 00000000..d86aa05c Binary files /dev/null and b/images/smudge.png differ diff --git a/images/snapshots.png b/images/snapshots.png new file mode 100644 index 00000000..1036a424 Binary files /dev/null and b/images/snapshots.png differ diff --git a/images/ssh-keys.png b/images/ssh-keys.png new file mode 100644 index 00000000..34c0ff88 Binary files /dev/null and b/images/ssh-keys.png differ diff --git a/images/topic-branches-1.png b/images/topic-branches-1.png new file mode 100644 index 00000000..3bdca0dc Binary files /dev/null and b/images/topic-branches-1.png differ diff --git a/images/topic-branches-2.png b/images/topic-branches-2.png new file mode 100644 index 00000000..fe139d99 Binary files /dev/null and b/images/topic-branches-2.png differ diff --git a/images/two-branches.png b/images/two-branches.png new file mode 100644 index 00000000..aa6377a0 Binary files /dev/null and b/images/two-branches.png differ diff --git a/images/undomerge-reset.png b/images/undomerge-reset.png new file mode 100644 index 00000000..3ffcc624 Binary files /dev/null and b/images/undomerge-reset.png differ diff --git a/images/undomerge-revert.png b/images/undomerge-revert.png new file mode 100644 index 00000000..87cd7c93 Binary files /dev/null and b/images/undomerge-revert.png differ diff --git a/images/undomerge-revert2.png b/images/undomerge-revert2.png new file mode 100644 index 00000000..dc5727ea Binary files /dev/null and b/images/undomerge-revert2.png differ diff --git a/images/undomerge-revert3.png b/images/undomerge-revert3.png new file mode 100644 index 00000000..71f94a63 Binary files /dev/null and b/images/undomerge-revert3.png differ diff --git a/images/undomerge-start.png b/images/undomerge-start.png new file mode 100644 index 00000000..518a71d8 Binary files /dev/null and b/images/undomerge-start.png differ diff --git a/images/vs-1.png b/images/vs-1.png new file mode 100644 index 00000000..312cde3b Binary files /dev/null and b/images/vs-1.png differ diff --git a/images/vs-2.png b/images/vs-2.png new file mode 100644 index 00000000..78d404c2 Binary files /dev/null and b/images/vs-2.png differ diff --git a/images/your-profile.png b/images/your-profile.png new file mode 100644 index 00000000..01373f60 Binary files /dev/null and b/images/your-profile.png differ diff --git a/images/zsh-oh-my.png b/images/zsh-oh-my.png new file mode 100644 index 00000000..dd1d4e06 Binary files /dev/null and b/images/zsh-oh-my.png differ diff --git a/images/zsh-prompt.png b/images/zsh-prompt.png new file mode 100644 index 00000000..634a8c5a Binary files /dev/null and b/images/zsh-prompt.png differ diff --git a/index.asc b/index.asc new file mode 100644 index 00000000..2df4a6b1 --- /dev/null +++ b/index.asc @@ -0,0 +1,3 @@ +[#index] +[index] += Index diff --git a/progit.asc b/progit.asc index 96f38f0d..fae19073 100644 --- a/progit.asc +++ b/progit.asc @@ -1,35 +1,51 @@ Pro Git ======= +Scott Chacon; Ben Straub +$$VERSION$$, $$DATE$$ +:lang: nl :doctype: book :docinfo: :toc: :toclevels: 2 +:pdf-page-size: A4 :front-cover-image: image:book/cover.png[width=1050,height=1600] -include::book/preface.asc[] +ifdef::ebook-format[:leveloffset: -1] -include::book/01-introduction/1-introduction.asc[] +include::book/license.asc[] -include::book/02-git-basics/1-git-basics.asc[] +include::book/preface_scott.asc[] -include::book/03-git-branching/1-git-branching.asc[] +include::book/preface_ben.asc[] -include::book/04-git-server/1-git-server.asc[] +include::book/dedication.asc[] -include::book/05-distributed-git/1-distributed-git.asc[] +include::book/introduction.asc[] -include::book/06-github/1-github.asc[] +include::ch01-introduction.asc[] -include::book/07-git-tools/1-git-tools.asc[] +include::ch02-git-basics.asc[] -include::book/08-customizing-git/1-customizing-git.asc[] +include::ch03-git-branching.asc[] -include::book/09-git-and-other-scms/1-git-and-other-scms.asc[] +include::ch04-git-server.asc[] -include::book/10-git-internals/1-git-internals.asc[] +include::ch05-distributed-git.asc[] -include::book/A-git-in-other-environments/1-git-other-environments.asc[] +include::ch06-github.asc[] -include::book/B-embedding-git/1-embedding-git.asc[] +include::ch07-git-tools.asc[] -include::book/C-git-commands/1-git-commands.asc[] +include::ch08-customizing-git.asc[] + +include::ch09-git-and-other-scms.asc[] + +include::ch10-git-internals.asc[] + +include::A-git-in-other-environments.asc[] + +include::B-embedding-git.asc[] + +include::C-git-commands.asc[] + +ifndef::ebook-format[include::index.asc[]]