From 4669bb25fc218ac581eb9708e478cd40d3840a9b Mon Sep 17 00:00:00 2001 From: craig Date: Wed, 25 Apr 2012 20:57:24 +0000 Subject: Update Italian documentation git-svn-id: svn://scribus.net/branches/Version14x/Scribus@17472 11d20701-8431-0410-a711-e3c959e3b870 --- scribus/doc/it/WwFill.html | 2 +- scribus/doc/it/WwImages.html | 6 +- scribus/doc/it/WwLines.html | 4 +- scribus/doc/it/WwRenderframes.html | 6 +- scribus/doc/it/WwShapes.html | 4 +- scribus/doc/it/about1.html | 105 + scribus/doc/it/bugreport.html | 85 + scribus/doc/it/cms.html | 54 + scribus/doc/it/cms2.html | 44 + scribus/doc/it/cms3.html | 20 + scribus/doc/it/codingstandards.html | 433 +++ scribus/doc/it/color2.html | 2 +- scribus/doc/it/color7.html | 26 + scribus/doc/it/colorwheel.html | 62 + scribus/doc/it/config.html | 2 +- scribus/doc/it/contributions.html | 46 + scribus/doc/it/developers.html | 14 + scribus/doc/it/doccopyright.html | 84 + scribus/doc/it/download.html | 20 + scribus/doc/it/editorial.html | 20 + scribus/doc/it/faq1.html | 166 ++ scribus/doc/it/faq3.html | 46 + scribus/doc/it/fileproblems.html | 80 + scribus/doc/it/gettexthowto.html | 153 + scribus/doc/it/gsview.html | 95 + scribus/doc/it/images/CMakeLists.txt | 4 +- scribus/doc/it/images/Cover_en1-page1.png | Bin 0 -> 447105 bytes scribus/doc/it/images/DrawLatexFrame.png | Bin 0 -> 207 bytes scribus/doc/it/images/Mantis_my_view.png | Bin 0 -> 55212 bytes scribus/doc/it/images/Mantis_new_report1.png | Bin 0 -> 12795 bytes scribus/doc/it/images/Mantis_new_report2.png | Bin 0 -> 6724 bytes scribus/doc/it/images/Mantis_new_report3.png | Bin 0 -> 8833 bytes scribus/doc/it/images/Mantis_searching.png | Bin 0 -> 47819 bytes scribus/doc/it/images/Mantis_signup.png | Bin 0 -> 23459 bytes scribus/doc/it/images/RYB_color_wheel.png | Bin 0 -> 8690 bytes scribus/doc/it/images/Rembrandt1.png | Bin 0 -> 116659 bytes scribus/doc/it/images/Rembrandt10.png | Bin 0 -> 28228 bytes scribus/doc/it/images/Rembrandt11.png | Bin 0 -> 123632 bytes scribus/doc/it/images/Rembrandt12.png | Bin 0 -> 557720 bytes scribus/doc/it/images/Rembrandt13.png | Bin 0 -> 44571 bytes scribus/doc/it/images/Rembrandt14.png | Bin 0 -> 11214 bytes scribus/doc/it/images/Rembrandt15.png | Bin 0 -> 50530 bytes scribus/doc/it/images/Rembrandt16.png | Bin 0 -> 59516 bytes scribus/doc/it/images/Rembrandt17.png | Bin 0 -> 793742 bytes scribus/doc/it/images/Rembrandt17a.png | Bin 0 -> 276388 bytes scribus/doc/it/images/Rembrandt17b.png | Bin 0 -> 449106 bytes scribus/doc/it/images/Rembrandt18.png | Bin 0 -> 450580 bytes scribus/doc/it/images/Rembrandt18b.png | Bin 0 -> 18242 bytes scribus/doc/it/images/Rembrandt19.png | Bin 0 -> 11750 bytes scribus/doc/it/images/Rembrandt2.png | Bin 0 -> 64737 bytes scribus/doc/it/images/Rembrandt20.png | Bin 0 -> 49225 bytes scribus/doc/it/images/Rembrandt21.png | Bin 0 -> 120137 bytes scribus/doc/it/images/Rembrandt3.png | Bin 0 -> 77547 bytes scribus/doc/it/images/Rembrandt4.png | Bin 0 -> 53373 bytes scribus/doc/it/images/Rembrandt5.png | Bin 0 -> 120168 bytes scribus/doc/it/images/Rembrandt6.png | Bin 0 -> 53412 bytes scribus/doc/it/images/Rembrandt7.png | Bin 0 -> 55000 bytes scribus/doc/it/images/Rembrandt8.png | Bin 0 -> 41222 bytes scribus/doc/it/images/Rembrandt9.png | Bin 0 -> 54234 bytes scribus/doc/it/images/Scripter.png | Bin 0 -> 33192 bytes scribus/doc/it/images/SwB.png | Bin 0 -> 93557 bytes scribus/doc/it/images/alert.png | Bin 0 -> 187 bytes scribus/doc/it/images/batik1.png | Bin 0 -> 29441 bytes scribus/doc/it/images/boundingbox.png | Bin 0 -> 5932 bytes scribus/doc/it/images/boundingbox1.png | Bin 0 -> 7309 bytes scribus/doc/it/images/cms-gamut1.png | Bin 0 -> 32560 bytes scribus/doc/it/images/cms-gamut2.png | Bin 0 -> 18883 bytes scribus/doc/it/images/cmsmodify1.png | Bin 0 -> 130238 bytes scribus/doc/it/images/cmyk.png | Bin 0 -> 163 bytes scribus/doc/it/images/colormanager2.png | Bin 0 -> 13336 bytes scribus/doc/it/images/colorwheel.png | Bin 0 -> 55025 bytes scribus/doc/it/images/colrs-caricature.png | Bin 0 -> 24146 bytes scribus/doc/it/images/colrs-mgt1.png | Bin 0 -> 24987 bytes scribus/doc/it/images/colrs-mgt2.png | Bin 0 -> 7079 bytes scribus/doc/it/images/combine_polygons.png | Bin 0 -> 8557 bytes scribus/doc/it/images/combine_polygons1.png | Bin 0 -> 9878 bytes scribus/doc/it/images/combine_polygons2.png | Bin 0 -> 9599 bytes scribus/doc/it/images/combine_polygons3.png | Bin 0 -> 8182 bytes scribus/doc/it/images/combine_polygons4.png | Bin 0 -> 24720 bytes scribus/doc/it/images/combine_polygons5.png | Bin 0 -> 9445 bytes scribus/doc/it/images/context_shape.png | Bin 0 -> 10481 bytes scribus/doc/it/images/contourline_flow.png | Bin 0 -> 43417 bytes scribus/doc/it/images/cw-analogous.png | Bin 0 -> 14031 bytes scribus/doc/it/images/cw-compl.png | Bin 0 -> 13872 bytes scribus/doc/it/images/cw-splitcompl.png | Bin 0 -> 13863 bytes scribus/doc/it/images/cw-tetradic.png | Bin 0 -> 13890 bytes scribus/doc/it/images/cw-triadic.png | Bin 0 -> 13896 bytes scribus/doc/it/images/cw-warning.png | Bin 0 -> 14515 bytes scribus/doc/it/images/docheader1.png | Bin 0 -> 8740 bytes scribus/doc/it/images/docheader2.png | Bin 0 -> 10648 bytes scribus/doc/it/images/dtp-studio.png | Bin 0 -> 41247 bytes scribus/doc/it/images/duotone-imp.png | Bin 0 -> 134043 bytes scribus/doc/it/images/duotone-imp2.png | Bin 0 -> 116050 bytes scribus/doc/it/images/edit_shapes.png | Bin 0 -> 85328 bytes scribus/doc/it/images/editcols1.png | Bin 0 -> 18516 bytes scribus/doc/it/images/editcols1a.png | Bin 0 -> 22316 bytes scribus/doc/it/images/editcols2.png | Bin 0 -> 24069 bytes scribus/doc/it/images/editcols3.png | Bin 0 -> 7533 bytes scribus/doc/it/images/eps-imp1.png | Bin 0 -> 82755 bytes scribus/doc/it/images/eps-imp2.png | Bin 0 -> 21044 bytes scribus/doc/it/images/eps-imp3.png | Bin 0 -> 18561 bytes scribus/doc/it/images/eps-imp4.png | Bin 0 -> 22374 bytes scribus/doc/it/images/eps-imp5.png | Bin 0 -> 48171 bytes scribus/doc/it/images/file-error1.png | Bin 0 -> 34725 bytes scribus/doc/it/images/file-error2.png | Bin 0 -> 32727 bytes scribus/doc/it/images/file-error3.png | Bin 0 -> 27189 bytes scribus/doc/it/images/fileimport.png | Bin 0 -> 36747 bytes scribus/doc/it/images/fontmatrix.png | Bin 0 -> 231399 bytes scribus/doc/it/images/fonts.png | Bin 0 -> 69351 bytes scribus/doc/it/images/fonts2.png | Bin 0 -> 115874 bytes scribus/doc/it/images/frame_shape_flow.png | Bin 0 -> 45657 bytes scribus/doc/it/images/geometry.png | Bin 0 -> 9753 bytes scribus/doc/it/images/geometry1.png | Bin 0 -> 8739 bytes scribus/doc/it/images/gimpoptions1.png | Bin 0 -> 143006 bytes scribus/doc/it/images/gimpoptions2.png | Bin 0 -> 143734 bytes scribus/doc/it/images/gimpoptions3.png | Bin 0 -> 130374 bytes scribus/doc/it/images/givelife1.png | Bin 0 -> 65422 bytes scribus/doc/it/images/gradient_adjuster.png | Bin 0 -> 2894 bytes scribus/doc/it/images/gradient_adjuster1.png | Bin 0 -> 2900 bytes scribus/doc/it/images/gradient_adjuster_vector.png | Bin 0 -> 31792 bytes scribus/doc/it/images/htmlimport.png | Bin 0 -> 49834 bytes scribus/doc/it/images/htmlstyle.png | Bin 0 -> 20211 bytes scribus/doc/it/images/import-pdfimage.png | Bin 0 -> 4689 bytes scribus/doc/it/images/ink-cov.png | Bin 0 -> 97296 bytes scribus/doc/it/images/insert-frame-1.png | Bin 0 -> 23260 bytes scribus/doc/it/images/insert-frame-2.png | Bin 0 -> 19156 bytes scribus/doc/it/images/krita1.jpg | Bin 0 -> 159473 bytes scribus/doc/it/images/layers1.png | Bin 0 -> 15325 bytes scribus/doc/it/images/layers2.png | Bin 0 -> 21929 bytes scribus/doc/it/images/lilyp.png | Bin 0 -> 58183 bytes scribus/doc/it/images/line_tab.png | Bin 0 -> 5136 bytes scribus/doc/it/images/line_tab1.png | Bin 0 -> 7901 bytes scribus/doc/it/images/line_tab2.png | Bin 0 -> 2948 bytes scribus/doc/it/images/line_tab3.png | Bin 0 -> 5834 bytes scribus/doc/it/images/line_tab4.png | Bin 0 -> 4724 bytes scribus/doc/it/images/line_tab5.png | Bin 0 -> 13194 bytes scribus/doc/it/images/line_tab6.png | Bin 0 -> 25955 bytes scribus/doc/it/images/line_tab7.png | Bin 0 -> 17549 bytes scribus/doc/it/images/lprof.png | Bin 0 -> 75651 bytes scribus/doc/it/images/missing-gs.png | Bin 0 -> 48074 bytes scribus/doc/it/images/mpage1.png | Bin 0 -> 9640 bytes scribus/doc/it/images/mpage2.png | Bin 0 -> 19907 bytes scribus/doc/it/images/mpage3.png | Bin 0 -> 12009 bytes scribus/doc/it/images/mpage4.png | Bin 0 -> 16730 bytes scribus/doc/it/images/mpage5.png | Bin 0 -> 22307 bytes scribus/doc/it/images/multipledup_copies.png | Bin 0 -> 20602 bytes scribus/doc/it/images/multipledup_rotation.png | Bin 0 -> 201255 bytes scribus/doc/it/images/multipledup_rows.png | Bin 0 -> 16531 bytes scribus/doc/it/images/new1.png | Bin 0 -> 30942 bytes scribus/doc/it/images/new2.png | Bin 0 -> 41594 bytes scribus/doc/it/images/new3.png | Bin 0 -> 72149 bytes scribus/doc/it/images/new4.png | Bin 0 -> 354444 bytes scribus/doc/it/images/new5.png | Bin 0 -> 26292 bytes scribus/doc/it/images/new6.png | Bin 0 -> 93558 bytes scribus/doc/it/images/node_edit_close.png | Bin 0 -> 20234 bytes scribus/doc/it/images/nodes_edit.png | Bin 0 -> 25858 bytes scribus/doc/it/images/numb-sections.png | Bin 0 -> 40754 bytes scribus/doc/it/images/oogettext1.png | Bin 0 -> 14730 bytes scribus/doc/it/images/patterns1.png | Bin 0 -> 100809 bytes scribus/doc/it/images/patterns2.png | Bin 0 -> 38597 bytes scribus/doc/it/images/pdf-form-ht1.png | Bin 0 -> 21722 bytes scribus/doc/it/images/pdf-form-ht2.png | Bin 0 -> 4030 bytes scribus/doc/it/images/pdf-form-ht3.png | Bin 0 -> 21241 bytes scribus/doc/it/images/pdf-form-ht4.png | Bin 0 -> 22134 bytes scribus/doc/it/images/pdf-form-ht5.png | Bin 0 -> 26682 bytes scribus/doc/it/images/pdf-form-ht6.png | Bin 0 -> 23053 bytes scribus/doc/it/images/pdfx1a-lo.png | Bin 0 -> 42952 bytes scribus/doc/it/images/pdfx3-1.png | Bin 0 -> 56637 bytes scribus/doc/it/images/pdfxcolor.png | Bin 0 -> 39778 bytes scribus/doc/it/images/pdfxintent.png | Bin 0 -> 42609 bytes scribus/doc/it/images/plot1.png | Bin 16419 -> 19153 bytes scribus/doc/it/images/plot2.png | Bin 17760 -> 21640 bytes scribus/doc/it/images/polygons.png | Bin 0 -> 15587 bytes scribus/doc/it/images/polygons1.png | Bin 0 -> 23305 bytes scribus/doc/it/images/povray.png | Bin 0 -> 42795 bytes scribus/doc/it/images/preflight-v.png | Bin 0 -> 35086 bytes scribus/doc/it/images/prefs-mac-1.png | Bin 0 -> 58690 bytes scribus/doc/it/images/prefs_9parts.png | Bin 0 -> 528 bytes scribus/doc/it/images/prefs_document1.png | Bin 0 -> 207803 bytes scribus/doc/it/images/prefs_fibonacci.png | Bin 0 -> 528 bytes scribus/doc/it/images/prefs_goldenmean.png | Bin 0 -> 529 bytes scribus/doc/it/images/prefs_guides1.png | Bin 0 -> 3162 bytes scribus/doc/it/images/prefs_gutenberg.png | Bin 0 -> 528 bytes scribus/doc/it/images/prefs_magazine.png | Bin 0 -> 527 bytes scribus/doc/it/images/print-dialog1.png | Bin 0 -> 38242 bytes scribus/doc/it/images/print-dialog2.png | Bin 0 -> 70332 bytes scribus/doc/it/images/printer2.png | Bin 0 -> 11452 bytes scribus/doc/it/images/printpreview.png | Bin 0 -> 201625 bytes scribus/doc/it/images/prop_shape.png | Bin 0 -> 15563 bytes scribus/doc/it/images/qsg-col1.png | Bin 0 -> 59645 bytes scribus/doc/it/images/qsg-col2.png | Bin 0 -> 56127 bytes scribus/doc/it/images/register.png | Bin 0 -> 202 bytes scribus/doc/it/images/resene-pal.png | Bin 0 -> 65837 bytes scribus/doc/it/images/result.png | Bin 0 -> 18380 bytes scribus/doc/it/images/rf-error1.png | Bin 0 -> 3826 bytes scribus/doc/it/images/rf2.png | Bin 0 -> 3454 bytes scribus/doc/it/images/rf3.png | Bin 0 -> 30472 bytes scribus/doc/it/images/rf5.png | Bin 47139 -> 53886 bytes scribus/doc/it/images/rf6.png | Bin 40209 -> 46449 bytes scribus/doc/it/images/rf7.png | Bin 37750 -> 41913 bytes scribus/doc/it/images/rgb-cmyk.png | Bin 0 -> 92971 bytes scribus/doc/it/images/rgb.png | Bin 0 -> 89 bytes scribus/doc/it/images/round_rectangle.png | Bin 0 -> 5315 bytes scribus/doc/it/images/sadie4by2b.png | Bin 0 -> 134431 bytes scribus/doc/it/images/scribus-os2.png | Bin 0 -> 199497 bytes scribus/doc/it/images/scribus-pres1.png | Bin 0 -> 92545 bytes scribus/doc/it/images/scribus-pres2.png | Bin 0 -> 80944 bytes scribus/doc/it/images/shape_edit.png | Bin 0 -> 3441 bytes scribus/doc/it/images/shapes8.png | Bin 0 -> 31489 bytes scribus/doc/it/images/skewing.png | Bin 0 -> 12077 bytes scribus/doc/it/images/spot.png | Bin 0 -> 272 bytes scribus/doc/it/images/squat_tux.png | Bin 0 -> 15323 bytes scribus/doc/it/images/style_manager7.png | Bin 0 -> 62322 bytes scribus/doc/it/images/style_manager8.png | Bin 0 -> 88998 bytes scribus/doc/it/images/swdialog.png | Bin 0 -> 16350 bytes scribus/doc/it/images/table-import-1.png | Bin 0 -> 64570 bytes scribus/doc/it/images/table-import-2.png | Bin 0 -> 24397 bytes scribus/doc/it/images/table-import-3.png | Bin 0 -> 76149 bytes scribus/doc/it/images/tb-bookbinder.png | Bin 0 -> 72011 bytes scribus/doc/it/images/tb-gsview.png | Bin 0 -> 166541 bytes scribus/doc/it/images/tb-inkscape.png | Bin 0 -> 216201 bytes scribus/doc/it/images/tb-jpdf.png | Bin 0 -> 7286 bytes scribus/doc/it/images/tb-libreoffice.png | Bin 0 -> 162116 bytes scribus/doc/it/images/tb-pdf-imp.png | Bin 0 -> 30494 bytes scribus/doc/it/images/text-frame-link.png | Bin 0 -> 654 bytes scribus/doc/it/images/text-frame-unlink.png | Bin 0 -> 759 bytes scribus/doc/it/images/text_flow.png | Bin 0 -> 98515 bytes scribus/doc/it/images/text_tab11.png | Bin 0 -> 15523 bytes scribus/doc/it/images/text_tab11b.png | Bin 0 -> 53917 bytes scribus/doc/it/images/text_tab12.png | Bin 0 -> 15279 bytes scribus/doc/it/images/text_tab2.png | Bin 0 -> 56349 bytes scribus/doc/it/images/text_tab4.png | Bin 0 -> 8150 bytes scribus/doc/it/images/text_tab5.png | Bin 0 -> 9723 bytes scribus/doc/it/images/text_tab6.png | Bin 0 -> 1074 bytes scribus/doc/it/images/text_tab7.png | Bin 0 -> 5990 bytes scribus/doc/it/images/text_tab7a.png | Bin 0 -> 73363 bytes scribus/doc/it/images/text_tab7b.png | Bin 0 -> 37477 bytes scribus/doc/it/images/text_tab8.png | Bin 0 -> 6179 bytes scribus/doc/it/images/text_tab9.png | Bin 0 -> 6034 bytes scribus/doc/it/images/transform_dialogb.png | Bin 0 -> 75237 bytes .../doc/it/images/transform_translaterotation.png | Bin 0 -> 180545 bytes .../doc/it/images/transform_translaterotation1.png | Bin 0 -> 7337 bytes .../doc/it/images/transform_translatescaling.png | Bin 0 -> 60019 bytes .../doc/it/images/transform_translateskewing.png | Bin 0 -> 154493 bytes .../doc/it/images/transform_translateskewing1.png | Bin 0 -> 151320 bytes scribus/doc/it/images/vectimp1.png | Bin 0 -> 16884 bytes scribus/doc/it/images/vectimp2.png | Bin 0 -> 197540 bytes scribus/doc/it/images/vectimp3.png | Bin 0 -> 46949 bytes scribus/doc/it/images/vectimp4.png | Bin 0 -> 18308 bytes scribus/doc/it/images/vectimp5.png | Bin 0 -> 36759 bytes scribus/doc/it/images/vector-advanced.png | Bin 0 -> 20176 bytes scribus/doc/it/images/vector-clipart.png | Bin 0 -> 30603 bytes scribus/doc/it/images/xnview.png | Bin 0 -> 28503 bytes scribus/doc/it/importhints4.html | 24 +- scribus/doc/it/install-dpkg.html | 189 ++ scribus/doc/it/install1.html | 37 + scribus/doc/it/install2.html | 49 + scribus/doc/it/install3.html | 59 + scribus/doc/it/install4.html | 126 + scribus/doc/it/install5.html | 79 + scribus/doc/it/irc.html | 42 + scribus/doc/it/lipsum.html | 33 + scribus/doc/it/mailing_lists.html | 195 ++ scribus/doc/it/menu.xml | 37 +- scribus/doc/it/moncal.html | 91 + scribus/doc/it/pdfexport2.html | 2 +- scribus/doc/it/plugin_howto.html | 322 +++ scribus/doc/it/print1.html | 24 + scribus/doc/it/print2.html | 56 + scribus/doc/it/print3.html | 21 + scribus/doc/it/print4.html | 22 + scribus/doc/it/readme-macosx.html | 26 + scribus/doc/it/readme-os2.html | 48 + scribus/doc/it/readme-win32.html | 29 + scribus/doc/it/readme.html | 216 ++ scribus/doc/it/releases.html | 51 + scribus/doc/it/scribuscopyright.html | 33 + scribus/doc/it/scribusfileformat.html | 2987 ++++++++++++++++++++ scribus/doc/it/scripter-extensions.html | 360 +++ scribus/doc/it/scripter-faq.html | 133 + scribus/doc/it/scripter1.html | 28 + scribus/doc/it/scripterapi-ImageExport.html | 65 + scribus/doc/it/scripterapi-PDFfile.html | 206 ++ scribus/doc/it/scripterapi-Printer.html | 89 + scribus/doc/it/scripterapi-color.html | 63 + scribus/doc/it/scripterapi-constants.html | 203 ++ scribus/doc/it/scripterapi-dialogs.html | 85 + scribus/doc/it/scripterapi-doc.html | 162 ++ scribus/doc/it/scripterapi-extensions.html | 41 + scribus/doc/it/scripterapi-font.html | 26 + scribus/doc/it/scripterapi-getobjprop.html | 89 + scribus/doc/it/scripterapi-layer.html | 109 + scribus/doc/it/scripterapi-manobj.html | 71 + scribus/doc/it/scripterapi-object.html | 141 + scribus/doc/it/scripterapi-page.html | 118 + scribus/doc/it/scripterapi-select.html | 37 + scribus/doc/it/scripterapi-setobjprop.html | 116 + scribus/doc/it/scripterapi-textframes.html | 163 ++ scribus/doc/it/scripterapi.html | 120 + scribus/doc/it/short-words.html | 2 +- scribus/doc/it/specs.html | 540 ++++ scribus/doc/it/toolbox.html | 12 + scribus/doc/it/toolbox1.html | 23 + scribus/doc/it/toolbox12.html | 39 + scribus/doc/it/toolbox13.html | 16 + scribus/doc/it/toolbox14.html | 13 + scribus/doc/it/toolbox15.html | 12 + scribus/doc/it/toolbox16.html | 15 + scribus/doc/it/toolbox17.html | 21 + scribus/doc/it/toolbox18.html | 25 + scribus/doc/it/toolbox19.html | 98 + scribus/doc/it/toolbox2.html | 28 + scribus/doc/it/toolbox3.html | 15 + scribus/doc/it/toolbox4.html | 31 + scribus/doc/it/toolbox5.html | 34 + scribus/doc/it/toolbox6.html | 49 + scribus/doc/it/toolbox7.html | 95 + scribus/doc/it/toolbox8.html | 16 + scribus/doc/it/toolbox9.html | 20 + scribus/doc/it/topten.html | 56 + scribus/doc/it/translation_howto.html | 86 + scribus/doc/it/tutorials.html | 12 + scribus/doc/it/workspace1.html | 71 + 323 files changed, 10087 insertions(+), 48 deletions(-) create mode 100644 scribus/doc/it/about1.html create mode 100644 scribus/doc/it/bugreport.html create mode 100644 scribus/doc/it/cms.html create mode 100644 scribus/doc/it/cms2.html create mode 100644 scribus/doc/it/cms3.html create mode 100644 scribus/doc/it/codingstandards.html create mode 100644 scribus/doc/it/color7.html create mode 100644 scribus/doc/it/colorwheel.html create mode 100644 scribus/doc/it/contributions.html create mode 100644 scribus/doc/it/developers.html create mode 100644 scribus/doc/it/doccopyright.html create mode 100644 scribus/doc/it/download.html create mode 100644 scribus/doc/it/editorial.html create mode 100644 scribus/doc/it/faq1.html create mode 100644 scribus/doc/it/faq3.html create mode 100644 scribus/doc/it/fileproblems.html create mode 100644 scribus/doc/it/gettexthowto.html create mode 100644 scribus/doc/it/gsview.html create mode 100644 scribus/doc/it/images/Cover_en1-page1.png create mode 100644 scribus/doc/it/images/DrawLatexFrame.png create mode 100644 scribus/doc/it/images/Mantis_my_view.png create mode 100644 scribus/doc/it/images/Mantis_new_report1.png create mode 100644 scribus/doc/it/images/Mantis_new_report2.png create mode 100644 scribus/doc/it/images/Mantis_new_report3.png create mode 100644 scribus/doc/it/images/Mantis_searching.png create mode 100644 scribus/doc/it/images/Mantis_signup.png create mode 100644 scribus/doc/it/images/RYB_color_wheel.png create mode 100755 scribus/doc/it/images/Rembrandt1.png create mode 100755 scribus/doc/it/images/Rembrandt10.png create mode 100755 scribus/doc/it/images/Rembrandt11.png create mode 100755 scribus/doc/it/images/Rembrandt12.png create mode 100755 scribus/doc/it/images/Rembrandt13.png create mode 100755 scribus/doc/it/images/Rembrandt14.png create mode 100755 scribus/doc/it/images/Rembrandt15.png create mode 100755 scribus/doc/it/images/Rembrandt16.png create mode 100755 scribus/doc/it/images/Rembrandt17.png create mode 100755 scribus/doc/it/images/Rembrandt17a.png create mode 100755 scribus/doc/it/images/Rembrandt17b.png create mode 100755 scribus/doc/it/images/Rembrandt18.png create mode 100755 scribus/doc/it/images/Rembrandt18b.png create mode 100755 scribus/doc/it/images/Rembrandt19.png create mode 100755 scribus/doc/it/images/Rembrandt2.png create mode 100755 scribus/doc/it/images/Rembrandt20.png create mode 100755 scribus/doc/it/images/Rembrandt21.png create mode 100755 scribus/doc/it/images/Rembrandt3.png create mode 100755 scribus/doc/it/images/Rembrandt4.png create mode 100755 scribus/doc/it/images/Rembrandt5.png create mode 100755 scribus/doc/it/images/Rembrandt6.png create mode 100755 scribus/doc/it/images/Rembrandt7.png create mode 100755 scribus/doc/it/images/Rembrandt8.png create mode 100755 scribus/doc/it/images/Rembrandt9.png create mode 100644 scribus/doc/it/images/Scripter.png create mode 100644 scribus/doc/it/images/SwB.png create mode 100644 scribus/doc/it/images/alert.png create mode 100644 scribus/doc/it/images/batik1.png create mode 100755 scribus/doc/it/images/boundingbox.png create mode 100755 scribus/doc/it/images/boundingbox1.png create mode 100644 scribus/doc/it/images/cms-gamut1.png create mode 100644 scribus/doc/it/images/cms-gamut2.png create mode 100644 scribus/doc/it/images/cmsmodify1.png create mode 100644 scribus/doc/it/images/cmyk.png create mode 100644 scribus/doc/it/images/colormanager2.png create mode 100644 scribus/doc/it/images/colorwheel.png create mode 100644 scribus/doc/it/images/colrs-caricature.png create mode 100644 scribus/doc/it/images/colrs-mgt1.png create mode 100644 scribus/doc/it/images/colrs-mgt2.png create mode 100755 scribus/doc/it/images/combine_polygons.png create mode 100755 scribus/doc/it/images/combine_polygons1.png create mode 100755 scribus/doc/it/images/combine_polygons2.png create mode 100755 scribus/doc/it/images/combine_polygons3.png create mode 100755 scribus/doc/it/images/combine_polygons4.png create mode 100755 scribus/doc/it/images/combine_polygons5.png create mode 100644 scribus/doc/it/images/context_shape.png create mode 100755 scribus/doc/it/images/contourline_flow.png create mode 100644 scribus/doc/it/images/cw-analogous.png create mode 100644 scribus/doc/it/images/cw-compl.png create mode 100644 scribus/doc/it/images/cw-splitcompl.png create mode 100644 scribus/doc/it/images/cw-tetradic.png create mode 100644 scribus/doc/it/images/cw-triadic.png create mode 100644 scribus/doc/it/images/cw-warning.png create mode 100755 scribus/doc/it/images/docheader1.png create mode 100755 scribus/doc/it/images/docheader2.png create mode 100644 scribus/doc/it/images/dtp-studio.png create mode 100644 scribus/doc/it/images/duotone-imp.png create mode 100644 scribus/doc/it/images/duotone-imp2.png create mode 100755 scribus/doc/it/images/edit_shapes.png create mode 100644 scribus/doc/it/images/editcols1.png create mode 100644 scribus/doc/it/images/editcols1a.png create mode 100644 scribus/doc/it/images/editcols2.png create mode 100644 scribus/doc/it/images/editcols3.png create mode 100644 scribus/doc/it/images/eps-imp1.png create mode 100644 scribus/doc/it/images/eps-imp2.png create mode 100644 scribus/doc/it/images/eps-imp3.png create mode 100644 scribus/doc/it/images/eps-imp4.png create mode 100644 scribus/doc/it/images/eps-imp5.png create mode 100644 scribus/doc/it/images/file-error1.png create mode 100644 scribus/doc/it/images/file-error2.png create mode 100644 scribus/doc/it/images/file-error3.png create mode 100644 scribus/doc/it/images/fileimport.png create mode 100644 scribus/doc/it/images/fontmatrix.png create mode 100644 scribus/doc/it/images/fonts.png create mode 100644 scribus/doc/it/images/fonts2.png create mode 100755 scribus/doc/it/images/frame_shape_flow.png create mode 100644 scribus/doc/it/images/geometry.png create mode 100644 scribus/doc/it/images/geometry1.png create mode 100644 scribus/doc/it/images/gimpoptions1.png create mode 100644 scribus/doc/it/images/gimpoptions2.png create mode 100644 scribus/doc/it/images/gimpoptions3.png create mode 100644 scribus/doc/it/images/givelife1.png create mode 100644 scribus/doc/it/images/gradient_adjuster.png create mode 100644 scribus/doc/it/images/gradient_adjuster1.png create mode 100644 scribus/doc/it/images/gradient_adjuster_vector.png create mode 100644 scribus/doc/it/images/htmlimport.png create mode 100644 scribus/doc/it/images/htmlstyle.png create mode 100644 scribus/doc/it/images/import-pdfimage.png create mode 100644 scribus/doc/it/images/ink-cov.png create mode 100644 scribus/doc/it/images/insert-frame-1.png create mode 100644 scribus/doc/it/images/insert-frame-2.png create mode 100644 scribus/doc/it/images/krita1.jpg create mode 100644 scribus/doc/it/images/layers1.png create mode 100644 scribus/doc/it/images/layers2.png create mode 100644 scribus/doc/it/images/lilyp.png create mode 100755 scribus/doc/it/images/line_tab.png create mode 100755 scribus/doc/it/images/line_tab1.png create mode 100755 scribus/doc/it/images/line_tab2.png create mode 100644 scribus/doc/it/images/line_tab3.png create mode 100755 scribus/doc/it/images/line_tab4.png create mode 100755 scribus/doc/it/images/line_tab5.png create mode 100644 scribus/doc/it/images/line_tab6.png create mode 100644 scribus/doc/it/images/line_tab7.png create mode 100644 scribus/doc/it/images/lprof.png create mode 100644 scribus/doc/it/images/missing-gs.png create mode 100644 scribus/doc/it/images/mpage1.png create mode 100644 scribus/doc/it/images/mpage2.png create mode 100644 scribus/doc/it/images/mpage3.png create mode 100644 scribus/doc/it/images/mpage4.png create mode 100644 scribus/doc/it/images/mpage5.png create mode 100644 scribus/doc/it/images/multipledup_copies.png create mode 100644 scribus/doc/it/images/multipledup_rotation.png create mode 100644 scribus/doc/it/images/multipledup_rows.png create mode 100644 scribus/doc/it/images/new1.png create mode 100644 scribus/doc/it/images/new2.png create mode 100644 scribus/doc/it/images/new3.png create mode 100644 scribus/doc/it/images/new4.png create mode 100644 scribus/doc/it/images/new5.png create mode 100644 scribus/doc/it/images/new6.png create mode 100644 scribus/doc/it/images/node_edit_close.png create mode 100644 scribus/doc/it/images/nodes_edit.png create mode 100644 scribus/doc/it/images/numb-sections.png create mode 100644 scribus/doc/it/images/oogettext1.png create mode 100644 scribus/doc/it/images/patterns1.png create mode 100644 scribus/doc/it/images/patterns2.png create mode 100644 scribus/doc/it/images/pdf-form-ht1.png create mode 100644 scribus/doc/it/images/pdf-form-ht2.png create mode 100644 scribus/doc/it/images/pdf-form-ht3.png create mode 100644 scribus/doc/it/images/pdf-form-ht4.png create mode 100644 scribus/doc/it/images/pdf-form-ht5.png create mode 100644 scribus/doc/it/images/pdf-form-ht6.png create mode 100644 scribus/doc/it/images/pdfx1a-lo.png create mode 100644 scribus/doc/it/images/pdfx3-1.png create mode 100644 scribus/doc/it/images/pdfxcolor.png create mode 100644 scribus/doc/it/images/pdfxintent.png create mode 100644 scribus/doc/it/images/polygons.png create mode 100755 scribus/doc/it/images/polygons1.png create mode 100644 scribus/doc/it/images/povray.png create mode 100644 scribus/doc/it/images/preflight-v.png create mode 100644 scribus/doc/it/images/prefs-mac-1.png create mode 100755 scribus/doc/it/images/prefs_9parts.png create mode 100755 scribus/doc/it/images/prefs_document1.png create mode 100755 scribus/doc/it/images/prefs_fibonacci.png create mode 100755 scribus/doc/it/images/prefs_goldenmean.png create mode 100755 scribus/doc/it/images/prefs_guides1.png create mode 100755 scribus/doc/it/images/prefs_gutenberg.png create mode 100755 scribus/doc/it/images/prefs_magazine.png create mode 100644 scribus/doc/it/images/print-dialog1.png create mode 100644 scribus/doc/it/images/print-dialog2.png create mode 100644 scribus/doc/it/images/printer2.png create mode 100644 scribus/doc/it/images/printpreview.png create mode 100644 scribus/doc/it/images/prop_shape.png create mode 100644 scribus/doc/it/images/qsg-col1.png create mode 100644 scribus/doc/it/images/qsg-col2.png create mode 100644 scribus/doc/it/images/register.png create mode 100644 scribus/doc/it/images/resene-pal.png create mode 100644 scribus/doc/it/images/result.png create mode 100644 scribus/doc/it/images/rf-error1.png create mode 100644 scribus/doc/it/images/rf2.png create mode 100644 scribus/doc/it/images/rf3.png create mode 100644 scribus/doc/it/images/rgb-cmyk.png create mode 100644 scribus/doc/it/images/rgb.png create mode 100755 scribus/doc/it/images/round_rectangle.png create mode 100644 scribus/doc/it/images/sadie4by2b.png create mode 100644 scribus/doc/it/images/scribus-os2.png create mode 100644 scribus/doc/it/images/scribus-pres1.png create mode 100644 scribus/doc/it/images/scribus-pres2.png create mode 100755 scribus/doc/it/images/shape_edit.png create mode 100755 scribus/doc/it/images/shapes8.png create mode 100755 scribus/doc/it/images/skewing.png create mode 100644 scribus/doc/it/images/spot.png create mode 100755 scribus/doc/it/images/squat_tux.png create mode 100755 scribus/doc/it/images/style_manager7.png create mode 100755 scribus/doc/it/images/style_manager8.png create mode 100644 scribus/doc/it/images/swdialog.png create mode 100644 scribus/doc/it/images/table-import-1.png create mode 100644 scribus/doc/it/images/table-import-2.png create mode 100644 scribus/doc/it/images/table-import-3.png create mode 100644 scribus/doc/it/images/tb-bookbinder.png create mode 100644 scribus/doc/it/images/tb-gsview.png create mode 100644 scribus/doc/it/images/tb-inkscape.png create mode 100644 scribus/doc/it/images/tb-jpdf.png create mode 100644 scribus/doc/it/images/tb-libreoffice.png create mode 100644 scribus/doc/it/images/tb-pdf-imp.png create mode 100755 scribus/doc/it/images/text-frame-link.png create mode 100755 scribus/doc/it/images/text-frame-unlink.png create mode 100755 scribus/doc/it/images/text_flow.png create mode 100755 scribus/doc/it/images/text_tab11.png create mode 100755 scribus/doc/it/images/text_tab11b.png create mode 100755 scribus/doc/it/images/text_tab12.png create mode 100755 scribus/doc/it/images/text_tab2.png create mode 100755 scribus/doc/it/images/text_tab4.png create mode 100755 scribus/doc/it/images/text_tab5.png create mode 100755 scribus/doc/it/images/text_tab6.png create mode 100755 scribus/doc/it/images/text_tab7.png create mode 100755 scribus/doc/it/images/text_tab7a.png create mode 100755 scribus/doc/it/images/text_tab7b.png create mode 100755 scribus/doc/it/images/text_tab8.png create mode 100755 scribus/doc/it/images/text_tab9.png create mode 100644 scribus/doc/it/images/transform_dialogb.png create mode 100644 scribus/doc/it/images/transform_translaterotation.png create mode 100644 scribus/doc/it/images/transform_translaterotation1.png create mode 100644 scribus/doc/it/images/transform_translatescaling.png create mode 100644 scribus/doc/it/images/transform_translateskewing.png create mode 100644 scribus/doc/it/images/transform_translateskewing1.png create mode 100644 scribus/doc/it/images/vectimp1.png create mode 100644 scribus/doc/it/images/vectimp2.png create mode 100644 scribus/doc/it/images/vectimp3.png create mode 100644 scribus/doc/it/images/vectimp4.png create mode 100644 scribus/doc/it/images/vectimp5.png create mode 100644 scribus/doc/it/images/vector-advanced.png create mode 100644 scribus/doc/it/images/vector-clipart.png create mode 100644 scribus/doc/it/images/xnview.png create mode 100644 scribus/doc/it/install-dpkg.html create mode 100644 scribus/doc/it/install1.html create mode 100644 scribus/doc/it/install2.html create mode 100644 scribus/doc/it/install3.html create mode 100644 scribus/doc/it/install4.html create mode 100644 scribus/doc/it/install5.html create mode 100644 scribus/doc/it/irc.html create mode 100644 scribus/doc/it/lipsum.html create mode 100644 scribus/doc/it/mailing_lists.html create mode 100644 scribus/doc/it/moncal.html create mode 100644 scribus/doc/it/plugin_howto.html create mode 100644 scribus/doc/it/print1.html create mode 100644 scribus/doc/it/print2.html create mode 100644 scribus/doc/it/print3.html create mode 100644 scribus/doc/it/print4.html create mode 100644 scribus/doc/it/readme-macosx.html create mode 100644 scribus/doc/it/readme-os2.html create mode 100644 scribus/doc/it/readme-win32.html create mode 100644 scribus/doc/it/readme.html create mode 100644 scribus/doc/it/releases.html create mode 100644 scribus/doc/it/scribuscopyright.html create mode 100644 scribus/doc/it/scribusfileformat.html create mode 100644 scribus/doc/it/scripter-extensions.html create mode 100644 scribus/doc/it/scripter-faq.html create mode 100644 scribus/doc/it/scripter1.html create mode 100644 scribus/doc/it/scripterapi-ImageExport.html create mode 100644 scribus/doc/it/scripterapi-PDFfile.html create mode 100644 scribus/doc/it/scripterapi-Printer.html create mode 100644 scribus/doc/it/scripterapi-color.html create mode 100644 scribus/doc/it/scripterapi-constants.html create mode 100644 scribus/doc/it/scripterapi-dialogs.html create mode 100644 scribus/doc/it/scripterapi-doc.html create mode 100644 scribus/doc/it/scripterapi-extensions.html create mode 100644 scribus/doc/it/scripterapi-font.html create mode 100644 scribus/doc/it/scripterapi-getobjprop.html create mode 100644 scribus/doc/it/scripterapi-layer.html create mode 100644 scribus/doc/it/scripterapi-manobj.html create mode 100644 scribus/doc/it/scripterapi-object.html create mode 100644 scribus/doc/it/scripterapi-page.html create mode 100644 scribus/doc/it/scripterapi-select.html create mode 100644 scribus/doc/it/scripterapi-setobjprop.html create mode 100644 scribus/doc/it/scripterapi-textframes.html create mode 100644 scribus/doc/it/scripterapi.html create mode 100644 scribus/doc/it/specs.html create mode 100644 scribus/doc/it/toolbox.html create mode 100644 scribus/doc/it/toolbox1.html create mode 100644 scribus/doc/it/toolbox12.html create mode 100644 scribus/doc/it/toolbox13.html create mode 100644 scribus/doc/it/toolbox14.html create mode 100644 scribus/doc/it/toolbox15.html create mode 100644 scribus/doc/it/toolbox16.html create mode 100644 scribus/doc/it/toolbox17.html create mode 100644 scribus/doc/it/toolbox18.html create mode 100644 scribus/doc/it/toolbox19.html create mode 100644 scribus/doc/it/toolbox2.html create mode 100644 scribus/doc/it/toolbox3.html create mode 100644 scribus/doc/it/toolbox4.html create mode 100644 scribus/doc/it/toolbox5.html create mode 100644 scribus/doc/it/toolbox6.html create mode 100644 scribus/doc/it/toolbox7.html create mode 100644 scribus/doc/it/toolbox8.html create mode 100644 scribus/doc/it/toolbox9.html create mode 100644 scribus/doc/it/topten.html create mode 100644 scribus/doc/it/translation_howto.html create mode 100644 scribus/doc/it/tutorials.html create mode 100644 scribus/doc/it/workspace1.html (limited to 'scribus/doc') diff --git a/scribus/doc/it/WwFill.html b/scribus/doc/it/WwFill.html index 0c2c74c..a2b3706 100644 --- a/scribus/doc/it/WwFill.html +++ b/scribus/doc/it/WwFill.html @@ -22,7 +22,7 @@
  • sfumatura radiale libera

    • -

    Se scegliete una delle sfumature, si apre il selettore delle sfumature, che inizialmente ha soltanto due punti di cambiamento del colore, entrambi neri, alle estremità del selettore. La freccia rossa indica il punto di cambiamento selezionato; potete sceglierne un altro con il mouse. Il punto di cambiamento selezionato è quello a cui vengono applicate le scelte per colore, tonalità e opacità. Potete spostare il punto di cambiamento trascinandolo col mouse oppure con la casella di controllo “Posizione”. Sono sempre presenti almeno due punti di cambiamento, ma potete aggiungerne quanti ne volete, e potete modificare le proprietà di ciascuno di essi in modo indipendente da quelle degli altri. Quando il cursore del mouse si trova nello spazio sottostante la barra orizzontale che mostra la sfumatura, vicino a esso appare un segno + e facendo clic vine creato un nuovo punto di cambiamento, che sarà anche quello attivo. Potete eliminare un punto di cambiamento facendo clic su di esso e trascinandolo con il mouse verso il basso; se lo trascinate in altre direzioni non riuscirete mai a farlo sparire.

    +

    Se scegliete una delle sfumature, si apre il selettore delle sfumature, che inizialmente ha soltanto due punti di cambiamento del colore, entrambi neri, alle estremità del selettore. La freccia rossa indica il punto di cambiamento selezionato; potete sceglierne un altro con il mouse. Il punto di cambiamento selezionato è quello a cui vengono applicate le scelte per colore, tonalità e opacità. Potete spostare il punto di cambiamento trascinandolo col mouse oppure con la casella di controllo “Posizione”. Sono sempre presenti almeno due punti di cambiamento, ma potete aggiungerne quanti ne volete, e potete modificare le proprietà di ciascuno di essi in modo indipendente da quelle degli altri. Quando il cursore del mouse si trova nello spazio sottostante la barra orizzontale che mostra la sfumatura, vicino a esso appare un segno + e facendo clic viene creato un nuovo punto di cambiamento, che sarà anche quello attivo. Potete eliminare un punto di cambiamento facendo clic su di esso e trascinandolo con il mouse verso il basso; se lo trascinate in altre direzioni non riuscirete mai a farlo sparire.

    Potete anche modificare tonalità e opacità dei colori delle sfumature, e ciascun colore può avere impostazioni indipendenti. Inoltre, la modifica dell'opacità di uno o più dei colori delle sfumature non ha alcuna influenza sull'opacità del testo contenuto in una cornice di testo.


    diff --git a/scribus/doc/it/WwImages.html b/scribus/doc/it/WwImages.html index 2ec852c..981f5ef 100644 --- a/scribus/doc/it/WwImages.html +++ b/scribus/doc/it/WwImages.html @@ -64,9 +64,9 @@ Potete entrare in modalità modifica contenuto facendo clic sull'apposita

    Vedi anche:

    diff --git a/scribus/doc/it/WwLines.html b/scribus/doc/it/WwLines.html index 57644b1..4ad0524 100644 --- a/scribus/doc/it/WwLines.html +++ b/scribus/doc/it/WwLines.html @@ -57,11 +57,11 @@ Nel descrivere le opzioni della scheda Linea seguiremo un ordine diverso da quel

    Punto base

    -Abbiamo lasciato quest'impostazione per ultima perché è un po' complicata. Per ogni tipo di linea o figura, le impostazioni iniziali nella scheda X,Y,Z del pannello Proprietà mostrano la Pos X e la Pos Y del punto base, che all'inizio è l'angolo superiore sinistro della cornice o della bounding box. Nel caso di una linea retta, Pos X e Pos Y indicano il punto iniziale da cui la linea è stata tracciata. Le altre caselle di controllo nella scheda X,Y,Z mostrano la Larghezza e l'Altezza della bounding box, tranne che per una linea retta, che è definita soltanto da Larghezza (cioè lunghezza), direzione (Rotazione) e spessore della linea. +Abbiamo lasciato quest'impostazione per ultima perché è un po' complicata. Per ogni tipo di linea o figura, le impostazioni iniziali nella scheda X,Y,Z del pannello Proprietà mostrano la Pos X e la Pos Y del punto base, che all'inizio è l'angolo superiore sinistro della cornice o del riquadro di delimitazione. Nel caso di una linea retta, Pos X e Pos Y indicano il punto iniziale da cui la linea è stata tracciata. Le altre caselle di controllo nella scheda X,Y,Z mostrano la Larghezza e l'Altezza del riquadro di delimitazione, tranne che per una linea retta, che è definita soltanto da Larghezza (cioè lunghezza), direzione (Rotazione) e spessore della linea.

    Questo è valido se il Punto base nella scheda Linea è impostato a Punto sinistro. Se impostate il punto base a Estremità la scheda X,Y,Z mostra caselle di controllo per X1, Y1, e X2, Y2.

    Per una linea retta X1 e Y1 indicano il punto iniziale della linea, cioè il punto a partire dal quale essa è stata disegnata; X2 e Y2 indicano le coordinate dell'altro estremo della linea.

    L'esempio mostrato sotto riguarda una linea retta, e potete vedere che X-Pos = X1 e Y-Pos = Y1. -

    Per un oggetto più complesso di una linea retta, i valori sono riferiti alla bounding box, e in questo caso X1 e Y1 indicano il punto base impostato nella scheda X,Y,Z,; i valori X2 e Y2 indicano la larghezza e l'altezza della bounding box, che quindi saranno sempre numeri positivi. +

    Per un oggetto più complesso di una linea retta, i valori sono riferiti al riquadro di delimitazione, e in questo caso X1 e Y1 indicano il punto base impostato nella scheda X,Y,Z; i valori X2 e Y2 indicano la larghezza e l'altezza del riquadro di delimitazione, che quindi saranno sempre numeri positivi. diff --git a/scribus/doc/it/WwRenderframes.html b/scribus/doc/it/WwRenderframes.html index 3f8f54d..dadd9c7 100644 --- a/scribus/doc/it/WwRenderframes.html +++ b/scribus/doc/it/WwRenderframes.html @@ -14,12 +14,12 @@

    Il passo successivo consiste nel fare clic e trascinare il mouse per tracciare la cornice, proprio come per una cornice di testo. Per impostazione predefinita, Scribus mostra un messaggio di benvenuto, indicante almeno che la configurazione per LaTeX è corretta. Qui sotto è mostrato l'output fornito da LaTeX, rappresentato in Scribus. Il messaggio di benvenuto appare nella lingua dell'interfaccia utente selezionata in File > Preferenze; se non esiste una traduzione, sarà mostrata la versione inglese:

    Punto base: punto sinistro

    La schermata qui sopra ha la risoluzione predefinita di 72 DPI, che ovviamente è troppo bassa per la stampa. La risoluzione può essere modificata facilmente, come spiegheremo più avanti.

    -

    Modificare le cornici rendering

    +

    L'editor della cornice rendering

    Se fate clic col tasto destro su una cornice rendering, il menù contestuale comprende una voce “Modifica origine:”

    quando la selezionate, si apre il “cuore” della cornice rendering, l'editor:

    -

    In Scribus 1.3.5, l'editor è preconfigurato per utilizzare LaTeX, Lilypond, gnuplot, dot/GraphViz e POV-Ray.

    +

    In Scribus 1.3.5 e successivi, l'editor è preconfigurato per utilizzare LaTeX, Lilypond, gnuplot, dot/GraphViz e POV-Ray.

    A sinistra vi è un campo denominato “Inserisci codice”: qui potete inserire il codice per l'output che volete ottenere dal programma esterno. Per i programmi preconfigurati Scribus comprende dei frammenti di codice che vi permetteranno di verificare se essi sono installati e configurati correttamente. Come potete vedere, l'editor esegue anche l'evidenziazione della sintassi.

    Il pulsante “Aggiorna” sotto il campo di testo aggiorna il contenuto della cornice rendering, e vi permette di controllare il risultato dei cambiamenti fatti al codice sorgente senza chiudere l'editor. “Annulla” annulla gli eventuali cambiamenti fatti. Tenete presente che, una volta iniziato a creare e modificare il testo, non è possibile cambiare il programma esterno usato per interpretarlo; quindi, ad esempio, se avete iniziato a lavorare su del codice sorgente LaTeX, non potete passare a Lilypond.

    La parte destra della finestra contiene una serie di schede. Non tutte sono presenti per ciascuno dei programmi preconfigurati, e per alcuni di essi l'editor mostra soltanto la scheda “Opzioni”.

    @@ -127,6 +127,6 @@ Per dot/Graphviz non sono disponibili opzioni aggiuntive.



    -

    Inoltre, avete la possibilità di iniziare con una cornice vuota. Contrassegnando l'opzione “Forza DPI”, Scribus visualizzerà l'output di tutte le cornici rendering con la risoluzione impostata nella casella di controllo a destra. La risoluzione predefinita è impostata a 72 DPI per motivi di efficienza, ma se intendete creare un documento destinato alla stampa professionale, vi servirà una risoluzione maggiore.

    +

    Inoltre, avete la possibilità di iniziare con una cornice vuota. Contrassegnando l'opzione “Forza DPI”, Scribus visualizza l'output di tutte le cornici rendering con la risoluzione impostata nella casella di controllo a destra. La risoluzione predefinita è impostata a 72 DPI per motivi di efficienza, ma se intendete creare un documento destinato alla stampa professionale, vi servirà una risoluzione maggiore.

    diff --git a/scribus/doc/it/WwShapes.html b/scribus/doc/it/WwShapes.html index 894c355..1e7dab1 100644 --- a/scribus/doc/it/WwShapes.html +++ b/scribus/doc/it/WwShapes.html @@ -12,7 +12,7 @@ La pagina Lavorare con le cornici contiene informazi

    Forme

    @@ -20,7 +20,7 @@ La pagina Lavorare con le cornici contiene informazi
    Lo strumento “Forme” comprende un insieme di forme predefinite, che nella versione 1.4.x sono molto più numerose che nelle precedenti. All'avvio di Scribus la forma predefinita è il rettangolo mostrato nell'icona. Immediatamente alla sua destra c'è una freccia che apre un menù con alcuni sottomenù; se selezionate uno dei sottomenù e poi una particolare forma (facendo clic con il mouse) l'icona sulla barra degli strumenti assume la forma che avete selezionato. Nota: l'aspetto delle icone delle forme è stato reso più nitido nell'immagine qui a destra; in Scribus non hanno un aspetto così distinto. -

    Come spiegato in Lavorare con le cornici, nelle forme e nei poligoni i colori predefiniti per la linea e il riempimento sono rispettivamente nero e nessuno. Potete cambiare queste impostazioni per il documento corrente in File > Impostazioni documento > Strumenti > Proprietà disegno forme (icona), e per i documenti futuri in File > Preferenze > Strumenti > Proprietà disegno forme (icona). +

    Come spiegato in “Lavorare con le cornici”, nelle forme e nei poligoni i colori predefiniti per la linea e il riempimento sono rispettivamente nero e nessuno. Potete cambiare queste impostazioni per il documento corrente in File > Impostazioni documento > Strumenti > Proprietà disegno forme (icona), e per i documenti futuri in File > Preferenze > Strumenti > Proprietà disegno forme (icona).

    Come per le altre cornici, potete disegnare una forma facendo clic e trascinando il mouse da un angolo a quello opposto. Se tenete premuto il tasto Maiusc mentre trascinate, quando lasciate andare il mouse la forma riempirà l'intero spazio fino ai margini della pagina.

    		 Menù per la scelta della forma
    Inserisci dimensioni oggetto Un'altra possibilità consiste nel selezionare una forma nel menù, e poi fare clic sulla pagina (senza trascinare il mouse): si apre allora una finestra di dialogo, Inserire dimensione oggetto, in cui potete inserire le dimensioni della forma che volete creare. -

    Questo potrebbe essere utile, ad esempio, per disegnare esattamente un quadrato o un cerchio. L'Origine si riferisce al punto sulla pagina in cui avete fatto clic per aprire questa finestra. +

    Questo potrebbe essere utile, ad esempio, per disegnare esattamente un quadrato o un cerchio. L'origine si riferisce al punto sulla pagina in cui avete fatto clic per aprire questa finestra.


    diff --git a/scribus/doc/it/about1.html b/scribus/doc/it/about1.html new file mode 100644 index 0000000..87a5259 --- /dev/null +++ b/scribus/doc/it/about1.html @@ -0,0 +1,105 @@ + + + + Il team di Scribus + +

    Il team di Scribus: i protagonisti (in ordine di apparizione)

    + +

    Franz Schmid (fschmid): “il nostro Linus …”. L'autore originale e principale sviluppatore; programmatore per un'azienda industriale.

    + +

    Peter Linnell (mrdocs): cominciò con i test sulla versione 0.3.6, si incaricò di scrivere la documentazione per la 0.5.0; collaudatore, creatore dei pacchetti RPM, primo webmaster del sito di Scribus; consulente per la prestampa e l'informatica per aziende editoriali e di e-commerce.

    + +

    Craig Bradney (MrB): cominciò con la versione 1.1.1; si occupa di programmazione e test, ha creato i siti docs.scribus.net e bugs.scribus.net, gestisce i canali IRC su freenode.net; responsabile informatico di una grande azienda del settore e-commerce.

    + +

    Petr Vaněk: cominciò con la versione 1.1.4; specialista di plugin, ha creato parecchi plugin e lo “how-to” per la scrittura di plugin per Scribus; tecnico informatico.

    + +

    Riku Leino (Tsoots): cominciò con la versione 1.1.5; ha scritto il plugin per i modelli di documento e gli importatori OpenOffice.org/HTML per la 1.2.2; responsabile informatico di una grande organizzazione non-profit finlandese.

    + +

    Andreas Vox (pronuncia: [fox]) (avox): cominciò con la 1.3.0; autore della prima versione nativa per Mac OS X, specialista su caratteri e PostScript, detesta il C++ e apprezza la buona impaginazione; programmatore.

    + +

    Jean Ghali (jghali): si occupa della versione nativa per Windows e della maggior parte del codice per la gestione del colore, cacciatore di bug di gran talento; tecnico informatico e di prestampa.

    + +

    Oleksandr Moskalenko (malex): prepara i pacchetti di Scribus per Debian, contribuisce all'internazionalizzazione e alla traduzione, gestisce il sito di Scribus, rappresenta il progetto alla GSoC; biologo molecolare.

    + +

    Pierre Marchand (pierremarc); si occupa di caratteri, spazio di lavoro, composizione e impaginazione del testo. Autore di FontMatrix, programmatore per un'azienda editoriale.

    + +

    Christoph Schäfer (christoph_s): collaudatore e cacciatore di bug per la versione di sviluppo, redattore del wiki, traduttore e revisore della documentazione, uno dei principali autori del manuale ufficiale e della guida in linea di Scribus.

    + +

    Hermann Kraus (Herm): autore del plugin “Cornice Rendering” per la versione 1.4, integrazione di GraphicsMagick e UniConvertor nella 1.5.

    + +

    Jain Basil Aliyas (jainbasil): autore dei filtri d'importazione XTG e IDML, lavora sullo scripter Scribus di nuova generazione.

    + +

    Paul Smedley (smedles): autore e manutentore della versione per OS/2.

    + + +

    Il resto del cast e gli ex sviluppatori (in nessun particolare ordine):

    + +

    Paul F. Johnson (Nodoid): cominciò a contribuire patch per la 0.8, si è occupato di revisione e ottimizzazione del codice, ha scritto il documento “Coding Standards”.

    + +

    Steve Callcott (sjc): autore del plugin in Python “Anteprima caratteri”, che dimostrò il vero potere dello scripter Python di Scribus; si occupa di controllo di sistemi, elettronica di consumo, sviluppo e assistenza software su misura.

    + +

    Alessandro Rimoldi: ha contribuito alla correzione di errori nello Scripter e alla messa a punto del codice, mentor per la GSoC.

    + +

    Jean-Jacques Sarton: ha fornito alcune importanti patch per il miglioramento della gestione delle immagini e di altre funzioni. Ha aggiunto a Scribus la possibilità di lanciare applicazioni di grafica esterne.

    + +

    Alistair Robinson: ha contribuito alcuni importanti aggiustamenti per la gestione dei caratteri nelle prime versioni di Scribus, e ha scritto un intelligente hack di GIMP per la creazione di immagini TIFF CMYK.

    + +

    Maciej Hanski: traduttore in polacco e uno dei principali collaboratori al wiki di Scribus.

    + +

    Yves Ceccone: il primo traduttore in francese, autore di molti degli script Python di esempio forniti con Scribus, si è occupato di gran parte della documentazione di Scribus in francese.

    + +

    Craig Ringer: ha lavorato allo scripter, al sistema per la gestione del codice e la generazione del programma, e al test delle prime versioni per Windows e Mac OS X. Ha contribuito aggiustamenti per Python e altri miglioramenti; responsabile IT/DTP per un quotidiano.

    + +

    Martin Costabel: mantiene la versione di Scribus e le librerie di supporto per Fink, rendendo possibile l'uso di Scribus in ambiente X11 su Mac OS X.

    + +

    Niyam Bhushan: autore di un eccezionale corso pratico per Scribus.

    + +

    Marti Maria: ha risposto a una montagna di domande sulla gestione del colore, e ha dato littleCMS al mondo open source.

    + +

    Johannes Rüschel: ottimo cacciatore di bug, già traduttore in tedesco.

    + +

    Alexandre Prokoudine: traduttore in russo, ha aiutato molto a risolvere problemi di internazionalizzazione e a migliorare l'interfaccia utente; autore professionale di documentazione tecnica.

    + +

    Lukasz Jernas (DeeJay1): manutentore del pacchetto per PLD Linux.

    + +

    Howard White: collaudo, collaudo e ancora collaudo; tecnico di prestampa in pensione.

    + +

    Cedric Gémy: collaudo e contributi per l'interfaccia utente, mentor GSoC; professore di grafica e autore di libri su programmi di grafica open source.

    + +

    Gregory Pittman: uno dei principali contributori al wiki e alla documentazione di Scribus, uno dei principali autori del manuale ufficiale e della guida in linea; autore di molti utili script per Scribus; neurologo.

    + +

    Volker Ribbert: cominciò con la traduzione tedesca della documentazione.

    + +

    Louis Desjardins: organizzatore del Libre Graphics Meeting, si è occupato di test e ha suggerito molti miglioramenti. Traduttore della documentazione originale in francese.

    + +

    Frederic Dubuy: traduttore della documentazione originale in francese.

    + +

    François Lanctôt: traduttore della documentazione originale in francese.

    + +

    Eirik Øverby: si occupa con perseveranza della manutenzione dei nostri server.

    + +

    Gora Mohanty: autore del plugin per il controllo ortografico.

    + +

    Elvis Stansvik: autore della funzione di ricerca per lo “Schema documento” e creatore della gestione delle tabelle nella versione 1.5svn.

    + +

    Tomas Mecir: creazione del controllo su orfani e vedove e altri miglioramenti nella versione 1.5svn.

    + +

    Michael Doubez

    + +

    Cezary Grabski: ha fornito un gran numero di correzioni e miglioramenti al sistema di gestione del testo e ad altre parti del programma.

    + +

    Marcus Holland-Moritz: miglioramenti delle prestazioni per documenti con immagini grandi.

    + +

    Christian Töpp

    + +

    Andy Fitzsimmon: creatore della schermata iniziale di Scribus.

    + +

    Andreas Nilsson: icone dal Progetto Tango.

    + +

    Jakub Steiner: icone dal Progetto Tango.

    + +

    Antoine Cailliau: icone dal Progetto Tango.

    + +

    Alessandro Levati: traduttore della guida in linea in italiano.

    + + diff --git a/scribus/doc/it/bugreport.html b/scribus/doc/it/bugreport.html new file mode 100644 index 0000000..e1cca94 --- /dev/null +++ b/scribus/doc/it/bugreport.html @@ -0,0 +1,85 @@ + + + + Segnalare un bug + + +

    Segnalare un bug

    +

    È quasi impossibile sviluppare software di buona qualità senza sottoporlo a prove, e Scribus naturalmente non fa eccezione. Sottoporre un software a prove significa usarlo, e questo è vero specialmente per le versioni di sviluppo. Quando si scopre un errore o un difetto (in gergo: un bug), gli sviluppatori devono essere informati che c'è qualcosa che non funziona, o che almeno sembra non funzionare, in modo che possa essere corretto. A volte la correzione potrebbe essere soltanto un aggiornamento della documentazione. Inoltre gli sviluppatori hanno bisogno di sapere quali sono le necessità degli utenti: se sentite la mancanza di una determinata caratteristica, o avete una grande idea per migliorare il programma, dovreste informarli.

    + +

    In ogni caso, la procedura è la stessa. Esistono dei software detti sistemi per la gestione dei bug (o bug tracking systems), che consentono agli sviluppatori di esaminare, classificare e organizzare la lavorazione delle segnalazioni di errore e delle richieste di miglioramento. Il team di Scribus ha deciso di usare Mantis come sistema per la gestione dei bug. Se volete contribuire al miglioramento di Scribus o se avete assolutamente bisogno di qualche nuova caratteristica, vi consigliamo di imparare a usarlo.

    + +

    Creare un account

    + +

    Per cominciare, visitate la pagina di iscrizione. Ecco come appare:

    +
    +
    +
    +

    Inserite un nome utente, il vostro indirizzo di posta elettronica, e la combinazione di lettere e cifre che appare sotto. Poi fate clic su “Signup” e attendete la conferma di iscrizione e la password, che saranno inviati via email. Dopo aver eseguito il login potrete cambiare le vostre preferenze nella scheda “My Account”. È consigliabile controllare le opzioni e impostare quelle che vi appaiono più utili.

    + +

    Prima di segnalare un bug

    +

    Se qualcosa non funziona come vi aspettate, o se pensate di avere l'idea del secolo, non cominciate ad inviare segnalazioni a raffica. È possibile che qualcun altro abbia già avuto lo stesso problema o la stessa grande idea, e la vostra segnalazione potrebbe essere chiusa come “duplicata” o con “nessun cambiamento necessario“. Per evitarlo, ecco cinque passi da seguire.

    + +
      +
    1. Leggete la documentazione online, frugate nel wiki di Scribus; potreste anche prendere in considerazione l'acquisto del manuale ufficiale di Scribus. Ci sono molte informazioni in varie lingue, e forse qualcuno ha già scritto un articolo che descrive il vostro problema, o le persone che si occupano della documentazione potrebbero aver descritto la funzione o il problema che vi interessa.
      2. +
    2. Cercate di usare Scribus sul serio e di imparare i concetti che sono alla base del programma. Scribus non è particolarmente difficile da imparare, ma è alquanto diverso da (ad esempio) un elaboratore di testi.
      3. +
    3. Mandate un messaggio a una delle mailing list e spiegate il vostro problema o la vostra idea. Di solito si trova una soluzione rapidamente. Abbastanza spesso, la mancanza di esperienza fa sì che un certo problema sembri un bug.
      4. +
    4. Fate domande su IRC. Questo può essere utile soprattutto se si ha bisogno di aiuto “in diretta”.
      5. +
    5. Se non avete trovato risposte alle vostre domande, dovreste cercare nel database dei bug. Potete fare ricerche per parole chiave, come mostrato dall'immagine qui sotto. Inserite una o più parole nella casella “Search”, premete “Apply Filter”, e Mantis cercherà tutte le segnalazioni contenenti la stringa. Se non conoscete il termine inglese da cercare, potete cercare la traduzione nel glossario multilingue sul wiki. Se la vostra versione di Scribus non è in inglese e volete sapere quali sono i termini inglesi usati nell'interfaccia di Scribus, basta cambiare lingua nelle Preferenze.
      6. +
    +
    +
    +
    +

    Noterete che Mantis usa colori diversi per indicare lo stato delle segnalazioni. Questo è il significato dei colori:

    +
    newfeedbackacknowledgedconfirmedassignedresolvedclosed
    +
    + + +
    +

    Come inviare una segnalazione di bug

    +
    Per inviare una segnalazione di bug dovete fare clic sul link “Report Issue”. Questo apre una pagina con molti campi da compilare:
    +
    +
    + + +

    Dopo avere inserito queste informazioni preliminari, potete iniziare a descrivere il vostro problema o proposta. Per favore, inserite la vostra segnalazione in inglese.

    +
    +
    +
    + + +

    Avete quasi finito, ma se volete, potete allegare un file alla segnalazione (come uno screenshot o un documento Scribus di esempio). Fate clic su “Search” o inserite il percorso o la URL del file.

    +
    +
    +
    +

    Se volete che la vostra segnalazione sia visibile solo dagli sviluppatori potete impostarla come “Private”; questo potrebbe essere utile, ad esempio, se avete dei problemi con un'immagine protetta da diritti d'autore. Marcate la vostra segnalazione come “Private” ed essa sarà visibile solo a pochissime persone.

    Quando avete inserito tutto ciò che volevate, fate clic su “Submit Report”. Fatto!

    + +

    Vista personalizzata

    +

    Se avete eseguito l'accesso al bug tracker, potete scegliere una visualizzazione più chiara. Fate clic sul link “My view”, e Mantis presenta le segnalazioni modificate di recente, suddivise in due gruppi: +
    +
    +
    +

    + + diff --git a/scribus/doc/it/cms.html b/scribus/doc/it/cms.html new file mode 100644 index 0000000..19b625b --- /dev/null +++ b/scribus/doc/it/cms.html @@ -0,0 +1,54 @@ + + + + Gestione del colore con Scribus + + +

    Gestione del colore con Scribus

    +

    Panoramica

    + +

    L'obiettivo di un sistema di gestione del colore è di ridurre le differenze tra i colori visualizzati su schermo e quelli della stampa finale, e inoltre di individuare i colori “fuori gamma,” cioè non compresi nella gamma di colori (o “gamut”) della stampante che si intende usare. Per usare la gestione del colore sono necessari profili ragionevolmente accurati sia della stampante sia del monitor. Il concetto di gestione del colore, le opzioni e le descrizioni possono causare notevole confusione nell'utente inesperto. Se non si conosce la terminologia, è molto facile scegliere impostazioni errate, e di conseguenza spesso si peggiora l'aspetto delle immagini su video, su carta, o su entrambi. Allora il neofita dice “ne ho abbastanza!”, e disabilita la gestione del colore.

    + +

    Ebbene: non fatelo. Vi basterà comprendere alcuni concetti di base e conoscere la destinazione finale di stampa, e sarete in grado di prevedere e controllare meglio l'aspetto che il documento avrà quando sarà stampato. Questo è utile specialmente quando dovete inviare dei file in tipografia per la stampa in quadricromia.

    + +

    Questi sono i passi per fare in modo che la gestione del colore funzioni in modo affidabile (ciò che vedete a video è ciò che sarà stampato):

    + +
      +
    1. Imparate un po' i concetti e la terminologia della gestione del colore. Esistono molti buoni libri e siti sull'argomento (ad esempio questo, in inglese, e questo, in italiano).
      2. +
    2. Procuratevi o create profili colore accurati. Il più importante è un profilo preciso per il vostro monitor. Lprof è un ottimo strumento per la creazione di profili per monitor. Se non avete un profilo per il monitor correttamente creato, e attivate la gestione del colore, otterrete risultati di stampa insoddisfacenti e anteprime inaffidabili a video.
      3. +
    3. Caricate i profili colore nelle applicazioni grafiche in modo corretto. Al giorno d'oggi la gestione del colore può essere utilizzata non solo nelle applicazioni grafiche proprietarie, ma anche nelle principali applicazioni open source come GIMP, Krita, digiKam, Inkscape, o sK1.
      4. +
    + +

    Il sistema di gestione del colore di Scribus è pensato per permettere prove colore a monitor (“soft proofs”) con la gestione del colore attiva. Inoltre Scribus può avvisare della presenza di colori “fuori gamma”, che potrebbero essere riprodotti in modo non accurato da una stampante o da una macchina tipografica: questo può accadere perché la maggior parte delle stampanti hanno una gamma meno ampia di colori stampabili (CMYK), rispetto alla maggior parte dei monitor (RGB). Scribus non incorpora profili nelle immagini, né altera quelli incorporati in esse (alcuni formati immagine, come EPS, JPEG, PNG o TIFF, permettono di incorporare profili ICM o ICC.)

    + + +
    Il modello RGB (a sinistra) ha una gamma di colori molto più ampia del modello CMYK (a destra).
    + +

    Che cosa sono i profili di colore, e i profili di periferica?

    + +

    I profili ICC o ICM sono uno speciale tipo di file che descrive le caratteristiche di colore di una periferica come uno scanner, un monitor o una stampante. Possono esistere profili per qualunque apparecchio in grado di creare, visualizzare o manipolare immagini digitali, da cui il termine profilo di periferica.

    +

    Vi sono anche profili di colore detti indipendenti dalla periferica o di spazio di lavoro. Questi file speciali possono essere considerati “traduttori” che convertono i dati di colore da un tipo di profilo colore ad un altro.

    +

    Un file ICC o ICM è un insieme di tabelle che contengono i valori matematici per mezzo dei quali una periferica misura e descrive il colore. Fortunatamente, questi profili seguono uno standard aperto internazionale e funzionano allo stesso modo su Mac OS X, OS/2, eCS, Windows, Linux o UNIX.

    + + +

    Attivare la gestione del colore

    +

    Perché la gestione del colore funzioni correttamente, i seguenti componenti devono essere installati, funzionanti e utilizzabili:

    + + +

    Posizioni dei profili colore

    + + +
    + + diff --git a/scribus/doc/it/cms2.html b/scribus/doc/it/cms2.html new file mode 100644 index 0000000..b1e278c --- /dev/null +++ b/scribus/doc/it/cms2.html @@ -0,0 +1,44 @@ + + + + Impostazioni per la gestione del colore + + +

    Impostazioni per la gestione del colore

    +

    Per ottenere buone anteprime con la gestione del colore, questi sono i requisiti minimi:

    + + +

    Allora, come posso procurarmi i profili giusti per il mio hardware?

    + +

    Alcuni profili sono “generici” e possono essere scaricati dal sito del produttore della periferica; questo tipo di profilo è generato dalle misurazioni eseguite dal produttore su un certo numero di esemplari. Oggi questi profili sono spesso forniti dal produttore insieme al software del monitor, dello scanner o della stampante. Questi profili “preconfezionati” di solito non sono perfettamente adatti, ma sono un buon punto di partenza, soprattutto se non potete permettervi un dispositivo di calibrazione, che può essere costoso. Controllate sul sito del produttore se esiste un profilo per la vostra periferica. Per i profili colore dei monitor potete usare anche il database Taxi, che è gestito dal progetto OpenSUSE.

    + + + +

    Il modo più preciso di profilare un monitor consiste nell'usare un apposito apparecchio elettronico, che in sostanza è uno speciale tipo di macchina fotografica in grado di misurare il colore. Il software invia al monitor dei colori di riferimento noti che vengono misurati dal dispositivo di profilazione, e in base a queste misure viene creato un profilo. Fino a non molto tempo fa non esistevano driver Linux per i normali colorimetri, ma grazie all'entusiasmo degli esperti della gestione del colore open source, oggi molti apparecchi possono essere usati almeno su Linux, Mac OS X e Windows. I driver open source possono anche essere compilati per le piattaforme UNIX, mentre è poco probabile che siano utilizzabili su OS/2 ed eComStation.

    + +

    Impostazioni per la gestione del colore in Scribus

    +

    Le impostazioni per la gestione del colore si trovano in Preferenze/Impostazioni documento. Ricordate che sul vostro sistema devono essere installati almeno un profilo RGB e uno CYMK per poter attivare la gestione del colore. Inoltre Scribus è più lento quando modificate, salvate o chiudete un file con la gestione del colore attiva, poiché littleCMS deve leggere ed eseguire le correzioni tra i profili.

    +
    Preferenze per la gestione del colore
    + +

    “Profili del sistema:” questi sei menù a discesa mostrano i profili disponibili sul vostro sistema. I profili per le immagini (ad esempio, immagini bitmap) e per i colori in tinta unita devono essere impostati separatamente. Inoltre dovete impostare separatamente anche i profili per gli spazi colore RGB e CMYK. Per quanto riguarda le stampanti, attualmente Scribus è in grado di utilizzare soltanto profili per la stampa commerciale. I profili per le comuni stampanti da scrivania non funzionano con Scribus, e non vengono mostrati nei menù a discesa.

    + + +

    La seconda parte della finestra di dialogo permette di selezionare gli “intenti rendering”, che sono spiegati nella pagina successiva.

    +

    Nella parte inferiore si trova la casella “Simulazione di stampa su schermo”. Se attiva, Scribus e littleCMS simulano i colori che la stampante è in grado di riprodurre in base al profilo stampante selezionato.

    +

    La casella “Segna colori fuori gamma” evidenzia alcune alcune aree del documento in colore verde: i colori in queste aree potrebbero non essere stampati fedelmente, in base al profilo stampante scelto. Di solito i colori indicati come fuori gamma, quando stampati, saranno più scuri, più chiari o comunque alterati:

    + + + +
    Un disegno visualizzato con l'avviso fuori gamma disattivato (a sinistra) e attivato (a destra)
    +

    L'ultima opzione, “Usa compensazione punto nero”, è un aiuto alla visualizzazione delle ombre nelle immagini a colori. È necessaria un po' di sperimentazione per stabilire se migliora le vostre immagini.

    + + + diff --git a/scribus/doc/it/cms3.html b/scribus/doc/it/cms3.html new file mode 100644 index 0000000..c68b906 --- /dev/null +++ b/scribus/doc/it/cms3.html @@ -0,0 +1,20 @@ + + + + Intenti rendering + + +

    Intenti rendering

    + +

    Il concetto di intento rendering può essere un po' difficile da capire per chi non è esperto nella gestione del colore. In sostanza, scegliere un certo intento rendering significa indicare a littleCMS in che modo i colori di un certo spazio colore devono essere fatti corrispondere a quelli di un altro spazio colore. Esistono quattro intenti rendering:

    + + + diff --git a/scribus/doc/it/codingstandards.html b/scribus/doc/it/codingstandards.html new file mode 100644 index 0000000..0450abe --- /dev/null +++ b/scribus/doc/it/codingstandards.html @@ -0,0 +1,433 @@ + + + + Scribus Coding Standards + + +

    Scribus Coding Standards

    + +

    +Initial document: Paul F. Johnson, 26 Feb. 2004, Version: 0.04
    +Revised: Craig Ringer, 16 Aug. 2005, Version: 0.05 (text encodings, exceptions, who to send patches to)
    +Revised: Peter Linnell, 06 Sept. 2005, Version: 0.06 (more text encodings stuff from recent discussions)

    + +

    This document is intended as a guide to all Scribus developers and contributors. It is aimed to be simple to use, as well as to keep the source code simple to understand and maintain.

    + +

    Code Documentation

    + +

    All code should be documented clearly.

    + +

    Prior to any method, the following should be there

    + +
    +
    +/*!
+ \fn functionName::functionName()
+ \author Authors Name
+ \date
+ \brief Constructor for class
+ \param None
+ \retval None
+ */
+
    +
    + +

    There should be something similar prior to the class definitions.

    + +

    In preference, all details should be in English. This includes comments.

    + +

    Unless a comment occupies a single line, // should be used in preference to /* */

    + +

    Code

    + +

    Variable naming conventions

    +

    All variables should begin in lower case letters. If the variable has more than one part to it, then the second part should begin in a capital letter. For example int foo and int fooBar.

    +

    Variables should be clear in their naming. The exception to this is in a for loop. In preference, these should be in English. We are in the process of converting and altering the current ones to fit in with this.

    +

    Any temporary variables (such as those used in a for loop or those only used within a scope), should only be declared where they are needed and not used in a global scope. If there is a condition at the start of a method, any variables required should be declared, but nothing else. For example

    +
    +
    +void foo::bar(f *b)
+{
+	int j;
+	string g = b->passed_in;
+	double fg, m, c;
+	which_string(g, &j);
+	if (j == true)
+		return;
+	// rest of the code
+}
+
    +
    +

    should not have the double variables declared. It is arguable if g should be declared, but in this example, it doesn't matter.

    + +

    If a variable is not required, don't create it. In the example above, there is no requirement for g to be used.

    + +

    Tabbing convention

    +
      +
    1. +

      In class definitions

      +

      With the exception of the access declarations, a single tab should be used prior to all method and variable definitions. There should be no tabs prior to access declarations. There is a tab prior to Q_Object.

      +
      2. +
    2. +

      In the main code

      +

      There should be a tab at the start of every line. With any conditional line, there should be an opening brace by itself. On the next line down, there should be another tab prior to any code. The close brace should be underneath the open brace.

      +
      3. +
    + +

    Conditionals

    +

    Always make a conditional logical. This may sound silly, but look at the following example

    +
    +
    +int foobar(bool m)
+{
+	if (m == true)
+	{
+		somethingA(1);
+		somethingB(1);
+		somethingC(1);
+	}
+	else
+	{
+		somethingA(0);
+		somethingB(0);
+		somethingC(0);
+	}
+}
+
    +
    + +

    This can be re-written to make things clearer

    +
    +
    +int foobar(bool m)
+{
+   int c = m == true ? 1 : 0;
+   somethingA(c);
+   somethingB(c);
+   somethingC(c);
+}
+
    +
    +

    A lot simpler to see and will usually optimize far better.

    + +

    Ternary conditionals (?) should be used in preference to if / else. These are usually far quicker to process the code once compiled.

    + +

    Depending on what is being performed, switch statements should be avoided. There is usually a simpler way to avoid them. For example

    +
    +
    +int b;
+string s;
+switch (f)
+{
+	case 1 :
+		b = 4;
+		s = "four";
+		break;
+	case 2 :
+		b = 8;
+		s = "eight";
+		break;
+	case 3 :
+		b = 12;
+		s = "twelve";
+}
+
    +
    +

    can be re-written as

    +
    +
    +int b = f * 4;
+char *number[] = {"four", "eight", "twelve"};
+size_t no = sizeof(number) / sizeof(*number);
+s = number(f);
+
    +
    +

    The switch has gone and the code generated runs far faster and as the conditions don't need to be created, will optimize far better. Note: when using the QObject::tr() function, this method of using char* may not always work properly. An alternative is to use QString number[] = {"four", "eight", "twelve"}; etc. + +

    Obviously for more complex switch conditions, the above can't be used.

    + +

    Conditionals formatting

    + +

    Formatting should look like this:

    +
    +
    +if (fred == 5)
+{
+	// something
+	// something
+}
+
    +
    +

    Switch formatting should look like this:

    +
    +
    +switch (f)
+{
+	case 0:
+		if (fred == 1)
+		{
+			// something
+			// more
+			// ok
+		}
+		else
+		{
+			if (jimmy == 0)
+			{
+				// hi
+				// code
+			}
+			// something here
+		}
+		break;
+}
+
    +
    +

    Simple to read and simple to see where the conditional ends.

    +

    Under NO circumstances should you have a line such as:

    +
    +
    +if (foo == bar) { somethingA(0); }
+
    +
    +

    This should be written as:

    +
    +
    +if (foo == bar)
+	somethingA(0);
+
    +
    +

    If braces are not required, don't use them. For example, braces wouldn't be needed here

    +
    +
    +for (int j = 0; j < 10; ++j)
+	cout << j << "\n"?;
+
    +
    +

    Pre or post increments

    + +

    In for loops, preincrements should be used (++a rather than a++). Under ARM processors and x64 processors (not sure about ia64) ++a requires half the number of clock cycles than the post processor style. In some circumstances, ++a is far more efficient under ia32. It is even more efficient when used with iterators. Post increments should be used in the following sort of code:

    +
    +
    +if (b == true)
+{
+	m->wibble(c);
+	m->wobble(c++);
+}
+
    +
    + +

    Spacings

    +

    There should be a space after:

    + + +

    Use of templates

    + +

    Templates for both types and classes are fine to be used. The project recommends using g++ 3.x which fully support templates and template classes. Please remember the overhead involved in using templates!

    +

    When using templates, please remember the following:

    + + +

    Optimization

    + +

    Unless you really know what you're doing and more over, what the code is doing, do not attempt to do any code optimization. In a lot of respects, optimization is a "black art".

    +

    Code such as a = b = c = 0; is more efficient (through the compiler) than a=0; b=0; c=0;

    +

    Careful thought about how the code works is usually far more beneficial than attempting any of the "tricks" currently employed.

    +

    Any large scale changes should be approved of first. Sometimes a small change can have large side effects.

    +

    Multiple separate lines containing calls to Qt methods are far less efficient than multiple calls contained in a for loop.

    + +

    Initialization

    + +

    QString fred = QString("bob") is not the same as QString fred("bob"). The first one creates an additional temporary that's then thrown away. That's slow, and should generally be avoided.

    + +

    In constructors, it is somewhat faster to use:

    + +
    +Fred::Fred() : ParentClass(), + argument1("initialValue"), + argument2(INITIAL_VALUE) +{ +} +
    + +

    than

    + +
    +Fred::Fred() : ParentClass() +{ + argument1 = "initialvalue"; + argument2 = INITIAL_VALUE; +} +
    + +

    for much the same reasons as outlined above. It's best to initialize the members in the same order that they're listed in the class declaration.

    + +

    Memory checking

    + +

    Due to the unavailability of exceptions (see below), we're using Q_CHECK_PTR to check allocations. This means that you get an abort with a useful message when an allocation fails, rather than an unexplained segfault.

    + +

    +int *m = new int[2048]; +Q_CHECK_PTR(m); +
    + +
    Exceptions
    + +

    All calls to new should ideally be trapped. This is not currently implemented in current releases. The preferred method would be:

    +
    +
    +#include <new>
+
+try
+{
+  m = new int[2048];
+}
+
+catch(bad_exception)
+{
+  cout << "memory allocation to m failed - <method name<" << endl;
+  exit(EXIT_FAILURE);
+}
+
    +
    +

    As there are many calls in Scribus to new, these will have a wrapper around.

    +

    For users of Qt who compile their own, they will need to include in the ./configure script that they want to throw C++ exceptions. Failure to do so will result in the catches not catching and possibly Scribus failing to run.

    +

    Currently (for v3.2 - v3.4), KDE recommend Qt is compiled without exceptions. This is a bad idea as it means trapping bad memory allocations cannot be caught using the preferred method. As most distributions follow this recommendation, that means we (Scribus) can't expect to be able to rely on exceptions.

    + +

    Text encodings

    + +

    Text encodings need to be handled carefully. Strange errors can result if you treat UTF-8 text as latin-1, for example. These issues are often hard to track down, so careful coding is important. A detailed treatment of text encodings won't fit here, but some information will be provided elsewhere in the documentation. This is an early version of this part of the text; feedback would be appreciated.

    + +

    The first thing you need to understand is that Qt's QString, and most other Qt classes, know their own encoding and take care of text encoding issues for you, so they can be treated as "just text" when passing them around inside Scribus and to other Qt classes. It's only at the interfaces between byte-oriented and "text"-oriented code that care is required. These interfaces can be tricky to spot (the implicit conversion of a QString to a QCString or char*, for example, is easily missed) so caution and careful reading of API documentation is required.

    + +

    While there is no real substitute for understanding text encodings, some of the most important rules to follow are:

    + +

    Always construct a QString from a byte string using one of the QString::fromblah(...) methods. You should never use QString(char*) or QString(QCString). You need to determine what encoding the byte string you're working with is in and use the correct call, by examining the documentation for the system / library you are calling. There is generally no way to tell what encoding a string is in by examining the string - at best this is guesswork. Do not assume a string is utf-8 or latin-1, since even if it works for you, in some locales it will not. For data read from the OS or C libraries, you generally want QString::fromLocal8Bit(...). If in doubt, ask somebody.

    + +

    Similarly, you should always use the appropriate QString conversion methods when converting QStrings to byte strings (e.g. QCString, QByteArray, or char*). Note that such conversions may happen automatically, so watch out for implicit conversions. If sending data to system calls or C libraries you'll generally want QString::local8Bit() but you should check to confirm that's correct for the specific call you're making. Some win32 calls, for example, expect UCS-2 (wchar) data, and some C libraries will expect UTF-8 strings to be passed to some methods.

    + +

    You should absolutely never do this:

    + +
    +QString blah = anotherQString.utf8(); +
    + +

    The above code:

    + + +

    Thus, you end up doing a lot of pointless work encoding and decoding the string, and to top it off probably mangle it by decoding a utf-8 string as latin-1. You usually won't notice this, because you probably only send ASCII data thorough, and thus the bug will only turn up much later from people in other locales who use other text encodings. These issues tend to be a pain to track down.

    + +

    For similar reasons, when you're reading or writing a QTextStream, remember to call QTextStream::setEncoding(...) before reading/writing any data. Use operator<< with QStrings, but WriteRawBytes(...) when writing byte strings that are already in the correct encoding. Byte strings in other encodings should be converted to QString or transcoded using QTextCodec. Do not just assume the QTextStream should write out UTF-8. The correct encoding will depend on where the data is going / coming from. For example, a plain text file for the user to edit should be in their local text encoding. If you're not sure, ask someone.

    + +

    Don't convert a QString to a byte string when writing to a QTextStream - the QTextStream does that for you in operator<< . For example:

    + +
    +QTextStream ts(&file); +// In this case we know we want to write out UTF-8 to this file, not write in +// the local 8-bit byte string encoding. +ts.setEncoding(QTextStream::UnicodeUTF8); +ts << someQString.utf8(); +
    + +

    as that's the same error as in the previous example, just written a different way. Instead, you should omit the .utf8().

    + +

    The best way to handle text encodings is to convert 8-bit byte strings to QString or another "safe" class as early as possible in input, and convert to 8-bit byte strings as late as possible on output. Above all else, do it only once and watch out for implicit conversions. You should think about encodings whenever passing text across any interface that wants byte-oriented strings rather than QStrings. Remember to read the documentation of the APIs you're using to determine how they behave with text encodings, and if you're not sure, ask somebody.

    + +

    It is strongly recommended that you read http://doc.trolltech.com/3.3/i18n.html for more coverage of this issue, especially the section "Support for Encodings". You should also read Achtung! Binary and Character data.

    + +

    Translation Hints - Encoding Issues

    +

    Please use:

    +
     "<qt>" + tr("text for translation") + "</qt>"
    +

    not this:

    +
     tr("<qt>text for translation</qt>")
    +

    it's really annoying to translators.

    + +

    If you are writing a class which is not inherited from QObject or any Qt +class, you cannot use inherited tr() method. If you are using something like:

    +
     QObject::tr("text for translation")
    +

    replace it with:

    + 
    QObject::tr("text for translation", "describe what is it related")
    +

    An example from the scripter:

    + 
    QObject::tr("Item is not text frame", "scripter error")
    +

    It helps translators with context and it tells them what they are +translating too, though in some cases strings are generic in nature.

    + + +

    There's another issue related to translations, though it's more for +encoding correctness etc: Please don't use:

    + +
    tr( QString("blah %1").arg(something) )
    + +or otherwise use a QString inside a tr(...) . Doing so causes an +implicit conversion to `const char*', in which the QString converts to a +latin-1 byte string. If some characters cannot be represented in latin-1 +they're replaced with `?' . The correct usage is: + +
    tr("blah %1","context").arg("something")
    + +

    ... exploiting the fact that tr(...) returns a QString and that you can +chain calls to QString::arg. That avoids any implicit conversions, and +will avoid a whole class of weird encoding bugs.

    + +

    If you really have to translate text that can't be represented in +latin-1, you need to use QObject::trUtf8(...). If you want to translate +a string with "Δ" (uppercase delta) in it, for example, we could try:

    + +

    tr("Δ is %1", "context")

    + +

    but that's wrong, not portable, may not compile, or worse might have +different results on different systems. We must use escaped byte strings +rather than including a unicode or extended latin-1 char directly in +source. The UTF-8 byte sequence for that character is \xce\x94, so we +could try:

    + + 
    tr("\xce\x94 is %1", "context")
    + +

    but that's also wrong, as that unicode byte sequence will be interpreted +as latin-1 and you'll get a mangled result. You must instead use:

    + + 
     trUtf8("\xce\x94 is %1", "context")
    + +

    Similarly, if you wanted to include the © (copyright) symbol, which +exists in latin-1 as well, you could use either:

    + + 
    tr("something \xa9 someone", "context")
    + +

    or

    + + 
    trUtf8("something \xc2\xa9 someone", "context")
    + +

    Portability

    + +

    Don't cast a pointer to an int, it causes portability issues where sizeof(int) != sizeof(void*). You might want to find another way to do what you're trying to achieve.

    + +

    Submitting of patches

    + +

    Code patches should be sent to Franz, Craig Bradney, or Peter. Documentation patches should be sent to Peter and Craig Bradney. Scripting matters should be addressed to Petr and Craig Ringer.

    +

    Patches should be in plain text. diff -u old_file.cpp new_file.cpp >difference.diff is the best way of sending them. Please do not send patches to the main list. Remember to use -u (unified diff) as other types of diff are painful to use.

    +

    Please ensure that when you have changed something you put a comment immediately before the change. Ensure you put a date and who made the change and what the change is for. Make sure that the comments include the original line of code. Over time, these will be weeded out, but it useful to see what has been altered.

    +

    Send a single diff for each file altered. It makes committing the changes far more simple for us!

    + +

    Writing plugins

    + +

    Please use the current functions and refer to the Plugin howto for further information.

    +

    All code called from the main Scribus application has to be encompassed within an extern "C" { ... }; to enable the plugin to work. +Ensure that all the code is documented and follows the coding guidelines set out above.

    + + \ No newline at end of file diff --git a/scribus/doc/it/color2.html b/scribus/doc/it/color2.html index 9458db3..c15764f 100644 --- a/scribus/doc/it/color2.html +++ b/scribus/doc/it/color2.html @@ -21,7 +21,7 @@

    Linux/UNIX:

    Se avete installato Scribus per mezzo di un sistema di gestione dei pacchetti come RPM, DEB o BSD Ports, i file delle raccolte devono essere copiati in /usr/lib/scribus/swatches o /usr/local/lib/scribus/swatches. L'esatta posizione dipende dalla configurazione del gestore di pacchetti di ciascuna distribuzione.

    -

    Se avete compilato Scribus personalmente dovete copiare i file delle raccolte in installation_directory/share/scribus/swatches.

    +

    Se avete compilato Scribus personalmente dovete copiare i file delle raccolte in installation_directory/lib/scribus/swatches.

    Se non avete permessi di root, potete anche copiare i file in /home/user_name/.scribus/swatches/locked.

    Se la cartella locked non esiste, dovrete crearla.

    Mac OS X

    diff --git a/scribus/doc/it/color7.html b/scribus/doc/it/color7.html new file mode 100644 index 0000000..12074c6 --- /dev/null +++ b/scribus/doc/it/color7.html @@ -0,0 +1,26 @@ + + + + Color Palettes in Scribus (5): GiveLife Color System® + + +

    Color Palettes in Scribus (5): GiveLife Color System®

    + +

    GiveLife Color System® is a Spanish company founded by designers and engineers to create new color systems for graphics and design professionals, especially in the Hispanic world.

    + +

    Until now, GiveLife Color System® has developed two numerical color systems, one in RGB and one in CMYK. Scribus is the first graphics program which is being shipped by default with the GiveLife Color System® color palettes.

    + +
    The GiveLife Color® System CMYK palette in the Scribus Color Manager

    + +

    The palette “GiveLife Color System CMYK”

    +

    This palette consists of 2265 CMYK colors, each of which has a five-digit numerical code. The system has been developed for use in print-related projects. The company offers a printed color reference for this palette on its website. This “Color Guide Book” has been created using the ICC profile FOGRA 39 (ISO 12647-2:2004).

    + +

    The palette “GiveLife Color System RGB”

    +

    The second palette comprises 5101 RGB colors, each of which has a four-digit numerical code. The correct ICC profile for use with this palette is sRGB.

    + +

    Note that you need to install the profiles listed above to use the colors reliably.

    + +

    The Scribus Team will cooperate with GiveLife Color System® to ensure that updates to the existing palettes, as well as new color systems will be made available to our users in the future.

    +
    + + \ No newline at end of file diff --git a/scribus/doc/it/colorwheel.html b/scribus/doc/it/colorwheel.html new file mode 100644 index 0000000..d5eea3f --- /dev/null +++ b/scribus/doc/it/colorwheel.html @@ -0,0 +1,62 @@ + + + + La mappa cromatica + + + +

    La mappa cromatica

    +

    Una mappa cromatica (o cerchio del colore) è uno strumento originariamente creato da scienziati come Isaac Newton per visualizzare lo spettro fisico di tutti i colori; oggi è usato da artisti e grafici per selezionare e abbinare colori in base alla percezione del colore. Come i modelli di colore RGB e CMY(K), una mappa cromatica si serve del concetto di colori primari, in questo caso rosso, giallo e blu, da cui l'abbreviazione RYB (dall'inglese red-yellow-blue). Esistono altre mappe cromatiche basate sui modelli di colore RGB o CMY(K), ma quella di Scribus segue il tradizionale approccio “artistico” o “percettivo”, poiché questo è il modo di garantire (quasi sempre) risultati visualmente piacevoli nella progettazione grafica, con l'utilizzo di formule basate sulle osservazioni e ricerche di Goethe e dei suoi successori.


    + + +
    La mappa cromatica RYB
    La mappa cromatica RYB
    +

    La finestra di dialogo Mappa Cromatica

    +

    La finestra di dialogo Mappa Cromatica (che si apre da Utilità > Mappa Cromatica) può apparire semplice a prima vista, ma in realtà è molto versatile. Osservate che è utilizzabile soltanto con un documento aperto, poiché le armonie di colore che potete creare qui vengono aggiunte ai colori del documento.


    +
    La finestra di dialogo Mappa Cromatica
    + +

    Generale

    +

    Nella parte superiore sinistra della finestra si trova la mappa cromatica vera e propria, che appare come un cerchio multicolore. In base allo schema di colore scelto, vedrete uno o più circoletti posizionati sul bordo del cerchio: essi sono gli indicatori di colore, e potete spostarli con il mouse per modificare lo schema di colore. Al centro della ruota è sempre presente un solo colore: questo è il colore base, cioè quello che determina gli altri colori dello schema. Potete cambiarlo facendo clic in un punto della mappa oppure scegliendo un altro colore base nella sezione a destra della mappa.

    +

    Al di sotto della mappa potete selezionare lo schema di colore, che è spiegato più avanti. Poiché gli schemi di colore sono basati su idee geometriche, potete modificare anche l'angolo o la “distanza” tra i colori in alcuni (ma non tutti) di essi.

    + +

    Modelli di colore

    +

    La finestra di dialogo fornisce tre tipi di modelli di colore, con la selezione delle variabili di colore per impostare il colore base. I modelli CMYK, RGB e HSV sono spiegati in questa pagina. Inoltre, potete scegliere i colori tra tutti i colori del documento, cioè tra quelli della raccolta colore attualmente selezionata e quelli importati o creati ex novo.

    + +

    Schemi di colore

    + +

    Monocromatico:

    +

    Lo schema di colore monocromatico (mostrato sopra) è la combinazione di un colore base con una variante scura e chiara del colore stesso. Non è possibile modificare l'“angolo,” poiché non vi è relazione geometrica tra i colori.

    +

    Analogo:


    +
    La finestra di dialogo Mappa Cromatica
    +

    Lo schema di colore analogo ha l'obiettivo di creare armonie di colore utilizzando colori “tra loro vicini” nella mappa cromatica. L'utilità di questo schema (specialmente nella stampa offset) dipende dalla presenza di un sufficiente contrasto tra i colori; è quindi consigliabile mantenere un valore dell'“angolo” abbastanza grande.

    +

    Complementare:

    +
    La finestra di dialogo Mappa Cromatica
    +

    I colori complementari sono quelli che si trovano in punti opposti tra loro nella mappa cromatica, quindi il campo Angolo è disattivato. Il loro migliore utilizzo consiste nel creare forti contrasti tra aree ampie, ma dovrebbero essere evitati come colori per il testo e lo sfondo del testo, poiché rendono il testo quasi illeggibile.

    +

    Complementare separato:

    +
    La finestra di dialogo Mappa Cromatica
    +

    A differenza dello schema complementare, il complementare separato utilizza un colore base e due colori vicini al complementare del colore base. La “distanza” tra i colori complmentari separati e il colore complementare deve essere la stessa per entrambi, ma la distanza stessa può variare, e questo è il motivo per cui si può modificare l'“angolo.”

    +

    Triadico:

    +
    La finestra di dialogo Mappa Cromatica
    +

    In uno schema di colore triadico, tre colori sono collocati sulla mappa cromatica in modo da formare un triangolo equilatero. Quindi l'“angolo” non è modificabile.

    +

    Tetradico (o Complementare doppio)

    +
    La finestra di dialogo Mappa Cromatica
    +

    Lo schema di colore tetradico comprende due coppie di colori complementari (da qui il nome alternativo “complementare doppio”). Se entrambe le coppie sono posizionate ad un angolo di 90° (che è l'impostazione predefinita), essi sono distribuiti sulla mappa a intervalli regolari; questo caso speciale è chiamato anche schema di colori “quadrato”. Non vi è alcun bisogno di limitarsi a uno schema quadrato, e quindi l'“angolo” può essere modificato.

    + + +

    L'anteprima

    +

    Aggiungere armonie di colore ai colori del documento

    +

    Nella parte in basso a destra della finestra, sono visualizzati i “colori risultanti” in tutti i tre modelli di colore. Purtroppo i nomi dei colori nel nuovo schema vengono creati automaticamente, e non è possibile modificarli in questa finestra. Quindi dovrete rinominarli in Modifica > Colori se volete utilizzare più armonie di colori nel documento, oppure se volete che i colori dello schema siano elencati vicini tra loro nelle finestre di gestione dei colori.

    +

    La sezione Anteprima della finestra di dialogo fornisce un'anteprima dello schema di colore selezionato, con un testo campione in 100% nero RGB e bianco RGB per mostrare l'aspetto del testo sullo sfondo di aree che utilizzano quei colori. Un'importante caratteristica dell'anteprima è la simulazione della cecità al colore. Quando ci si serve di armonie di colore, non si dovrebbe mai dimenticare che certe combinazioni di colore che funzionano bene per la maggioranza potrebbero non funzionare affatto per persone che soffrono di certi difetti visivi. Ad esempio, due colori contrastanti potrebbero apparire come un unico colore, oppure del testo facilmente leggibile quando collocato davanti a un'area colorata potrebbe scomparire completamente per persone con certi difetti visivi.

    +

    Nella parte inferiore della finestra sono presenti due opzioni per aggiungere lo schema di colore scelto ai colori del documento: “Fondi” e “Sostituisci.”

    +

    Fondi: aggiunge i colori che avete creato a quelli del documento. Se avete già creato un altro schema di colore senza aver cambiato i nomi dei colori di questo schema, appare la seguente finestra di dialogo:


    +
    La finestra di dialogo Mappa Cromatica
    +

    Come descritto, si apre la finestra di dialogo Colori, e qui potete rinominare gli schemi di colore esistenti. Potete poi tornare alla mappa cromatica e fondere la nuova armonia di colori.

    +

    Sostituisci: prevedibilmente, sostituisce i colori di uno schema creato in precedenza che hanno lo stesso nome nella finestra Colore.

    +

    Limitazioni

    +

    Vi sono diverse limitazioni sia nel modello colore RYB sia nella sua implementazione in Scribus:

    + + + diff --git a/scribus/doc/it/config.html b/scribus/doc/it/config.html index 44ed7bd..b9a898c 100644 --- a/scribus/doc/it/config.html +++ b/scribus/doc/it/config.html @@ -6,6 +6,6 @@

    Configurazione di Scribus

    Un programma ricco e complesso come Scribus non può adattarsi alle esigenze di tutti gli utenti con una singola configurazione, specialmente se si considera anche che può essere installato su molte piattaforme diverse. Con il progressivo sviluppo di Scribus, è stato inevitabile che gli utenti chiedessero sempre più opzioni per personalizzare Scribus e adattarlo alle proprie preferenze ed esigenze. Scribus è quindi diventato uno dei più configurabili programmi di desktop publishing. Ciononostante, vi saranno sempre utenti per cui Scribus non è abbastanza configurabile, e altri che non vogliono essere infastiditi da decine di opzioni modificabili.

    -

    Questa parte della guida in linea ha lo scopo di descrivere ciò che può essere regolato e adattato, ma anche ciò che può essere ignorato senza dare problemi nella maggior parte dei casi. Vi sono alcuni argomenti che rientrano sia nella “configurazione” sia nell'”uso“ (un esempio è la gestione delle raccolte di colori), e in questi casi gli autori della guida hanno dovuto scegliere in quale dei due capitoli collocarli. Un caso a sé è la gestione del colore, che è abbastanza complessa da meritare un capitolo a parte. Questo capitolo, inoltre, tenta di aiutarvi a configurare altre parti del vostro sistema per ottenere il massimo da Scribus.

    +

    Questa parte della guida in linea ha lo scopo di descrivere ciò che può essere regolato e adattato, ma anche ciò che può essere ignorato senza dare problemi nella maggior parte dei casi. Vi sono alcuni argomenti che rientrano sia nella configurazione sia nell'uso (un esempio è la gestione delle raccolte di colori), e in questi casi gli autori della guida hanno dovuto scegliere in quale dei due capitoli collocarli. Un caso a sé è la gestione del colore, che è abbastanza complessa da meritare un capitolo a parte. Questo capitolo, inoltre, tenta di aiutarvi a configurare altre parti del vostro sistema per ottenere il massimo da Scribus.

    diff --git a/scribus/doc/it/contributions.html b/scribus/doc/it/contributions.html new file mode 100644 index 0000000..4864833 --- /dev/null +++ b/scribus/doc/it/contributions.html @@ -0,0 +1,46 @@ + + + + Contributions to the Documentation< + + +

    Contributions to the Documentation

    + +

    This Online Help is the latest generation of the Scribus online documentation. The initial documents were written by Peter Linnell with help from Franz Schmid. Since then, the Scribus Team has grown, as did the number of contributions from other people, and we have seen an increasing number of additions and updates. The following table attempts to list the contributors to the documentations. Hopefully we didn’t miss anyone out (if so, please contact us and we will add you in): +

    + +

    Online Help

    + + + + + + + + + + + + + + +
    NameContribution(s)
    Craig BradneySite implementation, management and documentation verification
    Maciej HańskiPHP form document
    Václav HlobilTitle graphics
    Paul JohnsonCoding Standards document
    Riku LeinoGet Text plug-in Howto
    Peter LinnellOriginal documentation
    Gregory PittmanMain author of the next generation of the “Get Started with Scribus” tutorial, one of the main authors of the latest updates to this Online Help, proofeader
    Franz SchmidScribus :) and documentation verification
    Petr VaněkScripter and plug-in documentation
    Craig RingerScripter documentation
    Christoph SchäferOne of the main authors of the latest updates to this Online Help, proofeader, German translation of this Online Help and the Scribus Wiki.
    + +

    Translators of the Online Help

    + + + + + + + +
    NameLanguage(s)
    Louis DesjardinsFrench
    Frederic DubuyFrench
    François Lanctôt, thanks to GRICSFrench
    Volker RibbertGerman
    Johannes RüschelGerman
    + +

    Additional Documentation

    + + + +
    NameContribution(s)
    Niyam BhushanInitial version of the “Get Started with Scribus” tutorial
    +
    + + diff --git a/scribus/doc/it/developers.html b/scribus/doc/it/developers.html new file mode 100644 index 0000000..b7bcae7 --- /dev/null +++ b/scribus/doc/it/developers.html @@ -0,0 +1,14 @@ + + + + For Developers + + +

    For Developers

    + +

    Wanting to help Scribus develop even faster? Want to get your hands dirty with some coding? Got a great idea for new addon functionality for Scribus?

    + +

    Information related to the development of Scribus is here! You have come to the right place. Contact the team to discuss our plans and what we need some help with.

    + + + diff --git a/scribus/doc/it/doccopyright.html b/scribus/doc/it/doccopyright.html new file mode 100644 index 0000000..b9ead16 --- /dev/null +++ b/scribus/doc/it/doccopyright.html @@ -0,0 +1,84 @@ + + + + Copyright Notice and Publication License + + +

    Copyright Notice and Publication License

    + +

    This copyright notice concerns the online and packaged version of the Scribus Online Help, written by the Scribus team composed of Franz Schmid, Peter Linnell, Craig Bradney, Jean Ghali, Hermann Kraus, Riku Leino, Oleksandr Moskalenko, Craig Ringer, Christoph Schäfer, Petr Vaněk, Andreas Vox and Jain Basil with major contributions from Gregory Pittman and addtional documentation by Maciej Hanski. + +

    The “PDF Forms” section is licensed under the Free Documentation License. The FDL applies ONLY to this section of the documentation.

    + +

    The Scribus Online Help (excluding the aforementioned “PDF Form” page) is distributed under the Open Publication License guidelines described at www.opencontent.org.

    + +

    The following is the text of the license as it applies to this work:

    + +

    I. REQUIREMENTS ON BOTH UNMODIFIED AND MODIFIED VERSIONS

    + +

    This online help manual “Scribus Online Help” may be reproduced and distributed in whole or in part, in any medium physical or electronic, provided that the terms of this license are adhered to, and that this license or an incorporation of it by reference is displayed in the reproduction. + +

    Proper form for an incorporation by reference is as follows: + +

    Copyright © 2003–2011 the Scribus team composed of Franz Schmid, Peter Linnell, Craig Bradney, Jean Ghali, Hermann Kraus, Riku Leino, Oleksandr Moskalenko, Craig Ringer, Christoph Schäfer, Petr Vaněk, Andreas Vox and Jain Basil, as well as Gregory Pittman. The material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). + +

    The reference must be immediately followed with the elected options (see section VI). + +

    Commercial redistribution of Open Publication-licensed material is permitted. + +

    II. COPYRIGHT

    + +

    The copyright is owned by Franz Schmid, Peter Linnell, Craig Bradney, Jean Ghali, Hermann Kraus, Riku Leino, Oleksandr Moskalenko, Craig Ringer, Christoph Schäfer, Petr Vaněk, Andreas Vox and Jain Basil, as well as Gregory Pittman.

    + +

    III. SCOPE OF LICENSE

    + +

    Mere aggregation of this work or a portion of this work with other works or programs on the same media shall not cause this license to apply to those other works. The aggregate work shall contain a notice specifying the inclusion of the Open Publication material and appropriate copyright notice.

    + +

    SEVERABILITY. If any part of this license is found to be unenforceable in any jurisdiction, the remaining portions of the license remain in force.

    + +

    NO WARRANTY. Open Publication works are licensed and provided “as is” without warranty of any kind, express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose or a warranty of non-infringement.

    + +

    IV. REQUIREMENTS ON MODIFIED WORKS

    + +

    All modified versions of documents covered by this license, including translations, anthologies, compilations and partial documents, must meet the following requirements:

    + +

    1) The modified version must be labeled as such.

    + +

    2) The person making the modifications must be identified and the modifications dated.

    + +

    3) Acknowledgement of the original author and publisher if applicable must be retained according to normal academic citation practices.

    + +

    4) The location of the original unmodified document must be identified.

    + +

    5) The original author’s name may not be used to assert or imply endorsement of the resulting document without the original author’s (or authors’) permission.

    + +

    V. GOOD-PRACTICE RECOMMENDATIONS

    + +

    In addition to the requirements of this license, it is requested from and strongly recommended of redistributors that:

    + +

    1) If you are distributing Open Publication works on hardcopy or CD-ROM, you provide email notification to the authors of your intent to redistribute at least thirty days before your manuscript or media freeze, to give the authors time to provide updated documents. This notification should describe modifications, if any, made to the document.

    + +

    2) All substantive modifications (including deletions) be either clearly marked up in the document or else described in an attachment to the document.

    + +

    Finally, while it is not mandatory under this license, it is considered good form to offer a free copy of any hardcopy and CD-ROM expression of an Open Publication-licensed work to its author.

    + +

    VI. ELECTED OPTIONS

    + +

    1) Distribution of the work or derivative of the work in any standard (paper) book form is prohibited unless prior permission is obtained from the copyright holder. Other forms of distribution including CD-ROM, electronic, and magnetic media are permitted.

    +

    ===================

    + + + \ No newline at end of file diff --git a/scribus/doc/it/download.html b/scribus/doc/it/download.html new file mode 100644 index 0000000..490eb0e --- /dev/null +++ b/scribus/doc/it/download.html @@ -0,0 +1,20 @@ + + + + Scribus Download + + + +

    Scribus Download

    +

    Scribus is being updated on a regular basis. If you always want to use the latest and greatest stable Scribus version, here are the download resources:

    +

    Pre-compiled Binaries

    +

    Pre-compiled binaries for Mac OS X, OS/2 Warp4/eComStation and Windows are available from our Sourceforge repository.

    +

    RPM packages for most RPM-based Linux distributions are available mrdocs' RPM repository. Simply add the repository for your distribution to your package manager (YaST, yum etc.) to update Scribus automatically.

    +

    For DEB-based distributions (Debian, *buntu), please read the installation instructions.

    +

    Source Code

    +

    Along with the binaries for Mac OS X, OS/2 Warp4/eComStation and Windows, the Scribus Team also makes the Scribus source code of every release available via Sourceforge.

    +

    If you want to enjoy the latest bugfixes and feature enhancements that have been added to the source code, but haven't been released yet, you need to check out SVN. + +
    + + \ No newline at end of file diff --git a/scribus/doc/it/editorial.html b/scribus/doc/it/editorial.html new file mode 100644 index 0000000..9abe71a --- /dev/null +++ b/scribus/doc/it/editorial.html @@ -0,0 +1,20 @@ + + + + Editorial Notes + + +

    Editorial Notes

    +

    General

    +

    The Scribus Online Help is not a complete or detailed description of all the features provided by Scribus. Rather, its purpose is to provide enough information for you to use the program successfully. In addition, the authors intended to introduce those who are new to desktop publishing to concepts that are unique to this very special kind of software, as well as make users aware of traps and pitfalls lurking on the way from creating documents to professional printing.

    +

    This documentation will grow with each Scribus release, so the available information will become more and more complete. In addition, the Scribus Team is working on a new edition of the printed Scribus manual, which will contain even more detailed information and examples.

    +

    Spelling

    +

    The English version of the Scribus Online Help uses (cum grano salis) US spelling. This was simply a pragmatic decision, since two out of three main authors are US citizens. Moreover, while most international standards bodies (most notably ISO) require the use of “International” (read: British) English, it’s hard to imagine that anyone will have difficulties in understanding a text written in US spelling. An exception to the rule is screenshots, which may display the British or Australian version of the user interface.

    +

    Screenshots

    +

    Almost all screenshots in this Online Help have been created under the Fedora or OpenSUSE versions of KDE 4. The dialogs may look slightly different on other operating systems or under other desktop environments, but thanks to the Qt toolkit, there shouldn’t be any differences in actual usage.

    +

    Keyboard Shortcuts

    +

    Unless explicitly mentioned otherwise, all keyboard shortcuts in this Online Help refer to PC keyboards (Linux, UNIX, Windows, OS/2, eComStation).

    +

    Files and Directories

    +

    The authors of this documentation tried and continue to try to treat all supported operating systems equally. However, due to historical reasons, sometimes only file locations on Linux/UNIX may be mentioned. If you discover one of those instances, feel free to notify the development team, so this can be fixed.

    + + diff --git a/scribus/doc/it/faq1.html b/scribus/doc/it/faq1.html new file mode 100644 index 0000000..e559971 --- /dev/null +++ b/scribus/doc/it/faq1.html @@ -0,0 +1,166 @@ + + + + General Questions + + + +

    General Questions

    + + +

    Answers

    + + +

    The Scribus Wiki has an additional FAQ.

    + + diff --git a/scribus/doc/it/faq3.html b/scribus/doc/it/faq3.html new file mode 100644 index 0000000..aeddcd5 --- /dev/null +++ b/scribus/doc/it/faq3.html @@ -0,0 +1,46 @@ + + + + Development Questions + + + +

    Development Questions

    + + +

    Answers

    + + + + diff --git a/scribus/doc/it/fileproblems.html b/scribus/doc/it/fileproblems.html new file mode 100644 index 0000000..da7e08d --- /dev/null +++ b/scribus/doc/it/fileproblems.html @@ -0,0 +1,80 @@ + + + + Problems with Opening Scribus Files + + +

    Problems with Opening Scribus Files

    + +

    Damaged Files

    + +

    Parsing Errors

    +

    One of the major reasons for a damaged file (any file, not just Scribus files) is an interrupted saving procedure, e.g. a power failure or a system crash while the program was writing the data to the storage medium (like a hard drive or a USB stick). Other reasons can be file system errors or a damaged storage medium. Since Scribus SLA (and the older SCD) files are Plain Text XML-based files, these files can also be damaged by users themselves if they open and edit the files in a text editor.

    +

    No matter what the reason for a damage to a particular file may be, the result will be that Scribus can’t “parse” (i.e., in very general terms, read and interpret) the file’s content, e.g. due to missing XML tags or invalid data. In such a case, Scribus will display a warning that indicates the line number of the file in which it stumbled across the error:

    + +
    Indicator for a parsing error
    + +

    To fix damaged SLA and SCD files, a simple text editor is sufficient. For practical reasons, however, it’s recommended that the text editor provide a little more features than, for instance, Notepad on Windows. At the very least, the text editor should be able to show line numbers and support XML syntax highlighting. In case you are unfamiliar with XML concepts like tags etc., you can file a bug report and upload the damaged file to the bugtracker. In general, you can expect the file to be fixed by the developers within 48 hours. Be aware, though, that fixing a file by the developers need not mean that all content can be restored, as not all of it may have been written to the storage medium before the error occured. Thus, repairing a file may only result in a file that can be opened by Scribus again.

    + +

    Other File Errors

    +

    While it’s relatively easy to repair SLA and SCD files, things are more complicated if you’ve been saving a compressed version (SLA.GZ or SCD.GZ). In such a case you will have to use a tool that can either repair a damaged gzip archive or, if the latter is impossible, retrieve as much of the archive’s content as possible.

    + +

    Documents Created with Another Version of Scribus

    + +

    Files Created with an Earlier Version of Scribus

    +

    When you open a file created with an earlier version of Scribus, you will see a warning that you may or may not want to ignore. You can ignore it if you are sure that the file won’t have to be opened in an earlier version again, e.g. if you created the file yourself and simply upgraded to a newer Scribus version. If you’re working in a team, you should always make sure that all team members use the same version of Scribus.

    + +
    Warning about file format backward incompatibilty
    + +

    But what if you ignored the warning or saved the file inadvertently, knowing that your partner has to or wants to use an earlier version? Saving back to an older file format version isn’t possible. What you can do in such a case is to group all items on every page and then copy each group to the Scrapbook, page by page. You can then send your Scrapbook to the person that uses the older version, because the Scrapbook format didn’t change between versions. Be aware, though, that linked text frames on different pages cannot be re-created this way: You’ll have to re-link them in the earlier version.

    +

    While every newer version of Scribus can open files created in older versions, including SCD and SCD.GZ files saved by early 0.x versions from more than a decade ago, you should always check the text layout, because the Scribus text layout algorithms have changed significantly over time. This measure of caution is especially important with older file versions, but it is recommended to always check the text layout if you open the file on another computer or after a font upgrade. While Scribus always does a font check during startup, it does not check for different font versions when it opens a file. Thus, different font versions or fonts with the same PostScript font name, but from different vendors/sources may result in broken text layout, e.g. unintended text overflow.

    + + + + + + +
    A special note about files created with Scribus versions 1.3.5 to 1.4 Release Candidate 5: An important fix to the text layout engine in Scribus 1.4 Release Candidate 6 may cause significant text layout changes in text frames with certain text layout features (e.g. First Line Offset) applied, so re-formatting of text may be necessary in files created in versions prior to 1.4RC6.
    + + +

    Files Created with a Later Version of Scribus or Non-Scribus Files

    +

    Files created in later versions of Scribus cannot be opened by earlier ones. This is even true when both versions use the same file format, e.g. 1.3.9 and 1.4.0. Trying to open a file created in a later version with an earlier one will result in the following warning. This warning will also be displayed if you open a SLA, SLA.GZ, SCD or SCD.GZ file that is no Scribus file at all (there may be other programs that use these file extensions). The same goes, of course, for other file formats that can be opened by Scribus directly.

    + +
    Indicator for a file that has been created with a later version or that isn’t a Scribus file at all
    +

    If you, for one reason or the other, can’t use the latest stable release of Scribus, and your version supports the same file format, you can open the SLA file in a text editor and replace the Scribus version in the file header:

    +

    Example:

    +

    <?xml version="1.0" encoding="UTF-8"?>
    +<SCRIBUSUTF8NEW Version="1.4.0">

    +

    can be changed to:

    +

    <?xml version="1.0" encoding="UTF-8"?>
    +<SCRIBUSUTF8NEW Version="1.3.9">

    +

    Be aware, though, that you do so at your own risk, especially if you consider the changes made to the text layout engine since 1.4RC6.

    +

    Safety Measures

    +

    It may sound like a platitude, but every program and every operating system can crash, which means you may lose some or all of your work. Likewise, no computer is expected to run flawlessly forever and, like all material things, will cease working one day. Thus, the timeless hint “save your file regularly” also applies to Scribus. Fortunately, Scribus allows for automating the saving procedure to let you concentrate on your layout.

    +

    Autosave

    +

    To let Scribus save your results in regular intervals, you can activate “Autosave” and set the interval in the Document section of the Document Setup/Preferences. In addition to automatically saving your Scribus document, Scribus also creates a copy of the document. The copy’s file name consists of the original file name extended by the extension “.autosave”. Thus, the “autosave” copy of myfile.sla will be stored as myfile.sla.autosave. Should a SLA file have been damaged, you can always remove the “.autosave” extension and then open the “autosaved” version in Scribus. This procedure will give you the latest automatically saved version of your Scribus document.

    +

    Emergency Backup Files

    + +

    Other Potential Sources for Errors

    + +

    Missing Images

    +

    Images you have loaded into an image frame will not be stored in your Scribus file. Instead, Scribus will save the path to the image relative the Scribus file. When you open the Scribus file, Scribus will search for the image(s) used in the document in the paths stored in the file and the directory where the Scribus file itself is located. If you have moved either the Scribus file or the image(s) to another directory, Scribus probably won’t find the image(s) and display empty image frames. You can then use Extras > Manage Images to let scribus search for the new location of the image(s).

    +

    If you plan to exchange Scribus files with images between computers, you should always use File > Collect for Output to make sure all images are included.

    +

    Note that bitmap patterns will also have to be treated like regular images.

    + +

    File Substitutions

    +

    Scribus not only saves the paths to images but also paths to other file types used in connection with your documents. These are fonts and color profiles. Upon opening a file, you will be asked to substitute both file types. See the font and color management chapters for more information. Note that substituting fonts and/or color profiles may have consequences for your layout or color correctness. To avoid potential errors, you are advised to export these resources with your Scribus document by using File > Collect for Output.

    + +

    Render Frames

    +

    Since the content of Render Frames will be rendered anew each time you open a file, you have to make sure that third party applications used for rendering content are installed and configured correctly if you are exchanging files between computers and/or platforms. Otherwise, the frames will remain empty.

    + +

    Settings/Preferences

    +

    If, for no obvious reasons, a Scribus installation that used to work without any issues suddenly starts to behave strangely or doesn’t work at all, the reason may be damaged Preferences files. In case you are encountering any strange behavior of Scribus you can try to rename the hidden .scribus directory that contains these files and start Scribus anew. The program will then create new configuration files from scratch. This may or may not solve the issue. If it doesn’t, the reason for your problem is probably unrelated to Scribus, e.g. a hardware issue or compatibility issues after an update of other components of your system, like a Windows update or a Qt4 update under Linux/UNIX. In such a case you can delete the newly created ./scribus directory and restore the previously renamed folder. Of course this won’t solve your problem, but at least you don’t lose your previous default settings that way.

    + +
    + + diff --git a/scribus/doc/it/gettexthowto.html b/scribus/doc/it/gettexthowto.html new file mode 100644 index 0000000..c96751f --- /dev/null +++ b/scribus/doc/it/gettexthowto.html @@ -0,0 +1,153 @@ + + + + How To Write a Scribus Get Text Plugin + + +

    How To Write a Scribus Get Text Plugin

    +

    Plugin interface and article written by Riku Leino

    +

    Preface

    + +

    This article shows you how to write Get Text plugins for Scribus. Plugins are dynamic loaded libraries in "so" format. Get Text Plugins are used to import formatted text from all kinds of file formats into a Scribus text frame.

    + +

    Important

    + +

    Wait here for a while! Maybe you are at the edge of reinventing the wheel - so join the mailing-list or visit #scribus channel at irc.freenode.net. Your topic will be discussed and you'll get support too. We cannot stop you to write anything you want - sure. :)))

    + +

    An Example Plugin

    + +

    myimporter.h

    +
    +
    +#ifndef MYIMPORTER_H
+#define MYIMPORTER_H
+
+#include <scribus.h>
+#include <gtwriter.h>
+
+extern "C" void GetText(QString filename, QString encoding, bool textOnly, gtWriter *writer);
+
+extern "C" QString FileFormatName();
+
+extern "C" QStringList FileExtensions();
+
+#endif // MYIMPORTER_H
+
    +
    +

    Now let's describe the source code. MYIMPORTER_H declaration is the standard way to ensure only one insertion of the header file. Scribus.h is required to access Scribus objects. The function GetText() is called when a user has selected to import a file that has a file extenison which matches one in the QStringList returned by FileExtensions(). FileFormatName() should return the name for the file format this importer works on f.e. "Text files" for plain text importer.

    + +

    GetText parameters

    + + +

    File extensions

    +

    If your plugin is the only plugin for the file format return a QStringList with format's file extensions. If there already is an importer for the format you are also creating an importer for do not return file extensions but an empty QStringList. The most common and used plugin for a file format should return file extensions. Other more rarely used plugins should not return extensions. These plugins can be used by selecting them in the file dialog of Get Text.

    + +

    myimporter.cpp

    +
    +
    +#include "myimporter.h"
+#include <qstring.h>
+#include <qstringlist.h>
+
+QString FileFormatName()
+{
+    return QObject::tr("Nothing to import");
+}
+
+QStringList FileExtensions()
+{
+    // QStringList list("htm"); list << "html" << "php"; return list;
+    return QStringList();
+}
+
+void GetText(QString filename, QString encoding, bool textOnly, gtWriter *writer)
+{
+
+}
+
    +
    + +

    The importnothingplugin-1.0.tar.bz2 from http://docs.scribus.net can be used as a basis of your own get text plugin.

    + +

    How does it work?

    + +

    Text can be appended to a text frame with gtWriter::append() methods. append(QString text) appends text formatted with the style of the text frame. append(QString text, gtStyle *style) will use the style given as a parameter.

    + +

    gtStyle, gtParagraphStyle and gtFrameStyle can be used to set the style for imported text. The easiest way to get started is to use gtWriter's getDefaultStyle() method to get the text frame's current style and then use the gtFrameStyle returned to create new styles.

    + +

    gtStyle works on character styles and can be used inside a paragraph style. gtParagraphStyle creates a paragraph style in Scribus and can be used to apply a paragraph style to the text when importing. gtFrameStyle gives a possibility to change the default style of the text frame. Relation between these three classes is: gtStyle works as a base class. gtParagraphStyle extends gtStyle and gtFrameStyle extends gtParagraphStyle. They all have a gtFont object that can be obtained with getFont() method. gtFont object can be used to set some character based formatting. See the header files: gtfont.h, gtstyle.h, gtparagraphstyle.h and gtframestyle.h to get a better idea of the interfaces.

    + +

    There is also one helper class gtMeasure with static methods to convert length units to points which is the default unit scribus uses internally. For example converting 25 millimeters to points one can use gtMeasure's method i2d() (int to double): gtMeasure::i2d(25, MM). Second parameter tells the unit from where the conversion to points is done. All the possible units are defined as an enumeration Unit (see file gtmeasure.h).

    + +

    Simple example

    + +

    Text to import

    + +Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ut a sapien. Aliquam aliquet purus molestie dolor. Integer quis eros ut erat posuere dictum. Curabitur dignissim. Integer orci. Fusce vulputate lacus at ipsum. Quisque in libero nec mi laoreet volutpat.
    +        Aliquam eros pede, scelerisque quis, tristique cursus, placerat convallis, velit. Nam condimentum. Nulla ut mauris. Curabitur adipiscing, mauris non dictum aliquam, arcu risus dapibus diam, nec sollicitudin quam erat quis ligula. Aenean massa nulla, volutpat eu, accumsan et, fringilla eget, odio. Nulla placerat porta justo. Nulla vitae turpis. Praesent lacus. + +

    Code for import

    + +
    +
    +#include <gtparagraphstyle.h>
+#include <gtframestyle.h>
+#include <gtmeasure.h>
+
+...
+
+void GetText(QString filename, QString encoding, bool textOnly, gtWriter *writer)
+{
+
+/***** Create Paragraph Styles *************************************************/
+    gtFrameStyle* fstyle = writer->getDefaultStyle();
+    
+    gtParagraphStyle* firstPara = new gtParagraphStyle(*fstyle);
+    firstPara->setName("First Paragraph");
+    firstPara->getFont()->setSize(12.0);
+    firstPara->setLineSpacing(14.4);
+    
+    gtParagraphStyle* trailingPara = new gtParagraphStyle(*firstPara);
+    trailingPara->setName("Traling Paragraph");
+    trailingPara->setFirstLineIndent(gtMeasure::i2d(15, MM));
+    
+/***** Import Text *************************************************************/
+    writer->append("Lorem ipsum dolor sit amet, consectetuer adipiscing elit. ", firstPara);
+    
+    QString currentWeight = firstPara->getFont()->getWeight();
+    firstPara->getFont()->setWeight(BOLD); // from enum FontWeight (gtfont.h)
+    writer->append("Ut a sapien.", firstPara); // import with a bold font
+    
+    firstPara->getFont()->setWeight(currentWeight);
+    writer->append(" Aliquam aliquet purus molestie dolor. Integer quis eros ut "
+                   "erat posuere dictum. Curabitur dignissim. Integer orci. Fusce "
+                   "vulputate lacus at ipsum. Quisque in libero nec mi laoreet "
+                   "volutpat.\n", firstPara);
+    
+    // 2nd Paragraph
+    writer->append("Aliquam eros pede, scelerisque quis, tristique cursus, placerat "
+                   "convallis, velit. Nam condimentum. Nulla ut mauris. Curabitur "
+                   "adipiscing, mauris non dictum aliquam, arcu risus dapibus diam, nec "
+                   "sollicitudin quam erat quis ligula. Aenean massa nulla, "
+                   "volutpat eu, accumsan et, fringilla eget, odio. Nulla placerat porta "
+                   "justo. Nulla vitae turpis. Praesent lacus.", trailingPara);
+
+    delete firstPara;
+    delete trailingPara;
+}
+
+...
+
    +
    + +

    Now after right clicking on a text frame, choosing "Get Text..." and selecting our just built importer and opening some file we get a text frame with the sample text formatted correctly.

    +
    Sample frame
    + +

    If you have any questions send mail to Riku Leino (IRC nick:Tsoots) tsoots at gmail.com, register for Scribus mailing list or join the irc channel #scribus at irc.freenode.net.

    + + diff --git a/scribus/doc/it/gsview.html b/scribus/doc/it/gsview.html new file mode 100644 index 0000000..3ce56b8 --- /dev/null +++ b/scribus/doc/it/gsview.html @@ -0,0 +1,95 @@ + + + + + GSview and Scribus + + + +

    GSview*

    + +

    One important thing to note is that GSview must not be confused with ghostview, gv and their derivatives! +Although Adobe Reader® is often a better pure viewer for PDFs, GSview +should be regarded as one of the most essential tools to have when +using +Scribus. GSview has some extremely useful functions. For those +unfamiliar with the program, it provides an easy to use “front end” to +Ghostscript, as well as pstoedit for converting bitmaps +into vector files or vice versa. For those coming from a traditional +DTP background in the Mac/Windows world, it also +provides some of the functionality of Acrobat Distiller.
    +

    + +

    You should always use the latest version, at least 4.7. (GSview +migrated from the +Windows world, where it has been excellent since the 4.x versions.)

    + +

    For use with Scribus, GSview has the following features:

    + + + +

    One example where GSview is extremely useful with Scribus is +troubleshooting or fixing EPS files that do not display correctly +within +Scribus. Although many applications can generate EPS files, some add +their own quirks into the EPS, which can cause problems when used in +other programs (like Scribus).

    + +

    So, if you find difficulty with an EPS you wish to use in +Scribus, open the EPS in GSview. Then, use the key command M +to display messages from Ghostscript. The messages can indicate +problems which cause display or printing errors. You can also use the epswrite +“device” to re-save the EPS, which can help to strip out or fix issues +with an EPS.

    + +

    You can also rasterize an EPS image, by converting it to +PNG +or TIFF and then resize, adjust colors etc with an image program like +GIMP or Krita.
    +

    + +

    Note that GSview uses the libgs.so shared library to +access Ghostscript. Not all Linux distributions ship this, so the hints +for compiling Ghostscript with a paralell install really apply here.

    + +

    Getting Gsview:

    + +

    GSview is available for most Linux distributions, at least the major +ones. Otherwise you can build GSview by following +the instructions provided in the source package. For +Windows and OS/2 and eComStation you can download conventional +installers . +Unfortunately, there is no current version for Mac OS X available.

    + +

    A special note to users of OpenSUSE 11.3: The required GTK 1 +libraries are no longer available for this Linux distribution, but you +can use the versions +compiled for 11.2. You need to install the gtk-1.20 and glib +packages (if you want to build GSview yourself, you also need the +respective devel RPMs), as well as the lang +package.
    +

    + +

    Now, for advanced hints with GSview and Ghostscript, see: Advanced Ghostscript and GSview Hints

    + +

    *) Parts of this section are +thanks to Russell Lang, author and maintainer of GSview, epstool and +Ghostscript for his hints and patiently answering questions about +GSview and Ghostscript.

    + + \ No newline at end of file diff --git a/scribus/doc/it/images/CMakeLists.txt b/scribus/doc/it/images/CMakeLists.txt index 481a0bc..efb8307 100644 --- a/scribus/doc/it/images/CMakeLists.txt +++ b/scribus/doc/it/images/CMakeLists.txt @@ -3,7 +3,7 @@ INCLUDE_DIRECTORIES( ) #Install our image files -FILE( GLOB SCRIBUS_DOC_IT_IMAGES_FILES *.jpg *.png ) +FILE( GLOB SCRIBUS_DOC_EN_IMAGES_FILES *.jpg *.png ) -INSTALL(FILES ${SCRIBUS_DOC_IT_IMAGES_FILES} DESTINATION ${DOCDIR}it/images) +INSTALL(FILES ${SCRIBUS_DOC_EN_IMAGES_FILES} DESTINATION ${DOCDIR}en/images) diff --git a/scribus/doc/it/images/Cover_en1-page1.png b/scribus/doc/it/images/Cover_en1-page1.png new file mode 100644 index 0000000..844b21b Binary files /dev/null and b/scribus/doc/it/images/Cover_en1-page1.png differ diff --git a/scribus/doc/it/images/DrawLatexFrame.png b/scribus/doc/it/images/DrawLatexFrame.png new file mode 100644 index 0000000..d5982d4 Binary files /dev/null and b/scribus/doc/it/images/DrawLatexFrame.png differ diff --git a/scribus/doc/it/images/Mantis_my_view.png b/scribus/doc/it/images/Mantis_my_view.png new file mode 100644 index 0000000..bab7a7f Binary files /dev/null and b/scribus/doc/it/images/Mantis_my_view.png differ diff --git a/scribus/doc/it/images/Mantis_new_report1.png b/scribus/doc/it/images/Mantis_new_report1.png new file mode 100644 index 0000000..1c82c01 Binary files /dev/null and b/scribus/doc/it/images/Mantis_new_report1.png differ diff --git a/scribus/doc/it/images/Mantis_new_report2.png b/scribus/doc/it/images/Mantis_new_report2.png new file mode 100644 index 0000000..9dc91d7 Binary files /dev/null and b/scribus/doc/it/images/Mantis_new_report2.png differ diff --git a/scribus/doc/it/images/Mantis_new_report3.png b/scribus/doc/it/images/Mantis_new_report3.png new file mode 100644 index 0000000..f32a1b9 Binary files /dev/null and b/scribus/doc/it/images/Mantis_new_report3.png differ diff --git a/scribus/doc/it/images/Mantis_searching.png b/scribus/doc/it/images/Mantis_searching.png new file mode 100644 index 0000000..b5addb1 Binary files /dev/null and b/scribus/doc/it/images/Mantis_searching.png differ diff --git a/scribus/doc/it/images/Mantis_signup.png b/scribus/doc/it/images/Mantis_signup.png new file mode 100644 index 0000000..34d1c16 Binary files /dev/null and b/scribus/doc/it/images/Mantis_signup.png differ diff --git a/scribus/doc/it/images/RYB_color_wheel.png b/scribus/doc/it/images/RYB_color_wheel.png new file mode 100644 index 0000000..db06b3f Binary files /dev/null and b/scribus/doc/it/images/RYB_color_wheel.png differ diff --git a/scribus/doc/it/images/Rembrandt1.png b/scribus/doc/it/images/Rembrandt1.png new file mode 100755 index 0000000..fc4cc4c Binary files /dev/null and b/scribus/doc/it/images/Rembrandt1.png differ diff --git a/scribus/doc/it/images/Rembrandt10.png b/scribus/doc/it/images/Rembrandt10.png new file mode 100755 index 0000000..9cd8ec8 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt10.png differ diff --git a/scribus/doc/it/images/Rembrandt11.png b/scribus/doc/it/images/Rembrandt11.png new file mode 100755 index 0000000..b7b6ae5 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt11.png differ diff --git a/scribus/doc/it/images/Rembrandt12.png b/scribus/doc/it/images/Rembrandt12.png new file mode 100755 index 0000000..deb0d09 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt12.png differ diff --git a/scribus/doc/it/images/Rembrandt13.png b/scribus/doc/it/images/Rembrandt13.png new file mode 100755 index 0000000..7192e7b Binary files /dev/null and b/scribus/doc/it/images/Rembrandt13.png differ diff --git a/scribus/doc/it/images/Rembrandt14.png b/scribus/doc/it/images/Rembrandt14.png new file mode 100755 index 0000000..ad964ee Binary files /dev/null and b/scribus/doc/it/images/Rembrandt14.png differ diff --git a/scribus/doc/it/images/Rembrandt15.png b/scribus/doc/it/images/Rembrandt15.png new file mode 100755 index 0000000..8842923 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt15.png differ diff --git a/scribus/doc/it/images/Rembrandt16.png b/scribus/doc/it/images/Rembrandt16.png new file mode 100755 index 0000000..abb5cbf Binary files /dev/null and b/scribus/doc/it/images/Rembrandt16.png differ diff --git a/scribus/doc/it/images/Rembrandt17.png b/scribus/doc/it/images/Rembrandt17.png new file mode 100755 index 0000000..a0d4f09 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt17.png differ diff --git a/scribus/doc/it/images/Rembrandt17a.png b/scribus/doc/it/images/Rembrandt17a.png new file mode 100755 index 0000000..7d98c57 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt17a.png differ diff --git a/scribus/doc/it/images/Rembrandt17b.png b/scribus/doc/it/images/Rembrandt17b.png new file mode 100755 index 0000000..7ff19ff Binary files /dev/null and b/scribus/doc/it/images/Rembrandt17b.png differ diff --git a/scribus/doc/it/images/Rembrandt18.png b/scribus/doc/it/images/Rembrandt18.png new file mode 100755 index 0000000..fb35d91 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt18.png differ diff --git a/scribus/doc/it/images/Rembrandt18b.png b/scribus/doc/it/images/Rembrandt18b.png new file mode 100755 index 0000000..0601aa3 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt18b.png differ diff --git a/scribus/doc/it/images/Rembrandt19.png b/scribus/doc/it/images/Rembrandt19.png new file mode 100755 index 0000000..74fefe6 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt19.png differ diff --git a/scribus/doc/it/images/Rembrandt2.png b/scribus/doc/it/images/Rembrandt2.png new file mode 100755 index 0000000..e3f7df6 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt2.png differ diff --git a/scribus/doc/it/images/Rembrandt20.png b/scribus/doc/it/images/Rembrandt20.png new file mode 100755 index 0000000..9704294 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt20.png differ diff --git a/scribus/doc/it/images/Rembrandt21.png b/scribus/doc/it/images/Rembrandt21.png new file mode 100755 index 0000000..9456f6e Binary files /dev/null and b/scribus/doc/it/images/Rembrandt21.png differ diff --git a/scribus/doc/it/images/Rembrandt3.png b/scribus/doc/it/images/Rembrandt3.png new file mode 100755 index 0000000..d5cb93c Binary files /dev/null and b/scribus/doc/it/images/Rembrandt3.png differ diff --git a/scribus/doc/it/images/Rembrandt4.png b/scribus/doc/it/images/Rembrandt4.png new file mode 100755 index 0000000..ba431b6 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt4.png differ diff --git a/scribus/doc/it/images/Rembrandt5.png b/scribus/doc/it/images/Rembrandt5.png new file mode 100755 index 0000000..83dbf3a Binary files /dev/null and b/scribus/doc/it/images/Rembrandt5.png differ diff --git a/scribus/doc/it/images/Rembrandt6.png b/scribus/doc/it/images/Rembrandt6.png new file mode 100755 index 0000000..521e4a0 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt6.png differ diff --git a/scribus/doc/it/images/Rembrandt7.png b/scribus/doc/it/images/Rembrandt7.png new file mode 100755 index 0000000..13428d1 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt7.png differ diff --git a/scribus/doc/it/images/Rembrandt8.png b/scribus/doc/it/images/Rembrandt8.png new file mode 100755 index 0000000..77a3a52 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt8.png differ diff --git a/scribus/doc/it/images/Rembrandt9.png b/scribus/doc/it/images/Rembrandt9.png new file mode 100755 index 0000000..d647df9 Binary files /dev/null and b/scribus/doc/it/images/Rembrandt9.png differ diff --git a/scribus/doc/it/images/Scripter.png b/scribus/doc/it/images/Scripter.png new file mode 100644 index 0000000..10a68e0 Binary files /dev/null and b/scribus/doc/it/images/Scripter.png differ diff --git a/scribus/doc/it/images/SwB.png b/scribus/doc/it/images/SwB.png new file mode 100644 index 0000000..1677233 Binary files /dev/null and b/scribus/doc/it/images/SwB.png differ diff --git a/scribus/doc/it/images/alert.png b/scribus/doc/it/images/alert.png new file mode 100644 index 0000000..de5ef12 Binary files /dev/null and b/scribus/doc/it/images/alert.png differ diff --git a/scribus/doc/it/images/batik1.png b/scribus/doc/it/images/batik1.png new file mode 100644 index 0000000..ab65dcd Binary files /dev/null and b/scribus/doc/it/images/batik1.png differ diff --git a/scribus/doc/it/images/boundingbox.png b/scribus/doc/it/images/boundingbox.png new file mode 100755 index 0000000..b6bfdf7 Binary files /dev/null and b/scribus/doc/it/images/boundingbox.png differ diff --git a/scribus/doc/it/images/boundingbox1.png b/scribus/doc/it/images/boundingbox1.png new file mode 100755 index 0000000..eed45d8 Binary files /dev/null and b/scribus/doc/it/images/boundingbox1.png differ diff --git a/scribus/doc/it/images/cms-gamut1.png b/scribus/doc/it/images/cms-gamut1.png new file mode 100644 index 0000000..29a8c5e Binary files /dev/null and b/scribus/doc/it/images/cms-gamut1.png differ diff --git a/scribus/doc/it/images/cms-gamut2.png b/scribus/doc/it/images/cms-gamut2.png new file mode 100644 index 0000000..7517ae0 Binary files /dev/null and b/scribus/doc/it/images/cms-gamut2.png differ diff --git a/scribus/doc/it/images/cmsmodify1.png b/scribus/doc/it/images/cmsmodify1.png new file mode 100644 index 0000000..a2eaed5 Binary files /dev/null and b/scribus/doc/it/images/cmsmodify1.png differ diff --git a/scribus/doc/it/images/cmyk.png b/scribus/doc/it/images/cmyk.png new file mode 100644 index 0000000..b6a5c18 Binary files /dev/null and b/scribus/doc/it/images/cmyk.png differ diff --git a/scribus/doc/it/images/colormanager2.png b/scribus/doc/it/images/colormanager2.png new file mode 100644 index 0000000..814945f Binary files /dev/null and b/scribus/doc/it/images/colormanager2.png differ diff --git a/scribus/doc/it/images/colorwheel.png b/scribus/doc/it/images/colorwheel.png new file mode 100644 index 0000000..0d8b97e Binary files /dev/null and b/scribus/doc/it/images/colorwheel.png differ diff --git a/scribus/doc/it/images/colrs-caricature.png b/scribus/doc/it/images/colrs-caricature.png new file mode 100644 index 0000000..d58c87f Binary files /dev/null and b/scribus/doc/it/images/colrs-caricature.png differ diff --git a/scribus/doc/it/images/colrs-mgt1.png b/scribus/doc/it/images/colrs-mgt1.png new file mode 100644 index 0000000..8365388 Binary files /dev/null and b/scribus/doc/it/images/colrs-mgt1.png differ diff --git a/scribus/doc/it/images/colrs-mgt2.png b/scribus/doc/it/images/colrs-mgt2.png new file mode 100644 index 0000000..b1bf9ba Binary files /dev/null and b/scribus/doc/it/images/colrs-mgt2.png differ diff --git a/scribus/doc/it/images/combine_polygons.png b/scribus/doc/it/images/combine_polygons.png new file mode 100755 index 0000000..a25648b Binary files /dev/null and b/scribus/doc/it/images/combine_polygons.png differ diff --git a/scribus/doc/it/images/combine_polygons1.png b/scribus/doc/it/images/combine_polygons1.png new file mode 100755 index 0000000..53dc1d5 Binary files /dev/null and b/scribus/doc/it/images/combine_polygons1.png differ diff --git a/scribus/doc/it/images/combine_polygons2.png b/scribus/doc/it/images/combine_polygons2.png new file mode 100755 index 0000000..99ba387 Binary files /dev/null and b/scribus/doc/it/images/combine_polygons2.png differ diff --git a/scribus/doc/it/images/combine_polygons3.png b/scribus/doc/it/images/combine_polygons3.png new file mode 100755 index 0000000..5d658b7 Binary files /dev/null and b/scribus/doc/it/images/combine_polygons3.png differ diff --git a/scribus/doc/it/images/combine_polygons4.png b/scribus/doc/it/images/combine_polygons4.png new file mode 100755 index 0000000..f00d711 Binary files /dev/null and b/scribus/doc/it/images/combine_polygons4.png differ diff --git a/scribus/doc/it/images/combine_polygons5.png b/scribus/doc/it/images/combine_polygons5.png new file mode 100755 index 0000000..ee001ce Binary files /dev/null and b/scribus/doc/it/images/combine_polygons5.png differ diff --git a/scribus/doc/it/images/context_shape.png b/scribus/doc/it/images/context_shape.png new file mode 100644 index 0000000..50e2710 Binary files /dev/null and b/scribus/doc/it/images/context_shape.png differ diff --git a/scribus/doc/it/images/contourline_flow.png b/scribus/doc/it/images/contourline_flow.png new file mode 100755 index 0000000..6d3a1a1 Binary files /dev/null and b/scribus/doc/it/images/contourline_flow.png differ diff --git a/scribus/doc/it/images/cw-analogous.png b/scribus/doc/it/images/cw-analogous.png new file mode 100644 index 0000000..45cc043 Binary files /dev/null and b/scribus/doc/it/images/cw-analogous.png differ diff --git a/scribus/doc/it/images/cw-compl.png b/scribus/doc/it/images/cw-compl.png new file mode 100644 index 0000000..249e602 Binary files /dev/null and b/scribus/doc/it/images/cw-compl.png differ diff --git a/scribus/doc/it/images/cw-splitcompl.png b/scribus/doc/it/images/cw-splitcompl.png new file mode 100644 index 0000000..5aa2a13 Binary files /dev/null and b/scribus/doc/it/images/cw-splitcompl.png differ diff --git a/scribus/doc/it/images/cw-tetradic.png b/scribus/doc/it/images/cw-tetradic.png new file mode 100644 index 0000000..33a654d Binary files /dev/null and b/scribus/doc/it/images/cw-tetradic.png differ diff --git a/scribus/doc/it/images/cw-triadic.png b/scribus/doc/it/images/cw-triadic.png new file mode 100644 index 0000000..2153265 Binary files /dev/null and b/scribus/doc/it/images/cw-triadic.png differ diff --git a/scribus/doc/it/images/cw-warning.png b/scribus/doc/it/images/cw-warning.png new file mode 100644 index 0000000..5db834a Binary files /dev/null and b/scribus/doc/it/images/cw-warning.png differ diff --git a/scribus/doc/it/images/docheader1.png b/scribus/doc/it/images/docheader1.png new file mode 100755 index 0000000..401f68f Binary files /dev/null and b/scribus/doc/it/images/docheader1.png differ diff --git a/scribus/doc/it/images/docheader2.png b/scribus/doc/it/images/docheader2.png new file mode 100755 index 0000000..bc5c9eb Binary files /dev/null and b/scribus/doc/it/images/docheader2.png differ diff --git a/scribus/doc/it/images/dtp-studio.png b/scribus/doc/it/images/dtp-studio.png new file mode 100644 index 0000000..d91589d Binary files /dev/null and b/scribus/doc/it/images/dtp-studio.png differ diff --git a/scribus/doc/it/images/duotone-imp.png b/scribus/doc/it/images/duotone-imp.png new file mode 100644 index 0000000..d6afec7 Binary files /dev/null and b/scribus/doc/it/images/duotone-imp.png differ diff --git a/scribus/doc/it/images/duotone-imp2.png b/scribus/doc/it/images/duotone-imp2.png new file mode 100644 index 0000000..959b95a Binary files /dev/null and b/scribus/doc/it/images/duotone-imp2.png differ diff --git a/scribus/doc/it/images/edit_shapes.png b/scribus/doc/it/images/edit_shapes.png new file mode 100755 index 0000000..c85387c Binary files /dev/null and b/scribus/doc/it/images/edit_shapes.png differ diff --git a/scribus/doc/it/images/editcols1.png b/scribus/doc/it/images/editcols1.png new file mode 100644 index 0000000..b4d0f31 Binary files /dev/null and b/scribus/doc/it/images/editcols1.png differ diff --git a/scribus/doc/it/images/editcols1a.png b/scribus/doc/it/images/editcols1a.png new file mode 100644 index 0000000..863432d Binary files /dev/null and b/scribus/doc/it/images/editcols1a.png differ diff --git a/scribus/doc/it/images/editcols2.png b/scribus/doc/it/images/editcols2.png new file mode 100644 index 0000000..5cc7b10 Binary files /dev/null and b/scribus/doc/it/images/editcols2.png differ diff --git a/scribus/doc/it/images/editcols3.png b/scribus/doc/it/images/editcols3.png new file mode 100644 index 0000000..b4c14cd Binary files /dev/null and b/scribus/doc/it/images/editcols3.png differ diff --git a/scribus/doc/it/images/eps-imp1.png b/scribus/doc/it/images/eps-imp1.png new file mode 100644 index 0000000..577ed62 Binary files /dev/null and b/scribus/doc/it/images/eps-imp1.png differ diff --git a/scribus/doc/it/images/eps-imp2.png b/scribus/doc/it/images/eps-imp2.png new file mode 100644 index 0000000..572a123 Binary files /dev/null and b/scribus/doc/it/images/eps-imp2.png differ diff --git a/scribus/doc/it/images/eps-imp3.png b/scribus/doc/it/images/eps-imp3.png new file mode 100644 index 0000000..673d063 Binary files /dev/null and b/scribus/doc/it/images/eps-imp3.png differ diff --git a/scribus/doc/it/images/eps-imp4.png b/scribus/doc/it/images/eps-imp4.png new file mode 100644 index 0000000..17e460c Binary files /dev/null and b/scribus/doc/it/images/eps-imp4.png differ diff --git a/scribus/doc/it/images/eps-imp5.png b/scribus/doc/it/images/eps-imp5.png new file mode 100644 index 0000000..e9406a3 Binary files /dev/null and b/scribus/doc/it/images/eps-imp5.png differ diff --git a/scribus/doc/it/images/file-error1.png b/scribus/doc/it/images/file-error1.png new file mode 100644 index 0000000..c931189 Binary files /dev/null and b/scribus/doc/it/images/file-error1.png differ diff --git a/scribus/doc/it/images/file-error2.png b/scribus/doc/it/images/file-error2.png new file mode 100644 index 0000000..c1fcb19 Binary files /dev/null and b/scribus/doc/it/images/file-error2.png differ diff --git a/scribus/doc/it/images/file-error3.png b/scribus/doc/it/images/file-error3.png new file mode 100644 index 0000000..8bb6ed4 Binary files /dev/null and b/scribus/doc/it/images/file-error3.png differ diff --git a/scribus/doc/it/images/fileimport.png b/scribus/doc/it/images/fileimport.png new file mode 100644 index 0000000..cc67665 Binary files /dev/null and b/scribus/doc/it/images/fileimport.png differ diff --git a/scribus/doc/it/images/fontmatrix.png b/scribus/doc/it/images/fontmatrix.png new file mode 100644 index 0000000..2ee6a9a Binary files /dev/null and b/scribus/doc/it/images/fontmatrix.png differ diff --git a/scribus/doc/it/images/fonts.png b/scribus/doc/it/images/fonts.png new file mode 100644 index 0000000..a343db9 Binary files /dev/null and b/scribus/doc/it/images/fonts.png differ diff --git a/scribus/doc/it/images/fonts2.png b/scribus/doc/it/images/fonts2.png new file mode 100644 index 0000000..3665a67 Binary files /dev/null and b/scribus/doc/it/images/fonts2.png differ diff --git a/scribus/doc/it/images/frame_shape_flow.png b/scribus/doc/it/images/frame_shape_flow.png new file mode 100755 index 0000000..1ce6137 Binary files /dev/null and b/scribus/doc/it/images/frame_shape_flow.png differ diff --git a/scribus/doc/it/images/geometry.png b/scribus/doc/it/images/geometry.png new file mode 100644 index 0000000..572ea1f Binary files /dev/null and b/scribus/doc/it/images/geometry.png differ diff --git a/scribus/doc/it/images/geometry1.png b/scribus/doc/it/images/geometry1.png new file mode 100644 index 0000000..939a033 Binary files /dev/null and b/scribus/doc/it/images/geometry1.png differ diff --git a/scribus/doc/it/images/gimpoptions1.png b/scribus/doc/it/images/gimpoptions1.png new file mode 100644 index 0000000..a7a5fe7 Binary files /dev/null and b/scribus/doc/it/images/gimpoptions1.png differ diff --git a/scribus/doc/it/images/gimpoptions2.png b/scribus/doc/it/images/gimpoptions2.png new file mode 100644 index 0000000..2e89970 Binary files /dev/null and b/scribus/doc/it/images/gimpoptions2.png differ diff --git a/scribus/doc/it/images/gimpoptions3.png b/scribus/doc/it/images/gimpoptions3.png new file mode 100644 index 0000000..2adbff7 Binary files /dev/null and b/scribus/doc/it/images/gimpoptions3.png differ diff --git a/scribus/doc/it/images/givelife1.png b/scribus/doc/it/images/givelife1.png new file mode 100644 index 0000000..8cd5017 Binary files /dev/null and b/scribus/doc/it/images/givelife1.png differ diff --git a/scribus/doc/it/images/gradient_adjuster.png b/scribus/doc/it/images/gradient_adjuster.png new file mode 100644 index 0000000..1698e7c Binary files /dev/null and b/scribus/doc/it/images/gradient_adjuster.png differ diff --git a/scribus/doc/it/images/gradient_adjuster1.png b/scribus/doc/it/images/gradient_adjuster1.png new file mode 100644 index 0000000..c2bf81d Binary files /dev/null and b/scribus/doc/it/images/gradient_adjuster1.png differ diff --git a/scribus/doc/it/images/gradient_adjuster_vector.png b/scribus/doc/it/images/gradient_adjuster_vector.png new file mode 100644 index 0000000..59ee068 Binary files /dev/null and b/scribus/doc/it/images/gradient_adjuster_vector.png differ diff --git a/scribus/doc/it/images/htmlimport.png b/scribus/doc/it/images/htmlimport.png new file mode 100644 index 0000000..a176ba2 Binary files /dev/null and b/scribus/doc/it/images/htmlimport.png differ diff --git a/scribus/doc/it/images/htmlstyle.png b/scribus/doc/it/images/htmlstyle.png new file mode 100644 index 0000000..0c88245 Binary files /dev/null and b/scribus/doc/it/images/htmlstyle.png differ diff --git a/scribus/doc/it/images/import-pdfimage.png b/scribus/doc/it/images/import-pdfimage.png new file mode 100644 index 0000000..e568538 Binary files /dev/null and b/scribus/doc/it/images/import-pdfimage.png differ diff --git a/scribus/doc/it/images/ink-cov.png b/scribus/doc/it/images/ink-cov.png new file mode 100644 index 0000000..b41c458 Binary files /dev/null and b/scribus/doc/it/images/ink-cov.png differ diff --git a/scribus/doc/it/images/insert-frame-1.png b/scribus/doc/it/images/insert-frame-1.png new file mode 100644 index 0000000..60ff4eb Binary files /dev/null and b/scribus/doc/it/images/insert-frame-1.png differ diff --git a/scribus/doc/it/images/insert-frame-2.png b/scribus/doc/it/images/insert-frame-2.png new file mode 100644 index 0000000..a2f0d5e Binary files /dev/null and b/scribus/doc/it/images/insert-frame-2.png differ diff --git a/scribus/doc/it/images/krita1.jpg b/scribus/doc/it/images/krita1.jpg new file mode 100644 index 0000000..d184be5 Binary files /dev/null and b/scribus/doc/it/images/krita1.jpg differ diff --git a/scribus/doc/it/images/layers1.png b/scribus/doc/it/images/layers1.png new file mode 100644 index 0000000..1c8a999 Binary files /dev/null and b/scribus/doc/it/images/layers1.png differ diff --git a/scribus/doc/it/images/layers2.png b/scribus/doc/it/images/layers2.png new file mode 100644 index 0000000..58ff24b Binary files /dev/null and b/scribus/doc/it/images/layers2.png differ diff --git a/scribus/doc/it/images/lilyp.png b/scribus/doc/it/images/lilyp.png new file mode 100644 index 0000000..7de1b20 Binary files /dev/null and b/scribus/doc/it/images/lilyp.png differ diff --git a/scribus/doc/it/images/line_tab.png b/scribus/doc/it/images/line_tab.png new file mode 100755 index 0000000..305d029 Binary files /dev/null and b/scribus/doc/it/images/line_tab.png differ diff --git a/scribus/doc/it/images/line_tab1.png b/scribus/doc/it/images/line_tab1.png new file mode 100755 index 0000000..c78207b Binary files /dev/null and b/scribus/doc/it/images/line_tab1.png differ diff --git a/scribus/doc/it/images/line_tab2.png b/scribus/doc/it/images/line_tab2.png new file mode 100755 index 0000000..dd127e5 Binary files /dev/null and b/scribus/doc/it/images/line_tab2.png differ diff --git a/scribus/doc/it/images/line_tab3.png b/scribus/doc/it/images/line_tab3.png new file mode 100644 index 0000000..69abe7c Binary files /dev/null and b/scribus/doc/it/images/line_tab3.png differ diff --git a/scribus/doc/it/images/line_tab4.png b/scribus/doc/it/images/line_tab4.png new file mode 100755 index 0000000..869b06c Binary files /dev/null and b/scribus/doc/it/images/line_tab4.png differ diff --git a/scribus/doc/it/images/line_tab5.png b/scribus/doc/it/images/line_tab5.png new file mode 100755 index 0000000..29c30fc Binary files /dev/null and b/scribus/doc/it/images/line_tab5.png differ diff --git a/scribus/doc/it/images/line_tab6.png b/scribus/doc/it/images/line_tab6.png new file mode 100644 index 0000000..e184bd2 Binary files /dev/null and b/scribus/doc/it/images/line_tab6.png differ diff --git a/scribus/doc/it/images/line_tab7.png b/scribus/doc/it/images/line_tab7.png new file mode 100644 index 0000000..fc06490 Binary files /dev/null and b/scribus/doc/it/images/line_tab7.png differ diff --git a/scribus/doc/it/images/lprof.png b/scribus/doc/it/images/lprof.png new file mode 100644 index 0000000..e2d0bfa Binary files /dev/null and b/scribus/doc/it/images/lprof.png differ diff --git a/scribus/doc/it/images/missing-gs.png b/scribus/doc/it/images/missing-gs.png new file mode 100644 index 0000000..f2c929b Binary files /dev/null and b/scribus/doc/it/images/missing-gs.png differ diff --git a/scribus/doc/it/images/mpage1.png b/scribus/doc/it/images/mpage1.png new file mode 100644 index 0000000..ac63951 Binary files /dev/null and b/scribus/doc/it/images/mpage1.png differ diff --git a/scribus/doc/it/images/mpage2.png b/scribus/doc/it/images/mpage2.png new file mode 100644 index 0000000..375799b Binary files /dev/null and b/scribus/doc/it/images/mpage2.png differ diff --git a/scribus/doc/it/images/mpage3.png b/scribus/doc/it/images/mpage3.png new file mode 100644 index 0000000..baa13a0 Binary files /dev/null and b/scribus/doc/it/images/mpage3.png differ diff --git a/scribus/doc/it/images/mpage4.png b/scribus/doc/it/images/mpage4.png new file mode 100644 index 0000000..857dbd2 Binary files /dev/null and b/scribus/doc/it/images/mpage4.png differ diff --git a/scribus/doc/it/images/mpage5.png b/scribus/doc/it/images/mpage5.png new file mode 100644 index 0000000..2ab58e7 Binary files /dev/null and b/scribus/doc/it/images/mpage5.png differ diff --git a/scribus/doc/it/images/multipledup_copies.png b/scribus/doc/it/images/multipledup_copies.png new file mode 100644 index 0000000..42c29d9 Binary files /dev/null and b/scribus/doc/it/images/multipledup_copies.png differ diff --git a/scribus/doc/it/images/multipledup_rotation.png b/scribus/doc/it/images/multipledup_rotation.png new file mode 100644 index 0000000..145d687 Binary files /dev/null and b/scribus/doc/it/images/multipledup_rotation.png differ diff --git a/scribus/doc/it/images/multipledup_rows.png b/scribus/doc/it/images/multipledup_rows.png new file mode 100644 index 0000000..66b3a96 Binary files /dev/null and b/scribus/doc/it/images/multipledup_rows.png differ diff --git a/scribus/doc/it/images/new1.png b/scribus/doc/it/images/new1.png new file mode 100644 index 0000000..5e00d3a Binary files /dev/null and b/scribus/doc/it/images/new1.png differ diff --git a/scribus/doc/it/images/new2.png b/scribus/doc/it/images/new2.png new file mode 100644 index 0000000..7d8844e Binary files /dev/null and b/scribus/doc/it/images/new2.png differ diff --git a/scribus/doc/it/images/new3.png b/scribus/doc/it/images/new3.png new file mode 100644 index 0000000..19c7f88 Binary files /dev/null and b/scribus/doc/it/images/new3.png differ diff --git a/scribus/doc/it/images/new4.png b/scribus/doc/it/images/new4.png new file mode 100644 index 0000000..84db151 Binary files /dev/null and b/scribus/doc/it/images/new4.png differ diff --git a/scribus/doc/it/images/new5.png b/scribus/doc/it/images/new5.png new file mode 100644 index 0000000..2723495 Binary files /dev/null and b/scribus/doc/it/images/new5.png differ diff --git a/scribus/doc/it/images/new6.png b/scribus/doc/it/images/new6.png new file mode 100644 index 0000000..6cc0cce Binary files /dev/null and b/scribus/doc/it/images/new6.png differ diff --git a/scribus/doc/it/images/node_edit_close.png b/scribus/doc/it/images/node_edit_close.png new file mode 100644 index 0000000..4448527 Binary files /dev/null and b/scribus/doc/it/images/node_edit_close.png differ diff --git a/scribus/doc/it/images/nodes_edit.png b/scribus/doc/it/images/nodes_edit.png new file mode 100644 index 0000000..dcffb0d Binary files /dev/null and b/scribus/doc/it/images/nodes_edit.png differ diff --git a/scribus/doc/it/images/numb-sections.png b/scribus/doc/it/images/numb-sections.png new file mode 100644 index 0000000..6d05495 Binary files /dev/null and b/scribus/doc/it/images/numb-sections.png differ diff --git a/scribus/doc/it/images/oogettext1.png b/scribus/doc/it/images/oogettext1.png new file mode 100644 index 0000000..8354aa3 Binary files /dev/null and b/scribus/doc/it/images/oogettext1.png differ diff --git a/scribus/doc/it/images/patterns1.png b/scribus/doc/it/images/patterns1.png new file mode 100644 index 0000000..0f76421 Binary files /dev/null and b/scribus/doc/it/images/patterns1.png differ diff --git a/scribus/doc/it/images/patterns2.png b/scribus/doc/it/images/patterns2.png new file mode 100644 index 0000000..92dd930 Binary files /dev/null and b/scribus/doc/it/images/patterns2.png differ diff --git a/scribus/doc/it/images/pdf-form-ht1.png b/scribus/doc/it/images/pdf-form-ht1.png new file mode 100644 index 0000000..6931ec5 Binary files /dev/null and b/scribus/doc/it/images/pdf-form-ht1.png differ diff --git a/scribus/doc/it/images/pdf-form-ht2.png b/scribus/doc/it/images/pdf-form-ht2.png new file mode 100644 index 0000000..69353ac Binary files /dev/null and b/scribus/doc/it/images/pdf-form-ht2.png differ diff --git a/scribus/doc/it/images/pdf-form-ht3.png b/scribus/doc/it/images/pdf-form-ht3.png new file mode 100644 index 0000000..2a659a8 Binary files /dev/null and b/scribus/doc/it/images/pdf-form-ht3.png differ diff --git a/scribus/doc/it/images/pdf-form-ht4.png b/scribus/doc/it/images/pdf-form-ht4.png new file mode 100644 index 0000000..cb09e5d Binary files /dev/null and b/scribus/doc/it/images/pdf-form-ht4.png differ diff --git a/scribus/doc/it/images/pdf-form-ht5.png b/scribus/doc/it/images/pdf-form-ht5.png new file mode 100644 index 0000000..f53b709 Binary files /dev/null and b/scribus/doc/it/images/pdf-form-ht5.png differ diff --git a/scribus/doc/it/images/pdf-form-ht6.png b/scribus/doc/it/images/pdf-form-ht6.png new file mode 100644 index 0000000..e3b74e6 Binary files /dev/null and b/scribus/doc/it/images/pdf-form-ht6.png differ diff --git a/scribus/doc/it/images/pdfx1a-lo.png b/scribus/doc/it/images/pdfx1a-lo.png new file mode 100644 index 0000000..dd85849 Binary files /dev/null and b/scribus/doc/it/images/pdfx1a-lo.png differ diff --git a/scribus/doc/it/images/pdfx3-1.png b/scribus/doc/it/images/pdfx3-1.png new file mode 100644 index 0000000..ce05547 Binary files /dev/null and b/scribus/doc/it/images/pdfx3-1.png differ diff --git a/scribus/doc/it/images/pdfxcolor.png b/scribus/doc/it/images/pdfxcolor.png new file mode 100644 index 0000000..dd0de1b Binary files /dev/null and b/scribus/doc/it/images/pdfxcolor.png differ diff --git a/scribus/doc/it/images/pdfxintent.png b/scribus/doc/it/images/pdfxintent.png new file mode 100644 index 0000000..238bde4 Binary files /dev/null and b/scribus/doc/it/images/pdfxintent.png differ diff --git a/scribus/doc/it/images/plot1.png b/scribus/doc/it/images/plot1.png index 21707fe..fb83071 100644 Binary files a/scribus/doc/it/images/plot1.png and b/scribus/doc/it/images/plot1.png differ diff --git a/scribus/doc/it/images/plot2.png b/scribus/doc/it/images/plot2.png index 34417b1..69bbd8b 100644 Binary files a/scribus/doc/it/images/plot2.png and b/scribus/doc/it/images/plot2.png differ diff --git a/scribus/doc/it/images/polygons.png b/scribus/doc/it/images/polygons.png new file mode 100644 index 0000000..805c39f Binary files /dev/null and b/scribus/doc/it/images/polygons.png differ diff --git a/scribus/doc/it/images/polygons1.png b/scribus/doc/it/images/polygons1.png new file mode 100755 index 0000000..0c1757a Binary files /dev/null and b/scribus/doc/it/images/polygons1.png differ diff --git a/scribus/doc/it/images/povray.png b/scribus/doc/it/images/povray.png new file mode 100644 index 0000000..ff3ebee Binary files /dev/null and b/scribus/doc/it/images/povray.png differ diff --git a/scribus/doc/it/images/preflight-v.png b/scribus/doc/it/images/preflight-v.png new file mode 100644 index 0000000..c366354 Binary files /dev/null and b/scribus/doc/it/images/preflight-v.png differ diff --git a/scribus/doc/it/images/prefs-mac-1.png b/scribus/doc/it/images/prefs-mac-1.png new file mode 100644 index 0000000..82b9d59 Binary files /dev/null and b/scribus/doc/it/images/prefs-mac-1.png differ diff --git a/scribus/doc/it/images/prefs_9parts.png b/scribus/doc/it/images/prefs_9parts.png new file mode 100755 index 0000000..1864f70 Binary files /dev/null and b/scribus/doc/it/images/prefs_9parts.png differ diff --git a/scribus/doc/it/images/prefs_document1.png b/scribus/doc/it/images/prefs_document1.png new file mode 100755 index 0000000..6c4c6b2 Binary files /dev/null and b/scribus/doc/it/images/prefs_document1.png differ diff --git a/scribus/doc/it/images/prefs_fibonacci.png b/scribus/doc/it/images/prefs_fibonacci.png new file mode 100755 index 0000000..3f86ef3 Binary files /dev/null and b/scribus/doc/it/images/prefs_fibonacci.png differ diff --git a/scribus/doc/it/images/prefs_goldenmean.png b/scribus/doc/it/images/prefs_goldenmean.png new file mode 100755 index 0000000..6a19a52 Binary files /dev/null and b/scribus/doc/it/images/prefs_goldenmean.png differ diff --git a/scribus/doc/it/images/prefs_guides1.png b/scribus/doc/it/images/prefs_guides1.png new file mode 100755 index 0000000..682083f Binary files /dev/null and b/scribus/doc/it/images/prefs_guides1.png differ diff --git a/scribus/doc/it/images/prefs_gutenberg.png b/scribus/doc/it/images/prefs_gutenberg.png new file mode 100755 index 0000000..ec1538b Binary files /dev/null and b/scribus/doc/it/images/prefs_gutenberg.png differ diff --git a/scribus/doc/it/images/prefs_magazine.png b/scribus/doc/it/images/prefs_magazine.png new file mode 100755 index 0000000..39ca026 Binary files /dev/null and b/scribus/doc/it/images/prefs_magazine.png differ diff --git a/scribus/doc/it/images/print-dialog1.png b/scribus/doc/it/images/print-dialog1.png new file mode 100644 index 0000000..a2cde6e Binary files /dev/null and b/scribus/doc/it/images/print-dialog1.png differ diff --git a/scribus/doc/it/images/print-dialog2.png b/scribus/doc/it/images/print-dialog2.png new file mode 100644 index 0000000..ae02460 Binary files /dev/null and b/scribus/doc/it/images/print-dialog2.png differ diff --git a/scribus/doc/it/images/printer2.png b/scribus/doc/it/images/printer2.png new file mode 100644 index 0000000..c3efa19 Binary files /dev/null and b/scribus/doc/it/images/printer2.png differ diff --git a/scribus/doc/it/images/printpreview.png b/scribus/doc/it/images/printpreview.png new file mode 100644 index 0000000..a5fbda3 Binary files /dev/null and b/scribus/doc/it/images/printpreview.png differ diff --git a/scribus/doc/it/images/prop_shape.png b/scribus/doc/it/images/prop_shape.png new file mode 100644 index 0000000..b547b40 Binary files /dev/null and b/scribus/doc/it/images/prop_shape.png differ diff --git a/scribus/doc/it/images/qsg-col1.png b/scribus/doc/it/images/qsg-col1.png new file mode 100644 index 0000000..bddb675 Binary files /dev/null and b/scribus/doc/it/images/qsg-col1.png differ diff --git a/scribus/doc/it/images/qsg-col2.png b/scribus/doc/it/images/qsg-col2.png new file mode 100644 index 0000000..4467bd1 Binary files /dev/null and b/scribus/doc/it/images/qsg-col2.png differ diff --git a/scribus/doc/it/images/register.png b/scribus/doc/it/images/register.png new file mode 100644 index 0000000..94ac592 Binary files /dev/null and b/scribus/doc/it/images/register.png differ diff --git a/scribus/doc/it/images/resene-pal.png b/scribus/doc/it/images/resene-pal.png new file mode 100644 index 0000000..a05ba69 Binary files /dev/null and b/scribus/doc/it/images/resene-pal.png differ diff --git a/scribus/doc/it/images/result.png b/scribus/doc/it/images/result.png new file mode 100644 index 0000000..1a5b2bb Binary files /dev/null and b/scribus/doc/it/images/result.png differ diff --git a/scribus/doc/it/images/rf-error1.png b/scribus/doc/it/images/rf-error1.png new file mode 100644 index 0000000..7ec1a7a Binary files /dev/null and b/scribus/doc/it/images/rf-error1.png differ diff --git a/scribus/doc/it/images/rf2.png b/scribus/doc/it/images/rf2.png new file mode 100644 index 0000000..0ac7a69 Binary files /dev/null and b/scribus/doc/it/images/rf2.png differ diff --git a/scribus/doc/it/images/rf3.png b/scribus/doc/it/images/rf3.png new file mode 100644 index 0000000..a5c23c8 Binary files /dev/null and b/scribus/doc/it/images/rf3.png differ diff --git a/scribus/doc/it/images/rf5.png b/scribus/doc/it/images/rf5.png index 922cc60..890af48 100644 Binary files a/scribus/doc/it/images/rf5.png and b/scribus/doc/it/images/rf5.png differ diff --git a/scribus/doc/it/images/rf6.png b/scribus/doc/it/images/rf6.png index 1305842..f7cec52 100644 Binary files a/scribus/doc/it/images/rf6.png and b/scribus/doc/it/images/rf6.png differ diff --git a/scribus/doc/it/images/rf7.png b/scribus/doc/it/images/rf7.png index 0dc1e5f..ecc7760 100644 Binary files a/scribus/doc/it/images/rf7.png and b/scribus/doc/it/images/rf7.png differ diff --git a/scribus/doc/it/images/rgb-cmyk.png b/scribus/doc/it/images/rgb-cmyk.png new file mode 100644 index 0000000..d609738 Binary files /dev/null and b/scribus/doc/it/images/rgb-cmyk.png differ diff --git a/scribus/doc/it/images/rgb.png b/scribus/doc/it/images/rgb.png new file mode 100644 index 0000000..820f14d Binary files /dev/null and b/scribus/doc/it/images/rgb.png differ diff --git a/scribus/doc/it/images/round_rectangle.png b/scribus/doc/it/images/round_rectangle.png new file mode 100755 index 0000000..0816ac5 Binary files /dev/null and b/scribus/doc/it/images/round_rectangle.png differ diff --git a/scribus/doc/it/images/sadie4by2b.png b/scribus/doc/it/images/sadie4by2b.png new file mode 100644 index 0000000..f721d97 Binary files /dev/null and b/scribus/doc/it/images/sadie4by2b.png differ diff --git a/scribus/doc/it/images/scribus-os2.png b/scribus/doc/it/images/scribus-os2.png new file mode 100644 index 0000000..6f3d31e Binary files /dev/null and b/scribus/doc/it/images/scribus-os2.png differ diff --git a/scribus/doc/it/images/scribus-pres1.png b/scribus/doc/it/images/scribus-pres1.png new file mode 100644 index 0000000..81ba625 Binary files /dev/null and b/scribus/doc/it/images/scribus-pres1.png differ diff --git a/scribus/doc/it/images/scribus-pres2.png b/scribus/doc/it/images/scribus-pres2.png new file mode 100644 index 0000000..0e9aff6 Binary files /dev/null and b/scribus/doc/it/images/scribus-pres2.png differ diff --git a/scribus/doc/it/images/shape_edit.png b/scribus/doc/it/images/shape_edit.png new file mode 100755 index 0000000..b0b376a Binary files /dev/null and b/scribus/doc/it/images/shape_edit.png differ diff --git a/scribus/doc/it/images/shapes8.png b/scribus/doc/it/images/shapes8.png new file mode 100755 index 0000000..0ed0b7d Binary files /dev/null and b/scribus/doc/it/images/shapes8.png differ diff --git a/scribus/doc/it/images/skewing.png b/scribus/doc/it/images/skewing.png new file mode 100755 index 0000000..7ec3792 Binary files /dev/null and b/scribus/doc/it/images/skewing.png differ diff --git a/scribus/doc/it/images/spot.png b/scribus/doc/it/images/spot.png new file mode 100644 index 0000000..64da95f Binary files /dev/null and b/scribus/doc/it/images/spot.png differ diff --git a/scribus/doc/it/images/squat_tux.png b/scribus/doc/it/images/squat_tux.png new file mode 100755 index 0000000..9d69759 Binary files /dev/null and b/scribus/doc/it/images/squat_tux.png differ diff --git a/scribus/doc/it/images/style_manager7.png b/scribus/doc/it/images/style_manager7.png new file mode 100755 index 0000000..726a067 Binary files /dev/null and b/scribus/doc/it/images/style_manager7.png differ diff --git a/scribus/doc/it/images/style_manager8.png b/scribus/doc/it/images/style_manager8.png new file mode 100755 index 0000000..11a6288 Binary files /dev/null and b/scribus/doc/it/images/style_manager8.png differ diff --git a/scribus/doc/it/images/swdialog.png b/scribus/doc/it/images/swdialog.png new file mode 100644 index 0000000..aeb7e23 Binary files /dev/null and b/scribus/doc/it/images/swdialog.png differ diff --git a/scribus/doc/it/images/table-import-1.png b/scribus/doc/it/images/table-import-1.png new file mode 100644 index 0000000..848ed4e Binary files /dev/null and b/scribus/doc/it/images/table-import-1.png differ diff --git a/scribus/doc/it/images/table-import-2.png b/scribus/doc/it/images/table-import-2.png new file mode 100644 index 0000000..c1a24b5 Binary files /dev/null and b/scribus/doc/it/images/table-import-2.png differ diff --git a/scribus/doc/it/images/table-import-3.png b/scribus/doc/it/images/table-import-3.png new file mode 100644 index 0000000..d004981 Binary files /dev/null and b/scribus/doc/it/images/table-import-3.png differ diff --git a/scribus/doc/it/images/tb-bookbinder.png b/scribus/doc/it/images/tb-bookbinder.png new file mode 100644 index 0000000..ea21adf Binary files /dev/null and b/scribus/doc/it/images/tb-bookbinder.png differ diff --git a/scribus/doc/it/images/tb-gsview.png b/scribus/doc/it/images/tb-gsview.png new file mode 100644 index 0000000..add25e3 Binary files /dev/null and b/scribus/doc/it/images/tb-gsview.png differ diff --git a/scribus/doc/it/images/tb-inkscape.png b/scribus/doc/it/images/tb-inkscape.png new file mode 100644 index 0000000..4cbbf78 Binary files /dev/null and b/scribus/doc/it/images/tb-inkscape.png differ diff --git a/scribus/doc/it/images/tb-jpdf.png b/scribus/doc/it/images/tb-jpdf.png new file mode 100644 index 0000000..5ae48ab Binary files /dev/null and b/scribus/doc/it/images/tb-jpdf.png differ diff --git a/scribus/doc/it/images/tb-libreoffice.png b/scribus/doc/it/images/tb-libreoffice.png new file mode 100644 index 0000000..dfa77f9 Binary files /dev/null and b/scribus/doc/it/images/tb-libreoffice.png differ diff --git a/scribus/doc/it/images/tb-pdf-imp.png b/scribus/doc/it/images/tb-pdf-imp.png new file mode 100644 index 0000000..a3b6d0d Binary files /dev/null and b/scribus/doc/it/images/tb-pdf-imp.png differ diff --git a/scribus/doc/it/images/text-frame-link.png b/scribus/doc/it/images/text-frame-link.png new file mode 100755 index 0000000..a0c380f Binary files /dev/null and b/scribus/doc/it/images/text-frame-link.png differ diff --git a/scribus/doc/it/images/text-frame-unlink.png b/scribus/doc/it/images/text-frame-unlink.png new file mode 100755 index 0000000..849bacb Binary files /dev/null and b/scribus/doc/it/images/text-frame-unlink.png differ diff --git a/scribus/doc/it/images/text_flow.png b/scribus/doc/it/images/text_flow.png new file mode 100755 index 0000000..1687d1b Binary files /dev/null and b/scribus/doc/it/images/text_flow.png differ diff --git a/scribus/doc/it/images/text_tab11.png b/scribus/doc/it/images/text_tab11.png new file mode 100755 index 0000000..b268963 Binary files /dev/null and b/scribus/doc/it/images/text_tab11.png differ diff --git a/scribus/doc/it/images/text_tab11b.png b/scribus/doc/it/images/text_tab11b.png new file mode 100755 index 0000000..14eb626 Binary files /dev/null and b/scribus/doc/it/images/text_tab11b.png differ diff --git a/scribus/doc/it/images/text_tab12.png b/scribus/doc/it/images/text_tab12.png new file mode 100755 index 0000000..9cd7bb2 Binary files /dev/null and b/scribus/doc/it/images/text_tab12.png differ diff --git a/scribus/doc/it/images/text_tab2.png b/scribus/doc/it/images/text_tab2.png new file mode 100755 index 0000000..0f0e69d Binary files /dev/null and b/scribus/doc/it/images/text_tab2.png differ diff --git a/scribus/doc/it/images/text_tab4.png b/scribus/doc/it/images/text_tab4.png new file mode 100755 index 0000000..b8ad361 Binary files /dev/null and b/scribus/doc/it/images/text_tab4.png differ diff --git a/scribus/doc/it/images/text_tab5.png b/scribus/doc/it/images/text_tab5.png new file mode 100755 index 0000000..fc98274 Binary files /dev/null and b/scribus/doc/it/images/text_tab5.png differ diff --git a/scribus/doc/it/images/text_tab6.png b/scribus/doc/it/images/text_tab6.png new file mode 100755 index 0000000..fb0e0d2 Binary files /dev/null and b/scribus/doc/it/images/text_tab6.png differ diff --git a/scribus/doc/it/images/text_tab7.png b/scribus/doc/it/images/text_tab7.png new file mode 100755 index 0000000..d079063 Binary files /dev/null and b/scribus/doc/it/images/text_tab7.png differ diff --git a/scribus/doc/it/images/text_tab7a.png b/scribus/doc/it/images/text_tab7a.png new file mode 100755 index 0000000..75942dc Binary files /dev/null and b/scribus/doc/it/images/text_tab7a.png differ diff --git a/scribus/doc/it/images/text_tab7b.png b/scribus/doc/it/images/text_tab7b.png new file mode 100755 index 0000000..939a9c9 Binary files /dev/null and b/scribus/doc/it/images/text_tab7b.png differ diff --git a/scribus/doc/it/images/text_tab8.png b/scribus/doc/it/images/text_tab8.png new file mode 100755 index 0000000..c6bc75a Binary files /dev/null and b/scribus/doc/it/images/text_tab8.png differ diff --git a/scribus/doc/it/images/text_tab9.png b/scribus/doc/it/images/text_tab9.png new file mode 100755 index 0000000..a6b29d5 Binary files /dev/null and b/scribus/doc/it/images/text_tab9.png differ diff --git a/scribus/doc/it/images/transform_dialogb.png b/scribus/doc/it/images/transform_dialogb.png new file mode 100644 index 0000000..7359662 Binary files /dev/null and b/scribus/doc/it/images/transform_dialogb.png differ diff --git a/scribus/doc/it/images/transform_translaterotation.png b/scribus/doc/it/images/transform_translaterotation.png new file mode 100644 index 0000000..3c278ae Binary files /dev/null and b/scribus/doc/it/images/transform_translaterotation.png differ diff --git a/scribus/doc/it/images/transform_translaterotation1.png b/scribus/doc/it/images/transform_translaterotation1.png new file mode 100644 index 0000000..c352fe8 Binary files /dev/null and b/scribus/doc/it/images/transform_translaterotation1.png differ diff --git a/scribus/doc/it/images/transform_translatescaling.png b/scribus/doc/it/images/transform_translatescaling.png new file mode 100644 index 0000000..221246e Binary files /dev/null and b/scribus/doc/it/images/transform_translatescaling.png differ diff --git a/scribus/doc/it/images/transform_translateskewing.png b/scribus/doc/it/images/transform_translateskewing.png new file mode 100644 index 0000000..8134309 Binary files /dev/null and b/scribus/doc/it/images/transform_translateskewing.png differ diff --git a/scribus/doc/it/images/transform_translateskewing1.png b/scribus/doc/it/images/transform_translateskewing1.png new file mode 100644 index 0000000..c7f5f58 Binary files /dev/null and b/scribus/doc/it/images/transform_translateskewing1.png differ diff --git a/scribus/doc/it/images/vectimp1.png b/scribus/doc/it/images/vectimp1.png new file mode 100644 index 0000000..50fc96d Binary files /dev/null and b/scribus/doc/it/images/vectimp1.png differ diff --git a/scribus/doc/it/images/vectimp2.png b/scribus/doc/it/images/vectimp2.png new file mode 100644 index 0000000..c4c8c9a Binary files /dev/null and b/scribus/doc/it/images/vectimp2.png differ diff --git a/scribus/doc/it/images/vectimp3.png b/scribus/doc/it/images/vectimp3.png new file mode 100644 index 0000000..b2c7064 Binary files /dev/null and b/scribus/doc/it/images/vectimp3.png differ diff --git a/scribus/doc/it/images/vectimp4.png b/scribus/doc/it/images/vectimp4.png new file mode 100644 index 0000000..9ee135e Binary files /dev/null and b/scribus/doc/it/images/vectimp4.png differ diff --git a/scribus/doc/it/images/vectimp5.png b/scribus/doc/it/images/vectimp5.png new file mode 100644 index 0000000..d0ff77c Binary files /dev/null and b/scribus/doc/it/images/vectimp5.png differ diff --git a/scribus/doc/it/images/vector-advanced.png b/scribus/doc/it/images/vector-advanced.png new file mode 100644 index 0000000..4081ca9 Binary files /dev/null and b/scribus/doc/it/images/vector-advanced.png differ diff --git a/scribus/doc/it/images/vector-clipart.png b/scribus/doc/it/images/vector-clipart.png new file mode 100644 index 0000000..62b580a Binary files /dev/null and b/scribus/doc/it/images/vector-clipart.png differ diff --git a/scribus/doc/it/images/xnview.png b/scribus/doc/it/images/xnview.png new file mode 100644 index 0000000..7b7350e Binary files /dev/null and b/scribus/doc/it/images/xnview.png differ diff --git a/scribus/doc/it/importhints4.html b/scribus/doc/it/importhints4.html index a0c87c8..7fef57a 100644 --- a/scribus/doc/it/importhints4.html +++ b/scribus/doc/it/importhints4.html @@ -29,22 +29,22 @@ Come esempio, consideriamo il seguente documento HTML, e mostriamo come appare d <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> </head> <body> -<h1>H1 Text</h1> -<h2>H2 Text</h2> -<h3>H3 Text</h3> -<h4>H4 Text</h4> +<h1>Intestazione di primo livello (H1)</h1> +<h2>Intestazione di secondo livello (H2)</h2> +<h3>Intestazione di terzo livello (H3)</h3> +<h4>Intestazione di quarto livello (H4)</h4> <ol> -<li>Ordered List Item 1 </li> -<li>Ordered List Item 2 </li> +<li>Lista ordinata 1 </li> +<li>Lista ordinata 2 </li> </ol> <ul> -<li>Un-Ordered List Item 1 </li> - <li>Un-Ordered List Item 2 </li> +<li>Lista non ordinata 1 </li> + <li>Lista non ordinata 2 </li> </ul> - <code>code listings</code> - <p><b>Bold Paragraph Style</b></p> - <p><i>Italic Paragraph Style</i></p> - <p align="center">Centered Text</p> + <code>frammento di codice</code> + <p><b>Paragrafo con testo in grassetto</b></p> + <p><i>Paragrafo con testo in corsivo</i></p> + <p align="center">Testo centrato</p> </body> </html>

    Ecco gli stili generati con l'importazione del file:

    diff --git a/scribus/doc/it/install-dpkg.html b/scribus/doc/it/install-dpkg.html new file mode 100644 index 0000000..d53d0b3 --- /dev/null +++ b/scribus/doc/it/install-dpkg.html @@ -0,0 +1,189 @@ + + + + Scribus on Debian GNU/Linux and Derivatives + + +

    How to use the Scribus Debian / Ubuntu Repository

    +

    These notes are kindly provided by our Debian package maintainer, Oleksandr Moskalenko. <malex at tagancha.org>. Please direct questions related to Scribus on Debian to the above email.

    + +"Debian" name here encompasses Debian proper (unstable/testing/stable also known as sid/etch/sarge) and at least Ubuntu breezy/hoary. Instructions on rebuilding the source package may be applicable to other Debian derivatives and custom distributions. +

    Preamble

    + +

    Currently there are following Scribus-related packages in Debian:

    + + +

    Scribus team also maintains an unofficial (outside of Debian proper) repository that contains some of the packages mentioned above with the most notable difference being a more frequent update schedule compared to Debian proper. There are a couple reasons for the existence of this upstream repository. Debian development has a limit on how often a scribus package can be updated. It could sometimes take weeks between consecutive uploads as the package could be waiting on other related packages before it can move from Unstable (sid) into Testing (currently etch). Because of that the official packages are usually behind those available in our upstream archives. Packages in our upstream repositories usually follow scribus development fairly closely via svn snapshot builds. For instance, if you discovered a but you are advised to install the most recent package as the bug might have already been fixed and a fixed package is available. This is called "the Scribus magic (TM)". Also, our repositories contain builds for Ubuntu Hoary and Breezy branches (ix86 architecture).

    + +

    Debian setup for Scribus repositories

    +

    About the repositories

    +

    We actually maintain two identical repositories to provide bandwidth redundancy and failover capability to our distribution of Debian scribus packages. These repositories contain x86 packages for Debian stable,testing and unstable and Ubuntu hoary and breezy branches. If you are using a different Debian-based distribution or your hardware is not x86-based such as PowerPC or AMD64 you can easily build a Scribus package from our source package, so do not consider it as a strong obstacle to using these packages.

    + +

    Repository usage

    +

    To use our repositories add the appropriate source lines from the following list to your /etc/apt/sources.list file. Note that the lines starting with "deb" are used for installation of the pre-compiled binary packages and the line starting with "deb-src" are for the source package for building a binary package for your distribution (if it has a different set of libraries), hardware (if it's not x86) or compiler optimizations (if you really know you want them). 

    + +

    Source lines for /etc/apt/sources.list or for Synaptic et al

    +

    Debian stable (Sarge):

    +
     # debian.scribus.net - Primary repository
+    
     deb http://debian.scribus.net/debian/ stable main non-free contrib
+    
     deb-src http://debian.scribus.net/debian/ stable main non-free contrib
+    
     # debian.tagancha.org - Backup repository
+    
     deb http://debian.tagancha.org/debian/ stable main non-free contrib
+    
     deb-src http://debian.tagancha.org/debian/ stable main non-free contrib
+    
    
+
    +

    + Debian testing (Etch): +

    +
     # debian.scribus.net - Primary repository
+    
     deb http://debian.scribus.net/debian/ testing main non-free contrib
+    
     deb-src http://debian.scribus.net/debian/ unstable main non-free contrib
+    
     # debian.tagancha.org - Backup repository
+    
     deb http://debian.tagancha.org/debian/ testing main non-free contrib
+    
     deb-src http://debian.tagancha.org/debian/ unstable main non-free contrib
+    
    
+
    +

    + Debian unstable (Sid): +

    +
     # debian.scribus.net - Primary repository
+    
     deb http://debian.scribus.net/debian/ unstable main non-free contrib
+    
     deb-src http://debian.scribus.net/debian/ unstable main non-free contrib
+    
     # debian.tagancha.org - Backup repository
+    
     deb http://debian.tagancha.org/debian/ unstable main non-free contrib
+    
     deb-src http://debian.tagancha.org/debian/ unstable main non-free contrib
+    
    
+
    +

    + Ubuntu Hoary: +

    +
     # debian.scribus.net - Primary repository
+    
     deb http://debian.scribus.net/debian/ hoary main restricted
+    
     deb-src http://debian.scribus.net/debian/ hoary main restricted
+    
     # debian.tagancha.org - Backup repository
+    
     deb http://debian.tagancha.org/debian/ hoary main restricted
+    
     deb-src http://debian.tagancha.org/debian/ hoary main restricted
+    
    
+
+    
+
    +

    + Ubuntu Breezy: +

    +
    + Note that Ubuntu breezy package can be also used for Ubuntu "Dapper" branch right now. When Dapper changes enough to require its own scribus or scribus-ng package we will provide it. +
    +
     # debian.scribus.net - Primary repository
+    
     deb http://debian.scribus.net/debian breezy main restricted
+    
     deb-src http://debian.scribus.net/debian breezy main restricted
+    
     # debian.tagancha.org - Backup repository
+    
     deb http://debian.tagancha.org/debian breezy main restricted
+    
     deb-src http://debian.tagancha.org/debian breezy main restricted
+    
    
+
+    
+
    + +

    Using cryptographic repository signatures:

    +

    Our repositories are cryptographically signed for added security. Add the gpg-keys for our repositories to avoid having to confirm your installation choice to the package manager each time you update a scribus or scribus-ng package.

    + +
    +    root$ gpg --keyserver wwwkeys.eu.pgp.net --recv-keys DA286F326C5F196B
+    root$ gpg --armor --export DA286F326C5F196B | apt-key add -
    +or as a normal user (with an appropriate entry for apt-key in the sudoers file): +
    +    user$ gpg --keyserver wwwkeys.eu.pgp.net --recv-keys DA286F326C5F196B
+    user$ gpg --armor --export DA286F326C5F196B | sudo apt-key add -
    + +

    Final installation step

    +

    Once you added the relevant sources lines to your /etc/apt/sources.list you can run:

    + 
    aptitude install scribus scribus-ng
    + or + 
    apt-get install scribus scribus-ng
    + +

    in a root terminal or use your favorite graphical apt-get front-end such as synaptic or aptitude. Don't forget to "Reload Package List" in the synaptic. It's the equivalent of "apt-get (or aptitude) update" and has to be done to make new packages from our repositories available to your package management tools.

    + +

    Bug reporting

    +

    Please do not file bug reports about the packages from these upstream repositories in the Debian or Ubuntu BTS (Bug Tracking Systems). Use the distribution BTS for the package version that is in that distribution. However, if you cold verify that the bug is present in the package version in Debian, by all means feel free to file a bug report through the Debian BTS. You are encouraged to contact the maintainer Oleksandr (Alex) Moskalenko directly if you have package installation questions or related Scribus issues that you believe do not belong in Scribus BTS or for comments and suggestions about this document. If you have a Scribus issue that is not related to Debian packaging you may find it easier to just use the scribus BTS at http://bugs.scribus.net for reporting bugs as such issues would be forwarded from the Debian BTS to the Scribus BTS by the maintainer anyway.

    + +

    Step-by-step procedure for new Debian GNU/Linux users

    +

    You don't have to log on as root, but you have to have superuser privileges to edit the /etc/apt/sources.list file. Fortunately, on a Linux system you can do that with ease. Please open a root terminal or open a regular terminal and become root through a "su" command. You will have to provide root password when prompted. Then, you can launch your favorite text editor from that terminal and edit the sources.list file as outlined in the http://wiki.scribus.net/index.php/Scribus_on_Debian_GNU/Linux page. Alternatively, you can do a bit more work upfront to achieve a more permanent access to package manipulation system. If you are familiar with the VI editor you can do the following:

    + + +

    Now you are ready to launch the very nice graphical apt-get front-end Synaptic with a "sudo synaptic" command at any time. If you are a new Linux user, Synaptic will help you get started easier than you probably would with command line tools. Once you launch Synaptic select the "Settings/Repositories" menu entry. Click on the "New" button and type or paste in the appropriate source lines. For example for "Debian Sarge": URI: http://debian.scribus.net/debian/

    +
    + Distribution: stable +
    + Section(s): main non-free contrib +
    +

    Don't forget to enable that repository by selecting a checkbox in the leftmost column. Now you can reload repository information by clicking on the "Reload" button in the main Synaptic window. Then you click on the "Search" button and search for "scribus". Once "scribus", "scribus-ng", "scribus-doc", and "scribus-template" packages are found you can mark them for installation by double-clicking on them or by right-clicking and selecting "Mark for installation". When you are done, click on the "Apply" button to proceed with installation. After that you should have the packages installed and may begin to use Scribus.

    +

    Building from a source package for other Debian-based distributions

    +

    Instructions below have been rendered mostly obsolete for the x86 architecture by the new repositories. If you have non-x86 hardware or would like to build an optimized package you can still use these instructions. You can submit packages for other architectures to me and I will place them into the repository. If you have a non-x86 arch or would like to optimize the packages for your CPT you can achive these goals by a very simple package rebuild. Make sure that you have the deb-src lines for scribus repositories uncommented and run the following commands:

    + +

    The cool way (TM) - as root or set up sudo for yourself as a user:

    + 
    apt-get install apt-build
+
    + +

    Answer questions about your CPU and stuff - see an excellent document at http://julien.danjou.info/article-apt-build.html) +

    + 
    apt-build update
    + 
    apt-build install scribus (or scribus-ng)
    +
    + +

    An alternate cool way - as root or see the config setup below:

    + +

    To streamline this process and build scribus as a user:

    +

    Configure apt-src: Add the following lines to /etc/apt/apt.conf or ~/.apt-src/config file: +

    + 
    +        APT::Src::RootCommand su -c;
    
+        APT::Src::BuildDeps
    +

    This is especially convenient if you set up the no-password su to root for yourself through pam. Otherwise you'll likely have to type a password.

    +
    +

    Without apt-build or apt-src - as root:

    + 
     apt-get source -b scribus scribus-ng
    + 
     apt-get build-dep scribus-ng (or scribus)
    +
    +

    Another way - as root:

    + 
     apt-get install devscripts build-essential fakeroot
    + Note: This creates a minimal build environment. + 
     apt-get source scribus-ng (or "scribus" instead of "scribus-ng")
    + 
     apt-get build-dep scribus-ng (or scribus)
    + 
     cd scribus.... or scribus-ng...
    +

    Use the actual directory names.

    + 
     debuild -us -uc
    + 
     cd ..
    + 
     dpkg -i scribus_.... or scribus-ng_....
    + + +

    One thing which sets Scribus apart is the enthusiastic and friendly Scribus community that assists beginner and pro alike. You can take part in many ways: our mailing list, the IRC channel, email, the wiki, contracted support and finally the bugtracker. These options add to your Scribus experience and we think you will find it very rewarding.

    + diff --git a/scribus/doc/it/install1.html b/scribus/doc/it/install1.html new file mode 100644 index 0000000..f023725 --- /dev/null +++ b/scribus/doc/it/install1.html @@ -0,0 +1,37 @@ + + + + Come procurarsi il codice sorgente di Scribus + + +

    Come procurarsi il codice sorgente di Scribus

    +

    Potete prelevare un archivio in formato tar della più recente versione di Scribus da Sourceforge: http://sourceforge.net/projects/scribus/files/.

    + +

    Grazie ad Anduin.net c'è anche un repository SVN ad accesso anonimo, che è continuamente aggiornato. L'uso di questo codice è consigliato soltanto per coloro che desiderano tenersi aggiornati agli ultimi sviluppi. Ecco le istruzioni per procurarsi la più recente versione del codice sorgente da SVN:

    + +

    Ramo Scribus 1.4. Questo ramo contiene il codice per la versione stabile (1.4.x).

    +
    +
    +svn co svn://scribus.info/Scribus/branches/Version14x
+
    +o, per chi ha le porte SVN chiuse sul proprio firewall,: +
    +svn co http://scribus.info/svn/Scribus/branches/Version14x
+
    +
    + +

    Scribus 1.5svn – versione di sviluppo. Questo ramo contiene il codice per la versione sperimentale (1.5svn). Questo codice può avere un grado elevato di instabilità; potrebbe anche non funzionare o addirittura non essere compilabile!

    +
    +
    +svn co svn://scribus.info/Scribus/trunk
+
    +o, per chi ha le porte SVN chiuse sul proprio firewall,: +
    +svn co http://scribus.info/svn/Scribus/trunk
+
    +
    + +

    Dopo aver prelevato il codice, continuate con le istruzioni per compilare e installare usando CMake.

    + + + \ No newline at end of file diff --git a/scribus/doc/it/install2.html b/scribus/doc/it/install2.html new file mode 100644 index 0000000..39dfaea --- /dev/null +++ b/scribus/doc/it/install2.html @@ -0,0 +1,49 @@ + + + + Requisiti per la compilazione + + +

    Requisiti per la compilazione

    +

    I programmi che dovete avere per poter compilare Scribus 1.4 sono:

    +
      +
    1. Per Scribus 1.4.x è necessario GCC 3.x+, si consiglia fortemente GCC 3.3+. Il team di Scribus ha verificato la compilazione con GCC 4.1+. Si consiglia di utilizzare la più recente versione stabile di GCC 4.x per i benefici di prestazioni che offre.
      2. +
    2. CMake
      3. +
    3. GNU make
      4. +
    +Le dipendenze per la compilazione, e anche per l'esecuzione di Scribus, sono: +
      +
    1. Qt 4.6.0+: sia le librerie di esecuzione sia quelle di sviluppo.
      2. +
    2. Python e Python-devel: librerie 2.3+. Python 2.2 non funziona.
      3. +
    3. Freetype2 2.1.7+. A causa di vari difetti presenti in freetype2, consigliamo, se la vostra distribuzione/sistema operativo lo permette, di usare la versione 2.3.x.
      4. +
    4. Cairo 1.4.x. Consigliamo la versione 1.4.10 o successiva per ragioni di prestazioni.
      5. +
    5. libxml2 2.6+.
      6. +
    6. Ghostscript 8.60+ è altamente consigliato.
      7. +
    7. littleCMS (noto anche come lcms in alcune distribuzioni). La versione minima è la 1.12, ma si consiglia la 1.17 o successiva. lcms 1.12+ è in grado di eseguire la compensazione del punto nero.
      8. +
    8. libtiff 3.6.0+.
      9. +
    9. libjpeg.
      10. +
    10. librerie di sviluppo di CUPS; Scribus è in grado di stampare direttamente con CUPS (solo Linux/UNIX/Mac OS X).
      11. +
    11. tkinter (per gli script Font Sampler e Calendar Wizard).
      12. +
    12. le librerie Python-imaging sono utilizzate da certe funzioni di scripting.
      13. +
    13. openssl-devel; alcune distribuzioni di Linux, tra cui OpenSUSE, permettono di utilizzare il protocollo ssl con CUPS.
      14. +
    14. fontconfig-devel: per il rilevamento automatico dei caratteri su Linux, Mac OS X e UNIX. Non richiesto su Windows, OS/2 ed eComStation.
      15. +
    15. Podofo 0.6 o successivo: utilizzato per aumentare le capacità dell'importatore Adobe Illustrator.
      16. +
    +

    Requisiti opzionali:

    + +

    Scribus funziona con quasi ogni window manager e non richiede KDE. Tuttavia le funzionalità di trascinamento e rilascio sono assenti senza KDE.

    +

    Se la gestione del colore non funziona, dovete avere installati almeno un profilo RGB e uno CMYK, altrimenti le preferenze e opzioni per il colore non saranno presenti nei menù. Scribus installa un profilo RGB e uno CMYK in modo che la gestione del colore sia attiva, ma alcune distribuzioni, tra cui Debian, forniscono dei profili ICC in pacchetti separati, a causa dei loro criteri di gestione delle licenze.

    +

    In base alle prove eseguite, si è constatato che l'impostazione corretta del parametro CXXFLAGS al valore "-march=" ha un effetto assai benefico sulle prestazioni di Scribus. Ad esempio, se avete un processore Duron o Athlon, l'utilizzo di export CXXFLAGS="-march=athlon" apporta notevoli benefici. Verificate se la vostra distribuzione imposta questo parametro e come, e per altre informazioni consultate: +

    +
    man gcc
    +

    +

    Vi sono istruzioni dettagliate nel file BUILDING, e per la creazione dei pacchetti si dovrebbe consultare il file PACKAGING nel codice sorgente per ulteriori istruzioni.

    +

    Uso di CMake

    +

    Nella versione 1.3.3.6+ fu aggiunta la possibilità di utilizzare CMake in alternativa ai tradizionali autotools. A partire dalla versione 1.3.5 CMake è obbligatorio, e non è più possibile servirsi di autotools. Attualmente la compilazione su Linux, UNIX e Mac OS X funziona in modo soddisfacente. Per ulteriori informazioni leggete la pagina con le istruzioni per CMake.

    +

    La posizione predefinita per l'eseguibile di Scribus è /usr/local/bin. La documentazione si trova in /usr/local/lib/scribus/doc.

    +

    Inoltre, per i desktop Linux/UNIX, esiste un file desktop.config il cui nome è scribus.desktop, che può essere utilizzato per creare un collegamento nel menù o sul desktop. Basta copiarlo dalla directory base del codice di installazione al desktop, e tramite esso potrete lanciare Scribus. Dopo aver spostato il file sul desktop, fate clic col tasto destro e controllate che la casella “esecuzione” sia contrassegnata. Questo file è conforme alle più recenti specifiche www.freedesktop.org.

    + + diff --git a/scribus/doc/it/install3.html b/scribus/doc/it/install3.html new file mode 100644 index 0000000..55100d6 --- /dev/null +++ b/scribus/doc/it/install3.html @@ -0,0 +1,59 @@ + + + + Compiling and Installing using autotools + + +

    Compiling and Installing using autotools

    +

    These instructions apply to Scribus 1.3.3.x SVN and below

    +

    If you have downloaded source from SVN, you will need to start the intial build process:

    + +
    +cd Scribus
+make -f Makefile.svn
+
    + +

    In order to compile and install Scribus on your system, type the following +in the base directory of the Scribus distribution after uncompressing the +downloaded package:

    + +
    +./configure
+make
+make install
+
    + +

    The make install command will have to be done with root access if you have not run the ./configure command with a --prefix=[dir] option to specify a different install directory. The following is an example of how to configure and install into your home directory. (For more informaiton than the following line, look at the Parallel Install section for more on having more than one version of Scribus installed at once)

    + +
    +./configure --prefix=/usr;make;make install prefix=~/scribus/svn
+
    + + +

    If you receive warnings when running ./configure, you will need to verify the versions of autoconf and automake by running:

    + +
    +autoconf --version
+automake --version
+
    + +

    If they are not at least of the versions mentioned in the Requirements section, you may, depending on your distribution, need to tell it to use a higher version like following:

    + +
    +export WANT_AUTOCONF="2.5"
+export WANT_AUTOMAKE="1.7"
+
+
    + +

    Having run those two commands, recheck the versions. If they still do not comply to those required, you will need to upgrade those programs, however most distributions contain a high enough version.

    + +

    Since Scribus uses autoconf, as long as you have the correct developement versions of the libraries, you should have little difficulty compiling it. Should you run into problems please report them to the Scribus mailing list or IRC channel. See Community Resources section of this manual.

    + +

    Lastly:

    + +
    man scribus
    + +

    will list additional info for startup.

    + + + diff --git a/scribus/doc/it/install4.html b/scribus/doc/it/install4.html new file mode 100644 index 0000000..47693f3 --- /dev/null +++ b/scribus/doc/it/install4.html @@ -0,0 +1,126 @@ + + + + + Compilazione e installazione con l'uso di CMake e Scribus 1.4.x + + + +

    Compilazione e installazione con l'uso di CMake e Scribus 1.4.x

    + +

    Per molti anni gli sviluppatori di Scribus hanno generato il programma a partire dal codice sorgente utilizzando autotools, ma poi hanno deciso di sostituirlo con CMake. È uno strumento molto più flessibile, e allo stesso tempo molto meno complesso, e inoltre è compatibile con gli strumenti di compilazione presenti su Linux e varianti di UNIX, Windows e Mac OS X.

    + +

    Per generare un programma con CMake, ovviamente avete bisogno di CMake stesso. CMake è compreso nella maggior parte delle distribuzioni Linux e in alcune di UNIX. Se nella vostra non è presente, potete scaricarlo qui; dovreste accertarvi di prelevarne una versione recente, come la 2.8 o una superiore. Nel sito vi sono anche i pacchetti di installazione per Mac OS X, che possono anche essere ottenuti da macports.org. Scribus non usa ancora CMake per Windows, anche se questa capacità potrebbe essere aggiunta in futuro.

    + +

    Uno dei vantaggi di CMake è la possibilità di generare il programma “fuori sorgenti”. Creando una cartella distinta in cui avviene la compilazione del programma, i file temporanei e i file dell'applicazione che vengono generati si trovano un una posizione diversa dai file del codice sorgente. Questo aiuta a mantenere pulite le strutture delle directory, e riduce un po' il tempo necessario per scaricare gli aggiornamenti del codice sorgente. Questo è il metodo migliore ed è fortemente consigliato dai nostri sviluppatori. Inoltre CMake è molto più semplice da mantenere in efficienza per gli sviluppatori, e gli errori sono comprensibili anche dai comuni mortali.

    + +

    Preparazione

    + +

    Supponiamo che vi troviate nella seguente situazione:

    + + + +

    Iniziare la compilazione all'esterno del codice sorgente

    + +

    Spostatevi nella directory del codice sorgente:

    + 
    +cd /home/username/scribussource/
+
    + +

    Create una directory in cui Scribus sarà compilato:

    + 
    +mkdir builddir
+
    + +

    Spostatevi nella directory di compilazione:

    + 
    +cd builddir
+
    + +

    Poi date il seguente comando:

    + 
    +/usr/bin/cmake ../Scribus -DCMAKE_INSTALL_PREFIX:PATH=/home/username/scribusinstall/
+
    + + + +

    Passare alla fase di compilazione

    + +

    Quando il comando CMake ha completato la sua esecuzione senza errori (ricordate che ha bisogno di trovare le dipendenze di Scribus e registrare la loro posizione), dovete dare il seguente comando:

    + 
    +make && make install
+
    + +

    Opzioni avanzate

    + +

    Opzioni di compilazione

    + +

    Ecco alcune opzioni presenti nei file Cmake di Scribus 1.4.x (altre ne seguiranno!):

    + + +

    Esempio: per generare una versione di debug con l'uso di Cairo, il comando da dare sarà simile al seguente (su una sola riga):

    + 
    +/usr/bin/cmake . -DCMAKE_INSTALL_PREFIX:PATH=/home/username/scribusinstall -DWANT_CAIRO=1 -DWANT_DEBUG=1 -DWANT_VERSIONING=1
+
    + +

    Specificare le posizioni delle librerie

    + +

    Quando la vostra distribuzione pubblica il proprio pacchetto per una libreria da cui Scribus dipende, esso potrebbe non essere la più recente versione stabile o instabile fornita dagli autori della libreria. A volte gli sviluppatori di Scribus hanno bisogno di usare il codice più recente per migliorare certe parti di Scribus. In questi casi è necessario che compiliate voi la versione adatta di tali librerie.

    + +

    Creare un archivio tar da distribuire

    + +

    Per creare un archivio tar da distribuire, il vecchio modo sarebbe: make dist.

    + +

    Il nuovo modo consiste nel dare il seguente comando:

    + 
    +make package_source
+
    + +

    oppure

    + 
    +/usr/bin/cpack -G TBZ2 --config CPackSourceConfig.cmake
+
    + +

    per ottenere un pacchetto del codice sorgente.

    + +

    Importante: se dovete eseguire di nuovo cpack, eliminate _CPack_Packages/ prima di lanciarlo una seconda volta.

    + +

    Potete anche esportare da svn:

    + 
    +/path/to/scribus/svn
+
    in una directory temporanea, e poi inserirla in un archivio tar o zip. + +

    Problemi e successi

    + +

    Se avete letto bene queste istruzioni ma avete ancora problemi, contattateci su IRC o scrivete alla nostra mailing list spiegando il vostro problema. Siamo anche interessati ad avere notizie da utenti che sono riusciti a compilare Scribus su piattaforme diverse da Linux. Sappiamo già che la compilazione su Mac OS X è molto affidabile.

    + + diff --git a/scribus/doc/it/install5.html b/scribus/doc/it/install5.html new file mode 100644 index 0000000..c28776a --- /dev/null +++ b/scribus/doc/it/install5.html @@ -0,0 +1,79 @@ + + + + + Compilare e installare Scribus 1.4+ su Mac OS X + + + +

    Compilare e installare Scribus 1.4+ su Mac OS X

    + +

    Questo documento descrive sommariamente la procedura per generare Scribus 1.4 o superiore dal codice sorgente SVN su Mac OS X. Non è descritta (per ora) la procedura per creare un vero e proprio pacchetto di installazione.

    + +

    Ciò che vi serve:

    + + + +

    Compilazione e installazione

    + +

    Questi sono i passaggi per compilare e installare Scribus 1.4 su OS X/Aqua:

    + + + +

    Poi dovete installare alcuni pacchetti da MacPorts. Eventuali dipendenze necessarie saranno installate automaticamente, se non sono già presenti sul vostro sistema. Se avete già installato MacPorts per altro software, dovreste eseguire i comandi sudo port selfupdate e sudo port upgrade installed per far sì che vengano installate le versioni più recenti delle applicazioni e librerie già presenti sul sistema.

    + + + +

    Prelevate il codice sorgente di Scribus da SVN:

    + + + +

    Ed ora, se tutto è andato bene, Scribus 1.4 è pronto per l'uso sul vostro OS X.

    + + diff --git a/scribus/doc/it/irc.html b/scribus/doc/it/irc.html new file mode 100644 index 0000000..74f7ced --- /dev/null +++ b/scribus/doc/it/irc.html @@ -0,0 +1,42 @@ + + + + IRC di Scribus + + +

    IRC di Scribus

    + +Per entrare nel canale IRC di Scribus (link cliccabile): irc://irc.freenode.net/#scribus + +

    Alcuni consigli

    +

    La comunità di Scribus ha una presenza online in “tempo reale”: IRC o Internet Relay Chat. Per alcuni utenti questo potrebbe essere un mezzo poco familiare per ottenere assistenza, ma secondo noi funziona veramente bene. Di solito è presente almeno un membro del team di Scribus o un utente esperto. L'orario migliore per servirsi di IRC è l'ora dell'Europa centrale, e soprattutto la sera il canale di Scribus tende ad essere più frequentato. IRC è a volte considerato un luogo di discussioni accese e persino di insulti e scortesie, ma #scribus (il simbolo ‘#’ indica il nome del canale) ha un ambiente piacevole e amichevole. Scambi di insulti e provocazioni non sono tollerati in #scribus. Ecco una buona introduzione (in inglese) su come comportarsi: Rules of Engagement - The ten commandments of IRC; ed eccone una in italiano: IRCHelp.it: Policies - Netiquette.

    + +

    Non siate timidi, chiedete!

    +

    Quando accedete per la prima volta, dite ‘hi’ (‘ciao’) e fate la vostra domanda: #scribus è un luogo amichevole. Una breve presentazione sarà ben accetta. Se non parlate inglese, non temete: dovreste prima tentare in inglese, ma in #scribus vi sono parecchie persone che parlano lingue diverse. Anche nel Team, sono almeno sette le lingue conosciute abbastanza bene per conversare in IRC. Altri frequentatori regolari probabilmente ne coprono un'altra mezza dozzina.

    + +

    Fornite dettagli

    +

    È utile dire di più che “Ho un problema con una certa cosa che non funziona.”

    + + +

    Siate pazienti

    +

    Il pregio di IRC è la comunicazione diretta “all'istante”, ma a volte gli utenti sono impegnati in altre attività, come programmare Scribus :-). Su IRC, spesso gli utenti abituali e gli sviluppatori sono collegati 24 ore al giorno, ma potrebbero essere lontani dal computer. Ciò non significa che dovete aspettare giorni per avere una risposta. Inoltre, #scribus ha un amichevole bot il cui nome è mrscribe, che può facilmente ritrasmettere i messaggi: potete fare conoscenza con lui più avanti in questa pagina.

    + +

    IRC non è una scusa per non leggere la documentazione

    +

    Come minimo dovreste aver già letto le FAQ (domande frequenti) e le parti della documentazione attinenti al vostro problema. Se qualcuno (potrebbe essere mrscribe) vi dà una risposta o un link, significa che la vostra domanda è già stata fatta più di una volta. E significa anche che le informazioni che cercate si possono trovare facilmente altrove. Molto tempo e fatica sono stati impiegati per scrivere la documentazione, per quanto imperfetta. Ma è stata scritta per aiutare voi.

    + +

    Vi presentiamo MrScribe

    +

    MrScribe è il nostro amichevole “bot”. I bot sono molto utili su IRC, poiché aiutano ad automatizzare certe attività di manutenzione. MrScribe ha anche degli aspetti divertenti, che sono utili ad aiutare gli altri. Potete scoprire tutto su MrScribe qui: http://supybot.com/.

    + +

    Alcuni consigli su client IRC

    +

    Visto che sui nostri pc abbiamo client IRC in funzione 7 giorni la settimana e 24 ore al giorno, ce ne sono un paio che possiamo consigliare:

    + + +

    Soffermatevi in IRC

    +

    Quando arriva la risposta che aspettavate, non siete obbligati a scomparire. #scribus non è solo per esperti e sviluppatori; i principianti sono altrettanto benvenuti. È facile riconoscere gli sviluppatori, poiché di solito hanno lo status di “operatore”. IRC è il luogo dove gli sviluppatori vengono a sapere se gli utenti hanno difficoltà con qualche funzione di Scribus o se c'è qualcosa di poco chiaro nell'interfaccia del programma. Soffermarsi in IRC è un buon modo di venire a sapere particolari interessanti sulle caratteristiche più recenti, e buoni trucchi e consigli per l'uso dai più esperti. Così, quando ve la sentite, accomodatevi e godetevela.

    + diff --git a/scribus/doc/it/lipsum.html b/scribus/doc/it/lipsum.html new file mode 100644 index 0000000..8c62177 --- /dev/null +++ b/scribus/doc/it/lipsum.html @@ -0,0 +1,33 @@ + + + + Adding Sample Text in your Language + + +

    Adding Sample Text in your Language

    +

    Why Sample Text?

    +

    When creating page layouts a sample text, also known as “Lorem ipsum” or “lipsum” to typesetting professionals, is often used as a placeholder for actual text before the real text is inserted. The original Lorem ipsum consists of nonsensical Latin, the reason being the desire of typesetters to not distract from the impression of the text layout (font choice, font size, linespacing etc.). This can most easily be achieved with a nonsensical text, as the viewer will not be tempted to read. However, since one of the purposes of a Lorem ipsum is to show all letters in an alphabet, the original may not be well-suited for languages other than English or Latin, as most languages use either an extended Latin alphabet or no Latin alphabet at all.

    +

    Scribus makes it very convenient to insert a sample text by simply selecting, then right-clicking a text frame and selecting “Sample Text” from the Context Menu. This allows you to visualize the layout or experiment with different fonts and effects before finalizing your design.

    +

    Creating a Sample Text for your Language

    +

    This simple HOWTO shows you how easy it is to add your own language or alphabet if it’s not yet included with Scribus.

    +

    The structure of a lipsum file is very simple XML, which anyone can create in a text editor. Below is a shortened version of a Finnish sample text.

    +
    +<?xml version="1.0" encoding="utf8"?>
+<lorem>
+	<name>Finnish</name>
+	<author>http://www.dlc.fi/~frank/ite.htm</author>
+	<url>http://www.dlc.fi/~frank/huumori/trans/</url>
+
+<p>Vaimo ja mies ajattelivat pitää illallisjuhlat kaikille Rooman silmäätekeville Italiassa.
+Vaimo jännitti kovasti ja halusi kaiken  sujuvan täydellisesti. Viime minuuteilla hän tajusi, ettei
+hänellä ollut illallisille yhtään etanoita, jolloin hän käski miestään juoksemaan
+alas rannalle ja keräämään koriin joitain etanoita.</p>
+</lorem>
+
    + +

    You can search on the internet for a lipsum in your language – there are many available – or simply create your own. Make sure that you can use and distribute an existing sample text without restrictions. If you create your own Lorem ipsum, you are advised to make sure that the sample text is as nonsensical as possible and that it contains all letters of your alphabet.

    +

    Insert the text, replace the name, author and URL data with the correct ones. Then simply put HTML-like tags around each of the paragraphs.

    Insert the text, then save is as language.xml, where “language” must be replaced with an ISO 639-1 language code, a two letter abbreviation for the respective language, e.g. ru.xml for Russian. It’s important to make sure that you save the text in UTF-8 encoding. Otherwise, special characters won’t be displayed correctly.

    +

    To test your sample text, you can copy it to the subdirectory ~/share/scribus/loremipsum, whose location will vary depending on your operating system and the way you installed Scribus (e.g. /usr/share/scribus/loremipsum on Linux).

    +

    Once you made sure that your significant engineering effort works as expected, head over to the Scribus bugtracker, file a bug report with the severity “Feature” and upload your XML file. One of the Scribus developers will add it to the next release of Scribus for all to enjoy.

    + + \ No newline at end of file diff --git a/scribus/doc/it/mailing_lists.html b/scribus/doc/it/mailing_lists.html new file mode 100644 index 0000000..ec75ad8 --- /dev/null +++ b/scribus/doc/it/mailing_lists.html @@ -0,0 +1,195 @@ + + + + Mailing List + + +

    Regole di utilizzo delle mailing list e dichiarazioni di non responsabilità

    +

    Introduzione

    +

    +Gli sviluppatori e i collaboratori di Scribus vivono in località distribuite su ogni continente, e spesso sono geograficamente molto lontani tra loro. La comunità degli utenti è ancora più varia e sparpagliata nel mondo. Quindi IRC e la posta elettronica sono i mezzi preferiti per parlare dell'utilizzo e dello sviluppo di Scribus. La comunicazione via posta elettronica per gli sviluppatori e la comunità di Scribus avviene attraverso le mailing list di Scribus. +

    +

    +Le nostre liste sono pubbliche, il che significa che chiunque può leggere tutto ciò che vi viene scritto e partecipare alla discussione. Incoraggiamo tutti a contribuire allo sviluppo di Scribus e a far conoscere il software libero. La lista “scribus” è dedicata a discussioni sull'uso di Scribus e più in generale sul desktop publishing, a richieste di aiuto e annunci. La lista “scribus-dev” è dedicata a discussioni sullo sviluppo di Scribus tra gli sviluppatori e gli utenti interessati a questo tema.

    + +

    Istruzioni fondamentali per l'uso

    + +

    +Ciascuna delle mailing list di Scribus (che da qui in poi indicheremo con “listname”) ha un indirizzo per l'invio avente la forma listname@lists.scribus.net, un indirizzo per le richieste avente la forma listname-request@lists.scribus.net, e una pagina web all'indirizzo +http://lists.scribus.net/mailman/listinfo/. +

    +

    +Per mandare un'email a una lista, basta mandarla all'indirizzo per l'invio: listname@lists.scribus.net. Per iscrivervi a una lista e poter leggere le mail via via che arrivano, o per cancellare l'iscrizione, usate l'indirizzo per le richieste (vedi sotto). +

    +

    +Le mailing list attualmente attive sono elencate in ordine alfabetico nella pagina http://lists.scribus.net. +

    + +

    Iscrizione / cancellazione

    + +

    +Chiunque può direttamente iscriversi o cancellarsi da qualunque mailing list, purché la lista stessa consenta l'iscrizione libera. +

    +

    +Potete iscrivervi o cancellarvi da ciascuna mailing list direttamente dalla rispettiva pagina web all'indirizzo +http://lists.scribus.net/. +

    +

    +Le richieste di iscrizione o cancellazione possono anche essere inviate via email, a un apposito indirizzo per le richieste che è un po' diverso da quello della lista. I messaggi di iscrizione o cancellazione NON devono essere mandati all'indirizzo vero e proprio della lista. +

    +

    +Per iscrivervi o cancellarvi da una lista, mandate un'email a: +

    +

    +listname-REQUEST@lists.scribus.net +

    +

    +con la parola subscribe (per l'iscrizione) oppure unsubscribe (per la cancellazione) come oggetto. +

    +

    +Fate attenzione a non omettere la parte -REQUEST dall'indirizzo. +

    +

    +Come parte della procedura di iscrizione, il software che gestisce la lista invia automaticamente una mail a cui dovrete rispondere per confermare l'iscrizione. Questa è una misura di sicurezza per impedire che qualcuno iscriva alla lista un'altra persona senza il suo consenso. +

    +

    +Ricordate che una richiesta di cancellazione deve essere mandata dallo stesso indirizzo iscritto alla lista. Se ciò non è possibile, l'oggetto della richiesta deve avere la forma: unsubscribe indirizzoiscritto@dominio.iscritto. +

    +

    +Se ricevete messaggi da una mailing list, ma non riuscite a individuare l'indirizzo con cui vi siete iscritti, potete controllare le intestazioni complete dei messaggi ricevuti, in cui troverete alcune righe simili alle seguenti: +

    +
    +    To: quux@example.com
+    List-Id: <scribus.lists.scribus.net>
+    Sender: scribus-bounces@lists.scribus.net
+
    +

    +Questo vi dice con certezza che la lista in questione si chiama scribus e che l'indirizzo iscritto è quux@example.com. In questo caso (immaginario), per cancellarvi dalla lista dovreste mandare un'email a scribus-request@lists.scribus.net con oggetto unsubscribe quux@example.com. +

    + +

    Pagina delle opzioni

    + + + +

    Regole di comportamento

    + +

    +Quando usate le mailing list di Scribus dovreste seguire queste regole: +

    + + + +

    Manutenzione e amministrazione delle liste

    + +

    +A volte il server delle mailing list può essere spento per manutenzione o aggiornamento del software. Non allarmatevi: in questi casi facciamo tutto il possibile per riattivare le liste nel più breve tempo possibile. +

    +

    +Se avete problemi con l'iscrizione o la cancellazione, controllate di aver seguito le procedure corrette prima di contattarci. Assicuratevi di aver letto le avvertenze su iscrizione e cancellazione. +

    +

    +Per contattare la persona che si occupa del funzionamento delle liste, mandate una mail in inglese a mailman@lists.scribus.net. Oppure potete inserire una segnalazione nel nostro sistema per la gestione degli errori alla pagina http://bugs.scribus.net. +

    +

    +Se non siete riusciti a cancellarvi da una lista, dovreste includere nella vostra segnalazione una copia di tutte le intestazioni di un messaggio che avete ricevuto da quella lista. +

    + +

    Dichiarazione di non responsabilità/informazioni sulla privacy

    + +

    +Le mailing list sono luoghi di discussione pubblica. +

    +

    +Tutti i messaggi inviati a una lista sono distribuiti agli iscritti alla lista e copiati nell'archivio pubblico, dove possono essere letti e cercati da chiunque senza bisogno di essere iscritti. +

    +

    +Inoltre le nostre mailing list possono essere lette sotto forma di gruppi di discussione (Usenet). È possibile farlo anche tramite un'interfaccia web come Google o Gmane. +

    +

    +Le liste potrebbero essere distribuite anche in altri luoghi; accertatevi di non mandare alle liste alcun materiale confidenziale o non autorizzato, comprese informazioni come indirizzi di posta elettronica. Da notare in particolare è il fatto che spammer, virus, e altri software malevoli a volte raccolgono indirizzi da mailing list pubbliche per scopi abusivi. +

    +

    +Il team di Scribus gestisce le liste in buona fede, e agirà per contenere qualunque abuso di cui venga a conoscenza e mantenere il normale e continuo funzionamento delle liste. Allo stesso tempo, il team di Scribus non è responsabile per del contenuto dei messaggi inviati alle liste o di qualunque cosa possa accadere in relazione a essi. +

    + +

    Trattamento della pubblicità sulle mailing list di Scribus

    + +

    +L'invio di qualunque tipo di posta non richiesta in grandi quantità (nota anche come spam) alle liste di Scribus è vietato. Ai mittenti di tali messaggi può essere impedito di scrivere alle liste e/o possono essere segnalati alle autorità competenti. +

    +

    +I gestori delle liste di Scribus fanno tutto ciò che è loro possibile per impedire la pubblicazione in lista di messaggi di questo tipo. +

    +

    +Molte delle regole che usiamo per bloccare gli spammer e i loro messaggi ci sono state segnalate dagli iscritti. Se desiderate aiutarci a ridurre ulteriormente la quantità di spam, il vostro aiuto sarà apprezzato. Per segnalare spam potete scrivere a mailman@lists.scribus.net indicando la URL del messaggio presa dall'archivio della mailing list. Quando esamineremo la vostra richiesta riceverete una risposta. Tenete presente che prenderemo provvedimenti solo sui messaggi segnalati come spam nelle ultime ore, poiché è inutile avere regole di filtraggio non aggiornate. +

    +

    +Fate in modo che i messaggi che ricevete dalle mailing list di Scribus non vengano mai mandati a sistemi automatici per la segnalazione di spam. Questo comportamento è spesso dannoso per tutti gli utenti e ci costringerà a bloccare qualunque traffico dalle mailing list verso di voi, finché dimostrerete che non lo farete di nuovo. +

    + +

    Licenza

    +

    +Questo documento è stato adattato dalla descrizione delle mailing list del Progetto Debian. Questo materiale può essere distribuito soltanto alle condizioni esposte nella Open Publication License, Draft v1.0 o successiva. La versione più recente di solito è disponibile all'indirizzo http://www.opencontent.org/openpub/). +

    + + diff --git a/scribus/doc/it/menu.xml b/scribus/doc/it/menu.xml index 37151e9..1b4167d 100644 --- a/scribus/doc/it/menu.xml +++ b/scribus/doc/it/menu.xml @@ -7,16 +7,16 @@ - + - - - - + + + + @@ -52,7 +52,7 @@ - + @@ -71,18 +71,18 @@ - - - - + + + + - - - + + + - + - + @@ -96,7 +96,7 @@ - + @@ -135,10 +135,9 @@ - - + + - diff --git a/scribus/doc/it/moncal.html b/scribus/doc/it/moncal.html new file mode 100644 index 0000000..a3402cd --- /dev/null +++ b/scribus/doc/it/moncal.html @@ -0,0 +1,91 @@ + + + + A Quick Start Guide to Monitor Profiling with Lprof + + +

    A Quick Start Guide to Monitor Profiling with Lprof

    + +

    Overview

    +

    Author's note, the Lprof profilers were originally the creation of Marti Maria and after some time of dormancy have been resurrected by some volunteers. Lprof is now a separate project from littlecms, though it still depends on littlecms. Some distros do have them in package form. Google is your friend. However, nothing else on Linux is capable of the profile creation so easily as Lprof. They are worth tracking down in rpm or other package form. One other thing to note for those who used the earlier Lprof tools that the update Lprof application is now a single executable.

    + +

    Otherwise, visit http://lprof.sourceforge.net for the latest info and packages. There is steady activity on refining these profilers to make them comparable to commercial grade applications. There are no native Windows packages yet available. For those users running on Windows and who do have an Adobe graphics application installed, creation of a profile with Adobe Gamma is recommended for creating a basic monitor profile.

    + +

    There are five separate tools included in the package:

    + +
      +
    • A monitor profiler
      • +
    • A scanner profiler
      • +
    • A measurement tool
      • +
    • A profile checker
      • +
    • Special utillities for with IT8 targets which are used for profiling scanners
      • +
    + +

    Here, we are going to focus on creation a monitor profile with the Monitor Profile tool. Without some sort of reasonably accurate monitor profiler, you will find it difficult to get consistent on screen color soft proofs with color management enabled, nor obtain good results from the other tools. Before starting, you need to find if possible, your monitor manual or a spec sheet from your vendor's website. In addition, you might wish to locate the factory ICC profile, if available, which we will use for comparison purposes later on.

    + +

    Installation

    + +

    Lprof is uses a new build system called scons, which based on python. It is simple to untar and simply type python scons.py in the source directory. This will build lprof and then python scons.py install as root will install the package. I strongly recommend you read the detailed readme file before compiling.

    +

    Preparation

    + +

    First steps:

    + +
      +
    • You should have your monitor on for at least a half hour to stabilize the temperature.
      • +
    • In addition, for optimum results, set your desktop to a neutral gray background without any bitmap backgrounds or images. This is one of those times, when all that beautiful eye candy is definitely not helpful. The switch to a gray desktop, helps to prevent your eyes from being being fooled by a lack of balance in the colors. My desktop is usually a darkish blue, but for color critical work - back to boring gray.
      • + +
    • Configure, if possible, your monitor's color temperature to 6500k through the on-screen controls. Your monitor manual should have directions to set this for your individual monitor.
      • +
    + +

    Explanation: This step, helps to get your monitor to display with a closer match to the standards which are used in color measurement. Typically, most monitors are set at the factory to 9300k to look brighter, however for accurate color management it is too "cold" or bluish to depict colors in a balanced manner. After changing your monitor temperature to 6500k, you might think it has a yellowish cast, but walk away for a few minutes and return. Your eyes will adjust.

    + +

    Next, set monitor contrast to nearly 100%. Then you want to use the brightness controls to adjust the brightness, so you can see the following, so that each of the shades of gray is distinct. The developers of Lprof highly recommend Monica for setting gamma with the best precision. Further down is the screen for setting Gamma within Lprof. It is nearly full screen and should be maximized to avoid effects of having nearby colors on the screen.

    + + + +

    Setting Profile Parameters

    +

    The first tab will bring up the panel. Check: "I want build a coarse monitor profile." Then select: Enter Monitor Values.

    +
    The first lprof panel
    +

    Then, select

    + + +

    Then, switch to the panel here and select: Set Gamma and Black Point

    + +
    Setting gamma and black point.
    + +

    Setting Gamma

    +

    The panel below will take over almost all of your screen.

    +
    Setting Gamma
    + + + +

    Now that we have switched the monitor temperature to 6500K, set the same in the white point drop down list. Unless you know there is a specific reason to over ride the default sRGB, leave this as is. You do not need to name the profile as indicated just yet. Knowledgeable folks in India indicate 7500K is a more common setting for that area.

    + +

    Next adjust the slider to adjust the gamma so the two shades of gray blend together with the closest color match possible. Most IBM compatible PC's have a gamma setting between 2.1 and 2.4. Macs are generally 1.8. This the reason it is common to find images on edited on a PC looking darker on a Mac. If you monitor is older, it might have a slight color cast and you can try adjusting the individual color channel settings. Don't overdo it. Slight subtle adjustments are better.

    + +

    Next name the profile. On Linux or Unix, the recommended location is $home/.color/icc or /usr/share/color/icc for all users. Mac OSX users can use the native ColorSync tool in the control panel to create a similar profile.

    + +

    You can add addtional descriptive info in the Profile Identification panel below:

    + +
    adding descriptive info for your icm profile
    + +

    Using the monitor profile in Scribus

    + +

    Next, go back to the main page, name your profile. You might want to name the profile something like: $home/.color/icc/d650023.icm This gives you a quick reference to what the profile means. In this case, d= daylight 6500=the monitor is set to 6500k 23=gamma setting of 2.3. If you have colored walls or large windows, you might want to create two monitor profiles: One for daylight and a second one, when you have indoor lighting on during the night. The difference is subtle, but is noticeable. for this preliminary profile, you can leave the Parameters and Tweaking tab alone. The default is set to the icc default specs.

    + +

    The last step is to Create Profile and the profiler will create the icm file. This takes but a second or two. Now you can close the profiler for now.

    + +

    Then, copy the profile to the Scribus profiles directory from a console to $home/.color/icc : $ cp ./d650023.icm $home/.color/icc This is one the default directories Scribus will search for profiles. +

    + +

    Now Scribus can use this profile for more accurately managing screen previews. Start or restart Scribus and go File > Preferences > Color Management . Enable color management and select the monitor profile as below:

    + +
    Scribus CMS settings for the monitor profile
    + +

    By setting this monitor profile to be the default, you have enhanced the accuracy of your screen previews. You can selectively enable the gamut checking in your previews, but this is not quite perfected in littlecms. This is not a weakness in littlecms nor Scribus, but a limitation of the current icc specs. When enabling this consider the preview a warning - not definitive. The true test is what actually will print.

    + +

    You can also use this profile to enhance the previews in Cinepaint, GIMP, Krita or other image editing programs which are color management savvy. Monitor colors and brightness vary over time, so re-profiling at least once every couple of months is a good idea. In professional settings, sometimes they are re-profiled every week.

    + + + + \ No newline at end of file diff --git a/scribus/doc/it/pdfexport2.html b/scribus/doc/it/pdfexport2.html index 3223895..1d1a402 100644 --- a/scribus/doc/it/pdfexport2.html +++ b/scribus/doc/it/pdfexport2.html @@ -9,7 +9,7 @@

    Vi sono sostanzialmente quattro destinazioni per l'esportazione in PDF. È importante tener presenti i suggerimenti che diamo qui sotto prima di iniziare a creare un documento.

    1. -

      Ottimizzato per macchina da stampa: tutte le immagini bitmap importate in Scribus dovrebbero avere una risoluzione minima di 200 dpi, e preferibilmente di 300 dpi o più per fotografie o file TIFF. Per immagini al tratto o vettoriali convertite in bitmap, potrebbe essere necessaria una risoluzione ancora maggiore per ottenere i migliori risultati. Gran parte dei file vettoriali possono essere importati direttamentecome oggetti nativi di Scribus, ed è consigliato trattarli in questo modo se possibile. Nella finestra di dialogo di esportazione del PDF la destinazione da scegliere è “Stampante,” salvo che per l'esportazione in PDF/X-3.

      +

      Ottimizzato per macchina da stampa: tutte le immagini bitmap importate in Scribus dovrebbero avere una risoluzione minima di 200 dpi, e preferibilmente di 300 dpi o più per fotografie o file TIFF. Per immagini al tratto o vettoriali convertite in bitmap, potrebbe essere necessaria una risoluzione ancora maggiore per ottenere i migliori risultati. Gran parte dei file vettoriali possono essere importati direttamente come oggetti nativi di Scribus, ed è consigliato trattarli in questo modo se possibile. Nella finestra di dialogo di esportazione del PDF la destinazione da scegliere è “Stampante,” salvo che per l'esportazione in PDF/X-3.

    2. Ottimizzato per la stampa: questa opzione è per PDF destinati a una stampante da ufficio o domestica (laser o a getto d'inchiostro). Impostazioni consigliate: sottocampionate tutte le immagini a 300 dpi o meno, incorporate i caratteri, e impostate i margini della pagina tenendo conto dei limiti delle comuni stampanti da tavolo o da ufficio (circa 1,5 cm o 6/10 di pollice). Non scegliete “Stampante” come destinazione, ma “Schermo/Web”, poiché le stampanti laser e a getto d'inchiostro sono progettate per utilizzare dati RGB.

      diff --git a/scribus/doc/it/plugin_howto.html b/scribus/doc/it/plugin_howto.html new file mode 100644 index 0000000..a619d9d --- /dev/null +++ b/scribus/doc/it/plugin_howto.html @@ -0,0 +1,322 @@ + + + + How to write a Scribus Plugin + + +

      How to write a Scribus Plugin

      + +

      Preface

      + +

      This article shows you how to write plugins for Scribus. Plugins are +libraries that are loaded into the main application at run-time. Plugins can +extend and to an extent modify the behavior of the application without having +to edit and recompile the core application. They are useful for adding extra tools, +extra import and export functions, and for various more advanced uses.

      + +

      This document assumes some basic knowledge of C++. You're assumed to know +what a header file is, how include files work, know about classes an +inheritance, and have some general familiarity with the language. Some +familiarity with Qt - mainly QString and QObject - will also help. Issues like +virtual and pure virtual functions, "extern C" declarations, the details of +memory management, etc are glossed over and avoided in this document. You don't +have to know about them, but it'll help you follow what's going on better if +you do.

      + +

      We're not going to try to explain the details of how the Scribus plugin +system works here. This is just about how to write a plugin. The documentation +in the scplugin.h and pluginmanager.h help explain +how the system works.

      + +

      For any reasonable plugin idea, you will receive encouragement and assistance from the Scribus Team. +As rule, we do not do a lot of planning or development discussion by e-mail, but by IRC. Probably 99% of +the planning and project discussions take place there. You will find #scribus usually lively during parts of each day. The team is mostly resident in Europe, so Central European Time evenings is when it is busiest.

      + +

      Where do I find Scribus Plugins?

      + +

      Scribus ships with a number of standard plug-ins. These will be installed +along with the Scribus program and its other files. On UNIX, plug-ins will be +installed in the same prefix as the main app. In Mac OS X they're included in +the .app bundle. If you want to know what these plug-ins do, the easiest way to +find out is to to fire up Scribus and go into Edit->Preferences +and click on the "plugins" icon. From there you will see a list of what +plug-ins are installed, what type of plug-in they are, and where the files +are.

      + +

      In addition to the plug-ins shipped as standard with Scribus, it is possible +to build and install plug-ins you obtain from elsewhere, or to write and add +your own.

      + +

      Before you start coding

      + +

      Let's suppose you've got a great idea to improve Scribus and you cannot wait +to start writing some excellent C++ code. Hold on for just a few minutes +and read this section; you might save yourself some time and trouble.

      + +

      Important

      + +

      Maybe you are at the edge of "reinventing the wheel" - that is, writing + something you don't have to because someone else has already done it. You + should probably join the mailing-list and post about your idea, or join the + #scribus channel on irc.freenode.net. Your topic will + be discussed and you will probably get some help and ideas from the developers + and from other users. As Scribus is freely licensed, you're welcome to work + on your own, but at least an introductory chat on IRC, or a mail to the + mailing list may save hours of work and head banging. We want to make + writing plug-ins as painless as possible for those who're interested. + +

      Compatability

      + +

      Scribus does not have a fixed C++ API for plugins to use. Releases are not + binary compatible, and unstable versions frequently break source compatibility. + Source compatibility is not currently guaranteed even across stable releases + if changes are required to fix a problem. We hope to improve this so we can + provide a stable C++ API for external code in the future. For now, if possible + you should try to bundle the core of your plugin's functionality into a + separate module that knows as little about the innards of Scribus as + possible.

      + +

      This document covers implementing a plugin for Scribus 1.3.x. It is + dramatically different to what was required for the 1.2.x series. Future + changes should be smaller.

      + + +

      Quick Start

      + +

      It's not too hard to jump in and start writing a plugin. The documentation +below describes the implementation of a plugin in some detail, with references +to places where you can find out more if you need it. A "plugin template" is +provided for your use, so if you like you can get started by making a copy of +that and getting hacking. Some basic instructions are included in the file, and +if you get confused you can refer back to this document.

      + +

      We'll build the plugin as a part of Scribus. That's the easiest way to get +started, though you'll probably want to start distributing it separately later +on (see later). To start work on an Action plugin:

      + +

      We use CMake, as support for autotools has been +deprecated and moving forward it will be the only one used in 1.3.5+

      + +
        +
      • Copy scribus/plugins/myplugin + to scribus/plugins/pluginname + (where "pluginname" is what you want to call your plugin). + pluginname must be a valid C identifier - I suggest + sticking to nothing but lower case characters.
        • + +
      • Edit scribus/plugins/CmakeLists.txt and add + "pluginname" to it by adding the subdirectory to the others. This tells Scribus's build + system to compile your plugin.
        • + +
      • rename all the files in scribus/plugins/pluginname/ + from myplugin to pluginname, eg + myplugin.h to pluginname.h. +
        • + +
      • rename myplugin wherever it appears in the files to + pluginname, e.g. myplugin_getPluginAPIVersion() + to pluginname_getPluginAPIVersion(). Do the same for + MyPlugin and MYPLUGIN. On UNIX, you can use this + command:
        + sed -i -e "s/myplugin/pluginname/g" -e "s/MyPlugin/PluginName/g" -e "s/MYPLUGIN/PLUGINNAME/g" myplugin*
        + (all on one line, run from scribus/plugins/pluginname/). +
        • +
      + +

      You're now ready to start work on your plug-in. First, you need to fill +out some information about your plug-in in pluginname.cpp:

      + +
        +
      • In PluginName::languageChange(): +
          +
        • Change m_actionInfo.text to the text of the menu item + you want to trigger your plugin.
          • +
        • Change m_actionInfo.menu to the name of the menu you + want the menu item to go in. See FIXME where???? + FIXME for a list of menu names.
          • +
        • If you want your plugin to have a keyboard shortcut, uncomment + m_actionInfo.keySequence and set it to your preferred + shortcut. The example there should show you how that works.
          • +
        +
        • + +
      • Change the name in PluginName::fullTrName() + to the name of your plugin as you want it to appear in the Help->About Plugins dialog + box and in the Plugin Manager pane in the preferences.
        • + +
      • If you want your plugin to have information such as author info and a + description when the user looks at it in Help->About Plugins, fill out + as much as you want of the about info by assigning members of + about. You can see what information can be provided by looking + at the definition of AboutData in + scplugin.h.
        • +
      + +

      You've finished setting up the plugin, and can now start programming. Your +code should go in pluginnameimpl.cpp and +pluginnameimpl.h. The existing code should display a message +dialog box.

      + +

      To compile the plugin, you can simply re-run cmake with your usual options. , +and make in the top-level Scribus directory. You may need to remove CmakeCache.txt, +but this is becoming a rarer necessity in newer versions of CMake. +When the compile completes, run make install and fire up Scribus. +Your plugin should now appear in the plugin manager (in the preferences), and +should have a menu item. If you press the menu item, a dialog box should appear.

      + +

      Building plugins outside the Scribus tree

      + +

      Quick and dirty using QMake

      + +

      Warning

      + +
    3. Beware - a qmake project easy to use but isn't necessarily the most standard + way to distribute software on the Linux platform. Scribus runs natively on Linux/Unix, MacOSX, OS/2 and + Windows. This process is an example + only for development. When you create your bug-free functional package then + make time to prepare a full featured distributon as described in the next section.
      4. + +
    4. Let's compile it, but it isn't so easy as typing in gcc + myplugin.cpp ;). One easy way to build it - Qt qmake (because some + people really really hate autoconf and automake in their complexity. We've been know to +call it worse things more than once. ). Note: you + will need to create an empty config.h file before running these + steps
      5. +
    5. On Linux or OSX systems where Qt3 and Qt4 are installed parallel, you may need to +provide the full path: e.g. /usr/lib/Qt4/qmake
      6. + +
      +
      +$qmake -project
+
      +
      + +

      Now the project file is created and we'll make just a few changes into it.

      +
      +
      +######################################################################
+# Automatically generated by qmake (1.06c) Sun Dec 14 13:32:11 2003
+######################################################################
+
+#change TEMPLATE = app. We aren't working on application just plugin
+TEMPLATE = lib
+INCLUDEPATH += .
+#As working with Scribus, we need Scribus includes too.
+INCLUDEPATH += /home/subzero/devel/Scribus/include/Scribus/
+#And Scribus have to use freetype2.
+#So we should link it too. Use paths returned from
+##freetype-config --cflags and --libs
+INCLUDEPATH += /usr/include/freetype2
+LIBS += -lfreetype -lz
+
+# Input
+#create empty config.h file
+HEADERS += myplugin.h config.h
+SOURCES += myplugin.cpp
+
      +
      + +

      After these changes you're ready to compile

      + +
      +
      +$qmake
+$make
+
      +
      + +

      Running Qmake creates the Makefile and by running make you compile your + plugin.

      + +

      Then just copy *so* files into Scribus plugin directory and run Scribus. + You'll see "Do Nothing Plugin" in the Extras menu.

      + +

      It is clear that you have to use some other way to distribute your + source code to others - some use autogenerated qmake pro files, other use + the autoconf/automake combination.

      + +

      Distribute it! (a.k.a. Compile it! 2nd edition)

      + +

      Qmake is user frendly and useful for rapid development, but traditionally there has been + one standard way to compile/distribute software for Linux, *BSD etc. - autoconf + and automake. Lets call these two programs by the automagic acronym in the + following text.

      + +

      To use automagic successfully you'll need chalk drawn to the north + oriented pentagram on the floor (Carrefour, 2€), red-black daemonic + dress (Hugo Boss, 2000€) and a sacrificed penguin on the home altar + (one hour of fear in your local zoo). Err, only joking.. dont harm any + nice little penguins, you wont need to. We strongly prefer the simpler and +easier to use CMake build system.

      + +

      Download the donothingplugin-1.0.tar.gz example from + http://docs.scribus.net, unpack it and browse it.

      + + +

      Learning More

      + +

      To go on from here, you should probably read scplugin.h and ensure +you understand that. There is an explanation of the way the plugin system works +in more detail here. Above all else, though, you'll learn how +to get things done by reading the other plugins and the core Scribus code.

      + +

      Storing your plugin's preferences:

      + +

      Scribus provides a preferences api for plugin writers to store data between + Scribus launches. There are two types of storage formats available: key-value + pairs and tables.

      + +

      First you will need to get the PrefsContext object for your + plugin. Then you can query PrefsContext to get the value for a + specific key or you can ask for a PrefsTable by it's name. Here is + a short example using key-value pairs.

      + +
      +#include <prefsfile.h>
+#include <prefscontext.h>
+
+extern PrefsFile* prefsFile;
+
+PrefsContext *myPluginPrefs = prefsFile->getPluginContext("MyPlugin");
+
+// default value -1 will be used if "i" doesn't already exist
+int i = myPluginPrefs->getInt("i");
+
+// default value "dog" will be used if "s" doesn't already exist
+QString s = myPluginPrefs->get("s", "dog");
+
+myPluginPrefs->set("i", 221);
+myPluginPrefs->set("s", "cat");
+
      + +

      Scribus Object Model

      + +

      Scribus's source code is lightly documented. There is a significant + effort to correct this, but given the size of the codebase it's taking + quite some time. Please do try to follow what's going on based on the + header files and the code. If you're unable to sort it out, feel free to + drop in on IRC or ask on the mailing list, and someone may well be able to + help you. Try to be patient - we're not always on IRC or available, and it + can take time to answer a message if everybody's busy.

      + +

      If you feel like improving the documentation or fixing the doxygen api + docs generation, the praise will be endless.

      + +

      One important thing to understand is that the core Scribus application + can be accessed via the static global pointer ScApp, declared + in scribus.h. Confusingly, this is a QMainWindow subclass. + You can also get to the QApplication subclass used as ScQApp + from scribusapp.h.

      + +

      Some major subsystems are singleton classes that are accessible via + ClassName::instance() . Examples include PluginManager, + ScPaths, and growing numbers of others. The advantage + of this is that you can interact with these classes without having to + delve into the guts of ScApp.

      + +

      Plugin related links

      +Qt documentation from Trolltech
      +QMake documentation from Trolltech
      +
      + + \ No newline at end of file diff --git a/scribus/doc/it/print1.html b/scribus/doc/it/print1.html new file mode 100644 index 0000000..869f742 --- /dev/null +++ b/scribus/doc/it/print1.html @@ -0,0 +1,24 @@ + + + + Stampare con Scribus + + +

      Stampare con Scribus

      +

      Quando si utilizza un'applicazione avanzata per il desktop publishing come Scribus, può esserci qualche problema nella terminologia relativa alla stampa. La stampa potrebbe avvenire direttamente in casa o in ufficio, oppure presso un'azienda specializzata che svolge l'attività di stampa in modo professionale. Inoltre esiste una vasta gamma di macchine per la stampa, da piccoli apparecchi usati in casa o in ufficio, alle vere e proprie macchine tipografiche impiegate su scala industriale. Per evitare confusioni e fraintendimenti, chiameremo “stampa locale” la stampa per mezzo di un apparecchio da scrivania in casa o in ufficio, e “stampa commerciale” o “stampa in tipografia” quella eseguita presso un'azienda specializzata o per mezzo di una stampante di alto livello o una macchina tipografica.

      + +

      Stampa locale: alcune informazioni generali

      + +

      A prima vista può sembrare molto strano, ma il programma di DTP Scribus, il cui scopo principale è creare documenti destinati ad essere stampati, potrebbe non funzionare affatto con il rumoroso apparecchio che se ne sta sulla vostra scrivania, anche se il programma sembra rilevare benissimo la stampante locale attraverso le impostazioni di sistema. Questo è un problema noto. Gli sviluppatori ne sono a conoscenza, ma risolverlo è molto complicato, e, quel che è più importante, vi sono facili soluzioni alternative.

      + +

      Perché, probabilmente chiederete, la stampa diretta dall'interno di Scribus è un tale problema? Le altre applicazioni stampano benissimo su tutte le piattaforme su cui Scribus è utilizzabile. La risposta breve è che i dati che Scribus genera e invia alla stampante sono pensati per una stampante PostScript di alto livello. Una macchina di questo tipo può essere (e probabilmente è) piuttosto costosa. La maggior parte delle stampanti per uso “domestico” (o i loro driver) non sono in grado di interpretare le istruzioni PostScript generate da Scribus.

      + +

      Per gli utenti che hanno una formazione tecnica, e qualche conoscenza della più recente storia dei computer, spieghiamo un'altra causa di potenziali problemi. Qualche decennio fa, quando i dispositivi per la stampa a prezzo contenuto erano poco più che macchine per scrivere azionate dall'esterno, una nuova azienda chiamata Adobe, che in seguito sarebbe diventata uno dei giganti del settore del software, introdusse il linguaggio di descrizione pagina PostScript, che divenne parte integrante della “rivoluzione del desktop publishing”. Con il linguaggio PostScript e le stampanti compatibili con PostScript, divenne possibile stampare documenti con impaginazione elegante su macchine “da scrivania”, anche se le prime stampanti PostScript erano così costose che soltanto una piccola parte delle scrivanie ebbe mai l'onore di ospitare una macchina di questo tipo. Tra le cause che spingevano verso l'alto i costi delle stampanti PostScript vi erano i costi di licenza del linguaggio PostScript stesso e di un insieme di base di caratteri PostScript, poiché entrambi erano necessari per costruire una “vera” stampante PostScript. Un altro motivo era collegato all'hardware per la stampa. Questo è il punto in cui la Microsoft entrò in scena e fece ai fornitori di hardware un offerta che non potevano rifiutare. La Microsoft introdusse la cosiddetta Graphical Device Interface (GDI), che rese il PostScript largamente obsoleto (almeno per le stampanti da scrivania): essa forniva meno funzionalità (ma nella maggior parte dei casi, sufficienti), e trasferiva una parte dell'elaborazione dei dati di stampa dalla stampante (hardware) al sistema operativo (software), che naturalmente era Windows. La possibilità di risparmiare alcuni centesimi per macchina indusse i produttori a sviluppare stampanti da scrivania a basso costo che funzionavano solo con il sistema operativo Windows. Per gli sviluppatori di altri sistemi operativi ci vollero anni per creare un ponte tra le macchine “GDI” e i sistemi di stampa basati su PostScript (ad esempio in Mac OS X, Linux, *BSD, UNIX), ma non tutte le stampanti GDI sono pienamente utilizzabili con la stampa basata su PostScript (che significa, in sostanza, ogni sistema che non è Windows). Oggi molti produttori offrono driver per le loro stampanti anche per Mac OS X e Linux, oppure offrono agli sviluppatori abbastanza informazioni da permettere loro di scrivere driver funzionanti.

      +

      Questa digressione può aiutare a comprendere perché la stampa diretta dall'interno di Scribus può non funzionare, ma non è una spiegazione sufficiente. Poiché l'output di Scribus è inteso per essere stampato su una “vera” (leggi: di alto livello) stampante PostScript, può non funzionare con molte altre macchine. I lettori che hanno qualche conoscenza dello standard di stampa UNIX (CUPS: Common UNIX Printing System, utilizzato da Mac OS X, Linux, *BSD, e altri), probabilmente chiederanno come ciò sia possibile, ma la risposta è che Scribus genera un output PostScript di alto livello, le cui istruzioni a volte non possono essere elaborate dai rispettivi interpreti o driver PostScript.

      + +

      Tutto questo può suonare un po' inquietante, ma è abbastanza probabile che riuscirete a stampare direttamente sulla vostra stampante locale. Una stampante correttamente configurata in Windows probabilmente stamperà senza problemi. In Linux potrebbe funzionare bene, oppure potrebbe semplicemente richiedere un comando di stampa alternativo: vale la pena di fare qualche prova.

      + +

      Come stampare senza problemi sulla stampante locale

      +

      Il modo più sicuro di stampare un documento di Scribus sulla vostra stampante locale consiste nell'esportare il file di Scribus in PDF e poi stamparlo da Adobe Reader. Anche se Adobe Reader ha ricevuto critiche ben meritate per quanto riguarda problemi di sicurezza, è ancora il visualizzatore PDF più affidabile e funziona perfettamente con i sottosistemi di stampa di ogni moderno sistema operativo.

      + + diff --git a/scribus/doc/it/print2.html b/scribus/doc/it/print2.html new file mode 100644 index 0000000..c581842 --- /dev/null +++ b/scribus/doc/it/print2.html @@ -0,0 +1,56 @@ + + + + Strumenti per la stampa (1) + + +

      Strumenti per la stampa (1)

      +

      La verifica preliminare

      +

      La verifica preliminare è uno strumento che permette di controllare la presenza in un documento di problemi potenziali o probabili che possono sorgere nella stampa commerciale. Fare errori nella preparazione di un documento può comportare costi finanziari notevoli, e può farvi sembrare e sentire incompetenti. La creazione di documenti che non causano problemi quando l'organizzazione del lavoro prevede la stampa commerciale non richiede anni di studio. Ciò che richiede è una certa preparazione, e questa guida in linea fornisce almeno una parte delle informazioni necessarie. Ancora meglio, Scribus contiene uno strumento, la “verifica preliminare”, che può aiutarvi a identificare più facilmente i potenziali problemi; dovreste ignorare gli avvisi che fornisce solo se siete sicuri che questo non causerà errori.

      +

      La verifica preliminare può essere eseguita dalla barra dei menù da Finestre > Verifica preliminare. Inoltre appare automaticamente se qualche errore viene rilevato quando si lancia la stampa, si apre l'anteprima di stampa, o si esporta in PDF, EPS o PostScript:


      + +
      + +

      In “Profilo corrente” potete selezionare il tipo di file a cui è destinata l'esportazione o la stampa: PostScript (che comprende l'EPS), PDF 1.3, 1.4, 1.5 o X-3. Il profilo predefinito è quello impostato in Impostazioni Documento o in Preferenze (vedi sotto). Al di sotto del menù per la selezione del profilo è mostrato un elenco di tutti gli elementi del documento. Nella prima colonna, gli elementi per cui non è stato rilevato alcun errore sono marcati da un segno di spunta verde. Gli oggetti con potenziali errori sono indicati da un segnale di allarme. Nella seconda colonna è indicato l'errore potenziale, e la terza indica il livello su cui l'oggetto di trova, con il nome e il colore del livello stesso. Selezionando un oggetto in questa finestra, viene selezionato anche l'oggetto stesso, e Scribus si sposta alla rispettiva pagina. Dopo aver corretto un potenziale errore, potete ripetere la verifica. Potete anche decidere di ignorare gli avvisi ed esportare o stampare comunque.

      + +

      Spesso potreste considerare questi come semplici avvisi, piuttosto che come errori veri e propri. Ad esempio, nella finestra di dialogo qui sopra, potreste già sapere che l'immagine Image13 è una GIF e ha una bassa risoluzione, ma non avevate altra scelta che utilizzarla così com'è. Ma anche così, può servire a ricordarvi di controllare attentamente quell'immagine nel PDF per vedere se è adatta alle vostre necessità. D'altra parte, è probabile che abbiate dimenticato di cancellare la Image12, che è vuota, o che abbiate dimenticato di caricarvi un'immagine; e probabilmente nella Text9 non volevate inserire un testo troppo lungo per la cornice. In un documento lungo, anche se eseguite più volte dei controlli manuali, errori di questo genere possono capitare facilmente.

      + +

      Come quasi ogni altra funzione di Scribus, la verifica preliminare può essere configurata nelle Impostazioni documento oppure nelle Preferenze:

      +
      +
      +

      Le opzioni in questo pannello sono le seguenti:

      +
        +
      • Tipo di file (menù a discesa): qui potete selezionare, in base al tipo di file, quali potenziali problemi di stampa/esportazione Scribus verifica per impostazione predefinita.
        • +
      • Ignora tutti gli errori: in base a quanto avete letto prima, potete essere certi che attivare quest'opzione non è una buona idea: un errore scoperto dopo il completamento della stampa in tipografia può dimostrarsi costoso.
        • +
      • Controllo automatico prima della stampa o dell'esportazione: se questa opzione è attiva, la verifica preliminare, oltre che poter essere lanciata manualmente dall'utente, sarà eseguita automaticamente quando si stampa o si esporta un file PostScript o PDF e segnalerà eventuali errori rilevati.
        • +
      • Controlla glifi mancanti: questa opzione fa in modo che Scribus controlli la mancanza di glifi nei tipi di carattere utilizzati. Non sottovalutate la sua importanza, poiché il cambiamento del tipo di carattere, ad esempio in un foglio di stile o con la formattazione diretta, può far sì che il testo usi dei glifi non presenti nel nuovo carattere selezionato.
        • +
      • Controlla oggetti che non sono sulla pagina: potete facilmente spostare o persino creare oggetti al di fuori della pagina, cioè nello spazio di lavoro grigio (lo spazio appunti) intorno alle pagine. Questa è una caratteristica utile, ma può rovinare un file PostScript o PDF destinato alla stampa commerciale, ed è piuttosto facile “dimenticare” un elemento che si trova nello spazio appunti (ad esempio, una cornice vuota). Quindi è fortemente consigliabile non disabilitare questa opzione.
        • +
      • Controlla sovrapposizioni nelle cornici di testo: come avidi lettori di questa guida in linea, sicuramente saprete che il lavoro con Scribus è per lo più basato su cornici, e sicuramente saprete della necessità di ridurre la dimensione del carattere, oppure di allargare la cornice o collegarla a una successiva, se il testo è troppo lungo per una particolare cornice. In modo simile a quanto accade per i “glifi mancanti”, uno dei possibili problemi che possono rovinare o degradare la vostra costosa stampa è il cambiamento del tipo di carattere, poiché l'ampiezza dei glifi è variabile a seconda del tipo di carattere stesso. In alcuni casi anche l'uso dello stesso carattere su piattaforme diverse, o persino sullo stesso computer, può far sì che il testo superi lo spazio disponibile, poiché un aggiornamento potrebbe aver installato una nuova versione di un file di caratteri in cui le misure dei glifi sono cambiate.
        • +
      • Controlla le trasparenze usate: il formato di file PostScript non accetta trasparenze, e nemmeno il PDF 1.3, che Scribus è tuttora in grado di utilizzare. Poiché anche il PDF/X-3 è basato sul PDF 1.3, è necessario che questa opzione sia attiva solo per queste tre destinazioni di esportazione/stampa.
        • +
      • Controlla immagini mancanti: Scribus non salva le immagini bitmap all'interno dei suoi file; invece, crea dei collegamenti alle immagini in uno dei formati bitmap che è in grado di utilizzare. Può accadere facilmente che l'utente salvi un'immagine con un nome diverso, in un altro formato o in un'altra posizione: quindi il collegamento all'immagine potrebbe interrompersi, e la relativa cornice immagine sarà vuota. Un problema di questo genere può sfuggire facilmente: questa opzione fa in modo che Scribus lo segnali.
        • +
      • Controlla risoluzione immagini: poiché siete lettori illuminati, già sapete che la risoluzione delle immagini bitmap può essere un elemento critico per la riuscita della stampa; se la risoluzione è troppo bassa, le immagini stampate avranno un aspetto orrendo, e se è troppo alta le dimensioni di un file PostScript o PDF esportato potrebbero essere troppo grandi perché un Raster Image Processor (RIP) commerciale possa elaborarlo. Questa opzione fa sì che Scribus controlli se la risoluzione di un'immagine è troppo alta o troppo bassa per una certa destinazione. Come potete vedere, potete modificare i limiti in entrambe le direzioni, ma tenete presente che i valori predefiniti sono sensati nella maggior parte dei casi.
        • +
      • Controlla file PDF inseriti: Scribus può importare file PDF nelle cornici immagine per mezzo di Ghostscript. Scribus si serve di Ghostscript per “rasterizzare” (cioè per creare un'immagine bitmap di) un file PDF importato, e il risultato potrebbe non piacervi. Inoltre la qualità dell'importazione del file dipende dalla versione di Ghostscript che avete installato. Da qui l'opzione che fa sì che Scribus controlli se sono presenti file PDF importati, che è utile soprattutto se scambiate file di Scribus tra computer con diverse versioni di Ghostscript installate.
        • +
      • Controlla immagini GIF: avete già imparato che per i file GIF non c'è posto nella stampa professionale, ma anche se lo sapete potrebbe accadervi di ricevere da altri un archivio ZIP con un file di Scribus e le relative immagini, e alcune di esse potrebbero essere in formato GIF. Quindi, anche se la “minaccia GIF” potrebbe non essere imminente, non fa male lasciare attivata questa impostazione predefinita.
        • +
      • Controlla campi e annotazioni PDF: i file PDF contenenti annotazioni e campi vengono rifiutati da tutti i Raster Image Processor (RIP) commerciali, quindi se volete creare un file PDF pronto per la stampa dovreste lasciare questa opzione attiva.
        • +
      • Ignora livelli non stampabili: questa opzione serve per esportare soltanto i livelli contrassegnati come “stampabili”, il che è utile soprattutto se avete creato un file con un livello per ogni lingua.
        • +
      • Controlla livelli con impostazioni visibile/stampabile non corrispondenti: la possibilità di rendere un livello invisibile quando lavorate sul documento è molto utile, ma se dimenticate di rendere i livelli di nuovo visibili, nel file PostScript o PDF finale potrebbero mancare certi elementi. Potrebbe accadere anche il contrario, ad esempio se create un documento con più livelli per diverse lingue o diversi schemi di colore. Questa opzione fa sì che Scribus controlli se i livelli visibili sono anche “stampabili”, e in questo contesto “stampabile” significa anche che il livello o il suo contenuto saranno esportati.
        • +
      +

      L'anteprima di stampa

      +

      Come accennato nella pagina precedente, una delle sfide nell'uso di un'applicazione avanzata di DTP come Scribus consiste nel gestire l'output PostScript “di alto livello”. Se vi capita di poter usare una vera stampante PostScript (che non sarà una macchina piccola come quella con cui stampate le vostre foto), potreste cominciare ad apprezzare alcune delle capacità di stampa PostScript di Scribus. Esaminiamo meglio l'anteprima di stampa, che si apre da File > Anteprima di stampa.

      +

      L'anteprima di stampa in Scribus è qualcosa di speciale, perché fa ben più che semplicemente generare una visualizzazione del documento. Scribus crea l'anteprima di stampa creando e analizzando un file PostScript temporaneo. Dovreste avere un po' di pazienza quando generate l'anteprima di stampa, poiché dietro c'è un bel po' di lavoro! È opportuno ricordare che questa è una delle funzioni di Scribus che hanno bisogno che Ghostscript sia installato sul computer.

      +

      L'anteprima di stampa, utilizzata insieme alla verifica preliminare, può aiutarvi a identificare potenziali problemi quando l'organizzazione del lavoro prevede l'utilizzo di file e stampanti PostScript. L'affidabilità e la precisione dell'anteprima di stampa dipendono principalmente dalle capacità del vostro sistema di stampa, compresa la qualità dei driver, e il tipo di caratteristiche avanzate comprese nei documenti che create. Le caratteristiche che possono creare problemi con la stampa comprendono ad esempio sfumature, trasparenze, maschere complesse.


      + +
      Anteprima di stampa
      +

      La maggior parte delle opzioni nell'anteprima di stampa sono state create per la stampa avanzata PostScript o per la stampa commerciale. Quindi la maggior parte, se non tutte, le opzioni in questa finestra sono probabilmente superflue se vi servite di una semplice stampante da scrivania.

      +

      Il primo gruppo di opzioni riguarda le “Impostazioni di visualizzazione” relative alla stampa:

      +
        +
      • Abilita antialiasing: attiva o disattiva l'anteprima del testo con caratteri dotati di anti-aliasing. Questo ha effetto soltanto sui caratteri PostScript e potrebbe rallentare lievemente la visualizzazione.
        • +
      • Visualizza trasparenza: mostra lo sfondo della pagina in modo trasparente.
        • +
      • Visualizza CMYK: questa opzione fornisce una simulazione a video di inchiostri CMYK generici e dei colori spot. Quando è attiva, è possibile abilitare o disabilitare la visualizzazione di ciascun colore CMYK o spot.
        • +
      • Visualizza copertura inchiostro: con questa opzione, Scribus calcola e mostra la copertura dell'inchiostro per ciascuna parte della pagina. Nella schermata qui sotto viene mostrata la copertura per l'inchiostro “magenta”.

        • +
        Anteprima della copertura di inchiostro
        +
      +

      Il secondo gruppo di opzioni riguarda la visualizzazione del documento nell'anteprima di stampa. Sono spiegate nella pagina sulla finestra di dialogo per la stampa. Le opzioni nella parte inferiore dovrebbero essere di immediata comprensione.

      + + + diff --git a/scribus/doc/it/print3.html b/scribus/doc/it/print3.html new file mode 100644 index 0000000..5f87d68 --- /dev/null +++ b/scribus/doc/it/print3.html @@ -0,0 +1,21 @@ + + + + Strumenti per la stampa (2): la finestra di dialogo Stampa + +

      Strumenti per la stampa (2): la finestra di dialogo Stampa

      +

      Se la vostra stampante e il sottosistema di stampa del vostro sistema operativo permettono la stampa diretta dall'interno di Scribus, specialmente se vi servite di una stampante PostScript, Scribus offre alcune funzioni per la stampa che non si trovano nella maggior parte degli altri programmi. È importante osservare nuovamente che la disponibilità di queste funzioni dipende dalla qualità del driver della stampante. Inoltre, almeno su Windows, dove Scribus utilizza la “Graphical Device Interface”, dipende anche dalle funzioni che il produttore ha reso accessibili attraverso il driver. Per ragioni di usabilità, il numero di opzioni potrebbe essere stato intenzionalmente limitato su questo sistema operativo. Di seguito descriveremo la finestra di dialogo Stampa per i sistemi operativi che utilizzano il sistema di stampa CUPS (Linux, *BSD, UNIX, Mac OS X).


      +
      La finestra di dialogo Stampa
      +

      Destinazione della stampa

      +

      La prima cosa che dovete decidere qui è se volete effettivamente stampare su carta (o su un supporto fisico simile) oppure “stampare” su un file, cioè creare un file PostScript, che in seguito può essere inviato a una tipografia in grado di utilizzare il PDF. Se non è installato alcun driver per la stampa, creare un file PostScript sarà la sola opzione disponibile.

      +

      Opzioni della stampante

      +

      La casella “Comando alternativo per la stampa” è importante solo su sistemi Linux e UNIX. Un esempio del suo utilizzo è l'uso di una specifica finestra di dialogo per la stampa in un particolare ambiente desktop, poiché tale finestra di dialogo potrebbe offrire funzioni aggiuntive (come esportazione PDF basata su Ghostscript), oppure un insieme ridotto di funzioni, che può facilitare la stampa diretta da Scribus per l'utente medio.

      +

      Come accennato prima, i sistemi operativi che usano CUPS (Common UNIX Printing System) per la stampa, di solito offrono la possibilità di utilizzare un gran numero di funzioni per una data stampante, molte delle quali sono importanti solo per gli utenti esperti. Come si vede nella schermata sotto, tra questi vi sono il bilanciamento dei colori dell'inchiostro o le dimensioni delle goccioline di inchiostro. Se avete bisogno di un elevato livello di controllo sulla stampante locale, è consigliabile che vi serviate di un driver Gutenprint, purché ne esista uno per la vostra stampante. Scribus permette di utilizzare direttamente le funzioni dei driver Gutenprint via CUPS.


      +
      Opzioni stampante fornite da CUPS
      + +

      Intervallo

      +

      Le opzioni di questa parte della finestra di dialogo dovrebbero esservi familiari, almeno se avete mai stampato da un elaboratore di testi.

      +

      Altre opzioni per la stampa

      +

      Probabilmente non si sbaglia dicendo che la maggior parte delle funzioni nella parte inferiore della finestra di dialogo sono importanti solo per utenti professionali, il che significa che l'utente “medio” può ignorarle. Ciò significa anche che non è necessario che le spieghiamo in dettaglio qui, poiché esse sono (o dovrebbero essere) ovvie per gli utenti professionali.

      + + diff --git a/scribus/doc/it/print4.html b/scribus/doc/it/print4.html new file mode 100644 index 0000000..e4d674a --- /dev/null +++ b/scribus/doc/it/print4.html @@ -0,0 +1,22 @@ + + + + Preparare file per la stampa commerciale + + +

      Preparare file per la stampa commerciale

      +

      Se non avete mai trattato con una tipografia, l'atteggiamento che dovreste assumere è quello di non farvi spaventare dal processo. Pagate per avere un servizio, e quindi avete diritto a comprendere le vostre opzioni; inoltre, scoprirete che capire le richieste della tipografia vi aiuterà a creare un file che la tipografia stessa potrà utilizzare senza problemi. Evitare incomprensioni e far comprendere alla tipografia i vostri obiettivi prima che cominci il lavoro: questo probabilmente vi aiuterà a prevenire la maggior parte dei potenziali problemi. Se non ottenete risposte soddisfacenti da una certa azienda, cercatene un'altra. Il settore della stampa è competitivo: le aziende migliori offrono consigli e servizi di buona qualità tecnica e disponibilità verso il cliente.

      + + +

      Non esitate a far domande

      +
        +
      • La tipografia accetta file PDF?
        Se la risposta è no, vive ancora nell'età della pietra della stampa, e dovreste evitarla.

        • +

      • Se accettano file PDF, quali versioni sono in grado di utilizzare in modo affidabile?
        La risposta è importante specialmente se usate la trasparenza in file PDF 1.4 o 1.5, poiché certe tipografie potrebbero ancora avere macchine non in grado di utilizzare la trasparenza. In questi casi, la tipografia dove elaborare il vostro PDF con Acrobat per “appiattire” le trasparenze, con possibili costi aggiuntivi.

        • +

      • Possono fornire un profilo ICC della loro stampante, se la riproduzione fedele del colore è di importanza critica?
        Questo può aiutarvi a controllare i colori sul vostro schermo.

        • +

      • Se intendete servirvi di colori spot, quali serie di colori spot sono in grado di riprodurre in modo affidabile?
        Un esempio: se intendete usare i colori dello standard francese AFNOR o di quello tedesco RAL per una stampa da eseguire in Nord America, questo potrebbe essere un problema, poiché la maggior parte delle tipografie americane non ha familiarità con questi colori e la loro riproduzione affidabile.

        • +

      • Qual è il livello PostScript del loro RIP?
        Questo può essere un fattore decisivo per la preparazione dei vostri file. Se il loro RIP è 3015.xxx+, potete essere certi che sia in grado di gestire il 100% delle caratteristiche di Scribus. Potrebbero non essere in grado di rispondere direttamente, ma vale la pena chiederlo.

        • +

      • Possono eseguire l'imposizione?
        L'imposizione consiste nella stampa delle pagine del documento sui fogli di carta che formano un libro, che sono piegati e rilegati per ottenere il prodotto finito. In Scribus potete creare le pagine destre e sinistre, e forse aggiungere alcune pagine bianche in modo che la collocazione di ciascuna pagina sia soddisfacente. Il processo di imposizione ridispone le pagine del documento in modo che nel prodotto finito esse si trovino nell'ordine giusto e nelle posizioni corrette. I tipografi esperti dovrebbero essere in grado di eseguire questa operazione per voi; anzi, potrebbero preferire che non tentiate di eseguire l'imposizione da soli.

        • +

      • Se vi restano domande senza risposta, chiedete sulla mailing list o su IRC. Di solito c'è qualcuno abbastanza esperto da rispondere alle vostre domande.
        • +
      + + diff --git a/scribus/doc/it/readme-macosx.html b/scribus/doc/it/readme-macosx.html new file mode 100644 index 0000000..e9b8120 --- /dev/null +++ b/scribus/doc/it/readme-macosx.html @@ -0,0 +1,26 @@ + + + + Scribus su Mac OS X + +

      Scribus su Mac OS X

      +

      Hardware

      +
        +
      • Mac basato su Intel
        • +
      • 512 MB RAM in aggiunta a quanto richiesto per la memoria di sistema; maggiore è la quantità di RAM, meglio è. Per documenti grandi o complessi si consigliano almeno 1–2 GB.
        • +
      +

      Prima di installare Scribus

      +
        +
      • è consigliabile installare Ghostscript per Mac OS X, preferibilmente Ghostscript 8.60+ o successivo. Questo è importante per l'importazione e la stampa di EPS, PS e PDF. Potete anche installarlo per mezzo di MacPorts o Fink: il risultato sarà lo stesso.
        • +
      +

      Installazione

      +
        +
      • per installare Scribus basta prelevare il pacchetto DMG o *.pkg per Mac OS X da Sourceforge, aprirlo e trascinare l'icona di Scribus nella posizione che preferite. La finestra di DMG Finder propone la directory predefinita di sistema Applicazioni. Da essa potete fare clic sull'icona e lanciare Scribus.
        • +
      • il primo avvio di Scribus, o quando un nuovo utente lancia Scribus, può richiedere molto più tempo del normale. Questo accade perché Scribus crea un file di cache dei caratteri presenti sul vostro sistema. I lanci successivi sono molto più rapidi.
        • +
      +

      Software aggiuntivo

      +
        +
      • Scribus 1.4 contiene un nuovo tipo di cornice, la cornice rendering. Permette di utilizzare altri programmi e di visualizzare il loro output all'interno di un documento di Scribus. Per poterla utilizzare, è necessario installare questi programmi. Per impostazione predefinita, Scribus è preconfigurato per usare LaTeX, Lilypond, POV-Ray, Graphviz, e Gnuplot. +
        • +
      + \ No newline at end of file diff --git a/scribus/doc/it/readme-os2.html b/scribus/doc/it/readme-os2.html new file mode 100644 index 0000000..7d1d96c --- /dev/null +++ b/scribus/doc/it/readme-os2.html @@ -0,0 +1,48 @@ + + + + Scribus on OS/2 ® and eComStation™ + + +

      Scribus on OS/2 Warp4® and eComStation™

      + +

      The Scribus Team is much obliged to Paul Smedley for taking pains over porting Scribus to the OS/2 and eComStation platforms.

      + +

      The Scribus Team also wants to thank Serenity Systems for supporting development and testing of the OS/2 and eComStation port.

      + +
      Scribus on eComStation
      + +

      Requirements

      +

      To use Scribus on OS/2 and eCS, the following requirements have to be met: +

        +
      • A copy of libc063.dll and gcc445.dll. Both files need to copied to C:\OS2\DLL (OS/2) or C:\ECS\DLL (eComStation).
        • +
      • It also requires the Qt4 GA dll’s, which can be downloaded from http://svn.netlabs.org/qt4
        • +
      • Note that some of the abovementioned libraries are available as WarpIn packages from http://www.netlabs.org. To successfully install all *.wpi files, you need to have at least WarpIn 1.0.15 installed.
        • +
      • Ghostscript and Python 2.6 (both available from http://os2ports.smedley.info) are required to support some functionality. For instance, Python scripts won’t work if Python is missing. The print preview and EPS import will not work if Ghostscript isn’t available.
        • +
      • As of eComStation 2.0, Scribus 1.3.8 is being shipped with the installation CDs, so by installing this older version from the Add-on CD, all required components are already available and properly installed on your system. Thus, you can easily download the latest Scribus version and use it as described below.
        • +
      +

      + +

      Installation

      +

      The Scribus version for OS/2 and eCS is not being shipped with an installer. All you need to do is download the ZIP file from Sourceforge (the OS/2 and eCS version is the ZIP file with “OS2” in the file name) and unzip the archive to wherever you want. Then enter the extracted SCRIBUS-1.4.x-OS2-date\scribus directory, where “x” is a placeholder for the respective Scribus version number, and “date” stands for the creation date of your Scribus version, e.g. 20110128 (=28 January 2011) and double-click the scribus.exe file. You can also start Scribus from the command prompt.

      +

      Note that you have to extract the content of the ZIP file to a partition that uses a file system which supports long file names. FAT16 does not support long file names, while the existing FAT32 or even NTFS file system drivers for OS/2 and eCS are experimental at best, so the safest bet is to use a native IBM file system like HPFS (the OS/2 and eCS default FS) or JFS.

      + +

      Installing and Configuring Ghostscript

      +

      Like Scribus, Ghostscript doesn’t come with an installer. Simply download and extract the ZIP file from the link mentioned above. To configure Scribus for the use of Ghostscript, open the File > Preferences dialog in Scribus, then go to the “External Tools” tab. Under “PostScript Interpreter” you can either enter the path to the Ghostscript executable file manually or use the file dialog by clicking on “Change ...”. The name of the executable is gsos2.exe, and it’s located in the subdirectory \bin, so the path to the file may look like this: X:\GHOSTSCRIPT-900-OS2-date\GS900OS2\bin\gsos2.exe.

      + +

      Known issues

      +

      +

        +
      • Printing support is not complete, but PDF export is. You can easily print via Adobe Reader or another PDF viewer as a temporary workaround.
        • +
      • As for Adobe Reader on OS/2, please read the detailed hints in the toolbox section.
        • +
      +

      + +

      A Special Note to OS/2 and eComStation Users

      + +

      General feedback can be provided to paul@smedley.info and via the normal Scribus communications methods (IRC, mailing list etc). Bug reports should go to http://bugs.scribus.net.

      +

      If you like this software and want to support continued OS/2 and eCS ports, please consider donating via PayPal via the link at http://smedley.info/os2ports, or via the Mensys online store at http://www.mensys.net/os2ports.

      +

      You can also sponsor/support the Qt4 for OS/2 project – without the Netlabs Qt4 project, this port could not exist!

      + + + diff --git a/scribus/doc/it/readme-win32.html b/scribus/doc/it/readme-win32.html new file mode 100644 index 0000000..7ab8b12 --- /dev/null +++ b/scribus/doc/it/readme-win32.html @@ -0,0 +1,29 @@ + + + + Scribus su Windows + + +

      Scribus su Windows

      + +

      Requisiti hardware/software minimi:

      +

      +

        +
      • Scribus può essere installato e utilizzato su Windows 2000 SP4, Windows XP, Vista o 7. Non funziona su Windows 98 e ME.
        • +
      • è fortemente consigliato avere almeno 512 MB di RAM; maggiore è la quantità di RAM, meglio è.
        • +
      • processore Pentium III o superiore; 750 MHz o superiore.
        • +
      • Scribus è disponibile soltanto in versioni a 32 bit per Windows. Su sistemi a 64 bit non risulta che vi siano problemi, e non richiede nessuna speciale preparazione né configurazione post-installazione.
        • +
      • è fortemente consigliato disabilitare eventuali temi personalizzati per il desktop. Se incontrate comportamenti strani (ad esempio, se nessun documento appare a video), usate il tema “Windows Classico“. Qt ha un problema noto con i temi personalizzati, che può ostacolare il caricamento dei documenti. Questo è accade specialmente con temi forniti da terzi.
        • +
      +

      +

      Prima di installare Scribus

      +

      È consigliabile installare Ghostscript 8.7 o successivo, che serve per l'importazione EPS.
      Nota: dopo l'installazione troverete due file Ghostscript *.exe sul vostro sistema. Quello corretto da utilizzare nelle preferenze di Scribus (in Strumenti esterni) per Ghostscript è gswin32c.exe, non gswin32.exe. Nella gran maggioranza dei casi, se Ghostscript viene installato correttamente prima di Scribus, Scribus individua automaticamente la sua posizione. Ciò detto, Ghostscript di solito non è essenziale per poter utilizzare Scribus. Se non avete installato Ghostscript, Scribus all'avvio vi avverte della mancanza di Ghostscript e vi dà un link per scaricarlo, ma potete anche decidere di non installare questo strumento esterno.

      +

      Durante l'installazione

      +

      Se selezionate l'opzione “Extra Fonts” nel programma di installazione, saranno installati due pacchetti di caratteri di alta qualità liberamente distribuibili. Il primo comprende i caratteri URW da Ghostscript: si tratta di 45 tipi di carattere compatibili con quelli compresi nella maggior parte delle stampanti PostScript. Il secondo comprende la famiglia Bitstream Vera, ampiamente utilizzata in ambiente Linux e da alcuni dei modelli inclusi in Scribus.

      +

      Dopo l'installazione

      +

      Il primo avvio di Scribus, o quando un nuovo utente lancia Scribus, può richiedere molto più tempo del normale. Questo accade perché Scribus crea un file di cache dei caratteri presenti sul vostro sistema. I lanci successivi sono molto più rapidi.

      + +

      Modalità console per la diagnostica

      +

      Nel menù Start > Programmi c'è un collegamento aggiuntivo: Scribus -console. Questa modalità apre semplicemente un prompt dei comandi di Windows, in cui viene mostato riga per riga ciascun carattere e il suo percorso mentre Scribus lo carica. Vengono mostrati anche eventuali tipi di carattere non accettati da Scribus o duplicati, e in alcuni casi anche altre informazioni diagnostiche. I duplicati non vengono importati, anche se hanno nomi diversi.

      + + diff --git a/scribus/doc/it/readme.html b/scribus/doc/it/readme.html new file mode 100644 index 0000000..b7d5c76 --- /dev/null +++ b/scribus/doc/it/readme.html @@ -0,0 +1,216 @@ + + + + What’s New in Scribus 1.4? + + +

      What’s New in Scribus 1.4?

      +

      This is a cursory overview over the changes in Scribus compared to to the latest stable version 1.3.3.14.

      + +

      Note that the file format has changed and is not backwardly compatible with any prior stable version (1.3.3.14 or earlier). To be precise, you will not be able to open 1.4.0 files with version 1.3.3.14 or any earlier version.

      +

      General

      +
        +
      1. On initial launch, 1.4 will offer to inherit the configuration data from any existing prior version, but it will store them separately, so you can run 1.3.3.x in parallel with 1.4
        2. +
      2. You can install both versions in parallel and run them at the same time. The only caveat is to install them using different installation directories, e.g 1.3.3.x in /usr/local and 1.4 in /opt or $home/bin on Linux/UNIX. If you’re building Scribus from source, you can use the -DCMAKE_INSTALL_PREFIX:PATH= argument to configure where Scribus should be installed. On other platforms you can determine the location during the installation process.
        3. +
      +

      New in Scribus 1.4

      + +

      Qt4 Port

      +

      One of the major endeavours on the way from 1.3.3.x to 1.4 was the porting to the Qt4 toolkit. Among others, it enabled a vastly better performance under Mac OS X, as well as the creation of native DMGs for OS X. Scribus 1.4 DMGs will run on OS X 10.5 or later.

      + +

      Object Handling

      +
        +
      • Significant enhancements to Multiple Duplicate.
        • +
      • Transform tools as known from Illustrator.
        • +
      • New options to align and distribute objects.
        • +
      • Advanced multiple object selection.
        • +
      + +

      Text and Typography

      +
      Typography:
      +
        +
      • Glyph Extension
        • +
      • Variable First Line Offset for text frames.
        • +
      • Character Styles.
        • +
      • New Style Manager that allows for style hierarchies, cloned styles and style inheritance.
        • +
      • A new glyph selector which allows for the creation of glyph sets that can be shared between users.
        • +
      • Major improvements to the hyphenator.
        • +
      • Optical margins to give the impression of a straighter edge with justified text by moving hyphens, commas and parts of certain glyphs slightly into the margin:
        • +
      +
      + + + + + + + + + +
      Optical Margins
      Optical Margins
      +
      +
      Text
      +
        +
      • Basic spellchecking via aspell (not available for Windows, OS/2 and eComStation).
        • +
      • New text variable: Number of pages.
        • +
      • Undo/Redo is finally available for text-related actions.
        • +
      + +

      Vector Tools

      + +
        +
      • New default shapes.
        • +
      • New Path Tools, like Boolean path operations, lens effects or mesh distortion.
        • +
      • More options for text on path.
        • +
      +
      + + + + + + + + + +
      Boolean path operations
      Boolean path operations
      +
      + +

      Lines

      +
        +
      • New line styles.
        • +
      • Line style editor.
        • +
      + + +

      Solid Colors, Gradients and Patterns

      +
        +
      • Major improvements to the Color Wheel (support for multiple color models).
        • +
      • An option to replace solid colors throughout the whole document.
        • +
      • Support for external color palette formats (EPS, AI, PS, SOC, GPL).
        • +
      • Locking of standardized color palettes.
        • +
      • Many new color palettes, among them the national standard color sets of Australia, France, Japan, the United Kingdom and the United States, as well as Resene® color and dtp studio collections.
        • +
      • New gradient types.
        • +
      • Support for pattern fills: All graphics formats supported by Scribus can be used as patterns.
        • +
      • Emulation of color blindness for all colors in a document.
        • +
      +
      + + + + + + + + + +
      Replacing solid colors
      Replacing solid colors
      +
      + +

      Transparency

      +
        +
      • Blending modes as known from Photoshop or GIMP are now available for all objects in a Scribus document and can also be applied to layers.
        • +
      + +

      Render Frames

      +
        +
      • One of the major new features is the introduction of Render Frames, a special frame type that allows for rendering the output of programs like LaTeX, Lilypond or POV-Ray inside Scribus.
      +
      + + + + + + + + + +
      Render Frame Editor
      Render Frame Editor
      +
      + +

      Import Filters

      +
        +
      • A considerable amount of work has been spent on new import filters for vector formats, most notably Adobe Illustrator (AI). Scribus can now import both EPS and PDF based AI files. Other filters are: Windows Metafile (WMF), Xfig (FIG), Calamus Vector Graphics (CVG), Macintosh PICT (PICT), Kivio Stencils (SML) and Dia Shapes (SHAPE).
      + +
      + + + + + + + + + +
      Adobe Illustrator import
      Adobe Illustrator import
      +
      + +

      Image Handling

      +
        +
      • New non-destructive image effects.
        • +
      • Better handling of PSD-specific features, like clipping paths and layers.
        • +
      • Major improvements to the image manager.
        • +
      +
      + + + + + + + + + +
      The new image manager
      The new image manager
      +
      + +

      Layers

      +
        +
      • Scribus layers can now be exported as PDF layers (PDF 1.5 only).
        • +
      • Duplicate Layers feature.
        • +
      • Wireframe mode for layers to speed up performance.
        • +
      • Enforceable text flow around objects on a lower layer.
        • +
      + +

      Pre-press

      +
        +
      • Enhancements to the Print Preview, like indication of ink coverage.
        • +
      • Improvements to the Preflight Verifier.
        • +
      • New pre-press features, like bleed and printing marks.
        • +
      • Optional conversion of spot colors to process colors.
        • +
      + +

      PDF Export

      +
        +
      • Support for PDF 1.5 features, e.g. slide effects for PDF presentations or PDF layers.
        • +
      • Optional embedding of EPS and PDF files in PDF documents.
        • +
      • Better font subsetting.
        • +
      + +

      Usability

      +

      Much work has been spent on major and minor usability improvements throughout the whole program, e.g.:

      +
        +
      • A search feature for the Document Outline.
        • +
      • Many more viewing options, including a document preview without guides and frame borders.
        • +
      • One-click activation of color management.
        • +
      • Context menu for the document canvas with options to insert vector graphics directly or to activate viewing options
        • +
      • Many more options to automate and speed up the insertion of frames (e.g. Insert Frame dialog, “Sticky Tools” option).
        • +
      • Enhancements to the Scrapbook.
        • +
      + +

      Templates

      +
        +
      • Many templates, donated by artists, have been added.
        • +
      • We have finally begun to translate the template categories and template descriptions into other languages.
        • +
      + +

      Help System

      +
        +
      • The content of the Online Help system has almost doubled since the relase of the latest stable version 1.3.3.14. Moreover, major parts of the existing documentation have been updated or completely rewritten to reflect the feature set of Scribus 1.4+.
        • +
      • Many new tooltips have been added, and existing ones have been expanded.
        • +
      • Online help resources are now accessible from the Help menu.
        • +
      +
      +
      + + diff --git a/scribus/doc/it/releases.html b/scribus/doc/it/releases.html new file mode 100644 index 0000000..da9b7a3 --- /dev/null +++ b/scribus/doc/it/releases.html @@ -0,0 +1,51 @@ + + + +Release History + + +

      Release History

      +
        +
      • 27/10/2010 - Scribus 1.3.9 (devel)
        • +
      • 23/07/2010 - Scribus 1.3.8 (devel)
        • +
      • 05/06/2010 - Scribus 1.3.7 (devel)
        • +
      • 22/03/2010 - Scribus 1.3.6 (devel)
        • +
      • 12/02/2010 - Scribus 1.3.3.14
        • +
      • 28/05/2009 - Scribus 1.3.5 (devel)
        • +
      • 15/04/2008 - Scribus 1.3.3.13
        • +
      • 12/06/2008 - Scribus 1.3.3.12
        • +
      • 12/01/2008 - Scribus 1.3.3.11
        • +
      • 08/01/2008 - Scribus 1.3.3.10
        • +
      • 28/05/2007 - Scribus 1.3.4 (devel)
        • +
      • 05/05/2007 - Scribus 1.3.3.9
        • +
      • 23/02/2007 - Scribus 1.3.3.8
        • +
      • 09/01/2007 - Scribus 1.3.3.7 (added OS/2 Port)
        • +
      • 04/12/2006 - Scribus 1.3.3.6
        • +
      • 09/11/2006 - Scribus 1.3.3.5
        • +
      • 03/10/2006 - Scribus 1.3.3.4
        • +
      • 07/08/2006 - Scribus 1.3.3.3
        • +
      • 14/07/2006 - Scribus 1.2.5
        • +
      • 29/05/2006 - Scribus 1.3.3.2 (devel)
        • +
      • 10/04/2006 - Scribus 1.3.3.1 (devel)
        • +
      • 27/01/2006 - Scribus 1.3.3 (devel)
        • +
      • 22/01/2006 - Scribus 1.3.2 (devel) (added Win32 port)
        • +
      • 05/01/2006 - Scribus 1.2.4.1
        • +
      • 03/10/2005 - Scribus 1.3.1 (devel)
        • +
      • 12/09/2005 - Scribus 1.2.3
        • +
      • 14/07/2005 - Scribus 1.3.0 (added Mac OSX port)
        • +
      • 05/07/2005 - Scribus 1.2.2.1
        • +
      • 08/01/2005 - Scribus 1.2.1
        • +
      • 28/08/2004 - Scribus 1.2
        • +
      • 06/06/2004 - Scribus 1.1.7
        • +
      • 28/03/2004 - Scribus 1.1.6
        • +
      • 14/02/2004 - Scribus 1.1.5
        • +
      • 18/12/2003 - Scribus 1.1.4
        • +
      • 28/11/2003 - Scribus 1.1.3
        • +
      • 28/10/2003 - Scribus 1.1.2
        • +
      • 03/10/2003 - Scribus 1.1.1
        • +
      • 06/09/2003 - Scribus 1.1.0
        • +
      • 07/08/2003 - Scribus 1.0.1
        • +
      • 21/06/2003 - Scribus 1.0
        • + + + \ No newline at end of file diff --git a/scribus/doc/it/scribuscopyright.html b/scribus/doc/it/scribuscopyright.html new file mode 100644 index 0000000..40d6194 --- /dev/null +++ b/scribus/doc/it/scribuscopyright.html @@ -0,0 +1,33 @@ + + + + Scribus Copyright + + +

        Scribus Copyright

        +

        ©2001–2011 Franz Schmid and rest of the members of the Scribus Team.

        +

        The “Scribus Team” is informally defined as the following people: Franz Schmid, Peter Linnell, Craig Bradney, Jean Ghali, Hermann Kraus, Riku Leino, Oleksandr Moskalenko, Christoph Schäfer, Petr Vaněk, Andreas Vox, and Jain Basil.

        +

        Other contributors are listed in the “Authors” tab of the dialog Help > About Scribus.

        + +

        This program is Free Software; you can redistribute it and/or modify it under the terms of the GNU General Public License (GPL) as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

        + +

        This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

        + +

        You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

        + +

        Parts of the code are distributed under one of the following licenses: +

          +
        • GNU Library/Lesser Public License (LGPL), version 2 or version 2.1
          • +
        • 3-clause BSD License
          • +
        • MIT License
          • +
        • Some parts of the code are distributed under a dual licensing scheme. See the respective source files for further information.
          • +
        • Other parts of the code are in the Public Domain.
          • +

        + +
        Some third party files in the source code don’t include proper copyright notices, but the Scribus developers have been told by their authors that the license is compatible to the GPL version (e.g. LGPL v. 2 or MIT license). This doesn’t mean that you are allowed to copy or modify the code without obligations. It only means that the original authors forgot to add these notices. Without providing legal advice, we suggest that you contact the authors of the code who are mentioned in other files in the same directory and ask for permission or to update the files with appropriate licensing information.
        + +

        Antiword, which is shipped with the Windows version of Scribus, is a separately licensed program under the GPL, and the copyright license is included with the program.

        + +

        Resources, like the documentation, dictionary files, color profiles, color palettes, or templates, use their own licenses that need not be compatible with any of the licenses mentioned above, because resources are considered to be content, not functional code.
        Note that some of these files, especially some color palettes, are subject to very strict licensing conditions.

        + + \ No newline at end of file diff --git a/scribus/doc/it/scribusfileformat.html b/scribus/doc/it/scribusfileformat.html new file mode 100644 index 0000000..0be2a97 --- /dev/null +++ b/scribus/doc/it/scribusfileformat.html @@ -0,0 +1,2987 @@ + + + + File Format Specification for Scribus 1.2 + + +

        File Format Specification for Scribus 1.2

        +

        This specifcation is based on the current format used by Scribus 1.2. +

        It lists all Tags and Attributes, some of these are optional, depending on type of the Document. Optional Tags and Attributes are marked with a slight blue background, Scribus will insert a default value when one of these are missing.

        + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
        TagsAttributesMeaning
        SCRIBUSUTF8VersionVersion Number for
        Debugging
        DOCUMENTABSTSPALTENDistance between Columns in
        automatic Textframes
        ALAYERActive Layer
        ANZPAGESNumber of Pages
        AUTHORAuthor of the Doc
        AUTOCHECKAutomatic Hyphenation during typing
        0 = off, 1 = on
        AUTOMATICAutomatic Hyphenation
        0 = off, 1 = on
        AUTOSPALTENNumber of Colums in automatic
        Textframes
        BASEGRIDWidth of the Baseline Grid
        BASEOStartoffset for the Baseline Grid
        BOOKDocument has facing Pages
        when this Attribute is present
        BORDERBOTTOMBottom Border of Doc
        BORDERLEFTLeft Border of Doc
        BORDERRIGHTRight Border of Doc
        BORDERTOPTop Border of Doc
        COMMENTSComments for the Doc
        DCOLNumber of Colums in Textframes
        DFONTDefault Font
        DGAPDefault Gap between Columns
        in Textframes
        DIMoDefault Rendering Intent for the Monitor
        + 0 = Perceptual
        1 = Relative Colorimetric
        + 2 = Saturation
        3 = Absolute Colorimetric
        DIMo2Default Rendering Intent for Images
        + 0 = Perceptual
        1 = Relative Colorimetric
        + 2 = Saturation
        3 = Absolute Colorimetric
        DIPrDefault Rendering Intent for the Printer
        + 0 = Perceptual
        1 = Relative Colorimetric
        + 2 = Saturation
        3 = Absolute Colorimetric
        DOCCONTRIBPerson or organization making contributions to the document
        DOCCOVERExtent of scope of the document
        DOCDATEDate related to life-cycle of the document, YYYY-MM-DD
        DOCFORMATPhysical or digital manifestation of the document
        DOCIDENTAn unambigious reference to the document, eg ISBN
        DOCLANGINFOLanguage of content of document
        DOCRELATIONReference to a related document
        DOCRIGHTSInformation about rights held in and over the document, eg copyright
        DOCSOURCEReference to a document from which this document is derived
        DOCTYPENature or genre of the content of the document
        DpblaUse Blackpoint Compensation
        0 = off, 1 = on
        DpgamMark Colors out of Gamut
        0 = off, 1 = on
        DPInDefault ICC-Profile for solid Colors
        DPIn2Default ICC-Profile for Images
        DPMoDefault ICC-Profile for the Monitor
        DPPrDefault ICC-Profile for the Printer
        DPSoSimulate the Printer on Screen
        0 = off, 1 = on
        DpuseUse Colormanagement
        0 = off, 1 = on
        DSIZEDefault Fontsize
        FIRSTLEFTFirst page is a left page when this
        attribute is present
        FIRSTNUMFirst Pagenumber in the Doc
        GROUPCCounter for Groups in the Doc
        GUIDELOCKGuides locked
        0 = off, 1 = on
        HCMSColormanagement available
        0 = off, 1 = on
        HYCOUNTNumber of Hyphens allowed following each other
        KEYWORDSKeywords for the Doc
        LANGUAGELanguage of the Doc
        MAJGRIDDistance of the major Gridlines
        MINGRIDDistance of the minor Gridlines
        MINWORDLENMinimum length of a Word to be hyphenated
        ORIENTATIONOrientation of the Doc
        0 = Portrait
        1 = Landscape
        PAGEHEIGHTHeight of the Doc
        PAGEWITHWidth of the Doc
        PUBLISHER + Person or organization responsible for making the document available +
        TITLETitle of the Doc
        UNITSMeasurement unit for the Doc
        0 = Points
        1 = Millimeters
        2 = Inches
        3 = Picas
        VHOCHPercentage for Superscript
        VHOCHSCPercentage for scaling of the Glyphs in Superscript
        VKAPITPercentage for scaling of the Glyphs in Small Caps
        VTIEFPercentage for Subscript
        VTIEFSCPercentage for scaling of the Glyphs in Subscript
        MultiLineNameName of the Linestyle
        SubLineColorName of the colour of that Line
        DashHow the line is dashed
        1 = Solid Line
        2 = Dashed Line
        + 3 = Dotted Line
        4 = Dash Dot Line
        5 = Dash Dot Dot Line
        LineEndCode for the line end rendering
        0 = FlatCap
        16 = SquareCap
        32 = RoundCap
        LineJoinCode for the line join rendering
        0 = MiterJoin
        64 = BevelJoin
        128 = RoundJoin
        ShadeShading of the line colour in percent
        WidthLinewidth in points
        JAVANAMEName of the Script
        SCRIPTThe JavaScript itself
        BookmarkAktionAction for this Bookmark
        ElementNumber of the Scribus Object
        FirstNumber of first Bookmark at this Level
        ItemNrInternal Number of this Bookmark
        LastNumber of last Bookmark at this Level
        NextNumber of next Bookmark at this Level
        ParentNumber of this Bookmarks Parent
        PrevNumber of previous Bookmark at this Level
        SeitePage on which this Bookmark is located
        TextInternal Text of that Bookmark
        TitleString which is exported to PDF
        COLORCMYKValue as hexadecimal String
        NAMEName of the Colour
        RGBValue as hexadecimal String
        STYLEALIGNCode for the alignment of text.
        0 = Align Text Left
        1 = Align Text Centered
        2 = Align Text Right
        + 3 = Align Text Justified
        4 = Align Text Forced Justified
        BASEFlag for adjusting to the Baseline Grid
        0 = no adjusting, 1 = adjusting
        DROPFlag for DropCaps
        1 = DropCaps on
        DROPLINNumber of Lines for the DropCaps
        EFFECTCharacter Style for the Text
        1 = Superscript
        2 = Subscript
        4 = Outline Text
        + 8 = Underline
        16 = Strike Out
        64 = Small Caps
        FCOLORName of the fill colour
        FIRSTIndent of the first Line
        FONTName of the Font
        FONTSIZEFontsize
        FSHADEShade of the fill colour in percent
        INDENTIndent for all Lines
        LINESPLinespacing
        NACHSpacing after the paragraph
        NAMEName of the style
        NUMTABNumber of Tabs
        SCOLORName of the stroke colour
        SSHADEShade of the stroke colour in percent
        TABSList of defined Tabs, Tabcode and Position
        Tabcodes:
        0 = Left
        1 = Right
        + 2 = Full Stop
        3 = Comma
        4 = Center
        VORSpacing before the paragraph
        LAYERSDRUCKENFlag for printing
        0 = Layer is not printed
        1 = Layer is printed
        LEVELLevel of the Layer
        0 = Background
        NAMEName of the layer
        NUMMERNumber of the layer
        SICHTBARFlag for visibility
        0 = Layer is not visible
        1 = Layer is visible
        PDFArticlesFlag, set to 1 when use PDF-Articles is
        checked in the PDF-Options Dialog
        BBottomBottom Distance for the Bleed Box
        BindingBinding for the PDF-Document
        0 = Left Binding
        1 = Right Binding
        BLeftLeft Distance for the Bleed Box
        BookmarksFlag, set to 1 when include Bookmarks is
        checked in the PDF-Options Dialog
        BRightRight Distance for the Bleed Box
        BTopTop Distance for the Bleed Box
        CMethodCompression Method for Pictures
        0 = Automatic, Scribus tries to use the best Method
        1 = JPEG Compression
        + 2 = Flate Compression
        3 = No Compression
        CompressFlag, set to 1 when use Compress Text is
        checked in the PDF-Options Dialog
        EncryptFlag, set to 1 when use Encryption is
        checked in the PDF-Options Dialog
        ImagePICC-Profile for Images
        ImagePrFlag, set to 1 when embedded ICC-Proflies should not be used for images
        InfoStringInfo String for PDF-X/3 Output
        IntentRendering Intent for solid colours
        0 = Perceptual
        1 = Relative Colorimetric
        + 2 = Saturation
        3 = Absolute Colorimetric
        Intent2Rendering Intent for Images
        0 = Perceptual
        1 = Relative Colorimetric
        + 2 = Saturation
        3 = Absolute Colorimetric
        PassOwnerOwner Password for encrypted PDF's
        PassUserUser Password for encrypted PDF's
        PermissionsValue used for Encryption Settings
        PicResResolution for downsampling Images
        PresentModeFlag, set to 1 when Presentation effects should be used
        PrintPICC-Profile for the Printer, only used for PDF-X/3 output
        QualityQuality setting for Image Compression
        0 = Maximum (95%)
        1 = High (85%)
        + 2 = Medium (75%)
        3 = Low (50%)
        4 = Minimum (25%)
        RecalcPicFlag, set to 1 when Downsample Images is
        checked in the PDF-Options Dialog
        ResolutionResolution for embedded EPS-Pictures or PDF's
        RGBModeFlag, set to 1 when Output should be in RGB
        SolidPICC-Profile for solid colours
        ThumbnailsFlag, set to 1 when Generate Thumbnails is
        checked in the PDF-Options Dialog
        UseLpiFlag, set to 1 when the informations in the LPI tags should be used for Linescreening
        UseProfilesFlag, set to 1 when ICC-Profiles should be used for solid colours
        UseProfiles2Flag, set to 1 when ICC-Profiles should be used for images
        VersionPDF-Version which should be generated
        12 = PDF-X/3
        13 = PDF-1.3
        14 = PDF-1.4
        EffekteAnzeigeLenTime how long the page is shown in Full Screen Mode in seconds
        DiDirection of the Effect for Wipe and Glitter
        0 = Left to right
        1 = Top to bottom
        + 2 = Bottom to top
        3 = Right to left
        4 = Top-left to bottom-right
        DmDirection of the Effect for Split and Blinds
        0 = horizontal
        1 = vertical
        EffektType of Effect
        0 = No Effect
        1 = Blinds
        2 = Box
        3 = Dissolve
        + 4 = Glitter
        5 = Split
        6 = Wipe
        EffektLenTime how long the effect is shown in Full Screen Mode in seconds
        MDirection of the motion for Split and Box
        0 = towards inside
        1 = towards outside
        LPIAngleLinescreening angle
        ColorName of the Colour for which these settings are ment
        FrequencyHow many lines per Inch are used
        SpotFunctionCode for the used Spotfunction:
        0 = Simple Dot
        1 = Line
        + 2 = Round
        3 = Ellipse
        FontsNameName of the Font to be embedded into the PDF
        PAGEHorizontalGuidesList of horizontal Guidelines
        LEFTIs 1 if this page is a left Masterpage
        MNAMName of the attached Masterpage,
        empty when this page is a Masterpage
        NAMName of the Masterpage, empty
        when this page is a normal page
        NUMNumber of the page, counting starts with 0
        NumHGuidesNumber of horizontal Guidelines
        NumVGuidesNumber of vertical Guidelines
        VerticalGuidesList of vertical Guidelines
        PAGEOBJECTALIGNAlignment for text when no paragraph style is set
        0 = No Style, left aligned
        1 = Align Text Center
        + 2 = Align Text Right
        3 = Align Text Justified
        4 = Align Text Forced Justified
        ANAASet to 1 if Annotations Action is a JavaScript Action
        ANACTIONAction for the PDF-Field, contains either a URL or a JavaScript
        ANACTYPType of the Action for a PDF-Field
        0 = None
        1 = Java Script
        2 = Go To
        + 3 = Submit Form
        4 = Reset Form
        5 = Import Data
        ANBCOLName of the border colour of the PDF-Button
        ANBLACTJavaScript executed when the PDF-Field looses focus
        ANBSTYBorderstyle for a PDF-Button
        0 = Solid
        1 = Dashed
        2 = Underline
        + 3 = Beveled
        4 = Inset
        ANBWIDBorderwidth of a PDF-Button
        0 = None
        1 = Thin
        2 = Normal
        3 = Wide
        ANCACTJavaScript executed when the PDF-Page is changed
        ANCHKSet to 1 if the PDF-Checkbox is checked by default
        ANCHKSStyle of the checkmark in a PDF-Checkbox
        0 = Check
        1 = Cross
        2 = Diamond
        + 3 = Circle
        4 = Star
        5 = Square
        ANDACTJavaScript executed when the mouse button is pressed
        ANDOWNText for Button Down of a PDF-Button
        ANEACTJavaScript executed when the cursor enters the PDF-Field
        ANEXTERNPath or URL for an external PDF-Link
        ANFACTJavaScript executed before formatting the PFD-Field
        ANFEEDFeedback for PDF-Button press
        0 = None
        1 = Invert
        2 = Outlined
        + 3 = Push animation
        ANFLAGFlags for Annotations, value is the bitwise or of the following constants
        + 1 = Field is read-only
        2 = Field must have a value
        4 = Value is not exported
        + 4096 = Field is a multiline Textfield
        8192 = Field is a password field
        + 262144 = Field is editable
        4194304 = Don't spell check
        8388608 = Do not scroll
        ANFOACTJavaScript executed when the field receives focus
        ANFONTFont for the PDF-Button or Annotation
        0 = Courier
        1 = Courier Bold
        + 2 = Courier Italic
        3 = Courier Bold Italic
        4 = Helvetica
        5 = Helvetica Bold
        + 6 = Helvetica Italic
        7 = Helvetica Bold Italic
        8 = Times
        9 = Times Bold
        + 10 = Times Italic
        11 = Times Bold Italic
        12 = Zapf Dingbats
        13 = Symbols
        ANFORMATFormat of the Value in a PDF-Field
        0 = Plain text
        1 = Number
        + 2 = Percentage
        3 = Date
        4 = Time
        5 = Custom format
        ANHTMLSet to 1 if the PDF-Submit Action should send HTML instead of FDF
        ANICONSet to 1 if the PDF-Button uses icons
        ANKACTJavaScript for keypresses
        ANMCMaximum number of characters in a PDF-Textfield
        ANNAMEField name of the Annotation, also used for the object name
        ANNOTATIONSet to 1 if the object is a Annotation or a PDF-Field
        ANPLACEHow to display the Icon of a PDF-Button
        0 = Caption only
        1 = Icon only
        + 2 = Caption below Icon
        3 = Caption above Icon
        4 = Caption right to Icon
        + 5 = Caption left to Icon
        6 = Caption overlays Icon
        ANROLLText for roll over of PDF-Buttons
        ANSCALEScaling of Icons on PDF-Buttons
        0 = Always
        1 = When Icon is too small
        + 2 = When Icon is too big
        3 = Never
        ANTOOLTIPTooltip for the PDF-Field
        ANTYPEType of the Annotation or PDF-Field
        0 = Text annotation
        1 = Link annotation
        + 2 = PDF-Button
        3 = PDF-Textfield
        4 = PDF-Checkbox
        5 = PDF-Combobox
        + 6 = PDF-Listbox
        7 = External Link
        8 = External Weblink
        ANVACTJavaScript to be performed when the fields value has changed
        ANVISThe visiblity of the PDF-Field
        0 = visible
        1 = hidden
        2 = don't print
        3 = don't show, but print
        ANXACTJavaScript when the mouse pointer leaves the field
        ANZIELPage number of a PDF-Link
        AUTOTEXTSet to 1 if object is an automatic textframe
        BACKITEMNumber of the previous frame of linked textframe
        BACKPAGENumber of the page of the previous frame in linked textframes
        BASEOFOffset for the text from its path for text on a path
        BBOXHHeight of the bounding box, used only for EPS-Images
        BBOXXBounding box X-Value, used only for EPS-Images
        BEXTRADistance of text from the bottom edge of the frame
        BOOKMARKSet to 1 if object is a PDF-Bookmark
        BookNrNumber of the Bookmark
        BottomLineSet to 1 if the table item has a bottom line
        BottomLINKNumber of the object that is below of this object in tables
        CLIPEDITSet to 1 if the shape was edited
        COLGAPGap between text columns
        COLUMNSNumber of columns in text
        COCOORCoordinates of the objects contour line
        DASHOFFOffset for the first dash
        DASHSList of dash values, see the PostScript manual for details
        EMBEDDEDSet to 1 if embedded ICC-Profiles should be used
        EPROFEmbedded ICC-Profile for images
        EXTRADistance of text from the left edge of the frame
        EXTRAVKerning value
        FLIPPEDHSet to an uneven number if object is flipped horizontal
        FLIPPEDVSet to an uneven number if object is flipped vertical
        FRTYPEType of the shape of an object
        0 = Rectangle
        1 = Ellipse
        2 = Rounded rectangle
        + 3 = Free shape
        GRENDXX-Value of the end position of the gradient
        GRENDYY-Value of the end position of the gradient
        GROUPSList of group identifiers
        GRSTARTXX-Value of the start position of the gradient
        GRSTARTYY-Value of the start position of the gradient
        GRTYPType of the gradient fill
        0 = No gradient fill
        1 = Horizontal gradient
        + 2 = Vertical gradient
        3 = Diagonal gradient
        4 = Cross diagonal gradient
        + 5 = Radial gradient
        6 = Free linear gradient
        7 = Free radial gradient
        HEIGHTHeight of the object
        IFONTName of the font for text
        INVERSImage is inversed
        IRENDERRendering Intent for Images
        + 0 = Perceptual
        1 = Relative Colorimetric
        + 2 = Saturation
        3 = Absolute Colorimetric
        ISIZEFontsize for text
        isTableItemSet to 1 if the object belongs to a table
        LANGUAGELanguage of the object
        LAYERLayer number the object belongs to
        LeftLineSet to 1 if the table item has a left line
        LeftLINKNumber of the object that is left to this object in tables
        LINESPLinespacing for text
        LOCALSCXScaling of the image in the X-Direction
        LOCALSCYScaling of the image in the Y-Direction
        LOCALXX-Position of the image in the image frame
        LOCALYY-Position of the image in the image frame
        LOCKSet ot 1 if the object is locked
        LOCKRSet to 1 if the object is protected against resizing
        NAMEDLSTName of the custom line style
        NEXTITEMNumber of the next frame for linked textframes
        NEXTPAGENumber of the page of the next frame in linked textframes
        NUMCONumber of coordinates in COCOOR
        NUMDASHNumber of entries in DASH
        NUMGROUPNumber of grops in GROUPS
        NUMPONumber of coordinates in POCOOR
        NUMTABNumber of tabstops listed in TABS
        OwnLINKNumber of this object in tables
        PCOLORName of the colour for fll
        PCOLOR2Name of the colour for stroke
        PFILEFilename of the image
        PFILE2Filename of the pressed icon image for PDF-Buttons
        PFILE3Filename of the rollover icon image for PDF-Buttons
        PICARTSet to 1 if image should be shown
        PLINEARTHow the line is dashed
        1 = Solid Line
        2 = Dashed Line
        + 3 = Dotted Line
        4 = Dash Dot Line
        5 = Dash Dot Dot Line
        PLINEENDCode for the line end rendering
        0 = FlatCap
        16 = SquareCap
        32 = RoundCap
        PLINEJOINCode for the line join rendering
        0 = MiterJoin
        64 = BevelJoin
        128 = RoundJoin
        PLTSHOWSet to 1 if the path of a Text on a path should be shown
        POCOORCoordinates of the object shape
        PRFILEICC-Profile for the image
        PRINTABLESet to 1 if the object should be printed, 0 otherwise
        PTYPEType of object
        2 = Image
        4 = Text
        5 = Line
        6 = Polygon
        7 = Polyline
        8 = Text on a path
        PWIDTHLine width of the object
        RADRECTCorner radius for rounded Rectangles
        RATIOSet to 1 if the image scaling should respect the aspect ratio
        REVERSText is rendered reverse, eg Arabic
        REXTRADistance of text from the right edge of the frame
        RightLineSet to 1 if the table item has a right line
        RightLINKNumber of the object that is to the right of this object in tables
        ROTRotation of the object in degrees
        SCALETYPEHow the image can be scaled
        0 = Free scaling
        1 = Scaling bound to image frame dimensions
        SHADEShading for fill
        SHADE2Shading for stroke
        TABSList of defined Tabs, Tabcode and Position
        Tabcodes:
        0 = Left
        1 = Right
        + 2 = Full Stop
        3 = Comma
        4 = Center
        TEXTFLOWSet to 1 if text flows around this object
        TEXTFLOW2Set to 1 if text flows around the bounding box of this object
        TEXTFLOW3Set to 1 if text flows around the contour line of this object
        TEXTRADistance of text from the top edge of the frame
        TopLineSet to 1 if the table item has a top line
        TopLINKNumber of the object that is above this object in tables
        TransValueTransparency value for fill
        TransValueSTransparency value for stroke
        TXTFILLName of the default text fill colour
        TXTFILLSHDefault shading for the text fill colour
        TXTSCALEDefault text scaling
        TXTSTROKEName of the default colour for stroking text
        TXTSTRSHDefault shading for stroking text
        TXTSTYLEDefault character style, value is the bitwise or of these constants:
        + 1 = Superscript
        2 = Subscript
        4 = Outlined
        8 = Underlined
        + 16 = Strikeout
        64 = Small Caps
        WIDTHWidth of the Object
        XPOSX-Positon of the Object
        YPOSY-Position of the Object
        CSTOPNAMEName of the stop colour
        RAMPPosition of the colour stop,
        range from 0.0 till 1.0
        SHADEShading of the stop colour in Percent
        TRANSTransparency of the colour stop,
        range from 0.0 till 1.0
        ITEXTCABParagraph style for the character
        0 = No Style, left aligned
        1 = Align Text Center
        + 2 = Align Text Right
        3 = Align Text Justified
        4 = Align Text Forced Justified
        + higher values indicate a custom paragraph style
        CCOLORName of the fill colour
        CEXTRAValue for Kerning
        CFONTName of the Font
        CHThe character(s) itself
        CSCALEScaling in percent
        CSHADEShading of the fill colour
        CSHADE2Shading of the stroke colour
        CSIZEFontsize in points
        CSTROKEName of the stroke colour
        CSTYLEThe style of the character, value is the bitwise or of these constants:
        + 1 = Superscript
        2 = Subscript
        4 = Outlined
        8 = Underlined
        + 16 = Strikeout
        64 = Small Caps
        128 = Word can be hyphenated here
        + + diff --git a/scribus/doc/it/scripter-extensions.html b/scribus/doc/it/scripter-extensions.html new file mode 100644 index 0000000..755182d --- /dev/null +++ b/scribus/doc/it/scripter-extensions.html @@ -0,0 +1,360 @@ + + + Scripter: Extension Scripts + + + + + +

        Scripter: Extension Scripts

        + +

        Author: Craig Ringer

        + +

        The Scribus Python plugin offers some additional features for +extending Scribus with new capabilities and features, as opposed +to automating tasks. In particular, it is possible to use 'extension scripts' +to create new palettes and dockable windoes that can be used just like +they were a part of Scribus.

        + +

        Extension scripts

        + +

        Extension scripts are mostly like normal Python scripts for Scribus. +They're written somewhat differently so that they can be run with the +"extension script" feature, giving them access to PyQt support and +some other special features of the scripter. The most fundamental +differences between normal scripts and extensions scripts are that: +

        + +
          + +
        • Extension scripts can create Python objects that continue to exist + after the script exits. Objects will only continue to exist if a reference + to them still exists, most commonly because there's a name in the global + namespace that refers to them. This means that Python functions can be + called by Scribus - for example, as PyQt slots, or as callback functions on + an event.
          • + +
        • Extension scripts can create code that runs without blocking the + execution of scribus, so you can create floating palettes that can be + present while the user works normally with Scribus (ie non-modal + palettes).
          • + +
        • PyQt works correctly in extension scripts, unlike normal scipts.
          • + +
        • Extension scripts can make changes to the Python environment that will + affect scripts run after it. Modules imported by one script can be seen by + another, settings changed by one may stay changed, etc. This means you have + to be somewhat more careful when writing extension scripts. In particular, + global names bound by one extension script can be overwritten by another, + causing the objects associated with those names to be cleaned up by the + interpreter. In other words, you can have name conflicts and interactions + between scripts, which you can't with normal scripts.
          • + +
        + +

        The technical bit

        + +

        Normal scripts get run in a new Python sub-interepter that's used just for +that script then cleaned up. This means that whatever Python objects they +create and whatever Python settings they change get automatically reset when +the script exits. Because Scribus takes care of cleaning up your script, you +don't have to worry about memory, conflicting with other scripts, etc and can +just get on with the business of writing the script.

        + +

        Extension scripts, by contrast, are run in a single Python interpreter that +is started up when the script plugin loads. This interpreter keeps on running +until the script plugin is unloaded when Scribus quits. When Scribus runs an +extension script, it loads it into the running interpreter - much like +execfile loads a Python script in another Python script. This lets +extension scripts create new objects as they run, then exit to return control +to Scribus without having the objects they created destroyed. If another script +is then run, it can see all the objects created by the first script.

        + +

        There are several situations where being able to create objects from Python +that hang around after the script exits is useful. The most signficiant is +graphical programming with PyQt, where PyQt objects are created when the script +runs and become functional only after the script exits, returning control to +the Scribus event loop. Another possible use is for macros, event callbacks, +and timers, where Scribus would need to be able to call Python code. You can +do all these with PyQt right now, but there is no direct support for timers +and callbacks in Scribus yet.

        + +

        There are some downsides to having objects persist after the script exits. +Scripts can potentially interact in ways not thought of by their authors, which +is often good but can also cause unexpected and surprising bugs. Script authors +must also consider the effect of their code on the memory consumption of +Scribus.

        + +

        Building graphical add-ons in Python

        + +

        Building new palettes and dialogs in PyQt is a fairly easy way to +extend Scribus's user interface and provide extra facilities for +advanced scripts. Python is well suited to getting data into and out of +databases, content management systems, and other external repositories, +and being able to build your own interfaces for this can be very +helpful.

        + +

        In most ways, PyQt works the same when running within Scribus as it +does when used in a stand-alone Python interpreter. There are +differences, however, and it is important to understand these.

        + +
          + +
        • An instance of QApplication already exists, and attempting + to create one will have undesired consequences. You can access the existing + QApplication instance as qt.qApp if you need + it.
          • + +
        • Scribus runs the Qt event loop. Entering the Qt event loop in PyQt will + probably prevent further execution of Scribus until your code exists, and + may have other undesired behaviour. The following documentation will cover + the correct approach to integrating your code into the event loop. In + brief, however, you simply create all your instances, show your windows, + and let your script exit. Qt will automatically integrate your windows into + its event loop and everything will "just work" - even Python slots and + Python widgets. In general, anything you want to keep around should be put + in the global namespace (as explained above).
          • + +
        + +

        The Basics - Converting Hello World

        + +

        The first PyQt tutorial is the classic Hello World application. As +an example of the differences between PyQt and Scribus, we'll convert +that program to run in Scribus. Here's the original:

        + +
        +#!/usr/bin/env python
+import sys
+import qt
+
+a = qt.QApplication(sys.argv)
+
+hello = qt.QPushButton("Hello world!", None)
+hello.resize(100, 30)
+
+a.setMainWidget(hello)
+hello.show()
+sys.exit(a.exec_loop())
+
        + +

        First, we need to disable the creation of QApplication since in +Scribus a QApplication instance already exists, and only one is +allowed per application. PyQt provides us with access to the +QApplication that was created by Scribus when it starts up as +qt.qApp. So, we simply replace:

        + +
        +a = qt.QApplication(sys.argv)
+
        + +

        with

        + +
        +a = qt.qApp
+
        + +

        and we're done with that change.

        + +

        Next, we need to prevent the script from trying to run its own event +loop. Because Scribus has an event loop, if the script starts its own +it will disrupt Scribus until it exits. Qt is smart enough to hook any +windows you create into the existing event loop, so there's not much to +do. While your script is running, Scribus is under the control of +Python, so what we need to do is do all our setup (in this case, create +a simple window and show it) but then let our script exit +instead of running the event loop. Because all extension scripts run in +the same Python interpreter, the objects you create are not destroyed +when your script exits. It's a bit like loading a module. When your +script exists, Scribus takes control and resumes running the Qt event +loop. Because your windows are Qt widgets, the Scribus event loop looks +after them and they work like a normal part of Scribus. When a Python +slot is triggered or a Python function is called, PyQt automatically +takes care of running the Python function then returning to Scribus.

        + +

        The only hitch with this scheme is that when your script terminates, all +objects you create inside a function or other local scope will be cleaned up by +Python as the scope is left (eg when leaving main()). This means that you need +to keep a reference to everything at the global level so that it's not cleaned +up. Support for PyQt in Scribus is very new, and there's no clear "right" way +to do this yet. Options +include:

        + +
          +
        • Creating everything you want to keep in the global namespace. Caution + is required if your script is run multiple times.
          • + +
        • Storing objects you wish to keep in a dictionary or class in the global + namespace. Most of the same problems exist with this as with storing the + objects directly as global names.
          • + +
        • Putting your script in a module, then having the script the user runs + simply import the module and run a function in it. This looks like it'll be + the favoured approach. Note that the module body is not reloaded with every + import, so you should generally put any code you want run each time in a + function inside the module instead of the module top level. Alternately, you + could check if the module is already loaded and reload() it instead of + importing it anew.
          • +
        + +

        For now, because this script already creates everything as a global +we're going to do things that way. Larger scripts should be written as +modules.

        + +

        Given that the objects we need will already hang around when the +script exits, all we need to do is prevent the script from entering the +event loop. That's easy - just comment out the last line:

        + +
        +# sys.exit(a.exec_loop())
+
        + +

        and we're nearly done. The script will run now, but when you +close it it'll have a rather unintended effect - it'll close down +Scribus. That's probably not what you want. This happens because a Qt +application normally exits when its main widget ('main window') is +closed. We call qt.setMainWidget(...) to make our new window the +main widget, so when it's closed, Scribus goes with it. To prevent this, just +comment out qt.setMainWidget.

        + +

        The new script looks like:

        + +
        +#!/usr/bin/env python
+import sys
+import qt
+
+a = qt.qApp
+
+hello = qt.QPushButton("Hello world!", None)
+hello.resize(100, 30)
+
+#a.setMainWidget(hello)
+hello.show()
+#sys.exit(a.exec_loop())
+
        + +

        You'll find that script already saved as pyqt_tut1.py in the +scripter examples directory. Try running it as an extension script. You should +get a hello world button. Notice that you can keep working in Scribus as normal +while it's there, and that when you close the hello world window it politely +goes away without affecting Scribus.

        + +

        If you have a look at the sample copy of this tutorial script, +you'll notice it has a few small additions. They are accompanied +by some explanatory comments, so they won't be explored more here.

        + +

        Fun with global names and shared interpreters

        + +

        You may remember that I mentioned 'issues' with storing objects you +want to keep as globals earlier? Unsurprisingly, I was dodging +something I didn't want to have to explain right away.

        + +

        Storing objects as global names works fine ... until the user runs +your script again, or runs another script that uses the same names. +Python uses reference counting - an object continues to exist while one +or more names refer to it. When the global name you created earlier is +overwritten by another script or by another run of your script, there +are no more references to that object (which might be a window the user +is still using). Python does its job and helpfully deletes it for you - +it doesn't know it might still be being displayed, or might be a slot +that one of your windows is using. In many cases this will simply result +in a window unexpectedly vanishing, but it can have nastier consequences +too.

        + +

        Try this now. Run the hello world script (using "Load Extension +Script...") and without closing the "Hello world" window, run the +script again. The original window should vanish and be replaced with +the new one.

        + +

        There aren't really any good solutions to this yet, and the right +behavour depends on what exactly you want to do. I'd like to have some +clearer recommendations to give, but for that I need use cases. If +you're running into this issue, please post a description of your +project on the Scribus mailing list and I or someone else will try to +give you a few suggestions.

        + +

        The best solution so far is to use a simple wrapper script to run +your script and put your real script in a module. The wrapper script +imports your module then runs a function from the module to show the +windows. Since the module is only run the first time it's imported, the +window(s) will be displayed if they're not already visible, but won't +be disrupted if they are still visible. You can reload() the module +if you really want to re-run it, possibly after running some +cleanup code.

        + +

        Better suggestions would be much appreciated. Feel free to post questions +and ideas on the mailing list.

        + +

        Other tricks

        + +

        Even if you're not building a custom graphical user interface, it's +possible to make use of extension scripts. For example, you can use +PyQt to run a function on a timer. One use might be to check for +updates to an article in a database and perhaps ask the user if they +wish to update their document with the new text (or see the +differences). You can find a very simple exmaple of setting up a timer +with PyQt in the examples directory, called pyqt_timer.py.

        + +

        Another idea, as suggested by someone on the mailing list, was to +write an XML-RPC server to expose the scripter API to external +programs. This should be possible by using the PyQt classes for +networking and event handling.

        + +

        Other sources of information

        + +

        This document isn't a PyQt or Qt tutorial. Good sources of information on Qt and PyQt are: + +

        + +

        Cleanly handling being run outside Scribus

        + +
        +try:
+    import scribus
+except ImportError:
+    print "This script can only be run as an extension script from Scribus"
+    sys.exit(1)
+
        + +

        This tries to load the Scribus scripter interface, and if it fails +assumes it is not running under Scribus and complains. It's a good idea +to do this in all your scripts so that you don't confuse users who try +to run them with the standalone Python interpreter. Try running the +script with python pyqt_tut1.py and note how it tells the user why +it won't work then exits. This is much nicer than an import error or bizarre +behaviour.

        + +

        Unanswered questions and missing features

        + +

        Support for extending Scribus from Python is still very much a work +in progress. Lots works fine, but there are lots of unexplored corners. +Feedback, suggestions, requests, ideas and offers of help would be much +appreciated and can be directed to the mailing list or to the author(s) +of this document.

        + +

        Note that in particular there is no support for: +

          +
        • Using PyQt from normal scripts (as opposed to extension scripts)
          • +
        • Using PyGtk or wxPython
          • +
        • Threading (PyQt threads might work within the limits of Qt's threading support)
          • +
        • Hooking into the right-click menu (yet!)
          • +
        • Triggering scripts on certain events (being considered)
          • +
        • Easily and reliably hooking into the menus
          • +
        • Extending Scribus dialogs
          • +
        • Using Scribus custom widgets and classes
          • +
        • Anything that requires you to hand over control to its event loop without returning (these will work, but block Scribus).
          • +
        + +

        Some of these are just not done yet, some are extremely difficult, and some +we don't know how to do at all or don't plan to attempt.

        + + + + diff --git a/scribus/doc/it/scripter-faq.html b/scribus/doc/it/scripter-faq.html new file mode 100644 index 0000000..5baff56 --- /dev/null +++ b/scribus/doc/it/scripter-faq.html @@ -0,0 +1,133 @@ + + + + Scripter FAQ + + +

        Scripter FAQ

        +

        Author: Craig Ringer

        + +
        +

        How do I use non-ASCII text in the scripter?

        +

        First, make sure to ensure that your script has a correct coding line. Your script should start with something like: +

        +    #!/usr/bin/env python
+    # -*- coding: latin-1 -*-
+
        +or +
        +    #!/usr/bin/env python
+    # -*- coding: utf-8 -*-
+
        +or +
        +    #!/usr/bin/env python
+    # -*- coding: ascii -*-
+
        +

        +

        Those lines must be the first two lines of your script. The coding must match the actual encoding of the file.

        + +

        To find out what the text encoding is in vim, type + :set fileencoding? +How to find out the text encoding will vary for other editors, it may match your locale. The file command is not a reliable way to determine the text encoding of a file.

        + +

        You can convert files between encodings with the 'iconv' utility, but you will rarely need to given that Python can handle almost any text encoding if told what it is in the coding line.

        + +

        A few scripter functions require strict ASCII text, and cannot accept unicode or latin-1 text. If you call one of those with non-ASCII text, you'll get an error like: + UnicodeDecodeError: 'ASCII' codec can't decode byte 0xc3 + in position 1: ordinal not in range(128) +which is admittedly less than helpful.

        + +

        There currently seems to be a bug with the u'' modifier for string literals in the script console. This problem has also been identified in the Python interactive interpreter on the command line. It does not affect script files. Until this is solved, use the unicode("mystring") constructor or just use plain strings (which can contain unicode text) from the script console.

        + + +

        What's a good structure to use for my scripts?

        +

        Start with 'boilerplate.py' in the samples directory. That script disables redraws (for speed) and has code to make sure they get turned back on, does some checking and reports a useful error if run outside of scribus, etc.

        + +

        Why Python?

        +

        It's well suited to application embedding, but still full-featured and powerful. It's also accessible to new users and well documented. Additionally, it has solid unicode text support.

        + +

        Python makes a good glue language to connect different programs and components together. For example, you may wish you make it possible to use your in-house story database with Scribus - in which case the Python interface is probably the simplest and quickest way to get you there.

        + +

        It's also somewhat easier to write tidy Python code that other people can read and understand. If somebody else's script doesn't quite do what you need, with Python you have more of a chance of modifying it so it does.

        + +

        There are issues with embedding Python in applications, so from the perspective of pure automation scripting a language like Qt Script for Applications or lua might be better suited. If you want to get beyond simple automation, Python seems to be the way to go.

        + +

        I want to provide a more complex GUI than is provided by the dialogs built into the scripting interface. How can I do that?

        + +

        For most scripting tasks, building a simple GUI in Tkinter is your best choices at present. If you're looking to extend the user interface or provide palettes the user can work with while they continue to work in Scribus, you'll need to look into writing an 'extension script' with PyQt. + +

        In most cases it's recommended to just choose Tkinter. It's the only GUI toolkit that works reliably in normal Scribus scripts due to the way they're executed in sub-interpreters. It's also almost universally packaged in Linux distributions, though not all install it by default. Tkinter is highly portable. Tkinter is also bundled with the Windows installer for Scribus, along with being included with the python on Mac OS X 10.4.x. Users may not particularly love the appearance of Tkinter, but it works well.

        + +

        If you're looking to write more advanced GUIs, the best choice is currently PyQt. You can write your own custom dialogs and palettes using PyQt, giving you the ability to extend the Scribus interface to a limited extent. PyQt will not work reliably from a normal script, but works fine from scripts that are run using the "Load Extension Script..." menu item. Please see the advanced section of the scripter manual for more details on this.

        + +

        Issues with event loop integration and initialization in sub-interpreters mean that PyGtk and wxPython are not currently recommended and probably won't work properly. Given that Tkinter works well for normal scripts, and PyQt for more advanced tasks, this isn't seen as a major problem.

        + +

        Should I use 'from scribus import *' or 'import scribus'?

        +

        In general, 'import scribus' is preferred. 'from ... import' can get confusing in import loops, when reloading modules, when importing packages, and in some other circumstances. More info http://effbot.org/zone/import-confusion.htm.

        + +

        While 'import scribus' results in slightly more verbose code, it's generally worth it in improved code readability and explictness.

        + +

        What about general programming style?

        +

        In general, we defer to the Python gurus. Have a look at http://www.python.org/peps/pep-0008.html for a rather in-depth look at the subject.

        + +

        An exception is made for source code encodings, where either ASCII with escapes, latin-1, or utf-8 are recommended. Almost any encoding you choose should work fine, though.

        + +

        Please note that none of this is set in stone - you can code however you like. These recommendations are made for a reason though, and are a good idea to follow especially if you plan to share your code with others.

        + +

        Are there any quirks specific to the Scribus python interface that I should know about?

        +

        Yes, there are a few differences you should be aware of:

        + +
          +
        • Python scripts running in Scribus may not create threads. Qt, the toolkit Scribus is built with, provides its own threading framework that doesn't play well with the Python threading system. A interface to QThread may be provided if sufficient need for it can be shown, and if it can be made to work.
          • + +
        • PyQt does not currently work correctly from Python scripts run from normal Scribus scripts, though it can now be used from the 'extension script' mode. Please enquire on the mailing list if you think you may be able to assist in solving this. Experience with the Python/C API, sub-interpreters, and PyQt would probably be required.
          • + +
        • The Scribus python plug-in changes the Python default string encoding (sysdefaultencoding) to utf-8. Python defaults to ASCII. Because utf-8 is a (large) superset of ASCII, this should not affect scripts that only use ASCII-encoded strings. The Scribus functions have been tested to work correctly with this for unicode text, so there should not be any issues there either.
          + Nonetheless, it is possible that third party C extension modules may have problems with this, if the author failed to consider the encoding of incoming text. Any such problems are almost always bugs that should be reported to the author of the module, and should be few and far between. If you encounter such an issue, please enquire on the mailing list or on IRC.
          • + +
        • Python runs embedded inside Scribus. It is possible that loading certain C extension modules that perform complex initialization tricks may disrupt Scribus or the Python interpreter. If you encounter such a module, please report it on the mailing list or drop in on IRC. Anything that wants to run its own event loop is likely to be problematic, and interfaces to GUI toolkits also seem to be troublesome. Anything that spawns threads is also likely to cause issues.
          • +
        + +

        Can I use the rest of the Python standard library or add-in modules?

        +

        Yes, and yes. Scribus imposes no restrictions on access to the rest of Python (except for the technical limitations explained above), and that's one of the things that makes the scripter so powerful. It is possible that some Python functions such as threading may be affected by the way the interpreter has been embedded, but most should be usable as normal.

        + +

        I'd like to extend Scribus using Python, not just automate things with it...

        +

        Currently, that's not really possible. There is work on making it possible to extend Scribus with Python to some extent, especially the GUI. It's now possible to use PyQt to write your own palettes, but you won't be able to use custom Scribus widgets or get into the innards of the application. The Scribus core is unfortunately not well suited to extension from Python. More advanced or tightly integrated extensions are probably better written as C++ plug-ins.

        + +

        What about security? Can I trust scripts not to destroy my data or compromise my computer?

        +

        No. Do not run a script if it is not from a trusted source, and preferably not unless you have read it. The downside of the power of the Python scripting interface is that it imposes almost no security restrictions. Anything you can do from the shell without a password, a script can do too.

        + +

        If Python ever gets support for a restricted execution environment like versions < 2.2 had, support for it may be added, but currently there are essentially no restrictions. It would be interesting to investigate a simple automation-only macro language for embedding in Scribus, but currently there aren't the resources to do this.

        + +

        So ... can I embed scripts in documents or templates?

        +

        No, see above. We can't provide a restricted execution environment, so it's not safe to let scripts travel with documents. Otherwise a malicious script could use a document as a vector to infect other systems. Remember Word macro viruses? Yeah. We do too.

        + +

        What about a startup script or event-triggered scripts?

        + +

        Startup scripts are supported, and scripts that run when certain events happen may be supported in future. If a script is in a position to "infect" a startup script or your application, it's also able to modify your .bashrc or your X startup script. In other words, if you choose to run untrusted code on your machine, it's too late - having it insert its self into a Scribus startup script would be the least of your problems. This is not unique to Scribus, and is true of bash scripts, normal programs, and most plug-ins as well. Remember, do not run scripts that are not from trusted sources, scripts are programs like any other you might run on your computer.. + +

        It's as safe for Scribus to load a script on startup as it is for the shell (e.g. bash), or your graphical login system. Scribus cannot protect you if you choose to run untrusted programs on your system. What it can prevent is providing any vector for untrusted code to spread. That is why Scribus supports startup scripts (though they are not run by default) and why scripts will not be permitted to be embedded in or run from documents.

        + +

        Do not run a program, script, or plug-in, of any sort, from any source, unless you have verified that the program is not malicious. This is an important rule of basic computer security and applies to any program and operating system.

        + +

        What about C++ plugins for Scribus? Are they secure?

        +

        Not at all. A Scribus C++ plug-in can do almost anything any other program on your computer can do, so do not download and run one you do not absolutely trust the author of. This is true of plug-ins for most programs, as it is very difficult to restrict what a plug-in written in C/C++ can do.

        + +

        I can't find a way to do something from Python, but the main Scribus application supports it. What do I do?

        +

        The scripting interface currently requires each function to be written by hand - no automatic code generation / wrapping mechanism is used. This is partly because there isn't currently any tidy and stable underlying public API to wrap.

        + +

        In general, if a function is missing it is because nobody has found the time or need to write it yet. Sometimes the function is more complicated than it seems, and may be quite a lot of work to wrap. Sometimes it's five minutes work. Ask politely on IRC or the mailing list, and if someone has the time and inclination they may write one for you.

        + +

        I asked on the mailing list or IRC but nobody offered to write this function I need for the scripter. What can I do?

        +

        You have a few options:

        +
          +
        • Waiting a while then politely trying again.
          • +
        • You may be able to add it yourself - the chances are that somebody who works on the scripter will be able to help give you an idea of how much work that would involve for what you want to do. In general, the scripter isn't very complicated, and many functions are fairly trivial to write, so even if you don't know much C++ you shouldn't assume you can't do it. When I started work on the scripter I knew absolutely no C or C++ at all ... I just _really_ wanted a few new capabilities.
          • + +
        • If you do decide to add a function yourself, please remember to consider that not all text is ASCII. Use the 'es' format in PyArg_ParseTuple not the 's' format, and specify "utf-8" encoding. Use the QString::fromUtf8 and QString::utf8() methods when getting data into and out of, respectively, QString objects. Have a look at some of the other scripter code to see how this is done, or feel free to ask on IRC or the mailing list if you have trouble.
          • + +
        • Offering to pay somebody to do it. This is probably only practical for larger amounts of work that would require quite a bit of time and effort (and money), but it's there as an option if you really need something.
          • +
        + + \ No newline at end of file diff --git a/scribus/doc/it/scripter1.html b/scribus/doc/it/scripter1.html new file mode 100644 index 0000000..d4a11d2 --- /dev/null +++ b/scribus/doc/it/scripter1.html @@ -0,0 +1,28 @@ + + + + Scripting Scribus with Python + + +

        Scripting Scribus with Python

        + +

        Overview

        +

        This is the description how to use the scripting plug-in for Scribus. The Scripter allows you to use the powerful Python programming language as a scripting language in Scribus. This can help you to automate otherwise repetitive tasks or add new features.

        + +

        Note that additions to the Scripter are being made frequently, which means that the available documentation may be incomplete.

        + + +

        Using the Plug-in

        +

        Scribus is being shipped with some “hard-wired” scripts, which are available via Scripter > Scribus Scripts:

        + +
        Running a script
        + +

        There are some simple example scripts in the subdirectory “samples.” Its location depends on the operating system you use, e.g. /usr/local/share/scribus or /usr/share/scribus on Linux. If you have created a script which you think could be useful for others, please feel free to add it to the Scribus Wiki or paste it into an email and send it to the Scribus mailing list.

        + +

        To execute an external Python script, you have to use Script > Execute Script. Scribus will open a file dialog, which allows you to select a Python script (file extension: *.py). Script > Recent Scripts shows a list of recently executed scripts.

        + +

        You can use many Python modules with this plug-in, the only exception being scripts that expect parameters from the command Line. These won’t work because the plug-in gives the Python interpreter an empty command line.

        + +

        The menu entry Script > Show Console will launch an interactive Python console, where you can execute commands directly. There is no need to use “from scribus import *”, as this has already been done. You can use all the commands listed in the following pages of the Scripter API documentation directly without any prefix.

        + + diff --git a/scribus/doc/it/scripterapi-ImageExport.html b/scribus/doc/it/scripterapi-ImageExport.html new file mode 100644 index 0000000..f3b7c53 --- /dev/null +++ b/scribus/doc/it/scripterapi-ImageExport.html @@ -0,0 +1,65 @@ + + + + Python: class ImageExport + + +

        Python: class ImageExport

        +

        +class ImageExport(object) +

        +
        + +

        Image export

        +

        Class ImageExport() provides the bitmap graphics exporting for Python scripting as you know it from Export/Save as Image menu. See related class PDFfile() and procedure savePageAsEPS().

        +

        Example:
        + +i = ImageExport()
        +i.type = 'PNG' # select one from i.allTypes list
        +i.scale = 200 # I want to have 200%
        +i.name = '/home/subik/test.png'
        +i.save()
        +

        +

        Last two lines should be replaced with: i.saveAs('/home/subik/test.png')

        + +

        Methods defined here

        + +
        +
        __init__(...)
        +

        x.__init__(...) initializes x; see x.__class__.__doc__ for signature

        + +
        save(...)
        +
        save() -> boolean +

        Saves image under previously set 'name'.

        + +
        saveAs(...)
        +
        saveAs('filename') -> boolean +

        Saves image as 'filename'.

        +
        + +

        Data and other attributes defined here

        + +
        +
        __new__ = <built-in method __new__ of type object>
        +

        T.__new__(S, ...) -> a new object with type S, a subtype of T

        + +
        allTypes = <attribute 'allTypes' of 'ImageExport' objects>
        +

        Available types. Read only list of strings.

        + +
        dpi = <member 'dpi' of 'ImageExport' objects>
        +

        This value will be used for export as DPI. Read/write integer.

        + +
        name = <attribute 'name' of 'ImageExport' objects>
        +

        Filename of the image. With or without path. Read/write string.

        + +
        quality = <member 'quality' of 'ImageExport' objects>
        +

        Quality/compression: minimum 1 (poor), maximum 100 (qaulity). Read/write integer.

        + +
        scale = <member 'scale' of 'ImageExport' objects>
        +

        This is the scaling of the image. 100 = 100% etc. Read/write iteger.

        + +
        type = <attribute 'type' of 'ImageExport' objects>
        +

        Bitmap type. See allTypes list for more info. Read/write string.

        + + + diff --git a/scribus/doc/it/scripterapi-PDFfile.html b/scribus/doc/it/scripterapi-PDFfile.html new file mode 100644 index 0000000..9516bba --- /dev/null +++ b/scribus/doc/it/scripterapi-PDFfile.html @@ -0,0 +1,206 @@ + + + + Python: class PDFfile + + +

        Python: class PDFfile

        +

        class PDFfile(object) +

        +
        +

        Methods defined here:

        +
        +
        Save(...)
        +
        This method is deprecated - use save() instead.
        + +
        __init__(...)
        x.__init__(...) initializes x; see x.__class__.__doc__ for signature
        + +
        save(...)
        Save selected pages to pdf file
        +
        + +
        +

        Data and other attributes defined here:

        +
        +
        __new__ = <built-in method __new__ of type object>
        +
        T.__new__(S, ...) -> a new object with type S, a subtype of T
        + +
        aanot = <member 'aanot' of 'PDFfile' objects>
        +
        Allow Adding Annotations and Fields. Bool value
        + +
        achange = <member 'achange' of 'PDFfile' objects>
        +
        Allow Changing the Document. Bool value
        + +
        acopy = <member 'acopy' of 'PDFfile' objects>
        +
        Allow Copying Text and Graphics. Bool value
        + +
        aprint = <member 'aprint' of 'PDFfile' objects>
        +
        Allow Printing the Document. Bool value
        + +
        article = <member 'article' of 'PDFfile' objects>
        +
        Save Linked Text Frames as PDF Articles
        Bool value
        + +
        binding = <member 'binding' of 'PDFfile' objects>
        +
        Choose binding.
        + 0 - Left binding
        + 1 - Right binding
        + +
        bleedb = <member 'bleedb' of 'PDFfile' objects>
        +
        Bleed Bottom
        Distance for bleed from the bottom of the physical page
        + +
        bleedl = <member 'bleedl' of 'PDFfile' objects>
        +
        Bleed Left
        Distance for bleed from the left of the physical page
        + +
        bleedr = <member 'bleedr' of 'PDFfile' objects>
        +
        Bleed Right
        Distance for bleed from the right of the physical page
        + +
        bleedt = <member 'bleedt' of 'PDFfile' objects>
        +
        Bleed Top
        Distance for bleed from the top of the physical page
        + +
        bookmarks = <member 'bookmarks' of 'PDFfile' objects>
        +
        Embed the bookmarks you created in your document.
        These are useful for navigating long PDF documents.
        Bool value
        + +
        compress = <member 'compress' of 'PDFfile' objects>
        +
        Compression switch. Bool value.
        + +
        compressmtd = <member 'compressmtd' of 'PDFfile' objects>
        +
        Compression method.
        + 0 - Automatic
        + 1 - JPEG
        + 2 - zip
        + 3 - None.
        + +
        downsample = <attribute 'downsample' of 'PDFfile' objects>
        +
        Downsample image resolusion to this value. Values from 35 to 4000
        Set 0 for not to downsample
        + +
        effval = <attribute 'effval' of 'PDFfile' objects>
        +
        List of effection values for each saved page.
        + 
        +It is list of list of six integers. Those int have the following meaning:
+        - Length of time the page is shown before the presentation
+        starts on the selected page. (1-3600)
+        - Length of time the effect runs. (1 - 3600)
+                A shorter time will speed up the effect, a longer one will slow it down
+        - Type of the display effect
+                0 - No Effect
+                1 - Blinds
+                2 - Box
+                3 - Dissolve
+                4 - Glitter
+                5 - Split
+                6 - Wipe
+        - Direction of the effect of moving lines for the split and blind effects.
+                0 - Horizontal
+                1 - Vertical
+        - Starting position for the box and split effects.
+                0 - Inside
+                1 - Outside
+        - Direction of the glitter or wipe effects.
+                0 - Left to Right
+                1 - Top to Bottom
+                2 - Bottom to Top
+                3 - Right to Left
+                4 - Top-left to Bottom-Right
+
         + + +
        encrypt = <member 'encrypt' of 'PDFfile' objects>
        +
        Use Encription. Bool value
        + +
        file = <attribute 'file' of 'PDFfile' objects>
        +
        Name of file to save into
        + +
        fonts = <attribute 'fonts' of 'PDFfile' objects>
        +
        List of fonts to embed.
        + +
        imagepr = <attribute 'imagepr' of 'PDFfile' objects>
        +
        Color profile for images
        + +
        info = <attribute 'info' of 'PDFfile' objects>
        +
        Mandatory string for PDF/X-3 or the PDF will fail PDF/X-3 conformance. We recommend you use the title of the document.
        + +
        intenti = <member 'intenti' of 'PDFfile' objects>
        +
        Rendering intent for images
        +0 - Perceptual
        +1 - Relative Colorimetric
        +2 - Saturation
        +3 - Absolute Colorimetric
        + +
        intents = <member 'intents' of 'PDFfile' objects>
        +
        Rendering intent for solid colors
        +0 - Perceptual
        +1 - Relative Colorimetric
        +2 - Saturation
        +3 - Absolute Colorimetric
        + +
        lpival = <attribute 'lpival' of 'PDFfile' objects>
        +
        Rendering Settings for individual colors.
        +
        +This is list of values for each color.
+Color values have structure [siii] which stand for:
+        s - Color name ('Black', 'Cyan', 'Magenta', 'Yellow')
+        i - Frequency (10 to 1000)
+        i - Angle (-180 to 180)
+        i - Spot Function
+                0 - Simple Dot
+                1 - Line
+                2 - Round
+                3 - Ellipse
+
        +Be careful when supplying these values as they are not checked for validity.
        + +
        noembicc = <member 'noembicc' of 'PDFfile' objects>
        +
        Don't use embedded ICC profiles. Bool value
        + +
        outdst = <member 'outdst' of 'PDFfile' objects>
        +
        Output destination.
        +0 - screen
        +1 - printer
        + +
        owner = <attribute 'owner' of 'PDFfile' objects>
        +
        Owner's password
        + +
        pages = <attribute 'pages' of 'PDFfile' objects>
        +
        List of pages to print
        + +
        presentation = <member 'presentation' of 'PDFfile' objects>
        +
        Enable Presentation Effects.Bool value
        + +
        printprofc = <attribute 'printprofc' of 'PDFfile' objects>
        +
        Output profile for printing. If possible, get some guidance from your printer on profile selection.
        + +
        profilei = <member 'profilei' of 'PDFfile' objects>
        +
        Embed a color profile for images. Bool value.
        + +
        profiles = <member 'profiles' of 'PDFfile' objects>
        +
        Embed a color profile for solid colors. Bool value.
        + +
        quality = <member 'quality' of 'PDFfile' objects>
        +
        Image quality
        +0 - Maximum
        +1 - High
        +2 - Medium
        +3 - Low
        +4 - Minimum
        + +
        resolution = <attribute 'resolution' of 'PDFfile' objects>
        +
        Resolution of output file. Values from 35 to 4000.
        + +
        solidpr = <attribute 'solidpr' of 'PDFfile' objects>
        +
        Color profile for solid colors
        + +
        thumbnails = <member 'thumbnails' of 'PDFfile' objects>
        Generate thumbnails. Bool value.
        + +
        uselpi = <member 'uselpi' of 'PDFfile' objects>
        +
        Use Custom Rendering Settings. Bool value
        + +
        user = <attribute 'user' of 'PDFfile' objects>
        +
        User's password
        + +
        version = <member 'version' of 'PDFfile' objects>
        +
        Choose PDF version to use:
        +12 = PDF/X-3
        +13 = PDF 1.3 (Acrobat 4)
        +14 = PDF 1.4 (Acrobat 5)
        + + + \ No newline at end of file diff --git a/scribus/doc/it/scripterapi-Printer.html b/scribus/doc/it/scripterapi-Printer.html new file mode 100644 index 0000000..a638ffb --- /dev/null +++ b/scribus/doc/it/scripterapi-Printer.html @@ -0,0 +1,89 @@ + + + + Python: class Printer + + +

        Python: class Printer

        +

        +class Printer(object) +

        +
        + +

        Methods defined here:

        +
        +
        Print(...)
        +
        This method is deprecated - use print() instead.
        + +
        __init__(...)
        +
        x.__init__(...) initializes x; see x.__class__.__doc__ for signature
        + +
        print(...)
        +
        Prints selected pages.
        + +
        +

        Data and other attributes defined here:

        +
        +
        __new__ = <built-in method __new__ of type object>
        +
        T.__new__(S, ...) -> a new object with type S, a subtype of T
        + +
        allPrinters = <attribute 'allPrinters' of 'Printer' objects>
        +
        List of installed printers -- read only
        + +
        cmd = <attribute 'cmd' of 'Printer' objects>
        +
        Alternative Printer Command
        + +
        color = <member 'color' of 'Printer' objects>
        +
        Print in color.
        +True - color -- Default
        +False - greyscale
        + +
        copies = <member 'copies' of 'Printer' objects>
        +
        Number of copies
        + +
        file = <attribute 'file' of 'Printer' objects>
        +
        Name of file to print into
        + +
        mph = <member 'mph' of 'Printer' objects>
        +
        Mirror Pages Horizontal
        +True
        +False -- Default
        + +
        mpv = <member 'mpv' of 'Printer' objects>
        +
        Mirror Pages Vertical
        + True
        +False -- Default
        + +
        pages = <attribute 'pages' of 'Printer' objects>
        +
        List of pages to be printed
        + +
        printer = <attribute 'printer' of 'Printer' objects>
        +
        Name of printer to use.
        +Default is 'File' for printing into file
        + +
        pslevel = <member 'pslevel' of 'Printer' objects>
        +
        PostScript Level
        +Can be 1 or 2 or 3 -- Default is 3.
        + +
        separation = <attribute 'separation' of 'Printer' objects>
        +
        Print separationl
        + 'No' -- Default
        + 'All'
        + 'Cyan'
        + 'Magenta'
        + 'Yellow'
        + 'Black'
        +Beware of misspelling because a check is not performed
        + +
        ucr = <member 'ucr' of 'Printer' objects>
        +
        Apply Under Color Removal
        +True -- Default
        +False
        + +
        useICC = <member 'useICC' of 'Printer' objects>
        +
        Use ICC Profile
        +True
        +False -- Default
        + + + \ No newline at end of file diff --git a/scribus/doc/it/scripterapi-color.html b/scribus/doc/it/scripterapi-color.html new file mode 100644 index 0000000..a8e2526 --- /dev/null +++ b/scribus/doc/it/scripterapi-color.html @@ -0,0 +1,63 @@ + + + + Color related Commands + + +

        Color related Commands

        + +
        + +
        changeColor(...)
        +
        changeColor("name", c, m, y, k) +

        Changes the color "name" to the specified CMYK value. The color value is defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black. Color components should be in the range from 0 to 255.

        +

        May raise NotFoundError if the named color wasn't found. May raise ValueError if an invalid color name is specified.

        + +
        defineColor(...)
        +
        defineColor("name", c, m, y, k) +

        Defines a new color "name". The color Value is defined via four components: c = Cyan, m = Magenta, y = Yellow and k = Black. Color components should be in the range from 0 to 255.

        +

        May raise ValueError if an invalid color name is specified.

        + +
        deleteColor(...)
        +
        deleteColor("name", "replace") +

        Deletes the color "name". Every occurence of that color is replaced by the color "replace". If not specified, "replace" defaults to the color "None" - transparent.

        +

        deleteColor works on the default document colors if there is no document open. In that case, "replace", if specified, has no effect.

        +

        May raise NotFoundError if a named color wasn't found. May raise ValueError if an invalid color name is specified.

        + +
        getColor(...)
        +
        getColor("name") -> tuple +

        Returns a tuple (C, M, Y, K) containing the four color components of the color "name" from the current document. If no document is open, returns the value of the named color from the default document colors.

        +

        May raise NotFoundError if the named color wasn't found. May raise ValueError if an invalid color name is specified.

        + +
        getColorAsRGB(...)
        +
        getColorAsRGB("name") -> tuple +

        Returns a tuple (R,G,B) containing the three color components of the color "name" from the current document, converted to the RGB color space. If no document is open, returns the value of the named color from the default document colors.

        +

        May raise NotFoundError if the named color wasn't found. May raise ValueError if an invalid color name is specified.

        + +
        getColorNames(...)
        +
        getColorNames() -> list +

        Returns a list containing the names of all defined colors in the document. If no document is open, returns a list of the default document colors.

        + +
        isSpotColor(...)
        +
        isSpotColor("name") -> bool +

        Returns True if the color "name" is a spot color.

        +

        See also setSpotColor()

        +

        May raise NotFoundError if a named color wasn't found.

        +

        May raise ValueError if an invalid color name is specified.

        + +
        replaceColor(...)
        +
        replaceColor("name", "replace") +

        Every occurence of the color "name" is replaced by the color "replace".

        +

        May raise NotFoundError if a named color wasn't found. May raise ValueError if an invalid color name is specified.

        + +
        setSpotColor(...)
        +
        setSpotColor("name", spot) +

        Set the color "name" as a spot color if spot parameter is True.

        +

        See also isSpotColor().

        +

        May raise NotFoundError if a named color wasn't found.

        +

        May raise ValueError if an invalid color name is specified.

        + +
        + + + diff --git a/scribus/doc/it/scripterapi-constants.html b/scribus/doc/it/scripterapi-constants.html new file mode 100644 index 0000000..3514a21 --- /dev/null +++ b/scribus/doc/it/scripterapi-constants.html @@ -0,0 +1,203 @@ + + + + Predefined Constants + + +

        Predefined Constants

        + +

        There are some Constants defined to help using the Commands:

        + +

        Scribus Version:

        +

        The script interface provides two variables containing the current Scribus version in the scribus module. Scripts can use these variables to check that they're running under the version of Scribus they expect, and to report information about incompatibilities to the user. These two variables, scribus_version and scribus_version_info, were added in 1.2.1 and 1.3.0svn and will not be present in earlier versions. If you need to, you can check for their presence with hasattr(scribus, 'scribus_version').

        +

        scribus_version contains the current Scribus version as a string. It will usually look like '1.2.1svn' or '1.3.0', for example, but is not guaranteed to always follow that format. This variable is useful when you need to display the version to the user, for example when reporting an incompatibility. Do not parse or compare this variable, that is what scribus_version_info is for.

        +

        scribus_version_info is a tuple similar to the sys.version_info tuple provided by Python. It is a tuple of the form (majorversion, minorversion, patchlevel, extraversion, build) for example, 1.2.1svn will have (1,2,1,'svn',0) and 1.3.2 will have (1,3,2,'',0) . These tuples are ideal for checking for minimum versions, etc, because Python compares tuples element-by-element, left-to-right. For example:

        +
        +if scribus.scribus_version_info[:3] < (1,2,2):
+    messageBox("Scribus - Python script",
+        "This script requires Scribus 1.2.2 or newer. "+\
+        "You're running %s." % scribus.scribus_version,
+        ICON_CRITICAL)
+    sys.exit()
+
        + +

        Unit Enumeration Constants:

        +
        +
        UNIT_POINTS
        +
        Measurement Unit Point = 0
        +
        UNIT_MILLIMETERS
        +
        Measurement Unit Millimeter = 1
        +
        UNIT_INCHES
        +
        Measurement Unit Inch = 2
        +
        UNIT_PICAS
        +
        Measurement Unit Pica = 3
        +
        + +

        Unit Conversion Constants

        + +

        These conversion factors can be used to convert units to and from points. +Thus, to convert inches to points, you can simply write 'value/inch', to +convert points to inches you write 'value*inch', and to convert inches to mm +you write 'value*mm/inch' .

        + +
        +
        pt
        +
        points in 1 pt
        +
        inch
        +
        inches in 1 pt +
        p
        +
        pica in 1 pt
        +
        cm
        +
        centimetres in 1 pt
        +
        mm
        +
        millimetres in 1 pt
        +
        ...
        +
        Other constants will be provided if the Scribus core knows about them.
        +
        + +

        Page Orientation Definitions:

        +
        +
        PORTRAIT
        +
        Pageformat Portrait = 0
        +
        LANDSCAPE
        +
        Pageformat Landscape = 1
        +
        + +

        Definitions for Page Formats:

        +
        +
        PAPER_A0
        +
        Paperformat A0 = 2380 x 3368 Points
        +
        PAPER_A1
        +
        Paperformat A1 = 1684 x 2380 Points
        +
        PAPER_A2
        +
        Paperformat A2 = 1190 x 1684 Points
        +
        PAPER_A3
        +
        Paperformat A3 = 842 x 1190 Points
        +
        PAPER_A4
        +
        Paperformat A4 = 595 x 842 Points
        +
        PAPER_A5
        +
        Paperformat A5 = 421 x 595 Points
        +
        PAPER_A6
        +
        Paperformat A6 = 297 x 421 Points
        +
        PAPER_A7
        +
        Paperformat A7 = 210 x 297 Points
        +
        PAPER_A8
        +
        Paperformat A8 = 148 x 210 Points
        +
        PAPER_A9
        +
        Paperformat A9 = 105 x 148 Points
        +
        PAPER_B0
        +
        Paperformat B0 = 2836 x 4008 Points
        +
        PAPER_B1
        +
        Paperformat B1 = 2004 x 2836 Points
        +
        PAPER_B2
        +
        Paperformat B2 = 1418 x 2004 Points
        +
        PAPER_B3
        +
        Paperformat B3 = 1002 x 1418 Points
        +
        PAPER_B4
        +
        Paperformat B4 = 709 x 1002 Points
        +
        PAPER_B5
        +
        Paperformat B5 = 501 x 709 Points
        +
        PAPER_B6
        +
        Paperformat B6 = 355 x 501 Points
        +
        PAPER_B7
        +
        Paperformat B7 = 250 x 355 Points
        +
        PAPER_B8
        +
        Paperformat B8 = 178 x 250 Points
        +
        PAPER_B9
        +
        Paperformat B9 = 125 x 178 Points
        +
        PAPER_B10
        +
        Paperformat B10 = 89 x 125 Points
        +
        PAPER_C5E
        +
        Paperformat C5E = 462 x 649 Points
        +
        PAPER_COMM10E
        +
        Paperformat Comm10E = 298 x 683 Points
        +
        PAPER_DLE
        +
        Paperformat DLE = 312 x 624 Points
        +
        PAPER_EXECUTIVE
        +
        Paperformat Executive = 542 x 720 Points
        +
        PAPER_FOLIO
        +
        Paperformat Folio = 595 x 935 Points
        +
        PAPER_LEDGER
        +
        Paperformat Ledger = 1224 x 792 Points
        +
        PAPER_LEGAL
        +
        Paperformat Legal = 612 x 1008 Points
        +
        PAPER_LETTER
        +
        Paperformat Letter = 612 x 792 Points
        +
        PAPER_TABLOID
        +
        Paperformat Tabloid = 792 x 1224 Points
        +
        + +

        Definitions for Document Layout:

        +
        +
        FACINGPAGES
        +
        Layout with facing Pages.
        +
        NOFACINGPAGES
        +
        Normal Layout of the Document.
        +
        FIRSTPAGELEFT
        +
        The first Page of the Document is a left Page.
        +
        FIRSTPAGERIGHT
        +
        The first Page of the Document is a right Page.
        +
        + +

        Alignment Definitions

        +
        +
        ALIGN_LEFTK
        +
        Text is aligned to the Left.
        +
        ALIGN_CENTERED
        +
        The Text is centered in the Textframe.
        +
        ALIGN_RIGHT
        +
        The Text is aligned to the Right Side of the Textframe
        +
        ALIGN_FORCED
        +
        The Text has forced Alignment
        +
        ALIGN_BLOCK
        +
        The Text has block Alignment
        +
        + +

        Line related Definitions:

        +
        +
        LINE_DASH
        +
        LINE_DASHDOT
        +
        LINE_DASHDOTDOT
        +
        LINE_DOT
        +
        LINE_SOLID
        +
        JOIN_BEVEL
        +
        JOIN_MITTER
        +
        JOIN_ROUND
        +
        CAP_FLAT
        +
        CAP_ROUND
        +
        CAP_SQUARE
        +
        + +

        Fill related Definitions:

        +
        +
        FILL_NOG
        +
        No gradient, plain color
        +
        FILL_HORIZONTALG
        +
        FILL_VERTICALG
        +
        FILL_DIAGONALG
        +
        FILL_CROSSDIAGONALG
        +
        FILL_RADIALG
        +
        + +

        Dialog Buttons

        +
        +
        BUTTON_ABORT
        +
        BUTTON_CANCEL
        +
        BUTTON_IGNORE
        +
        BUTTON_NO
        +
        BUTTON_NONE
        +
        BUTTON_OK
        +
        BUTTON_RETRY
        +
        BUTTON_YES
        +
        + +

        Dialog Icons

        +
        +
        ICON_CRITICAL
        +
        ICON_INFORMATION
        +
        ICON_NONE
        +
        ICON_WARNING
        +
        + + + diff --git a/scribus/doc/it/scripterapi-dialogs.html b/scribus/doc/it/scripterapi-dialogs.html new file mode 100644 index 0000000..4eb9624 --- /dev/null +++ b/scribus/doc/it/scripterapi-dialogs.html @@ -0,0 +1,85 @@ + + + + Using Dialogs from Scribus + + +

        Using Dialogs from Scribus

        + +
        + +
        fileDialog(...)
        +
        fileDialog("caption", ["filter", "defaultname", haspreview, issave, isdir])
        -> string with filename         +

        Shows a File Open dialog box with the caption "caption". Files are filtered with the filter string "filter". A default filename or file path can also supplied, leave this string empty when you don't want to use it. A value of True for haspreview enables a small preview widget in the FileSelect box. When the issave parameter is set to True the dialog acts like a "Save As" dialog otherwise it acts like a "File Open Dialog". When the isdir parameter is True the dialog shows and returns only directories. The default for all of the opional parameters is False.

        +

        The filter, if specified, takes the form 'comment (*.type *.type2 ...)'. For example 'Images (*.png *.xpm *.jpg)'.

        +

        Refer to the Qt-Documentation for QFileDialog for details on filters.

        +

        Example: fileDialog('Open input', 'CSV files (*.csv)')
        +Example: fileDialog('Save report', defaultname='report.txt', issave=True)

        + +
        fileQuit(...)
        +
        fileQuit() +

        Quit Scribus.

        + +
        getGuiLanguage(...)
        +
        getGuiLanguage() -> string +

        Returns a string with the -lang value.

        + +
        messagebarText(...)
        +
        messagebarText("string") +

        Writes the "string" into the Scribus message bar (status line). The text must be UTF8 encoded or 'unicode' string(recommended).

        + +
        messageBox(...)
        +
        messageBox("caption", "message", +icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT, +button2=BUTTON_NONE, button3=BUTTON_NONE) -> integer +

        Displays a message box with the title "caption", the message "message", and an icon "icon" and up to 3 buttons. By default no icon is used and a single button, OK, is displayed. Only the caption and message arguments are required, though setting an icon and appropriate button(s) is strongly recommended. The message text may contain simple HTML-like markup.

        +

        Returns the number of the button the user pressed. Button numbers start at 1.

        +

        For the icon and the button parameters there are predefined constants available with the same names as in the Qt Documentation. These are the BUTTON_* and ICON_* constants defined in the module. There are also two extra constants that can be binary-ORed with button constants:

        +
          +
        • BUTTONOPT_DEFAULT Pressing enter presses this button.
          • +
        • BUTTONOPT_ESCAPE Pressing escape presses this button.
          • +
        +

        Usage examples:

        +
        +result = messageBox('Script failed',
+                    'This script only works when you have a text frame selected.',
+                    ICON_ERROR)
+result = messageBox('Monkeys!', 'Something went ook! <i>Was it a monkey?</i>',
+                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
+                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
+
        +

        Defined button and icon constants: BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO, BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL, ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.

        + +
        newDocDialog(...)
        +
        newDocDialog() -> bool +

        Displays the "New Document" dialog box. Creates a new document if the user accepts the settings. Does not create a document if the user presses cancel. Returns true if a new document was created.

        + +
        newStyleDialog(...)
        +
        newStyleDialog() -> string +

        Shows 'Create new paragraph style' dialog. Function returns real style name or None when user cancels the dialog.

        + +
        statusMessage(...)
        +
        messagebarText("string") +

        Writes the "string" into the Scribus message bar (status line). The text must be UTF8 encoded or 'unicode' string(recommended).

        + +
        progressReset(...)
        +
        progressReset() +

        Cleans up the Scribus progress bar previous settings. It is called before the new progress bar use. See progressSet.

        + +
        progressSet(...)
        +
        progressSet(nr) +

        Set the progress bar position to "nr", a value relative to the previously set progressTotal. The progress bar uses the concept of steps; you give it the total number of steps and the number of steps completed so far and it will display the percentage of steps that have been completed. You can specify the total number of steps with progressTotal(). The current number of steps is set with progressSet(). The progress bar can be rewound to the beginning with progressReset(). [based on info taken from Trolltech's Qt docs]

        + +
        progressTotal(...)
        +
        progressTotal(max) +

        Sets the progress bar's maximum steps value to the specified number. See progressSet.

        + +
        valueDialog(...)
        +
        valueDialog(caption, message [,defaultvalue]) -> string +

        Shows the common 'Ask for string' dialog and returns its value as a string Parameters: window title, text in the window and optional 'default' value.

        +

        Example: valueDialog('title', 'text in the window', 'optional')

        + +
        + + + diff --git a/scribus/doc/it/scripterapi-doc.html b/scribus/doc/it/scripterapi-doc.html new file mode 100644 index 0000000..e73d2f3 --- /dev/null +++ b/scribus/doc/it/scripterapi-doc.html @@ -0,0 +1,162 @@ + + + + Document related Commands + + +

        Document related Commands

        + +
        + +
        closeDoc(...)
        +
        closeDoc() +

        Closes the current document without prompting to save.

        +

        May throw NoDocOpenError if there is no document to close

        + +
        docChanged(...)
        +
        docChanged(bool) +

        Enable/disable save icon in the Scribus icon bar and the Save menu item. It's +useful to call this procedure when you're changing the document, because Scribus +won't automatically notice when you change the document using a script.

        + +
        getUnit(...)
        +
        getUnit() -> integer (Scribus unit constant) +

        Returns the measurement units of the document. The returned value will be one of the UNIT_* constants: UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.

        + +
        haveDoc(...)
        +
        haveDoc() -> bool +

        Returns true if there is a document open.

        + + + +
        loadStylesFromFile(...)
        +
        loadStylesFromFile("filename") +

        Loads paragraph styles from the Scribus document at "filename" into the current document.

        + +
        masterPageNames(...)
        +
        masterPageNames() +

        Returns a list of the names of all master pages in the document.

        + +
        newDoc(...)
        +
        newDoc(size, margins, orientation, firstPageNumber, unit, facingPages, firstSideLeft) -> bool +

        WARNING: Obsolete procedure! Use newDocument instead.

        +

        Creates a new document and returns true if successful. The parameters have the +following meaning:

        +
          +
        • size = A tuple (width, height) describing the size of the document. You can use predefined constants named PAPER_<paper_type> e.g. PAPER_A4 etc.
          • +
        • margins = A tuple (left, right, top, bottom) describing the document margins
          • +
        • orientation = the page orientation - constants PORTRAIT, LANDSCAPE
          • +
        • firstPageNumber = is the number of the first page in the document used for page numbering. While you'll usually want 1, it's useful to have higher numbers if you're creating a document in several parts.
          • +
        • unit: this value sets the measurement units used by the document. Use a predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
          • +
        • facingPages = FACINGPAGES, NOFACINGPAGES
          • +
        • firstSideLeft = FIRSTPAGELEFT, FIRSTPAGERIGHT
          • +
        +

        The values for width, height and the margins are expressed in the given unit for the document. PAPER_* constants are expressed in points. If your document is not in points, make sure to account for this.

        +

        example: newDoc(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 1, UNIT_POINTS, FACINGPAGES, FIRSTPAGERIGHT)

        + +
        newDocument(...)
        +
        newDocument(size, margins, orientation, firstPageNumber, + unit, pagesType, firstPageOrder, numPages) -> bool +

        Creates a new document and returns true if successful. The parameters have the +following meaning: +

          +
        • size = A tuple (width, height) describing the size of the document. You can +use predefined constants named PAPER_<paper_type> e.g. PAPER_A4 etc.
          • +
        • margins = A tuple (left, right, top, bottom) describing the document +margins
          • +
        • orientation = the page orientation - constants PORTRAIT, LANDSCAPE
          • +
        • firstPageNumer = is the number of the first page in the document used for +pagenumbering. While you'll usually want 1, it's useful to have higher +numbers if you're creating a document in several parts.
          • +
        • unit: this value sets the measurement units used by the document. Use a +predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS, +UNIT_PICAS, UNIT_POINTS.
          • +
        • pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page, +PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and +PAGE_4 is 4-fold.
          • +
        • firstPageOrder = What is position of first page in the document. +Indexed from 0 (0 = first).
          • +
        • numPage = Number of pages to be created.
          • +
        +

        The values for width, height and the margins are expressed in the given unit +for the document. PAPER_* constants are expressed in points. If your document +is not in points, make sure to account for this.

        +

        example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS, +PAGE_4, 3, 1)

        +

        May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.

        +
        + +
        openDoc(...)
        +
        openDoc("name") +

        Opens the document "name".

        +

        May raise ScribusError if the document could not be opened.

        + +
        placeEPS(...)
        +
        +

        placeEPS("filename", x, y) Places the EPS "filename" onto the current +page, x and y specify the coordinate of the topleft corner of the EPS +placed on the page If loading was successful, the selection contains +the imported EPS

        + +
        placeODG(...)
        +
        +

        placeODG("filename", x, y) Places the ODG "filename" onto the current +page, x and y specify the coordinate of the topleft corner of the ODG +placed on the page If loading was successful, the selection contains +the imported ODG

        + +
        placeSVG(...)
        +
        +

        placeSVG("filename", x, y) Places the SVG "filename" onto the current +page, x and y specify the coordinate of the topleft corner of the SVG +placed on the page If loading was successful, the selection contains +the imported SVG

        + +
        placeSXD(...)
        +
        +

        placeSXD("filename", x, y) Places the SXD "filename" onto the current +page, x and y specify the coordinate of the topleft corner of the SXD +placed on the page If loading was successful, the selection contains +the imported SXD

        + +
        saveDoc(...)
        +
        saveDoc() +

        Saves the current document with its current name, returns true if successful. If the document has not already been saved, this may bring up an interactive save file dialog. If the save fails, there is currently no way to tell.

        + +
        saveDocAs(...)
        +
        saveDocAs("name") +

        Saves the current document under the new name "name" (which may be a full or +relative path).

        +

        May raise ScribusError if the save fails.

        + +
        setInfo(...)
        +
        setInfo("author", "info", "description") -> bool +

        Sets the document information. "Author", "Info", "Description" are strings.

        + +
        setMargins(...)
        +
        setMargins(lr, rr, tr, br) +

        Sets the margins of the document, Left(lr), Right(rr), Top(tr) and Bottom(br) margins are given in the measurement units of the document - see UNIT_<type> constants.

        + +
        setDocType(...)
        +
        setDocType(facingPages, firstPageLeft) +

        Sets the document type. To get facing pages set the first parameter to FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead. If you want to be the first page a left side set the second parameter to FIRSTPAGELEFT, for a right page use FIRSTPAGERIGHT.

        + +
        setUnit(...)
        +
        setUnit(type) +

        Changes the measurement unit of the document. Possible values for "unit" are defined as constants UNIT_<type>.

        +

        May raise ValueError if an invalid unit is passed.

        + +
        scrollDocument(...)
        +
        scrollDocument(x,y) +

        Scroll the document in main GUI window by x and y.

        + +
        zoomDocument(...)
        +
        zoomDocument(double) +

        Zoom the document in main GUI window. Actions have whole number +values like 20.0, 100.0, etc. Zoom to Fit uses -100 as a marker.

        + +
        + + diff --git a/scribus/doc/it/scripterapi-extensions.html b/scribus/doc/it/scripterapi-extensions.html new file mode 100644 index 0000000..6c50066 --- /dev/null +++ b/scribus/doc/it/scripterapi-extensions.html @@ -0,0 +1,41 @@ + + + + Scripter Extensions API + + +

        Scripter Extensions API

        + +

        See Scripter Extensions for the +theoretical background of these procedures and functions.

        + +
        + +
        getChild(...)
        +
        getChild(object, childname, ofclass=None, recursive=True) +

        Return the first child of `object' named `childname', possibly restricting the search to children of type name `ofclass'. If `recursive' is true, search recursively through children, grandchildren, etc.

        + +
        getChildren(...)
        +
        getChildren(object, ofclass=None, ofname=None, regexpmatch=False, recursive=True) +

        Return a list of children of `object', possibly restricted to children of class named `ofclass' or children named `ofname'. If `recursive' is true, search recursively through children, grandchildren, etc. See QObject::children() in the Qt docs for more information.

        + +
        getProperty(...)
        +
        getProperty(object, property) +

        Return the value of the property `property' of the passed `object'. The `object' argument may be a string, in which case the named PageItem is searched for. It may also be a PyCObject, which may point to any C++ QObject instance. The `property' argument must be a string, and is the name of the property to look up on `object'. The return value varies depending on the type of the property.

        + +
        getPropertyCType(...)
        +
        getPropertyCType(object, property, includesuper=True) +

        Returns the name of the C type of `property' of `object'. See getProperty() for details of arguments. If `includesuper' is true, search inherited properties too.

        + +
        getPropertyNames(...)
        +
        getPropertyNames(object, includesuper=True) +

        Return a list of property names supported by `object'. If `includesuper' is true, return properties supported by parent classes as well.

        + +
        setProperty(...)
        +
        setProperty(object, property, value) +

        Set `property' of `object' to `value'. If `value' cannot be converted to a type compatible with the type of `property', an exception is raised. An exception may also be raised if the underlying setter fails. See getProperty() for more information.

        + +
        + + + \ No newline at end of file diff --git a/scribus/doc/it/scripterapi-font.html b/scribus/doc/it/scripterapi-font.html new file mode 100644 index 0000000..b6d9b92 --- /dev/null +++ b/scribus/doc/it/scripterapi-font.html @@ -0,0 +1,26 @@ + + + + Font Related Commands + + +

        Font Related Commands

        + +
        + +
        getFontNames(...)
        +
        getFontNames() -> list +

        Returns a list with the names of all available fonts.

        + +
        getXFontNames(...)
        +
        getXFontNames() -> list of tuples +

        Returns a larger font info. It's a list of the tuples with: [ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]

        + +
        renderFont(...)
        +
        renderFont("name", "filename", "sample", size, format="PPM") -> bool +

        Creates an image preview of font "name" with given text "sample" and size. If "filename" is not "", image is saved into "filename". Otherwise image data is returned as a string. The optional "format" argument specifies the image format to generate, and supports any format allowed by QPixmap.save(). Common formats are PPM, JPEG, PNG and XPM.

        +

        May raise NotFoundError if the specified font can't be found. May raise ValueError if an empty sample or filename is passed.

        + + + + diff --git a/scribus/doc/it/scripterapi-getobjprop.html b/scribus/doc/it/scripterapi-getobjprop.html new file mode 100644 index 0000000..5fddf98 --- /dev/null +++ b/scribus/doc/it/scripterapi-getobjprop.html @@ -0,0 +1,89 @@ + + + + Getting Object Properties + + +

        Getting Object Properties

        + +
        + +
        getObjectType(...)
        +
        getObjectType(["name"]) -> string +

        Get type of object "name" as a string. If "name" is not given the currently selected item is used.

        + +
        getCornerRadius(...)
        +
        getCornerRadius(["name"]) -> integer +

        Returns the corner radius of the object "name". The radius is expressed in points. If "name" is not given the currently selected item is used.

        + +
        getFillColor(...)
        +
        getFillColor(["name"]) -> string +

        Returns the name of the fill color of the object "name". If "name" is not given the currently selected item is used.

        + +
        getFillBlendmode(...)
        +
        getFillBlendmode(["name"]) -> integer +

        Returns the fill blendmode of the object "name". If "name" is not given the currently selected Item is used.

        + +
        getFillShade(...)
        +
        getFillShade(["name"]) -> integer +

        Returns the shading value of the fill color of the object "name". If "name" is not given the currently selected item is used.

        + +
        getFillTransparency(...)
        +
        getFillTransparency(["name"]) -> float +

        Returns the fill transparency of the object "name". If "name" is not given the currently selected Item is used.

        + +
        getImageFile(...)
        +
        getImageName(["name"]) -> string +

        Returns the filename for the image in the image frame. If "name" is not given the currently selected item is used.

        + +
        getImageScale(...)
        +
        getImageScale(["name"]) -> (x,y) +

        Returns a (x, y) tuple containing the scaling values of the image frame "name". If "name" is not given the currently selected item is used.

        + +
        getLineBlendmode(...)
        +
        getLineBlendmode(["name"]) -> integer +

        Returns the line blendmode of the object "name". If "name" is not given the currently selected Item is used.

        + +
        getLineCap(...)
        +
        getLineEnd(["name"]) -> integer (see constants) +

        Returns the line cap style of the object "name". If "name" is not given the currently selected item is used. The cap types are: CAP_FLAT, CAP_ROUND, CAP_SQUARE

        + +
        getLineColor(...)
        +
        getLineColor(["name"]) -> string +

        Returns the name of the line color of the object "name". If "name" is not given the currently selected item is used.

        + +
        getLineJoin(...)
        +
        getLineJoin(["name"]) -> integer (see contants) +

        Returns the line join style of the object "name". If "name" is not given the currently selected item is used. The join types are: JOIN_BEVEL, JOIN_MITTER, JOIN_ROUND

        + +
        getLineShade(...)
        +
        getLineShade(["name"]) -> integer +

        Returns the shading value of the line color of the object "name". If "name" is not given the currently selected item is used.

        + +
        getLineStyle(...)
        +
        getLineStyle(["name"]) -> integer (see constants) +

        Returns the line style of the object "name". If "name" is not given the currently selected item is used. Line style constants are: LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID

        + +
        getLineTransparency(...)
        +
        getLineTransparency(["name"]) -> float +

        Returns the line transparency of the object "name". If "name" is not given the currently selected Item is used.

        + +
        getLineWidth(...)
        +
        getLineWidth(["name"]) -> integer +

        Returns the line width of the object "name". If "name" is not given the currently selected Item is used.

        + +
        getPosition(...)
        +
        getPosition(["name"]) -> (x,y) +

        Returns a (x, y) tuple with the position of the object "name". If "name" is not given the currently selected item is used. The position is expressed in the actual measurement unit of the document - see UNIT_<type> for reference.

        + +
        getRotation(...)
        +
        getRotation(["name"]) -> integer +

        Returns the rotation of the object "name". The value is expressed in degrees, and clockwise is positive. If "name" is not given the currently selected item is used.

        + +
        getSize(...)
        +
        getSize(["name"]) -> (width,height) +

        Returns a (width, height) tuple with the size of the object "name". If "name" is not given the currently selected item is used. The size is expressed in the current measurement unit of the document - see UNIT_<type> for reference.

        + +
        + + diff --git a/scribus/doc/it/scripterapi-layer.html b/scribus/doc/it/scripterapi-layer.html new file mode 100644 index 0000000..829bb09 --- /dev/null +++ b/scribus/doc/it/scripterapi-layer.html @@ -0,0 +1,109 @@ + + + + Layer related Commands + + +

        Layer related Commands

        + +
        + +
        createLayer(...)
        +
        createLayer(layer) +

        Creates a new layer with the name "name".

        +

        May raise ValueError if the layer name isn't acceptable.

        + +
        deleteLayer(...)
        +
        deleteLayer("layer") +

        Deletes the layer with the name "layer". Nothing happens if the layer doesn't exists or if it's the only layer in the document.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        getActiveLayer(...)
        +
        getActiveLayer() -> string +

        Returns the name of the current active layer.

        + +
        getLayers(...)
        +
        getLayers() -> list +

        Returns a list with the names of all defined layers.

        + +
        getLayerBlendmode(...)
        +
        getLayerBlendmode("layer") -> int +

        Returns the "layer" layer blendmode, May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        isLayerFlow(...)
        +
        isLayerFlow("layer") -> bool +

        Returns whether text flows around objects on layer "layer", a value of True means that text flows around, a value of False means that the text does not flow around.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        isLayerLocked(...)
        +
        isLayerLocked("layer") -> bool +

        Returns whether the layer "layer" is locked or not, a value of True means that the layer "layer" is editable, a value of False means that the layer "layer" is locked.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        getLayerTransparency(...)
        +
        getLayerTransparency("layer") -> float +

        Returns the "layer" layer transparency, May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        isLayerOutlined(...)
        +
        isLayerOutlined("layer") -> bool +

        Returns whether the layer "layer" is outlined or not, a value of True means that the layer "layer" is outlined, a value of False means that the layer "layer" is normal.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        isLayerPrintable(...)
        +
        isLayerPrintable("layer") -> bool +

        Returns whether the layer "layer" is printable or not, a value of True means that the layer "layer" can be printed, a value of False means that printing the layer "layer" is disabled.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        isLayerVisible(...)
        +
        isLayerVisible("layer") -> bool +

        Returns whether the layer "layer" is visible or not, a value of True means that the layer "layer" is visible, a value of False means that the layer "layer" is invisible.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        sentToLayer(...)
        +
        sentToLayer("layer" [, "name"]) +

        Sends the object "name" to the layer "layer". The layer must exist. If "name" is not given the currently selected item is used.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        setActiveLayer(...)
        +
        setActiveLayer("name") +

        Sets the active layer to the layer named "name".

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        setLayerBlendmode(...)
        +
        setLayerBlendmode"layer", blend) +

        Sets the layers "layer" blendmode to blend. May raise NotFoundError if the layer can't be found.

        +

        May raise ValueError if the layer name isn't acceptable.

        + +
        setLayerFlow(...)
        +
        setLayerFlow"layer", flow) +

        Sets the layers "layer" flowcontrol to flow. If flow is set to true text in layers above this one will flow around objects on this layer.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        setLayerLocked(...)
        +
        setLayerLocked("layer", locked) +

        Sets the layer "layer" to be locked or not. If locked is set to true the layer will be locked.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        setLayerOutlined(...)
        +
        setLayerOutlined"layer", outline) +

        Sets the layer "layer" to be locked or not. If outline is set to true the layer will be displayed outlined.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        setLayerPrintable(...)
        +
        setLayerPrintable("layer", printable) +

        Sets the layer "layer" to be printable or not. If is the printable set to false the layer won't be printed.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        setLayerTransparency(...)
        +
        setLayerTransparency"layer", trans) +

        Sets the layers "layer" transparency to trans.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        setLayerVisible(...)
        +
        setLayerVisible("layer", visible) +

        Sets the layer "layer" to be visible or not. If is the visible set to false the layer is invisible.

        +

        May raise NotFoundError if the layer can't be found. May raise ValueError if the layer name isn't acceptable.

        + +
        + + diff --git a/scribus/doc/it/scripterapi-manobj.html b/scribus/doc/it/scripterapi-manobj.html new file mode 100644 index 0000000..0c281a3 --- /dev/null +++ b/scribus/doc/it/scripterapi-manobj.html @@ -0,0 +1,71 @@ + + + + Manipulating Objects + + +

        Manipulating Objects

        + +
        + +
        duplicateObject(...)
        +
        duplicateObject(["name"]) -> string +

        creates a Duplicate of the selected Object (or Selection Group).

        + +
        groupObjects(...)
        +
        groupObjects(list) +

        Groups the objects named in "list" together. "list" must contain the names of the objects to be grouped. If "list" is not given the currently selected items are used.

        + +
        isLocked(...)
        +
        isLocked(["name"]) -> bool +

        Returns true if is the object "name" locked. If "name" is not given the currently selected item is used.

        + +
        lockObject(...)
        +
        lockObject(["name"]) -> bool +

        Locks the object "name" if it's unlocked or unlock it if it's locked. If "name" is not given the currently selected item is used. Returns true if locked.

        + +
        moveObject(...)
        +
        moveObject(dx, dy [, "name"]) +

        Moves the object "name" by dx and dy relative to its current position. The distances are expressed in the current measurement unit of the document (see UNIT constants). If "name" is not given the currently selected item is used. If the object "name" belongs to a group, the whole group is moved.

        + +
        moveObjectAbs(...)
        +
        moveObjectAbs(x, y [, "name"]) +

        Moves the object "name" to a new location. The coordinates are expressed in the current measurement unit of the document (see UNIT constants). If "name" is not given the currently selected item is used. If the object "name" belongs to a group, the whole group is moved.

        + +
        rotateObject(...)
        +
        rotateObject(rot [, "name"]) +

        Rotates the object "name" by "rot" degrees relatively. The object is rotated by the vertex that is currently selected as the rotation point - by default, the top left vertext at zero rotation. Positive values mean counter clockwise rotation when the default rotation point is used. If "name" is not given the currently selected item is used.

        + +
        rotateObjectAbs(...)
        +
        rotateObjectAbs(rot [, "name"]) +

        Sets the rotation of the object "name" to "rot". Positive values mean counter clockwise rotation. If "name" is not given the currently selected item is used.

        + +
        scaleGroup(...)
        +
        scaleGroup(factor [,"name"]) +

        Scales the group the object "name" belongs to. Values greater than 1 enlarge the group, values smaller than 1 make the group smaller e.g a value of 0.5 scales the group to 50 % of its original size, a value of 1.5 scales the group to 150 % of its original size. The value for "factor" must be greater than 0. If "name" is not given the currently selected item is used.

        +

        May raise ValueError if an invalid scale factor is passed.

        + +
        setScaleImageToFrame(...)
        +
        setScaleImageToFrame(scaletoframe, proportional=None, name=<selection>) +

        Sets the scale to frame on the selected or specified image frame to `scaletoframe'. If `proportional' is specified, set fixed aspect ratio scaling to `proportional'. Both `scaletoframe' and `proportional' are boolean.

        +

        May raise WrongFrameTypeError.

        + +
        setStyle(...)
        +
        setStyle("style" [, "name"]) +

        Apply the named "style" to the object named "name". If object name is given, style is applied to the current text selection in object "name". If no object name is given, style is applied on selected object.

        + +
        sizeObject(...)
        +
        sizeObject(width, height [, "name"]) +

        Resizes the object "name" to the given width and height. If "name" is not given the currently selected item is used.

        + +
        unGroupObject(...)
        +
        unGroupObjects("name") +

        Destructs the group the object "name" belongs to.If "name" is not given the currently selected item is used.

        + +
        textFlowMode(...)
        +
        textFlowMode("name" [, state]) +

        Enables/disables "Text Flows Around Frame" feature for object "name". Called with parameters string name and optional int "state" (0 <= state <= 3). Setting "state" to 0 will disable text flow. Setting "state" to 1 will make text flow around object frame. Setting "state" to 2 will make text flow around bounding box. Setting "state" to 3 will make text flow around contour line. If "state" is not passed, text flow is toggled.

        + +
        + + diff --git a/scribus/doc/it/scripterapi-object.html b/scribus/doc/it/scripterapi-object.html new file mode 100644 index 0000000..aee42a0 --- /dev/null +++ b/scribus/doc/it/scripterapi-object.html @@ -0,0 +1,141 @@ + + + + Creating and Destroying Objects + + +

        Creating and Destroying Objects

        + +
        + +
        createCharStyle(...)
        +
        createCharStyle(...) +

        Creates a character style. This function takes the following keyword parameters: +

          +
        • "name" [required] -> name of the char style to create
          • +
        • "font" [optional] -> name of the font to use
          • +
        • fontsize [optional] -> font size to set (double)
          • +
        • "features" [optional] -> nearer typographic details can be defined by a string that might contain the following phrases comma-seperated (without spaces!): +
            +
          • inherit
            • +
          • bold
            • +
          • italic
            • +
          • underline
            • +
          • underlinewords
            • +
          • strike
            • +
          • superscript
            • +
          • subscript
            • +
          • outline
            • +
          • shadowed
            • +
          • allcaps
            • +
          • smallcaps
            • +
          +
          • +
        • "fillcolor" [optional], "fillshade" [optional] -> specify fill options
          • +
        • "strokecolor" [optional], "strokeshade" [optional] -> specify stroke options
          • +
        • baselineoffset [optional] -> offset of the baseline
          • +
        • shadowxoffset [optional], shadowyoffset [optional] -> offset of the shadow if used
          • +
        • outlinewidth [optional] -> width of the outline if used
          • +
        • underlineoffset [optional], underlinewidth [optional] -> underline options if used
          • +
        • strikethruoffset [optional], strikethruwidth [optional] -> strikethru options if used
          • +
        • scaleh [optional], scalev [optional] -> scale of the chars
          • +
        • tracking [optional] -> tracking of the text
          • +
        • "language" [optional] -> language code
          • +
        +

        +
        + +
        createBezierLine(...)
        +
        createBezierLine(list, ["name"]) -> string +

        Creates a new bezier curve and returns its name. The points for the bezier curve are stored in the list "list" in the following order: [x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn] In the points list, x and y mean the x and y coordinates of the point and kx and ky meaning the control point for the curve. The coordinates are given in the current measurement units of the document (see UNIT constants). "name" should be a unique identifier for the object because you need this name for further access to that object. If "name" is not given Scribus will create one for you.

        +

        May raise NameExistsError if you explicitly pass a name that's already used. May raise ValueError if an insufficient number of points is passed or if the number of values passed don't group into points without leftovers.

        + +
        createEllipse(...)
        +
        createEllipse(x, y, width, height, ["name"]) -> string +

        Creates a new ellipse on the current page and returns its name. The coordinates are given in the current measurement units of the document (see UNIT constants). "name" should be a unique identifier for the object because you need this name for further referencing of that object. If "name" is not given Scribus will create one for you.

        +

        May raise NameExistsError if you explicitly pass a name that's already used.

        + +
        createImage(...)
        +
        createImage(x, y, width, height, ["name"]) -> string +

        Creates a new picture frame on the current page and returns its name. The coordinates are given in the current measurement units of the document. "name" should be a unique identifier for the object because you need this name for further access to that object. If "name" is not given Scribus will create one for you.

        +

        May raise NameExistsError if you explicitly pass a name that's already used.

        + +
        createLine(...)
        +
        createLine(x1, y1, x2, y2, ["name"]) -> string +

        Creates a new line from the point(x1, y1) to the point(x2, y2) and returns its name. The coordinates are given in the current measurement unit of the document (see UNIT constants). "name" should be a unique identifier for the object because you need this name for further access to that object. If "name" is not given Scribus will create one for you.

        +

        May raise NameExistsError if you explicitly pass a name that's already used.

        + +
        createParagraphStyle(...)
        +
        createParagraphStyle(...) +

        Creates a paragraph style. This function takes the following keyword parameters: +

          +
        • "name" [required] -> specifies the name of the paragraphstyle to create
          • +
        • linespacingmode [optional] -> specifies the linespacing mode; possible modes are: +
            +
          • fixed linespacing: 0
            • +
          • automatic linespacing: 1
            • +
          • baseline grid linespacing: 2
            • +
          +
          • +
        • linespacing [optional] -> specifies the linespacing if using fixed linespacing
          • +
        • alignment [optional] -> specifies the alignment of the paragraph +
            +
          • left: 0
            • +
          • center: 1
            • +
          • right: 2
            • +
          • justify: 3
            • +
          • extend: 4
            • +
          +
          • +
        • leftmargin [optional], rightmargin [optional] -> specify the margin
          • +
        • gapbefore [optional], gapafter [optional] -> specify the gaps to the heading and following paragraphs
          • +
        • firstindent [optional] -> the indent of the first line
          • +
        • hasdropcap [optional] -> specifies if there are caps (1 = yes, 0 = no)
          • +
        • dropcaplines [optional] -> height (in lines) of the caps if used
          • +
        • dropcapoffset [optional] -> offset of the caps if used
          • +
        • "charstyle" [optional] -> char style to use
          • +
        +

        +
        + +
        createPathText(...)
        +
        createPathText(x, y, "textbox", "beziercurve", ["name"]) -> string +

        Creates a new pathText by merging the two objects "textbox" and "beziercurve" and returns its name. The coordinates are given in the current measurement unit of the document (see UNIT constants). "name" should be a unique identifier for the object because you need this name for further access to that object. If "name" is not given Scribus will create one for you.

        +

        May raise NameExistsError if you explicitly pass a name that's already used. +May raise NotFoundError if one or both of the named base object don't exist.

        + +
        createPolyLine(...)
        +
        createPolyLine(list, ["name"]) -> string +

        Creates a new polyline and returns its name. The points for the polyline are stored in the list "list" in the following order: [x1, y1, x2, y2...xn. yn]. The coordinates are given in the current measurement units of the document (see UNIT constants). "name" should be a unique identifier for the object because you need this name for further access to that object. If "name" is not given Scribus will create one for you.

        +

        May raise NameExistsError if you explicitly pass a name that's already used. May raise ValueError if an insufficient number of points is passed or if the number of values passed don't group into points without leftovers.

        + +
        createPolygon(...)
        +
        createPolygon(list, ["name"]) -> string +

        Creates a new polygon and returns its name. The points for the polygon are stored in the list "list" in the following order: [x1, y1, x2, y2...xn. yn]. At least three points are required. There is no need to repeat the first point to close the polygon. The polygon is automatically closed by connecting the first and the last point. The coordinates are given in the current measurement units of the document (see UNIT constants). "name" should be a unique identifier for the object because you need this name for further access to that object. If "name" is not given Scribus will create one for you.

        +

        May raise NameExistsError if you explicitly pass a name that's already used. May raise ValueError if an insufficient number of points is passed or if the number of values passed don't group into points without leftovers.

        + +
        createRect(...)
        +
        createRect(x, y, width, height, ["name"]) -> string +

        Creates a new rectangle on the current page and returns its name. The coordinates are given in the current measurement units of the document (see UNIT constants). "name" should be a unique identifier for the object because you need this name to reference that object in future. If "name" is not given Scribus will create one for you.

        +

        May raise NameExistsError if you explicitly pass a name that's already used.

        + +
        createText(...)
        +
        createText(x, y, width, height, ["name"]) -> string +

        Creates a new text frame on the actual page and returns its name. The coordinates are given in the actual measurement unit of the document (see UNIT constants). "name" should be a unique identifier for the object because you need this name for further referencing of that object. If "name" is not given Scribus will create one for you.

        +

        May raise NameExistsError if you explicitly pass a name that's already used.

        + +
        deleteObject(...)
        +
        deleteObject(["name"]) +

        Deletes the item with the name "name". If "name" is not given the currently selected item is deleted.

        + +
        getAllStyles(...)
        +
        getAllStyles() -> list +

        Return a list of the names of all paragraph styles in the current document.

        + +
        objectExists(...)
        +
        objectExists(["name"]) -> bool +

        Test if an object with specified name really exists in the document. The optional parameter is the object name. When no object name is given, returns True if there is something selected.

        + +
        + + diff --git a/scribus/doc/it/scripterapi-page.html b/scribus/doc/it/scripterapi-page.html new file mode 100644 index 0000000..f4de47a --- /dev/null +++ b/scribus/doc/it/scripterapi-page.html @@ -0,0 +1,118 @@ + + + + Page related Commands + + +

        Page related Commands

        + +
        + +
        closeMasterPage(...)
        +
        closeMasterPage() +

        Closes the currently active master page, if any, and returns editing +to normal. Begin editing with editMasterPage().

        + +
        createMasterPage(...)
        +
        createMasterPage(pageName) +

        Creates a new master page named pageName and opens it for editing.

        + +
        currentPage(...)
        +
        currentPage() -> integer +

        Returns the number of the current working page. Page numbers are counted from 1 upwards, no matter what the displayed first page number of your document is.

        + +
        deleteMasterPage(...)
        +
        deleteMasterPage(pageName) +

        Delete the named master page.

        + +
        deletePage(...)
        +
        deletePage(nr) +

        Deletes the given page. Does nothing if the document contains only one page. Page numbers are counted from 1 upwards, no matter what the displayed first page number is.

        +

        May raise IndexError if the page number is out of range

        + +
        editMasterPage(...)
        +
        editMasterPage(pageName) +

        Enables master page editing and opens the named master page +for editing. Finish editing with closeMasterPage().

        + +
        getAllObjects(...)
        +
        getAllObjects() -> list +

        Returns a list containing the names of all objects on the current page.

        + +
        getHGuides(...)
        +
        getHGuides() -> list +

        Returns a list containing positions of the horizontal guides. Values are in the +document's current units - see UNIT_<type> constants.

        + +
        getPageType(...)
        +
        getPageType() -> integer +

        Returns the type of the Page, 0 means left Page, 1 is a middle Page and 2 is a right Page

        + +
        getVGuides(...)
        +
        getVGuides() +

        See getHGuides.

        + +
        getPageItems(...)
        +
        getPageItems() -> list +

        Returns a list of tuples with items on the current page. The tuple is: (name, objectType, order) E.g. [('Text1', 4, 0), ('Image1', 2, 1)] means that object named 'Text1' is a text frame (type 4) and is the first at the page...

        + +
        getPageMargins(...)
        +
        getPageMargins() +

        Returns the document page margins as a (top, left, right, bottom) tuple in the document's current units. See UNIT_<type> constants and getPageSize().

        + +
        getPageNMargins(...)
        +
        getPageNMargins(nr) +

        Returns a tuple with a particular page's margins measured in the document's current units. See UNIT_<type> constants and getPageSize().

        + +
        getPageSize(...)
        +
        getPageSize() -> tuple +

        Returns a tuple with document page dimensions measured in the document's current units. See UNIT_<type> constants and getPageMargins()

        + +
        getPageNSize(...)
        +
        getPageNSize(nr) -> tuple +

        Returns a tuple with a particular page's size measured in the document's current units. See UNIT_<type> constants and getPageMargins()

        + +
        gotoPage(...)
        +
        gotoPage(nr) +

        Moves to the page "nr" (that is, makes the current page "nr"). Note that gotoPage doesn't (curently) change the page the user's view is displaying, it just sets the page that script commands will operates on.

        +

        May raise IndexError if the page number is out of range.

        + +
        importPage(...)
        +
        +

        importPage("fromDoc", (pageList), [create, imortwhere, importwherePage]) Imports a set of pages (given as a tuple) from an existing document (the file name must be given). This functions maps the "Page->Import" dropdown menu function. fromDoc: string; the filename of the document to import pages from pageList: tuple with page numbers of pages to import create: number; 0 to replace existing pages, 1 (default) to insert new pages importWhere: number; the page number (of the current document) at which import the pages importWherePage: number; used if create==1; 0 to create pages before selected page; 1 to create pages after selected page; 2 (default) to create pages at the end of the document

        + +
        newPage(...)
        +
        newPage(where [,"masterpage"]) +

        Creates a new page. If "where" is -1 the new Page is appended to the document, otherwise the new page is inserted before "where". Page numbers are counted from 1 upwards, no matter what the displayed first page number of your document is. The optional parameter "masterpage" specifies the name of the master page for the new page.

        +

        May raise IndexError if the page number is out of range

        + +
        pageCount(...)
        +
        pageCount() -> integer +

        Returns the number of pages in the document.

        + +
        redrawAll(...)
        +
        redrawAll() +

        Redraws all pages.

        + +
        savePageAsEPS(...)
        +
        savePageAsEPS("name") +

        Saves the current page as an EPS to the file "name".

        +

        May raise ScribusError if the save failed.

        + +
        setHGuides(...)
        +
        setHGuides(list) +

        Sets horizontal guides. Input parameter must be a list of guide positions measured in the current document units - see UNIT_<type> constants.

        +

        Example: setHGuides(getHGuides() + [200.0, 210.0] # add new guides without any lost
        +setHGuides([90,250]) # replace current guides entirely

        + +
        setRedraw(...)
        +
        setRedraw(bool) +

        Disables page redraw when bool = False, otherwise redrawing is enabled. This change will persist even after the script exits, so make sure to call setRedraw(True) in a finally: clause at the top level of your script.

        + +
        setVGuides(...)
        +
        setVGuides() +

        See setHGuides.

        + +
        + + diff --git a/scribus/doc/it/scripterapi-select.html b/scribus/doc/it/scripterapi-select.html new file mode 100644 index 0000000..1c81936 --- /dev/null +++ b/scribus/doc/it/scripterapi-select.html @@ -0,0 +1,37 @@ + + + + Selecting Objects + + +

        Selecting Objects

        + +
        + +
        deselectAll(...)
        +
        deselectAll() +

        Deselects all objects in the whole document.

        + +
        getSelectedObject(...)
        +
        getSelectedObject([nr]) -> string +

        Returns the name of the selected object. "nr" if given indicates the number of the selected object, e.g. 0 means the first selected object, 1 means the second selected Object and so on.

        + +
        moveSelectionToBack(...)
        +
        moveSelectionToBack() +

        Moves the current selection to the back.

        + +
        moveSelectionToFront(...)
        +
        moveSelectionToFront() +

        Moves the current selection to the front.

        + +
        selectionCount(...)
        +
        selectionCount() -> integer +

        Returns the number of selected objects.

        + +
        selectObject(...)
        +
        selectObject("name") +

        Selects the object with the given "name".

        + +
        + + diff --git a/scribus/doc/it/scripterapi-setobjprop.html b/scribus/doc/it/scripterapi-setobjprop.html new file mode 100644 index 0000000..cac62d7 --- /dev/null +++ b/scribus/doc/it/scripterapi-setobjprop.html @@ -0,0 +1,116 @@ + + + + Setting Object Properties + + +

        Setting Object Properties

        + +
        + +
        linkTextFrames(...)
        +
        linkTextFrames("fromname", "toname") +

        Link two text frames. The frame named "fromname" is linked to the frame named "toname". The target frame must be an empty text frame and must not link to or be linked from any other frames already.

        +

        May throw ScribusException if linking rules are violated.

        + +
        loadImage(...)
        +
        loadImage("filename" [, "name"]) +

        Loads the picture "picture" into the image frame "name". If "name" is not given the currently selected item is used.

        +

        May raise WrongFrameTypeError if the target frame is not an image frame

        + +
        setFillBlendmode(...)
        +
        setFillBlendmode(blendmode, ["name"]) +

        Sets the fill blendmode of the object "name" to blendmode is the name of one of the defined colors. If "name" is not given the currently selected item is used.

        + +
        setCornerRadius(...)
        +
        setCornerRadius(radius, ["name"]) +

        Sets the corner radius of the object "name". The radius is expressed in points. If "name" is not given the currently selected item is used.

        +

        May raise ValueError if the corner radius is negative.

        + +
        setFillColor(...)
        +
        setFillColor("color", ["name"]) +

        Sets the fill color of the object "name" to the color "color". "color" is the name of one of the defined colors. If "name" is not given the currently selected item is used.

        + +
        setFillShade(...)
        +
        setFillShade(shade, ["name"]) +

        Sets the shading of the fill color of the object "name" to "shade". "shade" must be an integer value in the range from 0 (lightest) to 100 (full Color intensity). If "name" is not given the currently selected Item is used.

        +

        May raise ValueError if the fill shade is out of bounds.

        + +
        setFillTransparency(...)
        +
        setFillTransparency(transparency, ["name"]) +

        Sets the fill transparency of the object "name" to transparency is the name of one of the defined colors. If "name" is not given the currently selected item is used.

        + +
        setLineBlendmode(...)
        +
        setLineBlendmode(blendmode, ["name"]) +

        Sets the line blendmode of the object "name" to blendmode is the name of one of the defined colors. If "name" is not given the currently selected item is used.

        + +
        setLineTransparency(...)
        +
        setLineTransparency(transparency, ["name"]) +

        Sets the line transparency of the object "name" to transparency is the name of one of the defined colors. If "name" is not given the currently selected item is used.

        + +
        setGradientFill(...)
        +
        setGradientFill(type, "color1", shade1, "color2", shade2, ["name"]) +

        Sets the gradient fill of the object "name" to type. Color descriptions are the same as for setFillColor() and setFillShade(). See the constants for available types (FILL_<type>).

        + +
        setGradientStop(...)
        +
        setGradientStop("color", shade, opacity, ramppoint, ["name"]) +

        Set or add a gradient stop to the gradient fill of the object \"name\" at position ramppoint. Color descriptions are the same as for setFillColor() and setFillShade(). setGradientFill() must have been called previously for the gradient fill to be visible.

        + +
        setLineCap(...)
        +
        setLineCap(captype, ["name"]) +

        Sets the line cap style of the object "name" to the style "cap". If "name" is not given the currently selected item is used. There are predefined constants for "cap" - CAP_<type>.

        + +
        setLineColor(...)
        +
        setLineColor("color", ["name"]) +

        Sets the line color of the object "name" to the color "color". If "name" is not given the currently selected item is used.

        + +
        setMultiLine(...)
        +
        setMultiLine("namedStyle", ["name"]) +

        Sets the line style of the object "name" to the named style "namedStyle". If "name" is not given the currently selected item is used.

        +

        May raise NotFoundError if the line style doesn't exist.

        + +
        setLineJoin(...)
        +
        setLineJoin(join, ["name"]) +

        Sets the line join style of the object "name" to the style "join". If "name" is not given the currently selected item is used. There are predefined constants for join - JOIN_<type>.

        + +
        setLineShade(...)
        +
        setLineShade(shade, ["name"]) +

        Sets the shading of the line color of the object "name" to "shade". "shade" must be an integer value in the range from 0 (lightest) to 100 (full color intensity). If "name" is not given the currently selected item is used.

        +

        May raise ValueError if the line shade is out of bounds.

        + +
        setLineStyle(...)
        +
        setLineStyle(style, ["name"]) +

        Sets the line style of the object "name" to the style "style". If "name" is not given the currently selected item is used. There are predefined constants for "style" - LINE_<style>.

        + +
        setLineWidth(...)
        +
        setLineWidth(width, ["name"]) +

        Sets line width of the object "name" to "width". "width" must be in the range from 0.0 to 12.0 inclusive, and is measured in points. If "name" is not given the currently selected item is used.

        +

        May raise ValueError if the line width is out of bounds.

        + +
        scaleImage(...)
        +
        scaleImage(x, y [, "name"]) +

        Sets the internal scaling factors of the picture in the image frame "name". If "name" is not given the currently selected item is used. A number of 1 means 100 %. Internal scaling factors are different from the values shown on properties palette. Note : deprecated, use setImageScale() instead.

        +

        May raise WrongFrameTypeError if the target frame is not an image frame

        + +
        setImageScale(...)
        +
        setImageScale(x, y [, "name"]) +

        Sets the scaling factors of the picture in the image frame "name". If "name" is not given the currently selected item is used. A number of 1 means 100 %. Scaling factors are equal to the values shown on properties palette.

        +

        May raise WrongFrameTypeError if the target frame is not an image frame

        + +
        setImageOffset(...)
        +
        setImageOffset(x, y [, "name"]) +

        Sets the position of the picture in the image frame "name". If "name" is not given the currently selected item is used. The specified offset values are equal to the values shown on properties palette when point unit is used.

        +

        May raise WrongFrameTypeError if the target frame is not an image frame

        + +
        traceText(...)
        +
        traceText(["name"]) +

        Convert the text frame "name" to outlines. If "name" is not given the currently selected item is used.

        + +
        unlinkTextFrames(...)
        +
        unlinkTextFrames("name") +

        Remove the specified (named) object from the text frame flow/linkage. If the frame was in the middle of a chain, the previous and next frames will be connected, eg 'a->b->c' becomes 'a->c' when you unlinkTextFrames(b)'

        +

        May throw ScribusException if linking rules are violated.

        + +
        + + diff --git a/scribus/doc/it/scripterapi-textframes.html b/scribus/doc/it/scripterapi-textframes.html new file mode 100644 index 0000000..3654890 --- /dev/null +++ b/scribus/doc/it/scripterapi-textframes.html @@ -0,0 +1,163 @@ + + + + Handling Text Frames + + +

        Handling Text Frames

        + +
        + +
        dehyphenateText(...)
        +
        dehyphenateText(["name"]) -> bool +

        Does dehyphenation on text frame "name". If "name" is not given the currently selected item is used.

        +

        May raise WrongFrameTypeError if the target frame is not a text frame

        + +
        deleteText(...)
        +
        deleteText(["name"]) +

        Deletes any text in the text frame "name". If there is some text selected, only the selected text will be deleted. If "name" is not given the currently selected item is used.

        + +
        getAllText(...)
        +
        getAllText(["name"]) -> string +

        Returns the text of the text frame "name" and of all text frames which are linked with this frame. If this textframe has some text selected, the selected text is returned. If "name" is not given the currently selected item is used.

        + +
        getColumnGap(...)
        +
        getColumnGap(["name"]) -> float +

        Returns the column gap size of the text frame "name" expressed in points. If "name" is not given the currently selected item is used.

        + +
        getColumns(...)
        +
        getColumns(["name"]) -> integer +

        Gets the number of columns of the text frame "name". If "name" is not given the currently selected item is used.

        + +
        getFont(...)
        +
        getFont(["name"]) -> string +

        Returns the font name for the text frame "name". If this text frame has some text selected the value assigned to the first character of the selection is returned. If "name" is not given the currently selected item is used.

        + +
        getFontSize(...)
        +
        getFontSize(["name"]) -> float +

        Returns the font size in points for the text frame "name". If this text frame has some text selected the value assigned to the first character of the selection is returned. If "name" is not given the currently selected item is used.

        + +
        getLineSpacing(...)
        +
        getLineSpacing(["name"]) -> float +

        Returns the line spacing ("leading") of the text frame "name" expressed in points. If "name" is not given the currently selected item is used.

        + +
        getText(...)
        +
        getText(["name"]) -> string +

        Returns the text of the text frame "name". If this text frame has some text selected, the selected text is returned. All text in the frame, not just currently visible text, is returned. If "name" is not given the currently selected item is used.

        + +
        getTextColor(...)
        +
        getLineColor(["name"]) -> string +

        Returns the name of the line color of the object "name". If "name" is not given the currently selected item is used.

        + +
        getTextDistances(...)
        +
        getTextDistances(["name"]) -> tuple +

        Returns the text distances of the text frame "name" expressed in points. The +distances are returned as a tuple like (left, right, top, bottom). If "name" +is not given the currently selected item is used.

        + +
        getTextLength(...)
        +
        getTextLength(["name"]) -> integer +

        Returns the length of the text in the text frame "name". If "name" is not given the currently selected item is used.

        + +
        getTextLines(...)
        +
        getTextLines(["name"]) -> integer +

        Returns the number of lines of the text in the text frame "name". If "name" is not given the currently selected item is used.

        + +
        getTextShade(...)
        +
        getLineShade(["name"]) -> integer +

        Returns the shading value of the line color of the object "name". If "name" is not given the currently selected item is used.

        + +
        hyphenateText(...)
        +
        hyphenateText(["name"]) -> bool +

        Does hyphenation on text frame "name". If "name" is not given the currently selected item is used.

        +

        May raise WrongFrameTypeError if the target frame is not a text frame

        + +
        insertText(...)
        +
        insertText("text", pos, ["name"]) +

        Inserts the text "text" at the position "pos" into the text frame "name". Text must be UTF encoded (see setText() as reference) The first character has an index of 0. Inserting text at position -1 appends it to the frame. If "name" is not given the currently selected Item is used.

        +

        May throw IndexError for an insertion out of bounds.

        + +
        isPDFBookmark(...)
        +
        isPDFBookmark(["name"]) -> bool +

        Returns true if the text frame "name" is a PDF bookmark. If "name" is not given the currently selected item is used.

        +

        May raise WrongFrameTypeError if the target frame is not a text frame

        + +
        selectText(...)
        +
        selectText(start, count, ["name"]) +

        Selects "count" characters of text in the text frame "name" starting from the character "start". Character counting starts at 0. If "count" is zero, any text selection will be cleared. If "name" is not given the currently selected item is used.

        +

        May throw IndexError if the selection is outside the bounds of the text.

        + +
        setColumns(...)
        +
        setColumns(nr, ["name"]) +

        Sets the number of columns of the text frame "name" to the integer "nr". If "name" is not given the currently selected item is used.

        +

        May throw ValueError if number of columns is not at least one.

        + +
        setColumnGap(...)
        +
        setColumnGap(size, ["name"]) +

        Sets the column gap of the text frame "name" to the value "size". If "name" is not given the currently selected item is used.

        +

        May throw ValueError if the column gap is out of bounds (must be positive).

        + +
        setFont(...)
        +
        setFont("font", ["name"]) +

        Sets the font of the text frame "name" to "font". If there is some text selected only the selected text is changed. If "name" is not given the currently selected item is used.

        +

        May throw ValueError if the font cannot be found.

        + +
        setFontSize(...)
        +
        setFontSize(size, ["name"]) +

        Sets the font size of the text frame "name" to "size". "size" is treated as a value in points. If there is some text selected only the selected text is changed. "size" must be in the range 1 to 512. If "name" is not given the currently selected item is used.

        +

        May throw ValueError for a font size that's out of bounds.

        + +
        setLineSpacing(...)
        +
        setLineSpacing(size, ["name"]) +

        Sets the line spacing ("leading") of the text frame "name" to "size". "size" is a value in points. If "name" is not given the currently selected item is used.

        +

        May throw ValueError if the line spacing is out of bounds.

        + +
        setPDFBookmark(...)
        +
        setPDFBookmark("toggle", ["name"]) +

        Sets wether (toggle = 1) the text frame "name" is a bookmark nor not. If "name" is not given the currently selected item is used.

        +

        May raise WrongFrameTypeError if the target frame is not a text frame

        + +
        setText(...)
        +
        setText("text", ["name"]) +

        Sets the text of the text frame "name" to the text of the string "text". Text must be UTF8 encoded - use e.g. unicode(text, 'iso-8859-2'). See the FAQ for more details. If "name" is not given the currently selected item is used.

        + +
        setTextAlignment(...)
        +
        setTextAlignment(align, ["name"]) +

        Sets the text alignment of the text frame "name" to the specified alignment. If "name" is not given the currently selected item is used. "align" should be one of the ALIGN_ constants defined in this module - see dir(scribus).

        +

        May throw ValueError for an invalid alignment constant.

        + +
        setTextDistances(...)
        +
        setTextDistances(left, right, top, bottom, ["name"]) +

        Sets the text distances of the text frame "name" to the values "left" +"right", "top" and "bottom". If "name" is not given the currently +selected item is used.

        +

        May throw ValueError if any of the distances are out of bounds (must be positive).

        + +
        setTextScalingH(...)
        +
        setTextScalingH(scale, ["name"])) +

        Sets the horizontal character scaling of the object "name" to "scale" in percent. If "name" is not given the currently selected item is used.

        + +
        setTextScalingV(...)
        +
        setTextScalingV(scale, ["name"])) +

        Sets the vertical character scaling of the object "name" to "scale" in percent. If "name" is not given the currently selected item is used.

        + +
        setTextColor(...)
        +
        setTextColor("color", ["name"]) +

        Sets the text color of the text frame "name" to the color "color". If there is some text selected only the selected text is changed. If "name" is not given the currently selected item is used.

        + +
        setTextShade(...)
        +
        setTextShade(shade, ["name"]) +

        Sets the shading of the text color of the object "name" to "shade". If there is some text selected only the selected text is changed. "shade" must be an integer value in the range from 0 (lightest) to 100 (full color intensity). If "name" is not given the currently selected item is used.

        + +
        setTextStroke(...)
        +
        setTextStroke("color", ["name"]) +

        Set "color" of the text stroke. If "name" is not given the currently selected item is used.

        + +
        textOverflows(...)
        +
        textOverflows(["name", nolinks]) -> integer +

        Returns 1 if there are overflowing characters in text frame "name", 0 if not. If is nolinks set to non zero value it takes only one frame - it doesn't use text frame linking. Without this parameter it search all linking chain.

        +

        May raise WrongFrameTypeError if the target frame is not an text frame

        + +
        + + diff --git a/scribus/doc/it/scripterapi.html b/scribus/doc/it/scripterapi.html new file mode 100644 index 0000000..73c4733 --- /dev/null +++ b/scribus/doc/it/scripterapi.html @@ -0,0 +1,120 @@ + + + + The Available Commands + + +

        The Available Commands

        + +

        The Plugin installs a builtin Module "scribus". Thus to use the extensions to the Python language you must do a "import scribus" or "from scribus import *".

        + +

        Scripter provides functions to control scribus and to manipulate objects on the canvas. Each function is documented individually below. A few things are common across most of the interface. Most functions operate on frames. Frames are identified by their name, a string - they are not real Python objects. Many functions take an optional (non-keyword) parameter, a frame name. Many exceptions are also common across most functions. These are not currently documented in the docstring for each function.

        +
          +
        • Many functions will raise a NoDocOpenError if you try to use them without a document to operate on.
          • +
        • If you do not pass a frame name to a function that requires one, the function will use the currently selected frame, if any, or raise a NoValidObjectError if it can't find anything to operate on.
          • +
        • Many functions will raise WrongFrameTypeError if you try to use them on a frame type that they do not make sense with. For example, setting the text color on a graphics frame doesn't make sense, and will result in this exception being raised.
          • +
        • Errors resulting from calls to the underlying Python API will be passed through unaltered. As such, the list of exceptions thrown by any function as provided here and in its docstring is incomplete.
          • +
        +

        Details of what exceptions each function may throw are provided on the function's documentation.

        + +

        Conventions used in this Document:

        +
        +
        number
        +
        means that "number" is an ordinary Interger or Floating Point Number.
        +
        "name"
        +
        means that "name" is a String Literal or Variable.
        +
        list
        +
        means that "list" is a Python List.
        +
        +

        Variables in angled Brackets are optional.

        + +

        Exceptions

        + +
        +
        exceptions.Exception
        +
        +
        ScribusException
        +
        +
        NameExistsError
        +
        NoDocOpenError
        +
        NoValidObjectError
        +
        NotFoundError
        +
        WrongFrameTypeError
        +
        +
        +
        +
        +
        + +

        NameExistsError

        +class NameExistsError(ScribusException) +
        Method resolution order:
        +
        NameExistsError
        +
        ScribusException
        +
        exceptions.Exception
        +
        +Methods inherited from exceptions.Exception:
        +
        __getitem__(...)
        +
        __init__(...)
        +
        __str__(...)
        + +

        NoDocOpenError

        +class NoDocOpenError(ScribusException) +
        Method resolution order:
        +
        NoDocOpenError
        +
        ScribusException
        +
        exceptions.Exception
        +
        +Methods inherited from exceptions.Exception:
        +
        __getitem__(...)
        +
        __init__(...)
        +
        __str__(...)
        + +

        NoValidObjectError

        +class NoValidObjectError(ScribusException) +
        Method resolution order:
        +
        NoValidObjectError
        +
        ScribusException
        +
        exceptions.Exception
        +
        +Methods inherited from exceptions.Exception:
        +
        __getitem__(...)
        +
        __init__(...)
        +
        __str__(...)
        + +

        NotFoundError

        +class NotFoundError(ScribusException) +
        Method resolution order:
        +
        NotFoundError
        +
        ScribusException
        +
        exceptions.Exception
        +
        +Methods inherited from exceptions.Exception:
        +
        __getitem__(...)
        +
        __init__(...)
        +
        __str__(...)
        + +

        ScribusException

        +class ScribusException(exceptions.Exception) +Methods inherited from exceptions.Exception:
        +
        __getitem__(...)
        +
        __init__(...)
        +
        __str__(...)
        + +

        WrongFrameTypeError

        +class WrongFrameTypeError(ScribusException) +
        +
        Method resolution order:
        +
        WrongFrameTypeError
        +
        ScribusException
        +
        exceptions.Exception
        +
        +Methods inherited from exceptions.Exception:
        +
        +
        __getitem__(...)
        +
        __init__(...)
        +
        __str__(...)
        +
        + + + diff --git a/scribus/doc/it/short-words.html b/scribus/doc/it/short-words.html index 13775ab..055748b 100644 --- a/scribus/doc/it/short-words.html +++ b/scribus/doc/it/short-words.html @@ -21,7 +21,7 @@
      • tutti gli elementi - applica gli spazi protetti all'intero documento.
      -

      La parte inferiore (“Impostazioni lingua”) sembra più, ma concettualmente è un po' più complicata. L'impostazione predefinita (”Usa la stessa lingua dello stile”) significa che Scribus userà o le impostazioni della lingua di sistema, o le impostazioni della lingua di Scribus, o le impostazioni della lingua di un certo stile, e il successivo prevale sempre sul precedente. Se disabilitate l'impostazione predefinita, potete far sì che Scribus appliche le mregole di una lingua diversa, ma (così come per le impostazioni di sistema, di Scribus e di stile) Scribus deve avere a disposizione le informazioni corrette sulla lingua che volete utilizzare. Se per una certa lingua non esiste una configurazione, dovrete crearla.

      +

      La parte inferiore (“Impostazioni lingua”) sembra più semplice, ma concettualmente è un po' più complicata. L'impostazione predefinita (”Usa la stessa lingua dello stile”) significa che Scribus userà o le impostazioni della lingua di sistema, o le impostazioni della lingua di Scribus, o le impostazioni della lingua di un certo stile, e il successivo prevale sempre sul precedente. Se disabilitate l'impostazione predefinita, potete far sì che Scribus appliche le mregole di una lingua diversa, ma (così come per le impostazioni di sistema, di Scribus e di stile) Scribus deve avere a disposizione le informazioni corrette sulla lingua che volete utilizzare. Se per una certa lingua non esiste una configurazione, dovrete crearla.

      Configurare il plugin Parole Brevi

      il plugin Parole Brevi utilizza un file di configurazione globale chiamato scribus-short-words.rc, che di solito si trova nella directory $prefix/lib/scribus/plugins (la directory effettiva può essere diversa, a seconda del sistema operativo e/o della posizione in cui Scribus è stato installato dalla vostra distribuzione o da voi). La struttura del file di configurazione è piuttosto semplice e non ha bisogno di molte spiegazioni: contiene un elenco di abbreviazioni per una data lingua, precedute o seguite da uno spazio e separate da virgole. La posizione dello spazio, prima o dopo un'abbreviazione, indica al plugin dove lo spazio protetto deve essere inserito. Ciascuna riga contenente le impostazioni deve iniziare con l'indicazione della lingua a cui si riferisce, quindi ad esempio en per l'inglese o cs per il ceco:

      diff --git a/scribus/doc/it/specs.html b/scribus/doc/it/specs.html new file mode 100644 index 0000000..cf9a558 --- /dev/null +++ b/scribus/doc/it/specs.html @@ -0,0 +1,540 @@ + + + + Scribus 1.4 Data Sheet + + +

      Scribus 1.4 Data Sheet


      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Supported Operating SystemsLinux, FreeBSD, NetBSD, OpenBSD, Solaris, OpenSolaris, Nexenta, Mac OS X 10.5 or later, OS/2 Warp 4, eComStation 1 or later, Windows 2000 or later
      UI Languages25
      Import Filters
      TextOpen Document Text (ODT), OpenOffice.org Writer 1 (SXW), HTML, MS Word (DOC), Comma Separated Values (CSV), Plain Text in various encodings.
      BitmapDesktop Color Separations (DCS), Encapsulated PostScript (EPS), Graphics Interchange Format (GIF), JPEG, Portable Networks Graphic (PNG), Photoshop Document (PSD), Tagged Image File Format (TIFF), Windows and OS/2 Bitmap (BMP), X PixMap (XPM)
      VectorAdobe Illustrator (AI), Calamus Vector Graphics (CVG), Dia Shapes (SHAPE), Encapsulated PostScript (EPS), Kivio Stencils (SML), OpenDocument Graphics (ODG), OpenOffice.org Draw (SXD), Macintosh PICT File (PICT), PostScript (PS), Scalable Vector Graphics (SVG, SVGZ), Scribus Objects (SCE), Windows Metafile (WMF), Xfig (FIG)
      Color PalettesAdobe Illustrator (AI), Encapsulated PostScript (EPS), GIMP Palette (GPL), OpenDocument Swatch (SOC), PostScript (PS), Scribus Palette (XML)
      OtherPDF (direct opening and import into image frames), Scribus Unicode Glyph Palette (UCP)
      Export Filters:
      PDF:1.3, 1.4, 1.5, X-3
      PostScript:Level 2, 3
      Vector:Encapsulated PostScript (EPS), Scalable Vector Graphics (SVG, SVGZ)
      Bitmap:BMP, BW, EPS, ICO, JP2, JPEG, PCX, PIC, PNG, PPM, RGB, RGBA, SGI, TGA, TIFF, XBM, XPM, XV
      Text:Plain Text
      Native File FormatsSLA (XML-based Plain Text), SLA.GZ (Compressed SLA)
      Layout/Page Management
      Preset Margin Layouts✓
      Master Pages✓
      Grids/Guides✓/✓
      Page Palette✓
      Layers✓
      Page Import✓
      Flexible Page Numbering✓
      Individual Page Layout/Dimensions✓/✓
      Table of Contents✓
      Bookmarks✓
      Text/Typography
      Paragraph/Character Styles✓/✓
      Style Manager✓
      Glyph ScalingManual/Automatic
      Character/Word Tracking✓/✓
      Glyph Extension✓
      Optical MarginsLeft, Right
      Drop Caps✓
      First Line OffsetMaximum Ascent, Font Ascent, Line Spacing
      Baseline Grid✓
      Indent/Tabulators✓/✓
      Columns/Text Distance from Frame✓/✓
      Text Flow around ObjectsAutomatic/Flexible
      Hyphenation ControlLanguage-based, Consecutive Hyphenations, Smallest Word, Exception List, Ignore List
      Spellcheck✓1
      Linebreak Control for Abbreviations✓
      Inline Objects✓
      Supported Font FormatsType 1 (Mac and PC), TrueType, OpenType
      Font Management✓
      Font Previewer✓
      Control Characters✓
      Integrated Text Editor (Story Editor)✓
      Glyph Collections✓
      Tables✓
      Text along Path✓
      Bitmap Images
      RGB/CMYK/Spot Color✓/✓/✓
      Support for Embedded Clipping Paths✓
      Support for Layers/Blend Modes✓/✓
      Non-destructive Image Effects✓
      Image Manager✓
      EXIF Support✓
      Configurable Preview Resolution✓
      Assignment of Color Profiles to Individual Image Frames✓
      Launcher for External Image Editor✓
      Vector Graphics
      Import as Vector✓
      Import as Image✓2
      Color Import✓
      Drawing ToolsStraight Lines, Bézier Curves, Freehand Lines, Shape Library
      Line Styles/Line Style Editor✓/✓
      Path ToolsLens Effects, Mesh Distortion, Path Along Path, Connect Paths, Cut Polygon, Boolean Path Operations, Path from Stroke, Subdivide Path
      Text Import✓3
      Object Handling
      Duplicate/Multiple Duplicate/Transform✓/✓/✓
      Editable Frame Shapes✓
      Property-based Multiple Select✓
      Undo/Redo✓
      Action Manager✓
      Object Browser✓
      Align/Distribute/Mirror/Rotate✓/✓/✓/✓
      Scratch Space around Pages✓
      Configurable Rulers✓
      Scrapbook for Reuseable Objects✓
      Measuring Tool✓
      FillSolid Colors, Gradients (Horizontal, Vertical, Diagonal, Cross, Radial), Patterns (Bitmap and Vector)
      Color Palette Management✓
      Solid/Spot Color PalettesMore than 150 color palettes, including Open Source Palettes, National/Government Standards, Resene® Colors, Crayola® Colors, GCMI Colors, dtp studio collection
      Frame Type Conversion✓
      Transparency/Blend Modes✓/✓
      Grouping/Locking/Combining of Objects✓/✓/✓
      Support for Traditional Measuring UnitsCicero, Pica
      Pre-Press/Printing
      RGB/CMYK/Spot Colors✓/✓/✓
      Color Management✓
      Printer Emulation on Screen✓
      Out-of-Gamut Warning✓
      Emulation of Color Blindness✓
      Knockout/Overprinting✓/✓
      Color Separations✓
      Printing Marks✓
      Print/Separation Preview✓/✓
      Display of Ink Coverage✓
      Under Color Removal✓
      Document Bleed✓
      Font Embedding Control✓
      Preflight Verifier✓
      Collect for Output✓
      Scripting
      Supported LanguagesPython
      Scripting Console✓
      Ready-to-Use Scripts via UI✓
      Sample Scripts✓
      Other Features
      Render Frames to Render Markup Languages Inside ScribusPre-configured for LaTeX, Lilypond, Gnuplot, GraphViz, POV-Ray
      PDF-Forms✓
      PDF JavaScript✓
      PDF Presentations✓
      PDF Encryption✓
      PDF/EPS Embedding in PDF Files✓
      Color Wheel to Create Color Harmonies✓
      Barcode Generator✓
      Dublin Core Metadata Support✓
      Documentation/Support
      Tooltips✓
      Integrated Help/
      Searchable/Bookmarks      		✓/✓/✓
      Printed Manual✓4
      Templates✓
      Architecture
      Programming LanguageC++ (some portions from third parties are written in C)
      Underlying UI ToolkitQt 4.6 or later
      DependenciesSee the list of requirements
      Plug-in Interface✓
      +
      +

      1 Not available on OS/2, eComStation and Windows.

      +

      2 EPS and PostScript only.

      +

      3 AI and EPS only.

      +

      4 For the previous version. An update is being worked on.

      +
      +

      License: GPL 2 with exceptions

      + + + diff --git a/scribus/doc/it/toolbox.html b/scribus/doc/it/toolbox.html new file mode 100644 index 0000000..a772ab8 --- /dev/null +++ b/scribus/doc/it/toolbox.html @@ -0,0 +1,12 @@ + + + + +La cassetta degli attrezzi del DTP + + +

      La cassetta degli attrezzi del DTP

      + +

      Come avete giàimparato, il desktop publishing consiste principalmente nell'assemblare contenuti creati in altri programmi. In questa parte della guida presentiamo una selezione di strumenti affidabili, consigliati dagli sviluppatori per l'uso con Scribus.

      + + diff --git a/scribus/doc/it/toolbox1.html b/scribus/doc/it/toolbox1.html new file mode 100644 index 0000000..9d9e06e --- /dev/null +++ b/scribus/doc/it/toolbox1.html @@ -0,0 +1,23 @@ + + +         +        Adobe Reader  + + +

      Adobe Reader

      + +

      Adobe Reader è uno degli strumenti essenziali da usare con Scribus. Serve principalmente per visualizzare documenti, ma ha alcune funzioni avanzate che non sono presenti in alcun altro visualizzatore PDF, come la piena capacità di eseguire JavaScript con documenti PDF e quella di fornire informazioni dettagliate incluse nel PDF e visualizzabili soltanto in Adobe Reader.

      + +

      In generale, non consigliamo di valutare la correttezza del colore nell'applicazione Anteprima di Mac o nei visualizzatori PDF open source.

      + +

      Inoltre, anche se il PDF è divenuto uno standard ISO, la Adobe ha inventato il PostScript e il PDF, che è basato sul PostScript, e ha un incentivo commerciale a promuovere il PDF e il rispetto degli standard su tutte le piattaforme.

      +

      Suggerimenti per gli utenti di Scribus:

      +

      Consigliamo fortemente di aggiornarvi alla più recente versione di Adobe Reader. In poche parole, non esiste nient'altro con migliori capacità di visualizzare correttamente i documenti PDF. Per quante obiezioni possiate avere nei confronti delle versioni più vecchie (e ve n'erano di sostanziali, soprattutto su Linux), nelle versioni successive, specialmente dopo la 7.0.9, la grande maggioranza dei problemi è risolta. E anche se spesso è liquidato come “divora-risorse”, è molto più stabile, contiene meno errori e viene caricato più velocemente rispetto alle versioni più vecchie. Su Linux ora ha un aspetto moderno. Le versioni dopo la 7.0.9 sono in grado di stampare direttamente tramite CUPS e offrono molte opzioni aggiuntive per la stampa. Se riscontrate problemi con documenti PDF generati da Scribus quando vengono aperti in altri visualizzatori, dovreste controllare se sono presenti anche su Reader 7 o successivo, prima di considerarli errori e segnalarli al team di Scribus.

      +

      Uno dei principali vantaggi delle più recenti versioni di Adobe Reader è la capacità di “appiattire” le trasparenze nei file PDF 1.4+. Questa caratteristica è importante, perché vi sono tipografie non in grado di stampare PDF con trasparenze; inoltre lo standard PDF/X-3, che oggi è richiesto da molte tipografie, non consente l'uso di trasparenze. Anche se l'appiattimento da PDF a PDF è presente solo in Adobe Acrobat, Adobe Reader permette di creare un file PostScript “appiattito” tramite la finestra di dialogo di stampa. Il file PostScript così ottenuto può essere riconvertito in PDF con GSview o con uno strumento da riga di comando.

      +

      Problemi noti

      +

      Siamo informati che possono verificarsi errate corrispondenze di colore quando si visualizzano PDF con qualche tipo di trasparenza in file PDF 1.4+. La Adobe è stata informata di questo problema.

      +

      Dovreste sempre fare in modo che le vostre applicazioni siano aggiornate alla versione più recente, per far sì che il vostro sistema sia sicuro. Il formato PDF offre grandi vantaggi, ma è divenuto obiettivo di creatori di software maligno e attacchi via JavaScript. In base alla vostra situazione, potrebbe essere consigliabile disabilitare l'esecuzione di JavaScript nei vostri visualizzatori PDF quando questa funzione non vi serve.

      +

      Nota per gli utenti di OS/2 ed eComStation

      +

      Purtroppo la Adobe non fornisce più nuove versioni di Adobe Reader per OS/2. L'ultima versione che, a quanto risulta, funziona su queste piattaforme è la 5.1, e richiede un ambiente di runtime aggiuntivo. L'ambiente di runtime può essere prelevato qui. Il programma di installazione di AR si trova qui.

      + + diff --git a/scribus/doc/it/toolbox12.html b/scribus/doc/it/toolbox12.html new file mode 100644 index 0000000..5506c22 --- /dev/null +++ b/scribus/doc/it/toolbox12.html @@ -0,0 +1,39 @@ + + + + A little WINE with Scribus + + +

      A little WINE with Scribus

      +

      Overview

      +

      One of the facts of life in the desktop publishing world, is the occasional need for working in a cross platform environment. Fortunately, for Linux users in particular, the Wine Project and Codeweavers have made much progress in being able to successfully run many Windows applications on top of Linux.

      +

      My main interest and focus for these notes is being able to run the latest versions of Adobe Acrobat Reader and the full version of Acrobat, in order to test Scribus created PDF files, as well as occasionally running the odd Windows or DOS based utility.

      +

      Since migrating my own personal workstation to Linux as my default environment, I have dabbled with installing various Windows apps and kept a eye on this project for several reasons:

      +
      1. Until the recent enhancements to Gnucash, I needed a Windows accounting application to run the books for my own company.
        2. +
      2. Professionally, I have to test and build training materials for a number of Windows applications, thus I try to avoid have to reboot into Windows.
        3. +
      3. I have run VMware in the past and it is superb, but is too resource intensive at times.
        4. +
      4. Sadly, many kinds of multimedia on the net needs a Windows based media application.
      +

      Hints and my experience

      +

      My experience is packaged versions of Wine rarely work well, with the exception of the Codeweavers wine preview releases. I always build from source. Typically the Wine project releases a snapshot tarball once a month. With Wine, there is a slightly different way of building Wine from the usual:

      +./configure && make && make install +

      It is not quite obvious, but there is a way to use the Wine installer scripts which make installing much less difficult. To build the tarball from the root directory where you have un-tarred the source tarball, simply run ./tools/wineinstall and follow the instructions. Compiling from source, takes quite a while, so the ideal time for this is when your workstation will be idle. The benefit is the wine install will be carefully tailored to your setup, both software and hardware. I find it runs more reliably this way.

      +

      If you really do not want to install from source, grab the latest Codeweavers rpm or deb. Their wine package also includes a nice graphical configuration tool for creating the wine.conf file, which is the the key to making Wine work well.

      +

      After installation, you need a wine.conf file. This is hidden in .wine in your home directory. Open in a text editor and study it carefully, the slight adjustments you make here can make a big difference in its performance and reliability. This is well commented and documented in the docs as well.

      +

      Sometimes, there are regressions: I will typically keep the previous snapshot source until I have found the newest one to work well as well as before. Once or twice in the past couple of years, I have reverted to a previous release because something was broken.

      +

      Minuses: Printing support is weak. You can generate PostScript for later conversion via Distiller or GSview. Wine will support CUPS if you have the correct libraries installed, but in general it is nowhere a finished part of the code.

      +

      The good stuff: The Wine snapshot releases in the past few months have run Adobe Acrobat 5: both the 5.1 reader and full 5.0.5 version very reliably. After installation, find the intertrust plug-in folder and delete it before launching Acrobat. This was a very buggy plug-in to enable on-line buying of PDFs. In corporate installs of Acrobat, I make sure this is never installed because it has caused so many problems. The distiller part of Acrobat from Versions 3 to 5 install and work flawlessly, as long as it can locate all your font paths correctly. I have distilled hi-res 35 MB "press-ready" composite CMYK PDFs with ease. I have also loaded the free PDFInspektor plug-in from Callas. I use this to test PDF/X-3 conformance of Scribus PDF/X-3 files (They passed the very first time ;))

      +

      Installing applications has become much more reliable in the last year. Where Wine sometimes has troubles is custom installs. Sometimes, you just have to click through the defaults to get an application to install properly.

      +

      The Alternatives

      +

      Crossover Office from Codeweavers

      +

      Versions 5.0+ run a number of applications quite well, including Photoshop 5,6,7, as well as in my tests, Illustrator 10 and Indesign 2.0.2. The last two can be taxing even on real Windows at times. I found the demo to have a very polished and easy to use installer, which makes configuration a snap. Codeweavers has contributed a great deal to the success of the Wine project thus far. You can also get Crossover Office with some versions of the Suse and Xandros distributions.

      +

      Win4Lin from Netraverse

      +

      Disclaimer: Netraverse has provided the Scribus Team with in-kind sponsorship.

      +

      Win4Lin allows you to run Win 2000 or XP natively on Linux with a translation layer, providing near native speeds and capabilities with few limitations. Basically, you need a licensed version of Win 2000 or XP and run the installer. It looks and works well and most Win32 applications can run.

      + +

      I would not discourage anyone from buying either. Both companies have been good citizens in the open source community.

      + +

      Success

      +
      Acrobat Reader 5.1 under WINE
      +

      Although Acrobat 5.0.5 is not officially supported by Codeweavers, it installs and runs very well. Until the day when Linux/Unix has the same parity in commercial application support, Wine is a good transition strategy. Hopefully, you will find these notes useful in supporting your use of Scribus.

      + + diff --git a/scribus/doc/it/toolbox13.html b/scribus/doc/it/toolbox13.html new file mode 100644 index 0000000..ad70495 --- /dev/null +++ b/scribus/doc/it/toolbox13.html @@ -0,0 +1,16 @@ + + + + XnView + + +

      XnView

      +

      Di applicazioni per visualizzare immagini e miniature ne esistono a bizzeffe; anche Konqueror e Nautilus lo fanno, quindi perché mai si dovrebbe usare XnView?

      + +

      È brutto. Usa vecchie librerie in stile Motif, ma due qualità lo riscattano ampiamente:

      +
      1. è molto veloce, più veloce di quasi tutti gli altri programmi simili;
        2. +
      2. è in grado di visualizzare una vasta gamma di formati immagine, con ottime capacità di conversione. Vi sono alcuni formati di file veramente poco noti che XnView può aprire e convertire. Probabilmente soltanto ImageMagick ne può aprire di più. È molto stabile, ed è uno strumento che dovreste almeno prendere in considerazione.
      + +
      Xnview
      + + diff --git a/scribus/doc/it/toolbox14.html b/scribus/doc/it/toolbox14.html new file mode 100644 index 0000000..a787dae --- /dev/null +++ b/scribus/doc/it/toolbox14.html @@ -0,0 +1,13 @@ + + + + LProf + + +

      LProf

      +

      LProf è uno strumento molto utile per far sì che la gestione dei colori funzioni in modo affidabile in Scribus, specialmente per chi usa Linux o UNIX (ma ne esistono versioni anche per Windows e Mac OS X).

      +

      In generale, LProf è uno strumento facile da usare per creare un profilo ICC di periferiche grafiche, tra cui il monitor, e questo aiuta a rendere più accurate le anteprime con la gestione del colore attiva.

      +

      LProf può funzionare con molti, ma non con tutti, i dispositivi di calibrazione. Controllate il sito di LProf per avere un elenco dei dispositivi con cui funziona, e anche per avere una documentazione più dettagliata.

      +
      Creazione di un profilo con LProf.
      + + diff --git a/scribus/doc/it/toolbox15.html b/scribus/doc/it/toolbox15.html new file mode 100644 index 0000000..5d0a6c0 --- /dev/null +++ b/scribus/doc/it/toolbox15.html @@ -0,0 +1,12 @@ + + + + Krita + + +

      Krita

      +

      Dopo essere risorto dalle ceneri, Krita, che fa parte del pacchetto KDE Office, è divenuto una meravigliosa applicazione pensata principalmente per la pittura naturale, come CorelPainter. Usa una metafora a video del pennello, e ha alcune caratteristiche innovative e interessanti come la capacità di emulare il modo in cui i colori si mescolano e asciugano su tela, una galleria di filtri con l'anteprima di ciascun filtro, livelli di aggiustamento, gruppi di livelli e strumenti per manipolare con precisione le pennellate. Solo per questo vale la pena di aggiungere Krita ai vostri strumenti per il DTP, ma il maggior vantaggio per gli utenti di Scribus è la sua versatilità nella gestione di un gran numero di formati di file e spazi colore. Krita è compatibile non solo con RGB, CMYK, e scala di grigi (fino a 16 bit) con l'uso di littleCMS per la gestione del colore, come Scribus, ma anche con spazi colore piuttosto insoliti come XYZ e L*a*b. Krita è pienamente in grado di eseguire conversioni da RGB a CMYK in modo semplice e facile, e può anche convertire immagini da 16 bit a 8 bit per renderne possibile l'importazione in Scribus (che non è ancora in grado di utilizzare immagini a 16 bit.)

      + +
      Krita con un'immagine in modalità CMYK e la gestione del colore attiva.
      + + diff --git a/scribus/doc/it/toolbox16.html b/scribus/doc/it/toolbox16.html new file mode 100644 index 0000000..084fb90 --- /dev/null +++ b/scribus/doc/it/toolbox16.html @@ -0,0 +1,15 @@ + + + + Fontmatrix + + +

      Fontmatrix

      +

      Coloro che provengono da MacOSX o anche da una versione più vecchia di MacOS, possono sentire la mancanza di un buon strumento grafico per la gestione dei caratteri. Ecco dunque Fontmatrix. È un programma giovane, ma ha tutti gli strumenti essenziali per gestire i tipi di carattere, sia singolarmente, sia in gruppi per mezzo di “etichette”. Fontmatrix è anche in grado di visualizzare i tipi di carattere in un testo di esempio, e di farlo in dimensioni variabili; e può visualizzare anche singoli glifi. Ancora meglio, Fontmatrix ha un ottime capacità di gestire i caratteri OpenType, e in futuro saranno ulteriormente migliorate.

      + +

      Fontmatrix non attiva i caratteri “al volo” per le applicazioni già aperte, ma può attivare e disattivare caratteri velocemente senza interferire con i caratteri di sistema, che devono essere sempre utilizzabili da tutte le applicazioni. Quindi, per lavorare con Scribus o altre applicazioni di grafica, basta visualizzare e attivare i tipi di carattere che vi servono, e riavviare l'applicazione interessata. Infine, Fontmatrix può creare dei campionari di caratteri, che sono documenti PDF che mostrano ciascun tipo di carattere.

      + +

      +
      Fontmatrix con la visualizzazione dell'elegante carattere Gentium.
      + + diff --git a/scribus/doc/it/toolbox17.html b/scribus/doc/it/toolbox17.html new file mode 100644 index 0000000..3b05032 --- /dev/null +++ b/scribus/doc/it/toolbox17.html @@ -0,0 +1,21 @@ + + + + SwatchBooker + + +

      SwatchBooker

      +

      Le vecchie abitudini sono dure a morire, e molti grafici si basano su raccolte di colori commerciali come quelle prodotte da Pantone®, HKS®, Toyo®, o altre, e specialmente quelle fornite insieme all'applicazione di disegno o progettazione che usano abitualmente da anni o decenni.

      +

      Il team di Scribus è riuscito ad ottenere le licenze d'uso di molte raccolte di colori, ma non tutti gli sforzi in questa direzione hanno avuto (ancora) successo, il che significa che potreste dover ottenere da altre fonti le raccolte colore che vi servono. Il team di Scribus è informato dell'esistenza di raccolte di terzi che contengono questi colori e che utilizzano il formato di Scribus, ma non può approvarne l'uso, poiché la loro legalità è discutibile quanto la loro affidabilità.

      +

      Finché i problemi di licenza con Scribus non saranno risolti, e purché abbiate una licenza valida per un programma come CorelDraw, PageMaker o InDesign, dovreste essere liberi di usare le relative raccolte di colori in Scribus, anche se Scribus non è ancora in grado di utilizzare molti formati proprietari di raccolte di colori. È questa la situazione in cui SwatchBooker diviene uno strumento essenziale. Con SwatchBooker non solo potete convertire le raccolte di colori, siano esse proprietarie od open source, per l'uso con Scribus; potete anche modificare le raccolte esistenti cambiando i valori di colore, assegnando profili colore o traducendo i nomi dei colori.

      +

      Se usate SwatchBooker per scopi diversi dalla conversione di raccolte di colori, lo fate a vostro rischio e pericolo. Cambiare i nomi dei colori spot o i loro valori alternativi L*a*b/CMYK/RGB può causare errate corrispondenze di colore, e va contro lo scopo specifico per cui esistono insiemi standardizzati di colori.

      +
      +
      Una raccolta colore proprietaria nel formato ASE di Adobe® aperta in SwatchBooker
      +
      +

      Requisiti:

      +

      Python, PyQt4, littleCMS

      +

      Formati gestibili:

      +

      Importazione: Adobe (ACO, ACB, ACT, ASE, ACF, BCF, CLR); AutoCAD (ACB; solo senza crittografia!); ColorSchemer (CS); Corel (CPL); GIMP (GPL); profili colore ICC denominati; OpenOffice.org (SOC); QuarkXPress (QCL+CUI; sono necessari entrambi i file per poter convertire una libreria colore di XPress); RAL Digital/Digital Colour Atlas (BCS); RIFF (PAL); Scribus (XML); VivaDesigner (XML)

      +

      Esportazione: Adobe Swatch Exchange (ASE); GIMP (GPL); HTML; SwatchBooker (SBZ), OpenOffice.org/LibreOffice (SOC); Scribus (XML)

      + + diff --git a/scribus/doc/it/toolbox18.html b/scribus/doc/it/toolbox18.html new file mode 100644 index 0000000..0d9a2da --- /dev/null +++ b/scribus/doc/it/toolbox18.html @@ -0,0 +1,25 @@ + + + + LibreOffice/OpenOffice.org + + +

      LibreOffice/OpenOffice.org

      + +

      LibreOffice e OpenOffice.org sono due pacchetti open source di programmi da ufficio che hanno in comune il codice sorgente. Che preferiate l'uno o l'altro, dovreste considerarlo uno strumento di grande utilità da usare con Scribus.

      +

      In primo luogo, Scribus contiene alcuni potenti filtri di importazione per i vecchi formati nativi di OpenOffice.org, e per il più recente standard internazionale ODF, che entrambi i pacchetti utilizzano molto bene.

      + +

      In secondo luogo, e altrettanto importante, entrambi i pacchetti sono in grado di utilizzare un grandissimo numero di formati di file diversi, il che significa che potete usarli come versatili convertitori di file, specialmente per documenti di testo e file grafici (vettoriali). Riportiamo di seguito un elenco dei formati di file che LibreOffice può aprire e convertire per l'uso in Scribus.

      + +

      Formati di documenti di testo:

      +

      DocBook (*.xml), documento Hangui WP 97 (*.hwp), documento Lotus WordPro (*.lwp), documento MS Word 5, 6, 95, 97, 2000, XP (*.doc), modello MS Word 95, 97, 2000, XP (*.dot), documento MS Word 2003, 2007 (*.docx, *.docm, *.xml), modello MS Word 2003, 2007 (*.dotx, *.docm), documento MS Works (*.wps), documento Office Open XML (*.docx, *.docm, *.xml), modello Office Open XML (*.dotx, *.docm), Pocket Word (*.psw), Rich Text Format (*.rtf), documento StarOffice Writer 1, 2, 3, 4, 5 (*.sdw), modello StarOffice Writer 1, 2, 3, 4, 5 (*.vor), documento T602 (*.602, *.txt), documento Unified Office Format Text (*.uof, *.uot), documento WordPerfect (*.wpd)

      + +

      Formati grafici (solo formati vettoriali, poiché vi sono convertitori migliori per le immagini bitmap):

      +

      AutoCAD Interchange Format (*.dxf), Computer Graphics Metafile (*.cgm), Enhanced Metafile (*.emf), OS/2 Metafile (*.met), StarOffice Writer Graphics File (*.sgf), StarOffice Drawing (*.sgv), StarView Metafile (*.svm)

      + +

      Inoltre, potete aprire diapositive create con programmi per presentazioni come PowerPoint o Impress e convertirle in un formato vettoriale o bitmap che Scribus è in grado di importare.

      + +
      Modifica di un'immagine clipart con LibreOffice Draw
      Modifica di un'immagine clipart con LibreOffice Draw
      + + + diff --git a/scribus/doc/it/toolbox19.html b/scribus/doc/it/toolbox19.html new file mode 100644 index 0000000..e1880e1 --- /dev/null +++ b/scribus/doc/it/toolbox19.html @@ -0,0 +1,98 @@ + + + + Strumenti da riga di comando + + + +

      Strumenti da riga di comando

      +

      Ecco un elenco di utili strumenti da riga di comando che possono essere usati insieme a Scribus. Non tutti questi programmi sono disponibili per ogni piattaforma su cui Scribus è utilizzabile, ma certamente sono tutti disponibili su Linux e UNIX (compreso Mac OS X). Per scoprire cosa questi strumenti possono fare e come servirvene, potete usare i consueti comandi della shell, come man program, program --help, o program -h (dove program è il nome dello strumento).

      +

      PDF/PostScript

      + +

      Strumenti Ghostscript

      +
        +
      • epswrite
        • +
      • pstoedit
        • +
      • ps2pdf
        • +
      • ps2pdf13
        • +
      • ps2pdf14
        • +
      • pdfopt
        • +
      + +

      Strumenti PoDoFo

      +
        +
      • podofocolor
        • +
      • podofocountpages
        • +
      • podofocrop
        • +
      • podofoencrypt
        • +
      • podofoimg2pdf
        • +
      • podofoimgextract
        • +
      • podofoimpose
        • +
      • podofoincrementalupdates
        • +
      • podofomerge
        • +
      • podofopages
        • +
      • podofopdfinfo
        • +
      • podofotxt2pdf
        • +
      • podofotxtextract
        • +
      • podofouncompress
        • +
      • podofoxmp
        • +
      +

      PDF Toolkit

      +
      • pdftk
      + +

      PDF Jam

      +
        +
      • pdfjam
        • +
      • pdfbook
        • +
      +

      Strumenti per bitmap

      +

      ImageMagick/GraphicsMagick

      +
        +
      • convert
        • +
      • identify
        • +
      • mogrify
        • +
      • composite
        • +
      • montage
        • +
      • compare
        • +
      +

      Strumenti di LittleCMS

      +
        +
      • icc2ps
        • +
      • icclink
        • +
      • icclink
        • +
      • jpegicc
        • +
      • tifficc
        • +
      • tiffdiff
        • +
      • wtpt
        • +
      + +

      Altri strumenti per bitmap

      +
        +
      • pngcrush
        • +
      • optipng
        • +
      + +

      Caratteri

      +

      Strumenti per i caratteri lcdf

      +
        +
      • cfftot1
        • +
      • mmafm
        • +
      • mmpfb
        • +
      • otfinfo
        • +
      • otftotfm
        • +
      • t1dotlessj
        • +
      • t1lint
        • +
      • t1reencode
        • +
      • ttftotype42
        • +
      + +

      Altri strumenti per i caratteri

      +
        +
      • afm2afm
        • +
      • pf2afm
        • +
      • pfb2pfa
        • +
      • fondu
        • +
      + + + diff --git a/scribus/doc/it/toolbox2.html b/scribus/doc/it/toolbox2.html new file mode 100644 index 0000000..7ead3ff --- /dev/null +++ b/scribus/doc/it/toolbox2.html @@ -0,0 +1,28 @@ + + + +Strumenti per PDF e PostScript + + +

      Strumenti per PDF e PostScript

      +

      Visualizzatori PDF e PostScript

      +

      Adobe Reader è il più affidabile tra i visualizzatori PDF, ma è giustamente noto come un “divora-risorse”, e può aprire soltanto file PDF. Per una veloce anteprima dei documenti PDF, alcuni utenti potrebbero preferire un programma più veloce; esistono molti visualizzatori PDF alternativi, ma soltanto due sono consigliati dal team di Scribus:

      +
        +
      • Okular è diventato il visualizzatore di documenti predefinito nell'ambiente desktop KDE 4. Per quanto riguarda la compatibilità con le caratteristiche del formato PDF, Okular è sorprendentemente vicino ad Adobe Reader, anche se non è ancora in grado di gestire correttamente documenti PDF nello spazio colore CMYK con la gestione del colore attiva. Ciò che rende Okular ancora più interessante, oltre alle sue capacità PDF, è il lungo elenco di formati di file che è in grado di aprire e convertire: PDF, PostScript, EPS, DjVu, DVI, G3 Fax, e inoltre molti formati di immagine.
        • +
      • Un altro affidabile visualizzatore e convertitore è GSview, le cui caratteristiche sono descritte in un apposito capitolo.
        • +
      +

      Editor PDF

      +

      Il formato PDF fu ed è progettato per essere una specie di “carta elettronica”, il che significa che non è fatto per essere modificabile. Ma, più il PDF si diffuse, più apparvero situazioni in cui aveva senso modificare questi file “non modificabili”: ad esempio correzioni di refusi all'ultimo minuto, o il riordinamento di pagine in una pubblicazione destinata alla stampa. La Adobe, che aveva inventato il PDF, prese l'iniziativa e sviluppò Acrobat, che è tuttora il più importante programma per la modifica di PDF. Ma le specifiche tecniche del formato PDF sono aperte, e anche altri cominciarono a lavorarci; oggi esistono innumerevoli strumenti, open source e non, che permettono di modificare i file PDF. Ecco un elenco di programmi open source consigliati per l'editing PDF.

      +
        +
      • Multivalent e PDF Toolkit (pdftk) sono entrambi strumenti da riga di comando basati su Java, con numerose opzioni per la manipolazione di file PDF.
        • +
      • PDF Edit è un insieme di script Qt per manipolare file PDF, ma gli script sono “nascosti” dietro un'interfaccia grafica, quindi i file vengono modificati in modalità WYSIWIG (“What you see is what you get”: quello che vedi è quello che è). PDF Edit permette di apportare molte modifiche dirette al contenuto di un file PDF, tra cui modifiche al testo o ai colori ed eliminazione di contenuto. Il programma è basato su Qt3, ma alla data in cui questa guida è stata scritta gli sviluppatori stanno lavorando per portarlo su Qt4.
        • +
      • jPDF Tweak, un programma in Java, è stato giustamente definito il “coltellino svizzero” dei PDF. Per la modifica dei PDF utilizza la libreria iText, che ha un elevato grado di affidabilità.

        • +
        jPDF Tweak

        +
      • PDF Split and Merge (PDF SaM) è ancora più potente di jPDF Tweak e si è dimostrato un valido strumento in ambiente di prestampa. PDF SaM è uno strumento adatto ai professionisti, mentre i principianti saranno probabilmente messi in difficoltà dalle sue numerose opzioni. Come jPDF Tweak, PDF SaM è un programma Java, ma, a differenza di tutti gli altri programmi Java citati in quest'elenco, la lingua dell'interfaccia grafica può essere cambiata e vi sono molte traduzioni.
        • +
      • Bookbinder è un editor PDF per principianti e per operazioni semplici. Il suo scopo principale è riordinare (e riscalare se necessario) le pagine in un file PDF per la stampa come opuscolo, e operazioni simili. Anche Bookbinder è scritto in Java.

        • +
        Bookbinder
        +
      • Per modificare un file PDF che contiene illustrazioni, potete servirvi di GIMP, Krita, Inkscape o Libre Office Draw, a seconda del contenuto, poiché tutte queste applicazioni possono importare documenti PDF e permettono di modificare i file.
        • +
        PDF import in Inkscape
        Importazione PDF in Inkscape
        +
      + + diff --git a/scribus/doc/it/toolbox3.html b/scribus/doc/it/toolbox3.html new file mode 100644 index 0000000..781062a --- /dev/null +++ b/scribus/doc/it/toolbox3.html @@ -0,0 +1,15 @@ + + + + Batik + + +

      Batik

      + +

      Batik è una raccolta di moduli XML Apache per l'esportazione e la conversione istantanea di SVG. Tra essi, uno degli strumenti veramente utili è Squiggle, un'applicazione Java che visualizza file SVG. Potrebbe essere difficile compilare Batik su certe distribuzioni, ma fortunatamente esistono pacchetti pronti per tutte le principali distribuzioni e sistemi operativi.

      + +

      Perché prendersi il disturbo di usarlo? Potete considerarlo un giudice lucido e integerrimo dell'SVG. Tra tutti i visualizzatori SVG, è probabilmente uno di quelli che più rispettano le specifiche (e forse è quello che le rispetta di più). Se ricevete o create un'immagine SVG che non viene importata correttamente, provate ad aprirla con Squiggle. Se non viene visualizzata correttamente, è più che probabile che il problema dipenda dall'applicazione con cui è stata creata. L'eccezione sono i file SVG esportati da Adobe Illustrator, che spesso contengono estensioni specifiche della Adobe, e potrebbero essere apribili soltanto da applicazioni Adobe.

      + +
      Batik
      + + diff --git a/scribus/doc/it/toolbox4.html b/scribus/doc/it/toolbox4.html new file mode 100644 index 0000000..3adc64d --- /dev/null +++ b/scribus/doc/it/toolbox4.html @@ -0,0 +1,31 @@ + + + + GIMP 2.x + + +

      GIMP 2.x

      + +

      Non c'è molto da dire sulla migliore applicazione per il trattamento di immagini in Linux. I miglioramenti in GIMP 2.x sono troppi per elencarli.

      + +

      Tuttavia, impostare GIMP per l'utilizzo con Scribus (il cui prodotto finale è destinato alla stampa) richiede alcuni aggiustamenti alle impostazioni predefinite, come mostrato sotto:

      + +
        +
      • Accertatevi di avere la più recente versione stabile 2.6.x.
        • +
      • GIMP ora è in grado di lavorare con i colori CMYK. Anche se il modello di colore internamente è ancora RGB più canali alfa, potete usare i valori CMYK e le definizioni di colore CMYK. Per completare queste funzionalità, esiste un plugin (prodotto da terzi) chiamato separate+, che può esportare in formato TIFF CMYK utilizzando un abile espediente con i livelli alfa. Il plugin separate+ può inoltre incorporare i profili ICC nei file TIFF esportati e creare TIFF in bicromia.
        • +
      • Uno dei miglioramenti più apprezzati riguarda la gestione del testo. GIMP 2.x utilizza fontconfig, quindi il rilevamento dei caratteri presenti sul sistema è molto meno problematico. Il testo può essere mantenuto in un livello a sé per facilitarne la modifica e la correzione. Nelle versioni 1.2.x certe operazioni sul testo erano difficili, ma ora vi sono ben pochi motivi per lamentarsi; è un piacere usare i nuovi controlli per il testo. Inoltre esiste anche un apposito plugin freetype per GIMP, che permette di manipolare i caratteri come in Scribus e Inkscape. Lo consigliamo, e lo potete trovare su ftp.gimp.org.
        • +
      • Le versioni più recenti di GIMP possono esportare tutti i tracciati come maschere di ritaglio nei file TIFF, e sono anche in grado di eseguirne meglio l'importazione da file TIFF.
        • +
      • Nei filtri e negli effetti, per impostazione predefinita i pixel sono adattati (interpolati) con il metodo lineare: questo è un buon compromesso tra velocità e accuratezza. Per materiale destinato alla stampa, si dovrebbe quasi sempre utilizzare il filtro di Lanczos, ma dovete aspettarvi che molte operazioni, (come riscalatura e applicazione di filtri) siano più lente. L'utilizzo del filtro di Lanczos a volte può produrre una differenza eccezionale nella qualità percepita di stampa di un'immagine, quindi dovreste fare in modo che GIMP lo usi per impostazione predefinita.
        • +
      + +
      Interpolazione Lanczos
      + +

      Come accade per la maggior parte dei programmi per la creazione e la modifica di immagini, le impostazioni predefinite di GIMP sono pensate primariamente per immagini destinate a siti web, il che significa che la risoluzione è di gran lunga troppo bassa per la stampa. Quindi, per prima cosa, impostate la risoluzione predefinita a un minimo di 144 DPI. Ricordate che l'uso di queste risoluzioni più alte provocherà la creazione di file di dimensioni molto maggiori, quindi potreste dover regolare anche le impostazioni di massimo utilizzo della memoria nelle preferenze di GIMP.

      + +
      Impostazioni DPI predefinite
      + +

      L'altra aggiunta notevole è la capacità (per ora a un livello molto semplice) di creare una prova colore a video (“soft proof”) con l'utilizzo della gestione del colore. Questa viene eseguita con LittleCMS (che è utilizzato anche da Scribus), e potete impostarla nelle preferenze. Ciò è utile se desiderate vedere l'aspetto dell'immagine in uno spazio colore CMYK quando sarà stampata o esportata in PDF.

      + +
      Impostazioni per la gestione del colore
      + + diff --git a/scribus/doc/it/toolbox5.html b/scribus/doc/it/toolbox5.html new file mode 100644 index 0000000..5e2e372 --- /dev/null +++ b/scribus/doc/it/toolbox5.html @@ -0,0 +1,34 @@ + + + + Ghostscript + + +

      Ghostscript

      +

      Che cos'è Ghostscript?

      + +

      Per chi non lo sa, Ghostscript (gs), in senso stretto, è un cosiddetto “interprete PostScript,” e molti programmi utilizzano gs per operazioni di conversione, importazione ed esportazione di file PostScript. Ghostscript è diventato uno dei “mattoni” essenziali del software open source; sarebbe difficile immaginare una moderna distribuzione di software open source che non lo contenga.

      +

      Anche Scribus utilizza Ghostscript, e a volte ne sfrutta le funzioni più sofisticate che sono disponibili soltanto nelle versioni più recenti. Scribus si serve di gs per tre funzioni. La prima è l'importazione di file EPS rasterizzati e di certi file DCS nelle cornici immagine. La seconda funzione che richiede gs è l'anteprima di stampa. La terza è il generatore di codici a barre.

      +

      Se gs non è installato sul vostro sistema, o se Scribus non trova l'eseguibile gs, le tre operazioni sopra citate non sono possibili, e Scribus mostra un avviso ogni volta che viene lanciato:


      +

      +

      Se gs è stato installato sul computer, ma Scribus non lo trova, potete inserire il percorso dell'eseguibile gs nelle preferenze di Scribus.

      + +

      È sempre consigliabile avere Ghostscript nella più recente versione disponibile per il vostro sistema.

      +

      Installazione di Ghostscript

      +

      Linux/UNIX

      +

      Come detto prima, Ghostscript è richiesto da molte applicazioni, tra cui il sottosistema di stampa; quindi è improbabile che non sia installato sul sistema. Se, per qualche ragione, gs non è presente sul vostro sistema, o se la versione presente è troppo vecchia (con Scribus dovreste usare almeno Ghostscript 8.6), potete scaricare l'archivio contenente il codice sorgente dal sito di gs. Fate attenzione a scaricare il vero e proprio Ghostscript, non ghostpdl, il cui codice sorgente si trova nella stessa directory. Poi seguite le istruzioni per la compilazione che trovate nell'archivio e installatelo.

      +

      Windows

      +

      Trovate spiegazioni nelle informazioni generali su Scribus in ambiente Windows.

      +

      Mac OS X

      +

      Vi sono diversi modi per installare Ghostscript per Mac OS X, ma purtroppo nessuno di essi sembra avere la facilità a cui la maggior parte degli utenti di Mac sono abituati:

      +
        +
      • potete scaricare un archivio ZIP contenente quattro DMG di gs per varie versioni di OS X. Leggete il relativo file info per capire qual è la versione che vi serve;
        • +
      • potete installare gs per mezzo di Fink;
        • +
      • le più recenti versioni di Ghostscript sono sempre disponibili tramite MacPorts;
        • +
      • e infine, potete, naturalmente, scaricare il più recente codice sorgente e compilarlo direttamente.
        • +
      +

      OS/2 ed eComStation

      +

      Trovate spiegazioni nelle informazioni generali su Scribus in ambiente OS/2 ed eComStation.

      + + + diff --git a/scribus/doc/it/toolbox6.html b/scribus/doc/it/toolbox6.html new file mode 100644 index 0000000..88c2b43 --- /dev/null +++ b/scribus/doc/it/toolbox6.html @@ -0,0 +1,49 @@ + + + + + GSview + + + +

      GSview*

      + +

      È importante notare che GSview non deve essere confuso con ghostview, gv e i loro derivati! Anche se Adobe Reader spesso è migliore come visualizzatore puro per documenti PDF, GSview dovrebbe essere considerato uno degli strumenti essenziali per l'uso con Scribus. GSview comprende alcune funzioni estremamente utili. Per coloro che non conoscono il programma, diciamo che fornisce un'interfaccia di facile uso per Ghostscript e per pstoedit, per la conversione di file bitmap in file vettoriali e viceversa. Per coloro che hanno un'esperienza di DTP tradizionale in ambiente Mac/Windows, fornisce anche alcune delle funzionalità di Adobe Acrobat.
      +

      + +

      Dovreste sempre usare la versione più recente, almeno la 4.7. (GSview fu originariamente sviluppato in ambiente Windows, e ha raggiunto una qualità eccellente fin dalle versioni 4.x.)

      + +

      Per l'uso con Scribus, GSview offre le seguenti funzionalità:

      + +
        + +
      • con l'aiuto di pstoedit, potete convertire immagini bitmap o documenti PDF in file SVG e altri formati vettoriali;
        • +
      • la capacità di visualizzare in anteprima, convertire e aggiungere anteprime (consigliato per il TIFF) a file PostScript ed EPS (Encapsulated PostScript);
        • +
      • la capacità di estrarre testo da file PDF, EPS e PostScript;
        • +
      • una facile interfaccia per le caratteristiche meno note di Ghostscript come la conversione e il ricampionamento di immagini;
        • +
      • altre caratteristiche sono: la conversione tra formati TIFF, la modifica della profondità di colore di un file TIFF o JPEG o dello spazio colore di un'immagine.
        • +
      + +
      + +

      Un esempio di una situazione in cui GSview è molto utile con Scribus è l'individuazione e la correzione di errori presenti in file EPS che non vengono visualizzati correttamente in Scribus. Molte applicazioni sono in grado di generare file EPS, ma alcune vi aggiungono delle caratteristiche insolite che possono causare problemi quando questi file sono utilizzati in altri programmi (come Scribus).

      + +

      Quindi, se incontrate difficoltà con un file EPS che desiderate utilizzare in Scribus, apritelo in GSview. Poi usate il comando da tastiera M per visualizzare i messaggi emessi da Ghostscript: questi messaggi possono indicare i problemi che causano errori di visualizzazione o stampa. Potete inoltre usare la ‘periferica’ epswrite da GSview per salvare nuovamente l'EPS, operazione che può aiutare a eliminare o correggere errori in un file EPS.

      + +

      Potete anche rasterizzare un'immagine EPS, convertendola in PNG o TIFF e poi ridimensionarla, correggere i colori, e così via, con programmi di grafica come GIMP o Krita.
      +

      + +

      GSview utilizza la libreria condivisa libgs.so per accedere a Ghostscript. Non tutte le distribuzioni Linux la comprendono; in queste situazioni dovreste seguire i consigli per compilare Ghostscript con un'installazione parallela.

      + +

      Procurarsi GSview:

      + +

      GSview è disponibile per la maggior parte delle distribuzioni Linux, almeno per le maggiori. Altrimenti potete compilarlo seguendo le istruzioni contenute nel pacchetto del codice sorgente. Per Windows, OS/2 ed eComStation potete scaricare i normali programmi di installazione. Purtroppo non è disponibile alcuna versione attuale per Mac OS X.

      + +

      Una nota speciale per gli utenti di OpenSUSE: a partire dalla versione 11.3, le librerie GTK 1, che sono necessarie, non sono più disponibili per questa distribuzione, ma potete servirvi delle versioni che si trovano nel repository OpenSUSE Factory. Dovete installare i pacchetti gtk-1.20 e glib (e se volete compilare direttamente GSview, anche i rispettivi pacchetti RPM devel), e inoltre il pacchetto linguistico che si trova nella directory “noarch”.
      +

      + +

      Per suggerimenti avanzati su GSview e Ghostscript, vedere Ghostscript avanzato & GSView.

      + +

      *) Per il contenuto di questa pagina ringraziamo Russell Lang, autore e sviluppatore di GSview, epstool e Ghostscript, per i suggerimenti e le pazienti risposte ai quesiti su GSview e Ghostscript.

      + + diff --git a/scribus/doc/it/toolbox7.html b/scribus/doc/it/toolbox7.html new file mode 100644 index 0000000..c0cf020 --- /dev/null +++ b/scribus/doc/it/toolbox7.html @@ -0,0 +1,95 @@ + + + + Advanced Ghostscript and GSview Hints + + +

      Advanced Ghostscript and GSview Hints

      +

      One of the frustrations for users of RPM-based or commercially created distributions, is the lack of availability of the latest versions of Ghostscript(GS). Because of the differences in licensing between the GPL Ghostscript and AFPL Ghostscript, GPL Ghostscript releases usually follow by about a year, the release of the most up to date AFPL GS. Because, there are certain restrictions in AFPL, most Linux distributions ship an older and heavily patched version of GPL Ghostscript.

      +

      As the current GS 8.x resource configuration (where it looks for fonts and fontmaps) is new, simply dropping in the latest GS tarball and rebuilding the RPM does not quite work. Lord knows I've tried on Red Hat and I consider myself to be pretty well versed in RPM building. If you have ever seen the Red Hat or Suse rpm spec file for GS, you will know what I mean. ;)

      +

      So, why do I want to go to the trouble of worrying about having the absolute latest version of GS? Not so difficult.

      +
      1. There are real substantial improvements in the ability of GS 8.5+ to handle EPS and PDF files which have the kinds of advanced features Scribus and other DTP applications can create. This can in some cases directly affect the quality of EPS and PS imports into Scribus.
        2. +
      2. You can build it with full on compiler optimization, which speeds up print and separation previews in Scribus. Many distributions only compile it with i386 instructions. This is probably more beneficial to older workstations compared to newer ones. Image processing programs are one area where compiler optimizations do make a difference.
        3. +
      3. Having the latest GS, makes GSview (and Scribus) more capable and more robust at handling both EPS files and a special kind of EPS called DCS 2.0.
        4. +
      4. Both Scribus and GSview have the ability in their preferences settings to use alternative locations for GS and GS libraries.
      +

      So, how does one get the latest GS for Scribus and GSview - without breaking your existing distribution printing setup? The secret: a parallel build of GS.

      +

      Disclaimer: This works for me. It could wreck your system, catch your hair on fire and other nastiness.

      +

      First Steps:

      +
      • Get the latest GS from here: Ghostscript Downloads
        • +
      • You can manually tweak the make files the old way or
        • +
      • Use the new configure script with the following options (and optionally -with-jasper and -with-rinkj with very latest versions):
      +
      +
      +
      ./configure --enable-compile-inits -with-x
      +
      + +

      By default, 'make install' will install all the files in '/usr/local/bin', '/usr/local/lib' etc. You can specify an installation prefix other than '/usr/local' using '--prefix', for instance '

      +
      +
      +
      --prefix=$HOME
      +
      +

      This default usually works fine and keeps the two sets of GS libs separated.

      +

      Second Steps:

      +

      There is a second step to compile Ghostscript as a shared library, which GSview needs:

      +
      +
      +
      make so
      +
      +

      and as root:

      +
      +
      +
      make soinstall
      +
      +

      Now, let's check briefly:

      +
      +
      +
      /usr/local/bin/gs -h
      +
      +

      You should have an output something like this:

      +
      +
      +
      +AFPL Ghostscript 8.51 (2005-04-18)
+Copyright (C) 2005 artofcode LLC, Benicia, CA.  All rights reserved.
+Usage: gs [switches] [file1.ps file2.ps ...]
+Most frequently used switches: (you can use # in place of =)
+ -dNOPAUSE           no pause after page   | -q        'quiet', fewer messages
+ -g<width>x<height>  page size in pixels   | -r<res>  pixels/inch resolution
+ -sDEVICE=<devname>  select device         | -dBATCH  exit after last file
+ -sOutputFile=<file> select output file: - for stdout, |command for pipe,
+                                         embed %d or %ld for page #
+Input formats: PostScript PostScriptLevel1 PostScriptLevel2 PostScriptLevel3 PDF
+Default output device: x11
+Available devices:
+   bbox bit bitcmyk bitrgb bj10e bj200 bjc600 bjc800 bmp16 bmp16m bmp256
+   bmp32b bmpgray bmpmono bmpsep1 bmpsep8 cdeskjet cdj550 cdjcolor cdjmono
+   cljet5 cljet5c deskjet devicen djet500 epswrite faxg3 faxg32d faxg4 ijs
+   jpeg jpeggray laserjet lj5gray lj5mono ljet2p ljet3 ljet3d ljet4 ljet4d
+   ljetplus nullpage pbm pbmraw pcx16 pcx24b pcx256 pcxcmyk pcxgray pcxmono
+   pdfwrite pgm pgmraw pgnm pgnmraw pj pjxl pjxl300 pkm pkmraw pksm pksmraw
+   png16 png16m png256 pngalpha pnggray pngmono pnm pnmraw ppm ppmraw
+   psdcmyk psdrgb psgray psmono psrgb pswrite pxlcolor pxlmono spotcmyk
+   tiff12nc tiff24nc tiffcrle tiffg3 tiffg32d tiffg4 tifflzw tiffpack
+   uniprint x11 x11alpha x11cmyk x11gray2 x11gray4 x11mono xcf
+Search path:
+   . : /home/peter/.fonts : /usr/local/share/ghostscript/8.51/lib :
+   /usr/local/share/ghostscript/8.51/Resource :
+   /usr/share/ghostscript/fonts
      +
      + +

      The key thing here is:

      +
      1. You see the correct version of GS. Otherwise, you might need to adjust your $PATH settings
        2. +
      2. You have pngalpha and the x11 devices listed, along with bitcmyk for cmyk preview, and png16m.
        3. +
      3. There is a reasonable search path for fonts, so GS can find your fonts. You will get errors in Scribus, when attempting to import EPS files or using the print preview, if this path is not set correctly and GS cannot find fonts. GS determines where to find fonts in a file called Fontmap. Setting this option is explained in the GS documentation.
      +

      If you are concerned about messing about with your existing packaging setup, you could use: checkinstall or Xstow. These programs will keep track of applications which are outside of your normal packaging system. I have used checkinstall with good luck in these kinds of situations on Red Hat systems.

      +

      Next,if installed, open up GSview and go to Options.. > Advanced Configure. Then, make sure the "Ghostscript Shared Object" is pointing at the correct libgs.so. Below is how I have setup GSview on my system.:

      +
      GSview - Advanced Options Panel
      + +

      Next, we need to tell Scribus where to find the newer GS. Go Edit..> Preferences.. >General. Then in External Tools, add the path for the new Ghostscript under PostScript Interpreter.

      +
      Scribus External Tools Preferences
      +

      Another tool which is available with GSview is epstool. An older version is shipped with the current GSview 4.6, but a newer one is available on the GSview home page. This is a great command line tool, which can perform advanced EPS/DCS 2.0 conversion. This is very useful when someone sends you an EPS file from other DTP applications - even those created on Macs. Upgrading this to work with GSview gives you excellent support on Linux to handle EPS files from all platforms. Recommended.

      +

      Lastly, one other tool which works as a plug-in with GSview is pstoedit This is a command line tool for converting bitmap images into vectors and PostScript, which then, depending on the nature of the image, can be edited in a vector drawing tool like Inkscape or Skencil. See the section Import Hints for hints on how I used this to convert the Scribus logo into SVG and then a native Scribus file. GSview uses this as a plug-in to convert files into vector format.

      +

      GSview has been, in my experience, the most reliable and versatile EPS/PS viewer on Linux. How good is it ? Well, the best example is letting you know this usually installed on every Windows DTP workstation I support for clients. For DTP with Scribus, I consider it essential.

      + + + \ No newline at end of file diff --git a/scribus/doc/it/toolbox8.html b/scribus/doc/it/toolbox8.html new file mode 100644 index 0000000..aa8cb68 --- /dev/null +++ b/scribus/doc/it/toolbox8.html @@ -0,0 +1,16 @@ + + + + ImageMagick + + +

      ImageMagick

      +

      ImageMagick è un convertitore di immagini da riga di comando. Esiste anche un'interfaccia grafica, chiamata “Display”. ImageMagick dimostra la sua utilità specialmente sotto tre aspetti:

      + +
      1. come applicazione per la conversione in modalità “batch” (cioè, eseguita su un gruppo di immagini senza interazione con l'utente);
        2. +
      2. può trattare un'ampia gamma di formati immagine;
        3. +
      3. le versioni più recenti sono compatibili con la gestione del colore e utilizzano littleCMS, proprio come Scribus.
      + +

      ImageMagick elabora le immagini “a scatola chiusa”, ma è incredibilmente potente se usato correttamente. Ne esistono versioni per Linux, Windows e MacOSX.

      + + diff --git a/scribus/doc/it/toolbox9.html b/scribus/doc/it/toolbox9.html new file mode 100644 index 0000000..35289a8 --- /dev/null +++ b/scribus/doc/it/toolbox9.html @@ -0,0 +1,20 @@ + + + + Inkscape + + +

      Inkscape

      + +

      Inkscape è rapidamente divenuto uno dei più importanti strumenti open source per la grafica vettoriale o l'“illustrazione”. Gli sviluppatori di Inkscape hanno compiuto grandi sforzi per aderire fedelmente alle specifiche tecniche del formato SVG elaborate dal W3C. Le versioni più recenti hanno fatto molti progressi e contengono un'ampia gamma di miglioramenti, tra cui la gestione del colore, uno dei migliori strumenti di tracciamento e molte funzionalità che rendono più facile la vita ai grafici. Come per Scribus, le capacità di Inkscape possono facilmente essere estese tramite script in Python.

      + +
      + +

      Inkscape ha un'interfaccia utente facile da usare, con ampi suggerimenti e un paio di corsi pratici sul disegno vettoriale veramente ben fatti. Quasi ogni funzione può essere attivata con tasti di scelta rapida (l'elenco è lungo quasi dieci pagine!). Come per Scribus, gli sviluppatori di Inkscape correggono gli errori rapidamente, e sono molto aperti a suggerimenti per nuove funzioni e miglioramenti.

      + +

      Ma il meglio di Inkscape è la sua fedeltà alle specifiche tecniche SVG. Non è perfetto; nessuna applicazione lo è; ma le immagini SVG create con Inkscape sembrano funzionare meglio della media con altre applicazioni SVG, anche rispetto a quelle create con applicazioni commerciali costose.

      + +

      Nella maggior parte dei casi, le immagini SVG create con Inkscape vengono importate facilmente in Scribus. Vi sono alcune caratteristiche del formato SVG che Scribus non è ancora in grado di gestire (come i motivi o le ombreggiature), ma nel 99% dei casi “It Just Works™”. Se un file non sembra essere importato correttamente in Scribus, provate a salvarlo in “Plain SVG” in Inkscape.

      +

      Per altre informazioni leggete la pagina sull'importazione di SVG.

      + + diff --git a/scribus/doc/it/topten.html b/scribus/doc/it/topten.html new file mode 100644 index 0000000..0c3a389 --- /dev/null +++ b/scribus/doc/it/topten.html @@ -0,0 +1,56 @@ + + + + Top <strike>Ten</strike>Twelve Hints - Tips and Tricks to make better documents faster in Scribus + + +

      Top Ten Twelve Hints - Tips and Tricks to make better documents faster in Scribus

      + +

      These are our top ten hints for using Scribus, in (some sort of) order:

      + +
        +
      • Get the latest Adobe Reader® installed.
        Without this, is it impossible to open PDFs from Scribus and see all the features Scribus can create within a PDF. Plus, it renders PDF better than most any other viewer. In the future more documentation for Scribus will be in PDF format, optimized for display in Adobe Reader. More details..
        • +
      • Tool Tips
        When, you are unsure of a function, use tool tips. While it is not 100% complete, a great many of the GUI functions have extensive tool tips to guide you about each option for a given function, especially more complex ones. To enable tool tips, make sure Help > Tooltips is checked. Then hover your mouse over the check box or GUI option.
        • +
      • Use guides
        to help visually align things in your document. Guides are invisible rulers you can place on the canvas to align different text boxes, as well as centering objects. In almost every document, I create a vertical guide to split the page in two. Then you can use this guide to center objects much easier.
        • +
      • Use the "nudge" tool. Select an object and then use the arrow keys to move object a tiny bit at a time - .01 in, or .01 mm. Shift and Ctrl + Shift + Arrow will change the distance per 'nudge'
        • +
      • Save Paper - Instead of printing a proof, export a low res PDF and open in Acrobat Reader. A properly setup PDF will display on the screen with a great deal of fidelity to the printed page.
        • +
      • Use PNG, in place of jpeg or gif. PNG is a much more versatile image format and it usually prints much better at the same resolution. Most importantly, it uses lossless compression and compresses some types of images really well. Lastly, the GIMP, which most users have as their primary bitmap editor, does a superb job of handling PNG, as well as compressing them very well.
        • +
      • Get a good Ghostscript- The newest 8.5x versions are much better at helping Scribus import EPS and generating high quality print previews. Versions 8.5x+ allows the best print previews in Scribus as they enable proper transparency and CMYK previewing.
        • +
      • Get good fonts - By good fonts, we mean high quality Type 1 or TrueType fonts from foundries like Adobe Bitstream and Monotype. Luckily, the available MS Web fonts are also pretty reliable in PostScript printing. A good source of fonts is the collection of Bitstream fonts included with most versions of Corel Draw. We know people who have used these fonts for years and can't remember a font problem with these fonts. Most disks have the same font in Type and TrueType versions. Some Adobe applications, like Pagemaker or InDesign include a small collection of useful high quality Type 1 fonts. This will make printing and PDF creation much more reliable.
        • +
      • Master Pages can be big time saver. Anytime you have common elements on several pages, add those elements to a template. This also avoids accidently moving or deleting objects.
        • +
      • Backup your Preferences - This is more important for users of CVS versions of Scribus. Occasionally - much less common now, a program crash caused by a bad image etc., can corrupt your preferences. So, to get a good replacement setup, close Scribus and rename the hidden .scribus folder in your home directory to .scribusbak. Reopen Scribus with no document open and change every setting as you wish and then close Scribus. Now copy the whole directory somewhere else. Then, if you have weird behavior in Scribus, the first thing to do is copy the good .scribus directory over the current one and restart. This is also important if, you have lots of custom keyboard shortcuts.
        • +
      • A cool trick for precision adjustments. This may or may not work on your workstation, depending on how your wheel mouse is configured. You can use the mouse wheel with the spin boxes instead of clicking the arrows. For small steps, look carefully at the dialog below where I have put the cursor to the far right.Then spin the mouse wheel up and down to adjust the measurement or setting. This adjusts 10ths of a unit. For larger adjustments, put the cursor to the left side. For extra slow and precise adjustments 100th of a unit, Hold Crtl + Shift keys while moving the wheel mouse up and down.


        +
        Place the cursor as indicated by the arrow

        +
        • + +
      • Let Scribus do the math for you. +Almost every spinbox where you enter values with measurements can magically do math. You can mix and match units as well. Special units are: pageheight, pagewidth, height, width
      +
      + + + + + + + + + + + + + + + + + + + + +
      Some Example Calculations
      8.5in/3divide 8.5 inches by 3
      pagewidth/4divide the page width by 4 *This only works with points.
      width*2double the width of the selected object
      5in+2padd 2 picas to 5 inches
      +
      +
        +
      • Bonus - subscribe to the Scribus mailing list. You can get this in digest form daily. The list is active, polite and newbies and experts alike are welcome. Do not be shy to ask questions, Linux gurus might be new to DTP and vice versa. Scribus Mailing List Info If you have tips you would like to share post them to the list. We will ensure they are considered and credited properly.
        • +
      • Extra Bonus - How to ask questions and file bug reports/issues on the mailing list? First, in newer versions go to Help > About and include the build info. More details Then, look in the mailing list archives or on the Bug Tracker, you might find your answer there. Then, make sure you add relevant details like which distribution, version of Scribus, versions of relevant packages or libraries. e.g. version of X-org if you have video or font issues. This helps the developers and other knowledgable users to respond quicker and more accurately. Note: If you are using a CVS version of Scribus, please also include the build date.
        • +
      + + diff --git a/scribus/doc/it/translation_howto.html b/scribus/doc/it/translation_howto.html new file mode 100644 index 0000000..9a1ada6 --- /dev/null +++ b/scribus/doc/it/translation_howto.html @@ -0,0 +1,86 @@ + + + + How to create or update a translation of Scribus + + +

      How to create or update a translation of Scribus

      + +

      Scribus is available in over 20 languages, thanks to the many willing souls out there who have spent the time translating. This is no small task, but at least technically not a very difficult one. This page outlines the requirements and procedures for creating or updating such a translation.

      + +

      Please note that there are many willing contributors to the Scribus project, and there may already be a translation in progress for the language you wish to help for. It would be worthwhile asking on the mailing list to see if someone has started. This is also a courtesy matter. At this point we don’t really have any “official” translators but perhaps you can work together, or take over an old translation if the previous translator no longer has the time to keep it up-to-date. So, here we go ...

      +

      Part One: Translating the TS files

      + +

      Requirements

      +
        +
      • The Scribus source from SVN. Please see the Installation section for details on how to checkout SVN if you aren’t up with that yet. Its not too hard so don’t be dismayed. By working with the SVN source, you know you will be working with the latest Scribus source and therefore will get the most up-to-date set of files to translate.
        • +
      • Lokalize or Qt4 Linguist (do not use Qt3 linguist!). Both of these are available in their respective development packages. The choice of which one to use is more a user preference, the result will be the same. For those who are new to this kind of work, Qt4 Linguist may be the tool of choice, as it offers a very simple, yet efficient user interface. Moreover, it's availabe for all platforms that are supported by Scribus (Linux/UNIX, Mac OS X, Windows 2000+, OS/4 Warp4 and eComStation).
        • +
      • You will need to make sure you have the lupdate program installed, which is a part of Qt4, or perhaps a part of the Qt4 development package, depending on your distribution.
        • +
      + +

      Procedure for creating or updating a translation file

      +
        +
      1. Check out SVN.
        2. +
      2. Move into the ~/Scribus directory.
        3. +
      3. Run qmake -project.
        4. +
      4. Edit the Scribus.pro file to have the language listed at the bottom that you wish to translate for. For example, +
        + 
        TRANSLATIONS += resources/translations/po/scribus.en_GB.ts
        +
        +Of course, replace the en_GB in this example with the language code you are working with.
        5. +
      5. Run lupdate Scribus.pro.
        6. +
      6. Start your translation program and load the resources/translations/po/scribus.en_GB.ts file.
        7. +
      7. Perform the translations.
        8. +
      8. Save the .ts file and copy it into the source directory that contains the translation files (e.g. ~/Scribus/resources/translations).
        9. +
      9. If you want to test your translation before submitting it to the Scribus developers, delete the file CMakeCache.txt in your build directory (provided you have built Scribus from source before), rerun cmake as you did before, but now add the parameter -DWANT_GUI_LANG="xx_XX, where xx_XX is the language code for your translation, e.g. en_GB (British English) or pt_BR (Brazilian Portuguese).
        10. +
      10. If you only specified your translation as a parameter, this will the only UI language available. If you have built Scribus with more than one language, select your translation in File > Preferences.
        11. +
      +

      Part Two: Translating other parts of Scribus

      +

      Unfortunately or fortunately, depending on your point of view, not all parts of the Scribus user interface can be translated via ts files. In two cases you need to edit XML files to translate Scribus, namely for Templates and the Render Frame editor.

      +

      Translating Templates

      +

      To translate Template categories, names and decriptions, you need the file template.xml from the directory ~/Scribus/resources/templates. Save this file under a name that helps Scribus identify the language you are translating to, e.g. template.it.xml for Italian.

      +

      The content of the XML file is (hopefully) self-explanatory. There is an entry for each template. A complete entry looks like this: +

      +<template category="Newsletters">
+	<name>TextBased</name>
+	<file>textbased/textbased.sla.gz</file>
+	<tnail>textbased/textbasedtn.png</tnail>
+	<img>textbased/textbased.png</img>
+	<psize>A4</psize>
+	<color>color</color>
+	<descr>A decent newsletter/magazine originaly created for one non-profit organization. Unrealized unfortunately.</descr>
+	<usage>Right click on text replace what's inside with your own. Or whatever you want to... ;)</usage>
+	<scribus_version>1.2RC1cvs</scribus_version>
+	<date>2004-07-10</date>
+	<author>Petr Van&#283;k</author>
+	<email>petr@yarpen.cz</email>
+</template>
+
      +Fortunately, you need not (actually must not) translate everything in here. What needs a translation is only the strings that are in red in the example above.

      +

      Translating the Render Frame Editor

      +

      As described in Working with Render Frames, this kind of frame is freely configurable. Not only can you add configuration files for new programs, but you can also add translations to existing ones. In contrast to Templates, you don’t have to create new XML files for your translations. Instead, you need to edit the existing ones. The configuration files for Render Frames are located in ~Scribus/resources/editorconfig. There is a file for each program, e.g. 100_latex.xml for LaTeX, 300_lilypond.xml for Lilypond etc.

      +

      To make life easier for translators, the developer of the Render Frame plugin has placed an indicator for translatable text strings in the files, namely i18n, which is an acronym for “internationalization”:

      +
      +<title><i18n>
+	<en>Ranges</en>
+	<cs>Rozsahy</cs>
+	<de>Bereiche</de>
+	<fr>Rangées</fr>
+	<pl>Zakresy</pl>
+	<ru>&#1044;&#1080;&#1072;&#1087;&#1072;&#1079;&#1086;&#1085;&#1099;</ru>
+	<hu>Tartomány</hu>
+</i18n></title>
+
      +

      If you want to add a, say, Dutch translation, simply add a string like this to the list above: <nl>Bereik</nl>. Of course you should only submit a translated configuration file that’s complete to the development team!

      + +

      Submitting your translation

      +
        +
      • Once you are happy with the result of your hard work, please open your web browser, head to the Scribus Bugtracker and submit a new bug with the title of your translation update under the “Translation” category.

        +
      • Please note that as of Scribus 1.3.9 it is no longer necessary to upload qm files, as these will be generated at build time. Also note that the translation of the Templates and Render Frame files is optional.

        • +
      • If you want to be credited (and we prefer to give credit where credit is due!), please add your name and your email address to the bug report.
        • +
      • That’s it! When the next SVN release is made, your new translation will be added by the team. Usually, new translations are being added SVN within one or two days.
        • +
      +

      Translating the Online Help

      +

      Before you start translating the Online Help, you should be aware of the fact that this a huge task, and this doesn’t just refer to the skills or the time required to successfully complete the work. The documentation will be updated on a regular basis, which is why you should contact the team before you are wasting your time on translating files that are in the process of being rewritten or replaced. Also note that some basic HTML knowledge will help a lot, since all help files are written in HTML. Again, you are advised to contact the development team to learn about the rather strict HTML coding conventions for Scribus help files.

      + + diff --git a/scribus/doc/it/tutorials.html b/scribus/doc/it/tutorials.html new file mode 100644 index 0000000..171063a --- /dev/null +++ b/scribus/doc/it/tutorials.html @@ -0,0 +1,12 @@ + + + + Tutorials + + +

      Tutorials

      + +

      Real world experience helps a lot when it comes to using any software. Please visit the Scribus Wiki for more tutorials on how to perform specific tasks with Scribus. Among others, a great "Getting Started with Scribus" tutorial, orginally created by Niyam Bhushan and subsequently enhanced and translated into other languages by others, is available there. It covers basic layout theory, workflow and describes how to apply it to the creation of your next newsletter. It's not just about words and pictures on paper! Read this and find out why. You can directly access the tutorial from within Scribus via Help > Tutorials. + + + diff --git a/scribus/doc/it/workspace1.html b/scribus/doc/it/workspace1.html new file mode 100644 index 0000000..e7de5d1 --- /dev/null +++ b/scribus/doc/it/workspace1.html @@ -0,0 +1,71 @@ + + + + Scribus' Workspace + + +

      Scribus' Workspace

      + +

      Once you have assembled all the bits to create your first layout, it is time to begin working in Scribus. For previous users of page layout applications, launching Scribus for the first time will seem comfortable and familiar.

      + +

      Scribus has three different icon tool bars.

      +

      1) File Tools

      +
      Scribus Tool Bar

      +

      Left to Right: File New, File Save, Close File, Print and Export PDF.

      +

      File New will bring up the new document dialog with the default preferences, shown further below. File Save, Close File and Print all work as expected and the last Export PDF launches the PDF Export window.

      + +

      2) Edit/Selection Tools

      +
      Scribus Tool Bar

      +

      + +

      3) PDF Form Tools.

      +
      Scribus Tool Bar

      + + +

      Scribus toolbars are floatable and dockable in that they can move from the main window and float over the canvas or they can be "docked" below the menus or either side of the canvas.

      +
      Scribus Tool Bar

      + + + + + + +

      File > New brings up a dialog which has a number of options, the default is set in the preferences dialog under Edit - Preferences. Lets open the default and have a begin with importing text. Text in a Scribus layout is an object, so it can moved and manipulated very precisely.


      + +
      See Automatic Text Frames is checked

      + +

      Selecting Automatic Text Frames will create one text frame per page with the borders of the text frame determined by the page margins. You can also make the text within the text frame multi-colum, commonly used in newspaper and magazine layouts.

      + + + +

      Manually Creating Text Frames

      + +

      Now to create a text frame, click the Insert Text Box button on the top. Move the cursor to the upper left hand corner of the page canvas and left click drag to enlarge the frame. You can now either double click the frame or select the Text Cursor to begin editing. Scribus has its own built-in Story Editor, which is essentially a small built in text editor. The other way and the I recommend is to import your text directly. But before set the font, size and alignments first - then import the text - this saves editing time. +

      +

      You can further modify text frames by the Right Click, which brings up a context menu or using the measurements palette via Tools > Show Measurements. Both panels share many of the same editing features. The modify option adds some PDF and color options, which are not available on the measurements palette.

      + +Edit Mode vs. Select Mode + +

      Switching between modes at the beginning can be confusing to new users - learning drawing programs can cause similar frustration. You select something, but you cannot do anything with it directly. It is doubly confusing, because while you are in select mode, you can move a text or image frame. How you can tell and how can you switch?

      + +

      There are a couple of basic ways which you can use and select tools and objects. +To enable edit mode - simply double click the object, any object when double clicked will be in edit mode. The cursor will change from the cross, which is for moving selecting objects to the hand/text cursor. To exit, click the page canvas without touching other objects. This puts you back in select mode. Select mode is what you want when you want to move, delete, copy or resize. Edit mode is when you want to edit the contents of the frame. +

      +

      Moving the cursor near the border or corner of an object frame the cursor will change to a double arrow. This will resize an object frame in one direction. When resizing with the mouse, holding Shift, will constrain or retain the same shape. Holding the Control key will retain the object's proportion as well.

      + +

      When you select a image or text frame, the red squares are grab handles. For text frames, the corner squares can be used to resize the frame. The top and bottom squares in the middle are for resizing vertically by dragging.

      + +

      Text Frames - Scribus has many different features for text handling, including support for right to left languages such as Hebrew and Arabic. Moreover, Scribus has a built in hyphenation engine based on the same one used in Open Office -it works well and many languages are supported. There is also the ability to adjust tracking or spacing between letter pairs. You can squeeze text or spreeaaad it apart. Text boxes can be rotated, flipped and you can add them to paths, like following the arc of a circle. +

      + +

      The Basics:

      + +

      Click the text icon and drag a new frame on the page. Then Right Click > Properties from the contect menu. From there you can adjust the defaults. Including borders, the fill color and column gap, spacing of text from the text frame edge and others.

      + + + +
      Text Tab of Properties Palette

      + +

      In the palette above, note the Styles drop down button. Using Styles is strongly recommended for efficient text layout and styling. With properly used styles, you can change the entire look of a document with a few clicks.

      + + \ No newline at end of file -- cgit