request to build tutorials (0.47)

Also please build the tutorials in HTML format, upload them, update the doc page[1] and run the publish script.

[1] http://www.inkscape.org/doc/

basic tutorial attached. I selected all the text blocks and reduced font size to 7. This seems to correct the alignment issue.

AFAIK the tutorials are created from a xml source or something in the svn src because they have to be kept in sync with the translated versions... so - updating one output format (english version in svg) might be not so easy to apply to all other versions (lang, svg, html,…)?

SVN: <http://inkscape.svn.sourceforge.net/viewvc/inkscape/doc-docbook/trunk/>

The bug might have been introduced with Revision 21387: revision log message says:
   Regenerated all tutorials from inkscape-doc primarily to add new
   tutorials translated into Polish, but also those where some translations
   existed. Hopefuly not messed around too much.
<http://inkscape.svn.sourceforge.net/viewvc/inkscape?view=rev&revision=21387>

… or even anything (in the docbook sources or used java/saxon versions?) before rev. 21387 Thu May 21 22:56:38 2009 - I could not definitely figure out by browsing the online SVN tree when the 'trunk/share/tutorials/*.svg' files were rebuilt the last time before rev. 21387 (probably in 20349 or 17293).

The changes between the r21386 and r21387 svg tutorial files besides adding new translations seem to be at first sight
- differing numeric precisions
- all y-coordinates have a smaller value, the differences are cumulative (larger differences at the bottom of the page):

  tutorial-basic.svg:
  @@ -55,7 +55,7 @@
  […]
  -<rect id="d0e18" width="264" height="1000px" x="35" y="59.767967999999996" …
  +<rect id="d0e18" width="264" height="1000px" x="35" y="59.55703" …
  @@ -508,7 +516,7 @@
  […]
  -<g transform="translate(0, 4391.997163799999)"> …
  +<g transform="translate(0, 3890.9993593000004)"> …

- whereas all values of 'height' stay unchanged

Tutorial build committed revision 22268 (app. only).
Welcome to the new (basic and advanced) tutorials in SK!
It seems that the SVG files don't overlap anymore. Please check and comment.

Quick check (en & de) looks ok - thank you!

> (app. only)
?

> Please check and comment.
Do you mean on content or appearance? ;-) *nitpicking* anyway:

the advanced tutorial says:

"Note that Inkscape has its own internal clipboard; it does not use the system clipboard except for copying/pasting text by the Text tool. "

but this has changed since 0.46 - at least the release notes for 0.47 say otherwise:

"Clipboard is system-wide - you can now copy/paste objects between different Inkscape instances as well as between Inkscape and other applications (which must be able to handle SVG on the clipboard to use this). "

Thanks JN.

Looks readable now but there are now some characters with accents missing. Specifically if you look at the first paragraph of tutorial-advanced.sk.svg called "Techniky vkladania" the word "ukazovateľ" is missing an "ľ" and "prilepiť späť" are missing "ť". In the third paragraph, "Ď" is missing from "Ďalšia". Both .po file and .svg file say they're utf-8, still this looks like an encoding issue.

I'd be very grateful if you could take a look at this because I won't be able to do so. Thank you in advance.

@~suv. The tutorials shared on the website are not updated yet. I meant appearance, but it's also the right time to check the content. Thank! :)
@helix84. I take a close look as soon as possible.

Things to do before 0.47:
* Update .po files to reflect recent changes in the original (en) strings (see Bug #168428).
* Add missing images to some trace tutorials (see Bug #409230).
* Check Bug #398922 (not sure it is really a bug), Bug #381995, Bug #166730 (and all other bugs with tutorials keyword).
* Change advanced comment about clipboard, comment #8 (thanks ~suv!)

@helix84. The SVG strings are correctly written (open the text with the Text and Fonts menu...), but not totally rendered. The same problem affects (at least) the VI tutorials. Changing the default font (Bitstream Vera) to DejaVu resolves the bug. Strangely, both fonts work well if I copy the text in OpenOffice. Thus I think it's not related to tutorial building (Bug #234618 reports a very similar problem). Everything is OK on Ubuntu.

tutorial-tips.svg: Clipping or masking a bitmap

"By default, an imported bitmap (e.g. a photo) is an <image> element which is not editable by the Node tool. To work around this, convert the image into a rectangle with pattern fill by Object to Pattern (Alt+I). This will give you a rectangle filled with your bitmap. Now this object can be converted to path, node-edited, intersected with other shapes etc. In Inkscape Preferences (Misc tab), you can set the option of always importing bitmaps as pattern-filled rectangles. "

Release Notes 0.46: Other changes and improvements

"The option Import bitmap as <image> is removed; it was added several versions ago to allow optionally importing images as rectangles with image pattern, to make clipping the images easier. Now that you can easily use clipping paths, as well as convert any image to rectangle with pattern with Alt+I, this option is not really necessary and removed to reduce confusion. Bitmaps are always imported into SVG as an <image> element. "

tutorial-tips.svg: Hidden features and the XML editor

"The XML editor allows you to change almost all aspects of the document without using an external text editor. Also, Inkscape usually supports more SVG features than are accessible from the GUI. For example, we now support displaying masks and clipping paths, even though there's no GUI for creating or modifying them. The XML editor is one way to get access to these features (if you know SVG). "

Release Notes 0.44: Clipping and masking

"Inkscape now provides some UI for using clipping paths and masks. […]"

Release Notes 0.47: Node tool

"The Node tool can now edit clipping paths and masks of objects on canvas, without releasing them. If the selected object has a clipping path and mask, the corresponding buttons on the controls bar of the tool will be enabled; pressing these buttons will display the editable paths or handles of the clippath or mask. A clipping path is stroked green, a mask is stroked blue (the same colors as those used for them in Outline mode). "

Lots of fixes are now ok (all the basics, advanced, tracing and some tips). But some of them (tracing and tips) should be largely rewritten, and we don't have time for it before 0.47 is released. So let's consider the tutorials frozen so that the translators have time to translate their files.

I open a new report for the waiting changes.

Tutorials updated (advanced and tips) in revision 22362.

The website tutorials are up to date (revision 22510) in SVN (but not synchronized with the website yet).

The tutorials are now published on the website.

While I was updating http://inkscape.org/doc/index.php I noticed there's no html tutorial interpolate in zh_TW. Curiousuly, there's tutorial-interpolate.sl.html which doesn't have a .po file. I didn't check all tutorial/language combinations thoroughly.

I've noticed that the interpolate sl po file was missing. I can't find a trace of it in SVN. Maybe someone translated it directly in the html code...
There's no html for interpolate in zh_TW, as there's no po and svg.