# Używanie wczytki InPageMonitor

## Spis rzeczy

1. Instalacja
2. Aktywacja
3. Okienko informacyjne (O InPageMonitor)
4. Preferencje
5. Paletka
6. Użytkowanie
7. Przykład

## Instalacja

Instalacja wtyczki InPageMonitor odbywa się poprzez skopiowanie folderu wtyczki (InPageMonitor) do odpowiedniego folderu wtyczek programu InDesign (przeważnie jest to C:\Program Files\Adobe\Adobe InDesign CS3\Plug-ins).

Uwaga: Dodatkowo w wersji Windows należy umieścić odpowiednie pliki .dll w odpowiednich folderach. Wewnątrz folderu InPageMonitor znajduje się podfolder system, gdzie umiesczono pliki libcurl.dll (7.18) oraz zlib1.dll (1.2.3). Obydwie biblioteki .dll należy skopiować do folderu systemowego (np. C:\Windows\System32) lub folderu, gdzie umiesczony jest plik .exe programu Adobe InDesign (np. C:\Program Files\Adobe\Adobe InDesign CS3).

Krok po kroku:

- zlokalizować folder programu InDesign (przeważnie jest to C:\Program Files\Adobe\Adobe InDesign CS3)
- odszukać folder Plug-Ins wewnątrz folderu programu InDesign
- skopiować folder wtyczki do tegoż folderu
System Windows: Skopiować pliki libcurl.dll oraz zlib1.dll do folderu, gdzie znajduje się program InDesign.exe (przeważnie jest to C:\Program Files\Adobe\Adobe InDesign CS3) lub do folderu systemowego (przeważnie jest to C:\Windows\System32).
- zrestartować program Adobe InDesign
- po ponownym uruchomieniu aplikacji paletka wtyczki dostępna będzie w menu Okno/Page Monitor.

## Aktywacja

Wtyczkę InPageMonitor należy aktywować tak, by móc pracować ponad ustalony czas 30 dni wersji demonstracyjnej. Proszę przeczytać o sposobie aktywacji.

## Okienko informacyjne

Okienko informacyjne (rys. 1) dostępne z poziomu głównego menu (Pomoc/Opis wtyczek/Programac/O InPageMonitor) oraz z poziomu menu paletki dostarcza informacji o wersji produktu oraz kluczu aktywacyjnym.

# Rys. 1: Okienko informacyjne

## Preferencje

Wczytka InPageMonitor udostępnia jedną preferencję, wskazującą na lokalizację pliku konfiguracyjnego .xml (plik tworzony w trakcie instalacji modułu InPageMonitorPHP). W pliku tym zawarte są dalsze informacje o działaniu wtyczki. Standardowo plik ten powinien być umieszczony gdzieś na serwerze, na którym działać będzie również moduł InPageMonitorPHP. Znając jego położenie, wystarczy wpisać URL w okienko preferencji.

Uwaga: Każdorazowo podczas startu programu InDesign InPageMonitor będzie poszukiwać pliku we wskazanym miejscu. Jeżeli plik ten nie zostanie znaleziony, InPageMonitor nie będzie mógł działać.

# Rys. 2: Preferencje wtyczki

## Paletka

Wtyczka InPageMonitor jest z powiomu paletki. Paletkę InPageMonitora można otworzyć wybierając z menu Okno element InPageMonitor (Okno/Page Monitor).

# Rys. 3: Pozycja Typografii w menu

1. Lista stron, wraz ze statusami "gotowy". Strona o statusie "gotowy" będzie inaczej prezentowana przez moduł InPageMonitorPHP.
2. Menu paletki, udostępniające funkcjonalność tożsamą z punktem 3.
3. Od lewej:
   - Oznacz wszystkie/zaznaczone strony jako niegotowe.
   - Oznacz wszystkie/zaznaczone strony jako gotowe.
   - Odwróc statusy wszystkich/zaznaczonych stron.

## Użytkowanie

InPageMonitor działa na plikach, których nazwy przechodzą test wyrażeń regularnych. Możliwe wyrażenia regularne dla nazw stron tworzone są automatycznie podczas instalacji modułu InPageMonitorPHP, kiedy to tworzony jest plik InPageMonitor.xml (URL do tego pliku wprowadzony musi być w preferencjach).

Definicja schematu nazewnictwa wygląda następujco (jeden z przykładów z pliku InPageMonitor.xml):

    <DOCNAME>
      <REGEX>([0-9]+_[0-9]+_(PS1|PS2)_([0-9]{6})+).+</REGEX>
      <DAY>[0-9]+_[0-9]+_[A-Z,0-9]{3}_([0-9]{2})</DAY>
      <MONTH>[0-9]+_[0-9]+_[A-Z,0-9]{3}_[0-9]{2}([0-9]{2})</MONTH>
      <MINIYEAR>[0-9]+_[0-9]+_[A-Z,0-9]{3}_[0-9]{4}([0-9]{2})</MINIYEAR>
      <OBJECT>[0-9]+_[0-9]+_([A-Z,0-9]{3})</OBJECT>
      <PAGE>([0-9]+)</PAGE>
      <XPAGE>[0-9]+_([0-9]+)</XPAGE>
    </DOCNAME>

Z powyższego przykładu wynika, że nazwa pliku:
`12_14_PS1_310108_OpisDokumentuTekstowego.indd`
zostanie odszyfrowana w następujący sposób:

- Przedział stron do generacji podglądów w dokumencie to: 12-14
- Produkt/sekcja: PS1 (jak wynika z REGEX'u, możliwe są tylko opcje PS1 i PS2, wartści te można zmodyfikać wprowadzając poprawki do pliku InPageMonitor.xml).
- Data: 31/01/08 (dzień/miesiąc/rok, po dwie cyfry).
- Dodatkowy tekst: OpisDokumentuTekstowego

Użytkowanie wtyczki sprowadza się do nadawania stronom statusu gotowa/niegotowa z poziom paletki oraz wywoływaina opcji Zapisz, co powoduje wygenerowanie odpowiedniej ilości podglądów, zapis tychże do folderu tymczasowego oraz wysłanie ich do serwera FTP.

Uwaga: Podlądy generowane i wysyłane są tylko przy akcji typu Zapisz, nie Zapisz jako.