summaryrefslogtreecommitdiff
path: root/biblio/bibtex/utils/mab2bib/README
blob: 44f4203324a8d83337136466185f36971874a011 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
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/