NoPaste

Anleitung zum Kalender-Script

von heinz

SNIPPET_TEXT:
  1. Anleitung zum Kalenderscript:
  2. ------------------------------
  3.  
  4. Zuerst:
  5. Die Verwendung ist freiwillig. Sollte dieses Script an Ihrem Computer
  6. irgendwelchen Schaden anrichten, (Bei mir hat es das nicht getan..)
  7. so ist das Ihr Problem.
  8.  
  9.  
  10. Dieses Script erhebt NICHT den Anspruch "Perfekt" zu sein.
  11. Es Entstand aus einer Idee aus dem Debian-Forum und wurde innerhalb von
  12. ca. 20-30 Stunden "Zusammengestrickt".
  13. Bitte fuehlen Sie sich frei es nach Ihren Vorstellungen zu veraendern
  14. und/oder anzupassen.
  15. Ich habe versucht "sinnvolle" Variablennamen und Kommentare zu verwenden.
  16.  
  17.  
  18. Das Script besteht aus mehreren Dateien:
  19. kal.sh            -> Das eigentliche Script.
  20. anleitung.txt     -> Diese Anleitung.
  21. dialogrc          -> Farbeinstellungen fuer die Menues (dialog).
  22.  
  23. Bei der Benutzung werden im selben Verzeichnis in dem auch das Script liegt
  24. zwei weitere Dateien angelegt:
  25. einstellungen.txt -> Hier drin sind die Einstellungen fuer den Kalender.
  26. feiertagliste.txt -> Hier drin sind die von Ihnen angelegten Feiertage.
  27.  
  28. Zur Laufzeit wird noch ein Verzeichnis mit temporaeren Daten angelegt:
  29. /tmp/temp_kalender_temp
  30. und nach beenden des Scriptes wieder entfernt.
  31.  
  32. Um zu funktionieren benoetigt das Script ein paar Programme:
  33. z.B. dialog, convert, montage, identify und noch ein Paar.
  34. Die Existenz dieser Programme wird beim Start ueberprueft.
  35.  
  36. Ich Empfehle Ihnen, das Script in einem eigenen Verzeichnis abzulegen.
  37. So haben Sie die Daten, die das Script anlegt/benoetigt (Einstellungen,
  38. Feiertage, Farbeinstellungen und Anleitung) an einer Stelle versammelt.
  39. Wenn Sie es von ueberall her nutzen moechten, erzeugen Sie einfach einen
  40. symbolischen Link darauf in >~/bin<.
  41.  
  42.  
  43.  
  44. Was ist der Zweck dieses Scriptes:
  45. -----------------------------------
  46. Es erzeugt einen einfachen Jahreskalender mit Wochen- und Feiertagsangabe.
  47. Man kann auch noch ein Bild ueber den Tagen positionieren, falls gewuenscht.
  48. Der Kalender wird als einzelbildfolge erstellt und zwar in dem Verzeichnis
  49. von dem aus Sie das Script starten.
  50. Ein Bild pro Monat.
  51. Die Entscheidung fuer die Einzelbild-Loesung traf ich auf Grund der
  52. Flexibilitaet dieser Loesung. (Siehe auch am Ende dieser Anleitung...)
  53.  
  54.  
  55.  
  56. Start des Scriptes:
  57. --------------------
  58. Startet man das Script ohne Parameter, gelangt man ins Hauptmenue.
  59. Mann kann durch die Angabe einer vierstelligen Jahreszahl auch gleich ein
  60. Jahr fuer den Kalender vorgeben.
  61. Wird keines angegeben, gilt das Aktuelle.
  62.  
  63. Mit der Option >-e JAHR< wird sofort ein Kalender fuer das entsprechende
  64. Jahr erstellt ohne das Menue zu starten.
  65. (Sie muessen min. einmal im Menue die Einstellungen gespeichert haben
  66.  um Kalender erstellen zu koennen.)
  67.  
  68. Mit der Option >--fonts< wird im aktuellen Verzeichnis ein Bild mit dem
  69. Namen >fonts.png< angelegt, welches ein Beispiel fuer jeden Font enthaelt
  70. den das Programm >convert< auf Ihrem System kennt.
  71. Betrachten Sie dieses Bild mit einem Bildbetrachter Ihrer Wahl.
  72.  
  73. Mit der Option >--help< wird eine kurze Liste der Optionen angezeigt.
  74.  
  75.  
  76.  
  77. Bedienung:
  78. -----------
  79. Um in den Menues zu navigieren, benutzen Sie die Pfeil-, Tabulator- und
  80. die Eingabetaste.
  81. Um Menuepunkte direkt "anzuspringen" koennen Sie auch die farblich
  82. unterlegten Anfangsbuchstaben nutzen.
  83. Mit der Maus muesste es auch gehen.
  84.  
  85.  
  86.  
  87. Hauptmenue:
  88. ------------
  89. Oben rechts sehen Sie das eingestellte Jahr.
  90.  
  91. Mit "Einstellungen machen" kommen Sie ins Einstellungsmenue.
  92. Hier stellen Sie die Parameter fuer das Aussehen des Kalenders ein.
  93.  
  94. Mit "Standard-Einstellungen wiederherstellen" koennen Sie alle Werte wieder
  95. auf Standard-Werte zurueckstellen.
  96.  
  97. Mit "Kalender erstellen" starten Sie die Erstellung des Kalenders fuer das
  98. eingestellte Jahr.
  99.  
  100. Mit "Feiertags menue" kommen Sie, wer haetts gedacht, in das Feiertagsmenue.
  101.  
  102. Mit "Anleitung lesen" koennen Sie diese Anleitung lesen.
  103. Nutzen Sie die Pfeiltasten auf/ab zum Lesen und die Taste >/< zum Suchen.
  104.  
  105.  
  106. Einstellungsmenue:
  107. -------------------
  108. Jahr:                           = Das Jahr fuer den Kalender.
  109. Groesse Tage: (BxH)             = Tagesgroesse in Pixel. (Breite mal Hoehe)
  110. Aufteilung Tage: (Horiz.xVert.) = Die Verteilung der Tage auf dem Kalender.
  111.                                   Der Standard >7x5< sind 5 Reihen a 7 Tage.
  112.                                   Der Gesamtwert darf nicht unter 31 liegen!
  113. Abstand Tage Horizontal:        = Leerraum links und rechts um einen Tag.
  114. Abstand Tage Vertikal:          = Leerraum oben und unten um einen Tag.
  115. Schriftgroesse Tage:            = Textgroesse fuer "Tag Wochentag" in Pixel.
  116. Schriftfarbe Tage:              = Textfarbe fuer "Tag Wochentag" in #rrggbb.
  117. Schriftfarbe Sonntage:          = Textfarbe fuer Sonntage in #rrggbb.
  118. Hintergrundfarbe Tage:          = Hintergrundfarbe der Tage in #rrggbb.
  119. Schriftart:                     = Schriftart fuer alle Texte.
  120. Textposition Tage:              = Textposition fuer den Tag und Wochentag.
  121. Rahmendicke Tage:               = Rahmendicke um die Tage. (0=kein Rahmen.)
  122. Rahmenfarbe Tage:               = Rahmenfarbe um die Tage.
  123. Schriftgroesse Monat:           = Schriftgroesse fuer den Monatsnamen.
  124. Schriftfarbe Monat:             = Textfarbe fuer Monatsnamen in #rrggbb.
  125. Rand Horizontal:                = Horizontaler Rand des Kalenderblattes.
  126. Rand Vertikal:                  = Vertikaler Rand des Kalenderblattes.
  127. Hintergrundfarbe Kalender:      = Hintergrundfarbe des Kalenderblattes.
  128. Schriftgroesse Feiertag:        = Textgroesse fuer Feiertage in Pixel.
  129. Textposition Feiertag:          = Textposition fuer Feiertage.
  130. Schriftfarbe Feiertage:         = Textfarbe fuer Feiertage in #rrggbb.
  131. Schriftgroesse Woche:           = Textgroesse fuer "Woche" in Pixel.
  132. Textposition Woche:             = Textposition fuer die Woche.
  133. Schriftfarbe Woche:             = Textfarbe fuer "Woche" in #rrggbb.
  134. Text vor Woche:                 = Kurzer Text vor der Wochennummer.
  135.                                   z.B. KW (Kann auch leer sein.)
  136.  
  137.  
  138. Um eine andere Schriftart zu waehlen, koennen Sie sich die Schriften
  139. ansehen, die von dem Programm >convert< unterstuetzt werden.
  140. Betaetigen Sie dazu im Einstellungsmenue die Taste >Fonts<.
  141. Beenden Sie diese Ansicht mit der Taste >q<.
  142. Oder geben Sie in einer Konsole folgenden Befehl ein:
  143. convert -list font
  144. Wenn Sie dieses Script mit dem Parameter >--fonts< starten, wird im
  145. aktuellen Verzeichnis eine Grafik-Datei namens >fonts.png< angelegt.
  146. In dieser ist ein Beispiel fuer jeden unterstuetzten Font enthalten.
  147.  
  148.  
  149. Um die Textstellen zu positionieren, nutzt >convert< 9 Richtungsangaben:
  150. Center North NorthEast East SouthEast South SouthWest West NorthWest
  151. Eine pixelgenaue Positionierung ist in dieser Version des Scriptes noch
  152. nicht vorgesehen.
  153. Um eine Liste aller Positionen zu sehen, druecken Sie im Einstellungsmenue
  154. die Taste >Textpositionen<.
  155.  
  156.  
  157. Die Einstellungen werden im selben Verzeichnis gespeichert, in dem das
  158. Script gespeichert ist.
  159.  
  160.  
  161.  
  162. Feiertagsmenue:
  163. ----------------
  164. Mit "zeige Feiertage" koennen Sie sich die Daten fuer die Feiertage in
  165. einem bestimmten Jahr anzeigen lassen.
  166. Dabei sind Rot markierte Feiertage schon vorbei. Gelbe kommen noch.
  167.  
  168. Mit "neuer Feiertag" koennen Sie neue Feiertage in Ihrer Liste aufnehmen.
  169. Um zu erfahren, wie Sie das Entsprechende Datum eingeben, nutzen Sie die
  170. Hilfe-Taste.
  171.  
  172. Mit "Feiertage bearbeiten" koennen Sie Feiertage aus Ihrer Liste veraendern.
  173.  
  174. Mit "loesche Feiertage" koennen Sie Feiertage aus Ihrer Liste loeschen.
  175.  
  176.  
  177. Die Liste der Feiertage wird ebenfalls im selben Verzeichnis gespeichert,
  178. in dem das Script gespeichert ist.
  179.  
  180.  
  181.  
  182. Zusaetzliche Bilder auf jedem Kalenderblatt:
  183. ----------------------------------------------
  184. Es ist vorgesehen, das Sie sich ein Bild Ihrer Wahl in jedes Kalenderblatt
  185. einfuegen koennen. (Ueber der Liste der Tage.)
  186. Das jeweilige Bild ist optional.
  187.  
  188. Um die Bilder einzufuegen, kopieren Sie 12 Bilder (Eines pro Monat) in das
  189. dafuer vorgesehene Verzeichnis. Der Standardort fuer dieses Verzeichnis
  190. ist wie immer im selben Verzeichnis, in dem auch das Script gespeichert ist.
  191. Sein Name ist >bilder<.
  192. Die Bilder koennen auf 3 verschiedene Arten benannt sein.
  193. 1. [1-12].typ
  194. 2. [01-12].typ
  195. 3. Monatsname.typ
  196. Werden die Bilder bei der Erstellung des Kalenders gefunden, werden sie
  197. automatisch benutzt.
  198. Auf die Groesse dieser Bilder und deren Typ brauchen Sie nicht unbedingt
  199. zu achten, da das Programm >montage< mit dem diese eingefuegt werden
  200. "intelligent" genug ist um sie anzupassen.
  201.  
  202.  
  203.  
  204. Ein letztes noch:
  205. ------------------
  206. Da es viele Ansichten darueber gibt was fuer ein Ausgabeformat am
  207. sinnvollsten ist und es unter Linux unzaehlige tools gibt mit denen Sie die
  208. erstellten Monats-Bilder weiter bearbeiten koennen, moechte ich Ihnen diese
  209. Wahl gerne selbst ueberlassen.
  210. Daher habe ich mich fuer die Loesung mit den Einzelbildern entschieden.
  211.  
  212. Am Ende des Scriptes habe ich eine einfache Stelle markiert, wo Sie die
  213. Befehle Ihrer Wahl einfuegen koennen, um daraus zu machen was Sie moechten.
  214.  
  215.  
  216.  
  217. Ich hoffe Sie finden das Script nuetzlich und es laeuft bei Ihnen Fehlerfrei.
  218.  
  219. Gruss,
  220. heinz
  221.  
  222.  

Quellcode

Hier kannst du den Code kopieren und ihn in deinen bevorzugten Editor einfügen. PASTEBIN_DOWNLOAD_SNIPPET_EXPLAIN