Ãœber diese Web-Seiten
Willkommen auf den RagTime-Expertenseiten.
Auf diesen Seiten kann zu RagTime diskutiert werden, RagTime-Kenner können ihr Know-How anbieten und zeigen. Viele Informationen und Beispieldateien stehen kostenlos zur Verfügung, sie finden aber auch Angebote kommerzieller Schulungsunternehmen und von Beratern.
Was können Sie auf diesen Seiten?
Als nicht-registrierter Besucher dürfen Sie sich die Seiten ansehen und Dateien herunterladen.
Wenn Sie sich als Teilnehmer registrieren, können Sie zusätzlich:
- sich an Diskussionen im Forum beteiligen
- viele der vorhandenen Seiten kommentieren
- dem Verfasser Nachrichten schicken
- eigene Beiträge schreiben
Letztere sind allerdings "moderiert", das heißt, die Beiträge müssen von einem der Verwalter freigeschaltet werden, bevor andere sie sehen können. Während der normalen Büro-Zeiten wird dies recht schnell geschehen.
Diese Seiten wenden sich an registrierte Besucher und geben eine kleine Einführung, wie man mit diesen Web-Seiten umgeht.
Registrieren
Wie registriert man sich?
Damit Sie Beiträge schreiben können, müssen Sie auf diesem Web-Server registriert sein.
Klicken Sie links auf "Anmelden", dann darunter auf "Konto einrichten". Geben Sie in dem folgenden Formular bitte mindestens einen Benutzernamen und eine E-Mail-Adresse an. Die Mail-Adresse wird zum Beispiel benötigt, um Ihnen Ihr vorläufiges Kennwort zuzusenden.
Auch Benachrichtigungen über neue Beiträge (frei konfigurierbar) funktionieren natürlich nur, wenn das System Sie per Mail erreichen kann.
Wie viele persönliche Informationen Sie eingeben, bleibt Ihnen überlassen. Diese Informationen sind für andere registrierte Besucher sichtbar. Auch diese können Sie noch später ändern.
Sobald Sie Ihr Kennwort per E-Mail erhalten haben, können Sie sich unter "Anmeldung" an dem System anmelden. Sie gelangen auf die Seite mit Ihren Daten. Mit dem Link "Mein Konto" können Sie diese Seite jederzeit wieder öffnen.
Die Seite für Ihr Konto zeigt drei Reiter: "Anzeigen", "Bearbeiten" und "Benachrichtigungseinstellungen".
Unter "Bearbeiten" können Sie Ihr vorläufiges Kennwort ändern. ebenso wie Ihren Benutzernamen und Ihre E-Mail-Anschrift. Beachten Sie auch die Untergruppe "Persönliche Informationen", die jetzt unter den Seitenreitern steht. Klicken Sie sie, um die Daten zu ändern, die andere Benutzer über Sie sehen können.
Unter "Benachrichtigungs-Einstellungen" können Sie das System veranlassen, Sie per E-Mail zu informieren, wenn neue Beiträge erschienen sind.
Lesen Sie auch die ausführlichen Informationen zu Konto-Einstellungen
Beiträge schreiben
Wie schreibt man Beiträge?
Wenn Sie als registrierter Besucher angemeldet sind, erscheint in der Navigation links unter Ihrem Namen der Link "Beitrag schreiben".
Klicken Sie ihn an, wenn Sie auf dem Web-Site einen Beitrag veröffentlichen wollen. Alle Beiträge (mit Ausnahme des Forums) sind moderiert, das heißt, sie müssen von einem Administrator freigeschaltet werden.
Es gibt mehrere Web-Formulare, die Sie für Beiträge benutzen können. Sie unterscheiden sich etwas in ihren Möglichkeiten:
- Beitrag mit Download-Dokument
- Forum-Beitrag
- Mehrere Texte und Bilder
- Schulung
Die meisten Beiträge werden mit dem Link "Beitrag mit Download-Dokument" angelegt. Das Web-Formular erlaubt Ihnen, ein kleines Bild als Vorschau zu benutzen, und ein größeres Bild für den Text selbst. Einem Beitrag können Dateien (RagTime-Dokumente zum Beispiel) angehängt werden.
Wenn Sie für einen Beitrag mehrere Bilder brauchen, dann benutzen Sie bitte den Link "Mehrere Texte und Bilder". Das Formular erlaubt bis zu sechs Bilder und Textabschnitte. Im übrigen entspricht es dem normalen "Beitrag mit Download-Dokument".
Anbieter von RagTime-Trainingsveranstaltungen können diese mit "Schulung" ankündigen. Zu solchen Beiträgen können Datum und Uhrzeit festgelegt werden. Der Beitrag erscheint dann in der Liste rechts unter den "Nächsten Terminen" und im Veranstaltungskalender.
Sie können an dieser Stelle auch mit "Forum-Beitrag" eine neue Diskussion im Forum beginnen, einfacher geht das jedoch im Forum selbst.
An Diskussionen beteiligen
Download-Seiten anlegen
Download-Seiten anlegen
Bitte beachten Sie die grundsätzlichen Spielregeln: Veröffentlichen Sie nichts, an dem andere Personen das Copyright haben! Veröffentlichen Sie bitte auch nichts, was andere Besucher beleidigen könnte.
Jeder Beitrag braucht einen Titel, den Sie gleich im ersten Feld des Formulars eingeben. In dem Menü darunter wählen Sie aus, wo in der Navigation des Download-Bereichs die Seite erscheinen soll.
Es gibt zwei Beschreibungsfelder: "Kurzbeschreibung" und "Ausführliche Beschreibung". Die Kurzbeschreibung erscheint in Listendarstellungen, z.B. auf der Startseite und wenn ein Besucher auf einen der Links in der Navigation zum Download-Bereich klickt. Die "Ausführliche Beschreibung" wird erst sichtbar, wenn jemand auf "Ganzen Beitrag lesen" klickt.
Enstsprechend gibt es für eine Vorschau des Dokuments zwei Bildfelder, in denen Sie beispielsweise .png-Dateien auf den Server laden können. "Kleines Bild" erscheint in den Listendarstellungen, klickt ein Leser auf "Ganzen Beitrag lesen" sieht er zusätzlich ein ggf. vorhandenes großes Bild.
Geben Sie Ihre Beschreibung in die Felder ein. Dabei könne Sie entweder einfachen Text benutzen, oder aber auch einen Teil der HTML-Auszeichnungsmarken. Klicken Sie auf das kleine + hinter "Filtered HTML" um zu sehen, welche HTML-Tags hier funktionieren.
Im unteren Bereich des Formulars können Sie die Datei anhängen. Falls es eine geeignete Abbildung gibt, laden Sie diese bitte zusätzlich unter "Kleines Bild" oder "Großes Bild" auf den Server. Benutzen Sie bitte Standardformate wie .png oder .jpg.
Download-Seiten haben folgende Voreinstellungen, die nach dem Freischalten greifen:
- Der Beitrag erscheint automatisch auf der Startseite
- Registrierte Besucher dürfen frei Kommentare zu den Seiten schreiben
Mehrere Texte und Bilder
Schulungsseiten anlegen
Schulungs-Ankündigungen anlegen
Wenn Sie selbst Schulungen zu RagTime anbieten (oder aber von einer RagTime-Schulung wissen), können Sie sie mit dem Formular "Schulung" in das System stellen.
Jeder Beitrag braucht einen Titel, den Sie gleich im ersten Feld des Formulars eingeben. Schulungs-Hinweise sollten bereits hier den Veranstaltungsort erkennen lassen. Falls sich die Veranstaltung an eine eingeschränkte Gruppe richtet (z.B. Hochschulveranstaltung nur für Studenten), vermerken Sie bitte auch das "eingeschränkt" gleich im Titel. Damit ersparen Sie anderen Besuchern viele unnötige Mausklicks.
Geben Sie eine Beschreibung ein. Dabei könne Sie entweder einfachen Text benutzen, oder aber auch einen Teil der HTML-Auszeichnungsmarken. Klicken Sie auf das kleine + unter "Formatierungsrichtlinien" um zu sehen, welche HTML-Tags hier funktionieren. Anker können benutzt werden, falls Sie auf eine ausführliche Beschreibung verzweigen wollen.
Geben Sie für die Veranstaltung den Beginn und das Ende ein, gleich ob die Veranstaltung nur an einem Tag stattfindet oder an mehreren aufeinander folgenden.
Ggf. können Sie noch eine Datei anhängen, z.B. ein PDF mit genaueren Informationen.
Voreinstellungen für Schulungs-Seiten:
Schulungsseiten gehören zu den Terminen, von denen immer die nächsten in dem Navigationsbalken rechts erscheinen. Betrachtet ein Besucher eine dieser Seiten, steht ihm der Kalender zur Verfügung, um sich durch weitere Termine zu navigieren.
Schulungsseiten dürfen nicht kommentiert werden.
Details zur Formatierung
HTML-Filterung
- Bestimmte HTML-Tags können benutzt werden
(klicken Sie auf das kleine Symbol unter "Formatierungsrichtlinien", um die aktuell möglichen Tags zu sehen.)
- Einfache URLs werden automatisch zu Links gewandelt
- Links können in einem Stil ähnlich der Wikipedia-Seiten eingegeben werden
Um einen Text hervorzuheben, schreiben Sie ihn so: "<em>hervorgehoben</em>". Er erscheint dann als hervorgehoben.
Alternativ kann "strong" benutzt werden: Schreiben Sie es dann so: "<strong>hervorgehoben</strong>". Er erscheint dann als hervorgehoben.
Wenn Sie einen einfachen Web-Link wie www.ragtime.de schreiben, erscheint er automatisch als www.ragtime.de
Entsprechend wird aus "support@ragtime.de" automatisch support@ragtime.de.
Links im Wiki-Stil
Links im Wiki-Stil erlauben, einen anderen Text als die Link-Adresse selbst zu haben. Einen Link wie:
Seiten der RagTime GmbH
können Sie schreiben als "[http://www.ragtime.de|Seiten der RagTime GmbH]". Im Text erscheinen die Worte nach dem senkrechten Strich, der Teil davor ist der Link.
Wie bei der Wikipedia können auch doppelte eckige Klammern benutzt werden.
Wiki-Links zu Seiten innerhalb der Experten-Seiten beginnen mit Doppelpunkt, gefolgt von dem Teil, der hinter ".../experts/" steht. Beispiel;
[:node/118|Anleitung Formatierung]
verlinkt zu dieser Seite. (Jede Seite bei den RagTime Experts hat so eine eindeutige "node"-Kennung.)
Alle Seiten auf diesem Web Site sind eindeutig in der Form "node/xxxx" ansprechbar, einige Seiten haben aber auch Namen oder zusätzliche andere Kennungen.
Weitere mögliche Anfänge für Wiki-Links:
[w:RagTime_(Software)|Wikipedia zu RagTime] verlinkt zu der RagTime-Seite in der Wikipedia in der Form:
Wikipedia zu RagTime
[google:RagTime|Google-Suche zu RagTime] erzeugt den Link "http://www.google.com/search?q=%22RagTime%22"
Dieselbe Technik können Sie verwenden für Links der Form "mailto:" und "ftp://".
Seiten kommentieren
Kommentare schreiben
Zu vielen Seiten dürfen frei Kommentare geschrieben werden. ("Frei" soll hier heißen: Diese Beiträge werden nicht moderiert. Wir behalten uns natürlich vor, Seiten zu entfernen, die beleidigenden Inhalt haben oder Rechte verletzen.)
Kann eine Seite kommentiert werden, gibt es unten auf dieser Seite den Link "Antworten". Klicken Sie ihn an um das Formular für Kommentare zu erhalten. Kommentare bestehen aus einem Betreff und dem eigentlichen Kommentar selbst. Für die Formatierung können Sie dieselben Techniken benutzen, wie für Seiten. Klicken Sie auf das "+"-Zeichen unter "Formatierungsrichtlinien" um die Liste der möglichen Tags zu sehen.
Verfasser kontaktieren
Mit Verfassern von Seiten Kontakt aufnehmen
Sofern ein Benutzer dies zugelassen hat, können Sie ihn über den Link "dem Verfasser schreiben" erreichen. Sofern der betreffende das nicht ausdrücklich abgeschaltet hat, wird er einmal pro Tag per E-Mail über ungelesene Nachrichten in diesem System informiert. Es gibt also eine gute Chance, den Betreffenden auf diesem Weg wirklich zu erreichen.
Bitte beachten Sie, dass Beiträge von "admin" nicht unbedingt von einem Administrator geschrieben wurden. "admin" ist ein sehr abstrakter Benutzer und sollte nur für Nachrichten benutzt werden, die das Funktionieren dieses Web-Sites betreffen.
Eigene Konto-Einstellungen
Registrierte Benutzer dieses Web Sites finden nach dem Anmelden in der Navigation links unter ihrem Namen den Punkt "Mein Konto".
Unter dem Reiter »Anzeigen« sehen Sie alles, was auch andere Besucher von experts.ragtime.de über Sie sehen können. Falls dort mehr steht, als Sie wollen: Ändern Sie die Einträge unter »Bearbeiten - Persönliche Informationen«.
Ein Klick auf diesen Link führt auf Einstellungsseiten, auf denen vor allem zu folgenden Bereichen Änderungen möglich sind:
- Eigener Benutzername und Kennwort, wie beim Anmelden benutzt
- Nachrichtenempfang von anderen Benutzern
- Einstellungen zu E-Mail-Benachrichtigungen
- Informationen über einen selbst für andere Benutzer
Tafel "Anzeigen"
Die Tafel "Anzeigen" gibt einen Überblick über Informationen, die auch andere Besucher dieses Web-Sites sehen können.
Beispielsweise über die Suche kann ein Besucher nach registrierten Benutzern suchen. Klickt er auf eine Fundstelle, sieht er die Informationen, die auch auf dieser Tafel erscheinen. Sie bearbeiten sie unter "Bearbeiten-Persönliche Informationen".
Tafel "Bearbeiten"
Die Tafel "Bearbeiten" hat zwei Unter-Tafeln: "Kontoeinstellungen" und "Persönliche Informationen".
"Kontoeinstellungen" betreffen Ihren Zugang zu diesem System, "Persönliche Informationen" enthält die Dinge, die andere Benutzer über sie sehen können.
Beachten Sie, dass es in beiden Tafeln eine E-Mail-Adresse gibt: Die unter "Kontoeinstellungen" benutzt der Server, um Ihnen Nachrichten zu senden. Die unter "Persönliche Informationen" ist ausschließlich eine Information für andere Benutzer.
Kontoeinstellungen
Private Nachrichten ermöglichen
Ist diese Option eingeschaltet, können andere Benutzer dieses Servers Ihnen Nachrichten senden. Diese Nachrichten erscheinen nach dem Anmelden unter dem Navigationslink "Posteingang".
Ist diese Option eingeschaltet, erscheint auf jeder Seite, die sie veröffentlichen und auf jedem Kommentar, den Sie schreiben, ein Link, um Ihnen direkt zu antworten.
Tägliche E-Mail für ungelesene Nachrichten
Ist die Option eingeschaltet, sendet der Server einmal pro Tag eine Information an Sie, wenn noch ungelesene Post in Ihrem Posteingang liegt.
Wenn Sie private Nachrichten erlauben, sollten Sie diese Option einschalten.
Benutzername
Dies ist der Name, unter dem Sie sich anmelden können und der als Verfassername für Ihre Beiträge erscheint. Der Name kann nachträglich geändert werden und erscheint dann an allen Stellen korrigiert. Mit Umlauten haben wir bisher keine Probleme beobachten können.
E-Mail-Adresse
Dies ist die Mail-Adresse, an die der Server Ihnen Nachrichten schickt, z.B. über ungelesenen Posteingang oder auch über neue Seiten auf dem Server, wenn unter "Benachrichtigungs-Einstellungen" eingeschaltet.
Passwort
Ändern Sie hier bei Bedarf Ihr Passwort. Es muss zweimal eigegeben werden, um Tippfehler zu vermeiden.
Persönliche Information
Die Tafel "Persönliche Information" enthält Informationen, die für andere Benutzer über Sie sichtbar sind.
Das Feld "E-Mail-Anschrift" ist ein freies Textfeld. Eine Adresse kann also als "irgendwer -ad- irgend.eine.domain" eingegeben werden, falls Sie den Missbrauch durch Spam-Roboter fürchten. Die Leser des Feldes werden das schon verstehen.
Das Feld "Web" ist ein normales URL-Feld, der Eintrag kann also in den Informationen über Ihr Konto einfach angeklickt werden. Bitte geben Sie das "http://" mit ein.
Tafel "Benachrichtigungs - Einstellungen"
Der Server kann Sie per E-Mail informieren, wenn es neue Beiträge gibt. Zur Zeit ist die Einstellung, dass einmal pro Tag eine Benachrichtigung mit der Liste der neuen Beiträge erzeugt wird.
Hauptschalter
Wählen Sie hier "Aktiviert" wenn Sie über neue Seiten informiert werden wollen. Ist der Hauptschalter "Deaktiviert" sind die übrigen Einstellungen dieser Tafel wirkungslos.
Detaillierte Einstellungen
Dieser Abschnitt kann im Laufe der Zeit variieren, je nach Modulen, die wir einschalten.
Schalten Sie "Ãœber neuen Inhalt benachrichtigen" auf "aktiviert", wenn Sie Zusammenfassungen mit neuen Seiten erhalten wollen.
Die meisten Seiten werden mit einem Einleitungstext und einem Haupttext geschrieben. (Einleitungstexte sind die, die Sie z.B. auf der Startseite sehen.) Wählen Sie unter "Inhalt", wie ausführlich die Benachrichtigung sein soll. In den meisten Fällen wird "Nur Titel" zu den übersichtlichsten Listen führen.
Schalten Sie "Bei neuen Kommentaren benachrichtigen" auf "aktiviert", wenn auch Kommentare anderer Benutzer in die Benachrichtigung aufgenommen werden sollen. Die meisten Seiten dieses Sites können von allen registrierten Benutzern kommentiert werden.
Auch Antworten im Forum sind "Kommentare" im Sinne der Benachrichtigungen.
Die Technik dieses Site
Informationen zur Technik, auf der diese Web-Seiten beruhen
Diese Web-Seiten beruhen auf dem Web Content Management System "Drupal",
Wenn Sie sich für dieses System interessieren, finden Sie ausführliche Informationen auf den Seiten.
www.drupal.org
Vergleiche auch
Wikipedia
Ãœbersicht RagTime und AppleScript
Note: A French version of this text can be found here
______________
RagTime 5 kann unter Mac OS in fast allen Bereichen von einem AppleScript gesteuert werden. Damit lassen sich sowohl regelmäßige Aufgaben innerhalb RagTimes automatisieren als auch durch Integration mit anderen Programmen komplexe Speziallösungen bauen.
AppleScript ist zugleich die interne Scriptingsprache von RagTime (Macintosh). Scripts können also sowohl das Programm von außen steuern als auch innerhalb des Programms ablaufen (und dabei ggf. andere Programme steuern).
Die Abbildungen zeigen dasselbe Script, einmal in dem Script-Bearbeitungsfenster von RagTime, einmal in einem separaten Script Editor. In beiden Fällen verhält sich das Script gleich, wenn es gestartet wird.
Dieser Artikel gibt eine knappe Übersicht über die Arbeit mit AppleScript in RagTime. Er wurde ursprünglich für RagTime Version 5 geschrieben und hier leicht angepasst.
Wenn Sie AppleScripts für RagTime entwickeln, ist das normale Vorgehen:
Zunächst bauen Sie das Script in einem externen Editor auf. Das kann der Apple Skripteditor sein oder auch das Produkt eines anderen Herstellers wie der Script Debugger von Late Night Software. In unseren Abbildungen eines Editors wird durchweg der Script Debugger gezeigt.
Ist das Script fertig und soll in RagTime installiert werden, kopieren Sie den kompletten Scripttext aus Ihrem Editor. In RagTime legen Sie unter „Extras -> AppleScript -> Skripte verwalten“ ein neues Script an und setzten den Scripttext dort ein. Klicken Sie dann den Knopf „Aufheben“. In RagTime dauert vor allem bei längeren Scripten das Kompilieren und aufheben recht lange. Dieser Schritt sollte also zum Schluss erfolgen.
Umgekehrt können Sie auch den Text eines bestehenden Scripts aus RagTime kopieren und in einem anderen Script-Editor einsetzen. Dies Vorgehen ist sinnvoll, wenn Sie ein bestehendes Script überarbeiten wollen.
Beispielscripts in diesem Aufsatz sind vollständig gehalten, Sie können Sie also aus dem Browser in einen Script Editor kopieren und haben nach dem Kompilieren ihre bevorzugte Syntax-Färbung.
Der Name im RagTime-Scripteditor erscheint danach im RagTime-Menü, der Beschreibungstext wird als Hilfstext angezeigt, wenn die Maus über der Anweisung bleibt.
Grundlegendes
Versions-Hinweis: Beispiele für RagTime 6.5 und aktuelles OS X 10.5 angepasst. Dabei einige Änderungen insbesondere zum Objekt selection, die notwendig wurden. Bei der Gelegenheit hab ich noch Seiten zum Anlegen von Polygonen und Bézierkurven und zur Transformation von Zeichenobjekten ergänzt.
Juni 2009, Jürgen Schell
Das RagTime AppleScript-Verzeichnis
Bildzuschrift 1:
Verzeichnis der Objekte und Befehle
Die RagTime-Script-Dialoge
Bildzuschrift 1:
Der Dialog "Skripte verwalten"
Weshalb Scripte in RagTime installieren?
Texte
Texte auslesen
Beschreibung:
Textkomponenten heißen in RagTimes Scriptspache “text flows�. Ein text flow besteht aus paragraphs, words und characters.
Folgendes Script weist den Textinhalt einer ganzen Textkomponente einer Variable zu:
tell application "RagTime 6.5"
     tell document 1
          set derText to text flow 1 as text
     end tell
end tell
Beachten Sie dabei die Anweisung zur Typumwandlung, “as text�. Dies ist ungewöhnlich, aber ohne die Umwandlung wird der Text nicht korrekt zurück geliefert.
“as text� liefert liefert auch Text mit Zeichen aus anderen Schriftsystemen zurück, vgl. Abbildung.
Weitere typische Konstruktionen:
tell application "RagTime 6.5"
     tell text flow 1 of document 1
          set derText to paragraphs 2 thru 6 as text
     end tell
end tell
weist “derText� den Textinhalt der Absätze 2 bis 6 zu. Etwas aufpassen muss man bei Wörtern: Der Code
tell application "RagTime 6.5" -- Problembeispiel!!!
     tell text flow 1 of document 1
          set derText to words 2 thru 6 as text
     end tell
end tell
führt zu meist unerwünschten Resultaten. RagTime liefert die Wörter als Liste zurück und AppleScript verbindet deren Bestandteile zu einem Text. Das Ergebnis ist die Sequenz der Wörter, getrennt vom aktuellen text item delimiter von AppleScript, ohne Satzzeichen etc. Die korrekte Sequenz liefert:
tell application "RagTime 6.5"
     tell text flow 1 of document 1
          set derText to text from word 2 to word 6 as text
     end tell
end tell
Will man nur die Wörter, getrennt von Leerzeichen haben, kann man die erste Variante nehmen und den text item delimiter umsetzen:
tell application "RagTime 6.5" --Problembeispiel!!!
set AppleScript's text item delimiters to " "
tell text flow 1 of document 1
set derText to words 2 thru 3 as text
end tell
set AppleScript's text item delimiters to ""
end tell
(Man sollte den text item delimiter zum Schluss zurücksetzen, sonst kann es Nebenwirkungen auf andere Scripts geben.)
Texte erweitern
Beschreibung:
Texte werden am einfachsten mit “make new text� eingefügt:
tell application "RagTime 6.5"
     tell text flow 1 of document 1
          make new text at end with data " Schlusswort"
     end tell
end tell
Am Ende der Komponente wird “ Schlusswort� angehängt. Die Position kann mit den gängigen “at beginning�, “at end�, “at after� und “at before� erfolgen. Beispiele:
tell application "RagTime 6.5"
     tell text flow 1 of document 1
          make new text at after paragraph 2 with data "Dies ist ein zusätzlicher Absatz nach Absatz 2\r"
     end tell
end tell
Beachten Sie, dass nur am Ende des Textes ein Return steht, nicht am Anfang. “after paragraph� erzeugt immer einen neuen Absatz.
Eine Besonderheit von Texten ist, dass man oft dort etwas einfügen will, wo noch nichts steht. Soll heißen: Nicht Buchstabe 2 eines Absatzes soll auf xyz gesetzt werden, sondern zwischen Buchstabe 2 und 3 soll xyz eingefügt werden. In der von Apple normierten Text Suite ist das Hilfsmittel dafür der “insertion point�. Der folgender Code setzt am Anfang des zweiten Absatzes Text ein:
tell application "RagTime 6.5"
     tell text flow 1 of document 1
          set insertion point before paragraph 2 to "Dies ist ein neuer Anfangssatz für Absatz 2. "
     end tell
end tell
Statt “before paragraph 2� könnte auch “after paragraph 1� stehen. Der Effekt wäre derselbe. In dieser Notation können Sie das Ende eines Absatzes ansprechen in der Form:
...
set insertion point after character -2 of paragraph 2 to...
...
Achten Sie darauf, dass der insertion point mit after oder before, nicht aber mit at benutzt wird: Das Ziel ist nicht ein bestehendes Objekt.
Formeln in Text einsetzen
Bilder
Bilder laden
Die Bild-Skalierung
Beschreibung:
Unter den properties von Bildern befinden sich welche, die den guten RagTime-Kenner verblüffen werden: scaling, horizontal scaling und vertical scaling.
Ein Bild kann in einem Dokument mehrfach platziert sein und dabei in jedem der Container eine andere Skalierung haben. Skalierung ist genau genommen nicht die Eigenschaft eines Bildes sondern einer konkreten Installation des Bildes. Sehen wir uns zuerst an, was die Abfrage einer Skalierung liefert. In einem Dokument haben wir dafür zwei Bilder geladen. Das erste ist einmal platziert und auf 50% skaliert. Das zweite ist doppelt platziert, einmal mit 25%, einmal mit 75 % Skalierung. In das folgende Script sind die Antworten aus dem AppleEvent Log hineinkopiert:
tell application "RagTime 6.5"
     tell document 1
          get scaling factor of picture 1
          --> 0.5
          get scaling factor of picture 2
          --> {0.25, 0.75}
     end tell
end tell
Im Falle des einfach platzierten Bildes wird eine Zahl geliefert, im anderen eine Liste. Die Liste enthält alle vorkommenden Skalierungsfaktoren. Ist ein Bild mehrfach platziert aber immer mit derselben Skalierung, wird nur eine Zahl und keine Liste geliefert.
Mit set darf nur eine Zahl benutzt werden:
tell application "RagTime 6.5"
     tell document 1
          set scaling factor of picture 1 to 0.5
     end tell
end tell
Dieser Code setzt die Skalierung aller Installationen von Bild 1 auf 50%.
Wollen Sie bei mehrfach installierten Bildern mit der Skalierung einer bestimmten Installation arbeiten, führt der Weg über den contents des Containers.
Die Abfrage:
tell application "RagTime 6.5"
     tell page 1 of layout 1 of document 1
          scaling factor of contents of rectangle 2
     end tell
end tell
Die Form beim setzen:
tell application "RagTime 6.5"
     tell page 1 of layout 1 of document 1
          set scaling factor of contents of rectangle 2 to 0.3
     end tell
end tell
Die align picture Anweisung
Formatvorlagen
Beschreibung:
Formatvorlagen sind generell eine Zusammenfassung von Eigenschaften unter einem Namen, die dann Objekten insgesamt zugewiesen werden können. Eine Schriftvorlage umfasst z.B. die Schriftart, -größe, -farbe etc. Eine Absatzvorlage kennt Ränder, Zeilen- und Absatzabstände... Linienvorlagen kennen Linienstärken, -strichelungen, Arten von Linienenden...
Formatvorlagen sind Bestandteil eines Dokuments auf oberster Ebene. Bei der Arbeit stehen immer die Vorlagen aus zwei Dokumenten zur Verfügung: die des aktuellen Dokuments und die des RagTime-Hilfsmittel-Dokuments.
Weil neu angelegten Objekten in einem neuen Dokument immer bestimmte Standardvorlagen aus den Hilfsmitteln zugeordnet wird (solange der Anwender keine andere wählt), steckt in diesen Vorlagen auch ein großer Teil der RagTime-Voreinstellungen, beispielsweise, welche Schriftart ein neues Dokument voreingestellt bekommt.
Bei allen Unterschieden in den einzelnen Merkmalen werden Formatvorlagen sehr einheitlich bearbeitet.
tell application "RagTime 6.5"
     tell document 1
          make new character style sheet at end
     end tell
end tell
erzeugt eine neue Schriftvorlage mit dem Standardnamen (“Ohne Titel�), öffnet das Fenster zur Bearbeitung der Vorlagen und wählt sie aus.
Nicht geöffnet wird das Fenster, wenn die Vorlage zusammen mit ihren properties angelegt wird:
tell application "RagTime 6.5"
     tell document 1
          make new character style sheet with properties {name:"Vorlage 1", font:"Arial", size:10} at end
     end tell
end tell
Das Ergebnis ist eine Schriftvorlage namens “Vorlage 1� im Dokument, die 10 Punkt Arial benutzt.
Vorlagen-Hierarchien
Bildzuschrift 1:
Schriftvorlagen im Inventar nach Script-Lauf
Farb-Vorlagen
Beschreibung:
Es gibt im Dokument spezielle Vorlagen für Farben, die zu einem von drei Farbmodellen gehören, die RagTime kennt: RGB, CMYK und CIE Lab.
Grundsätzlich werden Farben wie folgt angelegt:
tell application "RagTime 6.5"
     tell document 1
          make new named color with properties ¬
               {name:"Lab-Rot", kind:process, color:{LabL:50, Laba:80, Labb:80}} at end
     end tell
end tell
Die Script-Bezeichnung für benannte Farben ist “named color�. Im record der properties ist ein Eintrag wiederum ein record: color. Für Lab- und RGB-Farben hat dieser record drei Einträge, für CMYK 4. Die benutzten Koordinaten im record bestimmen das Farbmodell. Beispiele für die drei Modelle:
color: {LabL:80, Laba:-50, Labb:-60}
color: {red:0.0, green:82.0, blue:100.0}
color: {cyan:55.0, magenta:0.0, yellow:6.0, black:0.0}
(Es ist in diesen records sinnlos, Koordinaten verschiedener Modelle zu mischen.)
Bei Lab liegen die Werte für Luminanz im Bereich 0 bis 100, die beiden Farbton-Koordinaten a und b liegen im Bereich von -127 bis +128.
Die Komponenten von RGB- und CMYK-Farben werden in Prozent angegeben, also im Wertebereich von je 0 bis 100.
Infografiken anlegen
Pipelines und Master Pipelines
Pipelines bearbeiten
Programmobjekte
Dokumente anlegen
Folgender Code legt ein neues RagTime-Dokument, beginnend mit einem Layout, an:
tell application "RagTime 6.5"
set neues_dokument to (make new document at end with properties {component types:layout})
end tell
Dasselbe funktioniert natürlich auch mit anderen Komponenten zum Start. Hier für ein Rechenblatt:
Bei Bedarf kann man das Dokument auch gleich benennen, obwohl es noch gar nicht gesichert ist:
Oder man sichert die Datei gleich nach dem Anlegen:
set save_file to (((path to documents folder) as text) & "Testdatei.rtd")
tell application "RagTime 6.5"
set neues_dokument to (make new document at end with properties {component types:layout})
save neues_dokument in file save_file
end tell
Fenster
Komponenten
Beschreibung:
Ein RagTime-Dokument ist ähnlich wie ein Dateisystem aufgebaut. Sollen bestimmte Objekte in einem Dokument verändert werden, muss deshalb zunächst die Komponente angesprochen werden.
Komponenten sind:
layout
master layout -- Stammlayout
text flow -- eine Textkomponente
table -- ein Rechenblatt
drawing -- eine Zeichnung
picture -- ein Bild
button -- ein Knopf
graph -- eine Infografik
Layouts und Stammlayouts sind dabei wieder aus ihren Seiten aufgebaut - technisch entprechen sie tatsächlich weitgehend einer Zeichnungskomponente.
Typische Code-Fragmente sind deshalb:
tell application “RagTime 6.5�
     tell document 1
          tell text flow “Text 1�
               -- hier der Code
          end tell
     end tell
end tell
oder aber:
tell application “RagTime 6.5�
     tell document 1
          tell layout 1
               tell page 2
                    -- hier der Code
               end tell
          end tell
     end tell
end tell
Wiederum können die Komponenten über ihren Namen oder den Index angesprochen werden. Der Index hängt mit der Reihenfolge zusammen, in der die Komponenten dem Dokument zugefügt oder aus ihn gelöscht werden. Solange Sie während des Script-Ablaufs keine Komponente löschen, bleibt deshalb ein Index konstant.
Erzeugt werden Komponenten mit “make�. Die make-Anweisung benötigt in fast allen Fällen eine Positionsangabe der Form “at beginning� oder “at end�, selbst, wenn technisch nur eines von beiden möglich ist (zu Ausnahmen der Abschnitt über fehlende Zielangaben).
tell application “RagTime 6.5�
     tell document 1
          make new table at end
     end tell
end tell
erzeugt ein neues Rechenblatt im Dokument. Es ist in keinem Container installiert. Sie sehen es nur im Inventar aufgelistet und können es von dort mit einem Doppelklick in einem eigenen Fenster öffnen.
Seiten können eine flexible Referenz im make haben:
tell application "RagTime 6.5"
     tell layout 1 of document 1
          make new page at after page 1
     end tell
end tell
Analog: “at end�, “at before page 1�.
selection
Ausführliche Beschreibung:
Das Programm und Fenster haben eine Vielzahl von Eigenschaften. Für die Navigation in einem Script ähnlich wichtig wie Fenster und Dokumente ist die “selection�.
Die selection des Programms ist das Objekt, dass der Benutzer im aktiven Fenster ausgewählt hat. Zugleich ist selection auch eine Eigenschaft von Fenstern. Damit können Sie zusätzlich auf die Auswahl in weiter hinten liegenden Fenstern zugreifen.
Auf die selection des Programms kann nur zugegriffen werden, wenn RagTime im Vordergrund ist.
tell application "RagTime 6.5"
     activate
     get selection
end tell
oder
tell application "RagTime 6.5"
     get selection of window 2
end tell
Beispiele für Antworten:
--> insertion point after character 5 of contents of text flow "Text 1" of document id 1 of application "RagTime 6.5"
--> rectangle 1 of page 1 of layout "Layout 1" of document id 1 of application "RagTime 5"
--> cell "A1" of table "Rechenblatt 1" of document id 1 of application "RagTime 6.5"
Wichtig: Die selection kann für des Programms und die Fenster angesprochen werden, nicht aber für Dokumente. Während
tell application "RagTime 6.5"
     tell window 1
          get selection
     end tell
end tell
ein korrekter Code ist, führt
tell application "RagTime 6.5" -- Fehlerbeispiel
     tell document 1
          get selection
     end tell
end tell
zu einer Fehlermeldung!
Beachten Sie weiter, dass das Resultat von selection eine vollständige Referenz ist. Folgender Code ist deshalb OK:
tell application "RagTime 6.5"
     tell window 1
          set Auswahl to selection
     end tell
     tell document 1
          -- hier weiterer Code
          delete Auswahl
          -- hier weiterer Code
     end tell
end tell
Tabellen
Bildzuschrift 1:
Die Tabelle nach Lauf des Scripts
Zelleingabe und automatische Typerkennung
Beschreibung:
Wird in eine RagTime-Zelle etwas getippt, erfolgt eine automatische Typerkennung. Ziffernsequenzen werden als Zahlen erkannt, Zeichenfolgen wie “15.2.2002� als Datum etc.
Wird, wie auf der vorangehenden Seite, ein Text mit “value of� an eine Zelle übergeben, erfolgt keine Typerkennung.
...
set value of cell "A2" to "15.2.2002" liefert einen Text in der Zelle ab.
Setzt man dagegen die Zelle ohne explizit die value-Eigenschaft zu benutzen, erfolgt die Typerkennung wie bei manueller Eingabe:
set cell “A2� to “15.2.2002�
erzeugt ein Datum. Beispiel:
tell application "RagTime 6.5"
     tell column 1 of table 1 of document 1
          set cell 1 to "15%"
          -- die Zelle A1 enthält die Zahl 0,15 mit der Formatierung Prozent
          set value of cell 2 to "15%"
          -- die Zelle A2 enthält den Text "15%"
     end tell
end tell
Der Weg über “value of� ist direkter und deshalb schneller. Werden in einer Schleife viele Werte gesetzt, sollte man deshalb value of cell benutzen, wenn man nicht ausdrücklich die Typerkennung haben will.
Ähnlich wie im grafischen User Interface kann die Typerkennung von Zellen auch abgeschaltet werden:
tell application "RagTime 6.5"
     tell table 1 of document 1
          set preset type of column 2 to single line text
     end tell
end tell
setzt die Spalte B der Tabelle auf einfachen Text. Zulässige Werte für "set preset type" sind:
auto
single line text
multi line text
Zellen, Wert und Formel
Vermischtes
Beschreibung:
path to me
Läuft ein Script innerhalb RagTimes, liefert path to me den Pfad zur RagTime-Programmdatei. Wenn Sie ein Script in der Entwurfsphase in einem Script Editor anlegen, ist das Resultat naturgemäß ein anderes. Das Verhalten des Scripts innerhalb von RagTime kann aber ohne Probleme bereits in der Entwurfsphase erzwungen werden: Machen Sie RagTime zum parent des Scripts. Irgendwo am Anfang muss folgende property-Deklaration stehen:
property parent : application "RagTime 6.5"
Alle Anweisungen werden dann zuerst an RagTime geschickt und erst später in der Hierarchie ggf. weitergeleitet.
Umgekehrt setzt folgendes Script auch innerhalb von RagTime an der Auswahl den Pfad zum Programm FileMaker ein (sofern die Auswahl Text annehmen kann):
property parent : application "FileMaker Pro"
tell application "RagTime 6.5"
set selection to (path to me as text)
end tell
(Hinweis: Im vorangehenden Beispiel ist das »tell application "RagTime 6.5"« auch dann unbedingt nötig, wenn da Script innerhalb von RagTime läuft. Die parent-Eigenschaft sorgt sonst dafür, dass die selection-Abfrage an FileMaker geschickt wird!)
Die Lebesdauer von properties
Scripts werden innerhalb von RagTime nach bloßem Ablauf nicht neu in das Dokument oder die Hilfsmittel zurück geschrieben. Wird während eines Script-Ablaufs eine property geändert und das Script später neu aufgerufen, überlebt deshalb die Änderung nur so lange, wie sich das Script im Hauptspeicher befindet. Für ein Script im Dokument bedeutet das: Eine property überlebt, bis Sie das Dokument schließen. Für ein Script in den Hilfsmitteln bedeutet das: Die property überlebt, bis Sie RagTime beenden. Ein Beispielscript:
property Eigenschaft : 1
display dialog "Die Eigenschaft beträgt " & Eigenschaft as text buttons {"OK"} default button 1
set Eigenschaft to Eigenschaft + 1
Ist dieses Script in einem Dokument gesichert, zeigt der Dialog beim ersten Aufruf nach Öffnen des Dokuments immer 1, beim nächsten Aufruf 2 etc. Wird das Dokument geschlossen und wieder geöffnet, beträgt der Wert wieder 1.
Ist das Script in den Hilfsmitteln gesichert, zeigt der Dialog beim ersten Aufruf nach Programmstart eine 1. Mit jedem Aufruf wird um 1 hoch gezählt, bis Sie RagTime beenden.
Zeichnungen und Seiten
Beschreibung:
Zeichnungen und Seiten sind aus drawing objects aufgebaut. Sie umfassen gezeichnete Objekte wie Rechtecke und Kurven sowie grafische Texte.
Die Objekte werden über ihren Index oder - sofern sie haben - über ihren Namen angesprochen. Der Name kann vom Anwender über die Palette Objektkoordinaten vergeben werden, oder das Script legt sie mit einem Namen an.
Der Index zählt in der Zeichnung von vorn nach hinten: Das am weitesten vorn liegende Zeichnungsobjekt hat den Index 1, das nächste 2 usw.
drawing objects haben für die Varianten Unterklassen:
rectangle -- Rechteck
graphic line -- Linie
graphic text -- Graphischer Text
arc -- Bogen
oval
sector
polygon
Bezier curve
multigon -- Vieleck
Wird das Objekt über die Unterklasse angesprochen, kann der Index niedriger sein. polygon 1 kann drawing object 5 sein. Es ist das am weitesten vorn liegende Polygon.
tell application "RagTime 6.5"
     tell document 1
          delete rectangle 1 of page 1 of layout 1
     end tell
end tell
löscht das am weitesten vorn liegende Rechteck der Seite 1 von Layout 1, selbst, wenn davor noch ein Oval liegt. “delete drawing object 1� dagegen löscht das am weitesten vorn liegende Objekt, gleich, ob ein Rechteck, ein grafischer Text etc. (Um das am weitesten hinten liegende Objekt zu löschen, benutzen Sie den Index -1: delete rectangle -1 of page 1 of layout 1
Erzeugt werden Zeichnungsobjekte mit make. Dabei muss die hinten/vorn-Position mit z.B. “at end� oder “at beginning� angegeben werden.
tell application "RagTime 6.5"
     tell document 1
          make new rectangle at beginning of page 1 of layout 1
     end tell
end tell
legt ein Rechteck auf Seite 1 des Layouts 1 an, das VOR allen anderen Objekten liegt. Soll es hinten liegen, benutzt man “at end�.
Wie bei Seiten kann auch “at before� und “at after� benutzt werden:
tell application "RagTime 6.5"
     tell page 1 of layout 1 of document 1
          make new rectangle at after drawing object 1 with data {100, 100, 200, 300}
     end tell
end tell
erzeugt ein Rechteck in der zweiten Ebene von vorn und legt die Position auf der Seite gemessen in Punkt fest.
Bézierkurve: Beispiel Tropfen
Beschreibung:
Zuerst wird mitten auf einer Seite ein Kreis gezeichnet und mit »Zeichnung – Objektart – Bézier-Kurve« umgewandelt. Dann werden die Punkte mit dem Testscript abgefragt. In meinem Fall ist das Ergebnis die Liste
{{158.7401, 409.6062}, {158.7401, 336.809}, {217.7539, 277.7952}, {290.5511, 277.7952}, {363.3483, 277.7952}, {422.3621, 336.809}, {422.3621, 409.6062}, {422.3621, 482.4034}, {363.3483, 541.4172}, {290.5511, 541.4172}, {217.7539, 541.4172}, {158.7401, 482.4034}, {158.7401, 409.6062}}
RagTime legt die Punkte bei dem Kreis beginnend bei 9 Uhr im Uhrzeigersinn an. Hervorgehoben hab ich die Punkte 3 bis 5. Sie werden etwas umgestaltet für die Tropfenform.
Folgendes Script wird nun für die Zeichnung benutzt:
set punkteListe to {{158.7401, 409.6062}, {158.7401, 336.809}, {217.7539 + 50, 277.7952}, {290.5511, 277.7952 - 150}, {363.3483 - 50, 277.7952}, {422.3621, 336.809}, {422.3621, 409.6062}, {422.3621, 482.4034}, {363.3483, 541.4172}, {290.5511, 541.4172}, {217.7539, 541.4172}, {158.7401, 482.4034}, {158.7401, 409.6062}}
tell application "RagTime 6.5"
     set neuesDokument to (make new document with properties {component types:drawing} at end)
     tell drawing 1 of neuesDokument
          set dasPolygon to (make new Bezier curve at beginning with data punkteListe with properties {color:{red:10, green:60, blue:60}})
         Â
     end tell
end tell
Hervorgehoben sind wieder die Punkte mit den Änderungen. Das Resultat ist ein garantiert symmetrischer Tropfen.
Bildzuschrift 1:
Der in RagTime gezeichnete Kreis, in eine Bézierkurve gewandelt
Bildzuschrift 2:
Das Ergebnis des Scripts, das in der Punktliste drei Koordinaten ändert
Gruppieren von Objekten
Koordinaten von Zeichnungsobjekten
Beschreibung:
Alle Koordinatenangaben sind in Punkt (1/72 Zoll) gemessen von der oberen linken Ecke. Vertikale Koordinaten werden nach unten größer, horizontale nach rechts.
Beim Anlegen eines Rechtecks ist es naheliegend, die Koordinaten gleich als dessen Daten zu übergeben:
tell application "RagTime 6.5"
     tell layout 1 of document 1
          make new rectangle at beginning of page 1 with data {100, 100, 300, 200}
     end tell
end tell
Die Reihenfolge der Koordinaten ist: {X links, Y oben, X rechts, Y unten}
Bei den Koordinaten ist im AppleScript-Verzeichnis der Unterschied zwischen definition rect und bounds wichtig (sowie auf den ersten Blick vielleicht etwas unklar):
In RagTime können Zeichnungsobjekte transformiert werden: gedreht, skaliert, geschert.
Das definition rect gibt die Koordinaten an, die vor dieser Transformation galten. (Wenn Sie in der Palette Objektkoordinaten auf “Standard� klicken, bekommt das Objekt wieder die Grenzen des definition rect.) bounds hingegen gibt die Koordinaten an, mit denen das transformierte Objekt auf der Seite / der Zeichnung sichtbar ist. (Dies entspricht im User Interface von RagTime in der Palette "Objektkoordinaten" der Teilung in die Koordinaten, die oben in der Gruppe unter "Name" stehen, und die Koordinaten, die in der nächsten Gruppe für die Ränder stehen. Drehen Sie in RagTime ein Rechteck auf z.B. 45°, um den Unterschied zu sehen.)
Analog: left und left position. die zweite Form gibt den Wert des transformierten Objekts.
Beispiel (die Antworten von RagTime sind mit “-->� eingetragen. Sie wurden aus dem AppleEvent Log des Script Editors kopiert.):
tell application "RagTime 6.5"
     tell page 1 of layout 1 of document 1
          make new rectangle at beginning with data {200, 250, 300, 400}
               tell rectangle 1
               set vertical scaling factor to 2.5
               set horizontal scaling factor to 2.5
               get definition rect
               --> {200.0, 250.0, 300.0, 400.0}
               get bounds
               --> {125.0, 137.5, 375.0, 512.5}
               get left
               --> 200.0
               get left position
               --> 125.0
          end tell
     end tell
end tell
Die Koordinaten von bounds umfassen einen größeren Bereich und left position liegt weiter links, weil die Skalierung von 250% berücksichtigt wird.
Polygone und Bézierkurven
Beschreibung:
Polygone und Bézierkurven werden in RagTime als Listen von Punkten angelegt. Jeder Punkt ist dabei wieder eine Liste. Beispiel:
-- Script 1
set punkteListe to {{50, 50}, {100, 200}, {150, 50}, {50, 50}}
tell application "RagTime 6.5"
     set neuesDokument to (make new document with properties {component types:drawing} at end)
     tell drawing 1 of neuesDokument
          make new polygon at beginning with data punkteListe with properties {color:{red:10, green:60, blue:60}}
     end tell
end tell
Das Script legt ein neues Dokument – bestehend aus einer Zeichnung – an und zeichnet ein Dreieck. Die Liste {{50, 50}, {100, 200}, {150, 50}, {50, 50}} ist die Liste der Eckpunkte des Polygons. Jeder Punkt ist wieder eine Liste von zwei Koordinaten, X und Y. Y wird dabei von oben nach unten gemessen. Die Maßeineit sind Punkt (also 1/72 Zoll). Wie bei der Eigenschaft definition rect handelt es sich um die Koordinaten ohne irgendwelche Transformationen wie Drehung. Dies wird Deutlich im folgenden Script:
-- Script 2
set punkteListe to {{50, 50}, {100, 200}, {150, 50}, {50, 50}}
tell application "RagTime 6.5"
     set neuesDokument to (make new document with properties {component types:drawing} at end)
     tell drawing 1 of neuesDokument
          set dasPolygon to (make new polygon at beginning with data {{0, 0}, {1, 1}} with properties {color:{red:10, green:60, blue:60}})
          set rotation of dasPolygon to 0.25
          change point list of dasPolygon to punkteListe
     end tell
end tell
Hier wird zunächst ein Polygon mit nur zwei Punkten angelegt und anschließend rotiert. Dann wird die Punktliste auf denselben Wert gesetzt, wie im Script 1. Das Resultat ist ein Dreieck, dessen Spitze nach links zeigt: Die Dreihung wird weiterhin auf die Koordinaten angewandt.
Sehen wir uns eine Bézierkurve an. Zuerst wird von Hand eine in RagTime gezeichnet, wie abgebildet. Während sie ausgewält ist, wird die Punktliste mit einem Script abgefragt:
tell application "RagTime 6.5"
     try
          get point list of selection of window 1
     end try
end tell
(In der Praxis ist dieses simple Testscript sehr hilfreich. In vielen Fällen ist es am einfachsten, zunächst eine ungefähre Kurve von Hand anzulegen und deren Werte abzufragen, um die Größenordnung der realistischen Werte zu bekommen.)
Das Script liefert in meinem Fall folgende Liste als Resultat:
{{34.7244, 141.0236}, {64.4882, 87.1653}, {138.8976, 95.6693}, {182.1259, 136.063}, {225.3543, 176.4566}, {287.7165, 177.1653}, {318.1889, 155.1968}}
Das sind sieben Koordinatenpaare für Punkte. Sehen wir uns die Kurve noch einmal mit ausgewählten Punkten an (Abbildung unten):
Es gibt drei Punkte auf der Kurve und vier Endpunkte von den »Anfassern«. Jede Bézierkurve in RagTime (und in anderen Programmen) ist zusammengesetzt aus einer Reihe von Segmenten, die je von vier Punkten definiert sind. Der letzte Punkt eines Segments ist immer der erste des folgenden. So eine Bézierkurve als ganzes ist also immer durch Anzahl_Segmente * 3 + 1 Punkte definiert.
Bildzuschrift 1:
Das Ergebnis von Script 1
Bildzuschrift 2:
Das Ergebnis von Script 2
Bildzuschrift 3:
Die Bézier-Beispielkurve mit ausgewählten Punkten (damit die "Anfasser" sichtbar sind)
Transformationen von Grafikobjekten
Beschreibung:
Alle Transformationen in RagTime wirken auf das Zeichnungsobjekt einschließlich seiner Linienstärken und ggf. auch auf die Darstellung seines Inhalts. Schreibt man in einem gespiegelten Rahmen, erscheint auch der Text spiegelverkehrt. Ebenso erscheint Text in einem gescherten Rahmen selbst geschert.
Skalieren eines Objekts:
tell application "RagTime 6.5"
     tell page 1 of layout 1 of document 1
          set Rechteck to (make new rectangle at beginning with data {200, 250, 300, 400})
          set vertical scaling of Rechteck to 3
          set horizontal scaling of Rechteck to 3
     end tell
end tell
Vertikale und horizontale Skalierung werden einzeln gesetzt. Die Zahl ist einfach der Faktor der Skalierung. Ein Skalierungsfaktor -1 spiegelt das Objekt.
Rotieren eines Objekts:
tell application "RagTime 6.5"
     tell page 1 of layout 1 of document 1
          set Rechteck to (make new rectangle at beginning with data {200, 250, 300, 400})
          set rotation of Rechteck to 45 / 360
     end tell
end tell
Das Script legt ein Rechteck an und dreht es um 45° im Uhrzeigersinn. Beachten Sie den Ausdruck »45 / 360«. RagTime behandelt 1 als vollständige 360°-Drehung. 0.5 dreht also um 180°, 0.25 um 90° usw.
Scheren eines Objekts
tell application "RagTime 6.5"
     tell page 1 of layout 1 of document 1
          set X to 15 / 360
          set Rechteck to (make new rectangle at beginning with data {200, 250, 300, 400})
          set horizontal skewing of Rechteck to X
     end tell
end tell
Das Script legt ein Rechteck an und schert es um 15°. Die maximale Scherung, die RagTime akzeptiert ist ± 63,4° (± 0,1762). Wieder sind 360° auf 1 normiert, deshalb der Ausdruck »15 / 360«.
Lassen Sie sich nicht davon verwirren, dass nach den Setzen einer Transformation die anschließende Abfrage bisweilen etwas anderes liefert. Die Transformation eines Objekts ist letztlich eine 2*2 Matrix. Und mehrere Einzeloperationen führen zur selben Matrix. Wenn RagTime dann wieder rückwärts rechnet, können die Einzeltransformationen anders aussehen:
tell application "RagTime 6.5"
     tell page 1 of layout 1 of document 1
          set X to 30 / 360
          set Rechteck to (make new rectangle at beginning with data {200, 250, 300, 400})
          set vertical skewing of Rechteck to X
         Â
          vertical skewing of Rechteck
          --> 0.0
          horizontal skewing of Rechteck
          --> 0.0833
          vertical scaling of Rechteck
          --> 0.866
          horizontal scaling of Rechteck
          --> 1.1547
          rotation of Rechteck
          --> 0.0833
          transformation matrix of Rechteck
          --> {1.0, 0.5773, 0.0, 1.0}
     end tell
end tell
Das Rechteck wird ursprünglich um 30° vertikal geschert. Fragt man anschließend die Eigenschaften ab, ist die vertikale Skalierung zu 0 geworden, alle anderen Eigenschaften sind allerdings anders. Die Kombination von Scherung, Skalierung und Drehung, die das Script zurück meldet, ist tatsächlich äquivalent zu einer 30° vertikalen Scherung. Die Matrix wird im Script im letzten Schritt abgefragt. Sollen mehrere Objekte mit gleichen Transformationen erzeugt werden, ist es oft am einfachsten, ein Objekt mit den vertrauten Techniken (drehen, skalieren) anzulegen, dann dessen Matrix abzufragen und anschließend die weiteren Objekte mit dieser Matrix zu erzeugen.
Sollen Objekte gleich mit einer Transformation erzeugt werden (schneller, weniger Bildschirm-Updates), sieht die Syntax wie folgt aus:
tell application "RagTime 6.5"
     tell page 1 of layout 1 of document 1
          set X to {1.0, 0.5773, 0.0, 1.0}
          set Rechteck to (make new rectangle at beginning with data {200, 250, 300, 400} with properties {transformation matrix:X})
     end tell
end tell
Zeichnungsobjekte und Komponenten
Im- und Export
Exportieren
Importieren mit change
Beschreibung:
Die Import-Optionen, z.B. welche Textkodierung benutzt werden soll, kann man steuern, wenn man zuerst die Komponente anlegt und dann mit change auf den Inhalt der Importdatei setzt:
set textDatei to choose file with prompt "Text-Datei auswählen"
tell application "RagTime 6.5"
     tell document 1
          set Textkomponente to (make new text flow at end)
          change Textkomponente to textDatei using encoding 256 without link to file
-- Encoding 256 ist Mac Roman
          set Rechenblattkomponente to (make new table at end)
          change cell "A1" of Rechenblattkomponente to textDatei using encoding 256 without link to file, value format detection and import formats
     end tell
end tell
Das Script erzeugt eine neue Textkomponente und setzt dann den Inhalt auf textDatei, gibt aber dabei bereits das Encoding vor. Die für die meisten Anwender wohl wichtigsten Encodings sind:
256: Macintosh Standard für westeuropäische Sprachen
512: Windows Standard für westeuropäische Sprachen
Encoding-Nummern finden Sie in der RagTime-Hilfe "RagTime-Formeln und -Funktionen" im Abschnitt "Hintergrundinformationen".
Es wird ein Rechenblatt angelegt und die Zelle A1 auf die Datei geändert. Da value format detection und import formats beide festgelegt sind (hier: ausgeschaltet), folgt auch dieser Dialog nicht.
Die so importierten Komponenten können mit set (“set rectangle 1 of page 1 to...�) platziert werden.
Für den Import können auch Filter festgelegt werden, besonders bei Bildern bisweilen wichtig:
...convert with "JPEG" ...
Ein Beispielscript:
set bildDatei to choose file with prompt "Bild-Datei auswählen" of type list {"JPEG"}
tell application "RagTime 6.5"
     tell document 1
          set Bildkomponente to (make new picture at end)
          change Bildkomponente to bildDatei ¬
               convert with "JPEG" without link to file
     end tell
end tell
Importieren mit make und set
Scripts interaktiv
Arbeiten mit der Benutzerauswahl
Direkte und indirekte Benutzung von selection
Fehlende Ziel-Angabe
Beschreibung:
Änderungen in AppleScript haben leider dazu geführt, dass sich das sogenannte "Default Targeting" unterschiedlich verhält, abhängig davon, ob das Script im Programm selbst läuft oder aber es von außen (Script Editor) steuert. Mit "Default Targeting" ist gemeint, welches Ziel in einem Programm benutzt wird, wenn eine klare Zielangabe fehlt. In vielen Fällen wird dann die bestehende Auswahl ausgewertet. Die für das Programm gültige Auswahl steht aber nicht mehr zur Verfügung, wenn RagTime im Hintergrund ist.
Gehen wir von folgender Situationsannahme aus:
In RagTime ist ein Dokument mit mehreren Seiten geöffnet. Auf einer der Seiten ist ein Grafik-Objekt angeklickt, oder aber, es wurde zuletzt in den leeren Seitenbereich geklickt.
In RagTime 6.5 funktioniert dann folgendes Script:
make new rectangle with data {100, 100, 200, 300}
(Das »tell application "RagTime 6.5"« kann innerhalb von dem RagTime-Script-Editor natürlich fehlen. Das Script ist so vollständig.)
Ohne irgend eine Angabe, wo in einem Dokument dieses Rechteck angelegt werden soll, bestimmt die aktuelle Auswahl das Ziel. Das Rechteck wird auf der Zeichenfläche angelegt, die (oder in der) gerade die aktuelle Auswahl steht. Das ist zum Beispiel die Seite oder Zeichnung, in deren leeren Bereich zuletzt geklickt wurde. Oder aber die Seite / Zeichnung, in der gerade ein beliebiges Grafikobjekt ausgewählt ist.
Vom AppleScript Editor aus funktioniert diese Technik nur, wenn RagTime zuerst in den Vordergrund geholt wird:
tell application "RagTime 6.5"
     activate
     make new rectangle with data {100, 100, 200, 300}
end tell
Lässt man das »activate« weg, führt das Script in eine Fehlermeldung.
Um diese Technik noch etwas weiter zu illustrieren: Folgendes Script zieht Hilfslinien genau durch den Mittelpunkt des ausgewählten Objekts:
tell application "RagTime 6.5"
     activate
     set {X, Y} to position of selection
     make new vertical guide with data X
     make new horizontal guide with data Y
end tell
(Wiederum würde innerhalb von RagTime folgendes Script dasselbe tun:
set {X, Y} to position of selection
make new vertical guide with data X
make new horizontal guide with data Y
)
Im ersten Schritt wird die Position des Auswahl-Objekts ausgelesen. Da die Anweisung an RagTime geht (und nicht etwa an window 2 u.ä.) ist dies immer die Auswahl im aktuellen Dokument.
Die beiden folgenden Anweisungen legen Hilfslinien in der gerade benutzten Zeichnungsumgebung an. Das ist immer die Umgebung, in der das Objekt gerade ausgewählt ist.
Kriterium dafür, dass die Zielangabe fehlt, ist die fehlende “at�-Klausel. Selbst, wenn der “make new...�-Ausdruck in einem tell-Block steht, wird er als “Ohne Zielangabe� behandelt, wenn das “at� fehlt. Folgende Beispiele
tell application "RagTime 6.5" -- Fehlerbeispiel
     activate
     make new rectangle with data {100, 100, 200, 300} at beginning
end tell
Das Script führt bei Ausführung in eine Fehlermeldung. Wenn die “at�-Klausel vorhanden ist, muss das Ziel vollständig gegeben sein.
Für das nächste Beispiel wieder eine Situationsannahme: Sie haben ein Layout mit drei Seiten vor sich und ein Objekt auf Seite 3 angeglickt:
tell application "RagTime 6.5"
     tell page 1 of layout 1 of document 1
          activate
          make new rectangle with data {100, 100, 200, 200}
          make new rectangle with data {100, 100, 350, 350} at beginning
     end tell
end tell
Bei dem ersten (kleineren) Rechteck fehlt die “at�-Klausel. Die Anweisung geht an die aktuelle Zeichnungsumgebung und das Rechteck erscheint auf der angeklickten Seite 3 trotz des umgebenden “tell�.
Das zweite Rechteck hat eine “at�-Klausel und der umgebende tell-Block gibt das Ziel vollständig an. Das Rechteck wird auf Seite 1 erzeugt.
Selbst, wenn in dem “tell� ein “of document 2� stünde, würde das erste Rechteck in Dokument 1 angelegt werden, das zweite aber in Dokument 2. Deutlich sieht man den Unterschied, wenn man sich im AppleEvent Log ansieht, wie die Kommunikation mit RagTime abläuft:
tell application "RagTime 6.5" -- Ausschnitt aus AppleEvent Log
     activate page 1 of layout 1 of document 1
     make new rectangle with data {100, 100, 200, 200}
     --> rectangle 1 of page 3 of layout "Layout 1" of document id 1
     make new rectangle with data {100, 100, 350, 350} at beginning of page 1 of layout 1 of document 1
     --> rectangle 1 of page 1 of layout "Layout 1" of document id 1
end tell
Notwendige if und try beim Arbeiten mit selection
Beschreibung:
Arbeitet man mit dem selection-Objekt, kann es leicht zu allen möglichen Fehlern im Ablauf des Scripts kommen: Die aktuelle Auswahl des Benutzers ist evtl. gar nicht geeignet für die Aktionen des Scripts. Zwei Techniken bieten sich an: Wenn das Script nur für eine ganz bestimmte Art von Objekten geeignet ist, fragt man zunächst die Klasse der Auswahl ab und arbeitet nur im geeigneten Fall weiter. Wird mit einer Eigenschaft gearbeitet, die viele unterschiedliche Objekte haben können (position ist ein Beispiel), und ist das Script für (fast) alle dieser Objekte geeignet, ist ein try nützlicher.
Ein Beispieldokument enthalte ein Rechenblatt namens “Rechenblatt 1�. Wenn der Benutzer Text ausgewählt hat, soll dieses Rechenblatt am Anfang der Auswahl eigefügt werden.
tell application "RagTime 6.5"
     set textAuswahl to selection of window 1
     set Tabelle to a reference to table "Rechenblatt 1" of document 1
     if (class of selection of window 1) is text then
          set insertion point before textAuswahl to Tabelle
     end if
end tell
Ist irgend etwas anderes als Text ausgewählt, wird der if-Teil nicht ausgeführt. Dennoch sollte man auch in diesem Fall ein try erwägen. Es gibt immer Fälle, in denen das Script Fehlermeldungen auslöst und die man vergisst. Hier wären folgende Fälle betroffen: Die Einfügemarke steht in einem leeren Text, im Rechenblatt in einem Mehrzeilertext oder in einem grafischen Text.
Ein vorangehendes Beispiel hat Hilfslinien durch ein ausgewähltes Objekt gezeichnet. Dies ist ein typisches Beispiel für den Einsatz von try: Die Eigenschaft position haben Rechtecke, Beziérkurven, Punkte von Beziérkurven... In allen Fällen ist die folgende Anweisung, Hilfslinien durch die Position der Auswahl zu zeichnen, sinnvoll. Ist aber Text oder eine Rechenblattzelle ausgewählt, ist das Script nicht sinnvoll und führt in einen Fehler. Hier ist try die beste Technik:
tell application "RagTime 6.5"
     try
          set {X, Y} to position of selection of window 1
          activate
          make new vertical guide with data X
          make new horizontal guide with data Y
     end try
end tell
Wenn das ausgewählte Objekt die property position gar nicht hat oder aber in der benutzten Umgebung keine Hilfslinien möglich sind (z.B. ein Objekt einer Infografik ist ausgewählt), bricht die Ausführung einfach ab ohne durch eine unverständliche Fehlermeldung zu irritieren. In allen Fällen, in denen aber sinnvoll die Hilfslinien gezeichnet werden können, wird die Anweisung ausgeführt. Hält man eine Warnung für sinnvoll, kann man natürlich eine eigene Meldung erzeugen: Folgende Variante erzeugt eine eigene Meldung, gefolgt von der Originalmeldung:
property Fehlertext1 : "Es konnten keine Hilfslinien angelegt werden. Vermutlich ist kein geeignetes Objekt ausgewählt."
property Fehlertext2 : "AppleScript-Fehler: Nummer "
tell application "RagTime 6.5"
     try
          set {X, Y} to position of selection of window 1
          activate
          make new vertical guide with data X
          make new horizontal guide with data Y
     on error Meldung number Fehlernummer
          display dialog Fehlertext1 & return & return & Fehlertext2 & ¬
               Fehlernummer & ", " & Meldung buttons {"OK"} default button 1
     end try
end tell
Zum Abschluss noch eine Variante, die eher traditionellem “exception handling� entspricht: Statt einer eigenen Meldung wird die normale AppleScript-Meldung hochgereicht, aber ergänzt um die eigene Information:
property Fehlertext : "Vermutlich können durch das ausgewählte Objekt keine Hilfslinien gezogen werden."
tell application "RagTime 6.5"
     try
          set {X, Y} to position of selection of window 1
          activate
          make new vertical guide with data X
          make new horizontal guide with data Y
     on error Meldung number Fehlernummer
          error Meldung & return & Fehlertext number Fehlernummer
     end try
end tell
Wenn Aktionen Auswahl oder Bezug ändern
Beschreibung:
Beim Arbeiten mit Variablen, denen das selection-Objekt zugewiesen wurde, kann auch die Änderung der Auswahl durch eine Script-Aktion oder aber die Änderung ihres Bezugs eine Falle stellen.
Folgende Script-Varianten gehen davon aus, dass ein Rechteck ausgewählt ist.
Variante 1
tell application "RagTime 6.5"
     set Auswahl to selection of window 1
     make new rectangle at before Auswahl with data {50, 100, 150, 300}
     set color of Auswahl to {cyan:10, magenta:50, yellow:80, black:5}
end tell
Variante 2
tell application "RagTime 6.5"
     set Auswahl to selection of window 1
     make new rectangle at before Auswahl with data {50, 100, 150, 300}
     set color of selection of window 1 to {cyan:10, magenta:50, yellow:80, black:5}
end tell
In Variante 1 wird das neu angelegte Rechteck orange gefärbt, in Variante 2 das ausgewählte. Grund: Die Variable Auswahl enthält eine Referenz auf das Rechteck nach Index. Dadurch, das vor dem ausgewählten Rechteck ein neues angelegt wurde, hat dieses neue Rechteck den Index, den vorher das ausgewählte hatte. “Auswahl� zeigt deshalb jetzt auf das neue Rechteck.
Besonders bei Texten kann sich die Auswahl von Buchstaben durch Hinzufügen oder Löschen ändern. Ein Beispielscript soll vor und nach der Auswahl einen Bindestrich einfügen.
tell application "RagTime 6.5"-- Unerwartetes Resultat
     set Auswahl to selection of window 1
     set insertion point before Auswahl to "-"
     set insertion point after Auswahl to "-"
end tell
Durch das Einfügen des ersten Bindestrichs hat sich die Anzahl der Buchstaben verändert. Der zweite wird deshalb einen Buchstaben zu früh eingefügt.
In einen Fehler läuft auch die naheliegende Idee, direkt auf selection zu arbeiten:
tell application "RagTime 6.5"-- Fehlerhaftes Beispiel
     set insertion point before selection of window 1 to "-"
     set insertion point after selection of window 1 to "-"
end tell
Einer der Fälle, in denen sich der direkte und der indirekte Zugriff auf die Auswahl unterscheiden.
Eine Lösungsmöglichkeit ist, in der ersten Variante die Auswahl erneut abzufragen:
tell application "RagTime 6.5"
     set Auswahl to selection of window 1
     set insertion point before Auswahl to "-"
     set Auswahl to selection of window 1
     set insertion point after Auswahl to "-"
end tell
In Fällen wie diesem, in dem die Aktion die Anzahl der Buchstaben auf jeden Fall vergrößert, kann man natürlich auch einfach die Reihenfolge beim Einsetzen ändern und von hinten nach vorn arbeiten:
tell application "RagTime 6.5"
     set Auswahl to selection of window 1
     set insertion point after Auswahl to "-"
     set insertion point before Auswahl to "-"
end tell
Arbeiten mit dem Auswahl-Objekt
Beschreibung:
Wie in dem einführenden Teil zu Programmobjekten beschrieben, kann man in RagTime und unterhalb von RagTime über Fenster das Objekt selection ansprechen. In Dokumenten kann man das Objekt selection nicht ansprechen.
Seit einiger Zeit ist allerdings die für das Programm gültige Auswahl nur im Script-Zugriff, wenn RagTime im Vordergrund ist. Lässt man ein Script in RagTime laufen, ist das immer der Fall. Nicht aber, wenn man den Apple Script Editor im Vordergrund hat und das Script von dort aus laufen lässt.
tell application "RagTime 6.5" -- Problembeispiel
     set A to selection
end tell
führt zu einer Fehlermeldung. Hingegen funktioniert folgende Variante korrekt:
tell application "RagTime 6.5"
     activate
     set A to selection
end tell
Wird explizit ein Fenster angesprochen, kann das activate fehlen:
tell application "RagTime 6.5"
     set A to selection of window 1
end tell
führt zu keinem Fehler. Folgendes Script eignet sich zum Experimentieren, wenn man sich im Script Editor anschließend das Resultat ansieht:
tell application "RagTime 6.5"
     activate
     set A to selection
     set B to selection of window 1
     set C to selection of window 2
     {A, B, C}
end tell
Nehmen wir folgende Situation an: Zwei Dokumente sind geöffnet, im hinteren ist etwas Text ausgewählt, im forderen ein Rechteck auf einer Seite. Dann wird das Resultat dieses Scripts etwa wie folgt aussehen:
{
rectangle 1 of page 1 of layout "Layout 1" of document id 2 of application "RagTime 6.5",
rectangle 1 of page 1 of layout "Layout 1" of document id 2 of application "RagTime 6.5",
text from character 1 to character 10 of contents of text flow "Text 1" of document id 1 of application "RagTime 6.5"
}
Die ersten beiden Abfragen, selection und selection of window 1, liefern dasselbe Resultat, die Auswahl im ersten Dokument. Die Variable C enthält die Auswahl im zweiten Dokument.
Wird nun im forderen Dokument das Fenster Schriftvorlagen geöffnet und “Standardschrift� in der Liste ausgewählt, liefert das Script folgendes Resultat:
{
character style sheet "Standardschrift" of document id 2 of application "RagTime 6.5",
character style sheet "Standardschrift" of document id 2 of application "RagTime 6.5",
rectangle 1 of page 1 of layout "Layout 1" of document id 2 of application "RagTime 6.5"
}
In dieser Variante gehören die beiden ersten Fenster zu Dokument 1: Das Schriftvorlagen-Fenster und das Layout-Fenster. Variable A und B enthalten wieder dasselbe. Die selection von RagTime ist immer gleich der selection des ersten Fensters von RagTime. C enthält jetzt die Auswahl in dem Layout-Fenster von Dokument 1.
Ausgewählte Objekte gruppieren
Des brochures avec RagTime: Utiliser les pages maquettes
[:node/2996|Deutsche Version]
Cet article vous montre les bases pour créer des brochures et des magazines en utilisant les pages-maquettes. Ce sujet est une version Web d'un article écrit pour le service RagTime InfoMail.
Introduction
Zu Bild 1:
L'image montre une maquette très simple concernant une brochure avec une page de titre. Les flèches indiquent le déroulement, re
Zu Bild 2:
L'image montre trois contenants, décalés verticalement. L'effet de la ligne de base : toutes les bases de lignes sont alignées,
RagTime Everywhere benutzen
Anmeldung bei RagTime Everywhere
Ausführliche Beschreibung:
Hier beschreiben wir kurz, wie man sich bei dem Service anmeldet und ihn nutzt.
Einrichten des Zugangs
Für die Anmeldung benötigen Sie die Liefernummer ihres RagTime-Pakets, die Sie auch schon für die Autorisierung brauchten. Sie steht auf einem Aufkleber auf Ihrem RagTime-Paket, beginnt mit »L« und hat zwölf Ziffern.
Öffnen Sie die Web-Seite
http://www.ragtime.de/web/support/everywhere-autorisieren.html
(In der Navigation von www.ragtime.de finden Sie die Seite unter »Support - RagTime autorisieren.)
Klicken Sie auf »Hier gehts zur Registrierung«.
Geben Sie auf der folgenden Seite Ihre RagTime-Liefernummer ein und klicken Sie »Weiter«. Sie müssen noch die AGB bestätigen, können prüfen, ob Ihre E-Mail-Adresse richtig ist, und dann ist die Anmeldung auch schon fertig.
Nach fünf bis zehn Minuten erhalten Sie per E-Mail Ihre Zugangsdaten: Eine Benutzerkennung und ein Kennwort. Wichtig: Ändern Sie Ihr Kennwort bei der ersten Benutzung von RagTime Everywhere!
Das E-Mail enthält auch die Adresse des RagTime Everywhere Servers:
http://www.ragtime-sales.com/
Klicken Sie auf der Seite auf »Weiter«, geben dann Ihre Benutzerkennung und Ihr vorläufiges Kennwort ein und klicken auf »Login«.
Im folgenden Fenster sehen Sie drei Ordner:
RagTime.de Sales GmbH
Ihren eigenen Ordner
WebShare Public
In dem Ordner »RagTime.de Sales GmbH« stellen wir Dinge zur Verfügung.
Klicken Sie auf Ihren eigenen Ordner, werden die Anweisungen zum Anlegen von Unterordnern, zum Hochladen von Dateien etc. aktiv.
Aber: Zuerst die Änderung des Kennworts!
Klicken Sie oben im Fenster auf das Symbol »Administration« und im folgenden Fenster auf »Meine Benutzereinstellungen«.
In dem Bereich »WebShare-Einstellungen« geben Sie zuerst Ihr bisheriges Kennwort ein und dann ein neues. Merken Sie sich Ihr Kennwort bitte gut!
Hier noch ein genereller Hinweis zur Bedienung: Der RagTime Everywhere Server arbeitet sehr viel mit Scripts. Bitte benutzen Sie zur Navigation immer die Links auf der Seite und nicht die Browser-Knöpfe »vor« und »zurück«.
Grund-Handgriffe mit RagTime Everywhere
RagTime everywhere Anmerkungen
Ausführliche Beschreibung:
Anmerkungen zu einem Dokument anlegen
Für diese Einführung in Anmerkungen in RagTime everywhere habe ich eine kleine Beispiel-Situation konstruiert. Klicken Sie je auf ein Bild, um es in Originalgröße zu sehen.
Im RagTime everywhere-Account wurde ein Projektordner mit ein paar Bildern und einem RagTime-Dokument angelegt:
Der Server hat von dem Layout des RagTime-Dokuments eine PDF-Vorschau erzeugt, die man sich von jedem Gerät, das im Web browsen kann, in unterschiedlichen Skalierungen ansehen kann (auch blättern).
Die Neuerung sieht man, wenn man das Menü »Ansicht« öffnet:
Hier kann man das Werkzeug für die Anmerkungen aufrufen. Es erscheint eine Palette mit den Bestehenden Anmerkungen. Ein Mausklick auf das Pluszeichen, und man kann eine neue Anmerkung eingeben. Mit einem Rechteck lässt sich markieren, worauf die Anmerkung sich genau bezieht:
Beachten Sie dabei auch das Menü »Status« in der Palette für die Anmerkung. Jede neue Anmerkung, aber auch jede Antwort darauf, kann den Status auf »OK« oder »abgelehnt« setzen. Das ist optimal für die Verfolgung eines Arbeitsablaufs – zumal die Anmerkungen erhalten bleiben, wenn man das Dokument aktualisiert.
Im nächsten Bild haben wir eine kleine Diskussion nachgespielt: Ein Kollege hat sich am selben Account angemeldet und eine Antwort geschrieben. Zu dieser habe ich wiederum geantwortet. Und so sieht das dann aus:
Noch ein Feature oben drauf
In dem Ansicht-Menü gibt es auch den Eintrag »Farbinformationen«. Für alle Bitmap-Bilder, hier also die PNG-Dateien mit den Bildern von Lokomotiven, kann man sich für beliebige Punkte die Farbinformation anzeigen lassen. Es hat zwar nichts direkt mit Anmerkungen zu tun, aber zeigen will ich es hier trotzdem. Im folgenden Bild wurde die Datei »Train_5.png« geöffnet und es wurden zwei Pipetten gesetzt, für die die Farbinformationen gezeigt werden:
WM-Planer Fußball Weltmeisterschaft 2006 (deutsch/netherlands)
Grundlagen für den WM-Planer
Regeln für die Gruppenreihenfolge
Sortieren der Gruppe, Beispiel-Dokument
Zeitschriften mit RagTime 6.5: Stammseiten
Einführung
Zu Bild 1:
Einfaches Stammlayout
Zu Bild 2:
Wirkung Grundlinienraster
Das Projekt
Teil 2:
Vorüberlegungen zum Satzspiegel
Die meisten Seiten einer Zeitschrift haben ein ähnliches Aussehen. Es gibt aber einige Sonderfälle: Das Titelblatt hat nahezu immer eine andere Gestaltung als der Rest, ebenso die Rückseite. Oft soll auf der vorletzten Seite (oder der dritten von hinten) immer das Impressum stehen. Für eine Zeitschriftenvorlage beginnt man am besten mit einer Skizze auf Papier, welche Seiten solche festen Besonderheiten haben.
Dann macht man sich Gedanken zur Gestaltung der normalen Seiten. Das passiert am besten gleich am Rechner. In RagTime wird im Foyer, Tafel »Neu beginnend mit« auf »Stammlayout« geklickt. RagTime erzeugt ein neues Dokument mit einer Seite, die fast aussieht, wie eine normale Layoutseite. Der Karteikartenreiter oben über der Seite steht allerdings in der Mitte. Dies deutet an, dass es sich um eine Stammseite handelt.
Als erstes legt man den »Satzspiegel« fest, und zwar mit Hilfslinien. Hilfslinien werden mit der Maus aus den Linealen am Fensterrand herausgezogen und auf der leeren Seite losgelassen. Mit einem Doppelklick auf eine Hilfslinie öffnet man einen Dialog, in dem die Position exakt als Koordinate eingegeben werden kann, auf Wunsch lässt sich hier auch die Farbe ändern.
Wir beginnen mit einer typischen rechten Seite. Die ersten Fragen sind: Wie groß sollen die Ränder zu den Seitengrenzen sein und wie viele Spalten soll der Text haben. Auf A4 gut lesbar ist ein dreispaltiger Text. Zwei Spalten sind möglich, aber die Zeilen sind so lang, dass sie deutlich schwerer zu lesen sind.
Eine A4-Seite ist 21 cm breit. Wenn er Außenrand 2 cm betragen soll (rechter Rand auf einer rechten Seite), muss die Hilfslinie bei 19 cm liegen. Der Innenrand (links auf einer rechten Seite) kann schmaler sein, hier stoßen im fertigen Heft zwei Ränder gegeneinander. Wählen wir 1,5 cm.
Der untere Rand einer Seite ist üblicherweise am breitesten (beim Lesen von Büchern muss da der Damen Platz haben), nehmen wir 2,5 cm. Von oben gemessen ist das die Position 27,2 cm für die Hilfslinie.
Die drei Spalten: Unsere Ränder lassen einen Raum von 17,5 cm. Die Spalten müssen einen Abstand haben, wählen wir 5 mm. Verbleiben 16,5 cm für den Text, geteilt in drei Spalten. Die Spalten sind damit 5,5 cm breit. Von links beginnend ergeben sich folgende Positionen für weitere senkrechte Hilfslinien:
7,0 cm 7,5 cm 13,0 cm 13,5 cm
Der obere Rand der Seite hängt sehr davon ab, wie jeweils der Seitenkopf gestaltet wird. Soll der Bereich nur eine Überschrift für die Seite enthalten, wählen sie ihn etwas kleiner als den unteren Rand, z.B. 2 cm. Soll dort je ein Logo o.A. platziert werden, richtet sich der Rand danach.
Wenn Sie die Seite bis zu diesem Punkt gestaltet haben, machen Sie ein kleines Experiment: Klicken Sie den Karteikartenreiter oben über der Stammseite an und rufen »Layout - Doppelseitige Stammseite« auf. RagTime erzeugt jetzt eine linke Seite, auf der alle senkrechten Hilfslinien gespiegelt erscheinen. Dies ist der Grund, weshalb ich vorgeschlagen habe, mit einer rechten Standardseite zu beginnen. Da wir noch nicht ganz fertig sind, entfernen Sie die linke Stammseite bitte wieder: Seitenreiter anklicken und »Layout - Linke Stammseite löschen«.
Zu Bild 2:
Hilfslinien der ersten Stammseite
Zu Bild 3:
Einstellungen für die Vorlage "Standardabsatz"
Zu Bild 4:
Zwei fertige Seiten der kleinen Zeitschrift
Das Grundlinienraster
Zu Bild 1:
Die verschobene Zeilenhöhe durch ein Bild
Zu Bild 2:
Grundlinienraster einstellen
Zu Bild 3:
Für Standardabsatz festlegen, dass das Raster gilt
Teil 5:
Es kann sein, dass Ihnen die jeweils ersten Zeilen oben in den Rahmen zu weit von der Rahmengrenze entfernt sind. In dem Fall öffnen Sie bitte noch einmal Mit Doppelklick auf einen Seitenreiter die Layoutinformationen und experimentieren mit der Einstellung »Abstand von oberer Papierkante«. Damit lässt sich das Raster auf der Seite verschieben.
An dieser Stelle sind wohl einige Erklärungen an der Reihe. Jedes RagTime-Dokument hat ein Grundlinienraster, gleich, ob sichtbar oder nicht. Voreingestellt beträgt der Abstand der Rasterlinien 12 Punkt.
Absatzvorlagen haben die Einstellung, ob dieses Grundlinienraster von ihnen berücksichtigt werden soll oder nicht. Als Sie im ersten Schritt das Grundlinienraster geändert und sichtbar geschaltet haben, hatte das deshalb auf den Text keine Wirkung. Erst, als Sie im zweiten Schritt die Absatzvorlage »Standardabsatz« geändert haben, wurde das Raster für diese Vorlage gültig und der Text hat sich angepasst.
Weshalb diese zwei Stufen? Würde jeder Text an dem Raster ausgerichtet werden, wäre das viel zu unflexibel bei der Gestaltung. Es muss möglich sein, z.B. Überschriften unabhängig vom Raster zu halten. Auch bei Bildzuschriften wäre es inakzeptabel: Die Zeilen müssen einen einheitlichen Abstand vom Bild haben. Deshalb können Sie für jede Absatzvorlage unabhängig einstellen, ob sie das Grundlinienraster berücksichtigt oder nicht.
Weshalb sollte die Zugabe bei den Zeilenabständen zurück auf 0 gesetzt werden? Grundlinienraster haben auch eine Falle. Wenn die Zeilenhöhe auch nur minimal größer ist, als der Rasterlinienabstand, dann rasten die Textzeilen auf jeder zweiten Rasterlinie ein! Wird das Grundlinienraster benutzt, sollte der Zeilenabstand in der Absatzvorlage für normalen Text immer kleiner eingestellt werden, als der Abstand der Rasterlinien.
Noch ein Tipp zu den Abstandseinstellungen: Wenn im Text auch hochgestellte oder tiefgestellte Buchstaben vorkommen, dann ändert sich dadurch eine automatische Zeilenhöhe. Wahrscheinlich geschieht das an dieser Stelle auch in Ihrem Web-Browser. Dadurch kann es passieren, dass dann ein doppelter Zeilenabstand entsteht. In der Praxis ist es für die Einstellungen von Standardabsatz meist günstiger, eine feste Zeilenhöhe zu benutzten - wiederum kleiner als der Abstand der Rasterlinien.
Experimentieren Sie noch ein wenig mit dem Dokument. Wenn Sie einen neuen Textrahmen auf der Seite aufziehen und darin schreiben, richtet sich auch in diesem Rahmen der Text an den Grundlinien aus. Soll das für frei platzierte Rahmen anders sein, müssen Sie sich eine weitere Absatzvorlage anlegen und im Text benutzen.
Das Grundlinienraster wirkt grundsätzlich nicht auf grafischen Text und auch nicht auf Textelemente anderer Komponenten wie Tabellen oder Diagrammen.
Die Einstellungen für das Grundlinienraster gelten immer für das ganze Dokument. Es ist gleichgültig, ob Sie die Einstellungen in den Layoutinformationen für eine Stammseite oder eine Layoutseite vornehmen.
Das Stammlayout erweitern
Zu Bild 1:
Zustannd des Stammlayouts nach Zufügen der linken Stammseite.
Zu Bild 2:
Dies ist die aktuelle Anordnung auf den Stammseiten. Zur besseren Sichtbarkeit haben wir die Rahmen für Inhalt und Impressum gra
Inhaltsverzeichnis
Zu Bild 1:
Ãœbreschriften-Einstellungen
Teil 2:
Inhaltsverzeichnis anlegen
Rufen Sie jetzt »Extras - Inhaltsverzeichnis erzeugen« auf. Ein Dialog fragt Sie, für welches Layout das Inhaltsverzeichnis gebraucht wird. Wählen Sie es und klicken »OK«
Scheinbar tut RagTime nichts. Aber öffnen Sie das Inventar Ihres Dokuments. Eine neue Textkomponente namens »Inhaltsverzeichnis« ist entstanden.
In unserem Broschüren-Dokument gab es ein Rechteck auf Seite 1 für das Inhaltsverzeichnis. Ziehen Sie die Inhaltsverzeichnis-Komponente aus dem Inventar in dieses Rechteck. (Hatten Sie diese Tests mit einem improvisierten Dokument gemacht, zeichnen Sie zuerst ein leeres Rechteck.)
Der Text in dem Rechteck listet alle Ãœberschriften mit ihren Seitenzahlen.
Wichtige Hinweise
Das Inhaltsverzeichnis kann wie jeder andere Text bearbeitet werden. Wenn es aber neu angelegt werden muss (Aufruf von »Extras - Inhaltsverzeichnis erzeugen«), werden alle Änderungen überschrieben. Brauchen Sie andere Stile (Ränder, Abstände...), ändern Sie die Vorlagen, die das Inhaltsverzeichnis nutzt. Im Absatzvorlagen-Editor stehen jetzt neue Stile »Inhaltsverzeichnis« (einer für jede benutzte Überschriftebene).
Änderungen hier werden nicht überschrieben, wenn Sie das Inhaltsverzeichnis neu anlegen.
Das Inhaltsverzeichnis wird nur geändert, wenn »Inhaltsverzeichnis erzeugen« aufgerufen wird. D.h.: Nach Textänderungen, bei denen Überschriften auf andere Seiten fließen, müssen Sie die Anweisung vor dem Druck neu aufrufen.
Zusammenfassung
Die folgenden Punkte sollte man sich einprägen:
Textzeilen müssen vordefinierte Überschriften-Absatzformate nutzen, um im Inhaltsverzeichnis zu erscheinen.
Erzeugen eines Inhaltsverzeichnisses liefert eine neue Textkomponente, die im Inventar erscheint. Von dort kann sie irgendwo platziert werden.
Das Inhaltsverzeichnis wird nur aktualisiert, wenn Sie »Inhaltsverzeichnis erzeugen« neu aufrufen.
Alle Änderungen am Aussehen sollten über die Formatvorlagen erfolgen, die das Inhaltsverzeichnis nutzt, weil sie den neuen Aufruf von »Inhaltsverzeichnis...« überleben.
Schlussbemerkung
Ausführliche Beschreibung:
Spezielle Seiten
In den meisten Veröffentlichungen brauchen Sie Spezialseiten. Mal wurde eine Seite für Werbung verkauft um das Projekt zu finanzieren. Mal braucht man eine spezielle Bilderseite ohne jeden Text. RagTime verbindet Seiten automatisch mit Stammseiten, basierend auf den gegebenen Regeln. Sie können diese Verbindungen aber jederzeit manuell überschreiben.
Zuerst wird eine Stammseite für Spezialfälle angelegt: Öffnen Sie das Stammlayout (Doppelklick im Inventar) und wählen die rechte Standardseite aus durch Doppelklick auf den Seitenreiter. Kopieren Sie die Seite, klicken Sie in den Seitenzwischenraum darunter und setzen Sie die Seite ein.
Öffnen Sie die Layoutinformation der kopierten Seite. In der Tafel »Stammseiten« wählen Sie die letzte Option für »Benutzung«: »Wenn die gegebene Formel den Wert WAHR liefert«. Geben Sie 0 als Wert ein (d.h.: immer falsch!") Diese Stammseite wird nie automatisch benutzt. Oben in der Tafel können Sie die Seite benennen. Geben Sie »Leer« o.ä. ein.
Löschen Sie alle Objekte der Seitenkopie: Wählen Sie eines aus und drücken (Win:) strg-A / (Mac:) cmd-A. Alles wird ausgewählt. Drücken Sie die Rückschritttaste zum Löschen.
Klicken Sie wieder den Seitenreiter an und rufen »Layout - Doppelseitige Stammseite« auf. Schließen Sie das Stammlayout-Fenster.
Im Layout klicken Sie doppelt auf den Reiter der Seite, die als Spezialseite genutzt werden soll. In der Tafel »Seiten« gibt es ein Dropdown-Menü, in dem manuell eine Stammseite wählbar ist. Wählen sie hier »Leer«.
Text im Layout wird neu umbrochen und Ihre Spezialseite ist nun leer. (Hatten Sie dort ein Bild platziert, bleibt es dort. Bewegen Sie es von Hand auf eine andere Seite.)
Die Hilfslinien auf der leeren Seite machen es einfach, Container konsistent zu den übrigen Seiten zu platzieren. Da die leere Stammseite als doppelseitig angelegt wurde, erscheinen die Hilfslinien auf rechten und linken Seiten an der richtigen Position.
Das Bild unten zeigt mein Testdokument für diesen Artikel, zwei Seiten wurden auf die leere Stammseite umgeschaltet.
Zusammenfassung
Lassen Sie mich zusammenfassen, was hier diskutiert wurde:
- Beginnen Sie mit der Gestaltung einer Seite, möglicherweise mit Bleistift und Papier.
- Legen Sie eine Stammseite für typische rechte Seiten an.
- Wählen Sie eine Schriftart und -größe sowie den Zeilenabstand.
- Benutzen Sie das Grundlinienraster für einheitliche Zeilenpositionen in mehrspaltigem Layout.
- Legen Sie Stammseiten (modifizierte Kopien der ersten) für jeden speziellen Seitentyp der Publikation an, einschließlich leerer Seiten. Schalten Sie Stammseiten auf »doppelseitig«, wenn sie links und rechts erscheinen können.
- Benutzen Sie die vordefinierten Ãœberschrift-Absatzvorlagen wenn Sie (evtl.) ein Inhaltsverzeichnis brauchen.
Das war es grundsätzlich. Mit Kenntnis dieser Techniken sollten Sie in der Lage sein, eine handliche Vorlage für Ihre zukünftigen Publikationen zu schaffen.
Eigentlich hatten nur einige Teile dieser Serie mit Stammseiten zu tun. Andere waren allgemein zur Seitengestaltung oder über RagTime. Sie wissen vielleicht, dass Stammseiten eine von zwei Methoden in RagTime sind, Seiten automatisch anzufügen. Für einige Aufgaben (und einige Leute) haben Stammseiten zu viel Automatik. Die andere Methode sind Ringpipelines und könnten ein gutes Thema für einen zukünftiges Artikel abgeben.
