WIP: New hugo security policy

content/_index.html → content/_index.md

@@ -2,4 +2,3 @@
 section: home
 is_site_root: true
 ---
-

content/about/_index.html → content/about/_index.md

@@ -77,4 +77,3 @@ <h2 id="free-and-open-source">Free and Open Source</h2>
 
 
 </div>
-

content/tools/guis/ios.html → content/tools/guis/ios.md

@@ -4,5 +4,3 @@
 - /download/gui/ios
 - /download/guis/ios
 ---
-
-

content/tools/guis/linux.html → content/tools/guis/linux.md

@@ -4,4 +4,3 @@
 - /download/gui/linux
 - /download/guis/linux
 ---
-

content/tools/guis/mac.html → content/tools/guis/mac.md

@@ -4,5 +4,3 @@
 - /download/gui/mac
 - /download/guis/mac
 ---
-
-

content/tools/guis/windows.html → content/tools/guis/windows.md

@@ -4,5 +4,3 @@
 - /download/gui/windows
 - /download/guis/windows
 ---
-
-

external/book/content/book/af/_index.md

@@ -0,0 +1,4 @@
+---
+### DO NOT EDIT! Generated by script/update-book2.rb
+redirect_to: book/af/v2
+---

external/book/content/book/af/v1/_index.md

@@ -0,0 +1,4 @@
+---
+### DO NOT EDIT! Generated by script/update-book2.rb
+redirect_to: book/af/v2
+---

external/book/content/book/af/v2/Aan-die-slag-Die-Opdragreël.md

@@ -0,0 +1,34 @@
+---
+### DO NOT EDIT! Generated by script/update-book2.rb
+category: book
+section: learn
+subsection: book
+sidebar: book
+book:
+  language_code: af
+  chapter:
+    title: Aan die slag
+    number: 1
+  section:
+    title: Die Opdragreël
+    number: 3
+    cs_number: '1.3'
+    previous: book/af/v2/Aan-die-slag-Wat-is-Git%3F
+    next: book/af/v2/Aan-die-slag-Git-Installeer
+title: Git - Die Opdragreël
+url: "/book/af/v2/Aan-die-slag-Die-Opdragreël.html"
+---
+<h2 id="_git_in_the_command_line">Die Opdragreël</h2>
+<div class="paragraph">
+<p>Daar is baie verskillende maniere om Git te gebruik.
+Daar is die oorspronklike opdragreël-nutsmiddels (command line tools), en daar is talle grafiese gebruikerskoppelvlakke (GUI’s) met verskillende vermoëns.
+In hierdie boek gaan ons Git op die opdragreël (command line) gebruik.
+Dit is omdat die opdragreël die enigste plek is waar jy <em>alle</em> Git-opdragte kan uitvoer – die meeste GUI’s implementeer vir die gemak van die gebruiker slegs 'n deel van Git se funksionaliteit.
+As jy die opdragreël-weergawe kan gebruik, sal jy waarskynlik ook kan aanvoel hoe om 'n GUI-weergawe te gebruik, terwyl die omgekeerde nie altyd die geval is nie.
+Ten slotte: die keuse van grafiese hulpmiddel is 'n kwessie van persoonlike smaak, terwyl <em>alle</em> gebruikers die opdragreël-nutsmiddels geïnstalleer het en tot hul beskikking het.</p>
+</div>
+<div class="paragraph">
+<p>Ons gaan dus daarvan uit dat jy weet hoe om 'n rekenaar-terminaal (terminal) in macOS te open, of 'n Command Prompt of PowerShell in Windows.
+As jy nie weet waarvan ons hier praat nie, is dit dalk verstandig om hier 'n bietjie te stop en dit op te soek sodat jy die res van die voorbeelde en beskrywings in hierdie boek kan volg.</p>
+</div>
+<div id="nav"><a href="{{< previous-section >}}">prev</a> | <a href="{{< next-section >}}">next</a></div>

external/book/content/book/af/v2/Aan-die-slag-Git-Installeer.md

@@ -0,0 +1,181 @@
+---
+### DO NOT EDIT! Generated by script/update-book2.rb
+category: book
+section: learn
+subsection: book
+sidebar: book
+book:
+  language_code: af
+  chapter:
+    title: Aan die slag
+    number: 1
+  section:
+    title: Git Installeer
+    number: 4
+    cs_number: '1.4'
+    previous: book/af/v2/Aan-die-slag-Die-Opdragreël
+    next: book/af/v2/Aan-die-slag-Git-klaarmaak-vir-eerste-gebruik
+title: Git - Git Installeer
+---
+<h2 id="_installing_git">Git Installeer</h2>
+<div class="paragraph">
+<p>Voordat jy Git kan begin gebruik, moet jy dit eers op jou rekenaar beskikbaar stel.
+Selfs as dit reeds geïnstalleer is, is dit waarskynlik 'n goeie idee om die nuutste weergawe te installeer.
+Jy kan dit installeer as 'n pakket of via 'n ander installeerder, of die bronkode aflaai en self verpak (compileer).</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>Hierdie boek is geskryf met Git weergawe 2.8.0 as uitgangspunt.
+Alhoewel die meeste opdragte wat ons gebruik selfs in baie ou weergawes van Git behoort te werk, kan sommige dalk nie werk nie of effens anders reageer as jy 'n ouer weergawe gebruik.
+Omdat Git redelik goed is in die handhawing van terugwaartse verenigbaarheid (backwards compatibility), behoort enige weergawe na 2.0 prima te werk.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h3 id="_installeer_op_linux">Installeer op Linux</h3>
+<div class="paragraph">
+<p>
+As jy direk die Git-gereedskap op Linux wil installeer, kan jy dit oor die algemeen doen via die standaard pakketbeheerstelsel wat saam met jou verspreiding (distribution) kom.
+As jy Fedora gebruik (of 'n direkte verwante RPM-gebaseerde verspreiding (distribution), soos RHEL of CentOS), kan jy <code>dnf</code> gebruik:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-console" data-lang="console">$ sudo dnf install git-all</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As jy op 'n Debian-verwante verspreiding (distribution) is, soos Ubuntu, kan jy <code>apt</code> probeer:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-console" data-lang="console">$ sudo apt install git-all</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Vir meer opsies is daar instruksies vir die installering op diverse Unix-verspreidings (distributions) op die Git-webblad by <a href="https://git-scm.com/download/linux" class="bare" target="_blank" rel="noopener">https://git-scm.com/download/linux</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h3 id="_installeer_op_macos">Installeer op macOS</h3>
+<div class="paragraph">
+<p>
+Daar is verskeie maniere om Git op 'n Mac te installeer.
+Die eenvoudigste is om die Xcode command line tools te installeer.
+Op Mavericks (10.9) of hoër kan jy dit eenvoudig doen deur <code>git</code> vanaf die rekenaar-terminaal (terminal) by die heel eerste geleentheid aan te roep.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-console" data-lang="console">$ git --version</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As jy dit nog nie geïnstalleer het nie, sal dit jou vra om dit te installeer.</p>
+</div>
+<div class="paragraph">
+<p>As jy 'n meer onlangse weergawe wil installeer, kan jy dit via 'n binêre installeerder doen.
+'n macOS Git-installeerder word onderhou en is beskikbaar vir aflaai op die Git-webblad by <a href="https://git-scm.com/download/mac" class="bare" target="_blank" rel="noopener">https://git-scm.com/download/mac</a>.</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="{{< relurl "book/af/v2/images/git-osx-installer.png" >}}" alt="Git macOS installer">
+</div>
+<div class="title">Figure 7. Git macOS installer</div>
+</div>
+</div>
+<div class="sect3">
+<h3 id="_installeer_op_windows">Installeer op Windows</h3>
+<div class="paragraph">
+<p>
+Daar is ook 'n aantal maniere om Git op Windows te installeer.
+Die mees amptelike weergawe is beskikbaar vir aflaai op die Git-webblad.
+Gaan net na <a href="https://git-scm.com/download/win" class="bare" target="_blank" rel="noopener">https://git-scm.com/download/win</a> en die aflaai sal outomaties begin.
+Let daarop dat dit 'n projek is genaamd Git for Windows, wat apart van Git self bestaan; vir meer inligting hieromtrent, gaan na <a href="https://gitforwindows.org" class="bare" target="_blank" rel="noopener">https://gitforwindows.org</a>.</p>
+</div>
+<div class="paragraph">
+<p>Om 'n geoutomatiseerde installasie te verkry, kan jy die Git Chocolatey-pakket gebruik.
+Let daarop dat die Chocolatey-pakket deur vrywilligers onderhou word.</p>
+</div>
+</div>
+<div class="sect3">
+<h3 id="_installeer_vanaf_bronkode">Installeer vanaf bronkode</h3>
+<div class="paragraph">
+<p>Sommige mense vind dit egter nuttig om Git vanaf die bronkode te installeer, omdat jy dan die mees onlangse weergawe kry.
+Die binêre installeerders loop dikwels effens agter, alhoewel dit minder probleme oplewer omdat Git in die laaste jare behoorlik volwasse geword het.</p>
+</div>
+<div class="paragraph">
+<p>As jy Git vanaf die bronkode wil installeer, moet jy die volgende biblioteke hê waarvan Git afhanklik is: autotools, curl, zlib, openssl, expat en libiconv.
+Byvoorbeeld, as jy op 'n stelsel is wat <code>dnf</code> het (soos Fedora) of <code>apt-get</code> (soos 'n Debian-gebaseerde stelsel), kan jy een van die volgende opdragte gebruik om die minimale afhanklikhede te installeer vir die verpakking en installering van die Git binêre lêers:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-console" data-lang="console">$ sudo dnf install dh-autoreconf curl-devel expat-devel gettext-devel \
+  openssl-devel perl-devel zlib-devel
+$ sudo apt-get install dh-autoreconf libcurl4-gnutls-dev libexpat1-dev \
+  gettext libz-dev libssl-dev</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Om ook die dokumente in die verskillende formate (doc, html, info) te kan byvoeg, is hierdie bykomende afhanklikhede nodig (let wel: gebruikers van RHEL en RHEL-afgeleides soos CentOS en Scientific Linux sal die EPEL repository moet aktiveer om die <code>docbook2X</code> pakket te laai):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-console" data-lang="console">$ sudo dnf install asciidoc xmlto docbook2X
+$ sudo apt-get install asciidoc xmlto docbook2x</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As jy 'n RPM-gebaseerde verspreiding (distribution) gebruik, kan jy ook die <code>getopt</code> pakket benodig (wat reeds op 'n Debian-gebaseerde distro geïnstalleer is):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-console" data-lang="console">$ sudo dnf install getopt
+$ sudo apt-get install getopt</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Aanvullend, as jy Fedora/RHEL/RHEL-afgeleides gebruik, moet jy ook dit doen:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-console" data-lang="console">$ sudo ln -s /usr/bin/db2x_docbook2texi /usr/bin/docbook2x-texi</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>vanweë binêre naamsafwykings.</p>
+</div>
+<div class="paragraph">
+<p>Wanneer jy alle benodigde afhanklikhede het, kan jy voortgaan en die laaste geëtiketteerde (tagged) vrystellingslêer (release tarball) van een van die vele plekke aflaai.
+Jy kan dit via die kernel.org-blad kry by <a href="https://www.kernel.org/pub/software/scm/git" class="bare" target="_blank" rel="noopener">https://www.kernel.org/pub/software/scm/git</a>, of die mirror op die GitHub-webblad by <a href="https://github.com/git/git/tags" class="bare" target="_blank" rel="noopener">https://github.com/git/git/tags</a>.
+Dit is oor die algemeen iets duideliker aangedui wat die laaste weergawe is op die GitHub-blad, en die kernel.org-blad het ook vrystellingshandtekeninge (release signatures) as jy die afgelaaide lêer wil verifieer.</p>
+</div>
+<div class="paragraph">
+<p>Daarna, verpak (compileer) en installeer:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-console" data-lang="console">$ tar -zxf git-2.8.0.tar.gz
+$ cd git-2.8.0
+$ make configure
+$ ./configure --prefix=/usr
+$ make all doc info
+$ sudo make install install-doc install-html install-info</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As dit afgehandel is, kan jy Git ook via Git self verkry vir opdaterings:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-console" data-lang="console">$ git clone https://git.kernel.org/pub/scm/git/git.git</code></pre>
+</div>
+</div>
+</div>
+<div id="nav"><a href="{{< previous-section >}}">prev</a> | <a href="{{< next-section >}}">next</a></div>