zettel2text - einfaches Repair & Export Tool zu ZMzettelkasten
zettel2text V 0.20 ist verfügbar zum Download
English Version, please click on flag or here.
Das kleine Linux Kommandozeilen-Tool überprüft und wandelt das Dateiformat von ZMzettelkasten-Dateien (Version 2.6) in Textdateien.
Version 0.20 unterstützt Zettelkästen mit verschlüsselten Zetteln. Diese werden jedoch nicht im Klartext ausgegeben.
Neu in der Version 0.12 ist der Export einer Zettelkasten-Datei in ein CSV-Text-Format. Damit ist es möglich einen Zettelkasten relativ einfach in andere Programme zu portieren.
Zettelkasten-Dateien haben ein spezielles Format, das eine datenbankähnliche Struktur hat. Die Datensätze müssen in bestimmten Reihenfolgen und Mengen enthalten sein. Außerdem sind sie jeweils durch Hex-Null voneinander getrennt. Sie lassen sich zwar mit entsprechenden Tools direkt editieren, bequemer ist jedoch die Wandlung in ein normales Text-Format zur Bearbeitung in einem Text-Editor Ihrer Wahl.
Das Tool wandelt eine Zettelkasten-Datei unabhängig davon, ob sie beschädigt ist oder nicht, in ein normales ASCII-Textformat um. Damit ist es möglich, ggf. beschädigte Dateien zu reparieren oder komplett zum Import in eine Textverarbeitung, wie z.B. OpenOffice bereitzustellen.
Das Programm wird auf der Kommandozeile aufgerufen und benötigt als Parameter den Namen der zu prüfenden oder umzusetzenden ZMzettelkasten-Datei.
bernd@mars:~/daten/cprog$ zettel2text test.zkx - InFile=test.zkx ==> OutFile=test.txt Datei test.zkx size = 2718 [00- 1] Head: Version2.6 [00- 2] Desc: Dies ist eine Test-Datei [00- 3] Anzahl Zettel = 37 *** Header fertig - weiter mit Data *** 37 Zettel mit 296 Feldern gefunden Anzahl Felder ist richtig Größter Zettel = 229 Zeichen Ende
Wie im Beispiel zu sehen ist, wird der Zettelkasten test.zkx zunächst überprüft und anschließend in eine normale Textdatei test.txt gewandelt. Zusätzlich werden noch einige Informationen über die Datei ausgegeben und die Anzahl der Felder auf Plausibilität überprüft.
Die einfache Textdatei hat ein Format mit TAGs, damit sie später auch wieder in eine Zettelkastendatei rückwandelbar ist.
Siehe folgendes Beispiel:
bernd@mars:~/daten/cprog$ cat test.txt <HEAD>Version2.6 <DESC>Dies ist eine Test-Datei <ZAHL>37 <--- Zettel ---> 0 <TITEL>Zettel 1 Text1 2.Zeile 3.Zeile äöüßÄÖÜ <STICH>Stichwort 1,zettel,kasten <AUTOR>Autor 1 <LINKS>3,6,28,31 <NOTIZ>Vermerk 1 <DATUM>Datum 1 <EXTRN>Extern 1 <--- Zettel ---> 1 <TITEL>Zettel 2 Text 2 mit Formatierung <f>Liste</f> 2.Zeile 3.Zeile <c>Center</c> <STICH>Stichwort 2,noch,ein,Stichwort <AUTOR>Bernd Holzhauer ... <DATUM>Erstellt: 22.9.2002;Geändert: 21.2.2007 <EXTRN>http://www.cc-c.de <--- Zettel ---> 36 <TITEL>Zettel 37 und noch ein bisschen <STICH>stichwort,test <AUTOR>siehe zmzettelkasten.zkx Zettel 12 <LINKS>0,9,12,22 <NOTIZ>dieser Eintrag ist zum Testen <DATUM>Erstellt: 21.12.2006;Geändert: 18.3.2007 <EXTRN>http://www.cc-c.de;http://www.media4world.de
Die TAGs <HEAD> <DESC> und <ZAHL> kommen jedes nur einmal im Kopf der Datei vor. | |
<HEAD>Version2.6 | stellt die Versionsangabe des Datei-Formates dar. |
<DESC>Test Datei | wird typischerweise von einem Kommentar gefolgt. Das ist die Dateibeschreibung. |
<ZAHL>## | Anzahl der Zettel (Datensätze) in der Datei |
Je Zettel folgt dann: | |
<--- Zettel ---> ## | Trennzeile für einzelne Zettel (mit Zettel-Index). Dieser ist immer um eins kleiner als die reale Zettelnummer im Programm, da der Index mit 0 zu zählen beginnt. |
<TITEL> | Zetteltitel (nur eine Zeile) |
Zetteltext | ohne spezielles Tag - mehrzeilig - alle Zeilen zwischen Titelzeile und Stichworte |
<STICH> | Stichworte mit Kommata getrennt (keine Zeilenschaltungen) |
<AUTOR> | Autor bzw. Quellenangabe (mehrzeilig) |
<LINKS> | Zahlen von 0 bis Zahl-1 |
<NOTIZ> | Anmerkungen |
<DATUM>Erstellt: datum ;Geändert: datum | |
<EXTRN> | Externe Links (Verweise) mit Semikolon getrennt (keine Zeilenschaltungen) |
Beim Editieren mittels Texteditor ist unbedingt zu beachten, dass die Anzahl der Sätze je Zettel stimmig ist und dass die Inhalte der Felder richtig sind. Die TAGs müssen immer am Beginn einer Zeile stehen. Beginnt eine Zeile z.B. mit einem Leerzeichen, werden die TAGs bei der Rückwandlung nicht als solche erkannt.
Die Rückwandlung erfolgt durch Aufruf zettel2text -r test.txt
. Die Ausgabedatei erhält immer den Namen repair.zkx, damit die "alte" Zettelkasten-Datei erhalten bleibt. Wenn Sie sich mittels ZMzettelkasten repair.zkx
von der Konsistenz des Zettelkastens überzeugt haben, können Sie die Datei mit cp
über die Ursprungsdatei kopieren.
Mit dem Aufruf zettel2text -c test.zkx
wird die Zettelkasten-Datei in die Text-Datei test.csv gewandelt/kopiert. Diese Datei hat dann ein Semikolon separiertes Format, das (bedingt) zum Import z.B. in eine OpenOffice Tabelle geeignet ist. Im Zettelkasten vorhandene Zeilenschaltungen und Anführungszeichen bleiben erhalten und können dadurch den Import in ein anderes Programm stören.
Tipp: testen Sie den Export/Import in ein Spreadsheet zuerst mit einem kleinen Zettelkasten.
Download zettel2text Version 0.12
Nutzungsbestimmungen:
Das Programm ist Freeware und darf frei heruntergeladen und benutzt werden. Für die Benutzung des Programms fallen keine Gebühren an. Die Benutzung geht auf eigene Gefahr. Es kann auf Grund der Pre-Release noch zu Programm Fehlern kommen. Eine Haftung für eventuelle Datenverluste und -beschädigungen ist ausgeschlossen.Das Bereitstellen von Kopien auf Datenträgern (z.B. Zeitschriften CDs) oder zum Download bedarf meiner vorherigen Zustimmung.
Mitarbeitern (auch freien Mitarbeitern und Helfern) folgender Firmen und Organisationen ist der Download, die Nutzung und das Kopieren untersagt: Berufsgenossenschaften, Industrie- und Handelskammern, GEZ
Grund: Diese Organisationen mit ihren Zwangsmitgliedschaften schmarotzen in Deutschland schon genug.
Ich behalte mir vor, diese Liste bei Gelegenheit zu erweitern.
(c) 2007 Bernd Holzhauer
download zettel2text size 14kB - ausführbares Binary für die Linux Konsole
nach dem Download mit ./zettel2text dateiname
aufrufen.
Für häufigeren Gebrauch mit sudo cp zettel2text /usr/local/bin
kopieren.
Bei Fragen, Anregungen oder Fehlermeldungen, bitte per email melden.
Warenzeichen und Marken sind Eigentum der jeweiligen Besitzer.
Das Ing.Büro Bernd Holzhauer distanziert sich grundsätzlich von gesetzeswidrigen und möglicherweise illegalen Inhalten in Seiten, auf die über www.cc-c.de verwiesen wird. Sollte Ihnen diesbezüglich etwas auffallen, melden Sie es uns bitte per email.