r18519 by gpittman - appearance improvements for 140 manual docs

scribus-commit scribus-commit at lists.scribus.net
Sat Sep 28 23:55:26 UTC 2013 

Author: gpittman
Date: Sat Sep 28 23:55:26 2013
New Revision: 18519

URL: http://scribus.net/websvn/listing.php?repname=Scribus&sc=1&rev=18519
Log:
appearance improvements for 140 manual docs

Modified:
    branches/Version14x/Scribus/scribus/doc/en/EditingShapes.html
    branches/Version14x/Scribus/scribus/doc/en/WwShapes.html
    branches/Version14x/Scribus/scribus/doc/en/images/node_edit_close.png
    branches/Version14x/Scribus/scribus/doc/en/images/numb-sections.png
    branches/Version14x/Scribus/scribus/doc/en/images/pathops4.png
    branches/Version14x/Scribus/scribus/doc/en/images/pathops5.png
    branches/Version14x/Scribus/scribus/doc/en/images/pathops6.png
    branches/Version14x/Scribus/scribus/doc/en/images/pathops7.png
    branches/Version14x/Scribus/scribus/doc/en/images/pathops8.png

Modified: branches/Version14x/Scribus/scribus/doc/en/EditingShapes.html
URL: http://scribus.net/websvn/diff.php?repname=Scribus&rev=18519&path=/branches/Version14x/Scribus/scribus/doc/en/EditingShapes.html
==============================================================================
--- branches/Version14x/Scribus/scribus/doc/en/EditingShapes.html (original)
+++ branches/Version14x/Scribus/scribus/doc/en/EditingShapes.html Sat Sep 28 23:55:26 2013
@@ -3,9 +3,12 @@
 	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
 	<title>Editing Shapes</title>
 </head>
-
+<style>
+ at import "manual.css";
+</style>
+<body>
 <h2>Editing Shapes</h2>
-Many of the objects that can be incorporated into a Scribus document are vector drawings, and as such can be edited. Even though the title seems to refer to the geometric shapes that can be easily created, the same procedures can be applied to all of these:
+<p>Many of the objects that can be incorporated into a Scribus document are vector drawings, and as such can be edited. Even though the title seems to refer to the geometric shapes that can be easily created, the same procedures can be applied to all of these:</p>
 <ul>
 <li>Shapes</li>
 <li>Polygons</li>
@@ -16,121 +19,122 @@
 <li>Outlines created from text glyphs</li>
 <li>Imported vector drawings, such as EPS and SVG</li>
 </ul>
-As you may be aware or recall, when you consider the ability to convert from one kind of object to another, there is a great deal of flexibility in what you can do. Here we have edited the shape of a text frame, then taken a large glyph, converted to an outline, then converted to an image frame, and finally we take a polygon and convert to a text frame. The final state of the object determines its editing capabilities, so the large B can be edited like any other image frame, the polygon can have its text edited in Story Editor.
+<p>As you may be aware or recall, when you consider the ability to convert from one kind of object to another, there is a great deal of flexibility in what you can do. Here we have edited the shape of a text frame, then taken a large glyph, converted to an outline, then converted to an image frame, and finally we take a polygon and convert to a text frame. The final state of the object determines its editing capabilities, so the large B can be edited like any other image frame, the polygon can have its text edited in Story Editor.</p>
 <table cellpadding=3><tr>
 <td><img src="images/edit_shapes.png" ALT="Edit examples" ALIGN=left></td></tr>
 </table>
 
 <h3>Properties: Shape</h3>
 <table cellpadding=3><tr>
-<td>Here is our Shape tab from Properties, or at least the bigger part of it. We'll get to what's left (Fill Rules) farther down below in <b>Combining Polygons</b>. Let's look at the <b>Round Corners</b> item first, since it's a simple kind of edit, that does what it says. Since the spinbox is active, we know that the object this relates to is either a "regular" frame, like text, image, or render frame, or it's the rectangle shape (and not the 4-sided polygon). What the number in the spinbox refers to is the radius of the corner. You can keep going up on this until 2 adjacent rounding operations meet – if you start with a square, for example, you will end up with a circle. A rectangle looks more like a capsule with flattened sides and rounded ends. This could just as easily be a text or image frame.</td>
+<td><p>Here is our Shape tab from Properties, or at least the bigger part of it. We'll get to what's left (Fill Rules) farther down below in <b>Combining Polygons</b>. Let's look at the <b>Round Corners</b> item first, since it's a simple kind of edit, that does what it says. Since the spinbox is active, we know that the object this relates to is either a "regular" frame, like text, image, or render frame, or it's the rectangle shape (and not the 4-sided polygon). What the number in the spinbox refers to is the radius of the corner. You can keep going up on this until 2 adjacent rounding operations meet – if you start with a square, for example, you will end up with a circle. A rectangle looks more like a capsule with flattened sides and rounded ends. This could just as easily be a text or image frame.</p></td>
 <td rowspan=2><img src="images/prop_shape.png" ALT="Properties: Shape" ALIGN=right></td>
 </tr>
 <tr><td><img src="images/round_rectangle.png" ALT="Rounded rectangle" ALIGN=left></td></tr>
 </table>
 <table cellpadding=3><tr>
-<td>The next quickie edit is the icon with the drop-down arrow, next to the <b>Edit</b> button. The drop-down lists are the familiar ones from the toolbar shape icon, but this is a transformation, not making a new shape. Thus we can convert our capsule to a squat and overfed-looking Tux if we want.
-<p>In fact, we can do this with text and other frames as well, although you can expect the utility of a Tux-shaped text frame to be limited.
+<td><p>The next quickie edit is the icon with the drop-down arrow, next to the <b>Edit</b> button. The drop-down lists are the familiar ones from the toolbar shape icon, but this is a transformation, not making a new shape. Thus we can convert our capsule to a squat and overfed-looking Tux if we want.</p>
+<p>In fact, we can do this with text and other frames as well, although you can expect the utility of a Tux-shaped text frame to be limited.</p>
 </td>
 <td><img src="images/squat_tux.png" ALIGN=left></td></tr>
 </table>
 <h3>Edit Button</h3>
-<table cellpadding="3"><tr>
+<table cellpadding="3">
+<tr>
 <td align=center width=200><img src="images/shape_edit.png"></td>
-<td>Now we get to the main event here, editing a shape/frame with its nodes and control points. When you click the <b>Edit</b> button on the Shape tab, the <b>Nodes</b> dialog to the right pops up and your shape/frame is transformed something like what you see on the left, with these blue and magenta circles.
-<p>Something to note at the outset is that generally where there is a sharp corner in a shape you only see the blue nodes, but where there is a smooth curve of some sort, these magenta control points are visible, sticking out like antennae from the node. Actually, all of these nodes have control points, but you don't see them when they are at the same position as the node.</td>
-<td rowspan=3 valign=middle><img src="images/nodes_edit.png"></td>
+<td colspan="2"><p>Now we get to the main event here, editing a shape/frame with its nodes and control points. When you click the <b>Edit</b> button on the Shape tab, the <b>Nodes</b> dialog to the right pops up and your shape/frame is transformed something like what you see on the left, with these blue and magenta circles.</p>
+<p>Something to note at the outset is that generally where there is a sharp corner in a shape you only see the blue nodes, but where there is a smooth curve of some sort, these magenta control points are visible, sticking out like antennae from the node. Actually, all of these nodes have control points, but you don't see them when they are at the same position as the node.</p></td>
+
 </tr>
-<tr><td></td><td><img src="images/node_edit_close.png" ALIGN=right></td>
+<tr><td></td><td><img src="images/node_edit_close.png" ALIGN=right></td><td rowspan=2 valign="top"><img src="images/nodes_edit.png"></td>
 </tr>
-<tr><td colspan=2>As we begin to describe the usage of the shape edit dialog, let's use this numbering scheme to refer to the various buttons on the dialog to the far right. 
-<p>When the dialog first comes up, button <b>1</b> will be selected, in which case you can move the blue nodes using the mouse. In addition to moving individual nodes, you can click-drag a line segment between nodes and move the segment along with its nodes. The segment retains its size, shape, and orientation – adjoining line segments do the adjusting. 
-<p>If you click button <b>5</b>, you can then move the magenta control points. Once you have clicked on a node or control point it turns red, and at this point, in addition to moving it with the mouse, the <b>X-Pos</b> and <b>Y-Pos</b> spinboxes become active and refer to this selected point. If <b>Absolute Coordinates</b> is <b><i>not</i></b> checked, then these numbers are relative to the upper left corner of the bounding box for the frame or shape (<i>see What is a Bounding Box? below</i>). Let's mention at this point that all of our editing steps here are Undo-able, i.e. can be undone with <b>Ctrl-Z</b> in case you change your mind.
-<p>Button <b>2</b> allows for adding nodes, though they must be added somewhere along the line of the shape. Button <b>3</b> deletes the node you subsequently click on. The tooltip for button <b>4</b> says <i>Reset Control Points</i>, but it is not clear how to make this button active.
-<p>Button <b>6</b>, when clicked, allows for each individual control point to move independently. If button <b>7</b> is clicked, then the two control points at a node will arrange themselves on opposite side of a node and equidistant from it once either one is moved. This tends to produce a very smooth curved transition through the node. When a control point is selected, button <b>8</b> will be active and when clicked, resets the control point to its node's position.
-<p>Button <b>9</b> will split the curve/shape when it is checked – click this button, then click anywhere along the line. It will appear that a node has been created, like using button <b>2</b>, but actually there are now 2 nodes at that position, so that if you move one, you will see the line is broken. Button <b>10</b> performs the opposite procedure, by joining a broken curve or shape (<i>and can also be used to make a closed figure out of a Bezier curve</i>).
+<tr><td colspan=2><p>As we begin to describe the usage of the shape edit dialog, let's use this numbering scheme to refer to the various buttons on the dialog to the far right. </p>
+<p>When the dialog first comes up, button <b>1</b> will be selected, in which case you can move the blue nodes using the mouse. In addition to moving individual nodes, you can click-drag a line segment between nodes and move the segment along with its nodes. The segment retains its size, shape, and orientation – adjoining line segments do the adjusting. </p>
+<p>If you click button <b>5</b>, you can then move the magenta control points. Once you have clicked on a node or control point it turns red, and at this point, in addition to moving it with the mouse, the <b>X-Pos</b> and <b>Y-Pos</b> spinboxes become active and refer to this selected point. If <b>Absolute Coordinates</b> is <b><i>not</i></b> checked, then these numbers are relative to the upper left corner of the bounding box for the frame or shape (<i>see What is a Bounding Box? below</i>). Let's mention at this point that all of our editing steps here are Undo-able, i.e. can be undone with <b>Ctrl-Z</b> in case you change your mind.</p>
+<p>Button <b>2</b> allows for adding nodes, though they must be added somewhere along the line of the shape. Button <b>3</b> deletes the node you subsequently click on. The tooltip for button <b>4</b> says <i>Reset Control Points</i>, but it is not clear how to make this button active.</p>
+<p>Button <b>6</b>, when clicked, allows for each individual control point to move independently. If button <b>7</b> is clicked, then the two control points at a node will arrange themselves on opposite side of a node and equidistant from it once either one is moved. This tends to produce a very smooth curved transition through the node. When a control point is selected, button <b>8</b> will be active and when clicked, resets the control point to its node's position.</p>
+<p>Button <b>9</b> will split the curve/shape when it is checked – click this button, then click anywhere along the line. It will appear that a node has been created, like using button <b>2</b>, but actually there are now 2 nodes at that position, so that if you move one, you will see the line is broken. Button <b>10</b> performs the opposite procedure, by joining a broken curve or shape (<i>and can also be used to make a closed figure out of a Bezier curve</i>).</p>
 <p>Finishing out these first 3 rows, the unnumbered buttons next to the one we've labeled 10 flip the shape horizontally or vertically, respectively.</td>
 </tr></table>
 <h3>Skewing</h3>
 <table cellpadding=3><tr>
-<td>The first full row of buttons below the numbered ones are skewing operations. Each click on the button skews the shape in a small increment. Here we see the results of skewing using the 4 buttons, left to right, just like our images, each being clicked 10 times. Initially, the tops of all these shapes had the same Y-Pos.</td>
+<td><p>The first full row of buttons below the numbered ones are skewing operations. Each click on the button skews the shape in a small increment. Here we see the results of skewing using the 4 buttons, left to right, just like our images, each being clicked 10 times. Initially, the tops of all these shapes had the same Y-Pos.</p></td>
 <td><img src="images/skewing.png" ALT="Skewing Example"></td>
 </tr></table>
 <h3>Rotating, Enlarging, Shrinking</h3>
-Below the 4 rows of buttons we have spinboxes paired with buttons to the left. These are quite intuitive and the two buttons are complementary actions, for rotation, and then two ways to enlarge and shrink, either by percentage or number of points. Each click produces the amount of change indicated in the spinbox.
-<p>
+<p>Below the 4 rows of buttons we have spinboxes paired with buttons to the left. These are quite intuitive and the two buttons are complementary actions, for rotation, and then two ways to enlarge and shrink, either by percentage or number of points. Each click produces the amount of change indicated in the spinbox.</p>
+<p></p>
 <h3>What is a Bounding Box?</h3>
 <table cellpadding=3><tr>
 <td><img src="images/boundingbox.png" ALIGN=left></td>
 <td><img src="images/boundingbox1.png" ALIGN=left></td>
-<td>A <i>Bounding Box</i> is the rectangular space that defines the boundaries of a shape and all of its descriptive components. Here we see this illustrated on the far left, noting that the bounding box is much larger than the actual shape. When we go to edit mode in the near left, we see that the box must include all of the control points for the shape.
-<p>There is a constraint on the <b>X-Pos</b> and <b>Y-Pos</b> so that they cannot be less than 0.0 when referring to the Bounding Box, so you will not be able to use the spinboxes to move nodes or control points lower than this value. Nonetheless, they can be moved with the mouse and the bounding box's left upper corner will then reposition. Using <b>Absolute Coordinates</b> is another workaround, since these values can be less than zero.
-<p><b>Use Bounding Box</b> is one of the choices for Text Flow mode, as shown in the Shape tab graphic.
+<td><p>A <i>Bounding Box</i> is the rectangular space that defines the boundaries of a shape and all of its descriptive components. Here we see this illustrated on the far left, noting that the bounding box is much larger than the actual shape. When we go to edit mode in the near left, we see that the box must include all of the control points for the shape.</p>
+<p>There is a constraint on the <b>X-Pos</b> and <b>Y-Pos</b> so that they cannot be less than 0.0 when referring to the Bounding Box, so you will not be able to use the spinboxes to move nodes or control points lower than this value. Nonetheless, they can be moved with the mouse and the bounding box's left upper corner will then reposition. Using <b>Absolute Coordinates</b> is another workaround, since these values can be less than zero.</p>
+<p><b>Use Bounding Box</b> is one of the choices for Text Flow mode, as shown in the Shape tab graphic.</p>
 </td>
 </tr></table>
 <br clear=all>
 <h3>Finally: What is a Contour Line?</h3>
-Or maybe we should say, what is it for? A contour line is itself never visible, except in this editing mode. Let's imagine you have a frame/shape which is not rectangular, and you wish to flow around it, but not necessarily follow the contours of the frame/shape. Even if it's a shape and has a bounding box, as we saw above sometimes the bounding box is not what we want either, therefore we can use a contour line to flow in our precisely desired way. While you are editing your contour line, you will see the text flow change to help you get the look you want.
+<p>Or maybe we should say, what is it for? A contour line is itself never visible, except in this editing mode. Let's imagine you have a frame/shape which is not rectangular, and you wish to flow around it, but not necessarily follow the contours of the frame/shape. Even if it's a shape and has a bounding box, as we saw above sometimes the bounding box is not what we want either, therefore we can use a contour line to flow in our precisely desired way. While you are editing your contour line, you will see the text flow change to help you get the look you want.</p>
 <table cellpadding=3><tr>
 <td><img src="images/frame_shape_flow.png" ALIGN=left></td>
 <td><img src="images/contourline_flow.png" ALIGN=left></td>
 </tr></table>
-<p>Contour lines are not considered part of the graphic components, so therefore its nodes and control points can be outside the bounding box.
+<p>Contour lines are not considered part of the graphic components, so therefore its nodes and control points can be outside the bounding box.</p>
 <h3>Combining Polygons</h3>
-This operation really applies to both polygons and shapes, and mixtures of the two. The idea is to combine 2 or more shapes on different levels into a single one.
+<p>This operation really applies to both polygons and shapes, and mixtures of the two. The idea is to combine 2 or more shapes on different levels into a single one.</p>
 <table cellpadding=3><tr>
 <td><img src="images/combine_polygons.png"></td>
 <td><img src="images/combine_polygons1.png"></td>
 <td><img src="images/combine_polygons3.png"></td>
 </tr></table>
-This top row shows our starting point, with a shape overlapping a polygon, the shape having some transparency. In the middle, we select both by click-dragging the mouse around them, then select <b>Item > Combine Polygons</b> from the menu, to get what we see on the right. With this method, the colors derive from the bottom object.
+<p>This top row shows our starting point, with a shape overlapping a polygon, the shape having some transparency. In the middle, we select both by click-dragging the mouse around them, then select <b>Item > Combine Polygons</b> from the menu, to get what we see on the right. With this method, the colors derive from the bottom object.</p>
 <table><tr>
 <td><img src="images/combine_polygons2.png"></td>
 <td><img src="images/combine_polygons4.png"></td>
 <td><img src="images/combine_polygons5.png"></td>
 </tr></table>
-In the left graphic here, we selected the shapes by holding down Shift and clicking the cross shape first, then combined, so even if you combine more than two shapes this way, the colors derive from the first one clicked. The middle shows that our combined polygon has retained the transparency. On the right, we see the results of <b>Item > Split Polygons</b>. It is not recommended to Undo combined polygons, since results are unpredictable and may cause a subsequent crash, depending on what you do next.
-<p>Something else to point out here is that in the bottom row, the leftmost combination uses an <b>Even-Odd Fill Rule</b> from the Shape tab, and the middle uses <b>Non Zero</b>. <i>You apply the fill rule after you combine polygons</i>.
+<p>In the left graphic here, we selected the shapes by holding down Shift and clicking the cross shape first, then combined, so even if you combine more than two shapes this way, the colors derive from the first one clicked. The middle shows that our combined polygon has retained the transparency. On the right, we see the results of <b>Item > Split Polygons</b>. It is not recommended to Undo combined polygons, since results are unpredictable and may cause a subsequent crash, depending on what you do next.</p>
+<p>Something else to point out here is that in the bottom row, the leftmost combination uses an <b>Even-Odd Fill Rule</b> from the Shape tab, and the middle uses <b>Non Zero</b>. <i>You apply the fill rule after you combine polygons</i>.</p>
 <h3>Path Operations</h3>
-These are some improved methods for combining shapes and polygons in various ways. They can only be applied to shapes and polygons, not text or image frames, though once again, conversion to text or images frames is still possible later.
+<p>These are some improved methods for combining shapes and polygons in various ways. They can only be applied to shapes and polygons, not text or image frames, though once again, conversion to text or images frames is still possible later.</p>
 <table><tr><td><img src="images/pathops.png" alt="pathops.png" ALIGN=right></td>
-<td>Let's start with this situation, two standard shapes. First, select both shapes, and then select from the menu <br><b>Item > Path Tools > Path Operations...</b>
-<br>If you don't select both shapes, you will not be able to make this menu selection.</td>
+<td><p>Let's start with this situation, two standard shapes. First, select both shapes, and then select from the menu <br><b>Item > Path Tools > Path Operations...</b>
+<br>If you don't select both shapes, you will not be able to make this menu selection.</p></td>
 </tr><tr>
-<td><img src="images/pathops1.png" alt="pathops1.png" ALIGN=left></td>
-<td>What you get from this is the dialog to the left. 
-<br>Notice that a color has been assigned to the doughnut shape. This is merely for clarity to more easily see what will happen. If neither shape had a fill color, they would be assigned contrasting colors. <b>Swap Shapes</b> simply reverses the position of the two shapes, so that the first shape becomes the second.
-<p>Staying with this initial default choice of combining the shapes, we see to the right that we must choose which color the final shape will have – just as with <i>Combining Polygons</i>, the final shape can only have one set of colors for <b>Fill</b> and <b>Stroke</b>. As you can see, there is an option for choosing other colors for each, using the <b>Custom Colors</b> radio button.
-<p>What about the <b>Keep</b> button? If chosen, this will retain the elements of the shape. Perhaps best to illustrate the difference between the two with the examples below.
-<p>On the left below is when you do <i>not</i> check <b>Keep</b>, and to its right what happens when you <i>do</i> check <b>Keep</b>. It's also worth repeating that we stayed with using the First Shape for color choices.
+<td valign="top"><img src="images/pathops1.png" alt="pathops1.png" ALIGN=left></td>
+<td valign="top"><p>What you get from this is the dialog to the left. 
+<br>Notice that a color has been assigned to the doughnut shape. This is merely for clarity to more easily see what will happen. If neither shape had a fill color, they would be assigned contrasting colors. <b>Swap Shapes</b> simply reverses the position of the two shapes, so that the first shape becomes the second.</p>
+<p>Staying with this initial default choice of combining the shapes, we see to the right that we must choose which color the final shape will have – just as with <i>Combining Polygons</i>, the final shape can only have one set of colors for <b>Fill</b> and <b>Stroke</b>. As you can see, there is an option for choosing other colors for each, using the <b>Custom Colors</b> radio button.</p>
+<p>What about the <b>Keep</b> button? If chosen, this will retain the elements of the shape. Perhaps best to illustrate the difference between the two with the examples below.</p>
+<p>On the left below is when you do <i>not</i> check <b>Keep</b>, and to its right what happens when you <i>do</i> check <b>Keep</b>. It's also worth repeating that we stayed with using the First Shape for color choices.</p>
 <table><tr><td><img src="images/pathops2.png" alt="pathops2.png"></td><td><img src="images/pathops3.png" alt="pathops3.png"></td>
 </tr></table>
 </td>
 </tr></table>
 <h4>Other Choices</h4>
 <table>
-<tr><td ALIGN=center><b>Subtraction</b></td><td ALIGN=center><b>Intersection</b></td><td ALIGN=center><b>Exclusion</b></td><td ALIGN=center><b>Break Apart</b></td></tr>
+<tr><td ALIGN=center><p><b>Subtraction</b></p></td><td ALIGN=center><p><b>Intersection</b></p></td><td ALIGN=center><p><b>Exclusion</b></p></td><td ALIGN=center><p><b>Break Apart</b></p></td></tr>
 <tr><td><img src="images/pathops4.png" alt="pathops4.png"></td><td><img src="images/pathops5.png" alt="pathops5.png"></td><td><img src="images/pathops6.png" alt="pathops6.png"></td><td><img src="images/pathops7.png" alt="pathops7.png"></td>
 </tr>
 </table>
 <p>
 <table>
-<tr><td></td><td ALIGN=center><b>Break Apart pulled apart</b></td></tr>
-<tr><td width=450px VALIGN=top><b>Break Apart</b> has some interesting features. You may recall that above I said that the final shape could only have one sort of fill color, so what happened here? In contrast to all other choices, with <i>Break Apart</i> I can specify a color for the <i>intersection</i> of the two shapes, so here I have chosen a custom color. What you then find is the meaning of the <i>Break Apart</i> name – these are really 3 separate shapes now, which I can move apart if I wish. After that, conversion of these to other kinds of frames is also possible, as seen here, and also note that the upper right shape behaves as one image frame.
-<p>A final note with <i>Path Operations</i> is that <b>Undo</b> will likely have some effect, but will not reverse whatever operation you carried out here.</td>
+<tr><td></td><td ALIGN=center><p><b>Break Apart pulled apart</b></p></td></tr>
+<tr><td width=450px VALIGN=top><p><b>Break Apart</b> has some interesting features. You may recall that above I said that the final shape could only have one sort of fill color, so what happened here? In contrast to all other choices, with <i>Break Apart</i> I can specify a color for the <i>intersection</i> of the two shapes, so here I have chosen a custom color. What you then find is the meaning of the <i>Break Apart</i> name – these are really 3 separate shapes now, which I can move apart if I wish. After that, conversion of these to other kinds of frames is also possible, as seen here, and also note that the upper right shape behaves as one image frame.</p>
+<p>A final note with <i>Path Operations</i> is that <b>Undo</b> will likely have some effect, but will not reverse whatever operation you carried out here.</p></td>
 <td COLSPAN=3><img src="images/pathops8.png"></td>
 </tr>
 </table>
 <h3>Create Path from Stroke</h3>
-If you have a <i>single</i> shape selected, this will be an option under <b>Item > Path Tools</b>. The name for this operation is admittedly a bit obtuse, so once again simply showing what it does is more worthwhile.
+<p>If you have a <i>single</i> shape selected, this will be an option under <b>Item > Path Tools</b>. The name for this operation is admittedly a bit obtuse, so once again simply showing what it does is more worthwhile.</p>
 <table width=70% cellpadding=10><tr>
 <td><img src="images/pathtools.png"></td>
-<td>To do this, let's create a rectangular shape, and increase its stroke width to 10 points.<br>Now select <br><b>Item > Path Tools > Create Path from Stroke</b>,<br>at which point, your reaction is likely that nothing has changed, except if you had a fill color, it will have disappeared. Now, change the fill color from <i>None</i> to some color, here red, and then zoom in on your rectangle.</td></tr>
+<td><p>To do this, let's create a rectangular shape, and increase its stroke width to 10 points.<br>Now select <br><b>Item > Path Tools > Create Path from Stroke</b>,<br>at which point, your reaction is likely that nothing has changed, except if you had a fill color, it will have disappeared. Now, change the fill color from <i>None</i> to some color, here red, and then zoom in on your rectangle.</p></td></tr>
 <tr><td><img src="images/pathtools1.png"></td>
-<td>In the upper left corner of the rectangle, seen at about 900% zoom, we begin to understand what happened. The space which was formerly the border (stroke) is now the fill, and there has been applied a stroke to the boundaries of this (I have increased the hairline stroke to 1 point so that it is clearer).
-<p>If we had started with a red color to the stroke, then the new stroke would also have been red.</td></tr>
+<td><p>In the upper left corner of the rectangle, seen at about 900% zoom, we begin to understand what happened. The space which was formerly the border (stroke) is now the fill, and there has been applied a stroke to the boundaries of this (I have increased the hairline stroke to 1 point so that it is clearer).</p>
+<p>If we had started with a red color to the stroke, then the new stroke would also have been red.</p></td></tr>
 <tr><td><img src="images/pathtools2.png"></td>
-<td>To even better understand what has happened, let's convert this to an image frame and load an image. Now we can see that the space of the frame is limited to the original stroke space, so in a sense we have created a picture frame from this original rectangle.</td>
+<td><p>To even better understand what has happened, let's convert this to an image frame and load an image. Now we can see that the space of the frame is limited to the original stroke space, so in a sense we have created a picture frame from this original rectangle.</p></td>
 </tr></table>
 </body>
 </html>

Modified: branches/Version14x/Scribus/scribus/doc/en/WwShapes.html
URL: http://scribus.net/websvn/diff.php?repname=Scribus&rev=18519&path=/branches/Version14x/Scribus/scribus/doc/en/WwShapes.html
==============================================================================
--- branches/Version14x/Scribus/scribus/doc/en/WwShapes.html (original)
+++ branches/Version14x/Scribus/scribus/doc/en/WwShapes.html Sat Sep 28 23:55:26 2013
@@ -3,41 +3,44 @@
 	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
 	<title>Working with Shapes & Polygons</title>
 </head>
-
+<style>
+ at import "manual.css";
+</style>
+<body>
 <h2>Working with Shapes & Polygons</h2>
-
-In <a href="WwFrames.html">Working with Frames</a> there is information on manipulation of frames which is applicable to all frame types.  There we only explained how to start creation of shapes and polygons by using the appropriate toolbar icon, or using keyboard <b>S</b> or <b>P</b>.
-<p>With shapes and polygons, you have a number of choices to make with each about what kind of shape or polygon to create. All of these are vector drawings, so you can freely resize or edit them after creation. Let’s start with shapes.
+<p>In <a href="WwFrames.html">Working with Frames</a> there is information on manipulation of frames which is applicable to all frame types.  There we only explained how to start creation of shapes and polygons by using the appropriate toolbar icon, or using keyboard <b>S</b> or <b>P</b>.</p>
+<p>With shapes and polygons, you have a number of choices to make with each about what kind of shape or polygon to create. All of these are vector drawings, so you can freely resize or edit them after creation. Let’s start with shapes.</p>
 
 <h3>Shapes</h3>
 <table cellpadding=5><tr>
-<td>Shapes are a collection of predetermined shapes, and with version 1.4.x have been greatly increased in number. The default shape when you start Scribus is the simple rectangular shape which the icon shows. Just to the right side of the shape figure on the toolbar is an arrow for a drop down list of subselections. Once you select from a drop down category and specific type (click with the mouse), you see the toolbar icon change to your selected shape. <i>Note: the appearance of the Shapes icons has been enhanced in the image to the right – they will not appear as distinct as this.</i>
-<p>As stated in Working with Frames, the default line and fill color for shapes and polygons is “None.” You can change that for the current documents in <i>File > Document Setup > Tools > Shape (icon)</i>, and for future documents in <i>File > Preferences > Tools > Shape (icon)</i>.
-<p>Just like other frames, you simply click-drag from one corner of the shape to its opposite. If you hold down Shift while click-dragging, when you let up on the mouse the shape will fill to the margins of your page.</td><td>
-<img src="images/shapes8.png" ALT="Shapes Drop-down lists" ALIGN=right></td>
+<td valign="top"><p>Shapes are a collection of predetermined shapes, and with version 1.4.x have been greatly increased in number. The default shape when you start Scribus is the simple rectangular shape which the icon shows. Just to the right side of the shape figure on the toolbar is an arrow for a drop down list of subselections. Once you select from a drop down category and specific type (click with the mouse), you see the toolbar icon change to your selected shape. <i>Note: the appearance of the Shapes icons has been enhanced in the image to the right – they will not appear as distinct as this.</i></p>
+<p>As stated in Working with Frames, the default line and fill color for shapes and polygons is “None.” You can change that for the current documents in <i>File > Document Setup > Tools > Shape (icon)</i>, and for future documents in <i>File > Preferences > Tools > Shape (icon)</i>.</p>
+<p>Just like other frames, you simply click-drag from one corner of the shape to its opposite. If you hold down Shift while click-dragging, when you let up on the mouse the shape will fill to the margins of your page.</p></td>
+<td><img src="images/shapes8.png" ALT="Shapes Drop-down lists" ALIGN=right></td>
 </tr>
 </table>
 
 <table cellpadding=5 width="80%"><tr><td><img src="images/shapes7.png" ALT="Enter Object Size Dialog"></td>
-<td>Another option with shapes is to make your selection from the list, then simply click on the page, i.e., do not drag the mouse. This brings up a new dialog, <b>Enter Object Size</b>, in which you can make a shape of pre-determined dimensions.
-<p>This would be useful, for example, for making an exact square or circle. The <b>Origin</b> relates to the point on the page where you clicked to bring up this dialog.
+<td><p>Another option with shapes is to make your selection from the list, then simply click on the page, i.e., do not drag the mouse. This brings up a new dialog, <b>Enter Object Size</b>, in which you can make a shape of pre-determined dimensions.</p>
+<p>This would be useful, for example, for making an exact square or circle. The <b>Origin</b> relates to the point on the page where you clicked to bring up this dialog.</p>
 </td></tr>
 </table>
 <br clear=all>
 <h3>Polygons</h3>
-<table cellpadding=5><tr>
-<td>Polygons in Scribus are regular polygons, which when drawn with equal width and height dimensions, will have equal sides and angles. Default is for 4 sides (corners), although you may have anything from 3 to 999 sides. The Polygons icon will always show a pentagon, but by selecting Properties from the drop-down you get the dialog to the right. As you see, your choices here are restricted to the geometry of the polygon. You can set defaults for line and fill colors and shading, and line thickness in <i>File > Preferences > Tools > Shape (icon)</i> or in <i>File > Document Settings > Tools > Shape (icon)</i>. Your choices in <i>File > Preferences > Tools > Polygon (icon)</i> and in <i>File > Document Settings > Tools > Polygon (icon)</i> will be limited to what you see here in the <i>Polygon Properties</i> dialog.
-<p>Number of <b>Corners</b> and <b>Rotation</b> need no explanation, but note that the rotation can be set in the spinbox or with the slider. <b>Apply Factor</b> is not so intuitive, but the small preview will quickly show you that a factor of less than 0% will bend the sides inward at the midpoint, and greater than 0% bend them outward. <b>Curvature</b> transforms the angulated bend into a curve instead.
-</td>
-<td><img src="images/polygons.png" ALT="Polygon Properties" ALIGN=right></td></tr>
+<table cellpadding=5>
+<tr><td align="center"><img src="images/polygons.png" ALT="Polygon Properties" ></td></tr>
+<tr><td><p>Polygons in Scribus are regular polygons, which when drawn with equal width and height dimensions, will have equal sides and angles. Default is for 4 sides (corners), although you may have anything from 3 to 999 sides. The Polygons icon will always show a pentagon, but by selecting Properties from the drop-down you get the dialog to the right. As you see, your choices here are restricted to the geometry of the polygon. You can set defaults for line and fill colors and shading, and line thickness in <i>File > Preferences > Tools > Shape (icon)</i> or in <i>File > Document Settings > Tools > Shape (icon)</i>. Your choices in <i>File > Preferences > Tools > Polygon (icon)</i> and in <i>File > Document Settings > Tools > Polygon (icon)</i> will be limited to what you see here in the <i>Polygon Properties</i> dialog.</p>
+<p>In 1.5+ we have new settings for <i>Polygon Properties</i>. Number of <b>Corners</b> and <b>Rotation</b> need no explanation, but note that the rotation can be set in the spinbox or with the slider.</p>
+<p><b>Apply Factor</b> allows the usage of the remaining settings. In this example, setting the <b>Factor</b> less than 0% causes the sides to bend inward in the middle. The <b>Inner Rotation</b> setting has shifted the bending points clockwise, and finally, <b>Outer Curvature</b> causes the line segments to bend outward.</p>
+</tr></td>
+
 </table>
-<p>The best way to learn what the various settings do is simply to play with them then see the results. If you draw your polygon with unequal width and height, you will see various kinds of distortions compared to the small preview window. Below are some variations on a 4 and a 7-sided polygon which you might try to duplicate. 
-<p>Just as with shapes, if you activate the polygons icon, then click the canvas, you will get the <b>Enter Object Size</b> dialog.
-<table><tr><td><img src="images/polygons1.png" ALT="Polygon examples" ALIGN=left></td></tr>
-</table>
+<p>The best way to learn what the various settings do is simply to play with them then see the results. If you draw your polygon with unequal width and height, you will see various kinds of distortions compared to the small preview window.</p>
+<p>Just as with shapes, if you activate the polygons icon, then click the canvas, you will get the <b>Enter Object Size</b> dialog.</p>
+
 <h3>Context Menu</h3>
-<table cellpadding=5><tr><td><img src="images/context_shape.png" ALT="Context Menu Shapes" ALIGN=right></td>
-<td>The context menu with shapes and polygons has fewer choices than with text or image frames.
+<table cellpadding=5><tr><td valign="top"><img src="images/context_shape.png" ALT="Context Menu Shapes" ALIGN=right></td>
+<td><p>The context menu with shapes and polygons has fewer choices than with text or image frames.</p>
 <ul>
 <li><b>Undo</b> is active only when there is some operation on the frame which can be undone.</li>
 <li><b>Redo</b> is only present when some action has been undone.</li>
@@ -58,5 +61,5 @@
 </td</tr>
 </table>
 <h4>Editing Shapes</h4>
-This will be handled in <a href="EditingShapes.html">its own section</a>, since it has much greater applicability than just to geometric figures.
+<p>This will be handled in <a href="EditingShapes.html">its own section</a>, since it has much greater applicability than just to geometric figures.</p>
 </html>

Modified: branches/Version14x/Scribus/scribus/doc/en/images/node_edit_close.png
URL: http://scribus.net/websvn/diff.php?repname=Scribus&rev=18519&path=/branches/Version14x/Scribus/scribus/doc/en/images/node_edit_close.png
==============================================================================
Binary files - no diff available.

Modified: branches/Version14x/Scribus/scribus/doc/en/images/numb-sections.png
URL: http://scribus.net/websvn/diff.php?repname=Scribus&rev=18519&path=/branches/Version14x/Scribus/scribus/doc/en/images/numb-sections.png
==============================================================================
Binary files - no diff available.

Modified: branches/Version14x/Scribus/scribus/doc/en/images/pathops4.png
URL: http://scribus.net/websvn/diff.php?repname=Scribus&rev=18519&path=/branches/Version14x/Scribus/scribus/doc/en/images/pathops4.png
==============================================================================
Binary files - no diff available.

Modified: branches/Version14x/Scribus/scribus/doc/en/images/pathops5.png
URL: http://scribus.net/websvn/diff.php?repname=Scribus&rev=18519&path=/branches/Version14x/Scribus/scribus/doc/en/images/pathops5.png
==============================================================================
Binary files - no diff available.

Modified: branches/Version14x/Scribus/scribus/doc/en/images/pathops6.png
URL: http://scribus.net/websvn/diff.php?repname=Scribus&rev=18519&path=/branches/Version14x/Scribus/scribus/doc/en/images/pathops6.png
==============================================================================
Binary files - no diff available.

Modified: branches/Version14x/Scribus/scribus/doc/en/images/pathops7.png
URL: http://scribus.net/websvn/diff.php?repname=Scribus&rev=18519&path=/branches/Version14x/Scribus/scribus/doc/en/images/pathops7.png
==============================================================================
Binary files - no diff available.

Modified: branches/Version14x/Scribus/scribus/doc/en/images/pathops8.png
URL: http://scribus.net/websvn/diff.php?repname=Scribus&rev=18519&path=/branches/Version14x/Scribus/scribus/doc/en/images/pathops8.png
==============================================================================
Binary files - no diff available.

More information about the scribus-commit mailing list