Twój pierwszy formularz PDF w Scribusie: Difference between revisions

From Scribus Wiki
Jump to navigation Jump to search
Line 54: Line 54:




Tutaj definiujemy pole '''Nr''' jako liczbę. Adobe Reader nie pozwoli na wpisanie do tego innego niczego poza liczbą.  
Tutaj definiujemy pole '''Nr''' jako liczbę. Adobe Reader nie pozwoli na wpisanie w tym polu innego niczego poza wartością numeryczną.  




Line 72: Line 72:




After saving the script and closing the editor, the script contents is shown in the '''Field Properties'''.
Po zapisaniu skryptu i zamknięciu edytora, zawartość skryptu wyświetla się we '''Właściwościach pola'''.




Line 78: Line 78:




We have still to define, to which URL the form contents will be sent (there is a simple PHP script at the destination address, which will format and display the received form data). We choose in the button properties as the action type '''Submit''' form and enter the address of our PHP script: '''scribus_test.php'''. We match the '''Submit Data as HTML''' option to end with (the other option would be the FDF data, but this is a very different story) and we are done now.
Musimy jeszcze zdefiniować adres URL, na który wyślemy zawartość formularza (pod adresem tym czeka prosty skrypt PHP, który sformatuje i wyświetli zawrtość formularza). We właściwościach przycisku definujemy jako typ akcji '''Wyślij formularz''' i wpisujemy jako adres nazwę naszego skryptu PHP: '''http://twoj.serwer/scribus_test.php'''. Zaznaczamy jeszcze opcję '''Wyślij dane jako HTML''' (inna możliwość to wysłanie danych w formacie FDF, ale to już zupełnie inna historia) i nasz formularz jest gotowy.




Line 84: Line 84:




The only thing else to do is to export the document to PDF: menu '''File > Export... > Export to PDF...'''.
Ostatnią rzeczą do zrobienia jest wyeksportowanie dokumentu do formatu PDF: menu '''Plik > Eksport... > Export to PDF...'''.
We select Acrobat 5.0 as the file format and save the file.
The only thing else to do is to export the document to PDF: menu '''File > Exportuj... > Zapisz jako PDF...'''.
Jako format pliku wybieramy Acrobat 5.0 i zapisujemy plik.





Revision as of 14:42, 29 April 2005

Template:Jak to zrobić

Wstęp

Jedną z największych zalet Scribusa jest możliwość tworzenia formularzy PDF zawierających skrypty w języku JavaScript. Zwykle formularze takie przeznaczone są do wypełnienia na komputerze, a następnie wydruku. Informacje podane w polach tekstowych formularza PDF mogą być także wysłane na inny adres w celu dalszego przetwarzania.

Aby uczynić ze Scribusa w pełni profesjonalne narzędzie do produkcji do produkcji formularzy PDF, zespół tworzący ten program powinien wdrożyć jeszcze parę ważnych szczegółów. Chodzi m.in. o możliwość tworzenia przycisków wyboru (radio buttons, RFE 866) i wykonywanie globalnych skryptów w JavaScript n.p. podczas ładowania się formularza.

Niemniej Scribus już teraz dla wielu ludzi jest wartościowym narzędziem do tworzenia formularzy PDF i staje się coraz lepszy z dnia na dzień.

Wymagania

  • Scribus -- im nowszy, tym lepszy. W celu pobrania aktualnej wersji zajrzyj na stronę domową Scribusa
  • Adobe Reader 7 lub nowszy -- dopiero wersja 7 nie ma problemów z polskimi znakami w polach formularzy
  • Przeglądarka wspierająca wtyczkę Adobe Readera, najlepiej Firefox.

Tworzenie formularzy PDF

Tworzenie formularzy w Scribusie jest raczej mało skomplikowane. Zaczniemy od kliknięcia na ikonę Nowy Dokument lub wybrania opcji Nowy z menu Plik.


New document dialog in Scribus 1.2.2


Najpierw włączymy siatkę (menu Widok>Wyświetlaj siatkę), która pomoże nam w pozycjonowaniu pól formularza na stronei. Będziemy potrzebowali paru ramek tekstowych na tyłuł i opisy pól -- jest to raptem parę kliknięć na ikonę ramki tekstowej (tę w prawo od ikony ze strzałką).


Grid menu.png


Po wpisaniu tekstu do ramek tekstowych zmieniamy ich właściwości za pomocą palety Właściwości, dostępnej w menu Narzędzia.


Properties.png


Teraz możemy zacząć dodawać elementy formularza: parę pól tekstowych i przycisk, za pomocą którego będzie można wysłać zawartość formularza na zdefiniowany w nim adres URL. Aby dodać element formularza, klikamy na strzałkę po prawej stronie ikony OK wybieramy jedną z dostępnych opcji: przycisk, pole tekstowe, pole wyboru, listę rozwijaną lub listę.


Form elements1.png


Aktualnie aktywny element formularza ma czerwone obramowanie -- elementy wybiera się klikając na ikonę Wybierz element (tę ze strzałką, w lewo od ikony ramki tekstowej) i klikając na dany element.


Ulica.png


Prawy klik na elemencie formularza włącza menu kontekstowe. Wybieramy Opcje PDF > Właściwości pola i definiujemy nazwy pól (będziemy potrzebowali nazw pól w skrypcie PHP, do którego wyślemy formularz), typy (np., numer, czas, data) oraz akcje, które mają być wykonane w odpowiedzi na określone zdarzenia (Mouse Enter, Mouse Exit, On Blur itd.).


Field properties appearance1.png


Tutaj definiujemy pole Nr jako liczbę. Adobe Reader nie pozwoli na wpisanie w tym polu innego niczego poza wartością numeryczną.


Field properties format1.png


Aby zmienić kolejność pól (przyda się przy używaniu tabulatora do przeskakiwania z jednego pola do drugiego), otwieramy paletę Właściwości, klikamy na zakładkę X,Y,Z i zmieniamy numer poziomu wybranych pól.


Field tab order.png


Tutaj tworzymy własny skrypt sprawdzający zawartość pola Nazwisko - po zmianie zawartości pola włączy się brzęczyk i wyświetli się ostrzeżenie (niezbyt to skomplikowane, ale wystarczy do zademonstrowania możliwości PDF). Scribus posiada własny, prosty edytor tekstowy, który umożliwia nam zapisanie skryptu w oddzielnym pliku. Skrypty można definiować nie tylko na poziomie pól, ale również na poziomie dokumentu (menu Edycja > Skrypty w JavaScript).


Js validate script.png


Po zapisaniu skryptu i zamknięciu edytora, zawartość skryptu wyświetla się we Właściwościach pola.


Field properties validate.png


Musimy jeszcze zdefiniować adres URL, na który wyślemy zawartość formularza (pod adresem tym czeka prosty skrypt PHP, który sformatuje i wyświetli zawrtość formularza). We właściwościach przycisku definujemy jako typ akcji Wyślij formularz i wpisujemy jako adres nazwę naszego skryptu PHP: http://twoj.serwer/scribus_test.php. Zaznaczamy jeszcze opcję Wyślij dane jako HTML (inna możliwość to wysłanie danych w formacie FDF, ale to już zupełnie inna historia) i nasz formularz jest gotowy.


Field action.png


Ostatnią rzeczą do zrobienia jest wyeksportowanie dokumentu do formatu PDF: menu Plik > Eksport... > Export to PDF.... The only thing else to do is to export the document to PDF: menu File > Exportuj... > Zapisz jako PDF.... Jako format pliku wybieramy Acrobat 5.0 i zapisujemy plik.


Pdf export.png


Now it is time to launch Acrobat Reader and and see what you have done. Acrobat Reader 7 finally delivers the capability to display Unicode characters inside form fields -- great news for all non English native speakers. Both Name and Street fields contain characters outside of the Latin-1 font set. The No field contains a default value of 15 that has been put into it eaerlier -- in Scribus, just right click onto the form field, choose Edit text... from the context menu and type your default value.


Acroread unicode.png

Konfiguracja przeglądarek w celu wyświetlania formularzy PDF

Jeśli jesteś szczęśliwym posiadaczem w miarę aktualnej wersji Firefoksa, Mozilli lub Netscape'a, masz już jeden kłopot z głowy. Ponieważ ani Opera, ani Konqueror nie były w stanie poradzić sobie z wysyłaniem formularzy PDF, skoncentrujemy się na przeglądakach z rodziny Mozilli. Jedyną rzeczą, jaką musisz zrobić, to powiedzieć Firefoksowi, gdzie ma szukać wtyczki Adobe Readera 7. Dla posiadaczy Linuksa:

  1. Utwórz symboliczne dowiązanie do $twój_katalog_instacyjny/Acrobat7.0/Browser/intellinux/nppdf.so 
     w katalogu z wtyczkami Mozilli, np. dla Gentoo Linuksa będzie to /usr/lib/MozillaFirefox/plugins
  2. Upewnij się, że acroread zainstalowany jest w jednym z katologów podanych w PATH.

Jeśli używasz Firefoksa w innym systemie operacyjnym, zajrzyj na stronę Mozilli dotyczącą instalacji wtyczek: Mozilla Plugindoc site.

Testowanie i pobieranie przykładowych plików

  • Przykładowy formularz PDF (utworzony w Scribusie) -- Otwórz ten formularz w twojej przeglądarce internetowej i kliknij na przycisk Submit. Jeśli przeglądarka prawidłowo obsługuje wtyczkę Adobe Reader, powinieneś otrzymać odpowiedź od skryptu PHP.

Podsumowanie

Scribus jest komfortowym narzędziem do tworzenia formularzy PDF, zarówno ze względu na łatwość tworzenia i pozycjonowania elementów formularzy, jak i jakość efektu finalnego. Dodatkowo w pełni otwarty, oparty na XML format pliku Scribusa (.sla) pozwala zarówno na łatwe wprowadzanie zmian w zwykłym edytorze tekstowym, jak i automatyczne generowanie plików formularzy w innych programach.

Inne źródła informacji