home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / apps / database / cocktail / cocktail.txt < prev   
Text File  |  1993-03-11  |  16KB  |  420 lines
  1. COCKTAIL
  2. ========
  3.  
  4. Eine Cocktailrezeptverwaltung von
  5.  
  6.  
  7.         Harald Härtl                 Konto: 9129198
  8.         Bergbahnstr. 2a              BLZ  : 660 501 01
  9.         W-7500 Karlsruhe 41          Sparkasse Karlsruhe
  10.         Tel.: 0721/407536
  11.  
  12.  
  13. Das das Programm GEM-konform programmiert ist, sollte es auf jedem 
  14. Rechner (auch mit nur 520 kB) in jeder Auflösung arbeiten.
  15.  
  16. Bisher getestet:
  17. ST, ST + Overscan, ST + Bigscreen (nur monochrom) [TOS 1.4, KAOS]
  18. STE 
  19.  
  20.  
  21.  
  22. 1. Installation
  23.  
  24. Die Dateien COCKTAIL.PRG und COCKTAIL.RSC müssen im selben Verzeich- 
  25. nis stehen. 
  26.  
  27.  
  28.  
  29. 2. Programmbedienung
  30.  
  31. 2.1 Dialogboxen
  32.  
  33. Wenn GEM noch Fenster zu vergeben hat, werden alle Dialoge in Fenster 
  34. gelegt, ansonsten als fliegende Dialoge dargestellt.
  35. Fensterdialoge können wie ein normales Fenster verschoben werden, die 
  36. fliegenden Dialoge durch Gedrückthalten der Maustaste auf dem Esels- 
  37. ohr oben rechts.
  38. Wenn ein Feld im Dialog einen unterstrichenen Buchstaben aufweist, 
  39. kann durch Eingabe von <Alternate>-Buchstabe das betreffende Feld 
  40. ausgelöst werden.
  41. Dialogboxen mit editierbaren Feldern weisen eine Besonderheit auf: 
  42. Durch Betätigen von <Return> wird der Dialog nicht wie gewohnt ver- 
  43. lassen; vielmehr wird ein Editfeld weitergeschaltet. Um den Dialog 
  44. mit der Tastatur zu verlassen, muß <Shift>-<Return> betätigt werden.
  45. Schattiert dargestellte Objekte in Dialogboxen ziehen nach ihrer Be- 
  46. tätigung weitere Eingabeaufforderungen nach sich.
  47.  
  48. Eingabe von Sonderzeichen:
  49. Nicht direkt mit der Tastatur erreichbare Zeichen (Akzentzeichen, 
  50. etc.) können entweder mit Kombitasten oder durch Eingabe ihres 
  51. ASCII-Codes dargestellt werden. Dem ASCII-Code (dezimal) ist dazu ein 
  52. #-Zeichen voranzustellen (z.B. #146 -> Æ).
  53.  
  54. Kombitasten:
  55.    ,c -> ç  ,C -> Ç
  56.    `a -> à  `e -> è  `i -> ì  `o -> ò  `u -> ù
  57.    'a -> á  'e -> é  'i -> í  'o -> ó  'u -> ú  'E -> É
  58.    ^a -> â  ^e -> ê  ^i -> î  ^o -> ô  ^u -> û
  59.    ~n -> ñ  ~N -> Ñ
  60.    :a -> ä  :o -> ö  :u -> ü  :A -> Ä  :O -> Ö  :U -> Ü 
  61.    :i -> ï  :y -> ÿ  :e -> ë
  62.    .a -> å  .A -> Å
  63.  
  64. Die Umwandlung in das entsprechende Sonderzeichen geschieht erst nach 
  65. Verlassen des jeweiligen Editfeldes!
  66.  
  67. Die Tastaturkürzel der Menuleisten funktionieren nicht, wenn ein Fen- 
  68. sterdialog mit Editfeldern dargestellt wird, da dann alle Tastatur- 
  69. eingaben auf ein Editfeld bezogen werden.
  70.  
  71.  
  72. 2.2 Fenstermenus
  73.  
  74. Die Fenstermenuzeile wird durch Anklicken eines Menutitels aktiviert. 
  75. Sollte der gewünschte Menutitel nicht sichtbar sein, kann er durch 
  76. Anklicken der Symbole <- bzw -> ins Fenster gebracht werden.
  77.  
  78.  
  79.  
  80. 3. Die Menuzeile
  81.  
  82. 3.1 COCKTAIL
  83.  
  84.   3.1.1 Programminfo
  85.   Zusätzlich zum üblichen Blabla Anzeige des freien Speichers.
  86.  
  87.   3.1.2 Deskaccessories
  88.   Accessories sind ohne Einschränkungen verwendbar.
  89.  
  90.  
  91. 3.2 Datei
  92.  
  93.   3.2.1 neu
  94.   Anlegen eines neuen Barfachs mit Platz für max. 65535 Zutaten und 
  95.   ebensoviel Getränken (max. 10 Barfächer).
  96.   Es wird ein Fenster geöffnet, in dem durch Anklicken oder Eingabe 
  97.   von ^G bzw. ^Z das zugehörige Getränke- bzw. Zutatenfenster ge- 
  98.   öffnet werden kann (Siehe dazu Punkte 4 und 5).
  99.   Anzeige der momentan eingetragenen Getränke (G:) und Zutaten (Z:).
  100.   Verschiedene Barfächer können beispielsweise dazu benutzt werden, 
  101.   erprobte Getränke von noch zu testenden zu Trennen oder alle Before 
  102.   Dinner Getränke zu sammeln, oder...
  103.  
  104.   3.2.2 öffnen
  105.   Laden eines Barfaches, öffnen des Barfensters wie in 3.2.1.
  106.  
  107.   3.2.3 schließen
  108.   Das aktuelle Barfenster wird geschlossen. Nur anwählbar, wenn ein 
  109.   Barfenster das aktive Fenster ist. Wiedereröffnen des Barfensters 
  110.   über den entsprechenden Menupunkt in "Barfach".
  111.  
  112.   3.2.4 sichern
  113.   Speichern der Zutaten und Getränke des aktuellen Barfensters unter 
  114.   dessen Dateinamen. (Wenn noch keiner vergeben wurde, wird automa- 
  115.   tisch "sichern als" aufgerufen.)
  116.  
  117.   3.2.5 sichern als
  118.   Wie "sichern", nur daß ein Dateiname gewählt werden kann.
  119.  
  120.   3.2.6 Ende
  121.   Beendet das Programm. Sollten noch veränderte und nicht gesicherte 
  122.   Barfächer vorhanden sein (markiert durch "*" vor dem Namen), wird 
  123.   ein Speichern dieser Barfächer angeboten.
  124.  
  125.  
  126. 3.3 Barfach
  127.  
  128.   3.3.1 Barfächer
  129.   Jedes durch Laden oder neu Anlegen geöffnete Barfach erhält einen 
  130.   Menueintrag unter diesem Menutitel. Somit können geschlossene Bar- 
  131.   fächer wieder geöffnet bzw. unter anderen Fenstern versteckte Bar- 
  132.   fenster nach oben gebracht werden.
  133.  
  134.   3.3.2 löschen
  135.   Das in einem Popup-Menu auszuwählende Barfach wird aus dem Speicher 
  136.   entfernt.
  137.  
  138.  
  139. 3.4 Parameter
  140.  
  141.   3.4.1 einstellen
  142.   ·Dialogboxen: Alle Dialoge (auch die in Fenstern) werden an der an- 
  143.    gegebenen Stelle angezeigt.
  144.   ·Getränkepreise: Bei der Anzeige der Preise wird entsprechend ge- 
  145.    rundet.
  146.   ·Drucker: Zum Ausdruck werden verschiedene Steuerzeichen des Druk- 
  147.    kers benötigt. Diese werden mittels "Einstellen" gesetzt. Der 
  148.    Druckertreiber, der im Programm verwendet werden soll, ist mittels 
  149.    "Treiber" einstellbar.
  150.   ·automatisch laden: Ein Barfach kann bei Programmstart automatisch 
  151.    geladen werden. Dabei ist zusätzlich zum Dateinamen auch die 
  152.    Option "ein" zu selektieren.
  153.   ·Getränke drucken: Durch Selektion von "mit Zutaten" werden beim 
  154.    Ausdruck neben dem Namen auch Zutaten, Zubereitung und Glas aus- 
  155.    gedruckt; sonst nur Namen und Preis.
  156.  
  157.   3.4.2 laden
  158.   Laden einer Parameterdatei.
  159.  
  160.   3.4.3 speichern
  161.   Speichern der aktuellen Parameterdatei. Wird als Dateiname 
  162.   COCKTAIL.PAR gewählt und befindet sich diese Datei im selben Ver- 
  163.   zeichnis wie COCKTAIL.PRG, so wird diese Parameterdatei automatisch 
  164.   bei Programmstart geladen.
  165.  
  166.  
  167.  
  168. 4. Zutatenfenster
  169.  
  170. Ein Einfachklick auf eine Zutat selektiert diese; ist zusätzlich eine 
  171. Shifttaste gedrückt, werden bisher selektierte Zutaten nicht deselek- 
  172. tiert.
  173. Ein Doppelklick öffnet eine Zutat zum Ansehen oder Ändern (siehe 
  174. 4.1.2).
  175.  
  176.  
  177. 4.1 Zutat
  178.  
  179.   4.1.1 neu
  180.   In einem Dialog können Name, Inhalt, Preis und Verfügbarkeit einer 
  181.   neuen Zutat eingegeben werden.
  182.  
  183.   4.1.2 öffnen
  184.   Die bei Neueingabe eingegebenen Daten einer Zutat werden angezeigt 
  185.   und können bei Bedarf geändert werden. Änderungen werden dabei 
  186.   automatisch auch in die Getränkerezepte übernommen.
  187.  
  188.   4.1.3 löschen
  189.   Alle selektierten Zutaten werden entfernt, wenn sie nicht für ein 
  190.   Getränk benötigt werden.
  191.  
  192.   4.1.4 drucken
  193.   Von allen selektierten Zutaten werden Name, Inhalt und Preis sowie 
  194.   die Preise verschiedener kleiner Mengen dieser Zutat auf einem 
  195.   Drucker ausgegeben. Als "nicht vorhanden" markierte Zutaten werden 
  196.   dabei hervorgehoben gedruckt (Parameter-Drucker einstellen-Hervor- 
  197.   heben).
  198.  
  199.  
  200. 4.2 Arbeiten
  201.  
  202.   4.2.1 ausschneiden
  203.   Alle selektierten Zutaten werden in ein internes Klemmbrett über- 
  204.   nommen und, falls möglich (siehe 4.1.3), aus dem aktuellen Fenster 
  205.   gelöscht.
  206.  
  207.   4.2.2 kopieren
  208.   Wie 4.2.1, nur daß die Zutaten nicht gelöscht werden.
  209.  
  210.   4.2.3 einfügen
  211.   Mittels 4.2.1 oder 4.2.2 ins Klemmbrett gebrachte Zutaten werden in 
  212.   das aktuelle Fenster eingefügt. Bei Namensgleichheit folgt eine 
  213.   weitere Abfrage.
  214.  
  215.   4.2.4 alle selektieren
  216.   Alle Zutaten des aktuellen Fensters werden selektiert.
  217.  
  218.   4.2.5 Selektion invertieren
  219.   Selektierte Zutaten werden zu nicht selektierten und umgekehrt. Um 
  220.   ein "deselektiere alle" durchzuführen, kann man demnach zunächst 
  221.   "alle selektieren" und dann die "Selektion invertieren" (Oder auf 
  222.   ein freies Feld im Fenster klicken).
  223.  
  224.   4.2.6 suchen
  225.   Der einzugebende Suchtext wird in dem mit "suchen nach" definierten 
  226.   Bereich gesucht. Dabei werden nur Zutaten berücksichtigt, deren 
  227.   Status dem in "Auswahl aus" entspricht.
  228.   Der Suchtext darf bei Suche nach Text (Namen) die Wildcards "*" und 
  229.   "?" enthalten, bei Suche nach Zahlen (Inhalt/Preis) die Operatoren 
  230.   ">" und "<" (größer als und kleiner als), diese jedoch nur an er- 
  231.   ster Stelle im Suchtext.
  232.   Beispiel: Suche aller nicht vorhandenen Zutaten, die mit Y begin- 
  233.   nen: Suchtext: Y*, suchen nach: Name, Auswahl aus: nicht vorhande- 
  234.   nen, <Shift><Return> (wg. Editierfeld funktioniert <Return> allei- 
  235.   ne nicht -> 2.1).
  236.  
  237.  
  238.  
  239. 5. Getränkefenster
  240.  
  241. Ein Einfachklick auf ein Getränk selektiert dieses; ist zusätzlich 
  242. eine Shifttaste gedrückt, werden bisher selektierte Getränke nicht 
  243. deselektiert.
  244. Ein Doppelklick öffnet ein Getränk (siehe 5.1.2) zum Ansehen oder 
  245. Ändern.
  246.  
  247.  
  248.  
  249. 5.1 Getränk
  250.  
  251.   5.1.1 neu
  252.   Es erscheint ein Dialog, in dem die verschiedenen Parameter eines 
  253.   Getränks eingegeben werden können.
  254.   ·Name: Name des Getränks
  255.   ·Typ: Durch Klicken auf den Popup-Knopf (schattiert) erscheint eine 
  256.    Auswahl an Getränketypen.
  257.   ·Glas: Siehe Typ
  258.   ·Zutaten: Durch Klick in ein Feld des linken Blocks erscheint eine 
  259.    Mengenauswahl. Klickt man hier auf "anders...", so gelangt man zu 
  260.    einem weiteren Dialog, der die exakte Mengenangabe ermöglicht.
  261.    Ein Klick in den rechten Block öffnet das Zutatenfenster. Durch 
  262.    Klick auf eine Zutat wird diese in den Getränkedialog übernommen. 
  263.    Sollte die gewünschte Zutat noch nicht eingegeben sein, so kann 
  264.    dies über den Menupunkt "Zutat-neu" nachgeholt werden.
  265.   ·Zubereitung: Drei Zeilen zur freien Verfügung. Man beachte, daß, 
  266.    wie in allen übrigen Editfeldern, Kombitasten und Zeicheneingabe 
  267.    über den ASCII-Code (vgl. 2.1) erst nach Verlassen der Editzeile 
  268.    aufgelöst werden.
  269.   ·Status: Durch Klick auf "Status testen" werden der Gesamtinhalt 
  270.    und der Preis des aktuellen Getränks berechnet, sowie die Verfüg- 
  271.    barkeit desselben getestet (verfügbar, wenn alle Zutaten den Vor- 
  272.    handenstatus besitzen).
  273.  
  274.   5.1.2 öffnen
  275.   Die bei Neueingabe eingegebenen Daten eines Getränks werden ange- 
  276.   zeigt und können bei Bedarf geändert werden.
  277.  
  278.   5.1.3 löschen
  279.   Alle selektierten Getränke werden entfernt.
  280.  
  281.   5.1.4 drucken
  282.   Von allen selektierten Getränken werden die in 3.4.1 eingestellten 
  283.   Daten gedruckt. Nicht verfügbare Getränke werden hervorgehoben aus- 
  284.   gegeben.
  285.  
  286.  
  287. 5.2 Arbeiten
  288.  
  289.   5.2.1 ausschneiden
  290.   Alle selektierten Getränke werden mit den dafür benötigten Zutaten 
  291.   in ein internes Klemmbrett übernommen und aus dem aktuellen Fenster 
  292.   gelöscht.
  293.  
  294.   5.2.2 kopieren
  295.   Wie 5.2.1, nur daß die Getränke nicht gelöscht werden.
  296.  
  297.   5.2.3 einfügen
  298.   Mittels 5.2.1 oder 5.2.2 ins Klemmbrett gebrachte Getränke werden 
  299.   in das aktuelle Fenster eingefügt. Bei Namensgleichheit folgt eine 
  300.   weitere Abfrage, im Zielfenster nicht vorhandene Zutaten werden 
  301.   automatisch mitkopiert.
  302.  
  303.   5.2.4 alle selektieren
  304.   Alle Getränke des aktuellen Fensters werden selektiert.
  305.  
  306.   5.2.5 Selektion invertieren
  307.   Selektierte Getränke werden zu nicht selektierten und umgekehrt. Um 
  308.   ein "deselektiere alle" durchzuführen, kann man demnach zunächst 
  309.   "alle selektieren" und dann die "Selektion invertieren" (Oder auf 
  310.   ein freies Feld im Fenster klicken).
  311.  
  312.   5.2.6 suchen
  313.   Der einzugebende Suchtext wird in dem mit "suchen nach" definierten 
  314.   Bereich gesucht. Dabei werden nur Getränke berücksichtigt, deren 
  315.   Status dem in "Auswahl aus" entspricht.
  316.   Der Suchtext darf die Wildcards "*" und "?" enthalten.
  317.  
  318.  
  319.  
  320. 6. Änderung der Resourcedatei
  321.  
  322. Das Übertragen des Programms auf andere Sprachen ist durch Ändern der 
  323. Resourcedatei vollständig möglich. Lediglich die Meldungen "Anmelden 
  324. beim AES hat nicht funktioniert" und "Resourcedatei nicht ladbar" 
  325. bleiben aus verständlichen Gründen immer in deutsch.
  326. Zur Beachtung:
  327. ·Der Name des Programmautors stellt eine unveränderliche Größe dar. 
  328.  Änderungen verunmöglichen die Ausführbarkeit des Programms.
  329. ·Der Text des Menupunkts "Barfach-löschen..." muß die Länge des Ori- 
  330.  ginaleintrags besitzen, da sonst die Namen der Barfächer falsch ein- 
  331.  getragen werden.
  332. ·Die Free Strings für die Alertboxen dürfen nicht in Alert-Strings 
  333.  umgewandelt werden (da Interface dies tut, ist ein "x" am Anfang, 
  334.  damit Interface dies nicht tut.) Die Struktur der Alertboxen ist 
  335.  etwas gegenüber der Norm erweitert: Erlaubt sind max. 16 Zeilen à 
  336.  max. 55 Zeichen. %U unterstreicht eine Zeile einmal, %D zweimal, %F 
  337.  schreibt die Zeile in Fettschrift.
  338.  Für die $-Zeichen setzt das Programm die aktuellen Strings ein. Bei 
  339.  Auftreten mehrerer $-Zeichen sollte bei Übersetzungen die logische 
  340.  Reihenfolge beibehalten werden, um Verwirrungen (des Benutzers, dem 
  341.  Programm ist es egal) zu vermeiden.
  342. ·In den Nichtalertboxfreestrings trennt das $-Zeichen verschiedene 
  343.  Texte. Die Länge dieser Texte muß dann, wenn sie Leerzeichen am Ende 
  344.  enthalten, beibehalten werden (Sonst müllt die Druckausgabe). -> 
  345.  Ausprobieren.
  346. ·Neue Getränktypen und -gläser kann man einfach zu den bestehenden 
  347.  hinzufügen. Bei den Gläsern sollte man allerdings die gegebene Icon- 
  348.  größe (Breite 48, Höhe 90 Pixel) beibehalten und als Icontext nicht 
  349.  mehr als sieben Zeichen verwenden.
  350. ·AUF KEINEN FALL DARF DIE OBJEKTREIHENFOLGE VERÄNDERT WERDEN!!! Das 
  351.  heißt: keine Objekte löschen, nicht sortieren!
  352.  
  353.  
  354.  
  355. 7. Beispielsitzung
  356.  
  357. Wie beginne ich am besten, um beiliegende Cocktailrezepte an meinen 
  358. Barschrank anzupassen?
  359.  
  360. ·COCKTAIL.BAR laden (Datei-öffnen). 
  361. ·Zutatenfenster öffnen (Klick auf Symbol "Zutaten" im Barfenster).
  362. ·Alle Zutaten selektieren (Arbeiten-alle selektieren (Fenstermenu)).
  363. ·Zutaten anzeigen lassen (Zutat-öffnen (Fenstermenu)).
  364. ·Den "Zutat vorhanden"-Knopf entsprechend einstellen, <Shift><Return> 
  365.  (oder OK).
  366. ·Die nächste Zutat wird angezeigt, ...
  367. ·Barfenster nach oben bringen, Getränkefenster öffnen
  368. ·Alle verfügbaren Getränke suchen (Arbeiten-suchen in der Menuzeile 
  369.  des Getränkefensters): Suchtext:*, suchen nach: Name, Auswahl aus: 
  370.  selektierten, nicht selektierten, verfügbaren.
  371. ·Alle selektierten Getränke ins Klemmbrett (Arbeiten-kopieren).
  372. ·Neues Barfach anlegen (Datei-neu).
  373. ·Getränkefenster des neuen Barfachs öffnen.
  374. ·Klemmbrett einfügen (Arbeiten-einfügen).
  375. ·Barfenster des neuen Barfachs nach oben, abspeichern (Datei-sichern 
  376.  als).
  377. ·Im neuen Barfach stehen nun alle Getränke, die sofort gemixt werden 
  378.  können.
  379.  
  380.  
  381.  
  382. 8. Programmstatus
  383.  
  384. Dieses Programm ist Freeware. Das bedeutet hier:
  385.  
  386. ·Die Benutzung erfolgt in jeder Hinsicht auf eigene Gefahr.
  387. ·Jeder darf dieses Programm unentgeltlich benutzen und kopieren.
  388. ·Die Weitergabe ist ausschließlich nur dann gestattet, wenn die 
  389.  Dateien COCKTAIL.PRG, COCKTAIL.RSC und COCKTAIL.TXT in unveränderter 
  390.  Form vorliegen (bzw. COCKTAIL.RSC und COCKTAIL.TXT in sinngemäßer 
  391.  Übersetzung).
  392.  
  393.  
  394.  
  395. 9. Für Interessierte
  396.  
  397. Wer dieses Programm gern benutzt, der möge sich zu einer Spende von 
  398. DM 20.- (oder natürlich mehr) auf obiges Konto hinreißen lassen. Im 
  399. Gegenzug spendiere ich dann die neueste Version mit weiteren 
  400. Cocktailrezepten.
  401.  
  402. Wer sich einmal als derart großzügig erwiesen hat, kann mir jederzeit 
  403. eine rückfrankierte Diskette schicken, auf die ich dann mit neuen Re- 
  404. zepten (zur Zeit ca. 300 neue, geplant ca. 1000) und/oder einer neuen 
  405. Version antworten werde.
  406.  
  407. Irgendwelche Spenden entfallen, wenn ich 50 mir bis dato unbekannte 
  408. Rezepte als *.BAR erhalte. 
  409.  
  410.  
  411.  
  412. 10. Zu den Rezepten
  413.  
  414. Alle Getränke sollten, wenn nicht anders angegeben, in einem Shaker 
  415. mit Eis geschüttelt werden. (Ich war zu faul, dies bei fast jedem 
  416. Rezept hinzuschreiben.)
  417. Die Aussage "rühren" sollte als "im Mixglas mit Eis rühren" verstan- 
  418. den werden.
  419.  
  420.