Hilfe zu Cent v.0.3

Inhalt

Allgemeines
Oberfläche
Optionsdialog
Arbeit mit Cent
1. Arbeit mit Text-Dateien
2. HTML-Modus
Konfiguration
Installation
Deinstallation

Allgemeines Inhalt

Cent ist ein Programm zum Tausch beliebiger fest speicherbarer Textelemente, sowie zur Konvertierung von textbasierten Sonderzeichen zu HTML- oder numerischen Unicode-Entities. Hierbei werden alle Zeichen erfasst, die als HTML-Entities vorliegen.
Im Einzelnen sind dies:

einige 7-Bit ASCII-Zeichen
symbolische ISO 8859-1 Entities
ISO 8859-1 Character-Entities
von HTML unterstützte mathematische Symbole
von HTML unterstützte griechische Zeichen
einige zusätzliche von HTML unterstützte Symbole

Die zu konvertierenden Zeichen können unter Extras - Optionen - Allgemeines fest eingetragen, 'on the fly' über ein Sonderzeichenfenster ausgewählt oder in Form von Dateien geladen werden. Zwischen den beiden Entity-Typen kann vor der Konvertierung gewählt werden. Ein Wechsel der Entity-Typen in bereits konvertierten Dateien ist ebenfalls möglich.

Oberfläche Inhalt

Die Cent-Oberfläche gliedert sich in die folgenden Teilbereiche:

Menuleiste
Werkzeugleiste
Arbeitsfläche
Statusleiste

Menuleiste Inhalt

Die Menuleiste entspricht im Wesentlichen dem Design gängiger Programme mit den bekannten Funktionen:
- Datei
  - Öffnen
    Hier kann eine beliebige textbasierte Datei geöffnet und deren Inhalt im Eingabefeld dargestellt werden.
  - Original überschreiben
    Überschreibt die Originaldatei mit dem konvertierten Text
  - Original speichern
    Speichert die Originaldatei aus dem Eingabefeld und überschreibt die geöffnete Datei somit mit sich selbst. Dies dient dem Sichern von Änderungen am Original
  - Speichern unter...
    Weist dem konvertierten Text einen neuen Speicherort zu.
  - Schließen
    Beendet das Programm
- Bearbeiten
  - Textbereiche löschen
    Löscht alle im Arbeitsbereich angezeigten Texte.
  - Konvertieren
    Wandelt die angegebenen Sonderzeichen innerhalb des Textes im Eingabefeld in Entities. Das Ergebnis wird im Ausgabefeld angezeigt.
  - Entities tauschen
    Tauscht Entities im Ausgabefeld vom vorhandenen Typ gegen diejenigen des anderen. Z.B. werden aus HTML-Entities numerische Unicode-Entities und umgekehrt.
    Sonderzeichen werden hiermit nicht konvertiert.
- Extras
  - Optionen
    Öffnet ein Fenster zur Auswahl von Programmoptionen
- Hilfe
  - Hilfe zu Cent
    Diese Hilfe.
  - Über Cent
    Informationen zu diesem Programm und zur GNU General Public License.
Werkzeugleiste Inhalt
- CharacterSet
  Hier kann nach Bedarf ein bestimmter Zeichensatz für das Öffnen einer Datei gewählt werden. Als Standard wird der Zeichnsatz des Betriebssystems verwendet. Nach Wechsel des Zeichensatzes wird die Datei automatisch erneut geladen.
- Datei laden
  Öffnen und laden einer textbasierten Datei in das Eingabefeld.
- Textbereiche leeren
  Löscht die Darstellung des im Arbeitsbereich angezeigten Textes. Die Datei selbst bleibt hiervon unberührt. Eventuelle Änderungen gehen ohne Speichern verloren.
- Suchen/Ersetzen
  öffnet ein Suchfenster mit dem das aktuell fokussierte Fenster nach Textteilen durchsucht werden kann oder mit dem Textteile ersetzt werden können. Die Funktionen sind nur auf den Eingabe- und Ausgabefeldern anwendbar. Eine Suche im HTML-und Sonderzeichenfenster ist nicht möglich.
  Die Aktivierung der Checkbox "Einträge" bewirkt, dass auch im Optionen-Dialog fest gespeicherte Einträge ersetzt werden.
- Konvertieren
  Konvertiert den Inhalt des Eingabefeldes und gibt das Ergebnis im Ausgabebereich und im HTML-Fenster aus.
- Entities tauschen
  Tauscht Entities im Ausgabefeld vom vorhandenen Typ gegen diejenigen des anderen. Z.B. werden aus HTML-Entities numerische Unicode-Entities und umgekehrt.
  Sonderzeichen werden hiermit nicht konvertiert.
- Zeilennummern
  Schaltet in beiden Textbereichen die Anzeige von Zeilennummern an/aus.
  Die Art der Anzeige der Zeilennummern ist von der Einstellung des Zeilenumbruchs der Textbereiche und vom Darstellungstyp der Zeilennummern abhängig.
  Es muss beachtet werden, dass bei größeren Dokumenten die Aktivierung des Zeilenumbruchs der Textbereiche, sowie die Berücksichtigung der Zeilenumbrüche des Originaldokumentes die Darstellung der Zeilennummern verlangsamen kann.
  →default: deaktiviert
- Zeilennummern berücksichtigen Zeilenumbrüche
  Bei Aktivierung werden die Zeilennummern den Zeilenumbrüchen des geladenen Textes angepasst. Umbrochene Zeilen besitzen dann nur eine Nummer. Diese Funktion kann bei größeren Texten die Darstellung der Zeilennummern erheblich verlangsamen. Diese Funktion ist nur bei der Anzeige der Zeilennummern und Berücksichtigung der Zeilenumbrüche aktiv.
  →default: deaktiviert
- Zeilenumbrüche der Texte berücksichtigen
  Bei Aktivierung werden die Zeilen in den Textbereichen bei Überlänge umgebrochen. Deaktiviert ercheinen sie in Originallänge und müssen ggf. horizontal gescrollt werden.
  →default: deaktiviert
- Entity-Typ wechseln
  Stellt den Entity-Zieltyp ein.
  →default: Unicode
- Zwischenablage
  Wenn ausgewählt wird der konvertierte Text automatisch in die Zwischenablage kopiert.
  →default: aktiviert
- Alle Entities konvertieren
  Wenn ausgewählt werden alle Sonderzeichen zu Entities konvertiert, unabhängig davon, ob diese registriert wurden oder nicht. Diese Funktion ist deaktiviert, wenn unter Optionen die Checkbox reverse ausgewählt ist.
  Siehe hierzu auch unter Ampersand.
  →default: deaktiviert
- Ampersand (&) konvertieren
  Wenn ausgewählt wird auch das Zeichen Ampersand (&, Unicode x0026) konvertiert.
  Achtung! Sind im Originaltext bereits Entities enthalten, werden diese hierdurch ggf. zerstört, da das Ampersand & von der Konvertierung ebenfalls betroffen ist!
  →default: deaktiviert
- Sprachdatei
  Dieses Dropdown-Menu existiert nur, wenn im Verzeichnis <Heimatverzeichnis>/.cent/languages mindestens eine Datei mit der Endung .cent vorhanden ist. Die vorhandenen Dateien werden in diesem Fall im Menu mit ihrem Namen ohne Endung angezeigt. Die Auswahl eines Namens lädt den in der gleichnamigen Datei gespeicherten Zeichensatz zur Konvertierung.
  Weitere Informationen zur Anlage von Sprachdateien siehe unter Konvertieren ganzer Zeichensätze

Statusleiste
Die Statusleiste dient von links nach rechts:

der Darstellung des Pfades der geladenen Datei
der Darstellung der Zeile und Spalte der aktuellen Cursorposition
der Darstellung der zum Konvertieren gewählten Zeichen

der Anzeige der gewählten Konvertierungsmodi
Die Textangabe unterscheidet zwischen HTML- und Default-Modus. Rechts von dieser Angabe werden ggf. farbige Markierungen angezeigt, deren Bedeutung von links nach rechts der folgenden Tabelle entnommen werden können.

Modus	aktiv	passiv
HTML	orange	farblos
Zeichen ausschließen	blau	farblos
Alle Entities konvertieren	rot	farblos

Arbeitsfläche Inhalt

Die Arbeitsfläche ist in einen oberen und einen unteren Bereich eingeteilt:
Oben befindet sich das Eingabefeld, im unteren Bereich kann zwischen einem Text-Ausgabefeld, einem HTML-Ausgabefeld und einem Entity-Feld gewählt werden.
- Eingabefeld
  Die Texte im Eingabefeld sind Gegenstand der Konvertierung. Sie können manuell eingegeben oder mit der Funktion 'Öffnen' als textbasierte Datei geladen werden. Es muss jedoch beachtet werden, dass Sonderzeichen nur dann angezeigt werden, wenn das jeweilige Betriebssystem den notwendigen Zeichensatz unterstützt.
- Text-Ausgabefeld
  Das Text-Ausgabefeld zeigt das Ergebnis der Konvertierung. Über die entsprechenden Befehle der Werkzeugleiste werden hier nach Konvertierung Sonderzeichen als HTML- oder Unicode-Entities dargestellt.
- HTML-Ausgabefeld
  Bei HTML-Dateien zeigt das HTML-Fenster das Ergebnis des Text-Ausgabe-Fensters als HTML-Darstellung.
  Bei der Darstellung ist zu beachten, dass relative Pfadangaben (z.B. von CSS, Bildern, etc.) ignoriert werden, da Cent sich in der Regel nicht im Ausgangsverzeichnis der geladenen Datei befindet.
- Sonderzeichen
  Das Sonderzeichen-Fenster zeigt einen Überblick über die als HTML-Entities verfügbaren Zeichen und deren numerische Unicode-Äquivalente. Es muss beachtet werden, dass die Darstellung abhängig vom Betriebssystem ist.
  Zum Konvertieren eines Sonderzeichens klicken Sie auf den entsprechenden Button. In der Statusleiste wird das gewählte Zeichen mit den bereits aktivierten angezeigt.
  Zum Löschen der über das Sonderzeichen-Fenster gewählten Zeichen klicken Sie auf den Radiergummi-Button oben links im gleichen Fenster. Die Auswahl der über den Optionen-Dialog gewählten Zeichen bleibt dabei erhalten.

Optionsdialog Inhalt

Allgemeines
In dieser Registerkarte werden die Grundeinstellungen von Cent vorgenommen.
- Konvertieren von...
  In das Textfeld können Zeichen eingetragen werden, die als Standard für die Konvertierung dienen. Sie werden dann bei jedem Programmstart geladen und bei der Konvertierung eines Textes entsprechend gewandelt. Mehrere Zeichen müssen durch Kommata getrennt eingegeben werden. Durch Aktivierung der Checkbox Zeichen ausschließen werden die hier eingetragenen Zeichen von der Konvertierung ausgeschlossen.
- Zeichen ausschließen
  Bei Aktivierung der Checkbox werden die zur Konvertierung vorgesehenen Zeichen nicht konvertiert.
- HTML-Modus
  Aktiviert den HTML-Modus.
- Characterset
  Dient zur globalen Voreinstellung des Zeichensatzes, der beim Öffnen einer Datei verwendet werden soll.
- Splashscreen
  Aktiviert den Splashscreen beim Programmstart
- Sicherungsdatei
  Dient zur Anlage einer Sicherungsdatei vor der Konvertierung.
- Highlighting
  Hier lässt sich die Farbe des Highlighting der Konvertierungszeichen einstellen.
- Suche
  Hier lässt sich die Farbe des Highlighting der Suchbegriffe einstellen.
- Tabweite
  Der hier eingestellte Wert steuert die Anzahl der Leerzeichen, die in den Ein- und Ausgabefeldern für einen Tabulatorsprung verwendet werden.
Ersetzen
Hier werden Einträge zum Ersetzen von Textelementen vorgenommen.

Arbeit mit Cent Inhalt

Arbeit mit Text-Dateien

Um eine Text-Datei zu bearbeiten, wählen Sie 'Öffnen'. Der Text wird ins Eingabefeld geladen und kann dort ggf. nachbearbeitet werden. Zum Speichern des unkonvertierten Originals klicken Sie den Speichern-Button links neben dem Eingabefeld. Zum Konvertieren klicken Sie den Button Konvertieren. Beachten Sie, dass die zu konvertierenden Zeichen registriert sein müssen. Sie sehen dies daran, dass die registrierten Zeichen in der Statusleiste erscheinen. Nach dem Konvertieren erscheint das Ergebnis in den Fenstern des Ausgabebereichs. Es wird empfohlen, bei der Arbeit mit kompletten HTML-Dateien, diese vorher zu validieren, um eine korrekte Anzeige im HTML-Ausgabe-Fenster zu gewährleisten. Beachten Sie jedoch, dass relative Pfadangaben nicht interpretiert werden.

Zum Speichern konvertierter HTML-Dateien gehen Sie wie folgt vor:

Öffnen Sie die gewünschte Datei.
Nehmen Sie evtl. Änderungen im Eingabefeld vor.
Klicken Sie auf Konvertieren.
Der konvertierte Datei-Text erscheint im Ausgabefeld und kann durch Klicken auf Original überschreiben unter dem Namen der Original-Datei gespeichert werden.
Achtung! Die Original-Datei wird hierdurch überschrieben. Ihr ursprünglicher Inhalt geht verloren und kann nicht wieder hergestellt werden.
Klicken auf Speichern unter... gestattet ein Speichern des konvertierten Textes unter neuem Dateinamen.

HTML-Modus

Der HTML-Modus stellt eine viel verwendete Voreinstellung dar, in der alle Sonderzeichen mit Ausnahme von '<', '>', '&' und '"' in Entities gewandelt werden. Diese Zeichen werden zur Ausweisung von HTML-Quelltext verwendet, sodass standardkonforme HTML-Texte konvertiert werden können, deren Sonderzeichengehalt unbekannt ist ohne die Texte langwierig einzeln zu durchsuchen. Zum Anwenden des HTML-Modus gehen Sie wie folgt vor:

Wählen Sie Extras - Optionen - Registerkarte: Allgemeines
Aktivieren Sie die Checkbox HTML-Modus
Bestätigen Sie die Auswahl durch Klicken auf übernehmen oder ok
Laden Sie die zu konvertierende Datei
Klicken Sie in der Werkzeugleiste auf Konvertieren

Bitte beachten Sie, dass dieser Modus bei HTML-Seiten die zusätzliche Sprachelemente enthalten (Javascript, PHP, etc.) u.U. unzulässige Konvertierungen vornimmt und so die Funktionalität beeinträchtigen kann!

Konfiguration Inhalt

Sonderzeichen registrieren

Vor der Konvertierung müssen die umzuwandelnden Zeichen im Menu Extras - Optionen - Allgemeines unter Zeichen eingetragen werden. Geben Sie dort die entsprechenden Zeichen einzeln durch Kommata getrennt in das Textfeld ein und klicken Sie zum Speichern auf OK. Zeichen, die nicht durch eine Tastatureingabe dargestellt werden können, können durch Kopieren - Einfügen oder durch Eintrag des dezimalen Unicode-Wertes übernommen werden.
Bsp.: % kann durch Eintrag von 37 übernommen werden.
Zusätzlich zu den hier eingetragenen Zeichen sind die temporär über das Sonderzeichen-Fenster gewählten Zeichen Gegenstand der Konvertierung. Alle ausgewählten Zeichen werden in der Statusleiste angezeigt.
Um nicht nur die eingetragenen sondern alle Sonderzeichen zu konvertieren, wenden Sie eine der folgenden Methoden an:

Drücken Sie den Button Alle Entities konvertieren in der Werkzeugleiste. Diese Einstellung konvertiert alle Sonderzeichen. Sehen Sie hierzu jedoch auch die Einstellungen des Ampersand-Buttons.
Wählen Sie die Checkbox 1. Sie bewirkt, dass alle Entities mit Ausnahme der unter Zeichen eingetragenen konvertiert werden. Achtung! Um das Ampersand nicht zu konvertieren muss es eingetragen werden.

Character-Set

Im Dropdown-Menu Character-Set kann die Voreinstellung des Charactersets gewählt werden, mit dem Dateien geöffnet werden. Beachten Sie, dass es bei falsch gewähltem Characterset zu Fehldarstellungen des geladenen Textes kommen kann.

Sicherungsdatei anlegen

Wählen Sie unter Extras - Optionen Sicherungsdatei aus, um Cent vor der Konvertierung eine Sicherungsdatei anlegen zu lassen. Diese wird im gleichen Verzeichnis wie die Originaldatei angelegt und trägt eine Tilde (~) nach der Dateiendung.

Highlighting

Cent kann den Hintergrund der zur Konvertierung eingetragenen Zeichen im Originaltext farbig unterlegen (Highlighting). Wählen Sie hierzu die Checkbox unter Extras - Optionen - Highlighting.
Um eine geeignete Hintergrundfarbe zu wählen, klicken Sie auf das Farbfeld rechts neben der Checkbox. Wählen Sie im sich öffnenden Dialog eine geeignete Farbe und bestätigen Sie durch Klicken auf 'OK'.

Ersetzen von Textelementen

Ähnlich wie beim Tausch von Sonderzeichen zu Entities, können auch Textelemente auf zweierlei Weise getauscht werden.

Im Optionen-Dialog können unter der Registerkarte Ersetzen Zeichen und Textelemente in eine Tabelle eingetragen werden, die durch einen jeweils frei wählbaren Ausdruck ersetzt werden sollen. Die Tabelle muss für Einträge und zur Übernahme ihrer Funktion aktiviert werden. Hierzu setzen Sie das Häkchen in die Checkbox aktivieren. Die eingetragenen Elemente und deren Ersatz werden dauerhaft gespeichert und können wahlweise auf Anforderung oder automatisch beim Laden einer Datei aufgerufen werden. Für das automatische Ersetzen beim Öffnen einer Datei muss die Checkbox automatisch aktiviert sein. Um Fehldarstellungen zu vermeiden, ist jedoch unbedingt sicherzustellen, dass der eingestellte Zeichensatztyp demjenigen der Datei entspricht.
Im Dialogfeld Suchen/Ersetzen kann temporär ein Textelement zum Ersetzen eingetragen und/oder getauscht werden.
Bei Auswahl der Checkbox Einträge werden die dauerhaft gespeicherten Elemente ebenfalls getauscht, falls in der Ersetzen-Karte des Optionen-Dialogs die Checkbox aktivieren aktiviert ist.

Um Textelemente zu entfernen, lassen Sie das Textfeld für das Tauschelement leer.

Konvertieren ganzer Zeichensätze

Cent bietet die Möglichkeit, auch große Gruppen von Zeichen zu konvertieren, ohne dass diese nach dem Wechsel der Zeichen einzeln wieder eingegeben werden müssen. Auf diese Weise können z.B. Konvertierungen feststehender Zeichensätze (z.B. kyrillische oder griechische Buchstaben) bequem geladen und entladen werden. Hierzu muss lediglich einmalig eine einfache Textdatei erzeugt werden, die die in Entities zu tauschenden Zeichen enthält. Die Datei kann bliebig benannt werden, muss jedoch die Endung .cent aufweisen und im Verzeichnis <Heimatverzeichnis>/.cent/languages/ liegen. Sind dort korrekt benannte Dateien vorhanden, wird eine gesonderte Werkzeugleiste mit einem Dropdown-Menu zu deren Auswahl angezeigt.
Die Einträge in diese Dateien müssen so vorgenommen werden, dass nur ein Zeichen pro Zeile vorhanden ist. Die zu konvertierenden Zeichen können als einfache Buchstaben (z.B. ω ) oder als hexadezimale Unicode-Werte in der Form \u<Hexwert> (z.B. \u00D6 ) eingetragen werden. Zeilen, die mit einem Semikolon ( ; ) beginnen werden ignoriert.

Installation Inhalt

Cent benötigt eine Java-Laufzeit-Umgebung der Version >= 1.6.
'XXX' bezeichnet die jeweilige Versionsnummer.

Linux/Unix

Falls noch nicht geschehen, laden Sie die Datei Cent_XXX_noarch.zip hier herunter.
Öffnen Sie ein Konsolenfenster, wechseln Sie in das Verzeichnis, in das Sie den Download geladen haben und entpacken Sie das Archiv:

# cd <Installationsverzeichnis>
# unzip Cent_XXX_noarch.zip

Starten Sie Cent durch Eingabe von

# java -jar Cent_XXX_noarch.jar

Mac OS X

Falls noch nicht geschehen, laden Sie die Datei Cent_XXX_mac.zip hier herunter.
Entpacken Sie das Archiv und kopieren Sie die Dateien Cent_XXX.app in Ihr Programme-Verzeichnis. Starten Sie Cent durch einen Doppelklick auf Cent_XXX.app.

Windows

Falls noch nicht geschehen, laden Sie die Datei Cent_XXX_win.zip hier herunter.
Entpacken Sie das Archiv und kopieren Sie die Dateien Cent_XXX.exe in Ihr Programme-Verzeichnis. Starten Sie Cent durch einen Doppelklick auf Cent_XXX.exe.

Deinstallation Inhalt

Die Deinstallation erfolgt durch einfaches Entfernen der jeweiligen ausführbaren Datei (*.app/*.jar/*.exe) und des im persönlichen Heimat-Verzeichnis des Users angelegten Verzeichnisses .cent . Weitere Dateien oder Einträge werden bei der Installation nicht vorgenommen.