# This is a bilingual file (German and English). # English text: see below. Lesung for Palm OS Version 3.5a ----------------------------------------------------------------- Stand: 01.01.2009 (*) Neuerungen und Update (I) Allgemeines und Installation (II) Bedienung (III) Kontakt ----------------------------------------------------------------- (*) Neuerungen und Update ----------------------------------------------------------------- - Neu in Lesung 3.5a: -- Lizenzänderung: Programm ist nun Freeware unter GNU/GPL v2 -- Creator ID von PLES wieder auf PLOS gesetzt, so dass die alten Module von Losungen für Palm OS weiter verwendet werden können - Neu in Lesung 3.5: -- Namensänderung von "Losungen für Palm OS" in "Lesung für Palm OS" -- Creator ID auf PLES gesetzt -- Menü- und Infotexte angepasst - Das Programm wurde geschrieben, um die Herrnhuter Losungen auf Palm-OS-Geräten anzuzeigen. Zum Jahresende 2007 endete der Lizenzvertrag, so dass das Programm seither unter dem Namen "Lesung" und ohne die Losungs-spezifischen Infotexte zur Verfügung gestellt wird. - Mit dem Kommandozeilen-Programm "mkles" kann man sich selbst (und anderen) aus einer Textdatei leicht ein Modul für "Lesung" generieren, siehe www.axios.de/palm - Lesung 3.5a hat nun wieder dieselbe Programm-ID (Creator ID) wie Losungen 3.x, so dass es als Nachfolgeversion mit den alten Modulen eingesetzt werden kann. Eine bereits installierte Fassung von Losungen 3.x wird allerdings bei der Installation von Lesung 3.5a ersetzt. ! Bitte beachten Sie die Tips und Hinweise. ----------------------------------------------------------------- (I) Allgemeines und Installation ----------------------------------------------------------------- - Das Programm kann täglich wechselnde Texte wie die Herrnhuter Losungen, andere Zusammenstellungen von Bibelversen, Andachten etc. anzeigen. - Zusätzlich zum Programm benötigen Sie Textmodule, die sie mit dem unter www.axios.de/palm frei erhältlichen Programm "mkles" selbst erzeugen, dort verlinkt finden oder möglicherweise an anderer Stelle im Internet erhalten können. - Wenn das jeweilige Textmodul dafür vorbereitet ist, können täglich zwei oder vier Bibelverse referenziert und in dem Open-Source-Programm Bible+ direkt aufgerufen werden. - Wenn passende AFNT-Fonts installiert sind, können Module in verschiedenen Zeichensätzen (z. B. westeuropäisch, türkisch, russisch, hebräisch) verwendet und richtig angezeigt werden. - Rechte/Lizenzbestimmungen: Das Anwendungsprogramm 'Lesung 3.5a für Palm OS' ist urheberrechtlich geschützt, darf jedoch im Rahmen der GNU/GPL v2 (http://www.gnu.de/documents/gpl-2.0.de.html) kostenfrei beliebig genutzt, verändert und weiter gegeben werden. Die Verwendung geschieht auf eigene Gefahr und ohne jegliche Gewährleistung durch den Autor. Der Autor des Programms ist für nicht von ihm bereit gestellte Module nicht verantwortlich. - Systemvoraussetzungen: Palm OS 2.0 oder höher. Je nach Zeichensatz/ Sprachversion des verwendeten Geräts benötigen einige Module zur korrekten Anzeige bereits installierte Lokalisierungssoftware oder externe passende Schriften. Empfohlen wird die Verwendung von kostenfreien AFNT-Fonts, siehe dazu ausfuehrlich www.axios.de/palm/palm_afnt.html - Installation: Bitte einfach das Programm 'ples35.prc' und vorhandene Module per Hotsync auf das Gerät übertragen. ! Wenn man mit mehreren Modulen arbeiten möchte, sollte das Programm selbst im Hauptspeicher (RAM) abgelegt werden, nicht auf einer Speicherkarte, da es sonst beim Starten jedesmal zuerst in den Hauptspeicher kopiert wird, was einige Sekunden benötigen kann. Die Module können auf Speicherkarten liegen. - Deinstallation: Zum Löschen einzelner Module (auch auf Speicherkarten) verwenden Sie den Modul-Manager des Programms, zum Löschen von Programm und Modulen verwenden Sie die Löschfunktion des Betriebssystems. ----------------------------------------------------------------- (II) Bedienung ----------------------------------------------------------------- - Grundansicht: Wenn ein Textmodul geladen ist, bedeuten die Knöpfe am unteren Bildschirmrand von links nach rechts: << = Woche zurueck < = Tag zurueck (auch mit Links-Taste oder Strich nach links) [] = Datum wählen (auch mit /G oder ueber das Menue) > = Tag vor (auch mit Rechts-Taste oder Strich nach rechts) >> = Woche vor ? = Zufallsfunktion (siehe unten) A = Schriftart wechseln - Modulauswahl: Der kleine Pfeil rechts oben im Display öffnet eine Drop-down- Liste mit allen gefundenen Modulen. Hier können Sie zwischen den Modulen wechseln. Das gerade aktive Modul erkennen Sie auch an der Markierung in der Liste. ! Das aktive Modul wechselt nicht mit dem Kalenderjahr und umgekehrt! Wenn Sie die Texte für ein anderes Jahr anzeigen wollen, verwenden Sie bitte die Modul-Liste, nicht den Datumsdialog. - Modul-Manager: Hier können Sie Module gezielt kopieren und löschen. Wird 'VFS/ Speicherkarten' aktiviert, sucht Lesung auch auf maximal zwei externen Speicherkarten nach Modulen. Es werden standardmässig auf beiden Karten (sofern vorhanden) drei Verzeichnisse durchsucht: /PALM/Launcher /PALM/Lesung /PALM/Programs Zum Kopieren das gewuenschte Modul markieren, dann ueber die Drop-down-Liste das Ziel auswählen und 'Kopieren' druecken. Ein Kopieren zwischen den Karten funktioniert nur ueber den Umweg ueber den Arbeitsspeicher. Module auf Speicherkarten können nicht ueberschrieben werden (ggf. altes Modul zuvor löschen). ! Ist VFS deaktiviert, können durchaus Module auf einer Speicher- karte vorhanden sein, sie werden jedoch nicht gesucht und entsprechend auch nicht gefunden bzw. angezeigt. Bei aktiviertem VFS stoppt Lesung aus Ressourcengruenden die Suche nach 24 gefundenen externen Modulen. ! In den Standardverzeichnissen können sehr viele Dateien liegen, die Lesung bei jeder Suche öffnen und untersuchen muss. Daher kann es sinnvoll sein, Lesungs-Module nur unter /PALM/Lesung abzulegen und die Suche auf dieses Verzeichnis zu beschränken. ! Die angezeigten Namen sind die internen Modulnamen, nicht die Dateinamen. Die Dateinamen der Module sind beliebig, muessen jedoch auf .pdb enden. Fuer umfangreiches Arbeiten mit Speicherkarten verwenden Sie bitte einen Dateimanager. ! Neuere Palm-Geräte enthalten teilweise zusätzliche Speicherbereiche. Gesucht und gefunden werden derzeit allerdings nur die Module auf "Karte" 1/2. - Lesezeichen: Da Lesung immer mit dem Tagesdatum startet, kann ein Lese- zeichen gesetzt werden, d. h. ein beliebiges Datum (Tag/Monat) wird intern markiert. Ueber das Kuerzel /G kann man schnell zu diesem Tag springen. Das Lesezeichen legt nicht Jahr oder Modul fest, ist also in allen Modulen verfuegbar. Um das Lesezeichen neu zu setzen, einfach am gewuenschten Tag /S ("Setzen") aufrufen. - Suche: Ruft man die systemweite Suchfunktion aus Lesung heraus auf, werden die Lesungs-Module mit durchsucht. Ruft man die Suche aus einem anderen Programm heraus auf, werden die Lesungs-Module ausgelassen, um die Suche nicht unnötig zu verlängern. ! Auf nicht-asiatischen Geräten findet die Palm-OS-Suchfunktion den Suchtext nur am Anfang eines Wortes, die Suche nach "ömer" bringt also normalerweise kein Ergebnis, wohl aber die Suche nach "rö". ! Bei invertiertem Text (hebräisch, arabisch) sollte der Suchtext maximal ein Wort umfassen, da die angezeigte Zeichenreihenfolge anders ist als die im Modul gespeicherte (visuell/logisch) und der gewuenschte Text daher nicht gefunden werden kann. - Schriften: Ueber den 'A'-Knopf wird zwischen den vier Standardschriften (normal, fett, gross, gross und fett) gewechselt, sofern nicht fuer das aktuelle Modul ein (externer) AFNT-Font aktiv ist. - Fenstergrösse: Sofern die Hardware es unterstuetzt, läßt sich die Ansicht dynamisch vergrössern/verkleinern und rotieren. Sie passt sich verschiedenen Auflösungen und Displaygrössen an, auch Querformat und Alphasmart Dana. Einstellungen-Dialog: - Deutsches Menue: zeigt Menue und Infotexte in deutscher Sprache an. - Modulnamen oben anzeigen: zeigt den Namen des angezeigten Moduls ständig rechts oben an. - Link zu Bible+ (OS 3.5+): [ Bible+ ist ein verbreitetes, kostenfreies Bibelprogramm fuer Palm OS (Open Source unter GNU/GPL) mit zahlreichen verfuegbaren Bibel-Modulen, siehe http://palmbibleplus.sf.net Eine vollständiges deutsches Bibelmodul (Schlachter 1951) fuer Bible+ finden Sie unter http://www.axios.de/palm/download/scb51_pb.zip ] Wenn aktiviert, erscheinen im Menuepunkt "Gehe zu" zwei oder vier neue Einträge: "» AT-Vers" etc., mit denen man vier Bibelstellen in Bible+ direkt aufrufen kann: AT-/NT-Vers, Tagestext und fortlaufender Bibeltext. ! Diese Menuepunkte erscheinen nicht, wenn das aktuelle Modul keine Link-Informationen enthält. ! Fuer diese Funktion muss Bible+ im Hauptspeicher (RAM) des Geräts liegen (nicht auf einer Karte), und bereits einmal gestartet worden sein. Lesung prueft erst beim Aufruf der Sprungfunktion, ob Bible+ ueberhaupt vorhanden ist. ! Ältere Versionen von Bible+ stuerzen ab, wenn ein nicht vorhandenes Buch geöffnet werden soll, z. B. Genesis in einem Greek New Testament. Um das zu vermeiden, prueft Lesung, ob die aktuelle Bibel das gewuenschte Buch enthält. Wenn nicht, versucht Lesung, eine andere Bibel zu finden, in der das Buch vorhanden ist. Auf Speicherkarten wir in folgenden Verzeichnissen gesucht: /PALM/Programs/Bible+ /PALM/Programs/PPBL /PALM/Launcher ! Bitte verwenden Sie daher nach Möglichkeit aktuelle Versionen von Bible+ (3.1.36 und höher)! ! Durch geringfuegig unterschiedliche Verszählungen in verschiedenen Bibeluebersetzungen bzw. Sprachen kann es zu einzelnen Abweichungen beim angezeigten Vers kommen, vor allem um einen Kapitelwechsel herum. ! Die Module von Lesung können unterschiedlich viele Bibelstellen pro Tag enthalten. Ueber das Menue sind bis zu vier Bibelstellen aufrufbar. Hinweis fuer Nutzer von Olive Tree BibleReader bzw. OliveTree BibleR+: Ein Link von Lesung auch zu diesem Programm war beabsichtigt, die dazu nötigen Informationen wurden vom Programmhersteller jedoch nicht bereitgestellt. - Zufallstext anzeigen: Wenn aktiviert, erscheint in der Grundansicht unten neben dem "A"-Knopf ein zusätzlicher "?"-Knopf. Wird er gedrueckt, springt das Programm zu einem (pseudo-)zufälligen Tag im aktuellen Modul. - AFNT-Fonts (OS 3+): Die meisten Geräte verwenden als eingebauten Zeichensatz Latin-1 (ähnlich ISO 8859-1). Durch zusätzliche externe AFNT-Schriften können Module in vielen Zeichensätzen (griechisch, hebräisch, russisch, ...) ohne Fremdsoftware angezeigt werden. Ist diese Funktion aktiviert, sucht Lesung jeweils beim Öffnen eines Moduls, ob ein zum Zeichensatz des Moduls passender AFNT-Font vorhanden ist, und verwendet diesen. Ausfuehrlichere Dokumentation und Fonts unter www.axios.de/palm/palm_afnt.html ! Asiatische Geräte können mit einem Latin-AFNT-Font auch Umlaute darstellen. - Anzeige beim Systemstart (Startup-Funktion, OS 3.5+): Wenn das Kästchen aktiviert ist, wird Lesung beim Anschalten des Geräts bzw. nach Passworteingabe angezeigt, wenn seit dem Ausschalten mindestens die eingestellte Zeit (Stunden : Minuten) vergangen ist. Eine Zeit "00:00" bedeutet, Lesung wird bei jedem Anschalten angezeigt. (Andere Programme, die beim Systemstart aktiv sind, können u. U. die Anzeige von Lesung verhindern.) - Für Programmierer: Der Aufruf von Lesung aus anderen Programmen ist über die bekannten Systemfunktionen möglich. Ohne Parameter wird der aktuelle Tagestext im zuletzt verwendeten Modul geladen, über den Launch Code sysAppLaunchCmdGoTo kann zu einem bestimmten Tag gesprungen werden: ((GoToParamsPtr) cmdPBP)->recordNum = Tag (1-365; 29.02. = 366) Ggf. mit Markierung im Text: ((GoToParamsPtr) cmdPBP)->matchPos = Markierung ab Zeichen # ((GoToParamsPtr) cmdPBP)->searchStrLen = Markierung von # Zeichen Wenn ein bestimmtes Modul verwendet werden soll: ((GoToParamsPtr) cmdPBP)->dbID = (!NULL) oder (Modul-dbID), und: ((GoToParamsPtr) cmdPBP)->matchCustom = Modul # (RAM, dann Karte 1/2) ----------------------------------------------------------------- (V) Kontakt ----------------------------------------------------------------- Klaus Steigert, Giessen/Germany, palm at axios dot de, www.axios.de/palm ----------------------------------------------------------------- # # English section starts here ... # Lesung for Palm OS Version 3.5a ----------------------------------------------------------------- Last mod. 2009-01-01 (*) News and update (I) General information and installation (II) Manual (III) Contact ----------------------------------------------------------------- (*) News and update ----------------------------------------------------------------- - New in Lesung 3.5a: -- License change: application is now freeware (GNU/GPL v2) -- Creator ID set back to PLOS for better compatibility with Losungen modules - New in Lesung 3.5: -- Name change from "Losungen for Palm OS" to "Lesung for Palm OS" -- Creator ID changed to PLES -- Menu and info text changed - The application had been written to display the watchwords (daily bible verses), published by the Evangelische Brüder Unität, on Palm OS devices. As the license agreement ended, since January 2008 the application is available as "Lesung for Palm OS" without the Losungen-specific information. - A tool for generating text modules is freely available at www.axios.de/palm - Lesung 3.5a now again has the same application ID (Creator ID) as Losungen 3.x, so that both applications can use the same modules. ! Please read the notes and tips. ----------------------------------------------------------------- (I) General information and installation ----------------------------------------------------------------- - The application displays daily changing text, like daily bible verses, devotional text etc. - In addition to the application, you need at least one text module, to be found at www.axios.de/palm, somewhere else in the internet, or generated by yourself. - Depending on the text module, two or four scriptures (bible verses) can be referenced and directly addressed in the open-source application Bible+ (PalmBiblePlus). - If corresponding AFNT fonts are installed, modules can be of different code pages like Western European, Turkish, Russian, or Hebrew, and be displayed correctly. - Rechte/Lizenzbestimmungen: Das Anwendungsprogramm 'Lesung 3.5a für Palm OS' ist urheberrechtlich geschützt, darf jedoch im Rahmen der GNU/GPL v2 (http://www.gnu.de/documents/gpl-2.0.de.html) kostenfrei beliebig genutzt, verändert und weiter gegeben werden. Die Verwendung geschieht auf eigene Gefahr und ohne jegliche Gewährleistung durch den Autor. Der Autor des Programms ist für nicht von ihm bereit gestellte Module nicht verantwortlich. - Legal information/Copyright: The application 'Lesung 3.5a für Palm OS' is copyrighted and may be used, shared, and modified for free according to GNU/GPL v2 (http://www.gnu.org/licenses/gpl-2.0.html). Use the application on your own risk, no warranties given. The author of the application is not responsible for modules not published by himself. - System requirements: Palm OS 2.0 or higher. Depending on language version/localization of the device, some modules may need modules may need localization software or external fonts. It is recommended to use AFNT fonts, please see www.axios.de/palm/palm_afnt.html - Installation: Please install the application 'ples35.prc' and at least one module by hotsync on your device. ! If you intend to work with several modules, you should place the application itself in RAM, not on an expansion card. Otherwise, the application will be copied to RAM first every time you start Lesung, which may need some time. - Deinstallation: To delete modules individually from RAM or a memory card, please use the module manager. To delete the whole Lesung application with modules in RAM, please use the delete function of the launcher. ----------------------------------------------------------------- (II) Manual ----------------------------------------------------------------- - Main screen: If a text module is loaded, the buttons on the bottom of the screen have the following functions (left-to-right): << = One week back < = One day back (also with hardkey "left" or stroke left) [] = Go to date (also with /G or via menu) > = One day forward (also with hardkey "right" or stroke right) >> = One week forward ? = random function (see below) A = Toggle font - Module selection: The little arrow in the upper right corner of the display opens a drop-down list of all found modules. Here you may switch between the modules. The active module is highlighted. ! The current module does not change with a date (year) change. To display text for another year, please use the module list, not the calendar dialog. - Module manager: Use it to copy and delete modules. If the "VFS/expansion card" checkbox is activated, Lesung seeks for modules on expansion cards as well (maximum of two addressable external cards). If cards are present, the following three directories are searched: /PALM/Launcher /PALM/Lesung /PALM/Programs To copy a module, select it, chose the target (drop-down list) and press 'Copy'. To copy between cards, first copy to RAM, then to the other module. Modules on expansion cards cannot be overwritten (delete the old module first). ! If you deactivate VFS, there might be Lesung modules on a present expansion card, but they are not searched and thus not found and not displayed. If VFS is activated, a maximum of 24 external modules can be found. ! The default card directories may contain lots of files which Lesung needs to open and check if it is a Lesung module. Therefore, it may be useful to place Lesung modules in the /PALM/Lesung directory and only search this. ! The module names shown are the internal module names, not the file names. File names do not matter, they just need to have the .pdb extension. To manage files and paths in detail, please use a file manager. - Bookmark: As Lesung always starts with the current date, a bookmark can be set. The date (month/day) is marked internally, so that by using the shortcut /G you can jump to this day. The bookmark does not memorize year and module, so it is available in all modules. To relocate the bookmark, call /S at the new day. - Search: If you call the global search/find from within Lesung, the Lesung modules are searched. If you call the search function from within any other application, the Lesung modules are excluded to not delay the search. ! On non-Asian devices, the global search function finds the search string only at the beginning of a word. So, searching for 'omans' will probably not bring any result, while 'ro' will. ! When working with inverted text (Arabic, Hebrew), limit your search to one word, as the text is displayed other than stored (visual/logical). - Fonts: Pushing the 'A' button will toggle the four standard fonts (normal, bold, large, large bold), if not an AFNT font is active for the current module. - Window size: If your device supports it, the Lesung window may be resized and rotated dynamically. Lesung adapts to many resolutions and display sizes, including landscape format and Alphasmart Dana. Preferences dialog: - German menu: Shows menu items and info text in German language. - Show module names: displays the name of the current module all the time on the upper right corner of the screen. - Link to Bible+ (OS 3.5+): [ Bible+ is a well-known, free bible application for Palm OS (open source under GNU/GPL) with many available bible modules, see http://palmbibleplus.sf.net A complete German bible module (Schlachter 1951) for Bible+ you will find at http://www.axios.de/palm/download/scb51_pb.zip ] If activated, two or four new menu items appear in the "Go to" menu: "» Bible reference 1" ... You can use them to jump directly to the corresponding bible verse/text in Bible+. ! The menu items do not appear if the current module does not provide link information. ! To use this function, Bible+ needs to be installed in main memory (RAM, not on a card) and have been run at least once. Lesung does not check for availability of Bible+ prior to using the link function. ! Some Bible+ versions will crash when attempting to open a non-available bible book, e. g. Genesis in a Greek New Testament. To avoid this, Lesung checks, if the current bible contains the requested book. If not, Lesung tries to find another bible which has the book available. On expansion cards, the following directories are searched: /PALM/Programs/Bible+ /PALM/Programs/PPBL /PALM/Launcher ! Therefore, please use a current version of Bible+, if possible (3.1.36 and higher)! ! Due to slight differences in verse numbering between different bible translations and languages, there may be a verse shift at the text shown in Bible+, especially at chapter breaks. ! Lesung modules may contain different numbers of scriptures per day. The menu provides links to a maximum of 4 scriptures. Notice for users of Olive Tree BibleReader resp. OliveTree BibleR+: It was intended to enable a link also to this application, but the information needed has not been provided by the publisher. - Random function: If enabled, a button with a question mark appears in main view. It allows to jump to a (semi-) random day in the current module. - AFNT fonts (OS 3+): Most devices use Latin-1 (similar to ISO 8859-1) as built-in code page. Additional external AFNT fonts allow to display modules of different code pages (e. g. accented Greek, Hebrew, Russian) without third-party software. If you activate this function, on every module opening, Lesung seeks if there is an AFNT font available that matches the needed code page and loads it. For detailed information and download, please go to www.axios.de/palm/palm_afnt.html ! Asian devices are able to display Latin-1 special characters like the German 'Umlaute' when using a Latin-1 AFNT font. - Startup function (OS 4+): If the checkbox is marked, Lesung will be displayed on system power-on or after entering the password, if the delay time has passed since power-off. Other applications on the device that act on system power-on might prevent Lesung from being displayed. - For developers: Calling Lesung from within other applications is possible using the generic system functions. Without parameter, the current day is shown in the module that was used last. Using the launch code sysAppLaunchCmdGoTo allows to address a specific day: ((GoToParamsPtr) cmdPBP)->recordNum = day (1-365; Feb 29 = 366) For text highlighting, add: ((GoToParamsPtr) cmdPBP)->matchPos = highlight from char # ((GoToParamsPtr) cmdPBP)->searchStrLen = highlight # chars To use a specific module: ((GoToParamsPtr) cmdPBP)->dbID = (!NULL) or (module dbID), and: ((GoToParamsPtr) cmdPBP)->matchCustom = module # (search in RAM, then on VFS cards 1/2) ----------------------------------------------------------------- (III) Contact information ----------------------------------------------------------------- Klaus Steigert, Giessen, Germany, palm at axios dot de, www.axios.de/palm -----------------------------------------------------------------