Attached is the diff from the xml docbook file to assist translators to know what has changed. Other than added information, a number of contractions were removed to make translation a little more straightforward as well.

Unfortunately I didn't get to put examples for pressure and tilt in due to tilt being funky with current gtk on win32 (and it makes sense to add the examples together).

-Josh

Index: calligraphy/tutorial-calligraphy.xml =================================================================== RCS file: /cvsroot/inkscape/doc-docbook/calligraphy/tutorial-calligraphy.xml,v retrieving revision 1.2 diff -u -r1.2 tutorial-calligraphy.xml --- calligraphy/tutorial-calligraphy.xml 30 Apr 2005 18:59:03 -0000 1.2 +++ calligraphy/tutorial-calligraphy.xml 24 Oct 2005 16:58:03 -0000 @@ -2,8 +2,8 @@

<chapter id="CALLIGRAPHY"> <title>Calligraphy</title> -<author>bulia byak, buliabyak@...859...</author> -<!-- Copyright (C) 2004-5 bulia byak, buliabyak@...859... --> +<authors>bulia byak, buliabyak@...859... and josh andler, scislac@...859...</authors> +<!-- Copyright (C) 2004-5 bulia byak, buliabyak@...859... and josh andler, scislac@...1050...>

<abstract> <para> @@ -67,17 +67,34 @@ <title>Hardware</title>

<para> -You'll get the best results if you use a <firstterm>tablet and pen</firstterm> -(e.g. Wacom). However, even with mouse you can do some beginning calligraphy, though you -will have difficulty producing fast sweeping strokes. +You will get the best results if you use a <firstterm>tablet and pen</firstterm> +(e.g. Wacom). Thanks to the flexibility of our tool, even those with only a mouse can do +some fairly intricate calligraphy, though there will be some difficulty producing fast +sweeping strokes. </para>

<para> -Inkscape does not yet use <firstterm>pressure sensitivity</firstterm> of a tablet pen, -but that's not a problem because a traditional calligraphy pen (unlike a brush) is also -not very sensitive to pressure. Inkscape calligraphy pen can be sensitive to the -<firstterm>velocity</firstterm> of the stroke (see "Thinning" below), so if you are -using a mouse, you'll probably want to zero this parameter. +Inkscape is able to utilize <firstterm>pressure sensitivity</firstterm> and <secondterm> +tilt sensitivity</secondterm> of a tablet pen that supports these features. The sensitivity functions are disabled by +default because they require configuration. Also, keep in mind that calligraphy with a +quill or pen with nib are also not very sensitive to pressure, unlike a brush. +</para> + +<para> +If you have a tablet and would like to utilize the sensitivity features, you will need +to configure your device. This configuration will only need to be performed once and +the settings are saved. To enable this support you must have the tablet plugged in +prior to starting inkscape and then proceed to open the <firstterm>Input Devices...</firstterm> +dialog through the <emphasis>File</emphasis> menu. With this dialog open you can choose the +preferred device and settings for your tablet pen. Lastly, after choosing those settings, switch +to the Calligraphy tool and toggle the toolbar buttons for pressure and tilt. From +now on, Inkscape will remember those settings on startup. +</para> + +<para> +The Inkscape calligraphy pen can be sensitive to the <firstterm>velocity</firstterm> of +the stroke (see "Thinning" below), so if you are using a mouse, you'll probably want to +zero this parameter. </para> </sect1>

@@ -85,9 +102,10 @@ <title>Calligraphy Tool Options</title>

<para> -Switch to the Calligraphy tool by pressing <keycap>Ctrl+F6</keycap> or by clicking on -its toolbar button. On the top toolbar, you will notice there are 6 options: Width &amp; -Thinning; Angle &amp; Fixation; and Mass &amp; Drag. +Switch to the Calligraphy tool by pressing <keycap>Ctrl+F6</keycap>, pressing the <keycap>C</keycap> +key, or by clicking on its toolbar button. On the top toolbar, you will +notice there are 6 options: Width &amp; Thinning; Angle &amp; Fixation; and Mass &amp; Drag and two +buttons to toggle tablet Pressure and Tilt sensitivity on and off (for drawing tablets). </para>

<figure> @@ -113,8 +131,9 @@

<para> Since pen width is changed often, you can adjust it without going to -the toolbar, using the <keycap>left</keycap> and <keycap>right</keycap> arrow keys. The best thing about -these keys is that they work while you're drawing, so you can change +the toolbar, using the <keycap>left</keycap> and <keycap>right</keycap> arrow keys or with a +tablet that supports the pressure sensitivity function. The best thing about +these keys is that they work while you are drawing, so you can change the width of your pen gradually in the middle of the stroke: </para>

@@ -160,8 +179,10 @@

<para> After width, <firstterm>angle</firstterm> is the most important calligraphy -parameter. It is the angle of your pen in degrees, changing from 0 (horizontal) to 90 -(vertical counterclockwise) or to -90 (vertical clockwise): +parameter. It is the angle of your pen in degrees, changing from 0 (horizontal) to +90 (vertical counterclockwise) or to -90 (vertical clockwise). Note that if you +turn tilt sensitivity on for a tablet, the angle parameter is greyed out and +the angle is determined by the tilt of the pen. </para>

<figure> @@ -175,9 +196,10 @@ Each traditional calligraphy style has its own prevalent pen angle. For example, the Unicial hand uses the angle of 25 degrees. More complex hands and more experienced calligraphers will often vary the angle while drawing, and Inkscape makes this possible -by pressing <keycap>up</keycap> and <keycap>down</keycap> arrow keys. For beginning -calligraphy lessons, however, keeping the angle constant will work best. Here are -examples of strokes drawn at different angles (fixation = 1): +by pressing <keycap>up</keycap> and <keycap>down</keycap> arrow keys or with a tablet that +supports the tilt sensitivity feature. For beginning calligraphy lessons, however, +keeping the angle constant will work best. Here are examples of strokes drawn at +different angles (fixation = 1): </para>

<figure>