FreeCAD-Doc/localwiki/Arch_Git-it.html
2018-07-19 18:47:02 -05:00

144 lines
10 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<html><head><title>Arch Git/it</title><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><link type='text/css' href='wiki.css' rel='stylesheet'></head><body><h1>Arch Git/it</h1></div>
<div id="mw-content-text" lang="it" dir="ltr" class="mw-content-ltr"><hr/><div class="mw-parser-output"><table class="fcinfobox wikitable ct" >
<tr>
<td class="ctTitle">
<h3><span class="mw-headline" id="Arch_Git"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Arch_Git.png" class="image"><img alt="Arch Git.png" src="32px-Arch_Git.png" width="32" height="32" srcset="/wiki/images/thumb/e/e3/Arch_Git.png/48px-Arch_Git.png 1.5x, /wiki/images/thumb/e/e3/Arch_Git.png/64px-Arch_Git.png 2x" /></a> Arch Git</span></h3>
</td></tr>
<tr>
<th class="ctOdd">Posizione nel menu
</th></tr>
<tr>
<td class="ctEven">Arch → Utilità → Git
</td></tr>
<tr>
<th class="ctOdd">Ambiente
</th></tr>
<tr>
<td class="ctEven"><a href="https://www.freecadweb.org/wiki/index.php?title=Arch_Module/it" title="Arch Module/it">Arch</a>
</td></tr>
<tr>
<th class="ctOdd">Avvio veloce
</th></tr>
<tr>
<td class="ctEven">
</td></tr>
<tr>
<th class="ctOdd">Vedere anche
</th></tr>
<tr>
<td class="ctEven">
</td></tr>
<tr>
<td class="ctToc"><br /><div id="toc" class="toc"><div class="toctitle"><h2>Contents</h2></div>
<ul>
<li class="toclevel-1"><a href="#Arch_Git"><span class="tocnumber">1</span> <span class="toctext">Arch Git</span></a></li>
<li class="toclevel-1 tocsection-1"><a href="#Descrizione"><span class="tocnumber">2</span> <span class="toctext">Descrizione</span></a></li>
<li class="toclevel-1 tocsection-2"><a href="#Utilizzo"><span class="tocnumber">3</span> <span class="toctext">Utilizzo</span></a></li>
<li class="toclevel-1 tocsection-3"><a href="#Opzioni"><span class="tocnumber">4</span> <span class="toctext">Opzioni</span></a></li>
<li class="toclevel-1 tocsection-4"><a href="#Attivare_la_leggibilit.C3.A0_delle_differenze_per_i_file_FCStd"><span class="tocnumber">5</span> <span class="toctext">Attivare la leggibilità delle differenze per i file FCStd</span></a></li>
</ul>
</div>
</td></tr></table>
<p><br />
</p><p><b>Nota:</b> A partire da FreeCAD v0.17, questo strumento è stato rimosso dall'ambiente Arch e ora fa parte dell'ambiente esterno Webtools che è possibile installare tramite il menu Strumenti -&gt; Addons Manager
</p>
<h2><span class="mw-headline" id="Descrizione">Descrizione</span></h2>
<p>Questo comando consente di eseguire il commit del documento attivo a un repository <a rel="nofollow" class="external text" href="https://en.wikipedia.org/wiki/Git_%28software%29">GIT</a>. GIT è un potente sistema di controllo di versione del file, è in grado di gestire diverse versioni dei file e di conservare la traccia delle modifiche.
</p><p>Git è uno strumento complesso, prima di utilizzare questo strumento considerare di imparare le sue basi, al fine di evitare operazioni errate che possono causare la perdita di dati. Su internet è disponibile e facile da trovare una abbondante letteratura su GIT.
</p><p>Attuali limitazioni:
</p>
<ul><li> Lo strumento non è ancora in grado di creare dei nuovi repository. È necessario disporre di un repository locale esistente già creato (FreeCAD controllerà se il file del documento corrente è all'interno di un repository Git)</li>
<li> Lo strumento non può modificare o creare rami. È necessario farlo manualmente con gli strumenti standard di Git.</li></ul>
<p><b>Note:</b> Per essere in grado di utilizzare questo comando, sul sistema deve essere installato il pacchetto <a rel="nofollow" class="external text" href="https://github.com/gitpython-developers/GitPython">gitpython</a>. Sulla maggior parte delle distribuzioni Linux, gitpython è disponibile nei repository software standard come <i>gitpython</i> o <i>python-git</i>.
</p>
<h2><span class="mw-headline" id="Utilizzo">Utilizzo</span></h2>
<ol><li> Salvare il documento attivo corrente</li>
<li> Assicurarsi che il file salvato è già parte di un repository git</li>
<li> Selezionare il menu Arch -&gt; Utilità -&gt; <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Arch_CommitGit.png" class="image"><img alt="Arch CommitGit.png" src="16px-Arch_CommitGit.png" width="16" height="16" srcset="/wiki/images/thumb/f/ff/Arch_CommitGit.png/24px-Arch_CommitGit.png 1.5x, /wiki/images/thumb/f/ff/Arch_CommitGit.png/32px-Arch_CommitGit.png 2x" /></a> <a class="mw-selflink selflink">Git</a></span></li></ol>
<h2><span class="mw-headline" id="Opzioni">Opzioni</span></h2>
<div class="floatright"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Arch_Git_panel.jpg" class="image"><img alt="Arch Git panel.jpg" src="Arch_Git_panel.jpg" width="259" height="667" /></a></div>
<ul><li> Assicurarsi che il pannello <b>Report</b> sia aperto in modo che i messaggi di Git possano essere stampati al suo interno.</li>
<li> Lo strumento Git si apre solo se il file corrente è salvato all'interno di un repository Git. Può essere in una sottodirectory.</li>
<li> Il pulsante <b>Log</b> apre una finestra di dialogo che mostra i log (le voci di registro) più recenti.</li>
<li> Il pulsante <b>Refresh</b> esegue una nuova scansione del repository per individuare i file modificati.</li>
<li> Il pulsante <b>Diff</b> mostra le differenze tra la versione corrente di un file selezionato e la versione precedente memorizzata nel repository.</li>
<li> Il pulsante <b>Select all</b> seleziona tutti i file di cui fare il commit.</li>
<li> Il pulsante <b>Commit</b> esegue il commit dei file selezionati. Assicurarsi di scrivere un messaggio di commit che descrive le modifiche che si stanno commettendo.</li>
<li> Il pulsante <b>Pull</b> scarica le eventuali nuove modifiche nel repository locale da quello remoto selezionato. Se il file attualmente aperto in FreeCAD è stato modificato da un <i>Pull</i>, un messaggio di avviso informa l'utente in modo che egli possa salvare nuovamente il file o salvarlo altrove.</li>
<li> Il pulsante <b>Push</b> carica il proprio ultimo commit (s) nel repository remoto selezionato.</li></ul>
<h2><span class="mw-headline" id="Attivare_la_leggibilit.C3.A0_delle_differenze_per_i_file_FCStd">Attivare la leggibilità delle differenze per i file FCStd</span></h2>
<p>Il <a href="https://www.freecadweb.org/wiki/index.php?title=Fcstd_file_format/it" class="mw-redirect" title="Fcstd file format/it">formato dei file Fcstd</a> di FreeCAD è un formato binario basato su zip, per il quale Git non può produrre differenze corrette. Ciò significa che non si può vedere cosa è cambiato tra una versione e l'altra, e anche che ogni nuova versione memorizzata nel repository Git è una copia completa del file.
</p><p>Anche se il secondo problema attualmente non ha una soluzione, il primo può essere risolto con un piccolo strumento disponibile nel codice sorgente di FreeCAD, chiamato <a rel="nofollow" class="external text" href="https://github.com/FreeCAD/FreeCAD/blob/master/src/Tools/fcinfo">fcinfo</a>. A Git può essere ordinato di utilizzare l'utilità fcinfo per stampare un rapporto human-friendly (leggibile dalle persone) di un file FCStd, e, quando gli viene chiesto di produrre un differenza tra due file FCStd, produce invece un diff tra i due rapporti fcinfo. Notare che questo è solo un feedback visivo, una copia completa del file rimane ancora memorizzata internamente.
</p><p>Esempio di una differenza prodotta con fcinfo:
</p>
<pre>diff --git a/testhouse.FcStd b/testhouse.FcStd
index 08077b6..985b1d8 100644
--- a/testhouse.FcStd
+++ b/testhouse.FcStd
@@ -1,26 +1,25 @@
-Document: /tmp/43un09_testhouse.FcStd (442K)
- SHA1: 67c1985a45d93cba57d5bf44490897aba460100d
+Document: /tmp/zfXoDd_testhouse.FcStd (370K)
+ SHA1: db1cb5fca18af7bfdca849028f40550df4d845cb
Comment&#160;: This is a test house to showcase FreeCAD's BIM worflow and IFC export capabilities
Company&#160;: uncreated.net
CreatedBy&#160;: Yorik van Havre
CreationDate&#160;: Fri May 9 12:05:54 2014
FileVersion&#160;: 1
Id&#160;:
- Label&#160;: testhouse
- LastModifiedBy&#160;: Yorik van Havre
- LastModifiedDate&#160;: 2016-06-28T17:05:57-03:00
+ Label&#160;: testhouse2
+ LastModifiedBy&#160;: Yorik van Havre
+ LastModifiedDate&#160;: Sat Sep 13 20:46:36 2014
+
License&#160;: CC-BY 3.0
LicenseURL&#160;: http://creativecommons.org/licenses/by/3.0/
- ProgramVersion&#160;: 0.17R7800 (Git)
- TipName&#160;:
+ ProgramVersion&#160;: 0.15R3989 (Git)
Uid&#160;: 67e62d8a-6674-4358-92fe-615443be887a
- Objects: (231)
+ Objects: (221)
Annotation&#160;: Drawing::FeatureViewAnnotation
Annotation001&#160;: Drawing::FeatureViewAnnotation
Annotation002&#160;: Drawing::FeatureViewAnnotation
Annotation003&#160;: Drawing::FeatureViewAnnotation
- Annotation004&#160;: Drawing::FeatureViewAnnotation
- Annotation005&#160;: Drawing::FeatureViewAnnotation
Array&#160;: Part::FeaturePython (9K)
Box&#160;: Part::Box (2K)
Building&#160;: App::DocumentObjectGroupPython
@@ -110,7 +109,7 @@ Document: /tmp/43un09_testhouse.FcStd (442K)
Floor&#160;: App::DocumentObjectGroupPython
Floor001&#160;: App::DocumentObjectGroupPython
Floor002&#160;: App::DocumentObjectGroupPython
- Frame&#160;: Part::FeaturePython (89K) </pre>
<p>Ogni file di FreeCAD contiene un numero checksum SHA1, che cambia ogni volta che il file viene salvato, anche se non è stato cambiato nessun contenuto. Così fcinfo stampa sempre qualcosa, non importa se il contenuto cambia.
</p><p>Per abilitare l'utilizzo di fcinfo (solo per Linux e Mac - Da fare: aggiungere le istruzioni per Windows)
</p>
<ol><li> Salvare il file fcinfo da qualche parte nel sistema</li>
<li> Renderlo eseguibile</li>
<li> Creare un file .gitattributes nel proprio repository Git</li>
<li> Aggiungere in esso la seguente riga:</li></ol>
<pre>*.FCStd diff=fcinfo
</pre>
<div style="clear:both"></div>
</div>
</div>
</div><div class="printfooter">
Online version: "<a dir="ltr" href="https://www.freecadweb.org/wiki/index.php?title=Arch_Git/it&amp;oldid=253041">http://www.freecadweb.org/wiki/index.php?title=Arch_Git/it&amp;oldid=253041</a>"</div>
<div id="catlinks" class="catlinks" data-mw="interface"></div><div class="visualClear"></div>
</div>
</div>
<div id="mw-navigation">
<h2>Navigation menu</h2>
</body></html>