svn commit: r49476 - head/de_DE.ISO8859-1/books/fdp-primer/editor-config
Johann Kois
jkois at FreeBSD.org
Sun Oct 9 18:58:02 UTC 2016
Author: jkois
Date: Sun Oct 9 18:58:00 2016
New Revision: 49476
URL: https://svnweb.freebsd.org/changeset/doc/49476
Log:
MFde: New translation. de/books/fdp-primer/editor-config/chapter.xml
Obtained from: The FreeBSD German Documentation Project
Modified:
head/de_DE.ISO8859-1/books/fdp-primer/editor-config/chapter.xml
Modified: head/de_DE.ISO8859-1/books/fdp-primer/editor-config/chapter.xml
==============================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/editor-config/chapter.xml Sun Oct 9 16:10:54 2016 (r49475)
+++ head/de_DE.ISO8859-1/books/fdp-primer/editor-config/chapter.xml Sun Oct 9 18:58:00 2016 (r49476)
@@ -1,4 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
+<!--
+ The FreeBSD Documentation Project
+ $FreeBSD$
+ $FreeBSDde$
+ basiert auf: r49220
+-->
+
<!-- Copyright (c) 2013 Warren Block
All rights reserved.
@@ -28,19 +35,236 @@
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
-
- $FreeBSD$
- $FreeBSDde$
- basiert auf:
-->
-<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="editor-config">
- <title>Editor Configuration (noch nicht übersetzt)</title>
+<chapter xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+ xml:id="editor-config">
+
+ <info><title>Editor-Konfiguration</title>
+ <authorgroup>
+ <author><personname><firstname>Johann</firstname><surname>Kois</surname></personname><contrib>Übersetzt von </contrib></author>
+ </authorgroup>
+ </info>
+
+ <para>Die korrekte Konfiguration Ihres Texteditors macht die Arbeit
+ an der Dokumentation einfacher und schneller und hilft Ihnen dabei,
+ die <acronym>FDP</acronym>-Richtlinien einzuhalten.</para>
+
+ <sect1 xml:id="editor-config-vim">
+ <title><application>Vim</application></title>
+
+ <para>Installieren Sie entweder das Paket
+ <package>editors/vim</package> oder
+ <package>editors/vim-lite</package>, danach folgen Sie den
+ Anweisungen in
+ <xref linkend="editor-config-vim-config"/>.</para>
+
+ <sect2 xml:id="editor-config-vim-use">
+ <title>Verwendung</title>
+
+ <para>Drücken Sie die Taste <keycap>P</keycap>, um Absätze
+ oder Text, den Sie im visuellen Modus ausgewählt haben,
+ zu formatieren. Drücken Sie die Taste
+ <keycap>T</keycap>, um 8 Leerzeichen durch einen Tabulator
+ zu ersetzen.</para>
+ </sect2>
+
+ <sect2 xml:id="editor-config-vim-config">
+ <title>Konfiguration</title>
+
+ <para>Fügen Sie die folgenden Zeilen am Ende der Datei
+ <filename>~/.vimrc</filename> ein:</para>
+
+ <programlisting>if has("autocmd")
+ au BufNewFile,BufRead *.sgml,*.ent,*.xsl,*.xml call Set_SGML()
+ au BufNewFile,BufRead *.[1-9] call ShowSpecial()
+endif " has(autocmd)
+
+function Set_Highlights()
+ "match ExtraWhitespace /^\s* \s*\|\s\+$/
+ highlight default link OverLength ErrorMsg
+ match OverLength /\%71v.\+/
+ return 0
+endfunction
+
+function ShowSpecial()
+ setlocal list listchars=tab:>>,trail:*,eol:$
+ hi def link nontext ErrorMsg
+ return 0
+endfunction " ShowSpecial()
+
+function Set_SGML()
+ setlocal number
+ syn match sgmlSpecial "&[^;]*;"
+ setlocal syntax=sgml
+ setlocal filetype=xml
+ setlocal shiftwidth=2
+ setlocal textwidth=70
+ setlocal tabstop=8
+ setlocal softtabstop=2
+ setlocal formatprg="fmt -p"
+ setlocal autoindent
+ setlocal smartindent
+ " Rewrap paragraphs
+ noremap P gqj
+ " Replace spaces with tabs
+ noremap T :s/ /\t/<CR>
+ call ShowSpecial()
+ call Set_Highlights()
+ return 0
+endfunction " Set_SGML()</programlisting>
+ </sect2>
+ </sect1>
+
+ <sect1 xml:id="editor-config-emacs">
+ <title><application>Emacs</application></title>
+
+ <para>Installieren Sie entweder das Paket
+ <package>editors/emacs</package> oder
+ <package>editors/emacs-devel</package>.</para>
+
+ <sect2 xml:id="editor-config-emacs-validation">
+ <title>Validierung</title>
+
+ <para>Der xnml-Modus von Emacs verwendet ein kompaktes
+ RELAX-NG (<quote>Regular Language Description for XML
+ New Generation</quote>)-Schema, um XML zu validieren. Ein
+ solches, an DocBook 5.0 von FreeBSD angepasstes Schema ist
+ im Dokumentationsrepository bereits vorhanden. Damit der
+ nxml-Modus dieses Schema verwendet, müssen Sie die Datei
+ <filename>~/.emacs.d/schema/schemas.xml</filename> anlegen und
+ folgende Zeilen in die Datei einfügen:</para>
+
+ <programlisting><tag class="starttag">locatingRules xmlns="http://thaiopensource.com/ns/locating-rules/1.0"</tag>
+ <tag class="starttag">documentElement localName="section" typeId="DocBook"</tag>
+ <tag class="starttag">documentElement localName="chapter" typeId="DocBook"</tag>
+ <tag class="starttag">documentElement localName="article" typeId="DocBook"</tag>
+ <tag class="starttag">documentElement localName="book" typeId="DocBook"</tag>
+ <tag class="starttag">typeId id="DocBook" uri="/usr/local/share/xml/docbook/5.0/rng/docbook.rnc"</tag>
+<tag class="endtag">locatingRules</tag></programlisting>
+
+ </sect2>
+
+ <sect2 xml:id="editor-config-emacs-igor">
+ <title>Automatisches Gegenlesen mit Flycheck und Igor</title>
+
+ <para>Das Flycheck-Paket ist über <quote>Milkypostman's
+ Emacs Lisp Package Archive</quote> (<acronym>MELPA</acronym>)
+ erhältlich. Ist <acronym>MELPA</acronym> noch nicht in
+ packages-archives von Emacs eingetragen, muss dies manuell
+ durch das Ausführen der folgenden Emacs-Anweisung
+ erfolgen:</para>
+
+ <programlisting>(add-to-list 'package-archives '("melpa" . "http://stable.melpa.org/packages/") t)</programlisting>
+
+ <para>Um die Änderung permanent zu machen, müssen Sie diese Zeile
+ in die Initialisierungsdatei von Emacs aufnehmen, konkret in eine
+ der folgenden Dateien: <filename>~/.emacs</filename>,
+ <filename>~/.emacs.el</filename> oder
+ <filename>~.emacs.d/init.el</filename>.</para>
+
+ <para>Um Flycheck zu installieren, führen Sie folgende Anweisung
+ aus:</para>
+
+ <programlisting>(package-install 'flycheck)</programlisting>
+
+ <para>Legen Sie einen Flycheck-Prüfer für
+ <package>textproc/igor</package> an, indem Sie die folgende
+ Anweisung ausführen:</para>
+
+ <programlisting>(flycheck-define-checker igor
+ "FreeBSD Documentation Project sanity checker.
+
+See URLs http://www.freebsd.org/docproj/ and
+http://www.freshports.org/textproc/igor/."
+ :command ("igor" "-X" source-inplace)
+ :error-parser flycheck-parse-checkstyle
+ :modes (nxml-mode)
+ :standard-input t)
+
+ (add-to-list 'flycheck-checkers 'igor 'append)</programlisting>
+
+ <para>Wie bei MELPA müssen Sie auch diese Anweisung in die
+ Initialisierungsdatei von Emacs aufnehmen, um sie permanent
+ zu aktivieren.</para>
+ </sect2>
+
+ <sect2 xml:id="editor-config-emacs-specifc">
+ <title>FreeBSD-Dokumentationsspezische Einstellungen</title>
+
+ <para>Um FreeBSD-spezifische Einstellungen zu aktivieren, legen
+ Sie die Datei <filename>.dir-locals.el</filename> im
+ Wurzelverzeichnis des Dokumentationsrepositories an und fügen
+ die folgenden Zeilen in diese Datei ein:</para>
+
+ <programlisting>;;; Directory Local Variables
+;;; For more information see (info "(emacs) Directory Variables")
+
+((nxml-mode
+ (eval . (turn-on-auto-fill))
+ (fill-column . 70)
+ (eval . (require 'flycheck))
+ (eval . (flycheck-mode 1))
+ (flycheck-checker . igor)
+ (eval . (add-to-list 'rng-schema-locating-files "~/.emacs.d/schema/schemas.xml"))))</programlisting>
+ </sect2>
+ </sect1>
+
+ <sect1 xml:id="editor-config-nano">
+ <title><application>nano</application></title>
+
+ <para>Installieren Sie das Paket <package>editors/nano</package>
+ oder <package>editors/nano-devel</package>.</para>
+
+ <sect2 xml:id="editor-config-nano-config">
+ <title>Konfiguration</title>
+
+ <para>Kopieren Sie die Syntaxhighlighting-Datei für
+ <acronym>XML</acronym> in ihr Homeverzeichnis:</para>
+
+ <screen>&prompt.user; <userinput>cp /usr/local/share/nano/xml.nanorc ~/.nanorc</userinput></screen>
+
+ <para>Fügen Sie die folgenden Zeilen in die Datei
+ <filename>~/.nanorc</filename> ein:</para>
+
+ <programlisting>syntax "xml" "\.([jrs]html?|xml|xslt?)$"
+# trailing whitespace
+color ,blue "[[:space:]]+$"
+# multiples of eight spaces at the start a line
+# (after zero or more tabs) should be a tab
+color ,blue "^([TAB]*[ ]{8})+"
+# tabs after spaces
+color ,yellow "( )+TAB"
+# highlight indents that have an odd number of spaces
+color ,red "^(([ ]{2})+|(TAB+))*[ ]{1}[^ ]{1}"
+# lines longer than 70 characters
+color ,yellow "^(.{71})|(TAB.{63})|(TAB{2}.{55})|(TAB{3}.{47}).+$"</programlisting>
+
+ <para>Verarbeiten Sie diese Datei, um eingebettete Tabulatoren
+ zu erzeugen:</para>
+
+ <screen>&prompt.user; <userinput>perl -i'' -pe 's/TAB/\t/g' ~/.nanorc</userinput></screen>
+ </sect2>
+
+ <sect2 xml:id="editor-config-nano-use">
+ <title>Verwendung</title>
+
+ <para>Starten Sie Nano mit zusätzlichen hilfreichen
+ Parametern:</para>
+
+ <screen>&prompt.user; <userinput>nano -AKipwz -r 70 -T8 <replaceable>chapter.xml</replaceable></userinput></screen>
+
+ <para>Verwenden Sie &man.csh.1;, können Sie in
+ <filename>~/.cshrc</filename> einen Alias für diese Parameter
+ anlegen:</para>
+
+ <programlisting>alias nano "nano -AKipwz -r 70 -T8"</programlisting>
+
+ <para>Nachdem der Alias definiert wurde, werden diese Parameter
+ künftig automatisch angewendet:</para>
- <para>Dieses Kapitel ist noch nicht übersetzt. Lesen Sie daher bitte
- das <link
- xlink:href="&url.books.fdp-primer.en;/editor-config.html">Original in
- englischer Sprache</link>. Wenn Sie bei der Übersetzung
- mithelfen wollen, schicken Sie bitte eine E-Mail
- an &a.de.translators;.</para>
+ <screen>&prompt.user; <userinput>nano <replaceable>chapter.xml</replaceable></userinput></screen>
+ </sect2>
+ </sect1>
</chapter>
More information about the svn-doc-all
mailing list