home *** CD-ROM | disk | FTP | other *** search
-
- Algemeen conversie rekenprogramma voor de Psion Series 3a
- Versie 1.0
-
- Copyright (c) 1994 M.D. Nijdam
-
- Email: marco@west.nl
- Adres: Kerklaan 7c
- NL-2283 CM Rijswijk
- Nederland
-
- ======================================================================
- Inhoudsopgave
- ----------------------------------------------------------------------
-
- Voorbehoud
- Het programma en de naam
- Inleiding
- Voordelen boven andere conversie programma's
- Nadelen ten opzichte van andere tools
- Gebruik van het programma
- Om te beginnen
- In het programma
- Andere mogelijkheden
- Veranderen van de database
- Berekeningen uitvoeren
- Veranderen van de weergave precisie
- Veranderen van de getal notatie
- Bewaren van voorkeuren als instelling bij het starten
- Gebruik van een getal uit een Calc geheugen
- Bewaren van getal in Calc geheugen
- Tips
- Buitennissigheden
- Veranderen van de database
- Database specificatie
- Categorieën invoeren
- Standaard instellingen (defaults)
- Beperkingen
- Vertalingen
- Internationalisatie
- Vertalen van de help file
- Tips
- OPL code
- Vertalen
- Hergebruik
- Ten slotte: Hou me op de hoogte
-
- ======================================================================
- Voorbehoud
- ----------------------------------------------------------------------
-
- Dit programma is vrije software; je mag het verspreiden en/of wijzigen
- onder de voorwaarden van de GNU General Public License zoals door de
- Free Software Foundation gepubliceerd; versie 1, of (naar keuze) een
- latere versie.
- Dit programma wordt verspreid in de hoop dat het nuttig zal zijn,
- maar ABSOLUUT ZONDER GARANTIE; zelfs zonder de impliciete garantie
- van VERKOOPBAARHEID of GESCHIKTHEID VOOR EEN BEPAALD DOEL. Zie de
- GNU General Public License voor meer details.
-
- Tezamen met dit programma moet je een kopie van de GNU General Public
- License hebben ontvangen; zo niet, schrijf dan naar de Free Software
- Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
-
- ======================================================================
- Het programma en de naam
- ----------------------------------------------------------------------
-
- JAICNV is een afkorting voor "JAI convert". Het is een algemeen conversie
- programma voor de Psion 3a, dat de conversie van een getal van één
- eenheid in een andere berekent. Het is algemeen omdat de conversie
- regels in een database staan, die met het standaard Data programma
- op de Psion 3a kunnen worden gewijzigd. Je kan eenvoudig nieuwe
- conversies toevoegen. Meer hierover verderop in dit document.
-
- JAI is de afkorting van "Just An Idea", of wel "zomaar een idee".
- In het Frans (geschreven als J'ai) betekent het ook "Ik heb", of
- in het Engels "I have", wat je misschien herinnert aan de beroemde
- toespraak van Martin Luther King: "I have a dream". In mijn geval
- betekent het ook "Ik heb een idee".
-
- ======================================================================
- Inleiding
- ----------------------------------------------------------------------
-
- Oh nee, niet nog een conversie programma! Is het beter dan de andere
- honderd die ik heb gezien?
-
- Natuurlijk ben ik van mening dat dat het geval is. Hoewel het in het
- gebruik eenvoudig is, zijn de mogelijkheden van dit programma eindeloos.
- JAICNV kan elk getal omzetten in elk ander, als er maar een formule
- is om dat te doen.
-
- Om maar eens een paar mogelijkheden te noemen:
- - Omzetten van elke lengtemaat naar elke andere: inches, meters,
- kilometers, yards, miles, parsecs, etc. etc.
- - Idem voor oppervlakte-, en volumematen, massa en snelheid.
- - Omrekenen van temperatuur, zelfs van Celcius naar Fahrenheit,
- hoewel dat met een formule moet en niet met een factor.
- - Munteenheden omrekenen voor elke munteenheid.
- - Je kan zelf je favoriete formules met één, of met een truc
- zelfs enkele, variabelen in dit programma zetten.
-
- Bij dit programma heb ik een database met vele eenheden in bovenstaande
- categorieën gevoegd. En het is eenvoudig om zelf nieuwe toe te voegen,
- of bestaande te wijzigen. Dat laatste is vooral belangrijk bij
- munteenheden, omdat de wisselkoersen bijna dagelijks veranderen.
-
- En dat is nog niet alles. Het is mogelijk om de geheugens van de
- Psion Calc tool direct (of indirect) te gebruiken, en om berekende
- waarden weer in een Calc geheugen op te slaan. Daarmee is het tevens
- mogelijk getallen naar andere programma's, zoals Word, Data en Sheet
- te kopiëren.
-
- Voordelen boven andere conversie programma's
- =====================================================================
-
- - Dit is vrije software.
- - De programma code wordt meegeleverd.
- - Alles kan veranderd worden.
- - Het gebruikers interface kan in verschillende talen worden
- vertaald, zonder dat de programma code veranderd hoeft te
- worden.
- - Het kan vele conversie regels aan in één database, die
- eenvoudig door de gebruiker kunnen worden ingevoerd.
- Maar het kan ook meerdere databases aan.
- - Conversies zijn gesplitst per categorie, voor eenvoudige
- selectie.
- - Conversies die niet nodig zijn kunnen eenvoudig worden
- verwijderd, om geheugen te sparen.
- - Interface met Calc tool in twee richtingen.
- - Het is zelf ook een calculator die expressies met functies
- kan uitrekenen.
-
- Nadelen ten opzichte van andere tools
- =====================================================================
-
- - Dit is vrije software.
- - Geen garantie, geen ondersteuning.
- - Alles kan veranderd worden.
-
- ======================================================================
- Gebruik van het programma
- ----------------------------------------------------------------------
-
- Om te beginnen
- ======================================================================
-
- Kopieer de volgende files:
-
- jaicnv.opa naar \app directory
- jaicnvnl.dbf naar \dat directory
- jaicnvnl.hlp naar \dat directory
-
- Installeer het programma met de Installeer optie uit het Apps menu
- op het systeem scherm.
-
- Start het programma door het icoon voor het programma te selecteren
- en op Enter te drukken.
-
- Een alternatief is om de OPL code te veranderen zodat het in een OPO
- kan worden gecompileerd, door de APP definitie weg te halen.
-
-
- In het programma
- ======================================================================
-
- Nadat het programma gestart is zie je het voorbehoud. Druk op Enter
- om naar het openingsscherm te gaan. Van hieruit kun je Help opvragen,
- via het menu een aantal acties ondernemen, of naar het hoofdscherm
- gaan door op Enter te drukken.
-
- Vanaf het hoofdscherm kan je weer naar het openingsscherm terug door
- op Esc te drukken.
-
- Op het hoofdscherm kan je de categorie en de eenheden uitkiezen,
- en de om te zetten waarden invoeren. Telkens als je een wijziging
- maakt moet je op de Enter toets drukken. Het is belangrijk in wel
- veld je op Enter drukt. Als je bijv. in het veld voor de "van" waarde
- op Enter drukt wordt de "Naar" waarde berekend. Druk je op Enter in
- het veld voor de "Naar" waarde dan wordt de "Van" waarde berekent.
-
- De namen "Van" en "Naar" zijn dus eigenlijk wat misleidend,
- omdat je (meestal) in beide richtingen kan omzetten.
- Een reden om ze toch te gebruiken is dat in een incomplete
- database niet alle conversies in twee richtingen hoeven te zijn.
-
- Bij de start zijn sommige velden niet toegankelijk. Als je een
- categorie uitzoekt en op Enter drukt in het categorie veld worden
- de velden voor de eenheden toegankelijk. Als je de eenheden uitzoekt
- en in één van de eenheid velden op Enter drukt worden de velden voor
- de waarden toegankelijk. Als je later de categorie veranderd kan het
- voorkomen dat sommige velden weer worden beschermd.
-
- Samenvatting: Druk op Enter, en nog eens, en weer, en weer...
-
-
- ======================================================================
- Andere mogelijkheden
- ----------------------------------------------------------------------
-
- Veranderen van de database
- ======================================================================
-
- Standaard wordt de eerste database met een filenaam die voldoet aan
- "\dat\jaicnv*.dbf" gebruikt. Je kan echter een andere database
- uitkiezen. Hoe je zo'n database maakt wordt verderop beschreven.
-
- Om de database te veranderen moet je naar het hoofdscherm gaan
- (vanaf het opening scherm druk je op Enter). Het laatst punt
- op het hoofdscherm gebruik je om een (database) file uit te zoeken.
- Druk op Enter in het filenaam veld om de geselecteerde database
- te openen.
-
- Het veld werkt zoals velden om files te selecteren in andere Psion
- applicaties. Dus door op Tab te drukken kan je meer gedetailleerd
- de gewenste file uitzoeken.
-
- Kijk ook eens in de sectie over "internationalisatie" elders in
- dit document.
-
-
- Berekeningen uitvoeren
- ======================================================================
-
- In de waarde velden kan je niet alleen waarden invoeren, maar ook
- expressies. Je bent slechts beperkt door de lengte van een regel.
- Als je op Enter drukt in een veld met een expressie, wordt eerst
- de waarde van de expressie berekent, en daarmee de waarde voor het
- andere veld, gebruik makend van de conversie formule. Om de waarde
- van de expressie zelf te zien moet je dan wel de zelfde Van en Naar
- eenheid gebruiken, of eerst de andere waarde laten berekenen, zoals
- hierboven geschreven, en dan in het andere waarde veld op Enter
- drukken.
-
- Er wordt een fout gegeven als de expressie niet correct is.
-
- Elke OPL expressie kan gebruikt worden. Dit betekent dat je gebruik
- kunt maken van +, -, *, /, **, %, (, ), OPL functies (zoals sin(),
- cos(), tan(), pi, ln(), exp(), ja zelfs rnd), Calc geheugens (M0 to M9),
- hexadecimale getallen (bijv. $0D), etc.
-
-
- Veranderen van de weergave precisie
- ======================================================================
-
- In het begin toont JAICNV waarden met 20 cijfers.
- Je kan zowel het aantal decimalen als de maximale breedte van
- berekende waarden veranderen. Vanaf het opening scherm druk je op de
- Menu toets en kies je van het "Speciaal" menu de optie "Voorkeuren".
- Verander de "Maximale breedte" zoals je wilt en druk op Enter om
- het vast te leggen.
-
- In de volgende sectie wordt ook het getal formaat besproken.
-
-
- Veranderen van de getal notatie
- ======================================================================
-
- Bij de voorkeuren (zie Veranderen van weergave precisie) kun je
- ook de notatie van getallen veranderen. Kies voor
-
- - wetenschappelijk : Wetenschappelijk formaat, met mantissa en
- exponent. In dit geval kan je ook het aantal
- decimalen aangeven.
- - Vast aantal decimalen : Het getal wordt getoond met het aantal
- opgegeven decimalen.
- - Optimaal : Gebruikt vast aantal decimalen als dat
- mogelijk is, anders wetenschappelijk. Dit
- is de instelling bij het eerste starten
- Het aantal decimalen wordt in dit geval niet
- gebruikt.
-
-
- Bewaren van voorkeuren als instelling bij het starten
- ======================================================================
-
- De huidige voorkeuren kunnen in de huidige open database worden
- bewaard. De volgende keer dat je die database opent zullen die
- voorkeuren weer worden gebruikt.
-
- Om de voorkeuren te bewaren druk je, vanaf het opening scherm, op de
- Menu toets en kies je uit het "Speciaal" menu de optie "Bewaar
- Voorkeuren".
-
- Hierdoor wordt ook het huidige Calc geheugen in de database bewaard.
-
-
- Gebruik van een getal uit een Calc geheugen
- ======================================================================
-
- Op het hoofdscherm, in één van de twee velden voor waarden kan ook
- de naam van een Calc geheugen worden ingevoerd. De naam bestaat
- uit de letter M en een nummer tussen 0 en 9, bijv. "m1".
-
-
- Bewaren van getal in Calc geheugen
- ======================================================================
-
- Kies vanaf het openingsscherm uit het "Geheugen" menu de optie
- "Mx=Van waarde" of "Mx=Naar waarde" om de huidige waarde van het
- Van of Naar veld in het huidige geheugen op te slaan (x is het
- nummer van dat geheugen). Als het Van (of Naar) veld een expressie
- bevat wordt de waarde hiervan opgeslagen.
-
- Het huidige Calc geheugen kan je met de optie "Wijzig geheugen"
- uit het "Geheugen" menu veranderen.
-
- LET OP: Bewaren in een Calc geheugen is gevaarlijk. Andere programma's
- (zoals Calc) kunnen dat geheugen ook veranderen. De laatst
- bewaarde waarde (door welk programma ook gezet) wordt gebruikt.
-
-
- Tips
- ======================================================================
-
- - In elk van de velden met lijsten (categorie, Van eenheid en
- Naar eenheid) kun je snel naar een item toe springen door
- de eerste letter ervan in te drukken. Meerdere malen dezelfde
- letter drukken levert telkens het volgende item dat met
- dezelfde letter begint.
- - Als je bijv. vierkante internationale zeemijlen om wil zetten
- in vierkante meters (deze staat (nog) niet in de database, kan
- dat als volgt: kies in categorie lengte de meter en intern.
- zeemijl eenheden; converteer van zeemijl naar meter; wissel
- Van eenheid naar zeemijl en Naar eenheid naar meter, ga naar
- het Naar waarde veld (nu nog met naam "meter") en druk op
- Enter. Het Van waarde veld (nu met naam "meter") bevat het
- resultaat.
- - Voor conversie van graden naar radialen (nog niet in database)
- kun je de OPL functie rad() gebruiken. Kies Van en Naar unit
- het zelfde en type in Van waarde veld "rad(123)" en druk op
- Enter.
-
-
- Buitennissigheden
- ======================================================================
-
- Je kunt een conversie in de database zetten (verderop wordt beschreven
- hoe) waarvan de conversie factor gelijk is aan een Calc geheugen, of
- waarvan in de conversie formule één of meerdere Calc geheugens bevat.
-
- - Dit kan handig zijn voor conversies die erg veel veranderen,
- zoals wisselkoersen. Door de huidige koers in een Calc geheugen
- te zetten kun je eenvoudig met wisselende koersen werken.
- - Het kan ook gebruikt worden voor "Wat als" omzettingen, zoals
- "Wat gebeurt er met de opbrengst als de rente varieert tussen
- een aantal waarden". De rente kan in een geheugen worden
- gezet, de invoer in het ene veld, en de opbrengst wordt berekend
- in het andere veld.
- - Het is ook mogelijk om dit te gebruiken voor formules die meer
- dan één variabele hebben.
-
- In een formule kun je ook meer malen de ingevoerde waarde laten
- opnemen. Zie verderop over veranderen van de database.
-
- Door het gebruik van OPL functies kun je hele complexe en ook
- niet voor de hand liggende conversies doen. Bijvoorbeeld, om te
- converteren van een verschil in tijd naar seconden, kun je de
- volgende formule gebruiken (schrik niet):
-
- datetosecs(1994;01;01;val(left$("xx";2));val(mid$("xx";3;2));
- val(mid$("xx";5;2)))-datetosecs(1994;01;01;val(mid$("xx";8;2));
- val(mid$("xx";10;2));val(mid$("xx";12;2)))
-
- Hierin is aangenomen dat de "waarde" die ingevoerd is door
- de gebruiker de volgende syntax heeft: uummss-uummss.
- uu is uren, mm minuten en ss seconden. Bijvoorbeeld
- 120101-120002 zou als aantal seconden 59 moeten opleveren.
-
-
- ======================================================================
- Veranderen van de database
- ----------------------------------------------------------------------
-
- Zoals eerder gezegd zijn alle conversie specificaties opgeslagen in
- een database. Dit is een normale database die met het standaard Data
- programma op de Psion 3a kan worden gewijzigd. Alle velden in de
- database zijn tekst velden, hoewel sommige waarden of formules
- moeten bevatten.
-
- De conversies zijn gesplitst in categorieën. Elke categorie heeft
- een centrale eenheid. Binnen een categorie moeten alle conversies
- van of naar die centrale eenheid worden gegeven. JAICNV kan daardoor
- binnen een categorie elke eenheid naar elke andere eenheid omzetten,
- door via centrale eenheid te rekenen. Je hoeft daarvoor niet de
- conversie tussen elk van die eenheden te geven, maar slechts voor
- elke eenheid één conversie naar de centrale eenheid.
-
-
- Database specificatie
- ======================================================================
-
- De database bevat zes velden:
-
- - Van eenheid
- - Naar eenheid
- In deze twee velden moeten de namen van de
- eenheden worden ingevuld die in de selectie
- lijsten voor eenheden op het hoofdscherm komen.
- Eén van deze eenheden moet altijd centrale
- eenheid zijn.
- - Factor
- De factor is een getal (of de naam van een Calc
- geheugen) die aangeeft met welke factor de
- "Van" waarde moet worden vermenigvuldigd om de
- "Naar" waarde te krijgen.
- Omdat deze conversie een factor is, kan JAICNV
- tevens de conversie van de "Naar" naar de "Van"
- waarde uitvoeren.
- Als je een formule wilt gebruiken moet het factor
- veld leeg zijn.
- - Formule
- Als de conversie niet met een factor kan worden
- uitgevoerd (bijv. van graden Celsius naar
- Fahrenheit) moet in dit veld een formule worden
- gegeven om de "Van" in de "Naar" waarde te kunnen
- omrekenen. Als je ook van de "Naar" naar de "Van"
- waarde wilt kunnen omrekenen, moet je in dit geval
- een apart kaart in de database maken, met de juiste
- formule.
- In de formule worden de letters "xx" gebruikt, om
- de plaats aan te geven waar de "Van" waarde in de
- formule moet worden ingevuld (één "x" is niet
- voldoende, omdat in een formule ook de OPL functie
- "exp()" mag worden gebruikt). Een formule kan
- een constante zijn (dus zonder xx), maar ook
- mag in de formule meer keer xx voorkomen (ze
- worden allen door de ingevulde waarde vervangen).
- Een formule mag OPL functies bevatten. Let op
- dat het teken voor scheiding van functie
- argumenten wordt bepaald door de instelling
- van de default "DecimalSign" (zie verderop).
- - Van beschrijving
- - Naar beschrijving
- Dit zijn langere beschrijvingen van de eenheden.
- Vaak is het de volledige naam van een eenheid,
- maar elke tekst is toegestaan.
- Het wordt getoond vóór de waarde velden op het
- hoofdscherm.
- De beschrijving voor de centrale eenheid hoeft
- niet te worden ingevuld. Deze wordt altijd van
- categorie kaart gehaald.
-
- Categorieën invoeren
- ======================================================================
-
- Een categorie beschrijving wordt op een aparte kaart ingevuld, en wel
- als volgt:
-
- - Het "Van eenheid" veld moet de waarde "category:" hebben
- - Het "Naar eenheid" veld moet de naam van de centrale eenheid hebben.
- - De Factor en Formule velden worden niet gebruikt.
- - Het "Van beschrijving" veld moet de naam van de categorie bevatten.
- Deze wordt in de lijst met categorieën op het hoofdscherm gebruikt.
- - Het "Naar beschrijving" veld moet de beschrijving voor de centrale
- eenheid bevatten. Deze wordt altijd gebruikt als je van of naar de
- centrale eenheid converteert.
-
- Standaard instellingen (defaults)
- ======================================================================
-
- De database bevat ook een aantal standaard instellingen die je kan
- veranderen. Elke standaard instelling staat op een aparte kaart, en
- wel als volgt:
-
- - Het "Van eenheid" veld moet de tekst "default:" bevatten.
- - Het "Naar eenheid" veld moet één van de speciale woorden bevatten
- (zie verderop)
- - De factor and formule velden worden niet gebruikt.
- - Het "Van beschrijving" veld moet de waarde voor de default bevatten.
- - Het "Naar beschrijving" veld wordt niet gebruikt. Eventueel kunnen
- er opmerkingen in staan over welke waarden ingevuld kunnen worden.
-
- De volgende speciale woorden kunnen worden gebruikt:
- - HelpFile Pad en filenaam van de te gebruiken help file.
- * MemoryNr Nummer van het actieve Calc geheugen
- * ValWidth Maximale breedte van berekende waarden
- * ValPrecision Aantal decimalen dat van berekende waarden
- wordt getoond.
- * Notation 1 (wetenschappelijk), 2 (vast), 3 (optimaal)
- - DecimalSign Decimaal scheidingsteken: , of .
- Hierdoor wordt tevens het scheidingsteken
- voor OPL functieargumenten bepaald op
- ";" resp. ",".
-
- Een aantal van deze standaard waarden kan ook binnen Jaicnv worden
- veranderd en weer in de database worden bewaard. Deze zijn aangegeven
- met een *.
-
- Beperkingen
- ======================================================================
-
- De implementatie van JAICNV beperkt o.a. het aantal categorieën
- en het aantal eenheden binnen en categorie:
-
- - De totale lengte van alle categorie namen (in de "Van beschrijving"
- velden op de categorie kaarten) mag niet langer zijn dan 255 minus
- het aantal categorieën.
- - De totale lengte van alle namen van eenheden, zoals die in de
- Van of Naar eenheid lijsten op het hoofdscherm voorkomen, mag
- niet langer zijn dan 255 minus het aantal eenheden in de lijst.
- (let op dat eenheden met een factor zowel in de Van als de Naar
- lijst komen).
-
- JAICNV waarschuwt als deze grenzen worden overschreden.
- Om zoveel mogelijk eenheden in een lijst te krijgen is het verstandig
- om en namen van de eenheden zo kort mogelijk te houden. De volledige
- naam kan dan in de beschrijving van de eenheid.
-
- Verder gelden de volgende beperkingen:
-
- - Namen van eenheden mogen niet langer dan 100 karakters zijn
- - Beschrijvingen mogen niet langer dan 100 karakters zijn
- Dit zijn eigenlijk geen beperkingen, omdat zulke lange namen
- of beschrijvingen toch niet op het scherm passen.
- - Formules mogen niet langer zijn dat 255 tekens, minus de lengte
- van de in te vullen waarde.
- - Namen van categorieën en eenheden mogen geen komma's bevatten.
-
-
- ======================================================================
- Vertalingen
- ----------------------------------------------------------------------
-
- Internationalisatie
- ======================================================================
-
- Verschillende landen hebben verschillende lokale eenheden, en
- mogelijk verschillende namen voor de zelfde eenheid.
-
- Een "zeemijl" heet in het engels bijvoorbeeld een
- "nautical mile"
-
- Omdat JAICNV gebruik maakt van een database met units, en je toestaat
- andere databases te gebruiken, is het mogelijk om aparte database
- in verschillende talen te maken.
-
- In de distributie staat naast de Nederlandse een Engelse
- versie van de database, genaamd "jaicnven.dbf" (dit ook om de
- verspeidingsgraad van het programma te vergroten, want het
- Nederlandse taalgebied is niet zo groot).
-
- Voor een volledige vertaling moet ook de veld namen, menu opties
- en help teksten worden vertaald, en natuurlijk deze handleiding.
- De code is zodanig dat alle teksten in het programma uit de help
- database worden gehaald. Omdat ook deze database gewoon met het
- Data programma kan worden bewerkt, kan die ook vrij eenvoudig
- worden omgezet (verder op meer hierover).
-
- Een aandachtspunt bij het ondersteunen van meerdere talen is het
- teken dat wordt gebruikt als decimaal scheiding. In het Nederlands
- een komma "," gebruikelijk, in veel andere landen is een punt ".".
- Jaicnv gebruikt het teken zoals die in jou Psion is gezet.
- In de database kun je één van de twee kiezen, maar die moet je
- dan wel consistent in de hele database gebruiken. Standaard zal
- Jaicnv aannemen dat de getallen in de database een punt als decimaal
- scheiding gebruiken. Met de default "DecimalSign" in de database
- kun je de deze op een komma zetten (zie sectie over standaard
- instellingen).
- Het is aan te bevelen deze default ook expliciet in de database
- te zetten als je een punt gebruikt (in plaats van te vertrouwen
- op de hard gecodeerde standaard instelling).
- Door de instelling van DecimalSign ligt ook vast hoe functie
- argumenten in formules moeten worden gescheiden: met ";" of ",".
-
-
- Vertalen van de help file
- ======================================================================
-
- De help file is een normale database, die met de Data applicatie op
- de Psion 3a kan worden bewerkt. Het bevat een aantal dingen:
-
- - De help teksten (en het voorbehoud scherm).
- Elk help item staat op een aparte kaart. Er kunnen maximaal 8
- help items (kaarten) zijn. Elke kaart mag maximaal 8 regels
- tekst bevatten.
- - Teksten van menus.
- Elk menu staat op een aparte kaart en heeft een vaste naam.
- De menu items staan op dezelfde kaart, één per regel in een
- vaste volgorde. Kijk in een bestaande database voor je juiste
- volgorde.
- - Teksten voor schermen.
- Er is voor elk scherm één kaart. Net als voor menus heeft die
- een vast naam, en hebben de items op de regels een vaste volgorde.
- Sommige velden op een scherm kunnen ook een lijst van toegestane
- waarden bevatten (ook in een vaste volgorde). Een voorbeeld is
- de lijst van notaties op het voorkeuren scherm.
- - Foutmeldingen
- Elke foutmelding staat op een aparte kaart. Het heeft weer een
- vaste naam ter identificatie (die dus niet vertalen). De melding
- kan één of twee regels zijn.
- In sommige foutmeldingen moet tijdens runtime een tekst worden
- ingevuld. In de database moet in de foutmelding worden aangegeven
- waar die tekst moet worden ingevuld. Als er één tekst moet worden
- ingevuld moet de melding "%s1" bevatten op de plaats waar die
- tekst moet komen. Zijn er twee teksten, dan moeten "%s1" en "%s2"
- de plaatsen aangeven. Je moet zorgen dat een melding het juiste
- aantal plaatsaanduiders bevat. Het maakt niet uit in welke van de
- twee regels die staan, en in welke volgorde (als er twee zijn).
- - Strings
- Eén string per kaart, met vast naam. De string waarde moet in het
- "Msg" veld.
-
- Een record in de help database bevat de volgende velden:
- - Type: moet één van de strings "help:", "menu:", "panel: fatal"
- "error:" of "string:" bevatten.
- "help: disclaimer" wordt gebruikt voor het voorbehoud.
- - Naam: Naam/tekst van item (voor help) of één van de vaste namen
- (voor andere types)
- - Msg: Eerste regel (voor help en error), menu naam, scherm titel,
- waarde van string.
- - Regel1: Tweede regel (voor help of error), menu item, panel item.
- - Regel2-Regel8: Volgende regels (voor help), menu item, panel item.
-
-
- Tips
- ======================================================================
-
- Voor een volledige vertaling vindt ik het makkelijker om de
- database in tekst formaat te bewaren, met een nieuwe regel als
- veldscheiding, deze op de PC te wijzigen, en dan met een lege
- database samen te voegen.
-
- Kijk wel uit welke editor je op de PC gebruikt. Lege velden
- worden aangegeven door een regel met precies één spatie. Records
- worden door een geheel lege regel gescheiden. Als je editor de
- spaties aan het eind van een regel weggooit krijg je GROTE problemen.
-
- Je kunt ook internationale en wetenschappelijk tekens in de database
- gebruiken. Het lijkt erop dat die het zelfde zijn op de PC en de
- Psion.
-
-
- ======================================================================
- OPL code
- ----------------------------------------------------------------------
-
- Vertalen
- ======================================================================
-
- Als je de OPL code wilt vertalen in een OPA moet je de file
- jaicnv.pic
- in directory
- \pic
- zetten (of de code aanpassen).
-
- Hergebruik
- ======================================================================
-
- Misschien vindt je concepten van o.a. internationalisatie en help
- interessant. Omdat de code is meegeleverd kan je de code die die
- concepten implementeert hergebruiken.
-
- MAAR, HET PROGRAMMA EN DE CODE VALLEN ONDER DE CONDITIES VAN DE
- GNU GENERAL PUBLIC LICENSE. LEES DIE EERST VOOR JE CODE GAAT
- HERGEBRUIKEN. HET STAAT IN DE FILE COPYING.GPL
-
- Eén van de regels houdt in dat de software die je met deze software
- maakt ook weer vrij beschikbaar moet zijn onder de zelfde GNU GPL
- condities.
- Verder vraag ik je om bij hergebruikte code te zetten dat ik die
- heb geschreven.
-
- Als je code wilt hergebruiken in een programma dat onder andere
- voorwaarden wordt verspreidt, schrijf mij dan.
-
-
- ======================================================================
- Ten slotte: Hou me op de hoogte
- ----------------------------------------------------------------------
-
- Omdat dit vrije software is, en zowel de code als de database
- veranderd kunnen worden, kun je zelf wijzigingen aanbrengen
- (maar let wel op de regels die in de GNU licentie overeenkomst
- staan, die met de distributie is meegeleverd).
-
- Als je een database maakt met bruikbare conversies, als je
- een database vertaalt, of als je handige veranderingen of
- uitbreidingen aan het programma maakt, laat het me dan weten.
-
- Ook als je opmerkingen hebt, bugs vindt, of ideeën hebt voor
- uitbreidingen kun je me die laten weten.
-
- Mijn email en post adressen staan bovenaan dit document.
-