Your first PDF form with Scribus: Difference between revisions

From Scribus Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 13: Line 13:
[[Image:Formularz_nowy.png]]
[[Image:Formularz_nowy.png]]
-->
-->
http://linux.hanski.info/static/image/scribus/pdf_form_en/formularz_nowy.png
http://linux.hanski.info/static/image/scribus/pdf_form_en/formularz_nowy.png


Let us activate the grid then (menu View -> Show Grid), it will help us to correctly locate our form fields on the page. We need some text frames to make a nice title and field descriptions - a few clicks on the [ab] icon and all the text frames are there in no time.
Let us activate the grid then (menu View -> Show Grid), it will help us to correctly locate our form fields on the page. We need some text frames to make a nice title and field descriptions - a few clicks on the [ab] icon and all the text frames are there in no time.
Line 19: Line 22:
[[Image:siatka_menu.png]]
[[Image:siatka_menu.png]]
-->
-->


http://linux.hanski.info/static/image/scribus/pdf_form_en/siatka_menu.png
http://linux.hanski.info/static/image/scribus/pdf_form_en/siatka_menu.png


Having filled our frames with text, we can change their properties with the Properties palette, which can be found in the Tools menu.
Having filled our frames with text, we can change their properties with the Properties palette, which can be found in the Tools menu.
Line 26: Line 31:
[[Image:siatka_jednostki_miar.png]]
[[Image:siatka_jednostki_miar.png]]
-->
-->


http://linux.hanski.info/static/image/scribus/pdf_form_en/siatka_jednostki_miar.png
http://linux.hanski.info/static/image/scribus/pdf_form_en/siatka_jednostki_miar.png


Now we can start adding form elements: some text fields and one button for submitting our form to an URL. To add a field simply click on the arrow on the right side of the OK icon and select a type from the displayed options: button, text field, check box, combo box, and list box.
Now we can start adding form elements: some text fields and one button for submitting our form to an URL. To add a field simply click on the arrow on the right side of the OK icon and select a type from the displayed options: button, text field, check box, combo box, and list box.
Line 33: Line 40:
[[Image:symbole.png]]
[[Image:symbole.png]]
-->
-->


http://linux.hanski.info/static/image/scribus/pdf_form_en/symbole.png
http://linux.hanski.info/static/image/scribus/pdf_form_en/symbole.png
Line 44: Line 52:


http://linux.hanski.info/static/image/scribus/pdf_form_en/ulica.png
http://linux.hanski.info/static/image/scribus/pdf_form_en/ulica.png


The right click on an element activates a new menu. We choose Field Properties and define field names (we will need the field names in our PHP script, to which we'll send the form), types (e.g., number, time, date), and actions to be performed on different events (Mouse Enter, Mouse Exit, On Blur, and so on).
The right click on an element activates a new menu. We choose Field Properties and define field names (we will need the field names in our PHP script, to which we'll send the form), types (e.g., number, time, date), and actions to be performed on different events (Mouse Enter, Mouse Exit, On Blur, and so on).
Line 52: Line 61:


http://linux.hanski.info/static/image/scribus/pdf_form_en/wlasciwosci_pola.png
http://linux.hanski.info/static/image/scribus/pdf_form_en/wlasciwosci_pola.png


Here we are defining the No field as a number. Acrobat Reader won't accept anything else as a valid entry, then.
Here we are defining the No field as a number. Acrobat Reader won't accept anything else as a valid entry, then.
Line 66: Line 76:
[[Image:formularz_js_skrypt.png]]
[[Image:formularz_js_skrypt.png]]
-->
-->


http://linux.hanski.info/static/image/scribus/pdf_form_en/formularz_js_skrypt.png
http://linux.hanski.info/static/image/scribus/pdf_form_en/formularz_js_skrypt.png
Line 77: Line 88:


http://linux.hanski.info/static/image/scribus/pdf_form_en/formularz_js_sprawdzanie.png
http://linux.hanski.info/static/image/scribus/pdf_form_en/formularz_js_sprawdzanie.png


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.
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.
Line 85: Line 97:


http://linux.hanski.info/static/image/scribus/pdf_form_en/wyslij_formularz.png
http://linux.hanski.info/static/image/scribus/pdf_form_en/wyslij_formularz.png


The only thing else to do is to export the document to PDF: menu File -> Export... ->; Export to PDF....
The only thing else to do is to export the document to PDF: menu File -> Export... ->; Export to PDF....
Line 94: Line 107:


http://linux.hanski.info/static/image/scribus/pdf_form_en/formularz_export_PDF.png
http://linux.hanski.info/static/image/scribus/pdf_form_en/formularz_export_PDF.png


The result of our work can be tested Finished PDF. In order to submit the form we must open it from within a browser, Netscape 4.* or Mozilla are the safe choices (check the Mozilla plug-ins to see, if the Acrobat Reader plug-in is enabled. If not, you have to symlink it into the Mozilla's plug-in directory. In my particular case, the Mozilla's plug-in directory is /usr/lib/mozilla-1.3/plug-in, and the plug-in to be symlinked into it is /usr/local/Acrobat5/Browsers/intellinux/nppdf.so).
The result of our work can be tested Finished PDF. In order to submit the form we must open it from within a browser, Netscape 4.* or Mozilla are the safe choices (check the Mozilla plug-ins to see, if the Acrobat Reader plug-in is enabled. If not, you have to symlink it into the Mozilla's plug-in directory. In my particular case, the Mozilla's plug-in directory is /usr/lib/mozilla-1.3/plug-in, and the plug-in to be symlinked into it is /usr/local/Acrobat5/Browsers/intellinux/nppdf.so).

Revision as of 20:15, 7 February 2005

This article is part of the HOWTOs series.
Installation Usage PDF issues Imposition Other

Introduction

(Beware: this is still work in progress, I'm going to update this howto and insert new images, as soon as possible --Mhanski 17:22, 7 Feb 2005 (UTC) )

One of the biggest advantages of Scribus is the possibility to create PDF forms with embedded JavaScript scripts (in Adobe's own version, as described in the Acrobat Javascript Reference - 9.8 Mb).

How it works

Its rather simple to create a new form with Scribus. We start with clicking on the "New Document" icon or choosing New from the File menu.


formularz_nowy.png


Let us activate the grid then (menu View -> Show Grid), it will help us to correctly locate our form fields on the page. We need some text frames to make a nice title and field descriptions - a few clicks on the [ab] icon and all the text frames are there in no time.


siatka_menu.png


Having filled our frames with text, we can change their properties with the Properties palette, which can be found in the Tools menu.


siatka_jednostki_miar.png


Now we can start adding form elements: some text fields and one button for submitting our form to an URL. To add a field simply click on the arrow on the right side of the OK icon and select a type from the displayed options: button, text field, check box, combo box, and list box.


symbole.png


The current active element of the form has a red frame border; you can activate an element in choosing the "Select" icon (the one with crossed arrows) and clicking on the item to be chosen.


ulica.png


The right click on an element activates a new menu. We choose Field Properties and define field names (we will need the field names in our PHP script, to which we'll send the form), types (e.g., number, time, date), and actions to be performed on different events (Mouse Enter, Mouse Exit, On Blur, and so on).


wlasciwosci_pola.png


Here we are defining the No field as a number. Acrobat Reader won't accept anything else as a valid entry, then.


formularz_pole_num.png


Here, we are defining a custom validation script for the Name field - after changing the field contents there will be a beep sound and an alert will be showed (not very sophisticated, I know, but it still demonstrates the possibilities of PDF). Scribus has its own simple text editor, which enables us to save the script to a separate file. Custom scripts can be defined not only on the form field level, but as global scripts as well (Edit -> JavaScripts).


formularz_js_skrypt.png


After saving the script and closing the editor, the script contents is shown in the Field Properties.


formularz_js_sprawdzanie.png


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.


wyslij_formularz.png


The only thing else to do is to export the document to PDF: menu File -> Export... ->; Export to PDF.... We select Acrobat 5.0 as the file format and save the file.


formularz_export_PDF.png


The result of our work can be tested Finished PDF. In order to submit the form we must open it from within a browser, Netscape 4.* or Mozilla are the safe choices (check the Mozilla plug-ins to see, if the Acrobat Reader plug-in is enabled. If not, you have to symlink it into the Mozilla's plug-in directory. In my particular case, the Mozilla's plug-in directory is /usr/lib/mozilla-1.3/plug-in, and the plug-in to be symlinked into it is /usr/local/Acrobat5/Browsers/intellinux/nppdf.so).

Final word

My very own impression: Scribus as a tool for working with PDF forms seems to be more comfortable in use than Adobe Acrobat 5.0 (the only version, I've worked with). It's a lot easier to layout documents with Scribus, since Acrobat only allows you to edit existing documents, but not to create a new document from scratch. Scribus provides us with the full control over the final results and allows us much more freedom in changing the document's layout. More over, Scribus files can be edited even with a simple text editor, since its file format is entirely XML based.

--Mhanski 17:17, 7 Feb 2005 (UTC)