Index: head/de_DE.ISO8859-1/books/fdp-primer/editor-config/chapter.xml =================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/editor-config/chapter.xml (revision 49475) +++ head/de_DE.ISO8859-1/books/fdp-primer/editor-config/chapter.xml (revision 49476) @@ -1,46 +1,270 @@ + + - - Editor Configuration (noch nicht übersetzt) + - Dieses Kapitel ist noch nicht übersetzt. Lesen Sie daher bitte - das Original in - englischer Sprache. Wenn Sie bei der Übersetzung - mithelfen wollen, schicken Sie bitte eine E-Mail - an &a.de.translators;. + Editor-Konfiguration + + JohannKoisÜbersetzt von + + + + Die korrekte Konfiguration Ihres Texteditors macht die Arbeit + an der Dokumentation einfacher und schneller und hilft Ihnen dabei, + die FDP-Richtlinien einzuhalten. + + + <application>Vim</application> + + Installieren Sie entweder das Paket + editors/vim oder + editors/vim-lite, danach folgen Sie den + Anweisungen in + . + + + Verwendung + + Drücken Sie die Taste P, um Absätze + oder Text, den Sie im visuellen Modus ausgewählt haben, + zu formatieren. Drücken Sie die Taste + T, um 8 Leerzeichen durch einen Tabulator + zu ersetzen. + + + + Konfiguration + + Fügen Sie die folgenden Zeilen am Ende der Datei + ~/.vimrc ein: + + 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() + + + + + <application>Emacs</application> + + Installieren Sie entweder das Paket + editors/emacs oder + editors/emacs-devel. + + + Validierung + + Der xnml-Modus von Emacs verwendet ein kompaktes + RELAX-NG (Regular Language Description for XML + New Generation)-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 + ~/.emacs.d/schema/schemas.xml anlegen und + folgende Zeilen in die Datei einfügen: + + locatingRules xmlns="http://thaiopensource.com/ns/locating-rules/1.0" + documentElement localName="section" typeId="DocBook" + documentElement localName="chapter" typeId="DocBook" + documentElement localName="article" typeId="DocBook" + documentElement localName="book" typeId="DocBook" + typeId id="DocBook" uri="/usr/local/share/xml/docbook/5.0/rng/docbook.rnc" +locatingRules + + + + + Automatisches Gegenlesen mit Flycheck und Igor + + Das Flycheck-Paket ist über Milkypostman's + Emacs Lisp Package Archive (MELPA) + erhältlich. Ist MELPA noch nicht in + packages-archives von Emacs eingetragen, muss dies manuell + durch das Ausführen der folgenden Emacs-Anweisung + erfolgen: + + (add-to-list 'package-archives '("melpa" . "http://stable.melpa.org/packages/") t) + + Um die Änderung permanent zu machen, müssen Sie diese Zeile + in die Initialisierungsdatei von Emacs aufnehmen, konkret in eine + der folgenden Dateien: ~/.emacs, + ~/.emacs.el oder + ~.emacs.d/init.el. + + Um Flycheck zu installieren, führen Sie folgende Anweisung + aus: + + (package-install 'flycheck) + + Legen Sie einen Flycheck-Prüfer für + textproc/igor an, indem Sie die folgende + Anweisung ausführen: + + (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) + + Wie bei MELPA müssen Sie auch diese Anweisung in die + Initialisierungsdatei von Emacs aufnehmen, um sie permanent + zu aktivieren. + + + + FreeBSD-Dokumentationsspezische Einstellungen + + Um FreeBSD-spezifische Einstellungen zu aktivieren, legen + Sie die Datei .dir-locals.el im + Wurzelverzeichnis des Dokumentationsrepositories an und fügen + die folgenden Zeilen in diese Datei ein: + + ;;; 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")))) + + + + + <application>nano</application> + + Installieren Sie das Paket editors/nano + oder editors/nano-devel. + + + Konfiguration + + Kopieren Sie die Syntaxhighlighting-Datei für + XML in ihr Homeverzeichnis: + + &prompt.user; cp /usr/local/share/nano/xml.nanorc ~/.nanorc + + Fügen Sie die folgenden Zeilen in die Datei + ~/.nanorc ein: + + 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}).+$" + + Verarbeiten Sie diese Datei, um eingebettete Tabulatoren + zu erzeugen: + + &prompt.user; perl -i'' -pe 's/TAB/\t/g' ~/.nanorc + + + + Verwendung + + Starten Sie Nano mit zusätzlichen hilfreichen + Parametern: + + &prompt.user; nano -AKipwz -r 70 -T8 chapter.xml + + Verwenden Sie &man.csh.1;, können Sie in + ~/.cshrc einen Alias für diese Parameter + anlegen: + + alias nano "nano -AKipwz -r 70 -T8" + + Nachdem der Alias definiert wurde, werden diese Parameter + künftig automatisch angewendet: + + &prompt.user; nano chapter.xml + +