MFen 1.240 -> 1.242
This commit is contained in:
Rene Ladan
parent
a950dcc242
commit
bca2f28d49
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=34163
1 changed files with 245 additions and 3 deletions
|
|
@ -5,7 +5,7 @@
|
|||
$FreeBSDnl: doc/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v 1.47 2006/01/07 11:27:42 siebrand Exp $
|
||||
|
||||
%SOURCE% en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
|
||||
%SRCID% 1.240
|
||||
%SRCID% 1.242
|
||||
-->
|
||||
|
||||
<chapter id="updating-upgrading">
|
||||
|
|
@ -102,7 +102,7 @@
|
|||
|
||||
<listitem>
|
||||
<para>Hoe uw documentatie bijgewerkt te houden met
|
||||
<application>CVSup</application><!-- en
|
||||
<application>CVSup</application> of documentatie-ports<!-- en
|
||||
<application>Docsnap</application>-->.</para>
|
||||
</listitem>
|
||||
|
||||
|
|
@ -846,7 +846,7 @@ Fetching 133 new ports or files... done.</screen>
|
|||
|
||||
<para>Alle benodigde gereedschappen zijn beschikbaar als deel van
|
||||
de Portscollectie. De port <filename
|
||||
role="package">textproc/docproj</filename> is een meesterport
|
||||
role="package">textproc/docproj</filename> is een meester-port
|
||||
die door het &os; Documentatieproject is ontwikkeld om de
|
||||
installatie en toekomstige updates van deze gereedschappen
|
||||
makkelijker te maken.</para>
|
||||
|
|
@ -1039,6 +1039,248 @@ DOCSUPFILE?= /usr/share/examples/cvsup/doc-supfile</programlisting>
|
|||
&prompt.root; <userinput>make FORMATS='html html-split' install clean</userinput></screen>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="doc-ports">
|
||||
<sect2info>
|
||||
<authorgroup>
|
||||
<author>
|
||||
<firstname>Marc</firstname>
|
||||
<surname>Fonvieille</surname>
|
||||
<contrib>Gebaseerd op het werk van </contrib>
|
||||
</author>
|
||||
</authorgroup>
|
||||
</sect2info>
|
||||
|
||||
<title>Documentatieports gebruiken</title>
|
||||
|
||||
<indexterm><primary>Updaten en upgraden</primary></indexterm>
|
||||
|
||||
<indexterm>
|
||||
<primary>documentatiepakket</primary>
|
||||
|
||||
<see>Updaten en upgraden</see>
|
||||
</indexterm>
|
||||
|
||||
<para>In de vorige sectie werd er een methode voor het bijwerken
|
||||
van de &os;-documentatie vanaf de broncode gepresenteerd. Het
|
||||
bijwerken gebaseerd op broncode is echter niet voor alle
|
||||
&os;-systemen haalbaar of praktisch. Voor het bouwen van de
|
||||
documentatiebronnen zijn een redelijk grote verzameling van
|
||||
gereedschappen, de <emphasis>documentatie
|
||||
gereedschapskist</emphasis>, een bepaald niveau van bekendheid
|
||||
met <application>CVS</application> en checkouts van broncode
|
||||
vanuit een reservoir nodig, en een aantal handmatige stappen om
|
||||
de uitgecheckte broncode te bouwen. In deze sectie wordt een
|
||||
alternatieve manier beschreven om de geïnstalleerde
|
||||
kopiën van de &os;-documentatie bij te werken; een die de
|
||||
Ports Collectie gebruikt en het mogelijk maakt om:</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Voorgebouwde versies van de documentatie te downloaden
|
||||
en te installeren, zonder iets lokaal te hoeven bouwen (op
|
||||
deze manier wordt de noodzaak voor een installatie van de
|
||||
gehele documentatie-gereedschapskist voorkomen).</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>De documentatiebronnen te bouwen en ze via het
|
||||
ports-raamwerk te bouwen (de stappen van het uitchecken en
|
||||
bouwen worden iets eenvoudiger gemaakt).</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<para>Deze twee methoden om de &os;-documentatie bij te werken
|
||||
worden ondersteund door een verzameling van
|
||||
<emphasis>documentatie-ports</emphasis> die maandelijks door
|
||||
het &a.doceng; worden bijgewerkt. Deze zijn vermeld in de &os;
|
||||
Ports Collectie onder de virtuele categorie <ulink
|
||||
url="http://www.freshports.org/docs/">docs</ulink>.</para>
|
||||
|
||||
<sect3 id="doc-ports-install-make">
|
||||
<title>Documentatie-ports bouwen en installeren</title>
|
||||
|
||||
<para>De documentatie-ports gebruiken het bouwraamwerk van de
|
||||
ports om het bouwen van documentatie eenvoudiger te maken. Ze
|
||||
automatiseren het proces van het uitchecken van de broncode
|
||||
van de documentatie, het draaien van &man.make.1; met de
|
||||
juiste omgevingsinstellingen en opdrachtregelopties, en ze
|
||||
maken de installatie of deïnstallatie van documentatie
|
||||
net zo eenvoudig als de installatie van elke andere &os;-port
|
||||
of -pakket.</para>
|
||||
|
||||
<note>
|
||||
<para>Als een extra eigenschap registreren de
|
||||
documentatie-ports, wanneer ze lokaal zijn gebouwd, een
|
||||
afhankelijkheid naar de ports van de
|
||||
<emphasis>documentatie-gereedschapskist</emphasis>, zodat
|
||||
de laatste ook automatisch is geïnstalleerd.</para>
|
||||
</note>
|
||||
|
||||
<para>De organisatie van de documentatie-ports is als volgt:</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Er is een <quote>meester-port</quote>, <filename
|
||||
role="package">misc/freebsd-doc-en</filename>, waar de
|
||||
bestanden van de documentatie-ports gevonden kunnen worden.
|
||||
Het is de basis van alle documentatie-ports. Standaard
|
||||
bouwt het alleen de Engelstalige documentatie.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Er is een <quote>alles-in-één
|
||||
port</quote>, <filename
|
||||
role="package">misc/freebsd-doc-all</filename>, en het
|
||||
bouwt en installeert alle documentatie in alle beschikbare
|
||||
talen.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Ten slotte is er een <quote>slaaf-port</quote> voor
|
||||
elke vertaling, b.v. <filename
|
||||
role="package">misc/freebsd-doc-hu</filename> voor de
|
||||
documenten in het Hongaars. Ze zijn allemaal afhankelijk
|
||||
van de meester-port en installeren de vertaalde
|
||||
documentatie van de respectievelijke taal.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<para>Gebruik de volgende commando's (als
|
||||
<username>root</username>) om een documentatieport vanaf de
|
||||
broncode te installeren:</para>
|
||||
|
||||
<screen>&prompt.root; <userinput>cd /usr/ports/misc/freebsd-doc-en</userinput>
|
||||
&prompt.root; <userinput>make install clean</userinput></screen>
|
||||
|
||||
<para>Dit zal de Engelstalige documentatie in gesplitst
|
||||
<acronym>HTML</acronym>-formaat (hetzelfde als dat op <ulink
|
||||
url="http://www.FreeBSD.org"></ulink> wordt gebruikt) in de
|
||||
map <filename
|
||||
class="directory">/usr/local/share/doc/freebsd</filename>
|
||||
bouwen en installeren.</para>
|
||||
|
||||
<sect4 id="doc-ports-options">
|
||||
<title>Algemene knoppen en opties</title>
|
||||
|
||||
<para>Er zijn vele opties om het standaardgedrag van de
|
||||
documentatie-ports aan te passen. Het volgende is slechts
|
||||
een korte lijst:</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><makevar>WITH_HTML</makevar></term>
|
||||
|
||||
<listitem>
|
||||
<para>Staat bouwen van het HTML-formaat toe: een enkel
|
||||
HTML-bestand per document. De opgemaakte documentatie
|
||||
wordt naar gelang in een bestand genaamd
|
||||
<filename>article.html</filename>, of
|
||||
<filename>book.html</filename>, met afbeeldingen
|
||||
opgeslagen.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><makevar>WITH_PDF</makevar></term>
|
||||
|
||||
<listitem>
|
||||
<para>Staat bouwen van het &adobe; Portable Document
|
||||
Format toe, te gebruiken met &adobe; &acrobat.reader;,
|
||||
<application>Ghostscript</application>, of andere
|
||||
PDF-lezers. De opgemaakte documentatie wordt naar
|
||||
gelang opgeslagen in een bestand genaamd
|
||||
<filename>article.pdf</filename> of
|
||||
<filename>book.pdf</filename> opgeslagen.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><makevar>DOCBASE</makevar></term>
|
||||
|
||||
<listitem>
|
||||
<para>Waar de documentatie te installeren. Standaard is
|
||||
dit <filename
|
||||
class="directory">/usr/local/share/doc/freebsd</filename>.</para>
|
||||
|
||||
<note>
|
||||
<para>Merk op dat de standaard doelmap afwijkt van de
|
||||
map die door de <application>CVSup</application>-methode
|
||||
wordt gebruikt. Dit komt omdat er een port wordt
|
||||
geïnstalleerd, en ports worden normaliter onder
|
||||
de map <filename
|
||||
class="directory">/usr/local</filename>
|
||||
geïnstalleerd. Dit kan veranderd worden door
|
||||
de variabele <makevar>PREFIX</makevar> toe te
|
||||
voegen.</para>
|
||||
</note>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>Hier is een kort voorbeeld over hoe de bovengenoemde
|
||||
variabelen te gebruiken om de Hongaarse documentatie in
|
||||
Portable Document Format te installeren:</para>
|
||||
|
||||
<screen>&prompt.root; cd /usr/ports/misc/freebsd-doc-hu
|
||||
&prompt.root; make -DWITH_PDF DOCBASE=share/doc/freebsd/hu install clean</screen>
|
||||
</sect4>
|
||||
</sect3>
|
||||
|
||||
<sect3 id="doc-ports-install-package">
|
||||
<title>Documentatiepakketten gebruiken</title>
|
||||
|
||||
<para>Voor het bouwen van de documentatie-ports vanaf broncode,
|
||||
zoals beschreven in de vorige sectie, is een lokale
|
||||
installatie van de documentatie-gereedschapskist en wat
|
||||
schijfruimte voor het bouwen van de ports nodig. Wanneer de
|
||||
bronnen voor het installeren van de documentatie-gereedschapskist
|
||||
niet aanwezig zijn, of wanneer het bouwen vanaf broncode te
|
||||
veel schijfruimte in beslag neemt, is het nog steeds mogelijk
|
||||
om de vooraf gebouwde versies van de documentatie-ports te
|
||||
installeren.</para>
|
||||
|
||||
<para>Het &a.doceng; bereidt maandelijkse versies van de &os;
|
||||
documentatiepakketten voor. Deze binaire pakketten kunnen met
|
||||
elk van de meegeleverde pakketgereedschappen, zoals
|
||||
&man.pkg.add.1;, &man.pkg.delete.1;, enzovoorts gebruikt
|
||||
worden.</para>
|
||||
|
||||
<note>
|
||||
<para>Wanneer binaire pakketten worden gebruikt, zal de &os;
|
||||
documentatie in <emphasis>alle</emphasis> beschikbare
|
||||
formaten voor de gegeven taal geïnstalleerd worden.</para>
|
||||
</note>
|
||||
|
||||
<para>Het volgende commando bijvoorbeeld zal het nieuwste vooraf
|
||||
gebouwde pakket van de Hongaarse documentatie installeren:</para>
|
||||
|
||||
<screen>&prompt.root; <userinput>pkg_add -r hu-freebsd-doc</userinput></screen>
|
||||
|
||||
<note>
|
||||
<para>Pakketten hebben het volgende naamformaat welke afwijkt
|
||||
van de naam van de overeenkomstige port:
|
||||
<literal><replaceable>taal</replaceable>-freebsd-doc</literal>.
|
||||
Hier is <replaceable>taal</replaceable> het korte formaat
|
||||
van de taalcode, i.e. <literal>hu</literal> voor Hongaars,
|
||||
of <literal>zh_cn</literal> voor Vereenvoudigd Chinees.</para>
|
||||
</note>
|
||||
</sect3>
|
||||
|
||||
<sect3 id="doc-ports-update">
|
||||
<title>Documentatieports bijwerken</title>
|
||||
|
||||
<para>Voor het bijwerken van een eerder geïnstalleerde
|
||||
documentatieport is elk gereedschap voor het bijwerken van
|
||||
ports geschikt. Het volgende commando bijvoorbeeld werkt de
|
||||
geïnstalleerde Hongaarse documentatie bij via het
|
||||
gereedschap <filename
|
||||
role="package">ports-mgmt/portupgrade</filename> door alleen
|
||||
pakketten te gebruiken:</para>
|
||||
|
||||
<screen>&prompt.root; <userinput>portupgrade -PP hu-freebsd-doc</userinput></screen>
|
||||
</sect3>
|
||||
</sect2>
|
||||
|
||||
<!--FIXME: Waiting for a working docsnap server...-->
|
||||
<![ IGNORE [
|
||||
<sect2 id="docsnap">
|
||||
|
|
|
|||
Loading…
Reference in a new issue