|
|
@@ -1,23 +1,164 @@
|
|
|
-\section{\de{Was \underline{nicht} in GIT gespeichert werden sollte}\en{What \underline{not} to store in in GIT}}
|
|
|
+\section{\de{Gespeicherte Daten verwalten}\en{Manage stored data}}
|
|
|
+\subsection{\de{Was \underline{nicht} in GIT gespeichert werden sollte}\en{What \underline{not} to store in in GIT}}
|
|
|
|
|
|
Die folgenden Daten sollten nicht im GIT gespeichert werden. Insbesondere wenn die Datei > 1MB ist.
|
|
|
|
|
|
-\newcommand{\ext}[1]{\texttt{*.#1}}
|
|
|
+\newcommand{\ext}[1]{\var{*.#1}}
|
|
|
|
|
|
\begin{itemize}
|
|
|
-\item Videos (z.B: \ext{avi} / \ext{mp4} / \ext{wmv})
|
|
|
-\item Bilder (z.B: \ext{jpg} / \ext{png} / \ext{tiff} / \ext{bmp} / \ext{xcf} / \ext{ppt} / \ext{pptx} / \ext{psd})
|
|
|
-\item Ton-Dateien (z.B: \ext{wav} / \ext{mp3} / \ext{flac} / \ext{ogg})
|
|
|
-\item Programme / Installer (z.B: \ext{exe} / \ext{msi} / \ext{o /} \ext{jar})
|
|
|
-\item Binaerdateien (z.B: \ext{bin} / \ext{dat} / \ext{zip} / \ext{gz} / \ext{bz})
|
|
|
-\item Dateien, die sich aus den bereits vorhandenen Quelltexten herstellen lassen.
|
|
|
-\item Zwischen Dateien, die w\"ahrend des Bauvorganges entstehen. (z.B: \ext{o} / \ext{class})
|
|
|
-\item Programm- / Debugausgaben (z.B: \ext{log}, \ext{dat})
|
|
|
+\item Videos (\tZB{} \ext{avi} / \ext{mp4} / \ext{wmv})
|
|
|
+\item \de{Bilder}{Images} (\tZB{} \ext{jpg} / \ext{png} / \ext{tiff} / \ext{bmp} / \ext{xcf} / \ext{psd})
|
|
|
+\item \de{Pr\"asentationen}{Presentations} (\tZB{} \ext{ppt} / \ext{pptx} / \ext{pdf})
|
|
|
+\item \de{Ton-Dateien}\en{Audio-Files} (\tZB{} \ext{wav} / \ext{mp3} / \ext{flac} / \ext{ogg})
|
|
|
+\item \de{Programme, Bibliotheken, Installer}\en{Executables, Libraries, istaller} (\tZB{} \ext{exe} / \ext{dll} / \ext{lib} / \ext{msi} / \ext{o} / \ext{so} / \ext{class} / \ext{jar})
|
|
|
+\item Bin\"ardateien (\tZB{} \ext{bin} / \ext{dat} / \ext{zip} / \ext{gz} / \ext{bz})
|
|
|
+\item Dateien, die sich generieren lassen.
|
|
|
+\item Dateien, die w\"ahrend des Bauvorganges entstehen. (\tZB{} \ext{o} / \ext{class})
|
|
|
+\item Programm- / Debugausgaben (\tZB{} \ext{log}, \ext{dat})
|
|
|
+\item Ordner anderer Versionsverwaltungssysteme (\tZB \var{.svn})
|
|
|
+\item Backups, Tempor\"are Editor-Dateien, Lokale Workspace-Konfigurationen (\tZB \ext{swp} / \var{*\~})
|
|
|
\end{itemize}
|
|
|
|
|
|
-Repositories sollten mit History < 200Mb bleiben.
|
|
|
+Repositories sollten mit History < 300Mb bleiben.
|
|
|
\\
|
|
|
Bei Repositories $\geq$ 500MB mahnen wir.
|
|
|
|
|
|
|
|
|
-\section{\de{Was in ein GIT-Repository gehoert.}\en{What to store in a GIT repository.}}
|
|
|
+\subsection{\de{Was in ein GIT-Repository gehoert.}\en{What to store in a GIT repository.}}
|
|
|
+\begin{itemize}
|
|
|
+\item \de{Quelltexte}\en{Sourcecode}
|
|
|
+\item \de{Dokumentationen}\en{Documentation}
|
|
|
+\item Makefiles
|
|
|
+\item \de{Zum Bauen erforderliche Konfigurationen.}\en{Configuration, needed to build your project.}
|
|
|
+\item \de{Notwendige Dateien, die nicht generiert oder aus dem Internet / anderen Repositories geladen werden k\"onnen.}\en{Needed files, that can't be generated or loaded from the internet or other repositories.}
|
|
|
+\end{itemize}
|
|
|
+
|
|
|
+\newpage
|
|
|
+\subsection{Von GIT verwaltete Dateien konfigurieren}
|
|
|
+
|
|
|
+\begin{DE}
|
|
|
+ In jedem Ordner des von GIT verwalteten Repositories kann eine Datei \var{.gitignore} angelegt werden.
|
|
|
+ Dies ist eine Text-Datei, in der aufgelisted wird, welche Ordner oder Dateien bei einem \code{git add .} ignoriert werden sollen.
|
|
|
+ Dabei kann auch mit Wildcards (*) gearbeitet werden.
|
|
|
+\end{DE}
|
|
|
+\begin{EN}
|
|
|
+ In every folder of you GIT repository you may add a \code{.gitignore} file.
|
|
|
+ This is a text file, listing all folder or files that should be ignored by git.
|
|
|
+ You don't need to worry using \code{git add .}. It will not add these files.
|
|
|
+ In the list you may use wildcards (*).
|
|
|
+\end{EN}
|
|
|
+
|
|
|
+\subsubsection{\de{Beispiel: TeX Dokument}\en{Example: Tex Document}}
|
|
|
+
|
|
|
+\begin{minipage}[t]{0.39\textwidth}\parInit
|
|
|
+\de{Das Projekt hat diese Ordner-Struktur:}\en{The project has this folder structure:}
|
|
|
+\begin{itemize}
|
|
|
+\item \var{Makefile}
|
|
|
+\item \var{.gitignore}
|
|
|
+ \item \var{myPaper.tex}
|
|
|
+ \item \badvar{myPaper.pdf}
|
|
|
+ \item \badvar{myPaper.aux}
|
|
|
+ \item \badvar{myPaper.idx}
|
|
|
+ \item \badvar{myPaper.toc}
|
|
|
+ \item \badvar{myPaper.out}
|
|
|
+ \item \badvar{myPaper.log}
|
|
|
+ \item \var{chapter1.tex}
|
|
|
+ \item \badvar{chapter1.aux}
|
|
|
+ \item \badvar{.chapter1.aux.swp}
|
|
|
+ \item \var{chapter2.tex}
|
|
|
+ \item \badvar{chapter2.aux}
|
|
|
+ \item \badvar{chapter2.aux\~}
|
|
|
+ \item \ldots
|
|
|
+\item \var{images/}
|
|
|
+ \begin{itemize}
|
|
|
+ \item \var{logo.png}
|
|
|
+ \item \var{interestingGraphic.fig}
|
|
|
+ \item \ldots
|
|
|
+ \end{itemize}
|
|
|
+\end{itemize}
|
|
|
+\end{minipage}
|
|
|
+\hfill
|
|
|
+\begin{minipage}[t]{0.59\textwidth}\parInit
|
|
|
+\begin{DE}
|
|
|
+ Die \ext{tex} Dateien sind die Quelltexte zum TeX Dokument.
|
|
|
+ Im Ordner \var{images} sind f\"ur das Dokument wichtige Bilder oder Quelltexte, die diese Bilder generieren.
|
|
|
+ Diese Dateien sollten gespeichert werden.
|
|
|
+
|
|
|
+ Die Datei \var{myPaper.pdf} ist das compilierte Endprodukt.
|
|
|
+ Die \ext{log}, \ext{out}, \ext{aux}, \ext{toc}, \ext{idx} Dateien sind Nebenprodukte des Bauprozesses.
|
|
|
+ Diese Dateien sollten nicht in das Repository.
|
|
|
+
|
|
|
+ Der Editor legt w\"ahrend des Bearbeitens \ext{swp} Dateien an (z.B: \var{chapter1.swp}).
|
|
|
+ Beim Speichern legt der Editor Backups an (z.B: \var{chapter2.tex\~}).
|
|
|
+ Die Backup-Dateien und die \ext{swp} Dateien sollen nicht in das Repository.
|
|
|
+
|
|
|
+ Die \var{.gitignore} k\"onnte wie folgt aussehen:
|
|
|
+\end{DE}
|
|
|
+\begin{EN}
|
|
|
+ \ldots
|
|
|
+\end{EN}
|
|
|
+
|
|
|
+\begin{Code}
|
|
|
+{*}.swp\\
|
|
|
+{*}\~\\
|
|
|
+{*}.aux\\
|
|
|
+{*}.idx\\
|
|
|
+{*}.toc\\
|
|
|
+{*}.out\\
|
|
|
+{*}.log
|
|
|
+\end{Code}
|
|
|
+\end{minipage}
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+\subsubsection{\de{Beispiel: C Projekt}\en{Example: C Project}}
|
|
|
+
|
|
|
+\begin{minipage}[t]{0.39\textwidth}\parInit
|
|
|
+\de{Das Projekt hat diese Ordner-Struktur:}\en{The project has this folder structure:}
|
|
|
+\begin{itemize}
|
|
|
+\item \var{Makefile}
|
|
|
+\item \var{.gitignore}
|
|
|
+ \item \var{guessMyNumber.c}
|
|
|
+ \item \var{guessMyNumber.o}
|
|
|
+ \item \ldots
|
|
|
+\end{itemize}
|
|
|
+\end{minipage}
|
|
|
+\hfill
|
|
|
+\begin{minipage}[t]{0.59\textwidth}\parInit
|
|
|
+\begin{DE}
|
|
|
+ Die \ext{tex} Dateien sind die Quelltexte zum TeX Dokument.
|
|
|
+ Im Ordner \var{images} sind f\"ur das Dokument wichtige Bilder oder Quelltexte, die diese Bilder generieren.
|
|
|
+ Diese Dateien sollten gespeichert werden.
|
|
|
+
|
|
|
+ Die Datei \var{myPaper.pdf} ist das compilierte Endprodukt.
|
|
|
+ Die \ext{log}, \ext{out}, \ext{aux}, \ext{toc}, \ext{idx} Dateien sind Nebenprodukte des Bauprozesses.
|
|
|
+ Diese Dateien sollten nicht in das Repository.
|
|
|
+
|
|
|
+ Der Editor legt w\"ahrend des Bearbeitens \ext{swp} Dateien an (z.B: \var{chapter1.swp}).
|
|
|
+ Beim Speichern legt der Editor Backups an (z.B: \var{chapter2.tex\~}).
|
|
|
+ Die Backup-Dateien und die \ext{swp} Dateien sollen nicht in das Repository.
|
|
|
+
|
|
|
+ Die \var{.gitignore} k\"onnte wie folgt aussehen:
|
|
|
+\end{DE}
|
|
|
+\begin{EN}
|
|
|
+ \ldots
|
|
|
+\end{EN}
|
|
|
+
|
|
|
+\begin{Code}
|
|
|
+{*}.swp\\
|
|
|
+{*}\~\\
|
|
|
+{*}.aux\\
|
|
|
+{*}.idx\\
|
|
|
+{*}.toc\\
|
|
|
+{*}.out\\
|
|
|
+{*}.log
|
|
|
+\end{Code}
|
|
|
+\end{minipage}
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
Kristian Schultz