1 files changed, 143 insertions, 0 deletions
diff --git a/biblio/bibtex/utils/mab2bib/README b/biblio/bibtex/utils/mab2bib/README
new file mode 100644
index 0000000000..44f4203324
--- /dev/null
+++ b/biblio/bibtex/utils/mab2bib/README
@@ -0,0 +1,143 @@
+mab2bib & utf8_to_latex
+=======================
+
+Version: 2009-06-15
+
+
+----- [de] ------
+
+Lizenz:  Python-Lizenz (Open Source)
+Autor:   Henning Hraban Ramm, fiëé visuëlle
+Email:   hraban@fiee.net
+URL:     http://www.fiee.net
+
+
+Beschreibung
+------------
+
+Zwei kleine Hilfsprogramme zu BibTeX:
+
+"mab2bib" konvertiert Bibliografiedaten im MAB-Format zu BibTeX
+
+"utf8_to_latex" konvertiert Textdateien in UTF-8-Encoding zu LaTeX-ASCII
+
+
+Voraussetzungen
+---------------
+
+- Python 2.5 (ab 2.3 müsste gehen)
+- LaTeX-Codec von D. Eppstein (latex.py, wird mitgeliefert)
+  
+
+Verwendung
+----------
+
+Die Datei latex.py muss im gleichen Verzeichnis liegen
+wie die beiden anderen Skripte!
+(Sie darf natürlich auch sauber als Codec installiert werden,
+das erkläre ich jetzt aber nicht.)
+
+* Konvertierung von Textdateien in UTF-8 in LaTeX mit Babel (aus ä wird "a):
+
+  [python] utf8_to_latex.py <Eingabedatei> [<Ausgabedatei>]
+
+  Fehlt der Ausgabename, wird die alte Datei mit der Endung .bak gesichert
+  und überschrieben.
+  
+  Das Skript kann übrigens für andere Textkonvertierungen einfach kopiert
+  und umbenannt werden, z.B. "macroman_to_latin1.py", die Möglichkeiten
+  richten sich nach den vorhandenen Codecs in der Python-Distribution.
+
+* Konvertierung von MAB-Dateien in Latin-1 (ISO 8859-1) in BibTeX:
+
+  [python] mab2bib.py <MAB-Datei> [<BibTeX-Datei>]
+
+  Ist keine Ausgabedatei angegeben, wird an die Eingabedatei '.bib' angehängt.
+
+
+Probleme
+--------
+
+- Die Skripte sind sehr einfach und fangen viele Fehler nicht ab.
+- An den Ausgabe-Dateien ist in den meisten Fällen noch Handarbeit nötig.
+- Wenn die Eingabecodierung nicht Latin-1 ist (sondern z.B. Mac Roman),
+  muss man in mab2bib.py an der einzigen Stelle, wo "latin-1" steht, die
+  richtige Codierung eintragen (z.B. "mac-roman").
+- Ich hatte keine vollständige Liste von möglichen MAB-Nummern und BibTeX-
+  Schlüsseln, daher muss die Zuweisungstabelle in mab2bib.py eventuell
+  angepasst werden (einfach mal reinschauen, dürfte verständlich sein).
+
+----- [en] -----
+
+License: Python License (Open Source)
+Author:  Henning Hraban Ramm, fiëé visuëlle
+Email:   hraban@fiee.net
+URL:     http://www.fiee.net
+
+Abstract
+--------
+
+Two small tools for BibTeX:
+
+"mab2bib" converts bibliographical data in MAB format into BibTeX
+
+"utf8_to_latex" converts text files in UTF-8 encoding into LaTeX ASCII
+
+
+Prerequisites
+-------------
+
+- Python 2.5 (2.3 and up should work)
+- LaTeX-Codec by D. Eppstein (latex.py, included)
+  
+
+Usage
+-----
+
+The file latex.py must stay in the same directory as the other two scripts!
+(It may get properly installed as a coded instead, but I won't explain that.)
+
+* Convert a text file in UTF-8 into LaTeX with Babel (ä becomes "a)
+
+  [python] utf8_to_latex.py <input file> [<output file>]
+
+  If the output file name is missing, the input file is saved with a .bak
+  extension and overwritten.
+  
+  BTW you can simply copy and rename the script for other text conversions,
+  e.g. "macroman_to_latin1.py", only limited by the codecs in your Python
+  installation.
+
+* Convert a MAB file in Latin-1 (ISO 8859-1) into BibTeX:
+
+  [python] mab2bib.py <MAB file> [<BibTeX file>]
+
+  Without an output file name, the input file name is used with a .bib
+  extension added.
+
+
+Problems
+--------
+
+- The scripts are very simple and don't catch a lot or errors.
+- In most cases there's manual work needed at the output files.
+- If the input encoding is any other that Latin-1 (e.g. Mac Roman),
+  you must change the only place in mab2bib.py where you find
+  "latin-1" into the right encoding (e.g. "mac-roman").
+- I didn't get a complete list of MAB numbers and BibTeX keys, therefore
+  you must eventually adapt the mapping table in mab2bib.py (just look
+  into it, it should be easy to understand).
+
+
+
+
+----- [*] -----
+
+Links
+-----
+
+- fiëé Repository:  http://github.com/fiee/tools/tree/master
+- BibTeX und Koala: http://www.ub.uni-konstanz.de/serviceangebote/literaturverwaltung/bibtex.html
+- Python:           http://www.python.org
+- Python-Lizenz:    http://python.org/psf/license/
+