Skip to content

Commit fe54aff

Browse files
committed
Further proofread chapter 9
1 parent e1fc766 commit fe54aff

File tree

13 files changed

+72
-70
lines changed

13 files changed

+72
-70
lines changed

book/01-introduction/sections/what-is-git.asc

+1-1
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ Te datoteke so povlečene iz stisnjene podatkovne baze v direktoriju Git in dane
9494
Področje priprave je datoteka, v splošnem vsebovana v vašem direktoriju Git, ki shranjuje informacije o tem, kaj bo šlo v vašo naslednjo potrditev.
9595
Njegovo tehnično ime v jeziku Git je »indeks« (angl. _index_), vendar se pogosto imenuje tudi področje priprave podatkov (angl. _staging area_).
9696

97-
Direktorij Git je, kjer Git shranjuje meta podatke in objektno podatkovno bazo za vaš projekt.
97+
Direktorij Git je, kjer Git shranjuje metapodatke in objektno podatkovno bazo za vaš projekt.
9898
To je najpomembnejši del Gita in je, kar se kopira, ko _klonirate_ repozitorij iz drugega računalnika.
9999

100100
Osnovni potek dela Git gre nekako takole:

book/03-git-branching/sections/nutshell.asc

+2-2
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ $ git commit -m 'Initial commit'
1818
----
1919

2020
Ko ustvarite potrditev s pogonom `git commit`, Git preveri kontrolne vsote za vsak poddirektorij (v tem primeru samo vrhnji direktorij projekta) in jih shrani kot drevesni objekt v repozitorij Git.
21-
Git nato ustvari objekt potrditve, ki ima meta podatke in kazalec na vrhnje drevo projekta, da lahko ponovno ustvari posnetek, ko je treba.(((Ukazi Git, commit)))
21+
Git nato ustvari objekt potrditve, ki ima metapodatke in kazalec na vrhnje drevo projekta, da lahko ponovno ustvari posnetek, ko je treba.(((Ukazi Git, commit)))
2222

23-
Vaš repozitorij Git sedaj vsebuje pet objektov: tri _blobe_ (vsak predstavlja vsebino ene izmed treh datotek), eno _drevo_, ki izpisuje vsebino direktorija in določa, katera imena datotek so shranjena kot blobi, in eno _potrditev_ s kazalcem na to vrhnje drevo ter vse meta podatke potrditve.
23+
Vaš repozitorij Git sedaj vsebuje pet objektov: tri _blobe_ (vsak predstavlja vsebino ene izmed treh datotek), eno _drevo_, ki izpisuje vsebino direktorija in določa, katera imena datotek so shranjena kot blobi, in eno _potrditev_ s kazalcem na to vrhnje drevo ter vse metapodatke potrditve.
2424

2525
.Potrditev in njeno drevo
2626
image::images/commit-and-tree.png[Potrditev in njeno drevo]

book/09-git-and-other-scms/sections/client-hg.asc

+1-1
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ $ git log --oneline --graph --decorate
6262
----
6363

6464
Opazili boste, da delo z Mercurialovim repozitorijem uporablja standardni ukaz `git clone`.
65-
To je zato, ker git-remote-hg deluje na precej nizki ravni, uporabljajoč podoben mehanizem, kot je implementacija Gitovega protokola HTTP/S (oddaljeni pomočniki).
65+
To je zato, ker git-remote-hg deluje na precej nizki ravni in uporablja podoben mehanizem, kot je implementacija Gitovega protokola HTTP/S (oddaljeni pomočniki).
6666
Ker sta Git in Mercurial zasnovana tako, da ima vsak odjemalec polno kopijo zgodovine repozitorija, ta ukaz naredi celotno kopijo, vključno z vso zgodovino projekta, in to relativno hitro.
6767

6868
Ukaz `log` prikaže dve spremembi, najnovejša od teh je označena z velikim številom referenc.

book/09-git-and-other-scms/sections/client-p4.asc

+24-24
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Druga možnost pa je git-p4, most na strani odjemalca, ki vam omogoča uporabo G
1717
(((Perforce, Git Fusion)))
1818
Perforce zagotavlja izdelek, imenovan Git Fusion (dostopen na https://www.perforce.com/git-fusion[^]), ki sinhronizira strežnik Perforce z repozitoriji Git na strežniški strani.
1919

20-
====== Setting Up
20+
====== Nastavitev
2121

2222
Za svoje primere bomo uporabili najlažjo namestitveno metodo Git Fusion in sicer prenos virtualne naprave, ki poganja prikriti proces Perforce in Git Fusion.
2323
Sliko virtualne naprave lahko dobite na https://www.perforce.com/downloads/Perforce/20-User[^] in ko se prenos konča, ga uvozite v svoj najljubši program za virtualizacijo (uporabili bomo VirtualBox).
@@ -146,7 +146,7 @@ view = //depot/Talkhouse/main-dev/... ...
146146

147147
To je preslikava med vejami Perforce in vejami Git.
148148
Odsek se lahko imenuje poljubno, dokler je ime edinstveno.
149-
`git-branch-name` omogoča pretvorbo depot poti, ki bi bil pod Gitom neroden, v bolj prijazno ime.
149+
`git-branch-name` omogoča pretvorbo poti depoja (angl. _depot_) v bolj prijazno ime, saj bi bilo pod Gitom nerodno.
150150
Nastavitev `view` nadzoruje, kako so datoteke iz Perforce preslikane v repozitorij Git, pri čemer se uporablja standardna sintaksa preslikave pogledov.
151151
Določite lahko več preslikav kot v tem primeru:
152152

@@ -161,7 +161,7 @@ view = //depot/project1/main/... project1/...
161161
Tako lahko, če običajna preslikava delovnega prostora vključuje spremembe v strukturi map, to replicirate z repozitorijem Git.
162162

163163
Zadnja datoteka, o kateri bomo razpravljali, je `users/p4gf_usermap`, ki preslika uporabnike Perforce v uporabnike Git, in ki je morda sploh ne boste potrebovali.
164-
Pri pretvorbi iz nabora sprememb Perforce v potrditev Git, je privzeto obnašanje Git Fusiona, da poišče uporabnika Perforce in uporabi tam shranjen e-poštni naslov in polno ime za polje avtorja/izvajalca v Gitu.
164+
Pri pretvorbi iz nabora sprememb Perforce v potrditev Git, je privzeto obnašanje Git Fusiona, da poišče uporabnika Perforce in uporabi tam shranjen e-poštni naslov in polno ime za polje avtorja/potrjevalca v Gitu.
165165
Pri pretvorbi v drugo smer pa privzeto poišče uporabnika Perforce z e-poštnim naslovom, shranjenim v polju avtorja potrditve Git, in pošlje nabor sprememb kot tega uporabnika (s primernimi dovoljenji).
166166
V večini primerov bo ta način obnašanja povsem dovolj, vendar upoštevajte naslednjo preslikovalno datoteko:
167167

@@ -286,12 +286,12 @@ To https://10.0.1.254/Jam
286286
----
287287

288288
Git misli, da je to delovalo.
289-
Poglejmo zgodovino datoteke `README` iz zornega kota Perfocea z uporabo lastnosti revizijskega grafa `p4v`:
289+
Poglejmo zgodovino datoteke `README` iz zornega kota Perforca z uporabo lastnosti revizijskega grafa `p4v`:
290290

291291
.Revizijski graf Perforce, ki izhaja iz potiskanja Git
292292
image::images/git-fusion-perforce-graph.png["Revizijski graf Perforce, ki izhaja iz potiskanja Git"]
293293

294-
Če tega pogleda še niste videli, se vam lahko zdi zmedeno, toda prikazuje iste zasnove kot grafični prikazovalnik zgodovine Gita.
294+
Če tega pogleda še niste videli, se vam lahko zdi zmeden, toda prikazuje iste zasnove kot grafični prikazovalnik zgodovine Gita.
295295
Gledamo zgodovino datoteke `README`, zato nam drevesna struktura v zgornjem levem kotu prikazuje samo to datoteko, ki se pojavlja v različnih vejah.
296296
Na zgornjem desnem delu imamo vizualni graf, kako so povezane različne različice datoteke, in celostni pogled na ta graf je na spodnjem desnem delu.
297297
Preostanek prikaza je namenjen podrobnostim za izbrano revizijo (v tem primeru `2`).
@@ -300,7 +300,7 @@ Ena stvar, ki jo je treba opaziti, je, da se graf zdi povsem enak kot v Gitovi z
300300
Perforce ni imel imenovane veje, kjer bi shranil potrditvi `1` in `2`, zato je ustvaril vejo »anonymous« v imeniku `.git-fusion`.
301301
To se bo zgodilo tudi za imenovane veje Git, ki se ne ujemajo z imenovano vejo Perforce (kasneje pa jih lahko preslikate na vejo Perforce z uporabo konfiguracijske datoteke).
302302

303-
Večina tega se zgodi za zavesami, vendar končni rezultat je, da lahko ena oseba v ekipi uporablja Git, druga pa lahko Perfoce in nobena izmed njiju bo vedela o izbiri drug drugega.
303+
Večina tega se zgodi za zavesami, vendar končni rezultat je, da lahko ena oseba v ekipi uporablja Git, druga pa lahko Perforce in nobena izmed njiju bo vedela o izbiri drug drugega.
304304

305305
====== Povzetek Git-Fusion
306306

@@ -318,11 +318,11 @@ Lahko celo uporabite podmodule Git (čeprav bodo za uporabnike Perforce videti
318318
(((Ukazi Git, p4)))
319319
Git-p4 je most med Gitom in Perforceom v dveh smereh.
320320
Deluje v celoti znotraj vašega repozitorija Git, zato ne boste potrebovali nobene vrste dostopa do strežnika Perforce (razen seveda uporabniških poverilnic).
321-
Git-p4 ni tako prilagodljiva ali popolna rešitev kot Git Fusion, vendar vam omogoča, da večino tega, kar bi radi storili, izvedete brez poseganja v okolje strežnika.
321+
Git-p4 ni tako prilagodljiva ali popolna rešitev tako kot Git Fusion, vendar vam omogoča, da večino tega, kar bi radi storili, izvedete brez poseganja v okolje strežnika.
322322

323323
[NOTE]
324324
======
325-
Potrebovali boste orodje `p4` nekje v vaši poti `PATH`, da boste lahko delali z git-p4.
325+
Da boste lahko delali z git-p4, boste potrebovali orodje `p4` nekje v vaši poti `PATH`.
326326
V času tega pisanja je prosto dostopno na https://www.perforce.com/downloads/Perforce/20-User[^].
327327
======
328328

@@ -350,7 +350,7 @@ Initialized empty Git repository in /private/tmp/www-shallow/.git/
350350
Doing initial import of //depot/www/live/ from revision #head into refs/remotes/p4/master
351351
----
352352

353-
To ustvari »površinski« klon v izrazoslovju Git; uvozimo samo najnovejšo revizijo Perforce v Git; spomnimo se, da Perforce ni zasnovan tako, da bi vsakemu uporabniku zagotovil vsako revizijo.
353+
To ustvari »površinski« (angl. _shallow_) klon v izrazoslovju Git; v Git uvozimo samo najnovejšo revizijo Perforce; spomnimo se, da Perforce ni zasnovan tako, da bi vsakemu uporabniku zagotovil vsako revizijo.
354354
To je dovolj za uporabo Gita kot odjemalca Perforce, vendar za druge namene ni dovolj.
355355

356356
Ko je postopek končan, imamo popolnoma funkcionalni repozitorij Git:
@@ -406,8 +406,8 @@ $ git log --oneline --all --graph --decorate
406406
----
407407

408408
Videti je, da sta se različna razvoja `master` in `p4/master` razšla.
409-
Perforceov sistem razvejanja ni _nič_ podoben Gitovemu, zato oddaja potrditev združitev nima smisla.
410-
Git-p4 priporoča, da pred oddajo ponovno bazirate svoje potrditve, za to pa ima celo pripravljeno bližnjico:
409+
Perforceov sistem razvejanja ni _nič_ podoben Gitovemu, zato predložitev potrditev združitev nima smisla.
410+
Git-p4 priporoča, da pred predložitvijo ponovno bazirate svoje potrditve, za to pa ima celo pripravljeno bližnjico:
411411

412412
[source,console]
413413
----
@@ -523,7 +523,7 @@ $ git log --oneline --all --graph --decorate
523523
Rezultat je tak, kot da bi pravkar izvedli `git push`, kar je najbližja analogija temu, kar se je dejansko zgodilo.
524524

525525
Upoštevajte, da se med tem postopkom vsaka potrditev Git pretvori v nabor sprememb Perforce; če jih želite stisniti v en sam nabor sprememb, to lahko storite s pomočjo interaktivnega zaslona ponovnega baziranja pred zagonom `git p4 submit`.
526-
Poleg tega bodite pozorni na to, da se zgoščene vrednosti SHA-1 vseh potrditev, ki so bile oddane kot nabori sprememb, spremenijo; to je zato, ker git-p4 dodaja vrstico na konec vsake pretvorjene potrditve:
526+
Poleg tega bodite pozorni na to, da se zgoščene vrednosti SHA-1 vseh potrditev, ki so bile predložene kot nabori sprememb, spremenijo; to je zato, ker git-p4 dodaja vrstico na konec vsake pretvorjene potrditve:
527527

528528
[source,console?prompt=$]
529529
----
@@ -558,8 +558,8 @@ $ git log --oneline --all --graph --decorate
558558
----
559559

560560
Zgodovina Git in Perforce se začneta razhajati po potrditvi `775a46f`.
561-
Na Git strani imamo dve potrditvi, nato potrditev združitve z glavo Perforca in še eno potrditev.
562-
Poskusimo jih zdaj predložiti na stran Perforce na vrh enega samega nabora spremembe.
561+
Na Gitovi strani imamo dve potrditvi, nato potrditev združitve z glavo Perforca in še eno potrditev.
562+
Poskusimo jih zdaj predložiti (angl. _submit_) na stran Perforce na vrh enega samega nabora spremembe.
563563
Poglejmo, kaj bi se zgodilo, če bi poskusili predložiti zdaj:
564564

565565
[source,console]
@@ -573,7 +573,7 @@ Would apply
573573
3be6fd8 Correct email address
574574
----
575575

576-
Zastavica `-n` je kratka oblika za `--dry-run`, ki poskusi poročati, kaj bi se zgodilo, če bi ukaz za oddajo dejansko tekel.
576+
Zastavica `-n` je kratka oblika za `--dry-run`, ki poskusi poročati, kaj bi se zgodilo, če bi ukaz za predložitev dejansko tekel.
577577
V tem primeru se zdi, da bi ustvarili tri spremembe Perforce, ki se ujemajo s tremi potrditvami nezdružitev, ki še ne obstajajo na strežniku Perforce.
578578
To se zdi točno tisto, kar želimo, torej poglejmo, kako se izkaže:
579579

@@ -592,15 +592,15 @@ $ git log --oneline --all --graph --decorate
592592
* 70eaf78 Initial import of //depot/www/live/ from the state at revision #head
593593
----
594594

595-
Naša zgodovina je postala linearna, tako kot bi bilo po ponovnem baziranju pred oddajo (kar je dejansko tudi res).
595+
Naša zgodovina je postala linearna, tako kot bi bilo po ponovnem baziranju pred predložitvijo (kar je dejansko tudi res).
596596
To pomeni, da lahko ustvarjate, delate, zavržete in združujete veje na strani Git, ne da bi se bali, da bo vaša zgodovina na kakršenkoli način postala nezdružljiva s Perforceom.
597597
Če lahko ponovno bazirate, lahko prispevate k strežniku Perforce.
598598

599599
[[_git_p4_branches]]
600600
====== Veje
601601

602-
Če ima vaš projekt v Perforcu več vej, še niste obupali; git-p4 lahko to obdela na način, ki se zdi kot Git.
603-
Recimo, da je vaš depo Perforce urejen takole:
602+
Če ima vaš projekt v Perforcu več vej, imate srečo; git-p4 lahko to obdela na način, ki se zdi kot Git.
603+
Recimo, da je vaš depo (angl. _depot_) Perforce urejen takole:
604604

605605
[source]
606606
----
@@ -638,7 +638,7 @@ $ cd project; git log --oneline --all --graph --decorate
638638
* 2b83451 Project init
639639
----
640640

641-
Opazite »@all« določevalec v poti depoja; to pove git-p4, naj ne klonira samo najnovejšega nabora sprememb za to poddrevo, temveč celoten nabor sprememb, ki so se kdaj koli dotaknile teh poti.
641+
Opazite določevalec »@all« v poti depoja; to pove git-p4, naj ne klonira samo najnovejšega nabora sprememb za to poddrevo, temveč celoten nabor sprememb, ki so se kdaj koli dotaknile teh poti.
642642
To je bližje zasnovi kloniranja v Gitu, vendar lahko pri delu na projektu z dolgo zgodovino to traja nekaj časa.
643643

644644
Zastavica `--detect-branches` pove git-p4, naj uporabi specifikacije vej Perforce za preslikavo vej na reference Git.
@@ -656,16 +656,16 @@ $ git clone --detect-branches //depot/project@all .
656656
Nastavljanje konfiguracijske spremenljivke `git-p4.branchList` na `main:dev` pove git-p4, da sta `main` in `dev` obe veji in da je druga veja potomec prve.
657657

658658
Če zdaj naredimo `git checkout -b dev p4/project/dev` in naredimo nekaj potrditev, bo git-p4 dovolj pameten, da bo pravilno ciljal na pravo vejo, ko bomo izvedli `git p4 submit`.
659-
Na žalost git-p4 ne more mešati plitvih klonov in več vej; če imate ogromen projekt in želite delati na več kot eni veji, boste morali `git p4 clone` izvesti enkrat za vsako vejo, v katero želite oddati.
659+
Na žalost git-p4 ne more mešati površinskih klonov in več vej; če imate ogromen projekt in želite delati na več kot eni veji, boste morali `git p4 clone` izvesti enkrat za vsako vejo, v katero želite predložiti.
660660

661661
Za ustvarjanje ali integracijo vej boste morali uporabiti odjemalca Perforce.
662-
Git-p4 lahko samo sinhronizira in odda obstoječe veje in to lahko stori samo po eno linearno spremembo hkrati.
663-
Če združite dve veji v Git in poskušate oddati novo zbirko sprememb, bo zabeleženo samo nekaj sprememb datotek; izgubljeni bodo metapodatki o tem, katere veje so vključene v integracijo.
662+
Git-p4 lahko samo sinhronizira in predloži obstoječe veje in to lahko stori samo po eno linearno spremembo hkrati.
663+
Če združite dve veji v Git in poskušate predložiti novo zbirko sprememb, bo zabeleženo samo nekaj sprememb datotek; izgubljeni bodo metapodatki o tem, katere veje so vključene v integracijo.
664664

665665
===== Povzetek Gita in Perforca
666666

667-
Git-p4 omogoča uporabo poteka dela Git s strežnikom Perforce in je zelo učinkovit pri tem.
667+
Git-p4 omogoča uporabo poteka dela Git s strežnikom Perforce in je pri tem zelo učinkovit.
668668
Vendar pa je pomembno vedeti, da je Perforce odgovoren za vir in da uporabljate Git le lokalno.
669-
Bodite previdni pri deljenju potrditev Git; če imate oddaljeni repozitorij, ki ga uporabljajo druge osebe, ne potiskajte nobenih potrditev, ki še niso bile oddane na strežnik Perforce.
669+
Bodite previdni pri deljenju potrditev Git; če imate oddaljeni repozitorij, ki ga uporabljajo druge osebe, ne potiskajte nobenih potrditev, ki še niso bile predložene na strežnik Perforce.
670670

671671
Če želite prosto mešati uporabo Perforce in Git kot odjemalcev za nadzor izvorne kode, in če lahko prepričate upravitelja strežnika, da ga namesti, lahko uporabite Git Fusion, ki omogoča uporabo Git kot odjemalca za strežnik Perforce.

0 commit comments

Comments
 (0)