
       --------------------
      | 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. Fr Anregung, Dank und nderungswnsche 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 fr den tglichen gebrauch. Sie
   enthlt nur gut getestete Funktionen und Fehler werden meist schnellstmglich
   mit dem nchsten Patchlever behoben. Wenn du aber neuere Funktionen gleich
   verwenden willst oder mit testen helfen mchtest, verwende Bitte Testversionen
   mit dreistellige Versionsnummern. Tgliche Versionen mit 4 sind nur fr ganz
   mutige.


 2. Zusammenfassung der Neuheiten
    + Suchzeile am unteren Ende
    + die ersten 2 Erweiterungen
    + wesentlich bessere drag'n drop-Untersttzung
    + 10 dateibergreifende Lesezeichen und Geh zur letzten nderung
    + Kontexmens ber markiertem Text und der Reiterleiste, die nun 2 optionale
      Knpfe und bewegliche Reiter hat.
    + Mens fr zuletzt geschloene Dateien und Templates
    + alle Mens und Leisten haben Eintrge die Zustnde kennen oder Hkchen und
      knnen auf Ereignisse und Informationen reagieren
    + alle Mens und Werkzeugleisten sind mit einfachen yaml-Dateien angepassbar
    + Menlabels haben Umlaute
    + autosave, autonotify and blockformat
    + Dateien umbenennen und alle Dateien eines Verzeichnisses ffnen


 3. NEU in dieser Version (ausfhrlich)

 - Suchzeile
    + Diese sichtbarste und ntzlichste Neuerung findet ihr am unteren Rand, ber
      der Statuszeile. Sie enthlt eine Textzeile, die man anklicken oder mit
      <strg>+<F> anwhlen kann (und damit auch wieder zurckspringen kann). Fngt
      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 mglich, 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 auswhlen.
    + 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 nchsten oder vorigen Vorkommen
      des Suchbegriffes. Diese Funktionen bringen auch die beiden Knpfe rechts
      der Kombobox. <Strg>+<Enter> lt 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 lsst, an dem dieser Text zuletzt
      gendert 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 nchsten Aufruf wieder ffnen. Ein Verlassen mit <Strg>+<Q> schliet
      auch.

 - Lesezeichen und noch mehr Navigation
    Wenn es nicht gengt, 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 gelscht.
    <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. Textblcke 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 mglich war, wenn man <Alt> gedrckt hlt und mit der Maus auswhlt.
    + <shift>+<Rck> Zieht Leerzeichen in Tabulatorbreite ein.
    + Springen zum zuletzt sichtbaren Dokument geht jetzt mit <Strg>+<Shift>+<Rck>.

 - Dateimen
    Diese Men erhielt mit 2 neuen Funktionen und 2 neuen Untermens die meisten
    Erweiterungen.
    + Das Untermen Templates zhlt selbt definierte Textbausteine auf, die man
      somit einfgen kann. Die zugehrige Datei wird unter file > templates bestimmt
      und kann ber den Meneintrag Einstellungen > Templates geffnet 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" zhlt die zuletzt geschlossenen Dateien auf, die hier
      wieder geffnet werden knnen. file > history > length bestimmt die Lnge
      dieses Mens.
    + 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 ermglicht.
    + Alle Schlieen-Funktionen haben nun einen "ohne speichern"-Zwilling.
    + Auch das Untermen fr 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 mssen.

 - 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 groe Flche ist, mag dies vielen nicht aufgefallen sein. Jetzt
    kann man zum Glck dies ber der gesamten Flche des Editors tun, was fr
    mich auch eine groe Erleichterung ist.

 - Textbearbeitung
    + Im Untermen "Formatieren" sind 4 neue Eintrge 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 Lnge
    berschreiten, wirklich in mehrere ausgeteilt. "Blockformat" hingegen "fllt"
    auch halbleere Zeilen mit der nchsten auf und erzeugt so massive Textblcke,
    deren linke Begrenzung sich bei aktivierter autoeinrckung an der Einrckung
    der ersten Zeile orientiert. Beide Funktionen gibt es im in den Varianeten:
    a) Begrenzung am rechten Rand und b) formatiere auf eine frei whlbare Breite.

 - Kontextmens und Leisten
    Nicht nur ber der neuen Suchzeile findet ihr neue Kontextmens wenn ihr die
    rechte Maustaste drckt:
    + Das wichtigste ist vielleicht das Men das sich bei markiertem Text zeigt.
      Durch sinnvolles Aufteilen der Funktionen in 2 Mens 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 knnen 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 schlieen). Auch lt sich mit dem
      globalen Einstellungsschlssel 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 zugehrigen Dateien auf und man kann hier auch das aktuelle Dokument
      wechseln.
    + Die Kontextmens 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 Mens und Leisten sind ntzlich, aber die wirklich groe nderung
    von 0.3 zu 0.4 war das Ersetzen des XRC gegen etwas Eigenes und mchtigereres.
    + Dadurch findet ihr in den Mens jetzt endlich deutsche Umlaute.
    + Auch einzelne Eintrge knnen mit einem Hckchen (ja/nein) oder Kreis
      (Auswahl) versehen sein werden, oder auch deaktiviert werden. Knpfen in
      Werkzeugleisten knnen einen eingedrckten 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 gehrt. Auch welche
      Ereignisse ihn deaktivieren und welche internen Funktionen seinen Zustand
      bestimmen, wird hier festgelegt. Welches Etikett und welcher Hilfetext zu ihm
      gehrt 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 fr Hilfe.
    + Unter Einstellungen > Benutzerschnittstellen findet ihr auch die neuen
      Dateien in YAML, mit denen ihr ganz leicht die Mens und Leisten ndern knnt.
      Fr vorbergehendes kommentieren einzelner Eintrge benutzt bitte eine Raute
      (#) am Ende der Zeile.
    + mit the global Config-Schlssel "app > window > title" kann nun auch die
      Titelleiste verndert werden. Welche Informationen, die sich aktualisieren
      werden, dort verwendet werden knnen, 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 schliet
      sich der Notitzblock. In ihm geschriebene Texte sind immer sichtbar, auch
      beim nchsten Start des Programms. <F4> lsst den Cursor hin oder zurck
      springen und <F5> evaluiert den Inhalt als Perl.
    + Befindet sich der Cursor im Beabeitungsfeld fhrt <F5> das aktuelle Perl-
      Programm aus und fgt die die Ausgabe ins Ausgabefeld ein. <Shift>+<F5>
      kann das Programm auch abbrechen lassen und <Strg>+<F5> lt das Ausgabefeld
      auf und zuklappen.
    + Alle Einstellungsmglichkeiten 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 ntig die configs manuell zu kopieren.


 5. Hinweise

    + Lest die "Ntzliche Funktionen - Tour". Es gibt einige wenig bekannte aber
      umso ntzlicherere Funktionen fr 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 htten wir gerne Funktionen die eher
      fr Programmier sind wie Templatebibliohteken, Dateimanager, Befehlszeile,
      Debugger, Text falten oder Outline (Liste aller Variablen und Routinen).

    + Und drucken sowie UTF-Uterstuetzung wre natrlich auch nicht schlecht.