Subversion Repositories Scribus


Rev 18167 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
10646 cbradney 1
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
15136 cbradney 4
        <title>Document Settings and Preferences</title>
10646 cbradney 5
15136 cbradney 7
<h2>Document Settings and Preferences</h2>
16948 craig 8
<p>Under the <em>File</em> heading on the menu bar, you will find two related entries, <strong>Document Setup</strong> and <strong>Preferences</strong>. Each of these brings up a dialog used for changing various default settings and other behavior in Scribus:</p>
<li><strong>Document Setup</strong> will refer to the document being edited, and changes made for that document will be saved with the document and apply when it is re-opened. If you have no document open, you cannot select this dialog.</li>
<li><strong>Preferences</strong> in general changes settings for any future documents. It will be available whether or not you have any documents open. The following descriptions will primarily apply to Preferences, but we will point out differences compared with Document Setup as we go.</li>
15136 cbradney 15
<table cellpadding="5">
<tr><td width="200" valign="top"><ul>
<li><a href="#1"><strong>General</strong></a></li>
<li><a href="#2"><strong>Document</strong></a></li>
<li><a href="#3"><strong>Guides</strong></a></li>
<li><a href="#4"><strong>Typography</strong></a></li>
<li><a href="#5"><strong>Tools</strong></a></li>
<li><a href="#6"><strong>Hyphenation</strong></a></li>
<li><a href="#7"><strong>Fonts</strong></a></li>
17071 craig 24
<li><a href="#8"><strong>Preflight Verifier</strong></a></li>
15136 cbradney 25
<td width="300" valign="top"><ul>
16851 craig 27
15136 cbradney 28
<li><a href="#9"><strong>Color Management</strong></a></li>
<li><a href="#10"><strong>PDF Export</strong></a></li>
<li><a href="#11"><strong>Document Item Attributes</strong></a></li>
<li><a href="#11"><strong>Table of Contents and Indexes</strong></a></li>
<li><a href="#12"><strong>Keyboard Shortcuts</strong></a></li>
<li><a href="#13"><strong>Scrapbook</strong></a></li>
<td valign="top"><ul>
<li><a href="#14"><strong>Display</strong></a></li>
<li><a href="#15"><strong>External Tools</strong></a></li>
<li><a href="#16"><strong>Miscellaneous</strong></a></li>
<li><a href="#17"><strong>Plugins</strong></a></li>
<li><a href="#18"><strong>Short Words</strong></a></li>
<li><a href="#19"><strong>Scripter</strong></a></li>
<li><a href="#20"><strong>Document Information</strong></a></li>
<h3><a name="1"></a>General (not present in Document Setup)</h3>
16948 craig 46
<p>You may have started up Scribus in a particular <strong>Language</strong> &ndash; here we expect to see the system default language, but you can override that setting, which will remain on future startups until you change again.</p>
<p>The <strong>Theme</strong> will be whatever your main system theme is when none is selected, but otherwise your choices depend on your operating system or desktop environment and its available themes (if any). You can also change the size of the font used in the user interface. The various other settings are straightforward, and experimentation will be your guide.</p>
<p>The various &ldquo;paths&rdquo; are the default locations Scribus will use. The path for scripts is where Scribus looks when you choose <em>Scripts > Execute Script</em> from the menu bar.</p>
15136 cbradney 49
<table width="90%"><tr><td align="center"><img src="images/prefs_general.png" align="center" alt="Preferences: General" title="General Preferences" width="680"/></td></tr></table>
<h3><a name="2"></a>Document</h3>
16948 craig 51
<p>In Preferences, the various settings here will be those that you see when you create a new document (<em>File > New</em>). In the Document Setup, they will change the current document. The <strong>Page Size</strong> section should be easily understandable, with a large selection of standard sizes to choose from, in addition to <em>Custom</em>. The <strong>Document Layout</strong> choices have been the source of confusion for some. These simply apply to the relative placement of pages on your screen, and each will have the size as indicated, not some subdivision of it. <em>Double Sided</em> would typically be chosen for a book-like layout, and thus the First Page selector at the bottom allows the initial page to be Right or Left. This helps you use the appropriate <a href="pagetemplate1.html">Master Page</a> layout.</p>
15136 cbradney 52
<table width="90%"><tr><td align="center"><img src="images/prefs_document.png" align="center" alt="Default Document Settings" title="Default Document Settings"  width="680" /></td><td width="275"><img src="images/prefs_document1.png" width="250"><p>Here is an example of Double Sided, Right Page as the first (also happens to be two-column). If you print these on a local printer, they will print as individual pages.</td></tr></table>
16948 craig 53
<p><strong>Preset Layouts</strong> will be available for anything other than Single Page layout. What these represent are some time-honored ways to set the margins of the page, many based on some mathematical approach related to the dimensions of the page. Below we see the contrast of these various methods &ndash; these are all right pages of a double-sided layout.</p>
15136 cbradney 54
<p><table cellpadding="3"><tr>
<td align="center"><img src="images/prefs_gutenberg.png"><p>Gutenberg</td><td align="center"><img src="images/prefs_magazine.png"><p>Magazine</td><td align="center"><img src="images/prefs_fibonacci.png"><p>Fibonacci</td><td align="center"><img src="images/prefs_goldenmean.png"><p>Golden Mean</td><td align="center"><img src="images/prefs_9parts.png"><p>Nine Parts</td>
<h3><a name="3"></a>Guides</h3>
16948 craig 58
<p>Although labeled <strong>Guides</strong>, there are many other settings here, mostly related. Guides can either show above or below your content. <strong>Snapping: Snap Distance</strong> applies when <em>Page > Snap to Guides</em> or <em>Page > Snap to Grid</em> has been selected. <strong>Grab Radius</strong> has to do with the size of the virtual space for grabbing and dragging a frame&rsquo;s handles. As the tooltips indicate, you must shut down and restart Scribus for these to take effect when they are changed.</p>
<p>This panel sets the default distances and colors, as well as the snap to settings. <strong>Baseline Grids</strong> is the set of horizontal guides which forces text in multiple columns to align horizontally, as shown below. Settings for the distances for baselines are in Paragraph Styles, as well as the next panel <strong>Typography</strong></p>
559 cbradney 60
15279 cbradney 61
<table width="90%"><tr><td align="center"><img src="images/prefs_guides.png" alt="Guides and Baseline Grid Settings" align="middle" title="Guides and Baseline Grid Settings" /></td></tr></table>
15136 cbradney 62
<table width="80%"><tr><td valign="top">By default, Guides and Margins will show, but can be changed here, along with the color of each. Major and Minor Grids do not show by default &ndash; here we have changed the default colors so you can easily see the difference in the screenshot to the right, with page edges shown in red, margins in blue, major grid light green, and minor grid in light magenta.
16948 craig 63
<p>Finally, at the bottom of the dialog we can choose to show the baseline grid by default, and adjust its default settings.</p>
15136 cbradney 64
<p>Find out more about the baseline grid in <a href="WwText.html#10">Working with Text</a>.</td>
<td><img src="images/prefs_guides1.png"></td>
559 cbradney 68
15136 cbradney 69
<h3><a name="4"></a>Typography</h3>
16948 craig 70
<p>Here are the default settings for various typographic features &ndash; subscript, superscript, automatic line spacing and scaling of small capitals.</p>
<p>In addition, the amount of automatic linespacing can be adjusted relative to the size of the font. <em>Note that the 20% is in addition to the space required for the next line of text, so that the total space from one baseline to the next would be 120% of the font size.</em></p>
15279 cbradney 72
<p><table width="90%"><tr><td align="center"><img src="images/prefs_typog.png" align="center" alt="Typography Tab Panel"/></td></tr></table>
2811 mrdocs 73
15136 cbradney 74
<h3><a name="5"></a>Tools</h3>
<p>In the Tools tab you can change the defaults for text and image frames, shapes and polygons, and lines. In addition, there are page magnification settings, plus the defaults for duplication and rotation of objects.</p>
559 cbradney 76
15136 cbradney 77
<table width="100%">
15279 cbradney 78
<tr><td align="center"><img src="images/prefs_tools.png" alt="Tools Tab Panel"/></td>
<td><img src="images/prefs_tools1.png"/></tr>
<tr><td align="center"><img src="images/prefs_tools2.png" alt="Tools Tab Panel"/></td>
<td><img src="images/prefs_tools3.png"></tr>
<tr><td align="center" colspan="2"><img src="images/prefs_tools4.png" alt="Tools Tab Panel"/></td></tr>
<tr><td align="center"><img src="images/prefs_tools5.png">
<td align="center"><img src="images/prefs_tools6.png" alt="Tools Tab Panel"/></td></tr>
15136 cbradney 85
18475 gpittman 86
<h4>Some notes on Zoom/Magnification</h4>
<p>The default for the <em>Minimum</em> setting can be as low as 1%, while <em>Maximum</em> can go no higher than 3200%. Stepping is shown as a percentage, which only makes sense if you are going to a higher magnification. It would be better to think of this as a factor, where 200% = a factor of 2. Going upward, and starting at 100%, you then go to a factor of 2 (200%), of 4 (400%), of 8 (800%), and so on up to your maximum. Going downward, you go to a factor of 1/2 (50%), of 1/4 (25%), of 1/8 (12.5%), and so on down to your minimum. If you change your <em>Stepping</em> to 150%, for example, then 1.5 would be your factor.</p>
4422 mrdocs 88
18475 gpittman 89
<p>If what you want to do is to change the starting point, i.e., the default magnification of the page, then use the <em>Adjust Display Size</em> setting, as shown below under <a href="#14"><strong>Display</strong></a>.</p>
15136 cbradney 91
<h3><a name="6"></a>Hyphenation</h3>
4422 mrdocs 92
<p>Hyphenation details are described here: <a href="hyphenator.html">Hyphenation in Scribus</a>.</p>
15136 cbradney 94
<h3><a name="7"></a>Fonts</h3>
16948 craig 95
<p>Selecting and installing fonts correctly is one of the most important configuration items with Scribus, and an extensive set of notes is here: <a href="fonts1.html">Fonts and Scribus</a>. If there is one part of the documentation you really must read, it is this one.</p>
4422 mrdocs 96
15136 cbradney 97
<h3><a name="8"></a>Preflight Verifier</h3>
17071 craig 98
<p>See the information about <a href="print2.html">Printing Tools</a> to learn more about the configuration options in this panel.</p>
4422 mrdocs 99
15136 cbradney 100
<h3><a name="9"></a>Color Management</h3>
17071 craig 101
<p>There are detailed notes on this topic in the <a href="cms.html">Color Management</a> section.
15136 cbradney 102
<table width="90%"><tr><td align="center"><img src="images/prefs_colormgmt.png" alt="Color Management Preferences" title="Color Management Preferences" width="680" /></td></tr></table>
<p><em>Note: You will not be able to export to PDF/X-3 if color management is not enabled, and the Preferences settings for this format will likewise not be available.</em></p>
4422 mrdocs 104
15136 cbradney 105
<h3><a name="10"></a>PDF Export</h3>
<p>Remember that the settings here simply change the default values for PDF Export. You can still override any settings with the PDF Export dialog. For more info on PDF look at <a href="pdfexport1.html">PDF Export Options</a> and <a href="pdfx3.html">PDF/X-3 and Scribus</a>.</p>
4422 mrdocs 107
15136 cbradney 108
<table width="90%" cellpadding="5"><tr><td align="center"><img src="images/prefs_pdfexport.png" alt="PDF Export Preferences" title="PDF Export Preferences" width="680"/></td></tr>
16851 craig 109
<tr><td>New to Scribus 1.4.x is the inclusion of the ability to create bleeds, crop marks, and other printer marks as you export to PDF. Any bleed width is added to the page dimensions you selected when you created your document.
15136 cbradney 110
<p>Note here an example of what you see when you do not have ICC profiles installed &ndash; <strong>PDF/X-3 Output Intent</strong> is not available.</td></tr>
15279 cbradney 111
<tr><td align="center"><img src="images/prefs_pdfexport1.png" alt="PDF Export Preferences" title="PDF Export Preferences"/></td></tr></table>
4422 mrdocs 112
15136 cbradney 113
<h3><a name="11"></a>Documents Item Attributes</h3>
16948 craig 114
<p>Aside from storing additional information about a given item, this feature is currently most useful in connection with the creation of a table of contents.</p>
15136 cbradney 115
<h3>Table of Contents and Indexes</h3>
<p>These two subdialogs relate to each other. One use of these features is explained here: <a href=""></a></p>
4422 mrdocs 117
15136 cbradney 118
<h3><a name="12"></a>Keyboard Shortcuts</h3>
4422 mrdocs 119
15279 cbradney 120
<table width="90%"><tr><td align="center"><img src="images/prefs_keyboard.png" alt="Setting the Keyboard Shortcuts  for Scribus" title="Setting the Keyboard Shortcuts for Scribus"/></td></tr></table>
4422 mrdocs 121
16948 craig 122
<p>Here you see the various default keyboard shortcuts, which are editable, and many others can be assigned. Moreover, once customized, you can export them into a separate XML file that can be exported and saved separately, along with making it portable to other machines. The default file suffix is .ksxml. This is a Unicode file and should not have issues being transported across platforms, with the only caveat that Macs have an option and command meta key, where Linux, UNIX, OS/2, eComStation and Windows share common keyboards.</p>
15136 cbradney 123
<h3><a name="13"></a>Scrapbook</h3>
16948 craig 125
<p>With Scrapbooks, you can <em>right button</em> drag and drop frequently used items, including pictures, images and text files for quick placement. Scrapbooks can be saved with a file or independently of a document, as a separate Scrapbook which can be loaded use with many different Documents. Separate Scrapbooks are kept with a <code>.scs</code> designation. This panel sets the defaults for the thumbnail preview size of items in the Scrapbook palette and whether Scrapbooks should be saved automatically when changed.</p>
<h3><a name="14"></a>Display (not all of these are available in Document Settings)</h3>
15136 cbradney 127
<p>Most of these are pretty straightforward. Depending on the size of your screen, you can use this to adjust the rescale and rearrange your workspace. If you have plenty of space, you may want to adjust the display to accurately reflect your document size by default. Remember, you can adjust the magnification settings in <em>Tools > Zoom</em>.</p>
559 cbradney 128
15279 cbradney 129
<table width="90%"><tr><td align="center"><img src="images/prefs_display.png" alt="Display Settings" title="Display Settings" /></td></tr></table>
559 cbradney 130
16948 craig 131
<p>The Colors tab allows for customization of the colors used for various screen features, such as marking the margins, grids, and guides. In Document Settings only Fill Color is available. It&rsquo;s also worth mentioning here that the Fill Color only has to do with the <em>appearance</em> of the document background and is not printed or exported to PDF.
15136 cbradney 132
<h3><a name="15"></a>External Tools</h3>
16948 craig 133
<p>This panel enables you to change the default settings for the location of Ghostscript and other external programs. If you have installed Ghostscript before installing Scribus, it is usually detected automatically. If you receive an error message indicating that EPS files cannot be used, this is where the settings can be changed to allow Scribus to find the correct location of Ghostscript.</p>
18167 gpittman 135
<p><strong>Linux, UNIX, OS/2, eComStation, Haiku and Windows:</strong></p>
15136 cbradney 136
<table width="90%"><tr><td align="center"><img src="images/prefs_exttools.png" alt="External Tools Settings" title="External Tools Settings" width="680" /></td></tr></table>
18167 gpittman 137
<p>This particular screenshot comes from Linux and is also applicable to other UNIX systems. See the <a href="readme-haiku.html">Haiku</a>, <a href="readme-os2.html">OS/2 and eComStation</a> and <a href="readme-win32.html">Windows</a> specific information for these operating systems. Some additional information about Ghostscript can be found in <a href="toolbox7.html">Advanced Ghostscript.</a></p>
16948 craig 138
<p><strong>Mac OS X</strong></p>
4491 mrdocs 139
<table width="100%"><tr><td align="center"><img src="images/prefs-mac-1.png" alt="External Tools Settings" title="External Tools Settings" /></td></tr></table>
16948 craig 140
<p>Above are the recommended settings, provided you have correctly installed the <a href="readme-macosx.html">Ghostscript framework</a>.</p>
<h4>Other External Tools</h4>
<p><strong>Image Processing Tool</strong></p>
<p>You are not restricted to using GIMP for image editing, and could use any available image editor such as Krita, or even Photoshop. However, GIMP is set as the default application, as it&rsquo;s the most popular Open Source image editing software.
<p><strong>Web Browser</strong></p>
<p>Here you can set the path to the executable file of the browser that will be used if you click an external link in the Help Browser or select an external source from the <i>Help</i> menu.</p>
<p><strong>Render Frames</strong></p>
<p>See <a href="WwRenderframes.html">Working with Render Frames</a>.</p>
4920 mrdocs 148
4422 mrdocs 149
15136 cbradney 150
<h3><a name="16"></a>Miscellaneous</h3>
<table width="80%"><tr><td align="center"><img src="images/prefs_misc.png" title="Miscellaneous Settings"></td></tr></table>
<h3><a name="17"></a>Plugins</h3>
16948 craig 153
<p>This is an informational display about the various plug-ins you have at your disposal, how to use them, and where their libraries are located.
2811 mrdocs 154
15136 cbradney 155
<h3><a name="18"></a>Short Words</h3>
<img src="images/prefs_shortwords.png">
16948 craig 157
<p>Short Words is a plug-in to assist with adding non-breaking spaces to abbreviations like Mr. and measurements like km. Details on configuration and use are here: <a href="short-words.html">Short Words in Scribus</a>. </p>
4422 mrdocs 158
15136 cbradney 159
<h3><a name="19"></a>Scripter</h3>
16948 craig 160
<p>If the <a href="scripter1.html">Scripter plug-in</a> is activated at startup, you will not need to make any changes here to use the included Python scripts.</p>
<p>Scripter Extensions are special Scripter module or scripts which are loaded at startup to modify the abilities of the Python Scripter plug-in within Scribus. Details are <a href="scripter-extensions.html">here</a>. The Console tab is for choosing syntax highlighting colors within the Scripter Console.</p>
15136 cbradney 162
<h3><a name="20"></a>Document Information (available in Document Settings but not in Preferences)</h3>
16948 craig 163
See the section on <a href="docinfo.html">Document Information</a>.
<h3>Where Are the Preferences Files?</h3>
<p>Scribus&rsquo; preferences are kept in a hidden directory <code>.scribus</code>, the location of which is as follows:
4422 mrdocs 166
16851 craig 167
<li><strong>Linux/UNIX:</strong> <code>/home/username/.scribus</code></li>
16948 craig 168
<li><strong>Mac OS X:</strong> <code>User/username/.scribus</code></li>
<li><strong>OS/2 and eComStation</strong>: <code>X:\SCRIBUS-1.4.x-OS2-date\scribus\.scribus</code></li>
18167 gpittman 170
<li><strong>Haiku</strong>: <code>/boot/home/config/settings/Qt/.scribus</code></li>
16948 craig 171
<li><strong>Windows:</strong> <code>C:\Documents and Settings/username/.scribus</code></li>
15136 cbradney 172
17071 craig 173
<p>Within the directory are a <code>.scribus14.rc</code> file, a <code>scribusfont.rc</code> file (which preserves your font preferences) and a <code>prefs14.xml</code> file. These files are stored in XML format, so you can inspect and edit their contents with a text editor. If you have installed Python, there will also be a <code>scripter.rc</code> file that lists most recently used scripts. There are also several other directories, most which are comprised of configuration or history files. If you are encountering any issues with a previously working Scribus installation, <strong>renaming</strong>, not deleting, the <code>.scribus</code> directory may be a good idea. See the notes on <a href="fileproblems.html">Troubleshooting</a> for more information.</p>
4422 mrdocs 174
16851 craig 175
<p>See also</p>
<li><a href="fonts1.html">Font Setup</a></li>
<li><a href="hyphenator.html">Hyphenation</a></li>
<li><a href="docinfo.html">Document Information</a></li>
<li><a href="short-words.html">Short Words Plug-in</a></li>
<li><a href="color2.html">Managing Colors</a></li>
<li><a href="WwRenderframes.html">Working with Render Frames</a></li>
10646 cbradney 185
15136 cbradney 186