
       --------------------
      | Kephra Version 0.4 |
       --------------------


 1. Vorbemerkungen
 2. Zusammenfassung der Neuheiten
 3. Neu in dieser Version
 4. bekannte Fehler und Probleme
 5. Hinweise
 6. Geplantes


 1. Vorbemerkungen:

 - Willkommen bei Kephra. Dieser Editor wird entwickelt um deine Vorstellungen
   zu Verwirklichen. Für Anregung, Dank und Änderungswünsche besuch unsere Seite
   kephra.sf.net . Mehr Willkommen und über dieses Projekt finest du am Menü-
   punkt Hilfe > Willkommen.

 - Dies ist eine sogenannte, stabile Version für den täglichen gebrauch. Sie
   enthält nur gut getestete Funktionen und Fehler werden meist schnellstmöglich
   mit dem nächsten Patchlever behoben. Wenn du aber neuere Funktionen gleich
   verwenden willst oder mit testen helfen möchtest, verwende Bitte Testversionen
   mit dreistellige Versionsnummern. Tägliche Versionen mit 4 sind nur für ganz
   mutige.


 2. Zusammenfassung der Neuheiten
    + Suchzeile am unteren Ende
    + die ersten 2 Erweiterungen
    + wesentlich bessere drag'n drop-Unterstützung
    + 10 dateiübergreifende Lesezeichen und Geh zur letzten Änderung
    + Kontexmenüs über markiertem Text und der Reiterleiste, die nun 2 optionale
      Knöpfe und bewegliche Reiter hat.
    + Menüs für zuletzt geschloßene Dateien und Templates
    + alle Menüs und Leisten haben Einträge die Zustände kennen oder Häkchen und
      können auf Ereignisse und Informationen reagieren
    + alle Menüs und Werkzeugleisten sind mit einfachen yaml-Dateien angepassbar
    + Menülabels haben Umlaute
    + autosave, autonotify and blockformat
    + Dateien umbenennen und alle Dateien eines Verzeichnisses öffnen


 3. NEU in dieser Version (ausführlich)

 - Suchzeile
    + Diese sichtbarste und nützlichste Neuerung findet ihr am unteren Rand, über
      der Statuszeile. Sie enthält eine Textzeile, die man anklicken oder mit
      <strg>+<F> anwählen kann (und damit auch wieder zurückspringen kann). Fängt
      man dann an einen Begriff dort einzugeben, wird bereits nach der Eingabe
      gesucht (inkrementelle Suche). Das war schon vom Dialog bekannt nur konnte
      der das Gefundene verdecken, die Suchzeile nicht.
    + Es ist jetzt auch möglich, einen markierten Text in die Textfelder der Such-
      zeile und des Suchdialoges mit der Maus zu ziehen. (Drag'n Drop)
    + In der Combobox kann man auch mit den Tasten <Hoch> und <Runter> bereits
      verwendete Suchbegriffe auswählen.
    + Folgende Tastaturkombinationen tun das gleiche wie im Textfeld und dienen
      der Navigation: <Bildhoch>, <Bildrunter>, beides auch mit <Strg> zum wechseln
      des Dokumentes sowie <Strg>+<Richtungstasten>.
    + <Enter> bzw. <Shift>+<Enter> sucht nach dem nächsten oder vorigen Vorkommen
      des Suchbegriffes. Diese Funktionen bringen auch die beiden Knöpfe rechts
      der Kombobox. <Strg>+<Enter> läßt zum ersten Fundort, +<Shift> zum letzten
      springen.
    + Der dritte aktiviert das neue "goto last edit" (<Strg>+<Shift>+<G>),
      welches den Cursor an die Stelle springen lässt, an dem dieser Text zuletzt
      geändert wurde.
    + Der letzte Knopf ruft den bekannten Suchdialog, der alle Such- und Ersetzen-
      funktionen beinhaltet. Das Ändern der Suchoptionen geht aber auch mit einem
      Kontextmenü das sich bei Rechtsklick über der Suchzeile öffnet.
    + Sie kann auch mit dem roten X ganz links zugeklappt werden und wird sich
      mit dem nächsten Aufruf wieder öffnen. Ein Verlassen mit <Strg>+<Q> schließt
      auch.

 - Lesezeichen und noch mehr Navigation
    Wenn es nicht genügt, daß der Editor den Ort der letzten Änderung speichert,
    verwendet Lesezeichen. Derer gibt es insgesamt 10, denn ihr Name entspricht
    den Ziffern 0 bis 9. Mit <Strg>+<Shift>+<Ziffer> wird das Lesezeichen in der
    aktuellen Zeile gesetzt und erscheint als blauer Pfeil links neben der Zeilen-
    nummer. Wenn nicht, sollte man im Menü "Ansicht" den "Markerrand" aktivieren.
    Falls unter dieser Ziffer bereits ein anderes Lesezeichen bestand, wurde es
    soeben hierher bewegt und falls es sich hier befand, wurde es soeben gelöscht.
    <Strg>+<Ziffer> bewegt den Cursor zum Dokument und der Stelle des Lesezeichens.
    + Das Blockweise navigieren mit dem Cursor hab ich auf <Alt>+<Bildhoch>
      (<Bildrunter>) verlegt. Textblöcke werden von Leerzeilen getrennt.
    + Neu ist auch die Klammernavigation die mit <Alt>+Richtungstasten bedient
      wird. Dabei kann man mit den vertikalen Richtungstasten zwischen den Klammern
      gleicher Art springen, mit den Horizontalen zwischen Klammern aller Art.
    + Mit <Alt>+<Shift>+<Richtungstasten> kann man allerdings nicht Text zwischen
      Klammern markieren sondern eine rechteckige Textauswahl treffen, wie es vorher
      nur möglich war, wenn man <Alt> gedrückt hält und mit der Maus auswählt.
    + <shift>+<Rück> Zieht Leerzeichen in Tabulatorbreite ein.
    + Springen zum zuletzt sichtbaren Dokument geht jetzt mit <Strg>+<Shift>+<Rück>.

 - Dateimenü
    Diese Menü erhielt mit 2 neuen Funktionen und 2 neuen Untermenüs die meisten
    Erweiterungen.
    + Das Untermenü Templates zählt selbt definierte Textbausteine auf, die man
      somit einfügen kann. Die zugehörige Datei wird unter file > templates bestimmt
      und kann über den Menüeintrag Einstellungen > Templates geöffnet werden.
    + Damit das Dateimenü nicht zu lang wird, habe ich 3 "Öffnen"-Funktionen in
      ein Untermenü gegeben. Darin befindet sich auch eine Funktion zum öffnen aller
      Dateien eines Verzeichnisses, die sicher noch erweitert werden kann.
    + "Zuletzt Verwendete" zählt die zuletzt geschlossenen Dateien auf, die hier
      wieder geöffnet werden können. file > history > length bestimmt die Länge
      dieses Menüs.
    + In der "Speichern"-Gruppe findet sich jetzt eine Funktionen, die auch mit
      <Strg>+<Alt>+<Shift>+<S> aufrufbar ist, und das Umbenennen der gerade offenen
      Datei ermöglicht.
    + Alle Schließen-Funktionen haben nun einen "ohne speichern"-Zwilling.
    + Auch das Untermenü für Dateigruppen ist um 2 Funktionen reicher. Es kann
      nun eine alternative Dateigruppe (session) unter einem in der Hauptconfig
      angegebenen Dateinamen (file > session > backup) gespeichert und wieder
      hergestellt werden, ohne jedes mal den Dateinamen eingeben zu müssen.

 - Drag 'n Drop
    Sicher konnte man schon in Version 0.3 Dateien und Verzeichnisse öffnen, in
    dem man sie über die Reiterleiste zog und dort losließ. Da dies aber keine
    wirklich große Fläche ist, mag dies vielen nicht aufgefallen sein. Jetzt
    kann man zum Glück dies über der gesamten Fläche des Editors tun, was für
    mich auch eine große Erleichterung ist.

 - Textbearbeitung
    + Im Untermenü "Formatieren" sind 4 neue Einträge die 2 neue Funktionen des
    Editors verwenden. Das ist zum einen "Zeilen umbrechen". Im Gegensatz zum
    rein optischen Zeilenumbruch, werden hier Zeilen, die eine bestimmte Länge
    überschreiten, wirklich in mehrere ausgeteilt. "Blockformat" hingegen "füllt"
    auch halbleere Zeilen mit der nächsten auf und erzeugt so massive Textblöcke,
    deren linke Begrenzung sich bei aktivierter autoeinrückung an der Einrückung
    der ersten Zeile orientiert. Beide Funktionen gibt es im in den Varianeten:
    a) Begrenzung am rechten Rand und b) formatiere auf eine frei wählbare Breite.

 - Kontextmenüs und Leisten
    Nicht nur über der neuen Suchzeile findet ihr neue Kontextmenüs wenn ihr die
    rechte Maustaste drückt:
    + Das wichtigste ist vielleicht das Menü das sich bei markiertem Text zeigt.
      Durch sinnvolles Aufteilen der Funktionen in 2 Menüs konnte ich nicht nur
      mehr Funktionen einbringen, sondern es bieten sich zumeist nur die Funktionen
      an, die in der Situation auch sinnvoll sind.
    + In die Reiterleiste können nun die Reiter auch bewegt werden. Voerst nur mit
      den Tasten <Strg>+<BildHoch>|<BildRunter>.
    + Neu sind auch die 2 optionalen Icons in der Reiterleiste je ganz links
      (neues Dokument) und ganz rechts (Dokument schließen). Auch läßt sich mit dem
      globalen Einstellungsschlüssel app > tabbar > middle_click definieren, welche
      funktion die mittlere Maustaste über der Reiterleiste bekommt.
    + Das Menü über der Reiterleiste listet alle offenen Dokumente mit dem vollen
      Pfad der zugehörigen Dateien auf und man kann hier auch das aktuelle Dokument
      wechseln.
    + Die Kontextmenüs über den Zellen der Statuszeile sind jetzt auch alle nur
      noch mit dem  Rechtsklick sichtbar zu machen. Ein Linksklick schaltet die
      Funktioen an oder aus oder wechselt zwischen den wichtigsten Einstellungen.
    + Die zweite Zelle der Statuszeile zeigt übrigens jetzt auch die Anzahl der
      markierten Zeilen an.

 - Einstellungen
    Die neuen Menüs und Leisten sind nützlich, aber die wirklich große Änderung
    von 0.3 zu 0.4 war das Ersetzen des XRC gegen etwas Eigenes und mächtigereres.
    + Dadurch findet ihr in den Menüs jetzt endlich deutsche Umlaute.
    + Auch einzelne Einträge können mit einem Häckchen (ja/nein) oder Kreis
      (Auswahl) versehen sein werden, oder auch deaktiviert werden. Knöpfen in
      Werkzeugleisten können einen eingedrückten Zustand haben.
    + Neu ist auch die in dem Menü Einstellungen > Benutzerschnittstellen
      auffindbare Kommandoliste, in der bestimmt wird, welcher interne Befehl,
      Tastaturkombination und Symbol zu zu einem Kommando gehört. Auch welche
      Ereignisse ihn deaktivieren und welche internen Funktionen seinen Zustand
      bestimmen, wird hier festgelegt. Welches Etikett und welcher Hilfetext zu ihm
      gehört steht in den Sprachdateien (auch im Menü Einstellungen), die nun die
      gesamte Übersetzung des Editors in eine Sprache beinhalten. Wenn ihr ihn in
      eine übersetzen wollt meldet euch ruhig bei mir für Hilfe.
    + Unter Einstellungen > Benutzerschnittstellen findet ihr auch die neuen
      Dateien in YAML, mit denen ihr ganz leicht die Menüs und Leisten ändern könnt.
      Für vorübergehendes kommentieren einzelner Einträge benutzt bitte eine Raute
      (#) am Ende der Zeile.
    + mit the global Config-Schlüssel "app > window > title" kann nun auch die
      Titelleiste verändert werden. Welche Informationen, die sich aktualisieren
      werden, dort verwendet werden können, steht in den Kommantaren des Moduls
      Kephra::Config::Default::GlobalSettings.
    + Die im Titel angezeigten Pfade sind jetzt auch immer OS-konform.

 - die ersten 2 Erweiterungen
    + Mit <Strg>+<F4> oder dem Icon in der Werkzeugleiste öffnet und schließt
      sich der Notitzblock. In ihm geschriebene Texte sind immer sichtbar, auch
      beim nächsten Start des Programms. <F4> lässt den Cursor hin oder zurück
      springen und <F5> evaluiert den Inhalt als Perl.
    + Befindet sich der Cursor im Beabeitungsfeld führt <F5> das aktuelle Perl-
      Programm aus und fügt die die Ausgabe ins Ausgabefeld ein. <Shift>+<F5>
      kann das Programm auch abbrechen lassen und <Strg>+<F5> läßt das Ausgabefeld
      auf und zuklappen.
    + Alle Einstellungsmöglichkeiten der Erweiterungen sind unter app > panel
      zu finden.



 4. bekannte Fehler und Probleme

    + Installation aus der CPAN-Shell derzeit nur mit force und manchmal ist es 
      auch noch nötig die configs manuell zu kopieren.


 5. Hinweise

    + Lest die "Nützliche Funktionen - Tour". Es gibt einige wenig bekannte aber
      umso nützlicherere Funktionen für fortgeschrittene Benutzer hier zu entdecken.

    + Um die Haupteinstellungsdatei besser zu verstehen hilft es die Datei mit
      den Voreinstellungen: kephra/config/global/default/default.conf zu lesen,
      denn sie ist auskommentiert, wenn auch bloß englisch.


 6. Geplantes

    + Jaja die ungelegten Eier. Aber zu 0.5 hätten wir gerne Funktionen die eher
      für Programmier sind wie Templatebibliohteken, Dateimanager, Befehlszeile,
      Debugger, Text falten oder Outline (Liste aller Variablen und Routinen).

    + Und drucken sowie UTF-Uterstuetzung wäre natürlich auch nicht schlecht.