r16520 by craig - #9879: Updated docs from Greg Pittman

scribus-commit scribus-commit at lists.scribus.net
Sat Mar 26 17:10:08 CET 2011


Author: craig
Date: Sat Mar 26 16:10:08 2011
New Revision: 16520

URL: http://scribus.info/websvn/listing.php?repname=Scribus&sc=1&rev=16520
Log:
#9879: Updated docs from Greg Pittman

Modified:
    trunk/Scribus/doc/en/cli.html
    trunk/Scribus/doc/en/index.html
    trunk/Scribus/doc/en/intro.html
    trunk/Scribus/doc/en/qsg.html
    trunk/Scribus/doc/en/readme.html
    trunk/Scribus/doc/en/specs.html
    trunk/Scribus/doc/en/topten.html

Modified: trunk/Scribus/doc/en/cli.html
URL: http://scribus.info/websvn/diff.php?repname=Scribus&rev=16520&path=/trunk/Scribus/doc/en/cli.html
==============================================================================
--- trunk/Scribus/doc/en/cli.html (original)
+++ trunk/Scribus/doc/en/cli.html Sat Mar 26 16:10:08 2011
@@ -5,7 +5,7 @@
 </head>
 <body>
 <h4>Scribus Command Line Reference</h4>
-<p>Just like any other program, Scribus can be launched from the command line. Below you find the command line options for Linux/UNIX. On other operating systems the parameters may have to be used differently.</p>
+<p>Just like any other program, Scribus can be launched from the command line. Below you find the command line options for Linux/UNIX (including Mac OS X). On other operating systems the parameters may have to be used differently.</p>
 
 <p>
 <ul>
@@ -33,4 +33,4 @@
 Downloads a file from our scribus server indicating latest available versions.</li>
 </ul>
 </body>
-</html>
+</html>

Modified: trunk/Scribus/doc/en/index.html
URL: http://scribus.info/websvn/diff.php?repname=Scribus&rev=16520&path=/trunk/Scribus/doc/en/index.html
==============================================================================
--- trunk/Scribus/doc/en/index.html (original)
+++ trunk/Scribus/doc/en/index.html Sat Mar 26 16:10:08 2011
@@ -15,9 +15,9 @@
 
 <!--marker for image gallery-->
 
-<p>Welcome to Scribus, an open source page layout program for Linux/UNIX, Mac OS X, OS/2 Warp 4, eComStation and Windows desktops.</p>
+<p>Welcome to Scribus, a page layout program for Linux/UNIX, Mac OS X, OS/2 Warp 4, eComStation and Windows desktops.</p>
 
-<p>Since its humble beginning in the spring of 2001, Scribus has rapidly evolved into one of the premier Open Source desktop applications. Encouraged by professionals and beginners alike, the Scribus Team, supported by a large and constantly growing number of enthusiastic contributors from all over the world, is dedicated to develop and improve &ldquo;one of the most powerful and useful open-source projects out there&rdquo; (TechRepublic). Scribus is now completely cross-platform and runs natively on Linux/Unix, Mac OS X, OS/2 Warp 4, eComStation and Windows.</p>
+<p>Since its humble beginning in the spring of 2001, Scribus has rapidly evolved into one of the premier Open Source desktop applications. Encouraged by professionals and beginners alike, the Scribus Team, supported by a large and constantly growing number of enthusiastic contributors from all over the world, is dedicated to develop and improve &ldquo;one of the most powerful and useful open-source projects out there&rdquo; (TechRepublic).</p>
 
 <p>Underneath a user-friendly interface, Scribus supports professional publishing features, such as CMYK colors, spot color support, ICC color management and versatile PDF creation.</p>
 

Modified: trunk/Scribus/doc/en/intro.html
URL: http://scribus.info/websvn/diff.php?repname=Scribus&rev=16520&path=/trunk/Scribus/doc/en/intro.html
==============================================================================
--- trunk/Scribus/doc/en/intro.html (original)
+++ trunk/Scribus/doc/en/intro.html Sat Mar 26 16:10:08 2011
@@ -21,7 +21,7 @@
 </i>
 </blockquote>
 
-<p>So, that&rsquo;s how the Scribus documentation started, but as Scribus attracted more developers, and the more ambitious the project became, the less maintainable the documentation appeared to be for a single person. As is natural with successful Open Source projects, more people volunteered to expand the scope of information available about Scribus. It started with the <a href="http://wiki.scribus.net/index.php/Main_Page">Scribus Wiki</a>, an ongoing successful collaborative effort, mostly written by users for users, and reached a climax with the publication of the <a href="http://www.amazon.com/Scribus-Open-Source-Publishing-Christoph-Sch%C3%A4fer/dp/0956078001/ref=sr_1_1?s=books&ie=UTF8&qid=1289106422&sr=1-1">Official Scribus Manual</a>.</p>
+<p>So, that&rsquo;s how the Scribus documentation started, but as Scribus attracted more developers, and the more ambitious the project became, the less maintainable the documentation appeared to be for a single person. As is natural with successful Open Source projects, more people volunteered to expand the scope of information available about Scribus. It started with the <a href="http://wiki.scribus.net/canvas/Scribus">Scribus Wiki</a>, an ongoing successful collaborative effort, mostly written by users for users, and reached a climax with the publication of the <a href="http://www.amazon.com/Scribus-Open-Source-Publishing-Christoph-Sch%C3%A4fer/dp/0956078001/ref=sr_1_1?s=books&ie=UTF8&qid=1289106422&sr=1-1">Official Scribus Manual</a>.</p>
 <p>But the documentation efforts didn&rsquo;t stop with the publication of a printed book, quite the contrary! A review of the available documentation showed that many documents, while appropriately describing Scribus&rsquo;s features at the time they were written, needed an update to reflect the vast number of features in Scribus that had been added in the meantime, whereas some workarounds for Linux-related issues simply aren&rsquo;t necessary any longer on modern Linux desktops.</p>
 <p>The growing complexity of Scribus also collided with the original concept of the documentation, which can be described as as a mix of a diary and a field report, with some additional elements of a manual for sysadmins. This approach was undoubtedly necessary at the time the original documentation was written, as Scribus was first and foremost a Linux program back then. Fortunately, the Linux desktop is very user-friendly these days, and Scribus has been ported to other platforms as well.</p>
 <p>As a result, the Scribus documentation can now focus on a more structured approach, which will provide much more information about the practical use of the program. The priceless background information from Peter Linnell in the original documentation will naturally survive, albeit in another form, i.e., it will be spread across those documents for which the respective information seems applicable. And of course Peter Linnell is still <b>mrdocs</b>, which is yet another reason to have great expectations when it comes to further improvements to the Scribus documentation&nbsp;...</p>

Modified: trunk/Scribus/doc/en/qsg.html
URL: http://scribus.info/websvn/diff.php?repname=Scribus&rev=16520&path=/trunk/Scribus/doc/en/qsg.html
==============================================================================
--- trunk/Scribus/doc/en/qsg.html (original)
+++ trunk/Scribus/doc/en/qsg.html Sat Mar 26 16:10:08 2011
@@ -38,11 +38,13 @@
 </p><p>If you haven't clicked somewhere else on screen, your new rectangle is still selected, which means it is outlined in red dots and so-called handles at each corner and the middle of a line. Now use <i>Windows &gt; Properties</i> or press F2 to bring up the <b>Properties Palette</b>, which is the Swiss Army Knife of Scribus. You will learn a lot more about its use later. For the time being, let's stay in the default tab of this dialog, which is called &ldquo;X,Y,Z&rdquo;. The more complex a document is, the more useful it is to give each object a unique name. It will make it easier to find and to select it later on. Not surprisingly, we'll call our Shape &ldquo;Background&rdquo;.
 
 </p><p>Next, make our rectangle match the size of the page. Remember the values we chose for the page? Insert them here, but first don't forget to click on the chain symbol to the right of the boxes for changing the values for width and height. If you try to do this without unlinking that chain, you will see that a change in one value changes the other in a proportional way, and it will seem like you are forever stuck, which you will be until you unlink that chain.
-</p><p>Now that our rectangle has exactly the size of our page, you need to make sure that it matches the page borders by setting its X and Y positions to 0.000 &ndash; if you just delete what is there and replace with 0, then press Tab or Enter, Scribus will make the decimal point and other zeros for you.
+</p><p>Now that our rectangle has exactly the size of our page, you need to make sure that it matches the page borders by setting its X and Y positions to 0.000 &ndash; if you just delete what is there and replace with 0, then press Tab or Enter, Scribus will make the decimal point and other zeros for you.</p>
 
 <table width="100%"><tr><td align="center"><img src="images/Rembrandt4.png"/></td></tr></table> 
 
-</p><p>By default, Scribus uses &ldquo;None&rdquo; as the fill color for shapes, which is not what is needed here. Provided our shape is still selected, we use the Properties Palette again to assign new colors to it. For that purpose we select the &ldquo;Colors&rdquo; tab. From the list select &ldquo;Grey41&rdquo; as the Fill Color.</p>
+<p><i><b>Hint:</b> Now that you see how to do this manually, note that there is in 1.4.0 a new shortcut for creating a frame and filling to the margins. After you press S to activate the shape icon, now hold down the Shift key and click anywhere on the page &ndash; instantly you have a frame filled to the margins, in this case the entire page since we set our margins to 0.</i></p>
+
+</p><p>By default, Scribus uses &ldquo;Black&rdquo; as the fill color for shapes, which is not what is needed here. Provided our shape is still selected, we use the Properties Palette again to assign new colors to it. For that purpose we select the &ldquo;Colors&rdquo; tab. From the list select &ldquo;Grey41&rdquo; as the Fill Color.</p>
 <p>Each shape and each frame in Scribus has a border. In the case of shapes the default color is always black. Since we don't want any color for our Frame border, click on the symbol with the brush and select the color &ldquo;None&rdquo;, which is always at the top of the list.
 
 <table width="100%"><tr><td align="center"><img src="images/Rembrandt5.png"/></td></tr></table> 

Modified: trunk/Scribus/doc/en/readme.html
URL: http://scribus.info/websvn/diff.php?repname=Scribus&rev=16520&path=/trunk/Scribus/doc/en/readme.html
==============================================================================
--- trunk/Scribus/doc/en/readme.html (original)
+++ trunk/Scribus/doc/en/readme.html Sat Mar 26 16:10:08 2011
@@ -1,22 +1,22 @@
 <html>
 <head>
 	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
-	<title>What&rsquo;s New in Scribus 1.3.9?</title>
+	<title>What&rsquo;s New in Scribus 1.4?</title>
 </head>
 <body>
-<h2>What&rsquo;s New in Scribus 1.3.9?</h2>
+<h2>What&rsquo;s New in Scribus 1.4?</h2>
 <p>This is a cursory overview over the changes in Scribus compared to to the latest stable version 1.3.3.14.</p>
 
-<p><b><i>Note that the file format has changed and is not backwardly compatible. We have specifically disabled the ability to open files created with 1.3.4 or later in the stable 1.3.3.x versions. Also note that 1.3.9 is still a development version and not considered stable yet.</i></b></p>
+<p><b><i>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.</i></b></p>
 <h3>General</h3>
 <ol>
-<li>On initial launch, 1.3.9 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.3.9. </li>
-<li>You <b>can</b> 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.3.9 in /opt or $home/bin on Linux/UNIX. If you&rsquo;re building Scribus from source, you can use the <code>-DCMAKE_INSTALL_PREFIX:PATH=</code> argument to configure where Scribus should be installed. On other platforms you can determine the location during the installation process.</li>
+<li>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 </li>
+<li>You <b>can</b> 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&rsquo;re building Scribus from source, you can use the <code>-DCMAKE_INSTALL_PREFIX:PATH=</code> argument to configure where Scribus should be installed. On other platforms you can determine the location during the installation process.</li>
 </ol>
-<h3>New in Scribus 1.3.9</h3>
+<h3>New in Scribus 1.4</h3>
 
 <h4>Qt4 Port</h4>
-<p>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&nbsp;X, as well as the creation of native DMGs for OS&nbsp;X. Scribus 1.3.9 DMGs will run on OS&nbsp;X 10.5+.</p>
+<p>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&nbsp;X, as well as the creation of native DMGs for OS&nbsp;X. Scribus 1.4 DMGs will run on OS&nbsp;X 10.5 or later.</p>
 
 <h4>Object Handling</h4>
 <ul>
@@ -29,7 +29,6 @@
 <h4>Text and Typography</h4>
 <h5><b>Typography:</b></h5>
 <ul>
-<li>Optical Margins.</li>
 <li>Glyph Extension</li>
 <li>Variable First Line Offset for text frames.</li>
 <li>Character Styles.</li>
@@ -39,9 +38,11 @@
 <li>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:</li>
 </ul>
 <br>
-<table width="100%"><tr><td align="center"><img src="images/new1.png" alt="Optical Margins" /></td></tr></table>
-<table width="100%">
-  <tbody>
+<table width="100%">
+  <tbody>
+    <tr>
+      <td align="center"><img src="images/new1.png" title="Optical Margins" alt="Optical Margins" /></td>
+    </tr>
     <tr>
       <td><div align="center"><i>Optical Margins</i></div></td>
     </tr>
@@ -52,6 +53,7 @@
 <ul>
 <li>Basic spellchecking via aspell (not available for Windows, OS/2 and eComStation).</li>
 <li>New text variable: Number of pages.</li>
+<li>Undo/Redo is finally available for text-related actions.</li>
 </ul>
 
 <h4>Vector Tools</h4>
@@ -204,7 +206,7 @@
 
 <h4>Help System</h4>
 <ul>
-<li>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.3.9+.</li>
+<li>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+.</li>
 <li>Many new tooltips have been added, and existing ones have been expanded.</li>
 <li>Online help resources are now accessible from the <i>Help</i> menu.</li>
 </ul>

Modified: trunk/Scribus/doc/en/specs.html
URL: http://scribus.info/websvn/diff.php?repname=Scribus&rev=16520&path=/trunk/Scribus/doc/en/specs.html
==============================================================================
--- trunk/Scribus/doc/en/specs.html (original)
+++ trunk/Scribus/doc/en/specs.html Sat Mar 26 16:10:08 2011
@@ -12,7 +12,7 @@
 	<li>Scribus uses an XML-based file format, so that Scribus files (SLA) can be easily edited with a text editor or manipulated via Scripts (Perl, Python etc.).</li>
 	<li>Frames that can be edited more flexibly than in most other DTP programs.</li>
 	<li>Master Pages and Page Palettes allow for easy page management</li>
-	<li>Document-wide layers: Items can be moved between layers, and it's possible to apply blend modes and transparancy to individual layers. </li>	
+	<li>Document-wide layers: Items can be moved between layers, and it's possible to apply blend modes and transparency to individual layers. </li>	
 	<li>Object linking, grouping, moving, locking, resizing and converting between different object types.</li>
 	<li>A sophisticated Scrapbook allows for easy sharing of design objects (such as text blocks, logo images, backgrounds etc.) between documents or via a network.</li>
 	<li>Render Frames allow for importing LaTeX formulas and other markup content directly into frames, as well as editing the markup code in an integrated editor.</li>
@@ -20,7 +20,7 @@
 <h3>Import Filters:</h3>
 <ul>
 	<li><b>Text:</b> Open Document Text (ODT), OpenOffice.org Writer 1 (SXW), HTML, MS Word (DOC), Comma Separated Values (CSV) and Plain Text in various encodings.</li>
-	<li><b>Bitmap Images:</b> Encapsulated PostScript (EPS), Graphics Interchange Format (GIF), JPEG, Portable Networks Graphic (PNG), Photoshop Document (PSD), Tagged Image File Format (TIFF) and X PixMap (XPM).</li>
+	<li><b>Bitmap Images:</b> Encapsulated PostScript (EPS), Graphics Interchange Format (GIF), JPEG, Portable Networks Graphic (PNG), Photoshop Document (PSD), Tagged Image File Format (TIFF), Windows/OS/2 bitmap (BMP), and X PixMap (XPM).</li>
 	<li><b>Vector Formats:</b> Adobe Illustrator (AI), Calamus Vector Graphics (CVG), Dia Shapes (SHAPE), Encapsulated PostScript (EPS), Kivio Stencils (SML), OpenDocument Graphics (ODG), OpenOffice.org Draw 1 (SXD), Macintosh PICT File (PICT), PostScript (PS), Scalable Vector Graphics (SVG, SVGZ), Windows Metafile (WMF) and Xfig (FIG).</li>
 	<li><b>Color Swatches:</b> Adobe Illustrator (AI), Encapsulated PostScript (EPS), GIMP Palette (GPL), OpenOffice.org Swatch (SOC) and PostScript (PS).</li>
 	<li><b>Other:</b> Almost all supported vector formats can also be opened as documents. In addition, there is an experimental PDF filter that can open some PDF files directly. PDF files can also be imported into image frames.</li>
@@ -69,7 +69,7 @@
 <li>Creation of color harmonies with the Color Wheel.</li>
 <li>Support for spot colors.</li>
 <li>A Search and Replace feature for solid colours.</li>
-<li>A large collection of color swatches, including those from commercial vendors (Note that the whole collection will only be available in the final 1.4 release).</li>
+<li>A large collection of color swatches, including those from commercial vendors.</li>
 </ul>
 <h3>Professional Publishing Features:</h3>
 <ul>
@@ -109,4 +109,4 @@
 	<li>Users needing to create interactive PDF forms, including CGI/PHP form submission via PDF, or PDF presentations.</li>
 </ul>
 </body>
-</html>
+</html>

Modified: trunk/Scribus/doc/en/topten.html
URL: http://scribus.info/websvn/diff.php?repname=Scribus&rev=16520&path=/trunk/Scribus/doc/en/topten.html
==============================================================================
--- trunk/Scribus/doc/en/topten.html (original)
+++ trunk/Scribus/doc/en/topten.html Sat Mar 26 16:10:08 2011
@@ -9,7 +9,7 @@
 <p>These are our top ten hints for using Scribus, in (some sort of) order:</p>
 
 <ul>
-<li><strong>Get the latest 7.0.x or 8. Adobe Reader&#174; installed.</strong><br /> 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 Acro Reader. <a href="toolbox1.html">More details..</a></li>
+<li><strong>Get the latest Adobe Reader&#174; installed.</strong><br /> 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. <a href="toolbox1.html">More details..</a></li>
 <li><strong>Tool Tips</strong><br />When, you are unsure of a function, <strong>use tool tips</strong>. 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 <strong>Help &#062; Tooltips </strong>is checked. Then hover your mouse over the check box or GUI option.</li>
 <li><strong>Use guides</strong><br /> 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.</li>
 <li><strong>Use the "nudge" tool.</strong> 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'</li>




More information about the scribus-commit mailing list