Svg Namespace/pl

Wprowadzenie
FreeCAD może importować i eksportować dokumenty SVG zawierające kod należący do określonej "przestrzeni nazw", która jest podzbiorem instrukcji XML.

Like any XML document an SVG document consist of two sections:
 * Head: just one line to declare which version of the XML language is used for the instructions in the body of this document.
 * Body: a list of instructions. SVG documents enclose all instructions in -tags.
 * The opening tag contains information about the size and the used SVG namespaces.

Default namespace
Domyślna przestrzeń nazw SVG używana przez FreeCAD jest zadeklarowana w tym wierszu:

Zewnętrzny link prowadzi do strony internetowej zawierającej informacje o przestrzeni nazw i jej zestawie instrukcji. Atrybuty tej przestrzeni nazw są używane bez przedrostka.



Rozszerzenie przestrzeni nazw
Attributes missing from the SVG namespace can be added by namespace extensions. FreeCAD uses such an extension for drawing templates. Templates for the Drawing workbench used four custom attributes which are marked with a "freecad:" prefix:
 * freecad:EditableText, this is still used with templates for the TechDraw workbench.
 * freecad:basepoint1
 * freecad:basepoint2
 * freecad:dimpoint

A namespace declaration is used to introduce the prefix and the link to the related web site, this page:

The link is not used to retrieve information or values at runtime, but it is the key to activate the custom attributes.

Drawing templates
In the SVG documents exported by FreeCAD's Drawing Workbench and used as (Drawing) page templates, the custom attributes can be used, originally for FreeCAD's own internal use, but could also be used by other FreeCAD-aware applications in the future. These attributes all use the freecad: namespace prefix. The namespace URL defined in those SVG documents refers to this page.
 * The Drawing workbench is no longer included in FreeCAD and so these Drawing templates are obsolate now.

TechDraw templates
The TechDraw workbench also uses SVG templates but can not create and export templates. It relies on freecad:EditableText for entries in title blocks.

Migration to freecad.org
Since the FreeCAD wiki, including this page, was migrated from freecadweb.org to freecad.org in version 0.21 the link has to be updated accordingly to:

Updated TechDraw templates now contain a key that can not activate the custom attributes when used with FreeCAD and as a result editable texts of recent templates are not recognised and so handled as plain text.
 * In such cases the "web" has to be manually re-inserted into the namespace declaration of the template.

Wygląda na to, że może obsługiwać oba adresy linków.

Użycie
Jeden piksel = jeden milimetr.

Musisz wstawić, gdzieś wewnątrz swojego kodu svg, gdzie chcesz, aby zawartość rysunku się pojawiła (na przykład na końcu pliku, tuż przed ostatnim znacznikiem  ), następującą linię:

Aby umożliwić drukowanie w skali, rzeczywisty rozmiar słowa musi być podany w atrybutach szerokość i wysokość znacznika SVG. Wielkość dokumentu w jednostkach użytkownika (px) musi być podana w atrybucie viewBox.

Poniższe dane mają być sformatowane jak w podanym przykładzie, gdzie:
 * xxx = szerokość piksela,
 * yyy = wysokość w pikselach.

Dodatkowe informacje dotyczące przestrzeni roboczej i bloku tytułu mogą zostać dodane i są zdefiniowane na stronie Szablony rysunków.

freecad:EditableText
Aby użyć któregokolwiek z atrybutów freecad: w dokumentach SVG, musisz najpierw zdefiniować przestrzeń nazw freecad jako atrybut otwierany znacznikiem :

Definiuje tekst w szablonie, który może być edytowany przez FreeCAD.

Przykład:

freecad:basepoint1
Określa pierwszy punkt obiektu Wymiarowanie (reprezentowanego jako grupa w dokumencie SVG). Atrybut ten jest używany podczas importu fragmentu SVG w programie FreeCAD, w celu odtworzenia obiektu wymiarowego. Grupa zawiera ścieżki i inne elementy graficzne do poprawnego renderowania obiektu wymiarowego w innych aplikacjach SVG.

Przykład:

freecad:basepoint2
Określa drugi punkt obiektu Wymiarowanie (reprezentowanego jako grupa w dokumencie SVG). Atrybut ten jest używany podczas importu fragmentu SVG w programie FreeCAD, w celu odtworzenia obiektu wymiarowego. Grupa zawiera ścieżki i inne elementy graficzne do poprawnego renderowania obiektu wymiarowego w innych aplikacjach SVG.

Przykład: zobacz freecad:basepoint1

freecad:dimpoint
Określa punkt obiektu Wymiarowanie, przez który przechodzi linia wymiarowa. Ten atrybut jest używany podczas importowania fragmentu SVG w programie FreeCAD, w celu odtworzenia obiektu wymiarowego. Grupa zawiera ścieżki i inne elementy graficzne do poprawnego renderowania obiektu wymiarowego w innych aplikacjach SVG.

Przykład: zobacz freecad:basepoint1



Przykład kodu freecad:EditableText
Ten przykład został przeniesiony z tabeli na arkusz A3 Poziomy



1 : Tytuł bez pola textedit




Objaśnienia
Początek struktury

Dane struktury

Początek bloku tekstu

Wszystkie informacje o tekście, który będzie wyświetlany

Współrzędne i identyfikator gdzie pojawi się tekst

Tutaj AuthorName jest zmienną zarządzaną przez freecad:editable, zapisującą ciąg znaków do zmiany, który zostanie wyświetlony

Współrzędne i identyfikator tekstu, który jest wyświetlany domyślnie, a   oznacza koniec tekstu bloku

Inne bloki tekstowe i koniec  struktury grupowania bloków tekstowych

Jest możliwe, że po pracy z plikiem SVG Inkscape'a plik już nie działa, możliwe, że zaginęły informacje.

Następnie sprawdź, czy tekst edycji nie jest zmodyfikowany

Przykład:
 * editable = "AuthorName"
 * zastąpiony przez freecad:editable = "AuthorName"



Inne dostępne atrybuty
Zobacz Szablony środowiska Kreślenie