@database "AGImport Guide"
@author "Heiko Schröder"
@$VER: 3.0 (Release 3)
@wordwrap

@node main "AmigaGuide-Import V1.0"
                               @{" < Zur Übersicht " link "Makro-Paket.guide/Main"}

@{fg shine}Der Nutzen:@{fg text}
   Bisher haben Sie versucht Dokumentationen im Amigaguide-Format umständlich
   in Final Writer zu bearbeiten?!
   Dieses Makro nimmt Ihnen die Arbeit ab. Es importiert Guides layoutgetreu
   und setzt automatisch Verweise zu entsprechenden Kapiteln.

@{fg shine}Voraussetzungen:@{fg text}
   Korrekte Guides. ;-)

@{fg shine}Einschränkungen:@{fg text}
   Bis jetzt können nur Guides korrekt importiert werden, die aus nur einer
   Datei bestehen.

@{fg shine}Die Bedienung des @{"Makros" system "Sys:Utilities/Multiview PUBSCREEN=FINALWRITERPUBSCREEN AGImport.iff"}:@{fg text}

   Im oberen Teil des Fensters stehen die voreingestellten Daten zur Guide-
   importierung. Diese können Sie über das Menü: Projekt | @{"Voreinsteller..." link "Voreinst"}
   beliebig anpassen.

                     - - - - - - - - - - - - - - - - - 

   @{fg fill}A@{fg text}nwenden
      Hiermit starten Sie die Importierung, indem Sie das Guide auswählen.
      Die Fortschrittsanzeige zeigt Ihnen wie lange die Importierung ungefähr
      dauert.

      @{fg shine}Hinweise:@{fg text}
         * Es werden VORLÄUFIG Verweiskennungen gesetzt, sich aus dem 
           Amigaguide-Befehl: "link" ergeben.

         * Wenn Sie Seitenzahlen auf den Seiten wünschen, sollten Sie 
           diese über das Menü: Extras | Einfache Seitennummer... setzen.
           Dies ist über das Makro leider nicht machbar.

         * Löschen Sie auf GAR KEINEN FALL die Verweiskennungen. Diese sind
           erkennbar an den Zeichen @{fg shine}ð@{fg text} und @{fg shine}æ@{fg text}
           gefolgt von einer Zahl.
           Diese sind sehr wichtig für die nachfolgende Verweissetzung.

   @{fg fill}V@{fg text}erweise
      Haben Sie das Layout des Guides Ihren Wünschen angepaßt, können Sie
      die Verweise setzen lassen. Die Verweiskennungen werden endgültig 
      gelöscht.
      Das Dokument ist damit vollendet.

   Ab@{fg fill}b@{fg text}ruch
   @{fg fill}ESC@{fg text} oder Window schließen
      Beendet das Makro.

                     - - - - - - - - - - - - - - - - - 

@{fg shine}Hinweis:@{fg text}
      Sollte es Probleme geben, das Makro startet nicht mehr o.ä., so
      löschen Sie bitte die Voreinstellungsdatei "S:FW_AGImport.prefs".
      Meistens ist der Fehler damit behoben. 

@endnode

@node Voreinst "Voreinsteller für den Amigaguide-Import"

   Hiermit können Sie das Layout des zu importierenden Guides Ihren Wünschen
   anpassen.

   @{fg shine}Überschriften:@{fg text}
      Im Guide sind Sie durch die Befehle: @node und/oder @title
      gekenzeichnet. Geben Sie dafür die S@{fg fill}c@{fg text}hriftart und
      die Schrift@{fg fill}g@{fg text}röße an.

   @{fg shine}Mengentext:@{fg text}
      Der eigentliche sichtbare Text im Guide wird hier als Mengentext be-
      zeichnet. Das Aussehen beeinflussen Sie mit der Sc@{fg fill}h@{fg text}riftart
      und der Schriftgr@{fg fill}ö@{fg text}ße.

   @{fg shine}Allgemeines:@{fg text}
   Link@{fg fill}f@{fg text}ormat:
      Geben Sie hiermit das Aussehen des Verweises an.
      %K = Symbol für den Kapitelname
      %S = Symbol für die Seitenzahl

      !!! Bitte keine Anführungsstriche verwenden. !!!

      Ein paar Beispiele:
                     (siehe %K auf Seite %S)
         ergibt z.B. (siehe Vorgeschichte auf Seite 2)

                     (siehe Kapitel: %K auf S.%S)
         ergibt z.B. (siehe Kapitel: Vorgeschichte auf S.2)

                     => %K, S. %S
         ergibt z.B. => Vorgeschichte, S. 2


   @{fg fill}@@{fg text}node schreiben:
      @node ist ein Amigaguide-Befehl, der einen neuen Abschnitt markiert.
      In diesem Befehl verbirgt sich auch der Name des Abschnitts, man kann
      auch sagen der Kapitelname.
      Da aber sehr viele Programmierer in ihren Guides den Namen des Kapitels
      noch einmal hinschreiben - also doppelt -, können Sie dies unterdrücken.

   Seiten@{fg fill}u@{fg text}mbruch:
      Geben Sie an, ob nach jedem Amigaguide-Abschnitt (gekennzeichnet durch
      @node und @endnode) ein Seitenumbruch erfolgen soll.

   Gesch@{fg fill}w@{fg text}indigkeit:
      Es lohnt sich die Geschwindigkeit auf "schnell" zu stellen. Die Ansicht
      des Dokumentets wird dabei auf 20% gesetzt, daß einen enormen 
      Geschwindigkeitszuwachs zur Folge hat.

                     - - - - - - - - - - - - - - - - - 

   @{fg fill}S@{fg text}ichern
      Die eingestellten Daten werden dauerhaft in der Datei S:FW_AGImport.prefs
      gespeichert und werden bei einem erneuten Start des Makros übernommen.

   @{fg fill}A@{fg text}nwenden
      Die eingestellten Daten werden nur solange benutzt bis Sie das Makro
      beenden. Bei einem erneuten Start werden die alten Einstellungen
      benutzt.

   Ab@{fg fill}b@{fg text}ruch
      Alle Einstellungen werden wieder auf das zuletzt Gespeicherte 
      zurückgesetzt.

@endnode