# This is a bilingual file (German and English). # English text: see below. mkles Version 3.5a ----------------------------------------------------------------- Stand: 01.01.2009 (I) Allgemeines (II) Aufbau der Textdatei (III) Anwendung (IV) Kontakt ----------------------------------------------------------------- (I) Allgemeines ----------------------------------------------------------------- "mkles" ist ein Kommandozeilenprogramm, mit dem aus einer Textdatei Module für "Lesung for Palm OS" (Version 3.5 und höher) generiert werden können. Das beigefügte Programm ist ein Win32-Programm; für andere Betriebssysteme kann man es sich aus dem ebenfalls beigefügten Quelltext selbst neu kompilieren. Das Programm "mkles" unterliegt der GNU Public License (GPL), siehe www.gnu.org. ----------------------------------------------------------------- (II) Aufbau der Textdatei ----------------------------------------------------------------- Jede Zeile der Textdatei entspricht einem Datensatz bzw. dem Text für einen Kalendertag. Die Zeichensequenz \n führt zu einem Zeilenwechsel im angezeigten Text. Am Ende einer Zeile sollte kein zusätzliches \n stehen. Formatierungen (fett, kursiv, Farben etc.) sind nicht möglich. Die Gliederung des Textes erfolgt durch Zeilenwechsel (\n). Leerzeilen werden ausgelassen, d. h. wenn eine Zeile bewusst leer bleiben soll, muss ein Ersatztext (z. B. Leerzeichen, Punkt, Gedankenstrich) in der Zeile stehen. Zeichensatz: Die Textdatei muss in dem Zeichensatz angelegt sein, in dem sie später auf dem Gerät angezeigt werden soll, also in der Regel Win-1252, ISO 8859-1 bzw. Latin-1. Wenn auf dem Gerät ein passender AFNT-Font verfügbar ist, kann ein beliebiger 8-bit-Zeichensatz gewählt werden. Unicode wird bis einschließlich Palm OS 5.4 nicht unterstützt, allerdings werden Texte in GB-2312 von chinesischen Geräten korrekt dargestellt. Zeile 1 der Datei enthält den Text, der später unter dem Menüpunkt "Modul-Info" angezeigt wird. Wenn Sie das Modul z. B. im Internet veröffentlichen möchten, geben Sie hier bitte nach Möglichkeit den Namen des Moduls, eine kurze Beschreibung des Inhalts, Autor und ggf. Informationen zum Copyright, Sprache und Zeichensatz, Erstellungsdatum oder Revision sowie eine Quelle oder Kontaktmöglichkeit an, falls Anwender Rückfragen haben. Zeilen 2 bis 366 enthalten die Texte für 01.01. bis 31.12. eines Jahres. Zeile 367 enthält den Eintrag für den 29.02., bei Nicht-Schalt- jahren Platzhaltertext, z. B. "---". Zeile 368 enthält den Text, der später unter dem Menüpunkt "Sondertext" angezeigt wird. Zeilen 369 bis 373 enthalten Meta-Angaben zum Modul (siehe nachfolgende Übersicht). Zeile 374 enthält die Information, ob Links zu PalmBible+ vorhanden sind. Zeilen 375 bis 739 enthalten die Links für 01.01. bis 31.12. eines Jahres. Die Links bestehen aus neunstelligen Zahlen, die jeweils mit drei Stellen Bibelbuch (001-066; Referenz: Lutherbibel), Kapitel und Startvers enthalten, für zwei oder vier Links pro Tag. Zeile 376 enthält analog die Angabe für den 29.02. oder Platzhaltertext. 001 Modul-Info 002 Eintrag für den 01. Januar ... 366 Eintrag für den 31. Dezember 367 Eintrag für den 29. Februar (sonst z. B. "---") 368 Sondertext 369 Modulart [GEB = Gebetsinfos, LOS = Losungen, AND, BLP, EXT, TXT, WRD = The Word] 370 Jahr [2008] 371 Sprache [DE] 372 Schaltjahr [0/1] 373 Quartal [0 = Modul für das ganze Jahr, 1-4] 374 Bibel-Links vorhanden [0 = nein, 1 = 2 Verse pro Tag (z. B. AT/NT), 2 = 4 Verse pro Tag (z. B. AT/NT/Tagestext/ fortl. Bibellese)] 375 Bibel-Link für den 01. Januar ["BBBCCCVVV BBBCCCVVV BBBCCCVVV BBBCCCVVV" mit B = Buchnummer 001-066, C = Kapitelnummer 001-999, V = Versnummer 001-999] ... 739 Bibel-Link für den 31. Dezember 740 Bibel-Link für den 29. Februar ("---" if not a leap year) 741 Leerzeile (empfohlen) Eine Musterdatei (sample.txt) ist beigefügt. ----------------------------------------------------------------- (III) Anwendung ----------------------------------------------------------------- ! Starten Sie das Programm nicht durch Doppelklick. Öffnen Sie stattdessen in Windows ein Kommandozeilenfenster ("schwarze DOS-Box"): Klicken Sie auf Start > Ausführen... und geben Sie "cmd" ein. Bei Windows 98 geben Sie "command" ein. Bisweilen ist auch die Auswahl von Start > Programme > Zubehör > Eingabeaufforderung möglich. Es öffnet sich ein Kommandozeilenfenster. Wechseln Sie mit dem Befehl "cd" in das Verzeichnis, in dem sich 'mkles'und die Textdatei befinden. Dann kann es losgehen: mkles35 Beispiel: mkles35 mles09_de.txt "2009 DE" 1003 Sofern Parameter Leerzeichen enthalten, müssen sie in Anführungszeichen (Zollzeichen) eingeschlossen werden. Input file: Textdatei mit oben bezeichneter Struktur Module name: Modulname, wie er in "Lesung" erscheinen soll. Tipp: Möglichst kurze, strukturierte Namen verwenden, die auch bei vielen Modulen einfache Auswahl ermöglichen. Modulintern wird dem hier eingegebenen Namen noch ein "Lesung_Mod" vorangestellt, jedoch vom Programm nicht angezeigt. Hinweis: Module mit gleichem Namen überschreiben sich im Speicher des Geräts. Daher sollte immer ein eindeutiger Name als Parameter angegeben und der Default-Name nur zu Testzwecken verwendet werden. Code Page: Zeichensatz laut Palm-Nummerierung (siehe Palm-SDK) + 1000 (siehe www.axios.de/palm/afnt.html). Für westeuropäische Sprachen ist die Voreinstellung "1003" (PalmLatin). Über diesen Parameter findet "Lesung" ggf. einen passenden AFNT-Font. ----------------------------------------------------------------- (IV) Kontakt ----------------------------------------------------------------- Wenn Sie ein Modul erstellt haben, das für einen größeren Anwenderkreis von Interesse ist und dessen Texte aus urheberrechtlicher Sicht verbreitet werden dürfen, können Sie den Autor informieren, unter welcher URL Sie das Modul online gestellt haben. Wenn Fragen auftreten, die weder durch diese Infodatei noch durch hinreichendes Ausprobieren gelöst werden können, erreichen Sie den Autor unter: Klaus Steigert, Giessen, palm at axios dot de, www.axios.de/palm ----------------------------------------------------------------- # # English section starts here ... # mkles Version 3.5a ----------------------------------------------------------------- Last mod. 2009-01-01 (I) General information (II) Structure of the text file (III) Usage (IV) Contact ----------------------------------------------------------------- (I) General information ----------------------------------------------------------------- "mkles" is a command line tool to convert a plain text file into a module for "Lesung for Palm OS" (Version 3.5 and above). The enclosed executable file is a win32 application. For other operating systems, please see the enclosed source code. The application "mkles" is released under GNU Public License (GPL), see www.gnu.org. ----------------------------------------------------------------- (II) Structure of the text file (input file) ----------------------------------------------------------------- Each line of the input file represents one data record and the text for one calendar day. Use the sequence \n to add a line break in the displayed text. Avoid a line break \n at the end of a line. Formatting like bold or italic text, different colors are not supported. Structuring of the text for one day should be done by line breaks. Empty lines are omitted. If a line is intentionally kept blank, it should contain at least one character like a space, a dot, or a dash. Code page: The code page of the text file will be the encoding of the displayed text on the device. Usually this will be Win-1252, ISO 8859-1, or Latin-1. If a matching AFNT font is available on the device, any 8-bit code page can be used. Unicode is not supported in Palm OS up to the current version 5.4. Text in GB-2312 will be displayed correctly by Chinese devices. Line 1 of the text file contains the text displayed when selecting the menu entry "Help > Module". If you are intending to publish the module in the internet, please add some information about name and content of the module, author and copyright information, and if necessary, language, codepage, creation date or revision, and source or contact address, so that users know where to ask or to find support. Lines 2 to 366 contain the text for January 01 to December 31. Line 367 contains the text for February 29, if a leap year. Otherwise fill with replacement text like "---". Line 368 contains the text displayed when selecting the menu item "special text". Lines 369 to 373 contain meta information on the module, see below. Line 374 contains the information, if bible reference links to PalmBible+ are available. Lines 375 bis 739 contain the bible ref links for January 01 to December 31. The links are nine-digit numbers with triplets representing the bible book (001-066; sorting order of the Luther bible), chapter, and bible verse for two or four scriptures each day. Zeile 376 contains the bible ref link for February 29 or some replacement text. 001 Module info 002 Text for January 01 ... 366 Text for December 31 367 Text for February 29 or replacement text like "---" 368 Special text 369 Module type [GEB = Prayer info, LOS = Losungen, AND, BLP, EXT, TXT, WRD = The Word] 370 Year [2008] 371 Language [EN] 372 Leap year [0/1] 373 Quarter [0 = full year, 1-4] 374 Bible reference link to PalmBible+ present [0 = no, 1 = yes with 2 verses per day, 2 = yes, with 4 verses per day] 375 Bible ref link for January 01 ["BBBCCCVVV BBBCCCVVV BBBCCCVVV BBBCCCVVV" with B = bible book 001-066, C = chapter 001-999, V = verse 001-999] ... 739 Bible ref link for December 31 740 Bible ref link for February 29 or replacement text like "---" 741 Empty line or some dummy text (recommended) A sample text file is enclosed. ----------------------------------------------------------------- (III) Usage ----------------------------------------------------------------- ! Don't double-click the application. Instead, open a command line window ("black DOS box") by clicking on Start > Run... and enter "cmd" (on Windows 98 systems: "command"). A command line window opens. Use the command "cd" to switch to the directory with 'mkles' and the input text file. Now, you're ready to go: mkles35 Example: mkles35 mles08_en.txt "2008 EN" 1003 If a parameter contains blanks, quotation marks are needed. Input file: plain text file, see above Module name: the module name as it appears in "Lesung". Choose short and informative names which allow fast recognition and selection even with many modules present. Internally, the module name starts with "Lesung_Mod", which will not be visible in the application. Note: Modules with similar name overwrite each other on the device. Therefore, every module should be given a specific, unique name. The default module name should only be used for testing reasons. Code Page: using Palm OS code page enum (see Palm OS SDK) plus 1000 (for a list, see www.axios.de/palm/afnt.html). For Western European languages, the default is "1003" (PalmLatin). This parameter allows "Lesung" to pick an appropriate AFNT font, if available. ----------------------------------------------------------------- (IV) Contact ----------------------------------------------------------------- If there is questions which cannot be solved by this readme file or by some practicing, you may contact the author at: Klaus Steigert, Giessen/Germany, palm at axios dot de www.axios.de/palm -----------------------------------------------------------------