WebTools Git/ro



Notă: Începând cu FreeCAD v0.17, acest instrument a fost eliminat din Arch Workbench și face parte acum din WebTools Workbench pe care îl puteți instala prin meniul Tools → Addons Manager.

Descriere
Această comandă permite administrarea documentului curent cu GIT. GIT este un sistem puternic de control al versiunilor de fișiere, care poate gestiona diferite versiuni ale fișierelor și să țină evidența modificărilor..

Git este un instrument complex, înainte de a folosi acest instrument să ia în considerare învățarea elementelor de bază, pentru a evita operațiile greșite care pot cauza pierderea datelor. O literatură abundentă despre GIT este disponibilă și este ușor de găsit pe internet.

Limitări curente:


 * Instrumentul încă nu poate crea depozite noi. Trebuie să aveți deja un depozit local existent (FreeCAD va verifica dacă fișierul documentului curent se află în interiorul unui depozit Git)
 * Instrumentul nu poate schimba sau crea ramuri. Trebuie să faceți acest lucru manual cu instrumentele standard Git.

Notă: Pentru a putea să utilizați această comandă pachetul gitpython trebuie să fie instalat pe sistemul dvs. Pe majoritatea distribuțiilor linux, gitpython este disponibil din depozitele standard de software ca  gitpython  sau  python-git .

Cum se folosește

 * 1) Save the current active document
 * 2) Make sure the saved file is inside an existing git repository
 * 3) Select menu Arch -> Utilities ->

Opţiuni



 * Asigurați-vă că Report Window este deschis deoarece mesajele Git vor fi tipărite acolo.
 * Instrumentul Git se va deschide numai dacă fișierul curent este salvat într-un depozit Git. Poate fi într-un subdirector.
 * Butonul  Log va afișa un dialog care prezintă cele mai recente înregistrări din jurnal.
 * Butonul  Refresh  va re-scana depozitul pentru fișierele modificate.
 * Butonul  Diff  va afișa diferențele dintre versiunea curentă a unui fișier selectat și versiunea anterioară stocată în depozit.
 * Butonul Select all va selecta toate fișierele care urmează să fie angajate.
 * Butonul  Commit va angaja fișierele selectate. Asigurați-vă că ați scris un mesaj de comitere care descrie schimbările pe care le comiteți.
 * Butonul Pull va downloada' 'orice modificări noi în depozit de pe telecomanda selectată. Dacă fișierul deschis în prezent în FreeCAD este modificat printr-o tragere, un mesaj de avertizare vă va informa astfel încât să puteți salva din nou fișierul sau să îl salvați în altă parte.
 * Butonul  Push va uploada cel mai recent comitet (e) pe telecomanda selectată.

Abilitarea citirii umane a fișierelor diff for FCStd
FreeCAD Fcstd format de fișier este un format binar bazat pe zip, pentru care Git nu poate produce diferențe corecte. Aceasta înseamnă că nu puteți vedea ce s-a schimbat între o versiune și o altă versiune și că fiecare nouă versiune stocată în repozitoriul Git este o copie completă a fișierului.

Deși a doua problemă nu are în prezent o soluție, prima poate fi rezolvată cu un mic instrument disponibil din codul sursă FreeCAD, numit fcinfo. Poate fi spus lui Git să folosească utilitarul fcinfo pentru a tipări un raport prietenos cu oamenii despre un fișier FCStd și, atunci când este rugat să producă un diff între două fișiere FCStd, va produce o diferență între cele două rapoarte fcinfo. Rețineți că acesta este doar un feedback vizual, o copie completă a fișierului va fi în continuare stocată intern.

Examplu de diff produs cu fcinfo:

Fiecare fișier FreeCAD conține un număr de control SHA1, care se va schimba de fiecare dată când fișierul este salvat, chiar dacă nu s-au schimbat conținutul său. În concluzie fcinfo va tipări întotdeauna ceva, indiferent de schimbarea conținutul său.

Pentru a permite utilizarea fcinfo (numai Linux și Mac - TODO: adăugați instrucțiuni Windows)

* .FCStd diff = fcinfo
 * 1) Salvați fișierul fcinfo undeva în sistem
 * 2) Faceți-l executabil
 * 3) Creați un fișier .gitattributes în depozitul dvs. Git
 * 4) Adăugați următoarea linie în ea: