diff options
| author | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
| commit | 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch) | |
| tree | 90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/dinat | |
| parent | 950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff) | |
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/dinat')
| -rw-r--r-- | Master/texmf-dist/doc/latex/dinat/history.html | 692 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/dinat/index.html | 229 |
2 files changed, 921 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/dinat/history.html b/Master/texmf-dist/doc/latex/dinat/history.html new file mode 100644 index 00000000000..4038a66228d --- /dev/null +++ b/Master/texmf-dist/doc/latex/dinat/history.html @@ -0,0 +1,692 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<HTML LANG="de"> + +<HEAD> +<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso-8859-1"> +<META NAME="description" CONTENT="history of the BibTeX styles dinat"> +<META NAME="keywords" CONTENT="history dinat literatur DIN 1505 bibtex"> +<META NAME="resource-type" CONTENT="document"> +<META NAME="distribution" CONTENT="global"> + +<TITLE>Versionsübersicht</TITLE> + +</HEAD> + +<BODY BGCOLOR="white"> + +<H1>Versionsübersicht für <A HREF="index.html">dinat</A></H1> + +<HR> + +<H4>A short note for english speaking people</H4> + +<P> +This page is the version history of the BibTeX style +<CODE>dinat.bst</CODE>, which produce bibliographies following the german +norm DIN 1505. Because this norm is only usefull for text in german, all +extra documentation like these pages is in german, too. Nonetheless the +styles themselves have comments and output in english. If you like to get +this pages in english, too, please write me, I'll do my very best. +</P> + +<ADDRESS><A HREF="mailto:helge.baumann@gmx.de">mailto</A>: Helge +Baumann</ADDRESS> +<HR> + +<H2>Einleitung</H2> + +<P> +Hier werden (hoffentlich) alle Änderungen und ihr Sinn +aufgeführt, die zum Erreichen der aktuellen Version des BibTeX-Stils +<A HREF="dinat.bst">dinat.bst</A> durchgeführt wurden. Ich hoffe, dass +damit das Verständnis des Stils im Speziellen und von BibTeX im +Allgemeinen vertieft wird. +</P> + +<HR> + +<H4> Zu den <A HREF="#last">letzten Änderungen</A></H4> + +<HR> + +<H2>Der Anfang</H2> + +<P> +Einen neuen Stil zu schreiben kam mir zwar auch kurzzeitig in den Sinn, +aber nach einigen halbherzigen Versuchen habe ich es aufgegeben (hey, ich +sollte eigentlich meine Diplomarbeit schreiben!) und mich lieber auf die +Modifikation eines existierenden Stils beschränkt. Als Ausgangspunkt +habe ich den Stil <A +HREF="http://www.fh-hamburg.de/pers/Lorenzen/bibtex/"><CODE>natdin</CODE></A> +von <A HREF="http://www.fh-hamburg.de/pers/Lorenzen/">Lorenzen</A> +genommen, der die grundlegende DIN-Konformität schon eingebaut hat, +allerdings ziemlich fehlerhaft (und chaotisch) ist. Als Gradmesser für +den Erfolg habe ich anfangs die Datei <CODE>xampl.bib</CODE> verwendet, die +mit BibTeX mitgeliefert wird. Sie bietet zwar nicht unbedingt DIN-konforme +Einträge, deckt aber alle Standardfälle ab. +</P> + +<P> +Nachdem die Entscheidung gefallen war, einen "neuen" Stil zu +produzieren, ging es an die Einarbeitung in BibTeX im Allgemeinen und +<CODE>natdin</CODE> im Besonderen. Irgendwann verstand ich so +ungefähr, wie BibTeX mit Hilfe der bst-Dateien aus den Einträgen +der Datenbank eine TeX-Quelle erzeugt und fühlte mich gewappnet, dem +Problem entgegenzutreten. +</P> + +<HR> + +<H2>Von NATDIN zu DINAT</H2> + +<P> +Zuallererst musste ich <CODE>natdin</CODE> erstmal zum Laufen bekommen, +bei mir produzierte das Ding haufenweise Fehlermeldungen und Warnungen. +Fehler sind schlimmer als Warnungen, also musste ich mich zuerst um diese +kümmern. +</P> + +<H3>Grundlegende Fehler</H3> + +<UL> + <LI>doppelte Funktionen <CODE>or</CODE> und <CODE>conference</CODE> + entfernt</LI> +</UL> + +<P> +Ab hier ließ sich der Stil ohne Fehler einlesen, produzierte aber +noch 48 Fehler mit xampl.bib, ein bischen viel für meinen Geschmack! +</P> + +<H3>Detail-Arbeit</H3> + +<P> +Nun wurden einige Änderungen durchgeführt, die die Ausgabe nicht +grundlegend ändern, aber für das Verständnis des Stils gut +waren. Das meiste war eigentlich einfaches Aufräumen, nur ein paar +Sachen sind mir im Vorbeigehen zusätzlich aufgefallen, und so habe +ich sie gleich mit geändert: +</P> + +<UL> + <LI>Kommentare komplett entfernt, die meisten betrafen sowieso + irgendwelche Änderungen von vorangegangenen Versionen</LI> + <LI>Funktion <CODE>either.or.check</CODE> entfernt, wird nicht aufgerufen</LI> + <LI>in <CODE>misc</CODE> <CODE>Norm</CODE> durch <CODE>NORM</CODE> + ersetzt</LI> + <LI><CODE>[u.~a.~]</CODE> durch <CODE>[u.~a.]</CODE> ersetzt</LI> + <LI><CODE>{ 'skip$ }</CODE> durch <CODE>{ skip$ }</CODE> ersetzt</LI> + <LI>Formatierung (Einrückungen und Umbrüche) vereinheitlicht</LI> + <LI>Macro für <CODE>mar</CODE> geändert</LI> + <LI><CODE>phdthesis</CODE> eingeführt</LI> + <LI><CODE>format.pages.book</CODE> geändert</LI> + <LI>Funktionen <CODE>show</CODE> und <CODE>show.stack</CODE> für + Debugging eingeführt</LI> + <LI><CODE>"x" * "y"</CODE> zu + <CODE>"xy"</CODE>zusammengezogen</LI> + <LI>Funktionsaufrufe <CODE>'name</CODE> durch <CODE>{ name }</CODE> + ersetzt</LI> + <LI>gemeinsame Teile aus if-Zweigen verschoben bei</LI> + + <UL> + <LI><CODE>article.in.journal</CODE></LI> + <LI><CODE>format.editors</CODE></LI> + <LI><CODE>format.address.publisher.year</CODE></LI> + <LI><CODE>format.btitle.vol</CODE></LI> + <LI><CODE>format.series.number.din</CODE></LI> + <LI><CODE>format.vol.year.num.pages</CODE></LI> + <LI><CODE>format.in.ed.booktitle.din</CODE></LI> + <LI><CODE>format.tr.number.din</CODE> (umgestellt!)</LI> + <LI><CODE>format.book.crossref</CODE></LI> + <LI>allen entry-Funktionen</LI> + </UL> + + <LI>alle Kommandos ausser ENTRY, INTEGERS und STRINGS an das Ende + gesetzt</LI> + <LI><CODE>extra.label</CODE> am Ende von <CODE>format.date</CODE> + entfernt</LI> + <LI>diverse <CODE>tie.or.space.connect</CODE> durch <CODE>*</CODE> ersetzt, + falls kein festes Leerzeichen nötig</LI> +</UL> + +<P> +Bis hier waren alle Maßnahmen im Prinzip semantik-erhaltend, haben +damit also an der Anzahl der Fehler nichts geändert! Dies sollte nun +anders werden ... +</P> + +<H3><I>You can't pop an empty literal stack ...</I>-Fehler</H3> + +<UL> + <LI>in <CODE>calc.label</CODE> vor <CODE>sortify</CODE> ein + <CODE>label</CODE> eingefügt</LI> +</UL> + +<P> +Das entfernte die Fehlermeldungen, die durch das Sortieren hervorgerufen +wurden. Es blieben noch 12 Fehlermeldungen. +</P> + +<UL> + <LI>in <CODE>article.in.journal</CODE> bei leeren <CODE>author</CODE> und + <CODE>editor</CODE> kein <CODE>*</CODE></LI> +</UL> + +<P> +Das behebt den <CODE>empty literal stack</CODE> bei +<CODE>whole-jounal</CODE>, es bleiben noch 11 <I>the literal stack isn't +empty ...</I>-Fehler. +</P> + +<H3>Kommentare</H3> + +<P> +Ab hier war das Verständnis des Stils allerdings schon relativ +groß, so dass vorher ein paar weitere Dinge in Angriff genommen +werden konnten: +</P> + +<UL> + <LI>Funktionen etc. kommentiert</LI> + <LI>Funktionen umbenannt, um ihren Zweck zu beschreiben: + + <DL> + <DT><CODE>out.*</CODE></DT> <DD>Schreibt den obersten Eintrag des Stacks in + die bbl-Datei</DD> + <DT><CODE>format.*</CODE></DT> <DD>Formatiert den obersten Eintrag des + Stacks, d.h. baut ihn irgendwie um, packt aber keinen neuen Eintrag drauf + oder entfernt einen</DD> + <DT><CODE>push.*</CODE></DT> <DD>Legt genau einen (evtl. leeren) neuen + Eintrag auf den Stack</DD> + </DL> + + </LI> +</UL> + +<H3><I>the literal stack isn't empty ...</I>-Fehler</H3> + +<P> +Eine naheliegende Maßname war das Einfügen von +<CODE>stack$</CODE> am Ende von <CODE>out.bibitem.end</CODE> (ehemals +<CODE>fin.entry</CODE>), aber das hätte nur die Symptome kuriert, +nicht deren Ursache. Also ging es einzeln ans Eingemachte: Es waren alle +Stellen zu suchen und zu finden, in denen irgendwas auf den Stack gelegt +wurde, das hinterher nicht verarbeitet wurde. Dazu half die Umbenennung: +alles mit <CODE>push</CODE> musste etwas (genauer gesagt, exakt +<STRONG>ein</STRONG> Item) auf den Stack legen, alles mit +<CODE>format</CODE> dagegen sollte den obersten Stack-Eintrag manipulieren, +musste ihn also dazu abheben und hinterher wieder drauftun oder/und musste +etwas daranhängen. Gefunden habe ich dann nur den einen Eintrag: +</P> + +<UL> + <LI>in <CODE>format.article.in.journal</CODE> bei leerem Titel + <CODE>*</CODE> entfernt</LI> +</UL> + +<P> +Damit (wenn ich nichts vergessen habe) waren alle Fehlermeldungen +verschwunden, und die Hauptarbeit war getan: +</P> + +<H3>DINAT war geboren!</H3> + +<HR> + +<H2>Neue Funktionen</H2> + +<P> +Nun ging es daran, neue Funktionen einzubauen bzw. die existierenden +Formatierungen zu modifizieren: +</P> + +<UL> + <LI>Macros für Zeitschriften eingefügt</LI> + <LI>Leerzeichen vor Verweis in <CODE>format.article.crossref</CODE> + eingefürht</LI> + <LI>fette Verweise (<CODE>\textbf</CODE>) entfernt</LI> + <LI>ein Klammerpaar ("{}") um ehemalige <CODE>\textbf</CODE> + entfernt</LI> + <LI>zusätzliche Macros für Monate entfernt</LI> + <LI><CODE>pages</CODE> in <CODE>incollection</CODE> und + <CODE>inproceedings</CODE> hinter <CODE>series</CODE> und </LI> + <CODE>number</CODE> verschoben + <LI>alle Ausgaben in Englisch</LI> +</UL> + +<HR> + +<H2>URL</H2> + +<P> +Neuere Stile enthalten das Feld URL, also muß das auch hier rein +(außerdem brauche ich es selbst!). +</P> + +<UL> + <LI>Feld <CODE>url</CODE> eingefügt</LI> + <LI>Formatierung für <CODE>url</CODE> eingefügt</LI> + <LI>falls das url-Paket nicht verwendet wird, <CODE>\texttt</CODE> für + URL verwenden (<CODE>begin.bib</CODE>)</LI> + <LI>bei leerem <CODE>publisher</CODE>, <CODE>author</CODE> und + <CODE>editor</CODE> als Impressum die <CODE>url</CODE> verwenden</LI> + <LI><CODE>url</CODE> in alle Einträge vor <CODE>note</CODE> eingebaut, + allerdings nur, wenn noch nicht im Impressum verwendet</LI> +</UL> + +<HR> + +<H2>Von DINAT zu DINNAT</H2> + +<P> +Nachdem der DINAT-Stil so weit gediehen war, kam ich durch Beiträge in +der Newsgruppe <A HREF="news:de.comp.text.tex">de.comp.text.tex</A> auf die +Idee, den Stil so zu modifizieren, dass er die ganzen +NATBIB-Möglichkeiten bietet, also z.B. auch <CODE>\citeyear</CODE> und +die <CODE>*</CODE>-Formen. +</P> + +<UL> + <LI>Klammern um <CODE>year</CODE> in das Label eingebaut + (<CODE>calc.label</CODE>)</LI> +</UL> + +<P> +Leider gingen dabei die Marken vor den Einträgen im +Literaturverzeichnis flöten, so dass ein zweiter Stil nötig +wurde, der allerdings nicht mehr so richtig DIN-konform genannt werden +kann. Da er aber quasi die Langform von DINAT ist, wurde er DINNAT genannt. +Falls ich das jemals hinbekomme, die Marken zu erzeugen, wird DINNAT aber +wieder eingestellt! +</P> + +<P> +Ab jetzt müssen alle Änderungen parallel in beiden Stilen +durchgeführt werden, falls nicht anders vermerkt. +</P> + +<P> +Damit werden aber schon die zusätzlichen cite-Versionen +ermöglicht, es fehlt allerdings noch die lange Autorenliste. +</P> + +<UL> + <LI><CODE>make.full.names</CODE> mit allen in ihr aufgerufenen Funktionen + aus den anderen NAT-Stilen in <CODE>dinnat</CODE> eingefügt und hinter + das bisherige Label eingebaut</LI> +</UL> + +<HR> + +<H2>Erste Veröffentlichung am 10.4.2000</H2> + +<P> +Nachdem ich soweit gekommen war, war es an der Zeit, DINAT mit der +großen bösen Welt in Kontakt kommen zu lassen: Eine erste +Ankündigung erfolgte in der Newsgruppe de.comp.text.tex. Das Ergebnis +war nicht überwältigend, aber größer als gedacht, und +vor allem positiv! Ein echter Ansporn, weiter zu arbeiten. +</P> + +<HR> + +<H2>Version 1.1 vom 18.4.2000</H2> + +<P> +Wie üblich finden sich direkt nach Veröffentlichung der ersten +Version sofort ein paar kleine Fehler, die eine Überarbeitung +notwendig machen: +</P> + +<UL> + <LI><CODE>format.dashes</CODE> aus <CODE>push.url</CODE> entfernt</LI> + <LI><CODE>out.bibitem.start.end</CODE> in <CODE>out.bibitem.end</CODE> + umbenannt (typischer Suchen-und-Ersetzen-Fehler)</LI> + <LI><CODE>top$</CODE> durch <CODE>warning$</CODE> ersetzt, falls es nicht + für Debugging gebraucht wird</LI> + <LI>diverse <CODE>tie.or.space.connect</CODE> durch <CODE>*</CODE> ersetzt, + falls der hintere Teil auf jeden Fall länger ist, z.B. bei + ISBN/ISSN</LI> + <LI>diverse Leerzeichen vor bzw. hinter Satzzeichen etc. durch eine Tilde + ersetzt (und <CODE>tie.or.space.connect</CODE> durch <CODE>*</CODE> + ersetzt)</LI> + <LI>überflüssige geschweifte Klammern entfernt</LI> + <LI><CODE>format.article.in.journal</CODE> vereinfacht</LI> + <LI><CODE>push.series.number</CODE> umgestellt</LI> +</UL> + +<P> +Und natürlich auch ein paar richtige Änderungen (welche erste +Verison ist schon korrekt?): +</P> + +<UL> + <LI>zur Label-Erzeugung durch <CODE>key</CODE> wird der ganze Eintrag + genommen, nicht mehr nur die ersten drei Buchstaben (<A + HREF="mailto:rascher@ifn.ing.tu-bs.de">mailto</A>: Kai Rascher)</LI> + <LI>zur Label-Erzeugung wird der komplette <CODE>year</CODE>-Eintrag + verwendet, nicht nur die letzten vier Stellen, z.B. für + von-bis-Angaben (<A HREF="mailto:ulfhinze@gmx.de">mailto</A>: Ulf + Hinze)</LI> + <LI>bei <CODE>incollection</CODE> und <CODE>inproceedings</CODE> wird auch + mit <CODE>crossref</CODE> das Kapitel angegeben</LI> + <LI><CODE>push.book.crossref</CODE> vereinfacht</LI> +</UL> + +<P> +Ab jetzt sind auch diese Webseiten verfügbar, ich hoffe, damit werden +viele Fragen im Vorfeld beantwortet. Irgendwann demnächst wird diese +Seite auch umziehen, auf jeden Fall steht die Adresse dann im Vorspann der +Dateien. +</P> + +<HR> + +<H2>Version 1.2 vom 25.4.2000</H2> + +<P> +Nachdem diese Stile und damit auch diese Webseiten (auf Anregungen von <A +HREF="mailto:niepraschk@ptb.de">mailto</A>: Rolf Niepraschk) die Aufnahme +in die heiligen Hallen des <A HREF="http://www.ctan.com">CTAN</A> im Pfad +<CODE>biblio/bibtex/contrib/german/dinat/</CODE> gefunden haben, gibt es +auch noch ein paar Änderungen: +</P> + +<UL> + <LI>doppelte Leerzeichen entfernt</LI> + <LI><CODE>\natexlab</CODE> in <CODE>dinat</CODE> wieder eingeführt + (warum war das eigentlich draussen?)</LI> + <LI>in <CODE>dinnat</CODE> geschweifte Klammern um <CODE>\natexlab</CODE> + und in <CODE>\bibitem[...]</CODE> entfernt</LI> + <LI>in <CODE>misc</CODE> wird für <CODE>NORM</CODE> eine beliebige + Groß-/Kleinschreibung erkannt und verwendet</LI> + <LI>bei fehlenden Autor- etc. Angaben wird die gesamte Marke + (<CODE>cite$</CODE>) als Label genommen, nicht nur ihre ersten drei + Buchstaben</LI> + <LI><CODE>push.address.publisher.year</CODE> umgestellt</LI> + <LI>diverse <CODE>tie.or.space.connect</CODE> durch <CODE>*</CODE> ersetzt + (und Leerzeichen bzw. Tilden eingefügt)</LI> + <LI>Kommata in <CODE>push.incoll.inproc.crossref</CODE> richtig + gesetzt</LI> + <LI><CODE>url</CODE> nicht bei fehlenden Verlagsangaben (und nicht + fehlenden Autor und Editor!)</LI> + <LI>Titel von Normen kursiv</LI> + <LI><CODE>crossref</CODE> bei Normen eingefügt</LI> +</UL> + +<HR> + +<H2>Version 2.0 vom 2.5.2000</H2> + +<P> +Wenn das so weitergeht, komme ich doch noch in einen wöchentlichen +Update-Rhythmus :-) +</P> + +<P> +Ab jetzt gibt es zu den Änderungen auf dieser Seite auch die Namen und +Mail-Adressen der Leute, die diese angeregt haben, als Dank und Ansporn +sozusagen. +</P> + +<UL> + <LI>überflüssiges Leerzeichen in der Namensliste durch + <CODE>format.names</CODE> entfernt (<A + HREF="mailto:stefan@snobis.de">mailto</A>: Stefan Nobis)</LI> + <LI><CODE>urldate</CODE> als Datum des Zugriffs auf die URL eingebaut (<A + HREF="mailto:stefan@snobis.de">mailto</A>: Stefan Nobis)</LI> + <LI>Kommentar mit Namen des Stils in <CODE>begin.bib</CODE> zur Ausgabe in + die bbl-Datei eingefügt (sollte eigentlich Standard sein!)</LI> + <LI>einen Punkt hinter den Buchtitel bei Verweisen in + <CODE>incollection</CODE> und <CODE>inproceedings</CODE> gesetzt + (<CODE>push.incoll.inproc.crossref</CODE>)</LI> + <LI>Muster für den Eintrag in <CODE>natbib.cfg</CODE> berichtigt (<A + HREF="mailto:stefan@snobis.de">mailto</A>: Stefan Nobis)</LI> + <LI>Lösung des Label-Problems in <CODE>dinnat</CODE> gefunden!<BR> + Na gut, keine überzeugende, ist mehr ein Hack, aber wenigstens + funktioniert es</LI> +</UL> + +<P> +Diese Lösung sollte auch mit der Formatierung per +<CODE>natbib.cfg</CODE> zurechtkommen.<BR> +Falls die <CODE>natbib</CODE>-Option <CODE>numbers</CODE> oder die +<CODE>\bibpunct</CODE>-Variante <CODE>n</CODE> gewählt wurde, wird +auch nur ein entsprechendes numerisches Label erzeugt. +</P> + +<P> +Die letzte Änderung rechtfertigt den Sprung auf Version 2.0, da nun +mit einem Stil alle Zitiermöglichkeiten und Label erreicht werden +können. +</P> + +<P> +Diese Änderung führt darüberhinaus zur Zusammenführung +der beiden Stile, so dass nur noch ein Stil, nämlich der eigentlich +geplante <A HREF="dinat.bst">dinat.bst</A>, übrigbleibt. +</P> + +<HR> + +<H2>Version 2.1 vom 9.5.2000</H2> + +<P> +Und weiter geht es im immerwährenden Kreislauf der Änderungen, +selbst an meinem Geburtstag (aber schließlich erfolgte die erste +Veröffentlichung auch am Geburtstag meiner Frau): +</P> + +<UL> + <LI>der fünfte Parameter von <CODE>\bibpunct</CODE> in der + Konfiguration <CODE>natbib.cfg</CODE> erzeugte ein zusätzliches + Leerzeichen in den Zitierungen, also wurde es entfernt</LI> + <LI> die Felder <CODE>isbn</CODE>, <CODE>issn</CODE>, <CODE>url</CODE> und + <CODE>urldate</CODE> im Vorspann und auf der Webseite erklärt + (demnächst wird es auch eine richtige Anleitung geben)</LI> + <LI>für <CODE>techreport</CODE> <CODE>url</CODE> als Impressum bei + leerem <CODE>institution</CODE>, nicht <CODE>publisher</CODE></LI> + <LI>Links hier im Dokument geändert: Mailadressen werden jetzt + über <CODE>mailto:</CODE> verlinkt, Webseiten über den Namen</LI> + <LI>alle Texte in Funktionen verlagert, um sie leichter änderbar zu + machen, z.B. für Leute, die <CODE>et.al.</CODE> statt + <CODE>u.a.</CODE> haben wollen (<A + HREF="mailto:baum@mbox.cri.uni-hannover.de">mailto</A>: Peter Baum)</LI> + <LI><CODE>push.editors.organization</CODE> in + <CODE>push.organization</CODE> umbenannt und umgebaut</LI> + <LI><CODE>push.editors</CODE> umgebaut</LI> + <LI>damit wurde auch <CODE>push.ed.incoll</CODE> überflüssig</LI> + <LI><CODE>push.authors.editors</CODE> neu erstellt und eingebunden</LI> + <LI>die letzten vier Änderungen machten auch einige Änderungen an + anderen Funktionen notwendig</LI> + <LI>kleinerer Abstand bei <CODE>u.a.</CODE>: <CODE>\,</CODE> statt + <CODE>~</CODE></LI> + <LI><CODE>format.article.in.journal</CODE> zu + <CODE>push.article.in.journal</CODE> umgebaut</LI> + <LI><CODE>\cite</CODE> durch <CODE>\citep</CODE> ersetzt</LI> + <LI><CODE>push.crossref.editor</CODE> entfernt, da es nicht benutzt + wurde</LI> + <LI>in vielen Funktionen kleinere Umstellungen vorgenommen, um den Code + verständlicher und wartungsfreundlicher zu machen</LI> +</UL> + +<HR> +<A NAME="last"></A> + +<H2>Version 2.2 vom 12.07.2000</H2> + +<P> +Nachdem die Diplomarbeit abgegeben war, war wieder Zeit für +die Arbeit an dinat, dachte ich. Aber dann kam die neue Wohnung, der +Umzug, das Einrichten, der neue Job usw. Aber nun ist es geschafft, eine +neue Version ist fertig, wenn auch nicht so neu wie erhofft: +</P> + +<UL> + <LI><CODE>push.crossref</CODE> erstellt und eingebaut</LI> + <LI>diverse <CODE>crossref</CODE> geändert</LI> + <LI><CODE>out.check</CODE> in <CODE>out.check.required</CODE> + umbenannt</LI> + <LI><CODE>out.check.din</CODE> eingebaut für nur nach DIN + fehlende Teile</LI> + <LI><CODE>mastersthesis</CODE> in <CODE>masterthesis</CODE> + korrigiert</LI> + <LI><CODE>Zugriffsdatum</CODE> ebenfalls richtig geschrieben</LI> + <LI>um <CODE>\,</CODE> geschweifte Klammern gesetzt, hoffentlich + behebt das den nervigen <CODE>\nobreakspace{}</CODE>-Fehler +</UL> + +<P> +Vor allem für das letztere erbitte ich Meldungen, ob es geholfen hat! +</P> + +<HR> + +<H2>Version 2.3 vom 03.10.2000</H2> + +<P> +Nun ist der erste Stress mit neuer Wohnung, neuem Job etc. weg, viele viele +Vorschläge für dinat sind eingegegangen, und jetzt habe ich auch Zeit +für eine neue Version gefunden. Diese bringt noch nicht die +angekündigten großen Änderungen, sondern wie die vorigen vor +allem Detailverbesserungen, wenn auch einige lange geforderte: +</P> + +<UL> + <LI><CODE>masterthesis</CODE> wieder in das korrekte <CODE>mastersthesis</CODE> + geändert. Entschuldigung an alle für diese schlampige Korrektur, da + hatte ich mich aufs Glatteis führen lassen und selbst nicht genug + recherchiert. Um den Frust nicht zu groß werden zu lassen, bleibt + <CODE>masterthesis</CODE> erhalten.</LI> + <LI>die letzten Vorkommen von <CODE>u.~a.</CODE> beseitigt, nun sollten + wirklich alle <CODE>\nobreakspace{}</CODE>-Fehler weg sein!</LI> + <LI>als Abstand zwischen der Marke und dem Eintrag wird nun + standardmäßig <CODE>\labelsep</CODE> verwendet, wie es sich + gehört.</LI> + <LI><CODE>...key.organization.label</CODE> korrigiert, so dass nun die + ganze Organisation als Label verwendet wird.</LI> + <LI>in <CODE>proceedings</CODE> wird jetzt eine leere Organisation + abgefangen und falls vorhanden durch (Hrsg.) ergänzt.</LI> +</UL> + +<P> +<A NAME="doku">Und die Dokumentation ist immer noch nicht fertig.</A> +</P> + +<HR> + +<H2>Version 2.4 vom 05.11.2000</H2> + +<P> +Diese Version ist eine Olaf-Meltzer-Dank-Ausgabe, da er die +meisten Änderungen zu dieser Version beigetragen hat. Ich hatte +eigentlich nur ein wenig zu tun mit dem Zusammentragen und +Veröffentlichen. Dachte ich jedenfalls, bis ich mich an die +Namens-Formatierung machte ... Aber trotzdem, er hat es verdient, da er +nicht nur Fragen stellt, sondern auch selbst gute Lösungen liefert! +</P> + +<UL> + <LI><CODE>inbook</CODE> verbessert. Nun wird bei der Zitierung eines + einzelnen Teils eines Buchs nur eine einzelne Literaturangabe mit allen Werten + genriert. Wenn dagegen mehr als ein Teil eines Buchs zitiert werden, wird + das Buch mit allen Angaben aufgeführt und die jeweiligen Teile mit einem + entsprechenden Verweis (<A HREF="mailto:Olaf.Meltzer@freenet.de">mailto</A>: Olaf Meltzer).</LI> + <LI>überflüssigen Satzanfang aus <CODE>proceedings</CODE> entfernt + (<A HREF="mailto:Olaf.Meltzer@freenet.de">mailto</A>: Olaf Meltzer).</LI> + <LI>fehlenden Doppelpunkt nach Autor/Editor in <CODE>misc</CODE> + ergänzt (<A HREF="mailto:Olaf.Meltzer@freenet.de">mailto</A>: Olaf Meltzer).</LI> + <LI>wegen Problemen mit Adelsprädikaten wurden die Funktionen + <CODE>format.full.names</CODE>, <CODE>format.names</CODE> und + <CODE>sort.format.names</CODE> überarbeitet. Dabei fiel ab: + <UL> + <LI>die Variable <CODE>numnames</CODE> konnte entfernt werden.</LI> + <LI>die Variable <CODE>zahl</CODE> wurde in <CODE>pos</CODE> umbenannt, + da sie nicht einfach eine Zahl ist, sondern eine Position angibt.</LI> + <LI>die Variable <CODE>lang</CODE> wurde entfernt und statt dessen + die Variable <CODE>len</CODE> verwendet.</LI> + <LI>das allgemeine Verständnis der Namensformatierung wurde + größer!</LI> + </UL></LI> + <LI>innerhalb der ISBN/ISSN wird laut Duden der Binde-, also + Trennstrich verwendet, also keine Verdoppelung des <CODE>-</CODE> + mehr (sollte eigentlich schon lange gemacht sein).</LI> + <LI>Bei der Gelegenheit auch <CODE>format.dashes</CODE> etwas + aufgeräumt und verstanden.</LI> +</UL> + +<P> +Zum Stand der Dokumentation siehe <A HREF="#doku">oben</A>. Aber +inzwischen habe ich sehr viele Beispiel-Einträge sammeln können! +</P> + +<HR> +<A NAME="last"></A> + +<H2>Version 2.5 vom 15.11.2000</H2> + +<P> +Und direkt nach der letzten Version nun schon wieder eine neue. +Es haben sich einfach ein paar Dinge ergeben, die mir sinnvoll erschienen +und eine echte Verbesserung darstellen. Außerdem habe ich gerade +etwas Zeit. +</P> + +<UL> + <LI>In <CODE>proceedings</CODE> fehlendes <CODE>*</CODE> hinter + <CODE>push.organization</CODE> angefügt (<A + HREF="mailto:huhr@uni-paderborn.de">mailto</A>: Holger Uhr).</LI> + <LI>In <CODE>dinatlabel</CODE> wird nicht mehr <CODE>\citealt</CODE> + aufgerufen, sondern ein eigenes Label (<CODE>dinat.label</CODE>) gebastelt. + Dies spart einen LaTeX-Durchgang und ermöglicht vor allem das + Entfernen eines Zitats aus dem Text, ohne alle <CODE>.aux</CODE>-Dateien + wegschmeissen zu müssen. Ausserdem verhindert es überflüssige + Links, wenn das <CODE>hypertext</CODE>-Paket verwendet wird (<A + HREF="mailto:ben.samwer@ptb.de">mailto</A>: Ben Samwer).</LI> + <LI>Wenn ein Wert für <CODE>key</CODE> vorhanden ist, wird dieser + immer für das Label verwendet, vor <CODE>author</CODE>, + <CODE>editor</CODE> etc. Die dahinterliegende Überlegung ist, dass + ein <CODE>key</CODE> wohl nur angegeben wird, wenn er Sinn macht. Ist dann + aber ein <CODE>author</CODE> o.Ä. vorhanden, würde + <CODE>key</CODE> nirgendwo auftauchen. So lassen sich nun auch Werke mit + Autorenangaben etc. mit einer evtl. üblicheren Kurzbezeichnung zitieren (<A + HREF="mailto:ben.samwer@ptb.de">mailto</A>: Ben Samwer)</LI>. + <LI>Dazu wurden alle <CODE>...label</CODE>-Funktionen umgestellt und + auch umbenannt.</LI> + <LI>Und die <CODE>...sort</CODE>-Funktionen mussten ebenfalls + angepasst werden.</LI> + <LI><CODE>longest.label.width</CODE> und <CODE>longest.label</CODE> wurden + nicht benutzt, also wurden sie entfernt. Ursprünglich waren die Variablen + wohl zur Bestimmung der Einrücktiefe im Literaturverzeichnis + gedacht, was aber bei Autor-Jahr-Labels wenig Sinn macht, vor allem + wenn man an Werke mit zwei Autoren denkt, deren Label allein schon eine + ganze Zeile füllen kann.</LI> + <LI><CODE>initialize.longest.label</CODE> in <CODE>initialize.label</CODE> + umbenannt und vereinfacht.</LI> + <LI><CODE>number.label</CODE> in <CODE>label.count</CODE> + umbenannt.</LI> + <LI>Die <A HREF="index.html">Webseite</A> von Fehlern bereinigt.</LI> +</UL> + +<P> +Ein Problem bleibt die Sortierung von Einträgen mit gleichem ersten +(<EM>A</EM>), aber verschiedenem zweiten Autor (<EM>B</EM> bzw. <EM>C</EM>) +sowie mindestens einem weiteren Autoren (<EM>D</EM>) und unterschiedlicher +Jahreszahl (<EM>1994</EM> bzw. <EM>1999</EM>). Das Label wird dann aus erstem +Autor und Jahr gebildet (<EM>A u.a. 1994</EM> bzw. <EM>A u.a. 1999</EM>) und +entsprechend sortiert. Wird aber das Label nicht angezeigt, z.B. bei +numerischer Zitierung, dann wird das Werk <EM>A, B und D 1999</EM> trotzdem +hinter <EM>A, C und D 1994</EM> einsortiert, was zu Verwirrung führen kann. +Dies ist aber nicht befriedigend zu lösen, da zur Sortierzeit nicht +zwischen den beiden Zitierungsarten unterschieden werden kann. Da laut DIN +nach dem Label sortiert wird, behalte ich dieses bei, da ja die numerische +Zitierung nicht DIN entspricht. +</P> + +<HR> +<ADDRESS><A HREF="mailto:helge.baumann@gmx.de">mailto</A>: Helge Baumann, +2000-11-15</ADDRESS> + +</BODY> + +</HTML> diff --git a/Master/texmf-dist/doc/latex/dinat/index.html b/Master/texmf-dist/doc/latex/dinat/index.html new file mode 100644 index 00000000000..5f3a82a8e5f --- /dev/null +++ b/Master/texmf-dist/doc/latex/dinat/index.html @@ -0,0 +1,229 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<HTML LANG="de"> + +<HEAD> +<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso-8859-1"> +<META NAME="description" +CONTENT="bibliographies following the german DIN 1505 with BibTeX by dinat"> +<META NAME="keywords" CONTENT="dinat literatur DIN 1505 bibtex"> +<META NAME="resource-type" CONTENT="document"> +<META NAME="distribution" CONTENT="global"> + +<TITLE>Literaturverzeichnisse nach DIN mit BibTeX</TITLE> + +</HEAD> + +<BODY BGCOLOR="white"> + +<H1>Literaturverzeichnisse nach DIN mit BibTeX</H1> + +<HR> + +<H4>A short note for english speaking people</H4> + +<P> +This page is about a bibliography style for BibTeX named +<CODE>dinat.bst</CODE>, which produce bibliographies following the german +norm DIN 1505. Because this norm is only usefull for text in german, all +extra documentation like these pages is in german, too. Nonetheless the +styles themselves have comments and output in english. If you like to get +this pages in english, too, please write me, I'll do my very best. +</P> + +<ADDRESS><A HREF="mailto:helge.baumann@gmx.de">mailto</A>: Helge Baumann</ADDRESS> +<HR> + +<H2>Wie und warum?</H2> + +<P> +Im Zuge meiner Diplomarbeit stand ich vor dem Problem, ein +Literaturverzeichnis nach DIN 1505 verwenden zu wollen. Da ich meine Arbeit +mit LaTeX gesetzt habe und die Literatureinträge im BibTeX-Format +vorlagen, war es naheliegend, nach einem passenden fertigen Stil zu suchen. +Gefunden habe ich <A +HREF="http://www.fh-hamburg.de/pers/Lorenzen/bibtex/"><CODE>natdin</CODE></A> +von <A HREF="http://www.fh-hamburg.de/pers/Lorenzen/">Lorenzen</A>, der +auch ein gutes Werk zu <A +HREF="http://www.fh-hamburg.de/pers/Lorenzen/tum/litverz.ps">Literaturverzeichnissen +nach DIN</A> verfasst hat. Leider ist der von ihm erstellte Stil nicht ganz +ausgereift, also machte ich mich daran, davon ausgehend einen neuen Stil zu +entwicklen. +</P> + +<P> +Am Ende einer gewissen Entwicklung mit diversen Umwegen ist dann der Stil +<A HREF="dinat.bst">dinat.bst</A> herausgekommen, der alle +Möglichkeiten des <CODE>natbib</CODE>-Pakets bietet (dieses allerdings +auch in mindestens Version 7.0 voraussetzt), und bei konsequenter Anwendung von +<CODE>\citep</CODE> auch weitestgehend DIN-konforme Literaturverzeichnisse und +Zitierungen bietet. +</P> + +<HR> + +<H2>natbib</H2> + +<P> +Wie oben erwähnt, ist das Paket <CODE>natbib</CODE> Voraussetzung für den +Einsatz von <CODE>dinat</CODE>. Zur Zeit wird mindestens Version 7.0 +erwartet, das ist auch die bisher aktuellste auf den DANTE-Servern.</P> +<P> +Um mit <CODE>dinat</CODE> Literaturverzeichnisse zu erhalten, bei denen die +Marken (die Verweise, wie sie im Text auftauchen) den Einträgen +fettgedruckt vorangestellt sind, ist die Datei <CODE>natbib.cfg</CODE> um +den folgenden Eintrag zu erweitern (siehe auch die Dokumentation zu +<CODE>natbib</CODE>): +</P> + +<PRE> +\newcommand{\bibstyle@dinat}% + {\bibpunct{(}{)}{;}{a}{}{,~}% + \gdef\NAT@biblabelnum##1{\textbf{##1}}} +</PRE> + +<HR> + +<H2>Zusätze</H2> + +<P> +Zusätzlich zu den Standard-Feldern der Einträge existieren noch +die folgenden Felder: +</P> + +<DL> + <DT><CODE>issn</CODE></DT> <DD>Internationale Nummer für Zeitschriften + o.ä.</DD> + <DT><CODE>isbn</CODE></DT> <DD>Internationale Nummer für + Bücher</DD> + <DT><CODE>url</CODE></DT> <DD>Quelle eines elektronischen Dokuments. Wird + als Impressum verwendet, wenn kein Verlag und Verlagsort genannt wird, + sonst erscheint sie als zusätzliche Anmerkung</DD> + <DT><CODE>urldate</CODE></DT> <DD>Datum des Zugriffs auf eine url</DD> +</DL> + +<HR> + +<H2>Verfügbarkeit</H2> + +<P> +Der Stil <A HREF="dinat.bst">dinat.bst</A> ist in seiner jeweils +aktuellsten Version auf den CTAN-Servern (z.B. <A +HREF="ftp.dante.de">ftp.dante.de</A>) im Verzeichnis <A +HREF="ftp://ftp.dante.de/biblio/bibtex/contrib/german/dinat/">biblio/bibtex/contrib/german/dinat/</A> +zu finden. +</P> + +<P> +Eine Übersicht über die Entstehung des Stils ist in der <A +HREF="history.html">Versionsübersicht</A> zu finden. +</P> + +<HR> + +<H2>Anstehende Arbeiten</H2> + +<P> +Trotz der vielen Änderungen ist immer noch genug zu tun, bis +<CODE>dinat</CODE> wirklich zufriedenstellende Einträge erzeugt, die +alle Eventualitäten berücksichtigen, gut aussehen und DIN-konform +sind. Vor allem die letzten beiden Punkte sind manchmal nur schwer zu +vereinen :-) +</P> + +<P> +Was noch zu tun ist: +</P> + +<UL> + <LI>Eine schöne Anleitung in HTML und LaTeX mit Beispielen etc.</LI> + <LI><CODE>proceedings</CODE> scheint noch nicht so ausgereift zu sein.</LI> + <LI>Eigenständige Formatierungen für <CODE>booklet</CODE>, + <CODE>conference</CODE> und <CODE>unpublished</CODE>.</LI> + <LI>Der Code ist teilweise noch unsauber bzw. durcheinander, aber das + hört wohl nie auf.</LI> + <LI>Fehlende Felder müssen aufgeteilt werden in Standard-Felder + (required) und Feldern, die nur nach DIN notwendig sind. Echte Warnungen + sollte es nur bei fehlenden Standard-Feldern geben!</LI> + <LI>Wenn alle Standard-Felder vorhandenen sind, sollte ohne Warnungen + übersetzt werden.</LI> +</UL> + +<P> +Für Ergänzungen bin ich nicht unbedingt dankbar, das wäre +übertrieben, aber ich werde sie aufnehmen, wenn sie sinnvoll sind. +</P> + +<P> +Inzwischen bin ich auch soweit, dass ich eine Anleitung zum Erstellen bzw. +modifizieren von BibTeX-Stilen schreiben könnte. Falls daran sehr +großes Interesse besteht, bitte melden! +</P> + +<HR> + +<H2>Kontakt</H2> + +<P> +Fragen und Anregungen bitte direkt an mich unter <A +HREF="mailto:Helge.Baumann@gmx.de">Helge.Baumann@gmx.de</A> richten. +</P> + +<P> +Zur Zeit lese ich auch noch regelmäßig die Newsgruppe <A +HREF="news:DE.comp.text.tex">de.comp.text.tex</A>, so dass ich auch dort +erreichbar bin. +</P> + +<P> +Anfragen etc. kann ich am einfachsten nachvollziehen, wenn sie Folgendes +beinhalten (soweit möglich und sinnvoll): +</P> + +<OL> + <LI>verwendete Systeme, Versionsnummern etc. (ich selbst arbeite auf + einem Macintosh mit OzTeX, siehe <A HREF="#sonst">unten</A>)</LI> + <LI>eine kurze Beschreibung des Problems</LI> + <LI>einen Verweis auf die DIN bzw. den <A + HREF="http://www.fh-hamburg.de/pers/Lorenzen/tum/litverz.ps">Lorenzen</A></LI> + <LI>einen BibTeX-Eintrag</LI> + <LI>dem daraus mit <CODE>dinat</CODE> erzeugten Eintrag</LI> + <LI>den gewünschten Eintrag</LI> + <LI>Hinweis auf die geänderten bzw. zu ändernden Stellen</LI> +</OL> + +<P> +Ich versuche, Anfragen möglichst gleich nach Eingang zu beantworten, +und sei es nur mit einem Hinweis in der Art "Anfrage erhalten, ich +kümmere mich demnächst drum" (oder oft leider auch "Mache ich +nicht, weil nicht DIN ..."). +</P> + +<HR> + +<H2>Sonstiges</H2> + +<P> +<A name="sonst"></A> Entwickelt wurde der Stil auf einem <A +HREF="http://www.apple.de">Apple</A> Macintosh PowerPC 7100/66AV.<BR> +Als Editor kam <A HREF="http://alpha.olm.net">Alpha</A> zum Einsatz.<BR> +Als (Bib)TeX-System verwende ich <A +HREF="http://www.kagi.com/akt">OzTeX</A>. +</P> + +<P> +Als Literatur standen nur "BibTeXing" und "Designing BibTeX +Stiles" von Oren Patashnik zur Verfügung, das hat sich aber als +ausreichend herausgestellt, schliesslich studierte ich Informatik! +</P> + +<P> +Diese Webseiten sollten dem HTML-Standard 4.0 entsprechen und wurden mit +dem Browser <A HREF="http://www.icab.de">iCab</A> getestet. +</P> + +<HR> +<ADDRESS><A HREF="mailto:helge.baumann@gmx.de">mailto</A>: Helge Baumann, +2000-11-15</ADDRESS> +</BODY> + +</HTML> |