diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-13 11:50:49 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-13 11:50:49 +0000 |
commit | c853ffb5b2f75f5a889ed2e3ef89b818a736e87a (patch) | |
tree | 7d13a0883bb7936b84d6ecdd7bc332b41ed04bee /man | |
parent | Initial commit. (diff) | |
download | inkscape-upstream/1.3+ds.tar.xz inkscape-upstream/1.3+ds.zip |
Adding upstream version 1.3+ds.upstream/1.3+dsupstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man')
-rw-r--r-- | man/CMakeLists.txt | 26 | ||||
-rw-r--r-- | man/README | 7 | ||||
-rwxr-xr-x | man/fix-roff-punct | 140 | ||||
-rw-r--r-- | man/inkscape.de.pod.in | 862 | ||||
-rw-r--r-- | man/inkscape.fr.pod.in | 862 | ||||
-rw-r--r-- | man/inkscape.hu.pod.in | 847 | ||||
-rw-r--r-- | man/inkscape.ko.pod.in | 675 | ||||
-rw-r--r-- | man/inkscape.pod.in | 785 | ||||
-rw-r--r-- | man/inkscape.zh_TW.pod.in | 651 | ||||
-rw-r--r-- | man/inkview.de.pod.in | 150 | ||||
-rw-r--r-- | man/inkview.es.pod.in | 148 | ||||
-rw-r--r-- | man/inkview.fr.pod.in | 148 | ||||
-rw-r--r-- | man/inkview.hr.pod.in | 146 | ||||
-rw-r--r-- | man/inkview.hu.pod.in | 147 | ||||
-rw-r--r-- | man/inkview.ko.pod.in | 137 | ||||
-rw-r--r-- | man/inkview.pod.in | 136 | ||||
-rw-r--r-- | man/inkview.pt_BR.pod.in | 148 | ||||
-rw-r--r-- | man/inkview.zh_TW.pod.in | 134 | ||||
-rw-r--r-- | man/utf8-to-roff | 319 |
19 files changed, 6468 insertions, 0 deletions
diff --git a/man/CMakeLists.txt b/man/CMakeLists.txt new file mode 100644 index 0000000..f467560 --- /dev/null +++ b/man/CMakeLists.txt @@ -0,0 +1,26 @@ +# SPDX-License-Identifier: GPL-2.0-or-later + +# Load AUTHORS file contents into $INKSCAPE_AUTHORS +file(READ ${CMAKE_SOURCE_DIR}/AUTHORS content) +string(REGEX REPLACE "^([^\n#]+)\n" "\\1;\n" content_list "${content}") +join(INKSCAPE_AUTHORS "," "${content_list}") + + +file(GLOB podfiles *.pod.in) +foreach(podfile ${podfiles}) + get_filename_component(basename ${podfile} NAME) + string(REPLACE ".pod.in" "" basename ${basename}) + + set(POD_IN ${CMAKE_CURRENT_SOURCE_DIR}/${basename}.pod.in) + set(POD_OUT ${CMAKE_CURRENT_BINARY_DIR}/${basename}.pod) + + configure_file(${POD_IN} ${POD_OUT}) + + if(basename MATCHES "^inkscape") + pod2man(${POD_OUT} ${INKSCAPE_VERSION} 1 "Inkscape Commands Manual") + elseif(basename MATCHES "^inkview") + pod2man(${POD_OUT} ${INKSCAPE_VERSION} 1 "Inkview Commands Manual") + else() + message(WARNING "unexpected podfile: ${podfile}") + endif() +endforeach() diff --git a/man/README b/man/README new file mode 100644 index 0000000..f99ebc8 --- /dev/null +++ b/man/README @@ -0,0 +1,7 @@ +WARNING: Do not update these files directly! + +Their source can be found in the inkscape-docs project, see +https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/master/man + +If you need to update the man pages update inkscape.pod in the linked repository +and generate localized man pages using the scripts provided there. diff --git a/man/fix-roff-punct b/man/fix-roff-punct new file mode 100755 index 0000000..0a11f2f --- /dev/null +++ b/man/fix-roff-punct @@ -0,0 +1,140 @@ +#! /usr/bin/env perl +use strict; +use warnings; + +# fix-roff-punct: Fix up punctuation usage in automatically-generated +# troff files (man pages). + +# Authors: +# Peter Moulder <pmoulder@mail.csse.monash.edu.au> +# +# Copyright (C) 2004 Monash University +# +# Gnu GPL v2+: +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + +# Background: Humans use a number of dash-like characters: +# +# - ASCII hyphen/minus needed for command-line options and other computer +# input; +# - hyphen (`one-to-one'); +# - en dash (`2000-2003'); +# - em dash -- like this. [Not currently handled.] +# +# Troff input spells them as \-, -, \[en], \[em] respectively. (See the +# groff_char.7 man page for a full list of such punctuation characters.) If +# you run `man' with your LC_CTYPE indicating a rich character set like unicode +# (UTF-8 encoding), then it uses different output characters for each of the +# above. +# +# In particular, if your man page source has plain `-' when giving an example +# of a flag or command or other program input, then users won't be able to use +# mouse copy&paste from the formatted man page. + +# This script is something of a hack: it is only big enough to handle a few man +# pages of interest (produced by pod2man). You should manually check the +# changes it makes. + +# Approach: we handle each line a word at a time, and typically make the same +# hyphen-vs-ASCII decision throughout the word. We're a bit haphazard about +# word-splitting, but it's hard to find an example of where we'd be hurt by +# that, and by luck we would do the right thing for many gcc options like +# `-fconstant-string-class=\fICLASS-NAME\fR' (where CLASS-NAME should use a +# hyphen and the others should be ASCII hyphen-minus). +# +# Perl's /e (execute) flag for substitutions does just what we want +# for preserving non-word bits while transforming "words". +# +# We don't currently handle special things like `apt-get' that look like +# hyphenated english words but are actually program names. In general the +# problem is AI complete, e.g. `apt-gettable' could be either hyphen (gettable +# by apt) or ASCII hyphen-minus (able to be processed by the `apt-get' +# program). +# +# We don't currently take hints from font choice. (E.g. text in CR font should +# probably use ASCII hyphen-minus.) +# +# We currently only handle a couple troff requests and escapes (see groff.7). + +sub frob ($); + +my $yearRE = qr/(?:19[6-9]|20[013])[0-9]/; + +sub frob ($) { + my ($x) = @_; + + # Consider splitting into two words. + if ($x =~ m{\A(.*?)(\\(?:[&/,~:d]|f[BRI]|s-?[0-9]+))(.*)\z}) { + my ($before, $s, $after) = ($1, $2, $3); + return frob($before) . $s . frob($after); + } + + if ($x =~ m{\A(.*?)(\.+)\z}) { + my $d = $2; + return frob($1) . $d; + } + + # `32-bit', `5-page'. + if ($x =~ m{\A[0-9]+-[a-z]+\z}) { + return $x; + } + + # Year range: `(C) 1998-2003'. + if ($x =~ m{\A$yearRE\\?-$yearRE\z}) { + $x =~ s{\\?-}{\\[en]}; + return $x; + } + + # ISO date. + if ($x =~ m{\A$yearRE-[01][0-9]-[0-3][0-9]\z}) { + return $x; + } + + # Things likely to be computer input. + if ($x =~ m{[0-9]|\.[a-zA-Z]|\A(?:[-/.]|\\-|\[.*\]\z)}) { + $x =~ s/\\?-/\\-/g; + return $x; + } + + $x =~ s/\\?-/-/g; + return $x; +} + +while(<>) { + if ($_ eq '.tr \(*W-|\(bv\*(Tr' . "\n") { + # Get rid of pod2man's "helpful" munging of pipe symbol. + next; + } + + # Leave ASCII apostrophe unchanged (i.e. \[aq]) for examples. + if (/\A\\\& /) { + s/'/\\[aq]/g; # `\[aq]' = "ascii quote" + } + + if (/\A\.IP /) { + s/\\?-/\\-/g; + s/\\s\\-1/\\s-1/g; + } + elsif (/\A\.IX /) { + s/\\?-/-/g; + } + elsif (!/\A\. *(?:\\"|ds|if|ie)/) { + # As an optimization, we process only words containing `-'. + s{([.@/\\[:alnum:]]*-[-.@/\\[:alnum:]]*)}{frob($1)}ge; + } + print; +} diff --git a/man/inkscape.de.pod.in b/man/inkscape.de.pod.in new file mode 100644 index 0000000..81e668f --- /dev/null +++ b/man/inkscape.de.pod.in @@ -0,0 +1,862 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NAME + +Inkscape - ein Programm zum Bearbeiten von SVG-Dateien (Scalable Vector +Graphics). + +=head1 ÜBERSICHT + +C<inkscape [Optionen] [Dateiname1 Dateiname2 ...]> + +Optionen: + + -?, --help + --help-all + --help-gapplication + --help-gtk + + -V, --version + --debug-info + --system-data-directory + --user-data-directory + + -p, --pipe + --pdf-page=SEITE + --pdf-poppler + --convert-dpi-method=METHODE + --no-convert-text-baseline-spacing + + -o, --export-filename=DATEINAME + --export-overwrite + --export-type=DATEITYP[,DATEITYP]* + --export-extension=ERWEITERUNGS-ID + + -C, --export-area-page + -D, --export-area-drawing + -a, --export-area=x0:y0:x1:y1 + --export-area-snap + -d, --export-dpi=DPI + -w, --export-width=BREITE + -h, --export-height=HÖHE + --export-margin=WERT + + -i, --export-id=OBJEKT-ID[;OBJEKT-ID]* + -j, --export-id-only + -l, --export-plain-svg + --export-png-color-mode=FARBMODUS + --export-png-use-dithering=WAHRHEITSWERT + --export-ps-level=LEVEL + --export-pdf-version=VERSION + -T, --export-text-to-path + --export-latex + --export-ignore-filters + -t, --export-use-hints + -b, --export-background=FARBE + -y, --export-background-opacity=VALUE + + -I, --query-id=OBJEKT-ID[,OBJEKT-ID]* + -S, --query-all + -X, --query-x + -Y, --query-y + -W, --query-width + -H, --query-height + + --vacuum-defs + --select=OBJEKT-ID[,OBJEKT-ID]* + --actions=AKTION(:ARG)[;AKTION(:ARG)]* + --action-list + --actions-file=DATEINAME + + -g, --with-gui + -q, --active-window + --display=DISPLAY + --app-id-tag=TAG + --batch-process + --shell + + + +=head1 BESCHREIBUNG + +B<Inkscape> ist ein Freier Open Source Editor für Vektorgrafiken. Er bietet +vielfältige Funktionen und ist weit verbreitet bei der Bearbeitung von +künstlerischen und technischen Illustrationen, wie z.B. Comics, Clip Arts, +Logos, Typographie, Diagrammen und Flowcharts. Der Einsatz von +Vektorgrafiken erlaubt gestochen scharfe Ausdrucke und Wiedergabe bei +beliebiger Auflösung, ohne wie bei Rastergrafiken auf eine feste Anzahl von +Bildpunkten limitiert zu sein. Inkscape verwendet das standardisierte +B<SVG>-Dateiformat als Arbeitsformat, welches von vielen anderen Anwendungen +und Webbrowsern unterstützt wird. + +Die Benutzeroberfläche wurde so entworfen, dass die Arbeit für erfahrene +Nutzer komfortabel und zügig vonstatten geht, und ist gleichzeitig +kompatibel zu den B<GNOME>-Standards, damit Nutzer, die Erfahrung mit +anderen GNOME-Anwendungen haben, sich schnell darin zurechtfinden. + +B<SVG> ist ein durch den W3C standardisiertes XML-Format für +2D-Vektor-Zeichnungen. Es ermöglicht die Definition von Objekten in der +Zeichnung unter Verwendung von Punkten, Pfaden und einfachen Formen. Farben, +Schriftarten, Konturbreite und so weiter werden als `style'-Attributes +dieser Objekte definiert. Hierdurch soll ermöglicht werden, dass SVG-Dateien +in einer möglichst großen Anzahl von Programmen und für ein breites Spektrum +an Einsatzzwecken verwendet werden, da es standardisiert ist und die Dateien +im Text-/XML-Format vorliegen. + +B<Inkscape> verwendet SVG als natives Speicherformat und hat sich zum Ziel +gesetzt, das Open-Source-Zeichenprogramm für SVG-Dateien zu werden, das am +genauesten den entsprechenden Standard einhält. + + + +=head1 OPTIONEN + +=over 8 + +=item B<-?>, B<--help> + +Hilfe anzeigen + +=item B<--help-all> + +Alle Hilfeoptionen anzeigen + +=item B<--help-gapplication> + +Zeigt die GApplication-Optionen an + +=item B<--help-gtk> + +Zeigt die GTK+-Optionen an + +=item B<-V>, B<--version> + +Inkscape-Version und Erstellungsdatum anzeigen + +=item B<--debug-info> + +Gibt technische Informationen wie Inkscape-Version, die Versionen von +Abhängigkeiten und Betriebssystem aus. Diese Informationen sind wichtig um +Fehler in Inkscape zu beheben und sollten Teil jedes Fehlerberichts sein. + +=item B<--system-data-directory> + +Gibt das System-Datenverzeichnis aus, in dem die zusammen mit Inkscape +ausgelieferten Arbeitsdaten gespeichert sind. Diese umfassen Dateien die +Inkscape zur Ausführung benötigt (Definitionen der Einheiten, eingebaute +Tastaturbelegungen, Dateien die das Oberflächendesign beschreiben, +Symbolthemen, etc.), Kernerweiterungen, Standard-Ressourcen (Filter, +Schriftarten, Marker, Farbpaletten, Symbole, Vorlagen) und die Dokumentation +(SVG Beispieldateien, Tutorials). + +Der Pfad in dem Inkscape das System-Datenverzeichnis erwartet kann mit der +Umgebungsvariable L<INKSCAPE_DATADIR> überschrieben werden. + +=item B<--user-data-directory> + +Gibt den Benutzer-Profilordner aus, in dem benutzerspezifische Arbeitsdaten +und Einstellungen gespeichert werden. Zusätzliche Erweiterungen und +Ressourcen sollten vom Nutzer in die jeweils entsprechenden +Unterverzeichnisse in diesem Ordner installiert werden. Weiterhin können die +meisten Vorgaben aus dem System-Datenverzeichnis überschrieben werden, indem +eine Datei mit identischem Namen im Profilordner abgelegt wird +(z.B. Standardvorlagen, UI Dateien, etc.). + +Der Standardpfad des Profilordners kann mit der Umgebungsvariable +L<INKSCAPE_PROFILE_DIR> überschrieben werden. + +=item B<-p>, B<--pipe> + +Eingabedatei von der Standardeingabe (stdin) lesen. + +=item B<--pdf-page>=I<SEITE> + +Gibt die aus dem PDF zu importierende Seite an. Nummerierung startet bei 1. + +=item B<--pdf-poppler> + +Standardmäßig importiert Inkscape PDF-Dateien durch eine interne (von +Poppler abgeleitete) Bibliothek. Text wird als Text +gespeichert. Verlaufsgitter werden gekachelt dargestellt. Benutzung von +L<--pdf-poppler> bevorzugt den Import durch eine externe (Poppler mit cairo +Backend) Bibliothek. Text besteht aus Gruppen geklonter Zeichen, jedes +Zeichen ist ein Pfad. Bilder werden eingebettet gespeichert. Sind +Verlaufsgitter enthalten, wird das ganze Dokument als Rastergrafik +gerendert. + +=item B<--convert-dpi-method>=I<METHODE> + +Wähle die Methode um ältere (vor Version 0.92) Dateien neu zu skalieren, die +auf Grund der Umstellung von 90 DPI auf 96 DPI bei der Auswertung von +Längenangaben in Einheiten von Pixeln etwas kleiner dargestellt +werden.Mögliche Werte sind "none" (keine Änderung, Dokument wird mit 94% der +ursprünglichen Größe dargestellt), "scale-viewbox" (Dokument wird als Ganzes +neu skaliert, einzelne Längenangaben bleiben unverändert) und +"scale-document" (jede Längenangabe wird einzeln neu skaliert). + +=item B<--no-convert-text-baseline-spacing> + +Text-Grundlinien werden beim Öffnen von älteren (vor Version 0.92) Dateien +nicht repariert. Inkscape 0.92 hat die Definition der Eigenschaft +'line-height' aus dem CSS-Standard übernommen. Diese weicht nun von der in +älteren Versionen genutzten Definition ab. Standardmäßig werden die Werte +für Zeilenhöhe in Dateien, die vor dem Erscheinen von Inkscape 0.92 erstellt +worden sind, beim Laden angepasst, um das Erscheinungsbild des Textes zu +erhalten. Der Kommandozeilenbefehl bewirkt, dass die Anpassung nicht +vorgenommen wird. + +=item B<-o>, B<--export-filename>=I<DATEINAME> + +Legt den Namen der Ausgabedatei fest. Standardmäßig wird der Name der +Eingabedatei benutzt. Wird außerdem L<--export-type> benutzt, wird die +Dateierweiterung nach Bedarf angepasst (oder hinzugefügt). Andernfalls wird +der Dateityp aus der Erweiterung des angegebenen Dateinamens abgeleitet. + +Wir der spezielle Dateiname "-" verwendet, gibt Inkscape alle Bilddaten auf +die Standardausgabe (stdout) aus. + +=item B<--export-overwrite> + +Überschreibt die Eingabedatei. + +=item B<--export-type>=I<DATEITYP[,DATEITYP]> + +Gibt den Dateityp für den Export an. Mögliche Werte: svg, png, ps, eps, pdf, +emf, wmf und jeder andere Dateityp, für den eine Exporterweiterung verfügbar +ist. Es können auch mehrere Dateitypen gleichzeitig exportiert werden. + +Da PostScript keine Transparenz unterstützt, werden alle transparenten +Objekte aus dem Original-SVG automatisch in Rastergrafiken umgewandelt. Die +verwendeten Schriftarten werden unterteilt und eingebettet. Der +Standard-Exportbereich entspricht der Seitengröße, kann aber mit +L<--export-area-drawing> auf die Zeichnung beschränkt werden. + +Das PDF-Format behält Transparenzen in der Originaldatei bei. + +=item B<--export-extension>=I<ERWEITERUNGS-ID> + +Ermöglicht die Angabe einer Exporterweiterung, die für den Export verwendet +werden soll. Das ist inbesondere dann von Bedeutung, wenn für einen Dateityp +mehr als eine Exporterweiterung verfügbar ist. Wenn gesetzt, kann die +Dateierweiterung in --export-filename und --export-type weggelassen +werden. Allerdings kann in diesem Fall nur ein Dateityp in --export-type +angegeben werden. + +=item B<-C>, B<--export-area-page> + +Beim Export nach SVG, PNG, PDF und PS wird die gesamte Seite +exportiert. Dies ist die Standardeinstellung für SVG, PNG, PDF und PS, daher +braucht dies nicht angegeben zu werden - es sei denn, es wird L<--export-id> +verwendet, um ein bestimmtes Objekt zu exportieren. Für EPS wird diese +Option derzeit nicht unterstützt. + +=item B<-D>, B<--export-area-drawing> + +Beim Export nach SVG, PNG, PDF, PS und EPS wird die gesamte Zeichnung (nicht +die Seite), d.h. die äußere Begrenzung ist der Rahmen um alle Objekte im +Dokument (oder des exportierten Objektes, falls L<--export-id> verwendet +wird). Bei dieser Option enthält das exportierte Bild alle sichtbaren +Objekte des Dokumentes ohne zusätzlichen Rand oder Beschnitt. Für EPS ist +dies der Standard-Exportbereich. Beim Export nach PNG kann die Option in +Kombination mit L<--export-use-hints> verwendet werden. + +=item B<-a> I<x0:y0:x1:y1>, B<--export-area>=I<x0:y0:x1:y1> + +Geben Sie den Exportbereich beim PNG-Export in px (1/96 Zoll) +an. Standardmäßig wird die gesamte Dokumentseite exportiert. Der Punkt (0,0) +liegt in der unteren linken Ecke. + +=item B<--export-area-snap> + +Beim PNG-Export vergrößert sich hierdurch der Exportbereich auf den +nächsten, ganzzahligen px-Wert. Wenn die Standard-Export-Auflösung von 96 +dpi verwendet wird und die Grafik zur Minimierung von Antialiasing am +Pixel-Raster eingerastet ist, erlaubt diese Option die Erhaltung dieser +Ausrichtung, selbst wenn der Exportbereich von der Begrenzung eines Objektes +gebildet wird (mit L<--export-id> oder L<--export-area-drawing>), das selbst +nicht am Pixel-Raster ausgerichtet ist. + +=item B<-d> I<DPI>, B<--export-dpi>=I<DPI> + +Die Auflösung für den PNG-Export. Diese wird auch für die ersatzweise +Rasterisierung gefilterter Objekte beim Export nach PS, EPS oder PDF +verwendet (es sei denn, es wird L<--export-ignore-filters> verwendet, um die +Rasterisierung zu unterbinden). Standard sind 96 dpi, wobei 1 +SVG-Nutzer-Einheit (px, auch "user unit") 1 Bitmap-Pixel entspricht. Dieser +Wert ersetzt den DPI-Hinweis in der SVG-Datei, wenn gleichzeitig +--export-use-hints verwendet wird). + +=item B<-w> I<BREITE>, B<--export-width>=I<BREITE> + +Die Breite der generierten Rastergrafik in Pixeln. Dieser Wert hat Vorrang +vor der Option L<--export-dpi> (und dem DPI-Hinweis, falls mit +--export-use-hints verwendet). + +=item B<-h> I<HÖHE>, B<--export-height>=I<HÖHE> + +Die Höhe der erstellten Rastergrafik in Pixeln. Dieser Wert hat Vorrang vor +--export-dpi (oder dem DPI-Hinweis in der SVG-Datei, falls mit +--export-use-hints verwendet). + +=item B<--export-margin>=I<WERT> + +Fügt einen Rand zum Exportbereich hinzu. Die Randgröße wird in Einheiten der +Seitengröße (für SVG) oder in Millimetern (für PS/PDF) angegeben. Die Option +hat für andere Exportformate derzeit keine Funktion. + +=item B<-i> I<ID>, B<--export-id>=I<OBJEKT-ID[;OBJEKT-ID]*> + +Beim Export nach PNG, PS, EPS, PDF und normalem SVG: ID(s) des Objekts/der +Objekte, die exportiert werden sollen. Alle anderen Objekte werden nicht +exportiert. Standardmäßig ist der Exportbereich auf das Objekt +begrenzt. Dies kann mit L<--export-area> (nur für PNG) oder +L<--export-area-page> geändert werden. + +Wenn mehrere Objekte durch eine mit Komma getrennte Liste angegeben werden, +dann wird jedes separat exportiert. In diesem Fall werden die exportierten +Dateien nach dem Schema [dateiname]_[ID].[export_type] benannt. + +=item B<-j>, B<--export-id-only> + +Beim Export als PNG, PS, EPS, PDF und normales SVG wird nur das Objekt +exportiert, dessen id in L<--export-id> angegeben ist. Alle anderen Objekte +werden versteckt und sind im exportierten Bild nicht zu sehen, selbst wenn +sie über dem exportierten Objekt liegen. Ohne die Angabe von L<--export-id> +wird diese Option ignoriert. + +=item B<-l>, B<--export-plain-svg> + +Exportiert das/die Dokument(e) als normales SVG ohne jegliche sodipodi:- +oder inkscape:-Namensräume und ohne RDF-Metadaten. Um den Dateinamen +anzugeben wird die Option L<--export-filename> benutzt. + +=item B<--export-png-color-mode>=I<FARBMODUS> + +Bestimmt den Farbmodus (Bittiefe und Farbtyp) für exportierte Rastergrafiken +(Gray_1/Gray_2/Gray_4/Gray_8/Gray_16/RGB_8/RGB_16/GrayAlpha_8/GrayAlpha_16/RGBA_8/RGBA_16) + +=item B<--export-png-use-dithering>=I<false|true> + +Erzwingt Dithering oder deaktiviert es (der Inkscape-Build muss hierfür +Dithering auch unterstützen) + +=item B<--export-ps-level>=I<LEVEL> + +Setzt den Sprach-Level für den PS- und EPS-Export. Postscript Level 2 und 3 +werden unterstützt. Standard ist 3. + +=item B<--export-pdf-version>=I<VERSION> + +Wählt die PDF-Version für die exportierte PDF-Datei. Diese Option entspricht +der PDF-Versions-Auswahl im PDF-Export-Dialog der Benutzeroberfläche. Es +muss eine der Versionen aus der Auswahl verwendet werden, z.B. "1.4". Die +standardmäßig für den PDF-Export verwendete Version ist "1.4". + +=item B<-T>, B<--export-text-to-path> + +Konvertiert Textobjekte beim Export in Pfade, sofern sinnvoll (für PS, EPS, +PDF und SVG). + +=item B<--export-latex> + +(für den Export nach PS, EPS und PDF) Verwendung für die Erstellung von +Bildern für LaTeX-Dokumente, in denen der Text des Bildes von LaTeX gesetzt +werden soll. Beim Export in die Formate PDF / PS / EPS bewirkt diese Option +die Aufteilung der Ausgabe in eine PDF-/PS-/EPS-Datei (wie angegeben in +--export-type) und eine LaTeX-Datei. Der Text ist nicht in der +PDF-/PS-/EPS-Datei enthalten, sondern nur in der LaTeX-Datei. Diese +LaTeX-Datei bindet das PDF / PS / EPS ein. Wenn man nun diese LaTeX-Datei in +seinem LaTeX-Dokument einbindet ((\input{image.tex}), werden im +LaTeX-Dokument das Bild und der mit LaTeX gesetzte Text angezeigt. Weitere +Informationen finden sich in der resultierenden LaTeX-Datei. Siehe auch die +Terminalausgabe von GNUPlot zu `epslatex'. + +=item B<--export-ignore-filters> + +Exportiert gefilterte Objekte (z.B. solche mit Unschärfe) als Vektoren, und +ignoriert dabei die Filter (für Export nach PS, EPS und PDF). Standardmäßig +werden alle gefilterten Objekte mit der L<--export-dpi> (standardmäßig 96 +dpi) in Rastergrafiken umgewandelt, so dass sich ihr Aussehen nicht +verändert. + +=item B<-t>, B<--export-use-hints> + +Beim PNG-Export den Exportdateinamen und den DPI-Hinweis, die im zu +exportierenden Objekt gespeichert sind, verwenden. Diese Angaben werden +automatisch gesetzt, wenn man eine Auswahl aus Inkscape heraus +exportiert. Wenn man also eine Form mit id="path231" als /home/me/form.png +mit 300 dpi aus dokument.svg exportiert und danach das Dokument speichert, +kann man später mit folgendem Befehl die Form mit derselben Auflösung in +dieselbe Datei erneut exportieren: + + inkscape -i path231 -t dokument.svg + +Bei Verwendung von L<--export-dpi>, L<--export-width> oder +L<--export-height> zusammen mit dieser Option wird der DPI-Hinweis ignoriert +und der Wert von der Kommandozeile wird verwendet. Bei Verwendung von +L<--export-filename> mit dieser Option wird die Dateinamens-Angabe ignoriert +und der Dateiname von der Kommandozeile wird verwendet. + +=item B<-b> I<FARBE>, B<--export-background>=I<FARBE> + +Die Hintergrundfarbe für das exportierte PNG-Bild. Jeder Farbwert, der von +SVG unterstützt wird, ist möglich, z.B. "#ff007f" oder "rgb(255, 0, +128)". Falls nicht gesetzt, wird die Seitenfarbe, die in Inkscape in den +Dokumenteneinstellungen ausgewählt wurde, verwendet (gespeichert im Attribut +pagecolor= in sodipodi:namedview). + + + +=item B<-y> I<WERT>, B<--export-background-opacity>=I<WERT> + +Die Deckkraft des Hintergrundes des exportierten PNG-Bildes. Der Wert kann +zwischen 0.0 und 1.0 liegen (0.0 bedeutet vollständig transparent, 1.0 +vollständig deckend) oder aber zwischen 1 und 255 (255 ist volle +Deckkraft). Wenn dieser Wert nicht gesetzt wurde und Option -b nicht +verwendet wird, dann wird die Deckkraft, die in Inkscape im +Dokumenteneinstellungen-Dialog gewählt wurde, verwendet (gespeichert im +Attribut inkscape:pageopacity= von sodipodi:namedview). Wenn nicht gesetzt, +aber gemeinsam mit der Option -b verwendet, wird der Wert 255 (vollständig +transparent) verwendet. + +=item B<-I>, B<--query-id>=I<OBJEKT-ID[,OBJEKT-ID]*> + +Durch Komma getrennte Liste von IDs der Objekte, deren Größe abgefragt +werden soll. Wenn nicht gesetzt, wird die Größe der Zeichnung (d.h. des +Rahmens um alle Objekte im Dokument) zurückgegeben, nicht die Seitengröße +oder die viewBox. + +Wenn mehrere Werte als durch Komma getrennte Liste angegeben werden, dann +gibt jede Größen-Abfrage (z.B. L<--query-x>) eine durch Komma getrennte +Liste von Werten entsprechend der mit I<--query-id> angegebenen Liste von +Objekten aus. + +=item B<-S>, B<--query-all> + +Gibt eine komma-separierte Liste aller Objekte im SVG-Dokument mit einer ID +aus, zusammen mit den jeweiligen Werten für x, y, Breite und Höhe. + +=item B<-X>, B<--query-x> + +Fragt die X-Koordinate der Zeichnung oder des Objektes mit L<--query-id>, +falls angegeben, ab. Der zurückgegebene Wert hat die Einheit px +(SVG-Nutzer-Einheiten). + +=item B<-Y>, B<--query-y> + +Fragt die Y-Koordinate der Zeichnung oder des Objektes mit L<--query-id>, +falls angegeben, ab. Der zurückgegebene Wert hat die Einheit px +(SVG-Nutzer-Einheiten). + +=item B<-W>, B<--query-width> + +Fragt die Breite der Zeichnung oder des Objektes mit L<--query-id>, falls +angegeben, ab. Der zurückgegebene Wert hat die Einheit px +(SVG-Nutzer-Einheiten). + +=item B<-H>, B<--query-height> + +Fragt die Höhe der Zeichnung oder des Objektes mit L<--query-id>, falls +angegeben, ab. Der zurückgegebene Wert hat die Einheit px +(SVG-Nutzer-Einheiten). + +=item B<--vacuum-defs> + +Entfernt alle nicht verwendeten Elemente aus dem C<E<lt>defsE<gt>>-Abschnitt +der SVG-Datei. Wenn diese Option zusammen mit L<--export-plain-svg> +verwendet wird, wird nur die exportierte Datei dadurch verändert. Allein +verwendet, wird die angegebene Datei selbst verändert. + +=item B<--select>=I<OBJEKT-ID[,OBJEKT-ID]*> + +Der Befehl L<--select> wählt Objekte mit der angegebenen ID aus. Um mehrere +Objekte auszuwählen wird eine durch Komma getrennte Liste verwendet. Das +ermöglicht es, diese Objekte mit verschiedenen Verben zu +bearbeiten. C<--verb=EditDeselect> verwirft die gesamte Auswahl. Die +verfügbaren Objekt-IDs hängen vom Dokument ab, das geladen werden soll. + +=item B<--actions>=I<AKTION(:ARG)[;AKTION(:ARG)]*> + +Aktionen sind eine neue Methode um Funktionen mit einem optionalen Parameter +aufzurufen. Die Option L<--action-list> listed die IDs der verfügbaren +Aktionen auf. Alle Verben werden nach und nach durch Aktionen ersetzt. Bis +es so weit ist, kann jedes Verb auch als (parameterlose) Aktion verwendet +werden. Es ist zu beachten, dass die meisten Verben eine Benutzeroberfläche +benötigen (selbst wenn diese nicht aktiv genutzt wird). Um die +Benutzeroberfläche nach der Verarbeitung automatisch zu schließen kann die +Option L<--batch-process> genutzt werden. Zusätzlich gibt es zu allen +Export-Optionen passende Aktionen (zur Verwendung wird einfach der Prefix +'--' vor der Option entfernt und '=' durch ':' ersetzt). + +Wenn auschließlich Aktionen verwendet werden, muss L<--batch-process> +verwendet werden. + +Ein Export kann jederzeit durch die Aktion 'export-do' ausgelöst +werden. Dies ermöglicht mehrfache Exporte aus einer einzelnen Datei. + +=item B<--action-list> + +Zeigt alle zur Verfügung stehenden Aktionen an. + +=item B<--actions-file>=I<DATEINAME> + +Führt alle Aktionen aus, die in der angegebenen Datei aufgeführt sind. Die +Datei muss gemäß der Syntax von L<--actions> formatiert sein. Das Argument +L<--actions> wird ignoriert, wenn es gleichzeitig mit dieser Option +verwendet wird. + +=item B<-g>, B<--with-gui> + +Versucht, die grafische Oberfläche zu verwenden (unter Unix wird der +X-Server benutzt, selbst wenn $DISPLAY nicht gesetzt ist). + +=item B<-q>, B<--active-window> + +Der Befehl wird im zuletzt fokussierten Inkscape-Dokument ausgeführt, +anstatt einen neuen Inkscape-Prozess zu starten. + +=item B<--export-ps-level>=I<LEVEL> + +Bestimmt, welches X-Display für das Inkscape-Fenster verwendet werden soll + +=item B<--app-id-tag>=I<TAG> + +Erzeugt eine eindeutige Inkscape-Instanz mit der Anwendungs-ID +'org.inkscape.Inkscape.TAG'. Dies kann genutzt werden, um Inkscape-Instanzen +mit unterschiedlichen Versionen oder unterschiedlichen Einstellungsdateien +gleichzeitig laufen zu lassen. + +=item B<--batch-process> + +Schließt das Fenster nachdem alle Aktionen oder Verben ausgeführt wurden. + +=item B<--shell> + +Dieser Parameter bewirkt, dass Inkscape interaktiven +Kommandozeilenmodusgestartet wird. In diesem Modus gibt man Befehle im +Terminal ein und Inkscape führt diese aus, ohne dass für jeden Befehl eine +neue Instanz von Inkscape gestartet werden muss. Diese Funktion ist +hilfreich für die Verwendung mit Skripten und auf Servern: sie fügt keine +neuen Fähigkeiten hinzu, aber erlaubt die Ausführungsgeschwindigkeit und +Arbeitsspeicheranforderungen von Skripten zu optimieren, die Inkscape +wiederholt aufrufen und Kommandozeilenbefehle (wie Export oder Konversionen) +ausführen. + +Im interaktiven Kommandozeilenmodus erwartet Inkscape eine +aufeinanderfolgende Reihe von Aktionen (oder Verben) als Eingabe. Diese +werden zeilenweise verarbeitet, also typischerweise wen die Eingabetaste +gedrückt wird. Es ist möglich (aber nicht erforderlich) alle Aktionen in +eine einzelne Zeile zusammenzufassen. + +Diese Option kann mit dem Parameter L<--active-window> kombiniert werden, um +die Shell-Befehle in einem bereits geöffneten Inkscape-Dokument auszuführen. + +Folgendes Beispiel öffnet eine Datei und exportiert sie in zwei +unterschiedliche Formate, öffnet anschließend eine andere Datei und +exportiert ein einzelnes Objekt; + + file-open:datei1.svg; export-type:pdf; export-do; export-type:png; export-do + file-open:datei2.svg; export-id:rechteck2; export-id-only; export-filename:nur_rechteck.svg; export-do + +=back + +=head1 EINSTELLUNGEN + +Die Hauptkonfigurationsdatei liegt in +~/.config/inkscape/preferences.xml. Darin werden eine Vielzahl an +Einstellungen gespeichert, die in Inkscape geändert werden können (großteils +über den Einstellungsdialog). In den Unterverzeichnissen können auch eigene +Dateien abgelegt werden, und zwar für: + +B<$HOME>/.config/inkscape/extensions/ - Erweiterungen. + +B<$HOME>/.config/inkscape/fonts/ - Schriftarten. + +B<$HOME>/.config/inkscape/icons/ - Icons. + +B<$HOME>/.config/inkscape/keys/ - Tastenzuordnungs-Dateien. + +B<$HOME>/.config/inkscape/paint/ - Muster und Schraffuren. + +B<$HOME>/.config/inkscape/palettes/ - Farbpaletten. + +B<$HOME>/.config/inkscape/symbols/ - Symboldateien. + +B<$HOME>/.config/inkscape/templates/ - Vorlagen für neue Dateien. + +B<$HOME>/.config/inkscape/ui/ - Dateien für die Benutzeroberfläche. + +=head1 FEHLERSUCHE + +Das Programm gibt bei Erfolg eine Null zurück, bei einem Fehler einen von +Null verschiedenen Wert. + +Es können viele verschiedene Fehlernachrichten und Warnungen auf STDERR oder +STDOUT ausgegeben werden. Wenn das Programm sich mit einer bestimmten +SVG-Datei sonderbar verhält oder abstürzt, ist es hilfreich, diese Ausgabe +nach Hinweisen zu durchsuchen. + +=head1 BEISPIELE + +Obwohl B<Inkscape> offenkundig als grafische Anwendung konzipiert ist, kann +man damit auch SVG-Dateien über die Kommandozeile verarbeiten. + +Eine SVG-Datei in der Benutzeroberfläche öffnen: + + inkscape dateiname.svg + +Eine SVG-Datei mit der Standardauflösung von 96 dpi nach PNG exportieren +(eine SVG-Nutzer-Einheit entspricht einem Pixel in der Rastergrafik): + + inkscape --export-filename=dateiname.png dateiname.svg + +Dasselbe, aber erzwingt eine Größe von 600x400 Pixeln für die PNG-Datei: + + inkscape --export-filename=dateiname.png -w 600 -h 400 dateiname.svg + +Dasselbe, exportiert jedoch nur die Zeichnung (den Begrenzungsrahmen um alle +Objekte), nicht die Seite: + + inkscape --export-filename=dateiname.png --export-area-drawing dateiname.svg + +Exportiert zwei unterschiedliche Dateien in jeweils vier unterschiedliche +Dateiformate: + + inkscape --export-type=png,ps,eps,pdf dateiname1.svg dateiname2.svg + +Exportiert das Objekt mit id="text1555" nach PNG, mit demselben Namen für +die Ausgabedatei und derselben Auflösung wie beim letzten Mal, als es aus +der Benutzeroberfläche heraus exportiert wurde: + + inkscape --export-id=text1555 --export-use-hints dateiname.svg + +Dasselbe, verwendet jedoch die Standardauflösung 96 dpi, gibt einen +Dateinamen an und erweitert den Exportbereich auf den nächsten, ganzzahligen +Wert für SVG-Nutzer-Einheiten (um die pixelgenaue Ausrichtung der Objekte zu +erhalten und damit Antialiasing zu verringern). + + inkscape --export-id=text1555 --export-filename=text.png --export-area-snap dateiname.svg + +Konvertiert ein SVG-Dokument in ein normales SVG: + + inkscape --export-plain-svg --export-filename=dateiname2.svg dateiname1.svg + +Konvertiert ein SVG-Dokument zu EPS, wobei alle Texte in Pfade umgewandelt +werden: + + inkscape --export-filename=filename.eps --export-text-to-path dateiname.svg + +Fragt die Breite des Objektes mit id="text1555" ab: + + inkscape --query-width --query-id=text1555 dateiname.svg + +Dupliziert die Objekte mit id="path1555" und id="rect835", dreht die +Duplikate um 90 Grad, speichert die SVG-Datei und beendet sich: + + inkscape --select=path1555,rect835 --actions="duplicate;object-rotate-90-cw" --export-overwrite dateiname.svg + +Wählt alle Objekte des Typs Ellipse, dreht sie um 30 Grad, speichert die +Datei und beendet sich. + + inkscape --actions="select-by-element:ellipse;transform-rotate:30" --export-overwrite dateiname.svg + +Exportiert das Objekt mit der ID 'MeinDreieck' mit einem halbtransparenten +lilafarbenen Hintergrund in die Datei 'dreieck_lila.png' und mit einem roten +Hintergrund in die Datei 'dreieck_rot.png'. + + inkscape --actions="export-id:MeinDreieck; export-id-only; export-background:purple; export-background-opacity:0.5;export-filename:dreieck_lila.png; export-do; export-background:red; export-background-opacity:1; export-filename:tdreieck_rot.png; export-do" dateiname.svg + +Eine SVG-Datei von der Standardeingabe (stdin) lesen und ins PDF-Format +exportieren. + + cat dateiname.svg | inkscape --pipe --export-filename=dateiname.pdf + +Eine SVG-Datei ins PNG-Format exportieren und auf der Standardausgabe +(stdout) ausgeben, anschließend mit dem ImageMagick-Programm convert in das +JPG-Format konvertieren. + + inkscape --export-type=png --export-filename=- dateiname.svg | convert - dateiname.jpg + +Wie oben, jedoch wird auch die Eingabedatei von einer Pipe gelesen +(--export-filename kann dann entfallen) + + cat dateiname.svg | inkscape --pipe --export-type=png | convert - dateiname.jpg + +=head1 UMGEBUNGSVARIABLEN + +=over 8 + +=item B<INKSCAPE_PROFILE_DIR> + +Setzt einen benutzerdefinierten Pfad zum Inkscape Profilordner. + +=item B<INKSCAPE_DATADIR> + +Setzt einen benutzerdefinierten Pfad zum Inkscape Datenverzeichnis +(z.B. B<$PREFIX>/share wenn die gemeinsamen Inkscape-Daten sich in +B<$PREFIX>/share/inkscape befinden). + +=item B<INKSCAPE_LOCALEDIR> + +Setzt einen benutzerdefinierten Pfad zum Übersetzungskatalog. + +=back + +Für mehr Details, siehe +L<http://wiki.inkscape.org/wiki/index.php/Environment_variables> + +=head1 WEITERE INFORMATIONEN + +Die offizielle Anlaufstelle für Informationen rund um B<Inkscape> ist +L<https://www.inkscape.org/>. Auf der Webseite gibt es Nachrichten, +Dokumentation, Tutorials, Beispiele, die Mailinglisten, die neueste +Programmversion, Links zur Fehlerbericht- und Änderungswunsch-Datenbank, zu +Foren und vieles mehr. + +=head1 SIEHE AUCH + +L<potrace>, L<cairo>, L<rsvg>, L<batik>, L<ghostscript>, L<pstoedit>. + +Testsammlung zur Überprüfung der SVG-Standardkonformität: +L<http://www.w3.org/Graphics/SVG/WG/wiki/Test_Suite_Overview> + +SVG-Validator: L<https://validator.w3.org/> + +I<Scalable Vector Graphics (SVG) 1.1 Specification> I<W3C Recommendation 16 +August 2011> L<https://www.w3.org/TR/SVG11/> + +I<Scalable Vector Graphics (SVG) 1.2 Specification> I<W3C Working Draft 13 +April 2005> L<https://www.w3.org/TR/SVG12/> + +I<Scalable Vector Graphics (SVG) 2 Specification> I<W3C Candidate +Recommendation 15 September 2016> L<https://www.w3.org/TR/SVG2/> + +I<Document Object Model (DOM): Level 2 Core> I<W3C Recommendation 13 +November 2000> L<https://www.w3.org/TR/DOM-Level-2-Core/> + + + +=head1 ANMERKUNGEN ZUR BENUTZEROBERFLÄCHE + +Um den Umgang mit der Benutzeroberfläche von Inkscape zu erlernen, steht ein +Handbuch im Menü Hilfe > Inkscape-Handbuch, sowie Tutorials im Menü Hilfe > +Tutorials zur Verfügung. + +Außer SVG kann Inkscape (über Datei > Importieren) die meisten +Rastergrafikformate (PNG, BMP, JPG, XPM, GIF usw.), Klartext (erfordert +Perl), PS und EPS (erfordert Ghostscript), PDF und AI (AI-Version 9.0 oder +neuer) importieren. + +Inkscape exportiert 32-bit-PNG-Bilder (Datei > PNG-Bild exportieren) und +auch AI, PS, EPS, PDF, DXF und weitere Formate über Datei > Speichern unter. + +Inkscape kann Druck- und Neigung eines Grafik-Tablett-Stiftes für die +Beeinflussung von Breite, Winkel und Wirkungsstärke mehrerer Werkzeuge, +einschließlich des Kalligrafiewerkzeuges, nutzen. + +Inkscape bietet auch eine Benutzeroberfläche für die +Potrace-Bitmap-Vektorisier-Engine (L<http://potrace.sf.net>), die in +Inkscape enthalten ist. + +Inkscape kann externe Skripte verwenden (stdin-zu-stdout-Filter), die als +Einträge im Erweiterungsmenü dargestellt werden. Ein Skript kann einen +Dialog in der Benutzeroberfläche öffnen, in dem verschiedene Einstellungen +vorgenommen werden können und kann auf die ID der ausgewählten Objekte, die +bearbeitet werden sollen, über die Kommandozeile zugreifen. Inkscape +beinhaltet eine Auswahl von Effekten, die in Python geschrieben sind. + +=head1 TASTATURBEFEHLE + +Eine vollständige Liste der Tastatur- und Mausbefehle findet sich in der +Datei doc/keys.html oder über "Referenz der Tasten- und Mausbefehle" im Menü +"Hilfe". + +=head1 PROGRAMMFEHLER + +Viele Fehler sind bereits bekannt. Die Webseite +(L<https://www.inkscape.org/>) enthält Informationen dazu, wie man bei der +Bearbeitung der bereits gemeldeten Fehler helfen kann und wie man neue +Probleme melden kann. Siehe hierzu auch den Abschnitt "Bekannte Probleme" in +den Veröffentlichungshinweisen zur verwendeten Inkscape-Version (Datei +`NEWS`). + +=head1 GESCHICHTE + +Der Code, aus dem einmal Inkscape werden sollte, wurde 1999 als Gill, die +GNOME-Illustrator-Anwendung, von Raph Levien ins Leben gerufen. Das erklärte +Ziel von Gill war es, einmal alle SVG-Eigenschaften zu unterstützen. Raph +implementierte das PostScript-Bezier-Imaging-Modell, einschließlich Kontur +und Füllung, Stile für Linienenden, Stile für Linienverbindungen, Text und +mehr. Raph Gills Homepage ist L<http://www.levien.com/svg/> . Die Arbeit an +Gill verlangsamte sich oder endete im Jahr 2000. + +Der Nachfolger dieser Codebasis sollte das sehr beliebte Programm Sodipodi +werden, unter der Leitung von Lauris Kaplinski. Der Code wandelte sich in +mehrjähriger Arbeit hin zu einem mächtigen Illustrationsprogramm, das viele +neue Funktionen, Unterstützung für Mehrsprachigkeit und eine Version für +Windows und andere Betriebssysteme erhielt, und Abhängigkeiten eliminierte. + +Inkscape wurde im Jahr 2003 von vier aktiven Sodipodi-Entwicklern - Bryce +Harrington, MenTaLguY, Nathan Hurst und Ted Gould - gegründet, die eine +andere Entwicklungsrichtung einschlagen wollten, um sich mehr auf +SVG-Standardkonformität zu konzentrieren, das Interface-Design zu verbessern +und um mehr Menschen eine Möglichkeit zur Teilhabe an der Entwicklung zu +bieten. Das Projekt entwickelte sich rasch und gewann dabei eine Menge sehr +aktiver Beitragender und neuer Funktionen. + +Ein großer Teil der Arbeit in der Anfangszeit des Projektes bestand aus der +Stabilisierung des Codes und der Internationalisierung. Der ursprüngliche +Renderer, den Inkscape von Sodipodi geerbt hatte, war gespickt mit vielen +mathematischen Grenzfällen, die das Programm bei ungewöhnlicher Verwendung +zum Absturz brachten. Dieser Renderer wurde durch Livarot ersetzt, das zwar +auch nicht perfekt war, aber doch wesentlich weniger fehleranfällig. Das +Projekt machte es sich zur Gewohnheit, neuen Code möglichst rasch +zusammenzuführen, und Benutzer zu ermutigen, auch Entwicklerversionen des +Programmes zu verwenden. Dies half dabei, neue Fehler schnell zu entdecken +und ermöglichte es den Nutzern, die Reparaturen zu testen. Dies führte dazu, +dass Inkscape-Veröffentlichungen im allgemeinen unter dem Ruf stehen stabil +und zuverlässig zu sein. + +Es wurde sich um die Internationalisierung und Lokalisierung der +Benutzeroberfläche bemüht, was dem Projekt dabei half, weltweit Mitwirkende +zu gewinnen. + +Inkscape hatte einen positiven Einfluss darauf, wie visuell ansprechend Open +Source im Allgemeinen wahrgenommen wird, indem es ein Werkzeug zur Verfügung +stellte, mit dem Icons, Startbildschirme, Webseiten-Grafiken und so weiter +erstellt werden können. Obwohl Inkscape eigentlich "nur ein Zeichenprogramm" +ist, spielte es eine große Rolle dabei, Open Source für ein breiteres +Publikum grafisch reizvoller zu machen. + +=head1 AUTOREN + +Dieser Code verdankt seine Existenz einer großen Anzahl von Mitwirkenden an +Inkscape und seinen Vorgängern. Die folgende Liste ist mit Sicherheit +unvollständig - sie soll jedoch dazu dienen, die Arbeit all derer +anzuerkennen, die diese Anwendung zusammen geschaffen haben: + +${INKSCAPE_AUTHORS} + +=head1 URHEBERRECHT UND LIZENZ + +B<Copyright (C)> 1999-2023 liegt bei den Autoren. + +B<Inkscape> ist freie Software. Sie dürfen es zu den Bedingungen der GPL in +Version 2 oder höher weiterverbreiten und / oder verändern. + + + +=for comment $Date$ + diff --git a/man/inkscape.fr.pod.in b/man/inkscape.fr.pod.in new file mode 100644 index 0000000..17f3a8e --- /dev/null +++ b/man/inkscape.fr.pod.in @@ -0,0 +1,862 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NOM + +Inkscape - programme d'édition de SVG (Scalable Vector Graphics). + +=head1 SYNOPSIS + +C<inkscape [options] [fichier_1 fichier_2...]> + +S<options :> + + -?, --help + --help-all + --help-gapplication + --help-gtk + + -V, --version + --debug-info + --system-data-directory + --user-data-directory + + -p, --pipe + --pdf-page=PAGE + --pdf-poppler + --convert-dpi-method=MÉTHODE + --no-convert-text-baseline-spacing + + -o, --export-filename=FILENAME + --export-overwrite + --export-type=TYPE[,TYPE]* + --export-extension=EXTENSION-ID + + -C, --export-area-page + -D, --export-area-drawing + -a, --export-area=x0:y0:x1:y1 + --export-area-snap + -d, --export-dpi=PPP + -w, --export-width=LARGEUR + -h, --export-height=HAUTEUR + --export-margin=MARGE + + -i, --export-id=OBJECT-ID[;OBJECT-ID]* + -j, --export-id-only + -l, --export-plain-svg + --export-png-color-mode=COLORMODE + --export-png-use-dithering=BOOLEAN + --export-ps-level=LEVEL + --export-pdf-version=VERSION + -T, --export-text-to-path + --export-latex + --export-ignore-filters + -t, --export-use-hints + -b, --export-background=COLOR + -y, --export-background-opacity=VALUE + + -I, --query-id=ID_OBJET[,ID_OBJET]* + -S, --query-all + -X, --query-x + -Y, --query-y + -W, --query-width + -H, --query-height + + --vacuum-defs + --select=OBJECT-ID[,OBJECT-ID]* + --actions=ACTION(:ARG)[;ACTION(:ARG)]* + --action-list + --actions-file=FILENAME + + -g, --with-gui + -q, --active-window + --display=DISPLAY + --app-id-tag=TAG + --batch-process + --shell + + + +=head1 DESCRIPTION + +B<Inkscape> est un éditeur de dessin vectoriel libre et Open Source. Il +offre une multitude de fonctionnalités et est largement utilisé pour les +illustrations artistiques et techniques, comme les cartoons, les clip arts, +les logos, la typographie, les diagrammes ou les logigrammes. Il s'appuie +sur le dessin vectoriel pour fournir des impressions et des rendus nets à +des résolutions extrêmes, et il n'est pas contraint à un nombre déterminé de +pixels comme dans les images matricielles. Inkscape utilise le format de +fichier normalisé B<SVG> comme format principal, celui-ci étant pris en +charge par un grand nombre d'applications notamment les navigateurs web. + +L'interface est conçue pour offrir un confort d'usage et une efficacité aux +utilisateurs expérimentés, tout en restant conforme aux standards +B<GNOME>afin que les utilisateurs des applications GNOME puissent s'y +familiariser rapidement. + +Le format B<SVG> est un format XML normalisé par le W3C pour le dessin +vectoriel en 2D. Il permet de définir des objets sur un dessin en utilisant +des points, des chemins et des formes primitives. Les couleurs, les polices +de caractères, l'épaisseur du contour et autres sont spécifiés comme +attributs du style de ces objets. Le but, SVG étant un standard et ses +fichiers du texte/XML, est de rendre possible l'utilisation de fichiers SVG +pour un grand nombre de programmes et de pratiques. + +B<Inkscape> utilise le SVG comme format de document natif, et vise à devenir +le programme de dessin vectoriel le plus respectueux du format SVG, +disponible dans la communauté du logiciel libre. + + + +=head1 OPTIONS + +=over 8 + +=item B<-?>, B<--help> + +Affiche un message d'aide. + +=item B<--help-all> + +Affiche toutes les options de l'aide. + +=item B<--help-gapplication> + +Affiche les options de GApplication. + +=item B<--help-gtk> + +Affiche les options de GTK+. + +=item B<-V>, B<--version> + +Affiche la version d'Inkscape et la date de compilation. + +=item B<--debug-info> + +Affiche des informations techniques telles que la version d'Inkscape, des +dépendances, et le système d'exploitation. Ces informations sont utiles pour +déboguer des problèmes, n'hésitez pas à les inclure en soumettant un rapport +de bogue. + +=item B<--system-data-directory> + +Affiche le dossier des données système où sont stockés les fichiers de +données fournis avec Inkscape. Ceux-ci incluent les fichiers indispensables +à l'exécution d'Inkscape (comme les définitions d'unités, les raccourcis +clavier par défaut, les fichiers de description de l'interface graphique, +les thèmes d'icônes, etc.), les extensions fondamentales, le stock de +ressources (filtres, polices, marqueurs, palettes de couleurs, symboles, +modèles) et la documentation (les fichiers SVG d'exemples, les +didacticiels). + +L'emplacement du dossier des données système d'Inkscape peut être modifié +avec la variable d'environnement L<INKSCAPE_DATADIR>. + +=item B<--user-data-directory> + +Affiche le dossier du profil utilisateur où sont stockées les fichiers de +données spécifiques à l'utilisateur et ses préférences. Les extensions et +les ressources personnalisées (filtres, polices, marqueurs, palettes de +couleurs, symboles, modèles) devraient être installées dans leurs +sous-dossiers respectifs à cet emplacement. De plus, ajouter ici un fichier +avec un nom identique à celui du dossier des données système permettra de +lui octroyer la priorité sur les préréglages du dossier des données système +(par ex. les modèles par défaut, les fichiers d'interface graphique, etc.). + +L'emplacement par défaut du dossier du profil utilisateur peut être modifié +avec la variable d'environnement L<INKSCAPE_PROFILE_DIR>. + +=item B<-p>, B<--pipe> + +Lit le fichier d'entrée depuis l'entrée standard (stdin). + +=item B<--pdf-page>=I<PAGE> + +Importe la page donnée d'un fichier pdf. La numérotation commence à 1. + +=item B<--pdf-poppler> + +Par défaut, Inkscape importe des fichiers PDF via une bibliothèque interne +(dérivée de poppler). Le texte reste du texte. Les maillages sont convertis +en tuiles. L'option L<--pdf-poppler> permet d'importer via une bibliothèque +externe (poppler avec un back-end cairo). Le texte est constitué de groupes +contenant des glyphes clonés, chaque glyphe étant un chemin. Les images sont +stockées en interne. Les maillages imliquent de faire un rendu du document +complet sous forme d'image matricielle. + +=item B<--convert-dpi-method>=I<MÉTHODE> + +Choisis la méthode pour redimensionner les anciens fichiers (version +antérieure à 0.92) qui offrent un rendu légèrement plus petit du fait du +basculement de 90 PPP à 96 PPP, lors de l'interprétation des longueurs +données en nombre de pixels. Les valeurs possibles sont « none » (pas de +changement, le document sera rendu avec 94% de sa taille originale), « +scale-viewbox » (le document sera redimensionné globalement, les longueurs +individuelles restant inchangées) et « scale-document » (chaque longueur +sera redimensionnée individuellement). + +=item B<--no-convert-text-baseline-spacing> + +Impose de ne pas corriger automatiquement les lignes de base dans les +documents produits avec une version d'Inkscape antérieure à 0.92. Depuis +Inkscape 0.92, la propriété S<« line-height »> est gérée conformément au +standard CSS, ce qui la rend incompatible avec les précédentes versions. Par +défaut, les valeurs de hauteur de ligne dans les fichiers créés avant +Inkscape 0.92 vont être ajustées au chargement afin de préserver la +disposition souhaitée. Cette option permet d'éviter cet ajustement. + +=item B<-o>, B<--export-filename>=I<FICHIER> + +Définit le nom du fichier de sortie. Par défaut, le nom du fichier d'entrée +est réutilisé. Si l'option L<--export-type> est aussi utilisée, l'extension +du fichier sera adaptée (ou ajoutée) comme il se doit. Sinon le type du +fichier d'export sera déduit à partir de l'extension du fichier de sortie +spécifié. + +L'utilisation du nom de fichier spécial « - » conduit Inkscape à envoyer les +données de l'image vers la sortie standard (stdout). + +=item B<--export-overwrite> + +Écrase le fichier d'entrée. + +=item B<--export-type>=I<TYPE[,TYPE]*> + +Spécifie le type de fichier d'export. Les valeurs possibles sont : svg, +png, ps, eps, pdf, emf, wmf et tout type de fichier pour lequel il y a une +extension d'export. Il est aussi possible d'exporter vers plusieurs types en +une seule fois. + +Notez que PostScript n'accepte pas la transparence, et que tout objet +transparent dans le SVG original sera automatiquement rastérisé. Les polices +utilisées sont incorporées en tant que sous-ensemble. La zone d'exportation +par défaut est la S<page ;> vous pouvez la configurer comme étant le dessin +avec L<--export-area-drawing>. + +Notez aussi que le format PDF préserve la transparence du document SVG +original. + +=item B<--export-extension>=I<EXTENSION-ID> + +Permet de spécifier une extensions pour l'export, utile quand plusieurs +extensions produisent le même type de fichier. Permet d'éviter de spécifier +--export-filename and --export-type. Si spécifié, --export-type ne peut +contenir qu'un type. + +=item B<-C>, B<--export-area-page> + +Pour l'export en SVG, PNG, PDF et PS, définit la page comme zone à +exporter. C'est le comportement par défaut pour les formats SVG, PNG, PDF et +PS, et vous n'avez donc pas besoin de spécifier cette option pour ces +formats à moins que vous utilisiez l'option L<--export-id> pour exporter un +objet spécifique. En EPS, cette option n'est pas prise en charge. + +=item B<-D>, B<--export-area-drawing> + +Pour l'export en SVG, PNG, PDF, PS et EPS, définit le dessin entier (pas la +page) comme zone à exporter, c'est-à-dire le cadre englobant l'ensemble des +objets du document (ou des objets exportés lorsque l'option L<--export-id> +est utilisée). Avec cette option, l'image exportée n'affichera que les +objets visibles du document sans marge ni massicotage. Il s'agit de l'option +par défaut pour l'export au format EPS. Lors de l'export en PNG, elle peut +être combinée avec L<--export-use-hints>. + +=item B<-a> I<x0:y0:x1:y1>, B<--export-area>=I<x0:y0:x1:y1> + +Pour l'export en PNG, définit la zone à exporter en unités utilisateur SVG +(unité anonyme de longueur utilisée normalement par le format SVG +d'Inkscape, 1/96 pouce). Le comportement par défaut est d'exporter la page +complète du document. Le point S<(0 ; 0)> correspond au coin inférieur gauche. + +=item B<--export-area-snap> + +Pour l'export en PNG, arrondit les dimensions de la zone à exporter aux +valeurs entières supérieures en unités SVG utilisateur (px). Si vous +utilisez une résolution d'export de 96 ppp et que vos objets sont alignés +aux pixels afin de minimiser l'anti-crénelage, cette option permet de +préserver cet alignement même si l'export se fait selon des boîtes de +contour (avec L<--export-id> ou L<--export-area-drawing>) qui ne sont pas +correctement alignées sur les pixels. + +=item B<-d> I<PPP>, B<--export-dpi>=I<PPP> + +Définit la résolution utilisée pour l'export en PNG. Elle est également +utilisée pour définir le niveau de rastérisation des objets filtrés lors de +l'export en PS, EPS ou PDF (sauf si l'option L<--export-ignore-filters> est +utilisée). Elle est de 96 par défaut, correspondant à 1 pixel SVG (px, aussi +appelé « unité utilisateur ») s'exportant vers 1 pixel bitmap. Cette valeur +préempte la PPP enregistrée avec le document si la commande est utilisée +avec L<--export-use-hints>. + +=item B<-w> I<LARGEUR>, B<--export-width>=I<LARGEUR> + +Définit la largeur de l'image matricielle générée en pixels. Cette valeur +écrase l'option L<--export-dpi> (ou la résolution enregistrée avec le +document si L<--export-use-hints> est aussi utilisé). + +=item B<-h> I<HAUTEUR>, B<--export-height>=I<HAUTEUR> + +Définit la hauteur de l'image matricielle générée en pixels. Cette valeur +écrase le paramètre L<--export-dpi> (ou la PPP enregistrée avec le document +si --export-use-hints est aussi utilisé). + +=item B<--export-margin>=I<MARGE> + +Ajoute une marge autour de la zone à exporter. La dimension de la marge est +spécifiée en unités de la taille de page (pour SVG) et en millimètres (pour +PS/PDF). Cette option n'a actuellement pas d'effet pour les autres formats +d'export. + +=item B<-i> I<ID>, B<--export-id>=I<ID_OBJET[;ID_OBJET]*> + +Pour l'export en PNG, PS, EPS, PDF et SVG simple, exporte l'objet portant +l'identifiant (valeur de l'attribut id) S<I<ID> ;> les autres objets du +document ne seront pas exportés. Par défaut, la zone exportée est le cadre +englobant l'objet ; vous pouvez changer ce comportement en utilisant +L<--export-area> (PNG seulement) ou L<--export-area-page>. + +Si vous spécifiez plusieurs formats avec une liste d'objets séparés par des +points-virgules, chacune sera exportée séparément. Dans ce cas, les fichiers +d'export seront nommés ainsi : [fichier_d_entrée]_[ID].[format_d_export] + +=item B<-j>, B<--export-id-only> + +Pour les formats PNG, PS, EPS, et SVG simple, n'exporte que l'objet dont +l'identifiant est spécifié avec avec l'option L<--export-id>. Tous les +autres objets seront cachés et n'apparaîtront pas dans l'export même s'ils +chevauchent l'objet exporté. Si L<--export-id> n'est pas spécifié, cette +option est ignorée. + +=item B<-l>, B<--export-plain-svg> + +Exporte le(s) document(s) au format SVG simple, sans espace de noms +sodipodi: ou inkscape: et sans métadonnées RDF. Utilisez l'option +L<--export-filename> pour spécifier le nom du fichier. + +=item B<--export-png-color-mode>=I<COLORMODE> + +Définit le mode de couleur (profondeur de couleur) pour les bitmaps exportés +(Gray_1/Gray_2/Gray_4/Gray_8/Gray_16/RGB_8/RGB_16/GrayAlpha_8/GrayAlpha_16/RGBA_8/RGBA_16) + +=item B<--export-png-use-dithering>=I<false|true> + +Force le dithering ou le désactive, si la version d'Inkscape le supporte. + +=item B<--export-ps-level>=I<NIVEAU> + +Définit la version du langage pour l'export PS et EPS. Le niveau PostScript +2 ou 3 est accepté. La valeur par défaut est 3. + +=item B<--export-pdf-version>=I<VERSION> + +Sélectionne la version du format PDF utilisée pour exporter le +fichier. Cette option correspond au sélecteur de version PDF présent dans la +boîte de dialogue d'exportation en PDF de l'interface graphique. Vous devez +indiquer une des versions proposées par ce sélecteur, par exemple « 1.4 +». La version par défaut est « 1.4 ». + +=item B<-T>, B<--export-text-to-path> + +Convertit les objets texte en chemins lors de l'export, si applicable (pour +l'export en PS, EPS, PDF ou SVG). + +=item B<--export-latex> + +Pour l'export en PS, EPS ou PDF. Crée des images pour les documents LaTeX, +dans lesquels les textes de l'image sont composés par LaTeX. Lors de +l'export au format PDF/PS/EPS, cette option divise la sortie en un fichier +PDF/PS/EPS (lorsque, par exemple, l'option --export-pdf est spécifiée) et un +fichier LaTeX. Le texte ne sera pas enregistré dans le fichier PDF/PS/EPS, +mais apparaîtra à la place dans le fichier LaTeX. Ce fichier LaTeX inclut le +PDF/PS/EPS. Inclure le fichier LaTeX (\input{image.tex}) dans un document +LaTeX fait alors apparaître l'image, et tout le texte sera composé par +LaTeX. Consultez le document LaTeX généré pour en savoir plus. Consultez +également la sortie de la commande `epslatex' de GNUPlot dans un terminal. + +=item B<--export-ignore-filters> + +Exporte les objets filtrés (avec du flou, par exemple) comme des vecteurs, +en ignorant les filtres (pour l'export en PS, EPS ou PDF). Par défaut, tous +les objets filtrés sont rastérisés à une résolution choisie par +L<--export-dpi> (par défaut 96 ppp), ce qui préserve leur apparence. + +=item B<-t>, B<--export-use-hints> + +Lors de l'export en PNG, utilise le nom de fichier et la résolution +enregistrés en PPP avec l'objet exporté (uniquement si L<--export-id> est +spécifié). Ces valeurs sont configurées automatiquement lorsque vous +exportez la sélection depuis Inkscape. Donc, par exemple, si vous exportez +une forme avec id="path231" sous /home/me/shape.png avec une résolution de +300 ppp depuis document.svg en utilisant l'interface graphique d'Inkscape, +et enregistrez le document, vous pourrez réexporter plus tard cette forme +vers le même fichier et avec la même résolution en utilisant simplement la +commande + + inkscape -i path231 -t document.svg + +Si vous utilisez L<--export-dpi>, L<--export-width> ou L<--export-height> +avec cette option, alors la résolution enregistrée (en PPP) sera ignorée et +la valeur fournie sur la ligne de commande sera utilisée. Si vous utilisez +L<--export-filename> avec cette option, le nom de fichier enregistré avec le +document sera ignoré et le nom de fichier fourni sur la ligne de commande +utilisé. + +=item B<-b> I<COULEUR>, B<--export-background>=I<COULEUR> + +Définit la couleur d'arrière-plan du PNG exporté. La couleur peut être +décrite de toutes les manières supportées par le format SVG, par exemple +"#ff007f" ou "rgb(255, 0, 128)". Si cette couleur n'est pas définie, la +couleur de page définie dans Inkscape via la boîte de dialogue Préférences +du document sera utilisée (enregistrée dans l'attribut pagecolor= de +sodipodi:namedview). + + + +=item B<-y> I<VALEUR>, B<--export-background-opacity>=I<VALEUR> + +Définit l'opacité de l'arrière-plan du PNG exporté. Cela peut être une +valeur entre 0.0 et 1.0 (0.0 signifiant la transparence complète, 1.0 +l'opacité complète) ou supérieure à 1 et inférieure à 255 S<(255 :> +complètement opaque). Si cette valeur n'est pas spécifiée et si l'option -b +n'est pas utilisée, l'opacité de la page enregistrée avec le document (dans +l'attribut inkscape:pageopacity= de sodipodi:namedview) sera utilisée. Si +cette valeur n'est pas spécifiée mais que l'option -b est utilisée, la +valeur 255 (opacité complète) sera utilisée. + +=item B<-I>, B<--query-id>=I<ID_OBJET[,ID_OBJET]*> + +Définit l'identifiant de l'objet dont les dimensions sont demandées ; +utilisez une liste d'identifiants séparés par des virgules pour plusieurs +objets. Si cette option n'est pas utilisée, la commande retournera les +dimensions du dessin (c'est-à-dire de tous les objets du document), pas de +la page ou de la zone affichée. + +Si vous spécifiez une liste d'objets avec des valeurs séparées par des +virgules, toute demande de géométrie (par ex. L<--query-x>) retournera une +liste de valeurs séparées par des virgules correspondant à la liste des +objets indiqués dans I<--query-id>. + +=item B<-S>, B<--query-all> + +Affiche une liste de tous les objets du document SVG avec leur identifiant, +et les valeurs x, y, largeur et hauteur, en utilisant la virgule comme +séparateur. + +=item B<-X>, B<--query-x> + +Demande l'abscisse (coordonnée X) du dessin ou, si spécifié avec +L<--query-id>, de l'objet. La valeur retournée est en px (unités utilisateur +SVG). + +=item B<-Y>, B<--query-y> + +Demande l'ordonnée (coordonnée Y) du dessin ou, si spécifié avec +L<--query-id>, de l'objet. La valeur retournée est en px (unités utilisateur +SVG). + +=item B<-W>, B<--query-width> + +Demande la largeur du dessin ou, si spécifié avec L<--query-id>, de +l'objet. La valeur retournée est en px (unités utilisateur SVG). + +=item B<-H>, B<--query-height> + +Demande la hauteur du dessin ou, si spécifié avec L<--query-id>, de +l'objet. La valeur retournée est en px (unités utilisateur SVG). + +=item B<--vacuum-defs> + +Supprime tous les éléments inutilisés de la section C<E<lt>defsE<gt>> du +fichier SVG. Si cette option est utilisée avec L<--export-plain-svg>, seul +le fichier exporté sera affecté. Si cette option est utilisée seule, le +fichier spécifié sera modifié. + +=item B<--select>=I<ID_OBJET[,ID_OBJET]*> + +La commande L<--select> sélectionne les objets correspondant aux +identifiants spécifiés. Vous pouvez indiquer plusieurs objets avec une liste +d'identifiants séparés par des virgules. Ceci permet à différents verbes +d'agir sur cette même sélection. Pour désélectionner tous les objets, +utilisez C<--verb=EditDeselect>. Les identifiants d'objet disponibles +dépendent du document ouvert. + +=item B<--actions>=I<ACTION(:ARG)[;ACTION(:ARG)]*> + +Les actions sont une nouvelle méthode d'appel de fonctions prenant un seul +paramètre (optionnel). Pour obtenir la liste des noms d'actions disponibles, +utilisez l'option en ligne de commande L<--action-list>. Potentiellement, +tous les verbes seront remplacés par des actions. Pour le moment, tout verbe +peut être utilisé comme une action (sans paramètre). Notez que la plupart +des verbes nécessitent une interface graphique (même s'ils ne l'utilisent +pas). Pour fermet automatiquement l'interface graphique à la fin d'une +commande, utilisez L<--batch-process>. De plus, toutes les options d'export +ont des actions correspondantes (il suffit de retirer le '--' du début de +l'option et de remplacer '=' par ':'). + +Pour les actions seules, L<--batch-process> doit être utilisé. + +L'export peut être forcé à tout moment avec l'action export-do. Ceci permet +d'effectuer plusieurs exports sur un seul fichier. + +=item B<--action-list> + +Affiche une liste des toutes les actions disponibles. + +=item B<--actions-file>=I<FICHIER> + +Exécute les actions du fichier. Le fichier doit être formatté avec la +syntaxe des L<--actions>. Cette option remplace L<--actions> si les deux +sont présentes. + +=item B<-g>, B<--with-gui> + +Essaie d'utiliser l'interface graphique (sous Unix, utiliser le serveur X, +même si $DISPLAY n'est pas défini). + +=item B<-q>, B<--active-window> + +Au lieu de lancer un nouveau processus, exécute la commande dans la dernière +fenêtre active. + +=item B<--display>=I<DISPLAY> + +Définit l'affichage à utiliser pour la fenêtre d'Inkscape + +=item B<--app-id-tag>=I<TAG> + +Crée une unique instance d'Inkscape avec l'ID d'application +'org.inkscape.Inkscape.TAG'. Utile pour séparer les instances en présence de +plusieurs versions en parallèle, ou de plusieurs fichiers de préférence. + +=item B<--batch-process> + +Ferme l'interface graphique après l'exécution de toutes les actions ou tous +les verbes. + +=item B<--shell> + +Utilise Inkscape en mode ligne de commande interactif. Dans ce mode, vous +pouvez entrer des commandes sur l'invite et Inkscape les exécute, sans que +vous ayez à lancer une nouvelle instance du logiciel à chaque +commande. Cette fonctionnalité est principalement utile pour les scripts et +l'exécution à S<distance :> elle n'ajoute aucune fonctionnalité mais permet +d'améliorer la vitesse et l'occupation en mémoire des scripts qui appellent +Inkscape de façon répétée pour effectuer des tâches en ligne de commande +(telles que des exports ou des conversions). + +En mode shell, Inkscape attend une séquence d'actions (ou de verbes) en +entrée. Elles seront traitées ligne par ligne, après avoir appuyé sur la +touche Entrée. Il est possible (mais pas obligatoire) de mettre toutes les +actions sur la même ligne. + +Cette option se combine avec L<--active-window> pour exécuter les commandes +dans un document déjà ouvert. + +L'exemple suivant ouvre un fichier et l'exporte dans deux formats +différents, puis ouvre un autre fichier et exporte un seul objet : + + file-open:fichier1.svg; export-type:pdf; export-do; export-type:png; export-do + file-open:fichier2.svg; export-id:rect2; export-id-only; export-filename:rect_seul.svg; export-do + +=back + +=head1 CONFIGURATION + +Le fichier de configuration principal se trouve dans +S<~/.config/inkscape/preferences.xml ;> il contient de nombreux types de +paramétrages dont vous pouvez changer la valeur dans Inkscape (la plupart +dans la boîte de dialogue Préférences d'Inkscape). Vous pouvez également +ajouter des configurations spécifiques dans les sous-répertoires S<suivants :> + +B<$HOME>/.config/inkscape/extensions/ - extensions. + +B<$HOME>/.config/inkscape/fonts/ - polices. + +B<$HOME>/.config/inkscape/icons/ - icon sets. + +B<$HOME>/.config/inkscape/keys/ - configuration des raccourcis clavier. + +B<$HOME>/.config/inkscape/paint/ - motifs et hachures. + +B<$HOME>/.config/inkscape/palettes/ - palettes. + +B<$HOME>/.config/inkscape/symbols/ - catalogues de symboles. + +B<$HOME>/.config/inkscape/templates/ - modèles de document. + +B<$HOME>/.config/inkscape/ui/ - Fichiers d'interface. + +=head1 DIAGNOSTICS + +Le programme retourne la valeur zéro après une utilisation réussie ou +différente de zéro après un problème. + +Des messages d'erreur et des avertissements divers peuvent être envoyés vers +STDERR ou STDOUT. Si le programme se comporte de façon inconsistante avec un +fichier SVG particulier ou plante, ces messages peuvent comporter des +indices. + +=head1 EXEMPLES + +Bien qu'B<Inkscape> soit principalement conçu comme une application +graphique, il peut aussi être utilisé depuis la ligne de commande pour +effectuer des opérations SVG. + +Ouvrir un fichier SVG avec l'interface S<graphique :> + + inkscape fichier.svg + +Exporter un fichier SVG en PNG avec la résolution par défaut de 96 ppp (une +unité utilisateur SVG devient un pixel de l'image S<matricielle) :> + + inkscape --export-filename=fichier.png fichier.svg + +Idem, mais en forçant les dimensions du fichier à 600×400 S<pixels :> + + inkscape --export-filename=fichier.png -w 600 -h 400 fichier.svg + +Idem, mais en exportant le dessin (la boîte englobante de tous les objets), +et pas la S<page :> + + inkscape --export-filename=fichier.png --export-area-drawing fichier.svg + +Exporte deux fichiers différents, chacun dans quatre formats de fichiers +distincts : + + inkscape --export-type=png,ps,eps,pdf fichier1.svg fichier2.svg + +Exporter en PNG l'objet avec id="text1555", en utilisant le nom de fichier +et la résolution utilisés la dernière fois qu'il a été exporté depuis +l'interface S<graphique :> + + inkscape --export-id=text1555 --export-use-hints fichier.svg + +Idem, mais en utilisant une résolution de 96 ppp, en spécifiant un nom de +fichier et en arrondissant la zone à exporter aux valeurs entières les plus +proches en unités utilisateur SVG (afin de préserver l'alignement des objets +sur des pixels et minimiser S<l'anti-crénelage) :> + + inkscape --export-id=text1555 --export-filename=texte.png --export-area-snap fichier.svg + +Convertir un document du format SVG Inkscape au format SVG S<simple :> + + inkscape --export-plain-svg --export-filename=fichier2.svg fichier1.svg + +Convertir un document SVG en EPS, en convertissant les textes en S<chemins :> + + inkscape --export-filename=fichier.eps --export-text-to-path fichier.svg + +Demander la largeur de l'objet avec S<id="text1555" :> + + inkscape --query-width --query-id=text1555 fichier.svg + +Dupliquer les objets avec les id="path1555" et id="rect835", et appliquer +une rotation de 90 degrés sur les duplicatas, enregistrer le SVG et +S<quitter :> + + inkscape --select=path1555,rect835 --actions="duplicate;object-rotate-90-cw" --export-overwrite filename.svg + +Sélectionner tous les objets avec l'étiquette ellipse, leur appliquer à tous +une rotation de 30 degrés, enregistrer le fichier et quitter. + + inkscape --actions="select-by-element:ellipse;transform-rotate:30" --export-overwrite filename.svg + +Exporter l'objet avec l'ID MonTriangle avec un fond violet semi-transparent +vers le fichier triangle_violet.png, et avec un fond rouge vers le fichier +triangle_rouge.png. + + inkscape --actions="export-id:MyTriangle; export-id-only; export-background:purple; export-background-opacity:0.5;export-filename:triangle_purple.png; export-do; export-background:red; export-background-opacity:1; export-filename:triangle_red.png; export-do" filename.svg + +Lire un fichier SVG depuis l'entrée standard (stdin) et l'exporter au format +PDF : + + cat fichier.svg | inkscape --pipe --export-filename=fichier.pdf + +Exporter un SVG vers le format PNG, et l'envoyer vers la sortie standard +(stdout), puis le convertir au format JPG avec le programme de conversion +d'ImageMagick (convert) : + + inkscape --export-type=png --export-filename=- fichier.svg | convert - fichier.jpg + +Comme ci-dessus, mais en lisant à partir d'un tube (pipe) (--export-filename +peut être omis dans ce cas) + + cat fichier.svg | inkscape --pipe --export-type=png | convert - fichier.jpg + +=head1 VARIABLES D'ENVIRONNEMENT + +=over 8 + +=item B<INKSCAPE_PROFILE_DIR> + +Définit un emplacement personnalisé pour le dossier du profil utilisateur. + +=item B<INKSCAPE_DATADIR> + +Définit une emplacement personnalisé pour le dossier des données d'Inkscape +(par ex. B<$PREFIX>/share si les fichiers partagés d'Inkscape sont dans +B<$PREFIX>/share/inkscape). + +=item B<INKSCAPE_LOCALEDIR> + +Définit un emplacement personnalisé pour le catalogue des traductions. + +=back + +Pour plus de détails, voir aussi +L<http://wiki.inkscape.org/wiki/index.php/Environment_variables> + +=head1 AUTRES INFORMATIONS + +La référence principale où trouver des informations sur B<Inkscape> est +L<https://www.inkscape.org/>. Le site web comporte des actualités, de la +documentation, des didacticiels, des exemples, des archives des listes de +diffusion, la dernière version du programme, les bases de données contenant +les bogues et les demandes de fonctionnalité, des forums, et encore +davantage. + +=head1 VOIR AUSSI + +L<potrace>, L<cairo>, L<rsvg>, L<batik>, L<ghostscript>, L<pstoedit>. + +Suite de tests de conformité S<SVG :> +L<https://www.w3.org/Graphics/SVG/WG/wiki/Test_Suite_Overview> + +Validation de S<SVG :> L<https://validator.w3.org/> + +I<Scalable Vector Graphics (SVG) 1.1 Specification> I<W3C Recommendation 16 +August 2011> L<https://www.w3.org/TR/SVG11/> + +I<Scalable Vector Graphics (SVG) 1.2 Specification> I<W3C Working Draft 13 +April 2005> L<https://www.w3.org/TR/SVG12/> + +I<Scalable Vector Graphics (SVG) 2 Specification> I<W3C Candidate +Recommendation 15 September 2016> L<https://www.w3.org/TR/SVG2/> + +I<Document Object Model (DOM): Level 2 Core> I<W3C Recommendation 13 +November 2000> L<https://www.w3.org/TR/DOM-Level-2-Core/> + + + +=head1 NOTES SUR L'INTERFACE GRAPHIQUE + +Pour vous familiariser avec l'utilisation de l'interface graphique +d'Inkscape, consultez le manuel dans Aide > Manuel d'Inkscape et les +didacticiels dans Aide > Didacticiels. + +En plus du SVG, Inkscape peut importer (Fichier > Importer) la plupart des +formats d'images matricielles (PNG, BMP, JPG, XPM, GIF, etc.), du texte brut +(nécessite Perl), les formats PS et EPS (nécessite Ghostscript) et les +formats PDF et AI (AI version 9.0 ou ultérieur). + +Inkscape peut exporter (Fichier > Exporter une image PNG) des images PNG 32 +bits, mais aussi aux formats AI, PS, EPS, PDF, DXF et plusieurs autres +formats via Fichier > Enregistrer sous. + +Inkscape gère la pression et l'inclinaison du stylet d'une tablette +graphique pour la largeur, l'angle et la force d'action de plusieurs outils, +dont la plume calligraphique. + +Inkscape comporte une interface graphique pour le moteur de vectorisation +d'image matricielle Potrace (L<http://potrace.sf.net>) qui est inclus dans +Inkscape. + +Inkscape peut utiliser des scripts externes (filtres de stdin vers stdout) +représentés par des commandes dans le menu Effets. Un script peut faire +intervenir les boîtes de dialogue de l'interface graphique pour définir +différents paramètres et peut obtenir les identifiants des objets +sélectionnés sur lesquels agir depuis la ligne de commande. Inkscape est +livré avec un assortiment d'effets écrits en Python. + +=head1 RACCOURCIS CLAVIER + +Pour obtenir une liste complète des raccourcis clavier et souris, consultez +le fichier doc/keys.html, ou utilisez la commande Clavier et souris dans le +menu Aide. + +=head1 BOGUES + +Beaucoup de bogues sont S<connus ;> veuillez vous référer au site web +(inkscape.org) pour vérifier ceux qui ont déjà été rapportés et pour +soumettre de nouveaux problèmes. Consultez aussi la section S<« Known> S<Issues »> +des notes de livraison de votre version (dans le fichier `NEWS'). + +=head1 HISTORIQUE + +Le code qui allait devenir Inkscape est né en 1999, avec le programme Gill, +GNOME Illustrator, créé par Raph Levien. L'objectif défini pour Gill était +de gérer complètement le format SVG. Raph a codé le modèle PostScript de +courbes de Bézier, incluant le remplissage et le contour, les coiffes et +raccords de lignes, le texte, etc. La page de Raph consacrée à Gill se +trouve sur L<http://www.levien.com/svg/>. Le travail sur Gill semble avoir +diminué ou s'être arrêté en 2000. + +L'incarnation suivante du code allait devenir le très populaire Sodipodi, +mené par Lauris Kaplinski. Le code est devenu un outil d'illustration +puissant après plusieurs années de travail, ajoutant plusieurs nouvelles +fonctionnalités, le support multilingue, le portage sous Windows et d'autres +systèmes d'exploitation, et éliminant certaines dépendances. + +Inkscape a été lancé en 2003 par quatre développeurs actifs de Sodipodi, +Bryce Harrington, MenTaLguY, Nathan Hurst et Ted Gould, qui voulaient faire +prendre une orientation différente au code en termes de focalisation sur la +conformité SVG, d'aspect et de fonctionnement de l'interface, et d'ouverture +du développement à plus de participants. Le projet a progressé rapidement, +gagnant de nombreux contributeurs très actifs et une multitude de +fonctionnalités. + +Beaucoup de travail a été depuis consacré à la stabilisation du code et à +l'internationalisation. Le moteur de rendu hérité de Sodipodi comportait de +nombreux cas limites mathématiques qui entraînaient des plantages lorsque le +programme était utilisé à des fins S<inhabituelles ;> ce moteur a alors été +remplacé par Livarot qui, bien qu'imparfait, générait moins d'erreurs. Le +projet a également adopté la bonne habitude de publier son code +régulièrement, et encouragé les utilisateurs à tester des versions en +développement du S<logiciel ;> cela a aidé à identifier les nouveaux bogues +rapidement, et à assurer qu'il était facile pour les utilisateurs de +vérifier les correctifs. Inkscape a ainsi acquis une réputation de programme +robuste et fiable. + +En parallèle, des efforts ont été faits pour améliorer +l'internationalisation et la localisation de l'interface, ce qui a apporté +au projet de nouveaux contributeurs du monde entier. + +Inkscape a eu un impact positif sur l'attractivité visuelle de l'Open Source +en général, en offrant un outil pour créer et partager des icônes, des +écrans d'accueil, de l'art pour le web, etc. D'une certaine façon, bien que +n'étant qu'un S<« simple> outil de S<dessin »,> Inkscape a joué un rôle important +en rendant l'Open Source plus stimulant visuellement pour un plus large +public. + +=head1 AUTEURS + +Ce code doit son existence à un grand nombre de contributeurs tout au long +de ses différentes incarnations. La liste qui suit est certainement +incomplète mais permet de reconnaître les nombreuses épaules sur lesquelles +cette application S<repose :> + +${INKSCAPE_AUTHORS} + +=head1 COPYRIGHT ET LICENCE + +B<Copyright (C)> 1999-2023 par les auteurs. + +B<Inkscape> est un logiciel S<libre ;> vous pouvez le redistribuer et/ou le +modifier selon les termes de la licence GPL version 2 ou ultérieure. + + + +=for comment $Date$ + diff --git a/man/inkscape.hu.pod.in b/man/inkscape.hu.pod.in new file mode 100644 index 0000000..883e96c --- /dev/null +++ b/man/inkscape.hu.pod.in @@ -0,0 +1,847 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NÉV + +Inkscape – egy SVG (Scalable Vector Graphics) szerkesztő program + +=head1 ÁTTEKINTÉS + +C<inkscape [kapcsolók] [fájlnév1 fájlnév2 ...]> + +kapcsolók: + + -?, --help + --help-all + --help-gapplication + --help-gtk + + -V, --version + --debug-info + --system-data-directory + --user-data-directory + + -p, --pipe + --pdf-page=OLDAL + --pdf-poppler + --convert-dpi-method=MÓDSZER + --no-convert-text-baseline-spacing + + -o, --export-filename=FÁJLNÉV + --export-overwrite + --export-type=TÍPUS[,TÍPUS]* + --export-extension=KIEGÉSZÍTŐAZONOSÍTÓ + + -C, --export-area-page + -D, --export-area-drawing + -a, --export-area=x0:y0:x1:y1 + --export-area-snap + -d, --export-dpi=DPI + -w, --export-width=SZÉLESSÉG + -h, --export-height=MAGASSÁG + --export-margin=MARGÓ + + -i, --export-id=OBJEKTUMAZONOSÍTÓ[;OBJEKTUMAZONOSÍTÓ]* + -j, --export-id-only + -l, --export-plain-svg + --export-png-color-mode=SZÍNMÓD + --export-png-use-dithering=LOGIKAI + --export-ps-level=SZINT + --export-pdf-version=VERZIÓ + -T, --export-text-to-path + --export-latex + --export-ignore-filters + -t, --export-use-hints + -b, --export-background=SZÍN + -y, --export-background-opacity=ÉRTÉK + + -I, --query-id=OBJEKTUMAZONOSÍTÓ[,OBJEKTUMAZONOSÍTÓ]* + -S, --query-all + -X, --query-x + -Y, --query-y + -W, --query-width + -H, --query-height + + --vacuum-defs + --select=OBJEKTUMAZONOSÍTÓ[,OBJEKTUMAZONOSÍTÓ]* + --actions=MŰVELET(:ARGUMENTUM)[;MŰVELET(:ARGUMENTUM)]* + --action-list + --actions-file=FÁJLNÉV + -g, --with-gui + -q, --active-window + --display=KIJELZŐ + --app-id-tag=CÍMKE + --batch-process + --shell + + + +=head1 LEÍRÁS + +Az B<Inkscape> egy ingyenes és nyílt forráskódú vektorgrafikus +szerkesztő. Gazdag funkciókészletet kínál és széles körben használatos mind +művészi, mint technikai illusztrációk – például rajzfilmek, clipart-ok, +logók, tipográfiai elemek, diagramok és folyamatábrák – +készítésére. Vektorgrafikát használ az éles nyomatok és korlátlan felbontású +megjelenítés létrehozásáért és nincs rögzítve korlátozott számú pixelhez, +mint a raszteres grafika. Az Inkscape a szabványosított B<SVG> formátumot +használja saját formátumaként, melyet számos más alkalmazás is támogat a +webböngészőket is beleértve. + +A felhasználói felület úgy lett tervezve, hogy komfortos és hatékony legyen +a tapasztalt felhasználók számára, valamint a B<GNOME> szabvány követésének +hála a más GNOME alkalmazásokban jártas felhasználók is gyorsan meg tudják +tanulni a felületét. + +Az B<SVG> egy W3C szabvány 2D-s vektoros rajzoláshoz XML +formátumban. Lehetővé teszi objektumok létrehozását pontokkal, útvonalakkal +és primitív alakzatokkal. A színek, betűkészletek, körvonalszélességek és +hasonlók „stílus” attribútumként vannak definiálva ezeken az +objektumokon. Mivel az SVG egy szabvány, és a fájljai egyszerű text/xml +formátumúak, az a küldetése, hogy nagy számú felhasználó számtalan +programban alkalmazhassa. + +Az B<Inkscape> az SVG-t használja a saját natív dokumemtum-formátumaként +azzal a céllal, hogy a leginkább megfelelő SVG-rajprogram legyen a nyílt +forrású közösségben. + + + +=head1 KAPCSOLÓK + +=over 8 + +=item B<-?>, B<--help> + +Megjeleníti a súgóüzeneteket. + +=item B<--help-all> + +Megjeleníti az összes súgóüzenetet. + +=item B<--help-gapplication> + +Megjeleníti a GApplication kapcsolókat. + +=item B<--help-gtk> + +Megjeleníti a GTK+ kapcsolókat. + +=item B<-V>, B<--version> + +Megjeleníti az Inkscape verzióját és a build dátumát. + +=item B<--debug-info> + +Technikai információkat ír ki: az Inkscape verzióját, függőségi verziókat és +az operációs rendszert. Ez az információ hasznos hibakereséskor és minden +hibajelentésben meg kell adni. + +=item B<--system-data-directory> + +Kiírja a rendszer adatmappáját ahol az Inkscape-pel érkező adatfájlok vannak +tárolva. Itt vannak az Inkscape futásához szükséges állományok (az +egység-definíciók, a beépített gyorsbillentyűk, a felhasználói felületet +leíró fájlok, ikontémák, stb.), az alap kiterjesztések, a törzskészlet +(szűrők, betűkészletek, jelölők, színpaletták, szimbólumok, sablonok) és a +dokumentáció (SVG példafájlok és az ismertetők). + +Az Inkscape által várt adatmappa helye felülírható az L<INKSCAPE_DATADIR> +környezeti változóval. + +=item B<--user-data-directory> + +Kiírja a felhasználói profil mappáját, ahol a felhasználói adat- és +beállításfájlok vannak tárolva. Az egyéni kiterjesztéseket és +erőforrásfájlokat (szűrők, betűkészletek, jelölők, színpaletták, +szimbólumok, sablonok) ide, a megfelelő almappába kell telepíteni. Továbbá +ha a rendszer adatmappájában szereplő fájlnévvel ide helyezünk egy fájlt, +akkor az felülírja a legtöbb beállítást a rendszer adatmappájában +(pl. alapértelmezett sablonok, felhasználói felületleíró-fájlok, stb.). + +A profilmappa alapértelmezett helye felülírható az L<INKSCAPE_PROFILE_DIR> +környezeti változóval. + +=item B<-p>, B<--pipe> + +Beolvassa a bemeneti fájlt a szabványos bemenetről (stdin). + +=item B<--pdf-page>=I<OLDAL> + +Importálja a PDF-fájl megadott számú oldalát. A számozás 1-gyel kezdődik. + +=item B<--pdf-poppler> + +Alapértelmezetten az Inkscape a PDF-fájlokat egy belső (poppler származék) +könyvtárral importálja. A szövegek szövegként lesznek tárolva. A +színátmenetes hálók csempékké konvertálóknak. A L<--pdf-poppler> kapcsolóval +egy külső (poppler, cairo háttérprogrammal) importálási könyvtárra lehet +váltani. A szövegek betűkészletjelei klónozott útvonalak csoportjai +lesznek. A képek belsőleg tárolódnak. A hálók miatt az egész dokumentum +raszteres képként lesz leképezve. + +=item B<--convert-dpi-method>=I<MÓDSZER> + +Megjelöli a módszert, amellyel a régi (0.92 előtti) fájlok át lesznek +méretezve – kissé kisebbekké válnak a 90 DPI-ről 96 DPI-re való váltás miatt +a pixel egységének hosszúságértelmezése következtében. A lehetséges értékek +a „none” (nincs módosítás, a dokumentum az eredeti méretének 94%-ban lesz +megjelenítve), a „scale-viewbox” (a dokumentum egyben kerül átméretezésre, +az egyedi objektumok méretei érintetlenül maradnak) és „scale-document” +(minden egyes méret egyedileg kerül átméretezésre). + +=item B<--no-convert-text-baseline-spacing> + +Letiltja a szövegek alapvonalának automatikus javítását a régi (0.92 előtti) +fájlok megnyitása közben. Az Inkscape ugyanis a 0.92 verziótól kezdve +magáévá tette a CSS szabvány „line-height” tulajdonságának a szabvány adta +irányelvek szerinti alkalmazását és így eltért a régi +verzióktól. Alapértelmezetten a régi, 0.92 verzió előtti Inkscape-ben +készült fájlok megnyitásakor a sormagasság értékek módosítva lesznek, hogy +megőrizzék az eredetileg szándékolt szövegelrendezést. Ezzel a kapcsolóval +lehet hatástalanítani ezt az igazítást. + +=item B<-o>, B<--export-filename>=I<FÁJLNÉV> + +Beállítja a kimeneti fájl nevét. Az alapértelmezés a bemeneti fájl nevének +újrahasznosítása. Az L<--export-type> kapcsoló használatával a fájl +kiterjesztése értelem szerűen hozzá lesz igazítva vagy adva. Ellenkező +esetben az exportálandó fájl típusa a megadott fájlnév kiterjesztéséből fog +meghatározásra kerülni. + +A „-” speciális fájlnévvel lehet az Inkscape képadatait a szabványos +kimenetre irányítani (stdout). + +=item B<--export-overwrite> + +Felülírja a bemeneti fájlt. + +=item B<--export-type>=I<TÍPUS[,TÍPUS]*> + +Megadja az exportálandó fájl típusát. Lehetséges értékek: svg, png, ps, eps, +pdf, emf, wmf és minden további fájltípus, amihez van kiterjesztés +telepítve. Lehetséges egyszerre akár több fájltípusba is exportálni. + +Mivel a PostScript nem támogatja az átlátszóságot, ezért minden az SVG-ben +eredetileg átlátszó objektum bitkép másolattal lesz helyettesítve. Az +alkalmazott betűkészletek részhalmaza kerül beágyazásra. Az alapértelmezett +exportált terület a lap, melyet az L<--export-area-drawing> kapcsolóval +lehet a rajzra módosítani. + +A PDF megőrzi az eredeti SVG-ben található átlátszóságokat. + +=item B<--export-extension>=I<KIEGÉSZÍTŐAZONOSÍTÓ> + +Lehetővé tesz egy kimeneti kiterjesztés meghatározását, amellyel az +exportálás megvalósul abban az esetben, amikor több mint egy exportálási +kapcsoló van megadva az adott fájl számára. Ha ez be van állítva, akkor az +--export-filename és az --export-type mellőzve lehet. Továbbá, ha be van +állítva, csak egy fájltípus adható meg az --export-type kapcsolóval. + +=item B<-C>, B<--export-area-page> + +SVG, PNG, PDF és PS esetén az exportált területet a lapra állítja be. Ez +alapértelmezett az SVG, PNG, PDF és a PS esetén, ezért nem kell külön +megadni, kivéve az L<--export-id> kapcsolóval történő egy megadott objektum +exportálásának esetét. Ez a kapcsoló az EPS formátumra jelenleg nem +támogatott. + +=item B<-D>, B<--export-area-drawing> + +SVG, PNG, PDF, PS és EPS exportálása esetén az exportált területet a rajzra +állítja be (a lap helyett), vagyis a dokumentum összes objektumát határoló +téglalapra (ill. értelemszerűen az exportált objektumra az L<--export-id> +kapcsoló esetén). Ezzel a kapcsolóval az exportált kép a dokumentum összes +látható objektumát meg fogja jeleníteni margó és levágás nélkül. Az EPS +számára ez az alapértelmezett exportálási terület. PNG esetén együtt lehet +alkalmazni az L<--export-use-hints> kapcsolóval. + +=item B<-a> I<x0:y0:x1:y1>, B<--export-area>=I<x0:y0:x1:y1> + +PNG exportálása esetén beállítja a dokumentum exportált területét px-ben +(1/96 hüvelyk). Az alapértelmezés a teljes dokumentumoldal exportálása. A +(0,0) pont a bal alsó sarok. + +=item B<--export-area-snap> + +PNG exportálásakor az exportált területet kifelé a legközelebbi egész +pixelre illeszti. Ez a kapcsoló az alapértelmezett 96 DPI-s exportálási +felbontás és a grafikák elsimítás elkerülése érdekében történő pixelre +igazítása esetén megőrzi ezt az igazítást akkor is, ha olyan objektum +határoló téglalapja kerül exportálásra (az L<--export-id> vagy az +L<--export-area-drawing> kapcsolókkal), amely maga nincs pixelre igazítva. + +=item B<-d> I<DPI>, B<--export-dpi>=I<DPI> + +Beállítja a felbontást PNG exportálás esetén. Továbbá PS, EPS és PDF +exportálása esetén a szűrőkkel rendelkező objektumokról e felbontással +készül tartalék bitképmásolat (hacsak ez nincs elnyomva az +L<--export-ignore-filters> kapcsolóval). Az alapértelmezés 96 DPI, ami +megfelel 1 SVG felhasználói egység (px, ún. „felhasználói egység”) 1 bitkép +px-be való exportálásának. Az L<--export-use-hints> kapcsolóval együtt +alkalmazva felülírja az előzetesen tárolt DPI célt. + +=item B<-w> I<SZÉLESSÉG>, B<--export-width>=I<SZÉLESSÉG> + +Meghatározza a létrehozott bitkép szélességét. Felülírja az L<--export-dpi> +kapcsoló által adott beállítást (vagy az L<--export-use-hints> kapcsoló +esetén az előzetesen tárolt DPI célt). + +=item B<-h> I<MAGASSÁG>, B<--export-height>=I<MAGASSÁG> + +Meghatározza a létrehozott bitkép magasságát. Felülírja az L<--export-dpi> +kapcsoló által adott beállítást (vagy az L<--export-use-hints> kapcsoló +esetén az előzetesen tárolt DPI célt). + +=item B<--export-margin>=I<MARGÓ> + +Margót hoz létre az exportált terület köré és beállítja annak értékét. A +margó értéke az lap mértékegysége szerint kerül értelmezésre SVG esetén vagy +milliméterben PS, PDF esetén. A kapcsolónak jelenleg más formátumokra nincs +hatása. + +=item B<-i> I<ID>, B<--export-id>=I<OBJEKTUMAZONOSÍTÓ[;OBJEKTUMAZONOSÍTÓ]*> + +PNG, PS, EPS, PDF és egyszerű SVG exportálása esetén meghatározza annak az +objektumnak (ill. objektumoknak) az azonosítóját („id” attribútumát), amely +exportálásra kerül úgy, hogy egyetlen más objektum sem +exportálódik. Alapértelmezetten az exportált terület az objektumot határoló +téglalap, de ez felülírható az L<--export-area> (csak PNG) vagy az +L<--export-area-page> kapcsolókkal. + +Ha több pontosvesszővel elválasztott érték van megadva, akkor mindegyik +külön exportálódik. Ebben az esetben az exportált fájlok nevi így jönnek +létre:[bemeneti_fájlnév]_[objektumazonosító].[fájltípus] + +=item B<-j>, B<--export-id-only> + +PNG, PS, EPS, PDF és egyszerű SVG exportálása esetén beállítja, hogy csak az +az objektum legyen exportálva, amelynek az azonosítója meg van adva az +L<--export-id> kapcsolóval. Minden más egyéb objektum rejtve marad az +exportált állományban még akkor is, ha egyébként fedné ezt az objektumot. Az +L<--export-id> nélkül ez a kapcsoló mellőzve lesz. + +=item B<-l>, B<--export-plain-svg> + +Beállítja, hogy az exportált állomány egyszerű SVG legyen, sodipodi: és +inkscape: névterek, valamint RDF metaadatok nélkül. Az L<--export-filename> +kapcsolóval lehet megadni a fájl kívánt nevét. + +=item B<--export-png-color-mode>=I<SZÍNMÓD> + +Beállítja az exportálandó bitkép színmódját (bitmélység és színtípus) +(Gray_1/Gray_2/Gray_4/Gray_8/Gray_16/RGB_8/RGB_16/GrayAlpha_8/GrayAlpha_16/RGBA_8/RGBA_16) + +=item B<--export-png-use-dithering>=I<false|true> + +Kikényszeríti a zajmodulációt vagy letiltja azt (az Inkscape buildnek +támogatni kell a zajmodulációt ehhez) + +=item B<--export-ps-level>=I<SZINT> + +PS és EPS exportálás esetén beállítja a PostScript nyelv verzióját. A 2-es +vagy a 3-as támogatott, a 3-as az alapértelmezett. + +=item B<--export-pdf-version>=I<VERZIÓ> + +Kijelöli az exportált PDF verzióját. Ez a kapcsoló megegyezik a felhasználói +felületen a PDF exportálási párbeszédablakon megjelenő PDF-verzió választási +lehetőséggel. Az egyik ott, a legördülő menüben megjelenő lehetőséget kell +megadni a kapcsolónak, pl. „1.4”. Az alapértelmezett az „1.4” + +=item B<-T>, B<--export-text-to-path> + +Beállítja, hogy a szövegobjektumok útvonallá legyenek konvertálva az +exportálás folyamán, már ahol ez alkalmazható: PS, EPS, PDF és SVG +exportálás esetén. + +=item B<--export-latex> + +PS, EPS és PDF exportálása esetén: LaTeX dokumentumok számára állít elő +képeket úgy, hogy átadja a LaTeX számára a képekben szereplő szövegek +szedését. PDF, PS vagy EPS exportálása esetén a kapcsoló kettéválasztja a +kimenetet egy PDF/PS/EPS (ahogy az --export-type meghatározza), valamint egy +LaTeX fájllá. A szövegek nem lesznek részei a PDF/PS/EPS fájloknak, hanem a +LaTeX fájlban tűnnek fel. E LaTeX fájl tartalmazza a PDF/PS/EPS képet is. A +LaTeX fájl betöltése (\input{image.tex}) a LaTeX dokumentumba meg fogja +jeleníteni a képet úgy, hogy a szöveget a LaTeX szedi. További információk a +létrejött LaTeX fájlban találhatóak. Továbbá a GNUPlot „epslatex” kimenti +terminálját érdemes még megtekinteni. + +=item B<--export-ignore-filters> + +Bekapcsolva a szűrőkkel (pl. az elmosással) rendelkező objektumok vektorként +lesznek exportálva, figyelmen kívül hagyva a szűrőket (PS, EPS, PDF +exportálása esetén). Alapértelmezés szerint minden szűrővel rendelkező +objektum helyettesítő bitképpel kerül exportálásra az L<--export-dpi> +kapcsolóban meghatározott felbontással (alapértelmezetten 96 DPI-vel), hogy +a megjelenés megőrződjön. + +=item B<-t>, B<--export-use-hints> + +PNG exportálása esetén beállítja, hogy az exportált fájlnév és a DPI magában +az exportált objektumban (L<--export-id>) tárolt célértékek szerint jöjjön +létre. Ezek az exportálási tippek automatikusan jönnek létre kijelölések +exportálása közben. Például: Ha egy „path231” azonosítóval rendelkező +alakzatot exportál 300 DPI-vel a „/home/jómagam/alakzat.png” útvonalra a +„dokumentum.svg”-ből az Inkscape grafikus felhasználói felültén és ezt a +dokumentumot el is menti, úgy később ezt az alakzatot ugyanazzal a +fájlnévvel, ugyanazzal a felbontással tudja újra exportálni: + + inkscape -i path231 -t dokumentum.svg + +Az L<--export-dpi>, L<--export-width>, vagy az L<--export-height> +kapcsolókkal a DPI tipp felülíródik és a parancssorban megadott érték lesz +alkalmazva. Az L<--export-filename> kapcsolóval úgyszintén a tippben +eltárolt fájlnév felülíródik és a parancssorban megadott érték lesz +alkalmazva. + +=item B<-b> I<SZÍN>, B<--export-background>=I<SZÍN> + +Beállítja az exportált PNG háttérszínét. Ez bármilyen az SVG által +támogatott színleíró karaktersorozat lehet, mint pl. a „#ff007f” vagy az +„rgb(255, 0, 128)”. Ha ez nincs megadva, akkor a Dokumentumbeállítások +párbeszédablakban megadott lapszín (a „sodipodi:namedview” névtér +„pagecolor” attribútuma) lesz alkalmazva. + + + +=item B<-y> I<ÉRTÉK>, B<--export-background-opacity>=I<ÉRTÉK> + +Átlátszatlanságot állít be háttérszínhez PNG exportálás esetén. Ez az érték +lehet 0.0 és 1.0 között (a 0.0 a teljes átlátszóság, az 1.0 a teljes +átlátszatlanság), valamint 1 és 255 között (255 jelöli a teljes +átlátszatlanságot). Ha nincs beállítva és a -b kapcsoló sem, akkor a +Dokumentumbeállítások párbeszédablakban megadott lapátlátszatlanság (a +„sodipodi:namedview” névtér „inkscape:pageopacity” attribútuma) lesz +alkalmazva. Ha nincs beállítva, de a -b kapcsoló be van kapcsolva, akkor 255 +(teljes átlátszatlanság) értékkel lesz alkalmazva. + +=item B<-I>, B<--query-id>=I<OBJEKTUMAZONOSÍTÓ[,OBJEKTUMAZONOSÍTÓ]*> + +Egy vesszővel elválasztott listával meghatározza azon egy vagy több objektum +azonosítóját, melyek méretei lekérdezendőek. Ha nincs beállítva, akkor a +lekérdezés a rajz (értsd: a dokumentum összes objektumának) méretét adja +vissza, nem a lap vagy a viewbox méretét. + +Ha egy vesszővel elválasztott listában több érték van megadva, akkor minden +mértani lekérdezés (pl. L<--query-x>) egy vesszővel elválasztott listát ad +vissza, ahol az értékek a I<--query-id> kapcsolóban megadott objektumoknak +felelnek meg. + +=item B<-S>, B<--query-all> + +Kiír egy vesszővel határolt listát az SVG-dokumentum összes azonosítóval +rendelkező objektumának x, y koordinátáival, valamint szélesség és magasság +értékeivel. + +=item B<-X>, B<--query-x> + +Lekérdezi az X koordinátáját a rajznak vagy, ha a L<--query-id> kapcsolóval +meg van adva, egy objektumnak. A visszaadott érték px-ben (SVG felhasználói +egységben) értendő. + +=item B<-Y>, B<--query-y> + +Lekérdezi az Y koordinátáját a rajznak vagy, ha a L<--query-id> kapcsolóval +meg van adva, egy objektumnak. A visszaadott érték px-ben (SVG felhasználói +egységben) értendő. + +=item B<-W>, B<--query-width> + +Lekérdezi a szélességét a rajznak vagy, ha a L<--query-id> kapcsolóval meg +van adva, egy objektumnak. A visszaadott érték px-ben (SVG felhasználói +egységben) értendő. + +=item B<-H>, B<--query-height> + +Lekérdezi a magasságát a rajznak vagy, ha a L<--query-id> kapcsolóval meg +van adva, egy objektumnak. A visszaadott érték px-ben (SVG felhasználói +egységben) értendő. + +=item B<--vacuum-defs> + +Eltávolítja az összes C<E<lt>defsE<gt>> részt az SVG fájlból. Ha az +L<--export-plain-svg> kapcsolóval együtt kerül meghívásra, akkor csak az +exportált fájlt fogja ez érinteni. Csak önmagában alkalmazva a megadott +fájlt fogja módosítani a saját helyén. + +=item B<--select>=I<OBJEKTUMAZONOSÍTÓ[,OBJEKTUMAZONOSÍTÓ]*> + +A L<--select> kapcsoló kijelöli a megadott azonosítójú objektumot a funkciók +számára, hogy azok különféle tevékenységeket végezzenek rajtuk. Akár több +objektum is megadható egy vesszővel elválasztott listában. A kijelölésből +való eltávolításra a C<--verb=EditDeselect> kapcsoló használható. Az +elérhető objektumazonosítók a betöltendő dokumentumtól függenek. + +=item B<--actions>=I<MŰVELET(:ARGUMENTUM)[;MŰVELET(:ARGUMENTUM)]*> + +A műveletek egy új módszert biztosítanak a funkciók egy opcionális egyedi +paraméterrel való meghívására. Az elérhető műveletazonosítók listáját az +L<--action-list> kapcsolóval lehet lekérdezni. Egyszer majd minden funkció +műveletre lesz cserélve, de addig is ideiglenesen minden funkció műveletként +is meghívható, de jelenleg paraméter nélkül. Érdemes figyelembe venni, hogy +a legtöbb funkció grafikus felületet igényel (még akkor is ha voltaképpen +nem használja). A grafikus felhasználói felület műveletsor végi automatikus +lezárására a L<--batch-process> kapcsoló használatos. Továbbá minden +exportálásra szolgáló kapcsolónak is van műveleti megfelelője: a kapcsoló +elejéről le kell vágni a „--” karaktereket és az egyenlőségjelet („=”) +kettőspontra („:”) kell cserélni. + +Ha csak műveletek szerepelnek, akkor kötelező használni a L<--batch-process> +kapcsolót. + +Az exportálás a műveletsorban bármikor kikényszeríthető az export-do +művelettel. Ez többszörös exportálást tesz lehetővé egyetlen fájlon. + +=item B<--action-list> + +Felsorol minden elérhető műveletet. + +=item <--actions-file>B=I<FÁJLNÉV> + +Végrehajtja a fájlban felsorolt összes műveletet. A fájl tartalmát az +L<--actions> szintaxis szerint kell formázni. Ez az opció felülírja az +L<--actions> argumentumot, ha mindkettő meg van adva. + +=item B<-g>, B<--with-gui> + +Megkísérli a grafikus felhasználói felület alkalmazását (Unix rendszereken +az X szervert használja, ha a $DISPLAY nincs beállítva). + +=item B<-q>, B<--active-window> + +Egy új Inkscape-folyamat indítása helyett ez a parancs a legutóbb fókuszált +Inkscape-dokumentumban fogja futtatni a parancsot. + +=item B<--display>=I<KIJELZŐ> + +Beállítja az Inkscape ablak X-kijelzőjét. + +=item B<--app-id-tag>=I<CÍMKE> + +Létrehoz egy egyedi példányt az Inkscape-ből az +'org.inkscape.Inkscape.CÍMKE' alkalmazásazonosítóval. Ez hasznos az +Inkscape-példányok elkülönítéséhez, ha egyidejűleg különböző +Inkscape-verziókat futtatunk vagy különböző beállításfájlokat használunk. + +=item B<--batch-process> + +Bezárja a grafikus felhasználói felületet a művelet- vagy funkciósor végén. + +=item B<--shell> + +Ezzel a kapcsolóval az Inkscape egy interaktív parancsértelmező módba +helyezi magát. Ebben a módban a parancssorba utasítást lehet gépelni, amit +az Inkscape végrehajt anélkül, hogy minden egye utasítás után új példányt +kellene indítani a programból. Ez a szolgáltatás főleg szkriptelésre és +szerver üzemmódban való használatra való: nem ad új képességeket, de +jelentősen gyorsítja a végrehajtást és csökkenti a memóriaszükségletet +minden olyan parancsfájlnál, amely ismétlődően hívja meg az Inkscape-et, +hogy parancssori feladatokat hajtson végre (mint például az exportálás vagy +a konvertálás). + +Parancsértelmező módban az Inkscape egy művelet (vagy funkció) sorozatot vár +bemenetül. Soronként kerül értelmezésre, tipikusan az Enter +leütésekor. Lehetséges (de nem szükséges) minden műveletet akár egy sorban +is megadni. + +Ez az opció kombinálható az L<--active-window> paraméterrel, hogy a shell +parancsokat egy már megnyitott Inkscape dokumentumban hajtsa végre. + +A következő példa megnyit egy fájlt és két különböző formátumba exportálja, +majd megnyit egy másik fájlt és abból egyetlen objektumot exportál: + + file-open:fájl1.svg; export-type:pdf; export-do; export-type:png; export-do + file-open:fájl2.svg; export-id:rect2; export-id-only; export-filename:csak_a_négyzet.svg; export-do + +=back + +=head1 BEÁLLÍTÁS + +A fő konfigurációs fájl helye: ~/.config/inkscape/preferences.xml. Sokfajta +testreszabási beállítást tárol, melyet jellemzően az Inkscape Beállítások +párbeszédablakában lehet módosítani. Ugyanitt, az almappákba saját +beállításokat helyezhet el a következőképpen: + +B<$HOME>/.config/inkscape/extensions/ – kiterjesztések. + +B<$HOME>/.config/inkscape/fonts/ – betűkészletek. + +B<$HOME>/.config/inkscape/icons/ – ikoncsomagok. + +B<$HOME>/.config/inkscape/keys/ – gyorsbillentyűkiosztások. + +B<$HOME>/.config/inkscape/paint/ – minták és vonalkák + +B<$HOME>/.config/inkscape/palettes/ – paletták. + +B<$HOME>/.config/inkscape/symbols/ – szimbólumfájlok. + +B<$HOME>/.config/inkscape/templates/ – sablonok az új fájlok számára. + +B<$HOME>/.config/inkscape/ui/ – felhasználói felület fájlok. + +=head1 DIAGNOSZTIKA + +A program nullát ad vissza sikeres végrehajtás esetén, hiba esetén pedig nem +nullát. + +Különféle hiba- és figyelmeztető üzenetek kerülhetnek az STDERR vagy az +STDOUT kimenetre. Ha a program hibásan viselkedik egy adott SVG fájllal, +vagy összeomlik, akkor érdemes a nyomok után ezen a kimeneten kutatni. + +=head1 PÉLDÁK + +Noha az B<Inkscape> elsődlegesen egy grafikus szerkesztőprogram, +parancssorral is lehetséges vele SVG-fájlokat feldolgozni. + +Megnyit egy SVG-fájlt a grafikus felhasználói felületen: + + inkscape fájlnév.svg + +PNG-be exportál egy SVG-fájlt az alapértelmezett 96 DPI-vel (egy SVG +felhasználói egység 1 bitkép pixellé alakítva): + + inkscape --export-filename=fájlnév.png fájlnév.svg + +Mint az előző, csak a PNG mérete 600×400 pixelre van kényszerítve: + + inkscape --export-filename=fájlnév.png -w 600 -h 400 fájlnév.svg + +Hasonló, de a rajz (az összes objektumot határoló téglalap) kerül +exportálásra, nem a lap: + + inkscape --export-filename=fájlnév.png --export-area-drawing fájlnév.svg + +Két különböző fájlt exportál egyenként négy formátumba: + + inkscape --export-type=png,ps,eps,pdf fájlnév1.svg fájlnév2.svg + +A „text1555” azonosítóval rendelkező objektumot exportálja PNG-be úgy, hogy +a létrejövő fájlnév és felbontás az legyen, amit utoljára a grafikus +felhasználói felületen való exportálásakor volt megadva: + + inkscape --export-id=text1555 --export-use-hints fájlnév.svg + +Ugyanaz, de az alapértelmezett 96 DPI-vel, a fájlnév megadásával és az +exportált terület kifelé igazításával a legközelebbi SVG felhasználói +egységhez (az objektumok pixelre igazításának megőrzése és ezáltal az +élsimítás elkerülése érdekében): + + inkscape --export-id=text1555 --export-filename=szöveg.png --export-area-snap fájlnév.svg + +Átalakít egy Inkscape SVG dokumentumot egyszerű SVG-vé: + + inkscape --export-plain-svg --export-filename=fájlnév2.svg fájlnév1.svg + +Átalakít egy SVG dokumentumot EPS-sé az összes szöveg útvonallá konvertálása +mellett: + + inkscape --export-filename=filename.eps --export-text-to-path fájlnév.svg + +Lekérdezi a „text1555” azonosítójú objektum szélességét: + + inkscape --query-width --query-id=text1555 fájlnév.svg + +Megkettőzi a „path1555” és a „rect835” azonosítójú objektumokat, majd +elforgatja azokat 90°-kal, elmenti SVG-be és kilép. + + inkscape --select=path1555,rect835 --actions="duplicate;object-rotate-90-cw" --export-overwrite fájlnév.svg + +Kijelöl minden ellipszis elemet, elforgatja azokat 30°-kal, elmenti a fájlt +és kilép. + + inkscape --actions="select-by-element:ellipse;transform-rotate:30" --export-overwrite fájlnév.svg + +A „MyTriangle” azonosítójú objektumot exportálja először egy félig áttetsző +lila háttérrel a lila_háromszög.png-be, majd vörös háttérrel a +vörös_háromszög.png-be. + + inkscape --actions="export-id:MyTriangle; export-id-only; export-background:purple; export-background-opacity:0.5;export-filename:lila_háromszög.png; export-do; export-background:red; export-background-opacity:1; export-filename:vörös_háromszög.png; export-do" fájlnév.svg + +Beolvassa az SVG-t a szabványos bemenetről (stdin) és PDF-be exportálja: + + cat fájlnév.svg | inkscape --pipe --export-filename=fájlnév.pdf + +Exportál egy SVG-t PNG-be és a szabványos kimenetre (stdout) írja, ahonnan +az ImageMagick convert programja átalakítja JPG-be: + + inkscape --export-type=png --export-filename=- fájlnév.svg | convert - fájlnév.jpg + +Ugyanaz, mint az előbb, csak most maga is az adatcsatornából olvas (ilyenkor +az --export-filename kapcsoló elhagyható) + + cat fájlnév.svg | inkscape --pipe --export-type=png | convert - fájlnév.jpg + +=head1 KÖRNYEZETI VÁLTOZÓK + +=over 8 + +=item B<INKSCAPE_PROFILE_DIR> + +Egyéni helyet állít be a felhasználói profil mappának. + +=item B<INKSCAPE_DATADIR> + +Egyéni helyet állít be az Inkscape adatmappának (pl. B<$PREFIX>/share ha az +Inkscape megosztott állományainak helye a B<$PREFIX>/share/inkscape). + +=item B<INKSCAPE_LOCALEDIR> + +Egyéni helyet állít be a fordítási katalógusfájloknak. + +=back + +További információk: +L<http://wiki.inkscape.org/wiki/index.php/Environment_variables> + +=head1 TOVÁBBI INFORMÁCIÓK + +Hiteles információk az B<Inkscape>-ről a L<https://www.inkscape.org/> +webhelyen érhetőek el: hírek, dokumentáció, ismertetők, példák, levelező +listák archívuma, a legfrissebb kiadás a programból, hibák és +funkciókérések, fórum és sok más. + +=head1 LÁSD MÉG + +L<potrace>, L<cairo>, L<rsvg>, L<batik>, L<ghostscript>, L<pstoedit>. + +SVG megfelelőségi tesztcsomag: +L<https://www.w3.org/Graphics/SVG/WG/wiki/Test_Suite_Overview> + +SVG ellenőrző: L<https://validator.w3.org/> + +I<Scalable Vector Graphics (SVG) 1.1 Specification> I<W3C Recommendation 16 +August 2011> L<https://www.w3.org/TR/SVG11/> + +I<Scalable Vector Graphics (SVG) 1.2 Specification> I<W3C Working Draft 13 +April 2005> L<https://www.w3.org/TR/SVG12/> + +I<Scalable Vector Graphics (SVG) 2 Specification> I<W3C Candidate +Recommendation 15 September 2016> L<https://www.w3.org/TR/SVG2/> + +I<Document Object Model (DOM): Level 2 Core> I<W3C Recommendation 13 +November 2000> L<https://www.w3.org/TR/DOM-Level-2-Core/> + + + +=head1 FELHASZNÁLÓI FELÜLET + +Az Inkscpae felhasználói felületének tanulásához olvass el kézikönyvet a +Súgó → Inkscape-kézikönyv menüpontban vagy az ismertetőket a Súgó → +Ismertetők pontban. + +Az SVG mellett az Inkscape képes a legtöbb bitkép formátumot (PNG, BMP, JPG, +XPM, GIF, stb.) is importálni (Fájl → Importálás), valamint egyszerű +szöveget (Perl szükséges hozzá), továbbá PS-t és EPS-t (Ghostscript +szükséges hozzá), PDF-t és AI formátumot (AI 9.0 vagy frissebb változattól). + +Az Inkscape 32 bites PNG képet exportál (Fájl → PNG-kép exportálása), +valamint AI, PS, EPS, PDF, DXF és más egyéb formátumokat a Fájl → Mentés +másként menüpontban. + +Az Inkscape képes alkalmazni a grafikus tábla tollának nyomását és +dőlésszögét több eszköz szélességének, szögének és erejének meghatározására, +többek között a művészi tollét. + +Az Inkscape rendelkezik egy grafikus felhasználói felülettel a Potrace +L<http://potrace.sf.net>) bitkép-vektorizáló alrendszerhez, amely be van +építve az Inkscape-be. + +Az Inkscape képes külső (stdin-ről stdout-ra szűrő) parancsfájlok +futtatására, melyek a Kiterjesztések menüpont parancsaiként vannak +beépítve. A szkriptnek lehetne grafikus felhasználói párbeszédablaka, hogy +különféle paramétereket lehessen beállítani, vagy a kijelölt objektumok +azonosítóját be lehessen állítani, amin dolgozni fog a parancssoron. Az +Inkcape gyárilag válogatott, Pythonban készült szűrőkkel érkezik. + +=head1 GYORSBILLENTYŰK + +A teljes gyorsbillentyű és egérművelet listát a doc/keys.html-ben lehet +megtalálni, vagy a Súgó → Billentyű- és egérkombinációk leírása menüpontban. + +=head1 HIBÁK + +Sok hiba már ismert. A már bejelentettek a weboldalon +(L<https://www.inkscape.org/>) tekinthetőek át, ill. az újonnan +felfedezettek is itt küldhetőek be. Az ismert hibák fejezetet is érdemes +áttanulmányozni az verzióhoz kapcsolódó kiadási jegyzékben (a „NEWS” fájlt). + +=head1 TÖRTÉNET + +A kódbázis, ami később az Inkscape-pé vált 1999-ben kezdte meg a maga életét +a Gill programként, a GNOME Illustrator alkalmazásaként, melyet Raph Levien +készített. A Gill-el az volt a szándék, hogy egyszer majd az SVG-t teljes +egészét támogassa. Raph implementálta a PostScript Bézier képalkotó +modellt, beleértve a körvonalasítást, a kitöltést, a vonalvégeket, a +vonalkapcsolásokat, szövegeket, stb. Raph's Gill oldala: +L<http://www.levien.com/svg/>. A Gill fejlesztése 2000 körül lelassult, +ill. leállt. + +A kódbázis következő megtestesülése a rendkívül népszerű Sodipodi program +volt, melynek vezető fejlesztője Lauris Kaplinski. A kódbázis sokéves +munkának köszönhetően egy sokoldalú illusztráló programmá vált számos új +funkcióval, a többnyelvűség támogatásával, Windows és más operációs +rendszerre való portolással és a meglévő függőségek kiküszöbölésével. + +Az Inkscape-et 2003-ban négy aktív Sodipodi fejlesztő, Bryce Harrington, +MenTaLguY, Nathan Hurst és Ted Gould alapította azzal a szándékkal, hogy más +irányt vegyen a fejlesztés elsősorban az SVG megfelelőséget illetően, a +felhasználói felület kinézete érdekében és hogy a fejlesztésbe többen +kapcsolódhassanak be. A projekt gyorsan haladt előre és együtt növekedett az +aktív hozzájárulók száma a funkciókkal együtt. + +A projekt első napjaiban a munka a kód stabilizálására és +nemzetköziesítésére fókuszált. Az eredeti, Sodipoditól örökölt leképezőbe be +volt fűzve néhány olyan matematikai sarokeset, amely váratlan +összeomlásokhoz vezetett, amikor a programot rutinszerűen kezdték el +használni, ezért a leképezőt lecserélték a Livarot-ra, ami ugyan nem volt +tökéletes, de lényegesen kevésbé volt hajlamos a hibákra. A projekt áttért a +kódok gyakori beküldésére és elkezdte bátorítani a felhasználókat, hogy +használják a fejlesztői pillanatképeket. Ez elősegítette a hibák gyors +feltárását és biztosította, hogy a felhasználók egyszerűen ellenőrizhessék a +javításokat. Ennek eredményeképpen az Inkscape kiadások általában jó +hírnevet szereztek robusztus és megbízható voltuk miatt. + +Hasonló erőfeszítések történtek a felület nemzetköziesítése és lokalizációja +érdekében, ami nagyban segített abban, hogy a program hozzájárulókat +találjon világszerte. + +Az Inkscape jótékony hatást tett a nyílt forráskód vizuális vonzerejére +általában, mivel olyan eszközt biztosított, amivel ikonokat, kezdőképeket, +webes rajzokat és hasonlóakat lehetett készíteni és megosztani. Annak +ellenére, hogy „csak egy rajzprogram” az Inkscape fontos szerepet játszott a +nyílt forráskód láthatóvá tételében a nagyközönség számára + +=head1 SZERZŐK + +Ez a kódbázis számos közreműködőnek köszönheti a létezését több különböző +megtestesülése során. A következő lista minden bizonnyal hiányos, de +szeretné elősegíteni mindazok felismerését, akik a vállukra vették az évek +folyamán: + +${INKSCAPE_AUTHORS} + +=head1 SZERZŐI JOGOK ÉS LICENC + +B<Copyright (C)> 1999–2023 a szerzők. + +Az B<Inkscape> szabad szoftver és GPL 2-as verziója szerint lehet +terjeszteni, ill. módosítani. + + + +=for comment $Date$ + diff --git a/man/inkscape.ko.pod.in b/man/inkscape.ko.pod.in new file mode 100644 index 0000000..7c7fc2f --- /dev/null +++ b/man/inkscape.ko.pod.in @@ -0,0 +1,675 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 이름 + +Inkscape - SVG(Scalable Vector Graphics) 편집 프로그램입니다. + +=head1 개요 + +C<inkscape [옵션] [파일이름_1 파일이름_2 ...]> + +옵션: + + -?, --help + --help-all + --help-gapplication + --help-gtk + + -V, --version + --debug-info + --system-data-directory + --user-data-directory + + -p, --pipe + --pdf-page=페이지 + --pdf-poppler + --convert-dpi-method=방법 + --no-convert-text-baseline-spacing + + -o, --export-filename=파일이름 + --export-overwrite + --export-type=유형[,유형]* + --export-extension=확장기능-ID + + -C, --export-area-page + -D, --export-area-drawing + -a, --export-area=x0:y0:x1:y1 + --export-area-snap + -d, --export-dpi=DPI + -w, --export-width=너비 + -h, --export-height=높이 + --export-margin=여백 + + -i, --export-id=객체-ID[;객체-ID]* + -j, --export-id-only + -l, --export-plain-svg + --export-png-color-mode=색상모드 + --export-png-use-dithering=불리언 + --export-ps-level=레벨 + --export-pdf-version=버전 + -T, --export-text-to-path + --export-latex + --export-ignore-filters + -t, --export-use-hints + -b, --export-background=색상 + -y, --export-background-opacity=값 + + -I, --query-id=객체-ID[,객체-ID]* + -S, --query-all + -X, --query-x + -Y, --query-y + -W, --query-width + -H, --query-height + + --vacuum-defs + --select=객체-ID[,객체-ID]* + --actions=동작(:ARG)[;동작(:ARG)]* + --action-list + --actions-file=파일이름 + + -g, --with-gui + -q, --active-window + --display=디스플레이 + --app-id-tag=태그 + --batch-process + --shell + + + +=head1 설명 + +B<Inkscape>는 자유-오픈 소스 벡터 그래픽스 편집기입니다. 풍부한 기능을 제공하며 만화, 클립 아트, 로고, 타이포그래피, +다이어그램 및 순서도와 같은 예술적, 기술적 삽화 모두에 널리 사용됩니다. 벡터 그래픽스를 사용하여 해상도를 제한 없이 선명하게 출력하고 +렌더링할 수 있으며 래스터 그래픽처럼 고정된 픽셀 수에 구속되지 않습니다. Inkscape는 웹 브라우저를 비롯한 많은 다른 +애플리케이션에서 지원하는 표준화된 B<SVG> 파일 형식을 기본 형식으로 사용합니다. + +인터페이스는 숙련된 사용자에게 편안하고 효율적으로 설계되었으며 다른 GNOME 애플리케이션에 익숙한 사용자가 인터페이스를 빠르게 배울 수 +있도록 B<GNOME> 표준을 준수합니다. + +B<SVG>는 2D 벡터 드로잉을 위한 W3C 표준 XML 형식입니다. 포인트, 경로 및 기본 도형을 사용하여 도면에서 객체를 정의할 수 +있습니다. 색상, 글꼴, 자획 두께 등은 이러한 객체들에 대한 '스타일' 속성으로 지정됩니다. SVG가 표준이고 파일이 +text/xml이기 때문에 SVG 파일을 상당한 수의 프로그램과 다양한 용도로 사용할 수 있습니다. + +B<Inkscape>는 SVG를 네이티브 문서 형식으로 사용하며 오픈 소스 커뮤니티에서 사용할 수 있는 SVG 파일에 대한 가장 완벽한 +호환 도면 프로그램이 되는 것을 목표로 하고 있습니다. + + + +=head1 옵션 + +=over 8 + +=item B<-?>, B<--help> + +도움말 메시지를 표시합니다. + +=item B<--help-all> + +모든 도움말 옵션을 표시합니다. + +=item B<--help-gapplication> + +GApplication 옵션을 표시합니다. + +=item B<--help-gtk> + +GTK+ 옵션을 표시합니다. + +=item B<-V>, B<--version> + +Inkscape 버전 및 빌드 날짜를 표시합니다. + +=item B<--debug-info> + +Inkscape 버전, 종속성 버전 및 운영 체제를 포함한 기술 정보를 인쇄합니다. 이 정보는 Inkscape의 문제를 디버깅할 때 +유용하며 버그 보고서를 제출할 때마다 포함되어야 합니다. + +=item B<--system-data-directory> + +Inkscape와 함께 제공되는 데이터 파일이 저장된 시스템 데이터 디렉터리를 인쇄합니다. 여기에는 Inkscape에서 실행해야 하는 +파일(예: 장치 정의, 내장 키 맵, UI 레이아웃을 설명하는 파일, 아이콘 테마 등), 핵심 확장자, 스톡 리소스(필터, 글꼴, +표시도구, 색상 팔레트, 기호, 템플릿) 및 설명서(SVG 예시 파일, 튜토리얼)가 포함됩니다. + +Inkscape가 시스템 데이터 디렉터리를 L<INKSCAPE_DATADIR> 환경 변수로 재정의할 것으로 예상되는 위치입니다. + +=item B<--user-data-directory> + +사용자별 데이터 파일 및 환경설정이 저장된 사용자 프로필 디렉터리를 인쇄합니다. 사용자 지정 확장기능 및 리소스(필터, 글꼴, 표시도구, +색상 팔레트, 기호, 템플릿)는 이 디렉터리의 해당 하위 디렉터리에 설치해야 합니다. 또한 시스템 데이터 디렉터리에 있는 것과 동일한 +이름을 가진 파일을 배치하면 시스템 데이터 디렉터리(예: 기본 템플릿, UI 파일 등)에서 대부분의 프리셋을 재정의 할 수 있습니다. + +프로필 디렉터리의 기본 위치는 L<INKSCAPE_PROFILE_DIR> 환경 변수로 재정의할 수 있습니다. + +=item B<-p>, B<--pipe> + +표준 입력(stdin)에서 입력 파일을 읽습니다. + +=item B<--pdf-page>=I<PAGE> + +PDF 파일의 지정된 페이지를 가져옵니다. 페이지 번호는 1부터 시작합니다. + +=item B<--pdf-poppler> + +기본적으로 Inkscape는 내부(포플러 파생) 라이브러리를 통해 PDF 파일을 가져옵니다. 텍스트는 텍스트로 저장됩니다. 메시가 타일로 +전환시킵니다. 대신 L<--pdf-poppler>을 사용하여 외부(cairo 백엔드의 포플러) 라이브러리를 통해 가져옵니다. 텍스트는 각 +글리프가 경로인 복제된 글리프를 포함하는 그룹으로 구성됩니다. 이미지가 내부에 저장됩니다. 메시로 인해 전체 문서가 래스터 이미지로 +렌더링됩니다. + +=item B<--convert-dpi-method>=I<METHOD> + +픽셀 단위로 표현된 길이를 해석할 때 90DPI에서 96DPI로의 전환으로 인해 약간 더 작게 렌더링되는 기존(0.92 이전) 파일의 +크기를 재조정하는 데 사용되는 방법을 선택합니다. 가능한 값은 "none"(변경 사항 없음, 문서가 원래 크기의 94%로 렌더링됨), +"scale-viewbox"(문서가 전체적으로 조정되고 개별 길이가 그대로 유지됨) 및 "scale-document"(각 길이가 +개별적으로 재조정됩니다). + +=item B<--no-convert-text-baseline-spacing> + +열 때 기존(0.92 이전) 파일의 텍스트 기준선을 자동으로 수정하지 않습니다. Inkscape 0.92는 '줄-높이' 속성에 대한 +CSS 표준 정의를 채택하여 이전 버전과 다릅니다. 기본적으로 Inkscape 0.92 이전에 생성된 파일의 줄 높이 값은 불러오기 시, +의도한 텍스트 레이아웃을 유지하도록 조정됩니다. 이 명령줄 옵션은 해당 조정을 건너뜁니다. + +=item B<-o>, B<--export-filename>=I<FILENAME> + +출력 파일의 이름을 설정합니다. 기본값은 입력 파일의 이름을 재사용하는 것입니다. L<--export-type>도 사용되는 경우 파일 +확장자가 적절하게 조정(또는 추가)됩니다. 그렇지 않으면 내보낼 파일 형식이 지정된 파일 이름의 확장자에서 유추됩니다. + +특수 파일 이름 "-"를 사용하면 Inkscape가 이미지 데이터를 표준 출력(stdout)에 기록합니다. + +=item B<--export-overwrite> + +입력 파일을 덮어씁니다. + +=item B<--export-type>=I<유형[,유형]*> + +내보낼 파일 형식을 지정합니다. 가능한 값: svg, png, ps, eps, pdf, emf, wmf 및 내보내기 확장자가 존재하는 +모든 파일 유형. 한 번에 둘 이상의 파일 형식을 내보낼 수 있습니다. + +PostScript는 투명도를 지원하지 않으므로 원본 SVG의 모든 투명 객체는 자동으로 래스터화됩니다. 사용된 글꼴은 하위 집합이며 +포함되어 있습니다. 기본 내보내기 영역은 페이지입니다. L<--export-area-drawing>로 도면을 그리도록 설정할 수 +있습니다. + +PDF 형식은 원본 SVG의 투명도를 보존합니다. + +=item B<--export-extension>=I<EXTENSION-ID> + +지정된 파일 유형에 대해 둘 이상의 내보내기 옵션이 있는 경우 특히 관련이 있는 내보내기에 사용할 출력 확장자를 지정할 수 +있습니다. 설정하면 --export-filename 및 --export-type의 파일 확장자가 생략될 수 있습니다. 또한 설정하면 +--export-type에 하나의 파일 형식만 제공될 수 있습니다. + +=item B<-C>, B<--export-area-page> + +SVG, PNG, PDF, PS에서 내보낸 영역은 페이지입니다. 이것은 SVG, PNG, PDF 및 PS의 기본값이므로 +L<--export-id>을 사용하여 특정 객체를 내보내는 경우가 아니면, 이를 지정할 필요가 없습니다. EPS의 경우 이 옵션은 현재 +지원되지 않습니다. + +=item B<-D>, B<--export-area-drawing> + +SVG, PNG, PDF, PS 및 EPS 내보내기에서 내보낸 영역은 도면(페이지가 아님)입니다. 즉, 문서의 모든 객체(또는 +L<--export-id>이 사용된 경우 내보낸 객체)의 경계 상자입니다. 이 옵션을 사용하면 내보낸 이미지에 문서의 보이는 모든 객체가 +여백이나 자르기 없이 표시됩니다. 이것은 EPS의 기본 내보내기 영역입니다. PNG의 경우 L<--export-use-hints>과 +조합하여 사용할 수 있습니다. + +=item B<-a> I<x0:y0:x1:y1>, B<--export-area>=I<x0:y0:x1:y1> + +PNG 내보내기에서 문서의 내보낸 영역을 px(1/96인치)로 지정하여 설정합니다. 기본값은 전체 문서 페이지를 내보내는 것입니다. 점 +(0,0)은 왼쪽 하단 모서리입니다. + +=item B<--export-area-snap> + +PNG 내보내기의 경우, 내보내기 영역을 가장 가까운 정수 px 값에 맞춥니다. 96dpi의 기본 내보내기 해상도를 사용 중이고 +앤티앨리어싱을 최소화하기 위해 그래픽이 픽셀 스냅된 경우, 이 스위치를 사용하면 자체적으로 픽셀 줄맞춤되지 않은 일부 객체의 경계 +상자(L<--export-id> 또는 L<--export-area-drawing> 포함)를 내보내는 경우에도 이 줄맞춤을 유지할 수 +있습니다. + +=item B<-d> I<DPI>, B<--export-dpi>=I<DPI> + +PNG 내보내기에 사용되는 해상도입니다. PS, EPS 또는 PDF로 내보낼 때 필터링된 객체의 대체 래스터화에도 사용됩니다(래스터화를 +억제하기 위해 L<--export-ignore-filters>을 지정하지 않는 한). 기본값은 96dpi이며, 이는 1비트맵 픽셀로 +내보내는 1 SVG 사용자 단위(px, "사용자 단위"라고도 함)에 해당합니다. 이 값은 L<--export-use-hints>과 함께 +사용되는 경우 DPI 힌트를 재정의합니다. + +=item B<-w> I<WIDTH>, B<--export-width>=I<WIDTH> + +생성된 비트맵의 너비(픽셀)입니다. 이 값은 L<--export-dpi> 설정(또는 L<--export-use-hints>와 함께 +사용되는 경우 DPI 힌트)을 재정의합니다. + +=item B<-h> I<HEIGHT>, B<--export-height>=I<HEIGHT> + +생성된 비트맵의 높이(픽셀)입니다. 이 값은 L<--export-dpi> 설정(또는 L<--export-use-hints>와 함께 +사용되는 경우 DPI 힌트)을 재정의합니다. + +=item B<--export-margin>=I<MARGIN> + +내보낸 영역 주위에 여백을 추가합니다. 여백 크기는 페이지 크기(SVG의 경우) 또는 밀리미터(PS/PDF의 경우) 단위로 +지정됩니다. 이 옵션은 현재 다른 내보내기 형식에 영향을 주지 않습니다. + +=item B<-i> I<ID>, B<--export-id>=I<객체-ID[;객체-ID]*> + +PNG, PS, EPS, PDF 및 일반 SVG 내보내기의 경우 문서에서 내보내려는 객체의 id 속성 값. 다른 모든 객체는 내보내지지 +않습니다. 기본적으로 내보낸 영역은 객체의 경계 상자입니다. L<--export-area>(PNG만 해당) 또는 +L<--export-area-page>을 사용하여 이를 재정의할 수 있습니다. + +세미콜론으로 구분된 객체 목록으로 많은 값을 지정하면 각 값이 개별적으로 내보내집니다. 이 경우 내보낸 파일의 이름은 다음과 같습니다: +[input_filename]_[ID].[export_type] + +=item B<-j>, B<--export-id-only> + +PNG, PS, EPS, PDF 및 일반 SVG 내보내기의 경우 ID가 L<--export-id>로 지정된 객체만 내보냅니다. 다른 모든 +객체는 숨겨지며 내보낸 객체를 오버레이하더라도 내보내기에 표시되지 않습니다. L<--export-id>이 없으면, 이 옵션은 무시됩니다. + +=item B<-l>, B<--export-plain-svg> + +sodipodi: 또는 inkscape: 이름공간 및 RDF 메타데이터 없이 일반 SVG 형식으로 문서를 내보냅니다. L 옵션을 사용하여 +파일 이름을 지정합니다. + +=item B<--export-png-color-mode>=I<COLORMODE> + +내보낸 비트맵의 색상 모드(비트 심도 및 색상 유형)를 설정합니다 +(Gray_1/Gray_2/Gray_4/Gray_8/Gray_16/RGB_8/RGB_16/GrayAlpha_8/GrayAlpha_16/RGBA_8/RGBA_16) + +=item B<--export-png-use-dithering>=I<false|true> + +디더링을 강제하거나 비활성화합니다(Inkscape 빌드는 이를 위해 디더링을 지원해야 함). + +=item B<--export-ps-level>=I<LEVEL> + +PS 및 EPS 내보내기용 언어 버전을 설정합니다. PostScript 레벨 2 또는 3이 지원됩니다. 기본값은 3입니다. + +=item B<--export-pdf-version>=I<VERSION> + +내보낸 PDF 파일의 PDF 버전을 선택합니다. 이 옵션은 기본적으로 GUI의 PDF 내보내기 대화 상자에 있는 PDF 버전 선택기를 +표시합니다. 해당 콤보 상자의 버전 중 하나를 제공해야 합니다. "1.4". 기본 PDF 내보내기 버전은 "1.4"입니다. + +=item B<-T>, B<--export-text-to-path> + +해당되는 경우, 내보낼 때 텍스트 객체를 경로로 전환시킵니다(PS, EPS, PDF 및 SVG 내보내기의 경우). + +=item B<--export-latex> + +(PS, EPS 및 PDF 내보내기용) 이미지의 텍스트가 LaTeX에 의해 조판되는 LaTeX 문서용 이미지를 만드는 데 +사용됩니다. PDF/PS/EPS 형식으로 내보낼 때 이 옵션은 출력을 PDF/PS/EPS 파일(예: --export-type로 지정된 +대로)과 LaTeX 파일로 분할합니다. 텍스트는 PDF/PS/EPS 파일로 출력되지 않고 대신 LaTeX 파일에 나타납니다. 이 +LaTeX 파일에는 PDF/PS/EPS가 포함되어 있습니다. LaTeX 문서에 LaTeX 파일을 +입력(\input{image.tex})하면 이미지가 표시되고 모든 텍스트는 LaTeX에 의해 조판됩니다. 자세한 내용은 결과 LaTeX +파일을 참조하십시오. 또한 GNUPlot의 'epslatex' 출력 터미널을 참조하십시오. + +=item B<--export-ignore-filters> + +필터를 무시하고 필터링된 객체(예: 흐릿한 객체)를 벡터로 내보냅니다(PS, EPS 및 PDF 내보내기용). 기본적으로 필터링된 모든 +객체는 L<--export-dpi> (기본값 96dpi)에서 래스터화되어 모양을 유지합니다. + +=item B<-t>, B<--export-use-hints> + +PNG로 내보내는 동안 내보낸 객체에 저장된 내보내기 파일 이름 및 DPI 힌트를 사용합니다(L만 포함). 이러한 힌트들은 +Inkscape 내에서 선택 항목을 내보낼 때 자동으로 설정됩니다. 따라서 예를 들어 Inkscape GUI를 사용하여 +document.svg에서 300dpi에서 id="path231"인 도형을 /home/me/shape.png로 내보내고 문서를 저장하면 +나중에 다음과 같은 해상도로 동일한 파일로 해당 도형을 다시 내보낼 수 있습니다 + + inkscape -i path231 -t document.svg + +이 옵션과 함께 L<--export-dpi>, L<--export-width> 또는 L<--export-height>을 사용하면 DPI +힌트가 무시되고 명령줄의 값이 사용됩니다. 이 옵션과 함께 L<--export-filename>을 사용하면 파일 이름 힌트가 무시되고 +명령줄의 파일 이름이 사용됩니다. + +=item B<-b> I<COLOR>, B<--export-background>=I<COLOR> + +내보낸 PNG의 배경색입니다. "#ff007f" 또는 "rgb(255, 0, 128)"와 같이 SVG가 지원하는 색상 문자열일 수 +있습니다. 설정하지 않으면 문서 속성 대화 상자의 Inkscape에 설정된 페이지 색상이 사용됩니다(sodipodi:namedview의 +pagecolor= 속성에 저장됨). + + + +=item B<-y> I<VALUE>, B<--export-background-opacity>=I<VALUE> + +내보낸 PNG 배경의 불투명도입니다. 0.0에서 1.0 사이의 값(0.0은 완전한 투명도, 1.0은 완전한 불투명도를 의미) 또는 1보다 +큰 값에서 최대 255(255는 완전한 불투명도를 의미) 사이의 값일 수 있습니다. 설정하지 않고 -b 옵션을 사용하지 않으면 문서 속성 +대화 상자의 Inkscape에 설정된 페이지 불투명도가 사용됩니다(sodipodi:namedview의 +inkscape:pageopacity= 속성에 저장됨). 설정하지 않았지만 -b 옵션을 사용하면 값 255(전체 불투명도)가 사용됩니다. + +=item B<-I>, B<--query-id>=I<객체-ID[,객체-ID]*> + +차원이 쉼표로 구분된 목록에서 쿼리되는 객체의 ID를 설정합니다. 설정하지 않으면 쿼리 옵션은 페이지나 보기상자가 아닌 도면의 치수(즉, +모든 문서 객체)를 반환합니다. + +쉼표로 구분된 객체 목록으로 많은 값을 지정하는 경우 모든 기하 쿼리(예: L<--query-x>)는 I<--query-id>의 객체 +목록에 해당하는 쉼표로 구분된 값 목록을 반환합니다. + +=item B<-S>, B<--query-all> + +x, y, 너비 및 높이 값과 함께 ID가 정의된 SVG 문서에서 모든 객체의 쉼표로 구분된 목록을 인쇄합니다. + +=item B<-X>, B<--query-x> + +도면의 X 좌표 또는 지정된 경우, L<--query-id>이 있는 객체의 X 좌표를 쿼리합니다. 반환된 값은 px(SVG 사용자 +단위)입니다. + +=item B<-Y>, B<--query-y> + +도면의 Y 좌표 또는 지정된 경우 L<--query-id>을 사용하여 객체의 Y 좌표를 쿼리합니다. 반환된 값은 px(SVG 사용자 +단위)입니다. + +=item B<-W>, B<--query-width> + +도면의 너비 또는 지정된 경우 L<--query-id>을 사용하여 객체의 너비를 쿼리합니다. 반환된 값은 px(SVG 사용자 +단위)입니다. + +=item B<-H>, B<--query-height> + +도면의 높이 또는 지정된 경우 <--query-id>L을 사용하여 객체의 높이를 쿼리합니다. 반환된 값은 px(SVG 사용자 +단위)입니다. + +=item B<--vacuum-defs> + +SVG 파일의 C<E<lt>defsE<gt>> 섹션에서 사용하지 않는 항목을 모두 제거합니다. 이 옵션을 +L<--export-plain-svg>과 함께 호출하면 내보낸 파일만 영향을 받습니다. 단독으로 사용하면 지정된 파일이 제자리에서 +수정됩니다. + +=item B<--select>=I<객체-ID[,객체-ID]*> + +L<--select> 명령을 사용하면 ID가 지정된 객체가 선택됩니다. 쉼표로 구분된 목록으로 여러 객체 너비를 선택할 수 +있습니다. 이것은 다양한 동사가 그것들에 작용하도록 허용합니다. 모든 선택 항목을 제거하려면 C<--verb=EditDeselect>를 +사용합니다. 사용 가능한 객체 ID는 불러오도록 지정된 문서에 따라 달라집니다. + +=item B<--actions>=I<동작(:ARG)[;동작(:ARG)]*> + +작업은 선택적 단일 매개 변수를 사용하여 함수를 호출하는 새로운 방법입니다. 사용 가능한 작업 ID 목록을 가져오려면 +L<--action-list> 명령줄 옵션을 사용합니다. 결국 모든 동사는 행동으로 대체될 것입니다. 일시적으로 모든 동사를 (매개 +변수 없이) 동작으로 사용할 수 있습니다. 대부분의 동사는 GUI를 (사용하지 않더라도) GUI를 필요로 합니다. 처리가 끝날 때 +GUI를 자동으로 닫으려면 L<--batch-process>을 사용하십시오. 또한 모든 내보내기 옵션에는 일치하는 작업이 있습니다(옵션 +앞의 '--'를 제거하고 '='를 ':'로 대체). + +동작만 사용되는 경우 L<--batch-process>을 사용해야 합니다. + +내보내기는 export-do 작업으로 언제든지 강제로 실행할 수 있습니다. 이렇게 하면 단일 파일에서 여러 내보내기를 수행할 수 +있습니다. + +=item B<--action-list> + +모든 사용 가능한 작업의 목록을 인쇄합니다. + +=item B<--actions-file>=I<FILENAME> + +파일에 나열된 모든 작업을 실행합니다. 파일 내용은 L<--actions> 구문을 사용하여 형식을 지정해야 합니다. 이 옵션은 +L<--actions> 인수가 모두 제공될 때 무시됩니다. + +=item B<-g>, B<--with-gui> + +GUI를 사용해 보십시오(Unix에서는 $DISPLAY가 설정되지 않은 경우에도 X 서버를 사용합니다). + +=item B<-q>, B<--active-window> + +새 Inkscape 프로세스를 시작하는 대신, 가장 최근에 집중한 Inkscape 문서에서 명령을 실행합니다. + +=item B<--display>=I<DISPLAY> + +Inkscape 창에 사용할 X 디스플레이를 설정합니다. + +=item B<--app-id-tag>=I<TAG> + +응용프로그램 ID 'org.inkscape.Inkscape.TAG'를 사용하여 고유한 Inkscape 인스턴스를 만듭니다. 이는 다른 +Inkscape 버전을 실행하거나 다른 기본 설정 파일을 동시에 사용할 때 Inkscape 인스턴스를 분리하는 데 유용합니다. + +=item B<--batch-process> + +모든 작업 또는 동사를 실행한 후 GUI를 닫습니다. + +=item B<--shell> + +이 매개변수를 사용하면 Inkscape가 대화형 명령줄 셸 모드로 전환됩니다. 이 모드에서는 프롬프트에서 명령을 입력하면 +Inkscape가 명령을 실행하므로 각 명령에 대해 Inkscape의 새 복사본을 실행할 필요가 없습니다. 이 기능은 주로 스크립팅 및 +서버 사용에 유용합니다: 새로운 기능은 추가되지 않지만 Inkscape를 반복적으로 호출하여 명령줄 작업(예: 내보내기 또는 변환)을 +수행하는 모든 스크립트의 속도 및 메모리 요구 사항을 개선할 수 있습니다. + +셸 모드에서 Inkscape는 일련의 동작(또는 동사)을 입력으로 예상합니다. 한 줄씩 처리되며 이는 일반적으로 Enter 키를 누를 +때를 의미합니다. 모든 작업을 한 줄에 넣는 것은 가능하지만 필수는 아닙니다. + +이 옵션은 L<--active-window> 매개변수와 결합하여, 이미 열려 있는 Inkscape 문서에서 셸 명령을 실행할 수 +있습니다. + +다음 예시에서는 파일을 열고 두 가지 형식으로 내보낸 다음 다른 파일을 열고 단일 객체를 내보냅니다: + + file-open:file1.svg; export-type:pdf; export-do; export-type:png; export-do + file-open:file2.svg; export-id:rect2; export-id-only; export-filename:rect_only.svg; export-do + +=back + +=head1 구성 + +기본 구성 파일은 ~/.config/inkscape/preferences.xml에 있습니다. Inkscape에서 변경할 수 있는 다양한 +사용자 맞춤 설정을 저장합니다(주로 Inkscape 환경설정 대화상자에서). 또한 하위 디렉터리에 다음을 배치할 수 있습니다: + +B<$HOME>/.config/inkscape/extensions/ - 확장기능. + +B<$HOME>/.config/inkscape/fonts/ - 글꼴. + +B<$HOME>/.config/inkscape/icons/ - 아이콘 세트. + +B<$HOME>/.config/inkscape/keys/ - 키보드 맵. + +B<$HOME>/.config/inkscape/paint/ - 패턴 및 해치. + +B<$HOME>/.config/inkscape/palettes/ - 팔레트. + +B<$HOME>/.config/inkscape/symbols/ - 기호 파일. + +B<$HOME>/.config/inkscape/templates/ - 새 파일 템플릿. + +B<$HOME>/.config/inkscape/ui/ - 사용자 인터페이스 파일. + +=head1 진단 + +프로그램은 성공하면 0을 반환하고 실패하면 0이 아닌 값을 반환합니다. + +다양한 오류 메시지와 경고가 STDERR 또는 STDOUT에 인쇄될 수 있습니다. 프로그램이 특정 SVG 파일과 함께 비정상적으로 +작동하거나 충돌하는 경우 이 출력에서 단서를 찾는 것이 유용합니다. + +=head1 예시 + +분명히 B<Inkscape>는 주로 GUI 애플리케이션으로 의도되었지만 명령줄에서 SVG 처리를 수행하는 데에도 사용할 수 있습니다. + +GUI에서 SVG 파일 열기: + + inkscape filename.svg + +SVG 파일을 96dpi의 기본 해상도로 PNG로 내보내기 (하나의 SVG 사용자 단위는 하나의 비트맵 픽셀로 변환됨): + + inkscape --export-filename=filename.png filename.svg + +동일하지만, PNG 파일을 600x400픽셀로 강제 설정합니다: + + inkscape --export-filename=filename.png -w 600 -h 400 filename.svg + +동일하지만 페이지가 아닌 도면(모든 객체의 경계 상자)을 내보냅니다: + + inkscape --export-filename=filename.png --export-area-drawing filename.svg + +2개의 다른 파일을 각각 4개의 고유한 파일 형식으로 내보냅니다: + + inkscape --export-type=png,ps,eps,pdf filename1.svg filename2.svg + +GUI에서 마지막으로 내보낼 때 해당 객체에 사용된 출력 파일 이름과 해상도를 사용하여 id="text1555"인 객체를 PNG로 +내보냅니다: + + inkscape --export-id=text1555 --export-use-hints filename.svg + +동일하지만 기본 96dpi 해상도를 사용하고 파일 이름을 지정하고 내보낸 영역을 가장 가까운 전체 SVG 사용자 단위 값에 +맞춥니다(객체의 픽셀 줄맞춤을 유지하여 앨리어싱을 최소화하기 위해): + + inkscape --export-id=text1555 --export-filename=text.png --export-area-snap filename.svg + +잉크스케이프 SVG 문서를 일반 SVG로 전환시킵니다: + + inkscape --export-plain-svg --export-filename=filename2.svg filename1.svg + +SVG 문서를 EPS로 변환하여 모든 텍스트를 경로로 전환시킵니다: + + inkscape --export-filename=filename.eps --export-text-to-path filename.svg + +id="text1555"를 사용하여 객체의 너비를 쿼리합니다: + + inkscape --query-width --query-id=text1555 filename.svg + +id="path1555" 및 id="rect835"로 객체를 중복하고, 중복체를 90도 회전하고, SVG를 저장하고, 종료합니다: + + inkscape --select=path1555,rect835 --actions="duplicate;object-rotate-90-cw" --export-overwrite filename.svg + +타원 태그가 있는 모든 객체를 선택하고 30도 회전한 다음 파일을 저장하고 종료합니다. + + inkscape --actions="select-by-element:ellipse;transform-rotate:30" --export-overwrite filename.svg + +반투명 보라색 배경이 있는 MyTriangle ID가 있는 객체를 triangle_purple.png 파일로, 빨간색 배경을 가진 객체를 +triangle_red.png 파일로 내보냅니다. + + inkscape --actions="export-id:MyTriangle; export-id-only; export-background:purple; export-background-opacity:0.5;export-filename:triangle_purple.png; export-do; export-background:red; export-background-opacity:1; export-filename:triangle_red.png; export-do" filename.svg + +표준 입력(stdin)에서 SVG를 읽고 PDF 형식으로 내보냅니다: + + cat filename.svg | inkscape --pipe --export-filename=filename.pdf + +SVG를 PNG 형식으로 내보내고 표준 출력(stdout)으로 작성한 다음 ImageMagick의 변환 프로그램을 사용하여 JPG +형식으로 전환시킵니다: + + inkscape --export-type=png --export-filename=- filename.svg | convert - filename.jpg + +위와 같지만, 파이프에서 판독합니다(--export-filename 이 경우 생략 가능) + + cat filename.svg | inkscape --pipe --export-type=png | convert - filename.jpg + +=head1 환경 변수 + +=over 8 + +=item B<INKSCAPE_PROFILE_DIR> + +사용자 프로필 디렉터리의 사용자 지정 위치를 설정합니다. + +=item B<INKSCAPE_DATADIR> + +Inkscape 데이터 디렉터리의 사용자 지정 위치를 설정합니다(예: Inkscape의 공유 파일이 +B<$PREFIX>/share/inkscape에 있는 경우 B<$PREFIX>/share). + +=item B<INKSCAPE_LOCALEDIR> + +번역 범주의 사용자 지정 위치를 설정합니다. + +=back + +자세한 내용은 L<http://wiki.inkscape.org/wiki/index.php/Environment_variables>도 +참조하십시오 + +=head1 기타 정보 + +B<Inkscape> 정보를 찾을 수 있는 표준 위치는 L<https://www.inkscape.org/>입니다. 웹사이트에는 뉴스, +문서, 튜토리얼, 예제, 메일링 리스트 아카이브, 프로그램의 최신 릴리스 버전, 버그 및 기능 요청 데이터베이스, 포럼 등이 있습니다. + +=head1 참고 항목 + +L<potrace>, L<cairo>, L<rsvg>, L<batik>, L<ghostscript>, L<pstoedit>. + +SVG 적합성 테스트 도구 모음: +L<https://www.w3.org/Graphics/SVG/WG/wiki/Test_Suite_Overview> + +SVG 유효성 검사기: L<https://validator.w3.org/> + +I<Scalable Vector Graphics (SVG) 1.1 Specification> I<W3C Recommendation 16 +August 2011> L<https://www.w3.org/TR/SVG11/> + +I<Scalable Vector Graphics (SVG) 1.2 Specification> I<W3C Working Draft 13 +April 2005> L<https://www.w3.org/TR/SVG12/> + +I<Scalable Vector Graphics (SVG) 2 Specification> I<W3C Candidate +Recommendation 15 September 2016> L<https://www.w3.org/TR/SVG2/> + +I<Document Object Model (DOM): Level 2 Core> I<W3C Recommendation 13 +November 2000> L<https://www.w3.org/TR/DOM-Level-2-Core/> + + + +=head1 GUI 참고 + +Inkscape의 GUI 작동을 배우려면 도움말 > Inkscape 설명서의 설명서와 도움말 > 튜토리얼에서 튜토리얼을 읽으십시오. + +SVG 외에도, Inkscape는 대부분의 비트맵 형식(PNG, BMP, JPG, XPM, GIF 등), 일반 텍스트(Perl 필요), +PS 및 EPS(Ghostscript 필요), PDF 및 AI 형식( AI 버전 9.0 이상)을 가져오기(파일 > 가져오기)할 수 +있습니다. + +Inkscape는 파일 > 다른 이름으로 저장하기를 통해 AI, PS, EPS, PDF, DXF 및 기타 여러 형식은 물론 32비트 +PNG 이미지(파일 > PNG 이미지 내보내기)를 내보냅니다. + +Inkscape는 멋글씨 펜을 포함한 여러 도구의 두께, 각도 및 작용력에 대해 그래픽 태블릿 펜의 압력과 기울기를 사용할 수 있습니다. + +Inkscape에는 Inkscape에 포함된 Potrace 비트맵 추적 엔진(L<http://potrace.sf.net>)에 대한 GUI +프런트 엔드가 포함되어 있습니다. + +Inkscape는 확장기능 메뉴의 명령으로 표시되는 외부 스크립트(stdin-to-stdout 필터)를 사용할 수 있습니다. 스크립트는 +다양한 매개변수를 설정하기 위한 GUI 대화 상자를 가질 수 있으며 명령줄을 통해 작동할 선택된 객체의 ID를 가져올 수 +있습니다. Inkscape는 Python으로 작성된 다양한 효과와 함께 제공됩니다. + +=head1 키 바인딩 + +키보드 및 마우스 단축키의 전체 목록을 보려면 doc/keys.html을 보거나 도움말 메뉴에서 키 및 마우스 명령을 사용하십시오. + +=head1 버그 + +많은 버그가 알려져 있습니다. 보고된 사항에 대한 검토 및 새로 발견된 문제점에 대한 보고는 +홈페이지(L<https://www.inkscape.org/>)를 참조하시기 바랍니다. 사용 중인 버전의 릴리스 노트에서 알려진 문제 +섹션도 참조하십시오(파일 `뉴스'). + +=head1 내역 + +Inkscape가 된 코드베이스는 Raph Levien이 만든 GNOME Illustrator 애플리케이션인 Gill 프로그램으로 +1999년에 시작되었습니다. Gill의 명시된 목표는 궁극적으로 모든 SVG를 지원하는 것이었습니다. Raph는 자획 및 채움, 라인 캡 +스타일, 라인 결합 스타일, 텍스트 등을 포함한 PostScript 베지어 이미징 모델을 구현했습니다. Raph의 Gill 페이지는 +L<http://www.levien.com/svg/>에 있습니다. Gill에 대한 작업은 2000년에 느려지거나 중단된 것으로 보입니다. + +코드베이스의 다음 구현은 Lauris Kaplinski가 이끄는 매우 인기 있는 프로그램 Sodipodi가 되는 +것이었습니다. 코드베이스는 몇 년 간의 작업을 통해 강력한 일러스트레이션 프로그램으로 바뀌었고 몇 가지 새로운 기능, 다국어 지원, +Windows 및 기타 운영 체제로의 이식, 종속성 제거를 추가했습니다. + +Inkscape는 2003년에 4명의 활동적인 Sodipodi 개발자인 Bryce Harrington, MenTaLguY, Nathan +Hurst 및 Ted Gould에 의해 형성되었으며, SVG 규정 준수, 인터페이스 모양새 및 그리고 더 많은 참여자들에게 개발 기회를 +열어주고자 하는 욕구라는 측면에서 코드베이스와 다른 방향을 취하기를 원하면서 형성되었습니다. 프로젝트는 빠르게 진행되었고, 많은 적극적인 +기여자들과 특징들을 확보했습니다. + +프로젝트 초기의 많은 작업은 코드 안정화 및 국제화에 중점을 두었습니다. Sodipodi에서 상속된 원래 렌더러에는 프로그램이 일상적인 +사용을 넘어서 밀어넣을 때 예기치 않은 충돌로 이어지는 수학적 코너 케이스가 많았습니다. 이 렌더러는 완벽하지는 않지만 오류가 발생하기 +쉬운 Livarot로 대체되었습니다. 이 프로젝트는 또한 코드를 자주 커밋하고 사용자가 프로그램의 개발 스냅샷을 실행하도록 권장하는 +방식을 채택했습니다. 이는 새로운 버그를 신속하게 식별하고 사용자가 수정 사항을 쉽게 확인할 수 있도록 하는 데 도움이 되었습니다. 그 +결과, Inkscape 릴리즈는 일반적으로 강력하고 신뢰할 수 있다는 평판을 얻었습니다. + +마찬가지로, 인터페이스를 국제화하고 현지화하기 위한 노력을 기울였으며, 이는 프로그램이 전 세계적으로 기여자를 확보하는 데 도움이 +되었습니다. + +Inkscape는 아이콘, 시작 화면, 웹 사이트 아트 등을 만들고 공유하는 도구를 제공함으로써 일반적으로 오픈 소스의 시각적 매력에 +좋은 영향을 끼쳤습니다. 어떤 면에서, "단지 그림 그리는 프로그램"임에도 불구하고, Inkscape는 오픈 소스를 더 많은 대중들에게 +시각적으로 자극을 주는 중요한 역할을 했습니다. + +=head1 작성자 + +이 코드베이스는 다양한 시대에 걸쳐 많은 기여자들이 존재했습니다. 다음 목록은 분명 불완전하지만 이 애플리케이션이 차지하는 많은 짊어짐을 +인식합니다: + +${INKSCAPE_AUTHORS} + +=head1 저작권 및 라이선스 + +B<Copyright (C)> 1999-2023 by Authors. + +B<Inkscape>는 자유 소프트웨어입니다. GPL 버전 2 이상의 조건에 따라 재배포 및/또는 수정할 수 있습니다. + + + +=for 주석 $Date$ + diff --git a/man/inkscape.pod.in b/man/inkscape.pod.in new file mode 100644 index 0000000..66e2a42 --- /dev/null +++ b/man/inkscape.pod.in @@ -0,0 +1,785 @@ + ************************************************************ + * NOTE: Please do not edit this file directly. * + * * + * Changes should be applied to the source file at * + * https://gitlab.com/inkscape/inkscape-docs/documentation/ * + ************************************************************ + +=encoding UTF-8 + +=head1 NAME + +Inkscape - an SVG (Scalable Vector Graphics) editing program. + +=head1 SYNOPSIS + +C<inkscape [options] [filename_1 filename_2 ...]> + +options: + + -?, --help + --help-all + --help-gapplication + --help-gtk + + -V, --version + --debug-info + --system-data-directory + --user-data-directory + + -p, --pipe + --pdf-page=PAGE + --pdf-poppler + --convert-dpi-method=METHOD + --no-convert-text-baseline-spacing + + -o, --export-filename=FILENAME + --export-overwrite + --export-type=TYPE[,TYPE]* + --export-extension=EXTENSION-ID + + -C, --export-area-page + -D, --export-area-drawing + -a, --export-area=x0:y0:x1:y1 + --export-area-snap + -d, --export-dpi=DPI + -w, --export-width=WIDTH + -h, --export-height=HEIGHT + --export-margin=MARGIN + + -i, --export-id=OBJECT-ID[;OBJECT-ID]* + -j, --export-id-only + -l, --export-plain-svg + --export-png-color-mode=COLORMODE + --export-png-use-dithering=BOOLEAN + --export-ps-level=LEVEL + --export-pdf-version=VERSION + -T, --export-text-to-path + --export-latex + --export-ignore-filters + -t, --export-use-hints + -b, --export-background=COLOR + -y, --export-background-opacity=VALUE + + -I, --query-id=OBJECT-ID[,OBJECT-ID]* + -S, --query-all + -X, --query-x + -Y, --query-y + -W, --query-width + -H, --query-height + + --vacuum-defs + --select=OBJECT-ID[,OBJECT-ID]* + --actions=ACTION(:ARG)[;ACTION(:ARG)]* + --action-list + --actions-file=FILENAME + + -g, --with-gui + -q, --active-window + --display=DISPLAY + --app-id-tag=TAG + --batch-process + --shell + + +=head1 DESCRIPTION + +B<Inkscape> is a Free and open source vector graphics editor. It offers a rich +set of features and is widely used for both artistic and technical +illustrations such as cartoons, clip art, logos, typography, diagramming and +flowcharting. +It uses vector graphics to allow for sharp printouts and renderings at +unlimited resolution and is not bound to a fixed number of pixels like raster +graphics. Inkscape uses the standardized B<SVG> file format as its main format, +which is supported by many other applications including web browsers. + +The interface is designed to be comfortable and efficient for skilled users, +while remaining conformant to B<GNOME> standards so that users familiar with +other GNOME applications can learn its interface rapidly. + +B<SVG> is a W3C standard XML format for 2D vector drawing. It allows +defining objects in the drawing using points, paths, and primitive +shapes. Colors, fonts, stroke width, and so forth are specified as +`style' attributes to these objects. The intent is that since SVG is a +standard, and since its files are text/xml, it will be possible to use +SVG files in a sizeable number of programs and for a wide range of uses. + +B<Inkscape> uses SVG as its native document format, and has the goal of +becoming the most fully compliant drawing program for SVG files +available in the Open Source community. + + +=head1 OPTIONS + +=over 8 + +=item B<-?>, B<--help> + +Shows a help message. + +=item B<--help-all> + +Shows all help options. + +=item B<--help-gapplication> + +Shows the GApplication options. + +=item B<--help-gtk> + +Shows the GTK+ options. + +=item B<-V>, B<--version> + +Shows the Inkscape version and build date. + +=item B<--debug-info> + +Prints technical information including Inkscape version, dependency versions and operating system. +This Information is useful when debugging issues with Inkscape and should be included whenever +filing a bug report. + +=item B<--system-data-directory> + +Prints the system data directory where data files that ship with Inkscape are stored. This includes +files which Inkscape requires to run (like unit definitions, built-in key maps, files describing UI +layout, icon themes, etc.), core extensions, stock resources (filters, fonts, markers, color +palettes, symbols, templates) and documentation (SVG example files, tutorials). + +The location in which Inkscape expects the system data directory can be overridden with the +L<INKSCAPE_DATADIR> environment variable. + +=item B<--user-data-directory> + +Prints the user profile directory where user-specific data files and preferences are stored. +Custom extensions and resources (filters, fonts, markers, color palettes, symbols, templates) +should be installed into their respective subdirectories in this directory. In addition placing a +file with a name identical to one in the system data directory here allows to override most presets +from the system data directory (e.g. default templates, UI files, etc.). + +The default location of the profile directory can be overridden with the L<INKSCAPE_PROFILE_DIR> +environment variable. + +=item B<-p>, B<--pipe> + +Reads input file from standard input (stdin). + +=item B<--pdf-page>=I<PAGE> + +Imports the given page of a pdf file. Numbering starts with 1. + +=item B<--pdf-poppler> + +By default Inkscape imports PDF files via an internal (poppler-derived) library. +Text is stored as text. Meshes are converted to tiles. +Use L<--pdf-poppler> to import via an external (poppler with cairo backend) library +instead. Text consists of groups containing cloned glyphs where each glyph is a path. +Images are stored internally. Meshes cause entire document to be rendered as a raster image. + +=item B<--convert-dpi-method>=I<METHOD> + +Choose method used to rescale legacy (pre-0.92) files which render +slightly smaller due to the switch from 90 DPI to 96 DPI when interpreting +lengths expressed in units of pixels. Possible values are "none" (no +change, document will render at 94% of its original size), "scale-viewbox" +(document will be rescaled globally, individual lengths will stay +untouched) and "scale-document" (each length will be re-scaled +individually). + +=item B<--no-convert-text-baseline-spacing> + +Do not automatically fix text baselines in legacy (pre-0.92) files on +opening. Inkscape 0.92 adopts the CSS standard definition for the +'line-height' property, which differs from past versions. By default, +the line height values in files created prior to Inkscape 0.92 will be +adjusted on loading to preserve the intended text layout. This command +line option will skip that adjustment. + +=item B<-o>, B<--export-filename>=I<FILENAME> + +Sets the name of the output file. The default is to re-use the name of the input file. +If L<--export-type> is also used, the file extension will be adjusted (or added) as appropriate. +Otherwise the file type to export will be inferred from the extension of the specified filename. + +Usage of the special filename "-" makes Inkscape write the image data to standard output (stdout). + +=item B<--export-overwrite> + +Overwrites input file. + +=item B<--export-type>=I<TYPE[,TYPE]*> + +Specify the file type to export. Possible values: svg, png, ps, eps, pdf, emf, wmf +and every file type for which an export extension exists. It is possible to export +more than one file type at a time. + +Note that PostScript does not support transparency, so any transparent +objects in the original SVG will be automatically rasterized. Used fonts +are subset and embedded. The default export area is page; you can set it +to drawing by L<--export-area-drawing>. + +Note that PDF format preserves the transparency in the original SVG. + +=item B<--export-extension>=I<EXTENSION-ID> + +Allows to specify an output extension that will be used for exporting, which +is especially relevant if there is more than one export option for a +given file type. If set, the file extension in --export-filename and +--export-type may be omitted. Additionally, if set, only one file type +may be given in --export-type. + +=item B<-C>, B<--export-area-page> + +In SVG, PNG, PDF, PS exported area is the page. This is the +default for SVG, PNG, PDF, and PS, so you don't need to specify this unless +you are using L<--export-id> to export a specific object. For EPS this option +is currently not supported. + +=item B<-D>, B<--export-area-drawing> + +In SVG, PNG, PDF, PS, and EPS export, exported area is the drawing (not +page), i.e. the bounding box of all objects of the document (or of the +exported object if L<--export-id> is used). With this option, the exported +image will display all the visible objects of the document without +margins or cropping. This is the default export area for EPS. For PNG, +it can be used in combination with L<--export-use-hints>. + +=item B<-a> I<x0:y0:x1:y1>, B<--export-area>=I<x0:y0:x1:y1> + +In PNG export, set the exported area of the document, specified in px +(1/96 in). The default is to export the entire document page. The point +(0,0) is the lower-left corner. + +=item B<--export-area-snap> + +For PNG export, snap the export area outwards to the nearest integer px +values. If you are using the default export resolution of +96 dpi and your graphics are pixel-snapped to minimize antialiasing, +this switch allows you to preserve this alignment even if you are +exporting some object's bounding box (with L<--export-id> +or L<--export-area-drawing>) which is itself not pixel-aligned. + +=item B<-d> I<DPI>, B<--export-dpi>=I<DPI> + +The resolution used for PNG export. It is also used for fallback +rasterization of filtered objects when exporting to PS, EPS, or PDF +(unless you specify L<--export-ignore-filters> to suppress +rasterization). The default is 96 dpi, which corresponds to 1 SVG user +unit (px, also called "user unit") exporting to 1 bitmap pixel. This +value overrides the DPI hint if used with L<--export-use-hints>. + +=item B<-w> I<WIDTH>, B<--export-width>=I<WIDTH> + +The width of generated bitmap in pixels. This value overrides +the L<--export-dpi> setting (or the DPI hint if used +with L<--export-use-hints>). + +=item B<-h> I<HEIGHT>, B<--export-height>=I<HEIGHT> + +The height of generated bitmap in pixels. This value overrides the +L<--export-dpi> setting (or the DPI hint if used with L<--export-use-hints>). + +=item B<--export-margin>=I<MARGIN> + +Adds a margin around the exported area. The size of the margin is +specified in units of page size (for SVG) or millimeters (for PS/PDF). +The option currently has no effect for other export formats. + +=item B<-i> I<ID>, B<--export-id>=I<OBJECT-ID[;OBJECT-ID]*> + +For PNG, PS, EPS, PDF and plain SVG export, the id attribute value of +the object(s) that you want to export from the document; all other objects +are not exported. By default the exported area is the bounding box of +the object; you can override this using L<--export-area> (PNG only) +or L<--export-area-page>. + +If you specify many values with a semicolon separated list of objects, +each one will be exported separately. In this case the exported files will +be named this way: [input_filename]_[ID].[export_type] + +=item B<-j>, B<--export-id-only> + +For PNG, PS, EPS, PDF and plain SVG export, only export the object whose id is given in +L<--export-id>. All other objects are hidden and won't show in export +even if they overlay the exported object. Without L<--export-id>, this +option is ignored. + +=item B<-l>, B<--export-plain-svg> + +Export document(s) to plain SVG format, without sodipodi: or inkscape: +namespaces and without RDF metadata. Use the L<--export-filename> option +to specify the filename. + +=item B<--export-png-color-mode>=I<COLORMODE> + +Sets the color mode (bit depth and color type) for exported bitmaps (Gray_1/Gray_2/Gray_4/Gray_8/Gray_16/RGB_8/RGB_16/GrayAlpha_8/GrayAlpha_16/RGBA_8/RGBA_16) + +=item B<--export-png-use-dithering>=I<false|true> + +Forces dithering or disables it (the Inkscape build must support dithering for this). + +=item B<--export-ps-level>=I<LEVEL> + +Set language version for PS and EPS export. PostScript level 2 or 3 is supported. Default is 3. + +=item B<--export-pdf-version>=I<VERSION> + +Select the PDF version of the exported PDF file. This option basically +exposes the PDF version selector found in the PDF-export dialog of the +GUI. You must provide one of the versions from that combo-box, +e.g. "1.4". The default pdf export version is "1.4". + +=item B<-T>, B<--export-text-to-path> + +Convert text objects to paths on export, where applicable (for PS, EPS, +PDF and SVG export). + +=item B<--export-latex> + +(for PS, EPS, and PDF export) Used for creating images for LaTeX +documents, where the image's text is typeset by LaTeX. When exporting +to PDF/PS/EPS format, this option splits the output into a PDF/PS/EPS +file (e.g. as specified by --export-type) and a LaTeX file. Text will not +be output in the PDF/PS/EPS file, but instead will appear in the LaTeX +file. This LaTeX file includes the PDF/PS/EPS. Inputting +(\input{image.tex}) the LaTeX file in your LaTeX document will show the +image and all text will be typeset by LaTeX. See the resulting LaTeX +file for more information. Also see GNUPlot's `epslatex' output +terminal. + +=item B<--export-ignore-filters> + +Export filtered objects (e.g. those with blur) as vectors, ignoring the +filters (for PS, EPS, and PDF export). By default, all filtered objects +are rasterized at L<--export-dpi> (default 96 dpi), preserving the +appearance. + +=item B<-t>, B<--export-use-hints> + +While exporting to PNG, use export filename and DPI hints stored in the exported object (only +with L<--export-id>). These hints are set automatically when you export +selection from within Inkscape. So, for example, if you export a shape +with id="path231" as /home/me/shape.png at 300 dpi from document.svg +using Inkscape GUI, and save the document, then later you will be able +to reexport that shape to the same file with the same resolution simply +with + + inkscape -i path231 -t document.svg + +If you use L<--export-dpi>, L<--export-width>, or L<--export-height> +with this option, then the DPI hint will be ignored and the value from +the command line will be used. If you use L<--export-filename> with this +option, then the filename hint will be ignored and the filename from the +command line will be used. + +=item B<-b> I<COLOR>, B<--export-background>=I<COLOR> + +Background color of exported PNG. This may be any SVG supported color +string, for example "#ff007f" or "rgb(255, 0, 128)". If not set, then +the page color set in Inkscape in the Document Properties dialog will be +used (stored in the pagecolor= attribute of sodipodi:namedview). + + +=item B<-y> I<VALUE>, B<--export-background-opacity>=I<VALUE> + +Opacity of the background of exported PNG. This may be a value either +between 0.0 and 1.0 (0.0 meaning full transparency, 1.0 full opacity) or +greater than 1 up to 255 (255 meaning full opacity). If not set and +the -b option is not used, then the page opacity set in Inkscape in the +Document Properties dialog will be used (stored in the +inkscape:pageopacity= attribute of sodipodi:namedview). If not set but +the -b option is used, then the value of 255 (full opacity) will be +used. + +=item B<-I>, B<--query-id>=I<OBJECT-ID[,OBJECT-ID]*> + +Set the ID(s) of the object(s) whose dimensions are queried in a +comma-separated list. If not set, query options will return the +dimensions of the drawing (i.e. all document objects), not the page or +viewbox. + +If you specify many values with a comma separated list of objects, any +geometry query (e.g. L<--query-x>) will return a comma separated list +of values corresponding to the list of objects in I<--query-id>. + +=item B<-S>, B<--query-all> + +Prints a comma delimited listing of all objects in the SVG document with +IDs defined, along with their x, y, width, and height values. + +=item B<-X>, B<--query-x> + +Query the X coordinate of the drawing or, if specified, of the object +with L<--query-id>. The returned value is in px (SVG user units). + +=item B<-Y>, B<--query-y> + +Query the Y coordinate of the drawing or, if specified, of the object +with L<--query-id>. The returned value is in px (SVG user units). + +=item B<-W>, B<--query-width> + +Query the width of the drawing or, if specified, of the object with +L<--query-id>. The returned value is in px (SVG user units). + +=item B<-H>, B<--query-height> + +Query the height of the drawing or, if specified, of the object +with L<--query-id>. The returned value is in px (SVG user units). + +=item B<--vacuum-defs> + +Remove all unused items from the C<E<lt>defsE<gt>> section of the SVG file. +If this option is invoked in conjunction with L<--export-plain-svg>, +only the exported file will be affected. If it is used alone, the +specified file will be modified in place. + +=item B<--select>=I<OBJECT-ID[,OBJECT-ID]*> + +The L<--select> command will cause objects that have the ID specified to be +selected. You can select many objects width a comma separated list. This +allows various verbs to act upon them. To remove all the selections use +C<--verb=EditDeselect>. The object IDs available are dependent on the +document specified to load. + +=item B<--actions>=I<ACTION(:ARG)[;ACTION(:ARG)]*> + +Actions are a new method to call functions with an optional single parameter. +To get a list of the action IDs available, use the L<--action-list> command line option. +Eventually all verbs will be replaced by actions. Temporarily, any verb can be +used as an action (without a parameter). Note, most verbs require a GUI (even +if they don't use it). To close the GUI automatically at the end of processing, +use L<--batch-process>. In addition all export options have matching actions +(remove the '--' in front of the option and replace '=' with ':'). + +If only actions are used L<--batch-process> must be used. + +Export can be forced at any point with the export-do action. This allows one to do +multiple exports on a single file. + +=item B<--action-list> + +Prints a list of all available actions. + +=item B<--actions-file>=I<FILENAME> + +Execute all actions listed in the file. The file contents must be formatted using the +syntax of L<--actions>. This option overrides the L<--actions> argument when both are given. + +=item B<-g>, B<--with-gui> + +Try to use the GUI (on Unix, use the X server even if $DISPLAY is not +set). + +=item B<-q>, B<--active-window> + +Instead of launching a new Inkscape process, this will run the command in the most recently focused Inkscape document. + +=item B<--display>=I<DISPLAY> + +Sets the X display to use for the Inkscape window. + +=item B<--app-id-tag>=I<TAG> + +Creates a unique instance of Inkscape with the application ID 'org.inkscape.Inkscape.TAG'. +This is useful to separate the Inkscape instances when running different Inkscape versions +or using different preferences files concurrently. + +=item B<--batch-process> + +Close GUI after executing all actions or verbs. + +=item B<--shell> + +With this parameter, Inkscape will enter an interactive command line +shell mode. In this mode, you type in commands at the prompt and +Inkscape executes them, without you having to run a new copy of Inkscape +for each command. This feature is mostly useful for scripting and server +uses: it adds no new capabilities but allows you to improve the speed +and memory requirements of any script that repeatedly calls Inkscape to +perform command line tasks (such as export or conversions). + +In shell mode Inkscape expects a sequence of actions (or verbs) as input. +They will be processed line by line, that means typically when pressing enter. +It is possible (but not necessary) to put all actions on a single line. + +This option can be combined with the L<--active-window> parameter, to execute the +shell commands in an already opened Inkscape document. + +The following example opens a file and exports it into two different formats, +then opens another file and exports a single object: + + file-open:file1.svg; export-type:pdf; export-do; export-type:png; export-do + file-open:file2.svg; export-id:rect2; export-id-only; export-filename:rect_only.svg; export-do + +=back + +=head1 CONFIGURATION + +The main configuration file is located in +~/.config/inkscape/preferences.xml; it stores a variety of customization +settings that you can change in Inkscape (mostly in the Inkscape +Preferences dialog). Also in the subdirectories there, you can place +your own: + +B<$HOME>/.config/inkscape/extensions/ - extensions. + +B<$HOME>/.config/inkscape/fonts/ - fonts. + +B<$HOME>/.config/inkscape/icons/ - icon sets. + +B<$HOME>/.config/inkscape/keys/ - keyboard maps. + +B<$HOME>/.config/inkscape/paint/ - patterns and hatches. + +B<$HOME>/.config/inkscape/palettes/ - palettes. + +B<$HOME>/.config/inkscape/symbols/ - symbol files. + +B<$HOME>/.config/inkscape/templates/ - new file templates. + +B<$HOME>/.config/inkscape/ui/ - user interface files. + +=head1 DIAGNOSTICS + +The program returns zero on success or non-zero on failure. + +A variety of error messages and warnings may be printed to STDERR or +STDOUT. If the program behaves erratically with a particular SVG file +or crashes, it is useful to look at this output for clues. + +=head1 EXAMPLES + +While obviously B<Inkscape> is primarily intended as a GUI application, +it can be used for doing SVG processing on the command line as well. + +Open an SVG file in the GUI: + + inkscape filename.svg + +Export an SVG file into PNG with the default resolution of 96 dpi (one +SVG user unit translates to one bitmap pixel): + + inkscape --export-filename=filename.png filename.svg + +Same, but force the PNG file to be 600x400 pixels: + + inkscape --export-filename=filename.png -w 600 -h 400 filename.svg + +Same, but export the drawing (bounding box of all objects), not the +page: + + inkscape --export-filename=filename.png --export-area-drawing filename.svg + +Export two different files into four distinct file formats each: + + inkscape --export-type=png,ps,eps,pdf filename1.svg filename2.svg + +Export to PNG the object with id="text1555", using the output filename +and the resolution that were used for that object last time when it was +exported from the GUI: + + inkscape --export-id=text1555 --export-use-hints filename.svg + +Same, but use the default 96 dpi resolution, specify the filename, and +snap the exported area outwards to the nearest whole SVG user unit +values (to preserve pixel-alignment of objects and thus minimize +aliasing): + + inkscape --export-id=text1555 --export-filename=text.png --export-area-snap filename.svg + +Convert an Inkscape SVG document to plain SVG: + + inkscape --export-plain-svg --export-filename=filename2.svg filename1.svg + +Convert an SVG document to EPS, converting all texts to paths: + + inkscape --export-filename=filename.eps --export-text-to-path filename.svg + +Query the width of the object with id="text1555": + + inkscape --query-width --query-id=text1555 filename.svg + +Duplicate the objects with id="path1555" and id="rect835", rotate the duplicates 90 +degrees, save SVG, and quit: + + inkscape --select=path1555,rect835 --actions="duplicate;object-rotate-90-cw" --export-overwrite filename.svg + +Select all objects with ellipse tag, rotate them 30 degrees, save the file, and quit. + + inkscape --actions="select-by-element:ellipse;transform-rotate:30" --export-overwrite filename.svg + +Export the object with the ID MyTriangle with a semi transparent purple background +to the file triangle_purple.png and with a red background to the file triangle_red.png. + + inkscape --actions="export-id:MyTriangle; export-id-only; export-background:purple; export-background-opacity:0.5;export-filename:triangle_purple.png; export-do; export-background:red; export-background-opacity:1; export-filename:triangle_red.png; export-do" filename.svg + +Read an SVG from standard input (stdin) and export it to PDF format: + + cat filename.svg | inkscape --pipe --export-filename=filename.pdf + +Export an SVG to PNG format and write it to standard output (stdout), then convert it +to JPG format with ImageMagick's convert program: + + inkscape --export-type=png --export-filename=- filename.svg | convert - filename.jpg + +Same as above, but also reading from a pipe (--export-filename can be omitted in this case) + + cat filename.svg | inkscape --pipe --export-type=png | convert - filename.jpg + +=head1 ENVIRONMENT VARIABLES + +=over 8 + +=item B<INKSCAPE_PROFILE_DIR> + +Set a custom location for the user profile directory. + +=item B<INKSCAPE_DATADIR> + +Set a custom location for the Inkscape data directory (e.g. B<$PREFIX>/share +if Inkscape's shared files are in B<$PREFIX>/share/inkscape). + +=item B<INKSCAPE_LOCALEDIR> + +Set a custom location for the translation catalog. + +=back + +For more details see also +L<http://wiki.inkscape.org/wiki/index.php/Environment_variables> + +=head1 OTHER INFO + +The canonical place to find B<Inkscape> info is at +L<https://www.inkscape.org/>. The website has news, documentation, +tutorials, examples, mailing list archives, the latest released version +of the program, bugs and feature requests databases, forums, and more. + +=head1 SEE ALSO + +L<potrace>, L<cairo>, L<rsvg>, L<batik>, L<ghostscript>, L<pstoedit>. + +SVG compliance test suite: +L<https://www.w3.org/Graphics/SVG/WG/wiki/Test_Suite_Overview> + +SVG validator: +L<https://validator.w3.org/> + +I<Scalable Vector Graphics (SVG) 1.1 Specification> +I<W3C Recommendation 16 August 2011> +L<https://www.w3.org/TR/SVG11/> + +I<Scalable Vector Graphics (SVG) 1.2 Specification> +I<W3C Working Draft 13 April 2005> +L<https://www.w3.org/TR/SVG12/> + +I<Scalable Vector Graphics (SVG) 2 Specification> +I<W3C Candidate Recommendation 15 September 2016> +L<https://www.w3.org/TR/SVG2/> + +I<Document Object Model (DOM): Level 2 Core> +I<W3C Recommendation 13 November 2000> +L<https://www.w3.org/TR/DOM-Level-2-Core/> + + +=head1 GUI NOTES + +To learn Inkscape's GUI operation, read the manual in Help > Inkscape +manual, and the tutorials in Help > Tutorials. + +Apart from SVG, Inkscape can import (File > Import) most bitmap formats +(PNG, BMP, JPG, XPM, GIF, etc.), plain text (requires Perl), PS and EPS +(requires Ghostscript), PDF and AI format (AI version 9.0 or newer). + +Inkscape exports 32-bit PNG images (File > Export PNG Image) as well as +AI, PS, EPS, PDF, DXF, and several other formats via File > Save as. + +Inkscape can use the pressure and tilt of a graphic tablet pen for +width, angle, and force of action of several tools, including the +Calligraphic pen. + +Inkscape includes a GUI front-end to the Potrace bitmap tracing engine +(L<http://potrace.sf.net>) which is embedded into Inkscape. + +Inkscape can use external scripts (stdin-to-stdout filters) that are +represented by commands in the Extensions menu. A script can have a GUI +dialog for setting various parameters and can get the IDs of the +selected objects on which to act via the command line. Inkscape comes +with an assortment of effects written in Python. + +=head1 KEYBINDINGS + +To get a complete list of keyboard and mouse shortcuts, view +doc/keys.html, or use the Keys and Mouse command in Help menu. + +=head1 BUGS + +Many bugs are known; please refer to the website +(L<https://www.inkscape.org/>) for reviewing the reported ones and to +report newly found issues. See also the Known Issues section in the +Release Notes for your version (file `NEWS'). + +=head1 HISTORY + +The codebase that would become Inkscape began life in 1999 as the +program Gill, the GNOME Illustrator application, created by Raph Levien. +The stated objective for Gill was to eventually support all of SVG. +Raph implemented the PostScript bezier imaging model, including stroking +and filling, line cap style, line join style, text, etc. Raph's Gill +page is at L<http://www.levien.com/svg/>. Work on Gill appears to have +slowed or ceased in 2000. + +The next incarnation of the codebase was to become the highly popular +program Sodipodi, led by Lauris Kaplinski. The codebase was turned into +a powerful illustration program over the course of several year's work, +adding several new features, multi-lingual support, porting to Windows +and other operating systems, and eliminating dependencies. + +Inkscape was formed in 2003 by four active Sodipodi developers, Bryce +Harrington, MenTaLguY, Nathan Hurst, and Ted Gould, wanting to take a +different direction with the codebase in terms of focus on SVG +compliance, interface look-and-feel, and a desire to open development +opportunities to more participants. The project progressed rapidly, +gaining a number of very active contributors and features. + +Much work in the early days of the project focused on code stabilization +and internationalization. The original renderer inherited from Sodipodi +was laced with a number of mathematical corner cases which led to +unexpected crashes when the program was pushed beyond routine uses; this +renderer was replaced with Livarot which, while not perfect either, was +significantly less error prone. The project also adopted a practice of +committing code frequently, and encouraging users to run developmental +snapshots of the program; this helped identify new bugs swiftly, and +ensure it was easy for users to verify the fixes. As a result, Inkscape +releases have generally earned a reputation for being robust and +reliable. + +Similarly, efforts were taken to internationalize and localize the +interface, which has helped the program gain contributors worldwide. + +Inkscape has had a beneficial impact on the visual attractiveness of +Open Source in general, by providing a tool for creating and sharing +icons, splash screens, website art, and so on. In a way, despite being +"just an drawing program", Inkscape has played an important role in +making Open Source more visually stimulating to larger audiences. + +=head1 AUTHORS + +This codebase owes its existence to a large number of contributors +throughout its various incarnations. The following list is certainly +incomplete, but serves to recognize the many shoulders on which this +application sits: + +${INKSCAPE_AUTHORS} + +=head1 COPYRIGHT AND LICENSE + +B<Copyright (C)> 1999-2023 by Authors. + +B<Inkscape> is free software; you can redistribute it and/or modify it +under the terms of the GPL version 2 or later. + + +=for comment +$Date$ diff --git a/man/inkscape.zh_TW.pod.in b/man/inkscape.zh_TW.pod.in new file mode 100644 index 0000000..cac22c6 --- /dev/null +++ b/man/inkscape.zh_TW.pod.in @@ -0,0 +1,651 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 名稱 + +Inkscape - SVG (Scalable Vector Graphics) 編輯程式。 + +=head1 概要 + +C<inkscape [選項] [檔名_1 檔名_2 ...]> + +選項: + + -?, --help + --help-all + --help-gapplication + --help-gtk + + -V, --version + --debug-info + --system-data-directory + --user-data-directory + + -p, --pipe + --pdf-page=頁數 + --pdf-poppler + --convert-dpi-method=方式 + --no-convert-text-baseline-spacing + + + -o, --export-filename=檔名 + --export-overwrite + --export-type=類型[,類型]* + --export-extension=擴充模組識別碼 + + + -C, --export-area-page + -D, --export-area-drawing + -a, --export-area=x0:y0:x1:y1 + --export-area-snap + -d, --export-dpi=DPI + -w, --export-width=寬度 + -h, --export-height=高度 + --export-margin=間距 + + + -i, --export-id=OBJECT-ID[;OBJECT-ID]* + -j, --export-id-only + -l, --export-plain-svg + --export-png-color-mode=COLORMODE + --export-png-use-dithering=BOOLEAN + --export-ps-level=LEVEL + --export-pdf-version=VERSION + -T, --export-text-to-path + --export-latex + --export-ignore-filters + -t, --export-use-hints + -b, --export-background=COLOR + -y, --export-background-opacity=VALUE + + -I, --query-id=物件識別碼[,物件識別碼]* + -S, --query-all + -X, --query-x + -Y, --query-y + -W, --query-width + -H, --query-height + + + --vacuum-defs + --select=OBJECT-ID[,OBJECT-ID]* + --actions=ACTION(:ARG)[;ACTION(:ARG)]* + --action-list + --actions-file=FILENAME + + -g, --with-gui + -q, --active-window + --display=DISPLAY + --app-id-tag=TAG + --batch-process + --shell + + + +=head1 描述 + +B<Inkscape> +是一款自由與開放原始碼的向量繪圖軟體。提供強大豐富的功能且能廣泛應用在藝術與技術用途插畫,諸如卡通、素材、圖標、設計原型、圖表和流程圖。使用向量圖形能構允許銳邊圖像輸出和無解析度限制的圖形繪算,而不會向點陣圖像有固定像素數量的限制。Inkscape +使用標準的 B<SVG> 檔案格式昨為主要格式,其他許多應用程式包括網頁瀏覽程式都支援此種格式。 + +使用者介面以簡單易用且能讓專業人士有效率創作的方向設計,保留 B<GNOME> 桌面標準的舒適性以確保使用者能以其他 GNOME +應用程式使用體驗快速學習操作方式。 + +B<SVG> 是 W3C 針對 2D 向量繪圖制定的標準 XML 格式。 SVG 可於圖畫中使用點、路徑和基本形狀來定義物件。 +顏色、字型、邊框寬度...等等可作為「樣式」屬性指定給這些物件。由於 SVG 的目標是成為標準格式,也因為 SVG +檔為純文字檔/xml,所以有相當多的程式可能使用 SVG 檔並有多種用途。 + +B<Inkscape> 使用 SVG 作為內定文件格式,並且以成為在開放原碼社群中完整相容 SVG 格式的繪圖程式為目標。 + + + +=head1 選項 + +=over 8 + +=item B<-?>, B<--help> + +顯示說明訊息。 + +=item B<--help-all> + +Shows all help options. + +=item B<--help-gapplication> + +Shows the GApplication options. + +=item B<--help-gtk> + +Shows the GTK+ options. + +=item B<-V>, B<--version> + +顯示 Inkscape 版本和編譯日期。 + +=item B<--debug-info> + +印出技術資訊包括 Inkscape 版本、相依套件版本和操作系統。此資訊在 Inkscape 除錯的時候非常有用且應該將資訊撰寫在程式錯誤 (bug) +回報中。 + +=item B<--system-data-directory> + +印出系統資料目錄即與 Inkscape 連動的資料檔案儲存位置。這包括執行 Inkscape 必須的檔案 (像單位定義、內建按鍵對應、檔案描述 UI +排版、圖示主題等等)、核心擴充模組、常備資源 (濾鏡、字型、記號、調色盤、符號、範本) 和文件 (SVG 範例檔案、指導手冊)。 + +Inkscape 預期的系統資料目錄位置可用 L<INKSCAPE_DATADIR> 環境變數覆蓋。 + +=item B<--user-data-directory> + +印出使用者設定檔的目錄即使用者指定的資料檔案和偏好設定的儲存位置。自訂擴充模組和資源 (濾鏡、字型、記號、調色版、符號、範本) +應該安裝到該目錄底下的各自子目錄中。另外將檔案以系統資料目錄中檔案的完全相同名稱儲存可覆蓋原本系統資料庫的大部分預先設定 (例如預設範本、UI +檔案等等)。 + +設定檔目錄的預設位置可用 L<INKSCAPE_PROFILE_DIR> 環境變數覆蓋。 + +=item B<-p>, B<--pipe> + +從標準輸入 (stdin) 讀取輸入檔案。 + +=item B<--pdf-page>=I<頁數> + +匯入 pdf 檔案給定的頁面。號碼從 1 開始。 + +=item B<--pdf-poppler> + +Inkscape 預設經由內部 (poppler-derived) 函數庫匯入 PDF 檔案。文字會以文字格式儲存。使用 +L<--pdf-poppler> 可改用外部 (使用 cairo 後端的 poppler) 函式庫匯入 PDF。文字組成包含複製的字 (glyphs) +而每個字 (glyphs) 都是路徑。影像儲存在檔案內部。網面會讓整份文件都以點陣圖形方式繪算。 + +=item B<--convert-dpi-method>=I<方式> + +選擇用於縮放舊版 (pre-0.92) 檔案的方式其繪算稍微較小,因為像素單位的內插長度從 90 DPI 切換為 96 +DPI。數值可以設定為「none」(不變更、文件繪算原始大小的 94%)、「scale-viewbox」(文建會整體縮放,而個別長度維持不變) +和「scale-document」(每個長度會個別重新縮放)。 + +=item B<--no-convert-text-baseline-spacing> + +開啟舊版 (pre-0.92) 檔案時不要自動修正文字基準線。Inkscape 0.92 的「line-height」性質採用 CSS +標準定義,這與之前的版本不同。預設文字列高度值以檔案內建立的數值優先而 Inkscape 0.92 +調整為載入時保留文字排版的傾向。此指令選項則會跳過調整動作。 + +=item B<-o>, B<--export-filename>=I<檔名> + +設定輸出檔案的名稱。預設會沿用輸入檔案的名稱。如果有使用 L<--export-type> 選項,那麼檔案副檔名要依照情形調整 +(或加入)。反之匯出的檔案會從指定檔名的副檔名自動選擇對應的檔案類型。 + +特殊檔名 "-" 的用法可讓 Inkscape 將影像資料寫入到標準輸出 (stdout)。 + +=item B<--export-overwrite> + +覆寫輸入檔案。 + +=item B<--export-type>=I<類型[,類型]*> + +指定要匯出的檔案格式。可能的格式:svg, png, ps, eps, pdf, emf, wmf +與每種現有匯出副檔名的檔案類型。也能夠一次匯出多種檔案類型。 + +注意 PostScript 格式不支援透明,所以原始 SVG 中的透明物件都會自動轉換成點陣圖。用到的字型會為子集合並嵌入。預設匯出範圍是頁面。你可以用 +L<--export-area-drawing> 將匯出範圍設定為繪圖。 + +備註 PDF 格式會保留原始 SVG 的透明度。 + +=item B<--export-extension>=I<擴充模組識別碼> + +允許匯出時使用的特定輸出擴充模組,尤其在給定檔案類型有多個匯出選項影響很大。如果設定,檔案副檔名會忽略 --export-filename 和 +--export-filename。另外,如果設定,只能用 --export-type 給定一種檔案類型。 + +=item B<-C>, B<--export-area-page> + +用 SVG、PNG、PDF、PS 和 EPS 格式匯出範圍為頁面。這是匯出 SVG、PNG、PDF 和 PS 的預設值,所以你不必指定此選項除非你使用 +L<--export-id> 來匯出指定的物件。目前 EPS 尚未支援此選項。 + +=item B<-D>, B<--export-area-drawing> + +匯出 SVG、PNG、PDF、PS 和 EPS 時,匯出範圍為繪畫部份 (不是畫布),即文件全部物件的外框邊界 (如果使用 --export -id +則是匯出物件的外框邊界)。 使用這個選項,匯出的圖片會顯示文件中所有的可見物件,而不會有頁邊空白或裁剪。 這是 EPS 預設的匯出範圍。對於 +PNG,這個可以和 L<--export-use-hints> 結合使用。 + +=item B<-a> I<x0:y0:x1:y1>, B<--export-area>=I<x0:y0:x1:y1> + +In PNG export, set the exported area of the document, specified in px (1/96 +in). The default is to export the entire document page. The point (0,0) is +the lower-left corner. + +=item B<--export-area-snap> + +For PNG export, snap the export area outwards to the nearest integer px +values. If you are using the default export resolution of 96 dpi and your +graphics are pixel-snapped to minimize antialiasing, this switch allows you +to preserve this alignment even if you are exporting some object's bounding +box (with L<--export-id> or L<--export-area-drawing>) which is itself not +pixel-aligned. + +=item B<-d> I<DPI>, B<--export-dpi>=I<DPI> + +匯出 PNG 所使用的解析度。 當匯出為 PS、EPS 或 PDF (除非你指定 L<--export-ignore-filters> 禁止點陣化) +時,也用於退回套用濾鏡 物件的點陣化過程。預設值為 96 dpi,其對應成 1 SVG 使用者單位 (px, 亦稱「使用者單位」) 匯出為 1 點 +陣圖像素。 如果和 L<--export-use-hints> 一起使用,這個數值會覆蓋 DPI 內定值。 + +=item B<-w> I<寬度>, B<--export-width>=I<寬度> + +匯出點陣圖的寬度,單位為像素。 這個數值會覆蓋 L<--export-dpi> 設定值 (如果和 --export-use-hints 同時使用則會覆蓋 +DPI 內定值)。 + +=item B<-h> I<高度>, B<--export-height>=I<高度> + +匯出點陣圖的高度,單位為像素。 這個數值會覆蓋 L<--export-dpi> 設定值 (如果和 --export-use-hints 同時使用,會覆蓋 +DPI 內定值)。 + +=item B<--export-margin>=I<間距> + +匯出區域的周圍加入間距。用頁面尺寸 (SVG) 或公釐 (PS/PDF) 的單位指定間距大小。此選項目前對於其他匯出格式沒有作用。 + +=item B<-i> I<ID>, B<--export-id>=I<物件識別碼[;物件識別碼]*> + +匯出 PNG、PS、EPS、PDF 和普通 SVG 時, 你想要從文件中匯出的物件的 ID +屬性值;其他剩下的物件都不會被匯出。預設情形下匯出的範圍是物件的外框邊界;你可用 --export-area (只適用於 PNG) 或 +L<--export-area-page> 覆蓋這項數值。 + +如果你用物件的分號分隔清單指定多個數值,每個會個別匯出。這裡匯出的檔案會用這種方式命名: +[input_filename]_[ID].[export_type] + +=item B<-j>, B<--export-id-only> + +For PNG, PS, EPS, PDF and plain SVG export, only export the object whose id +is given in L<--export-id>. All other objects are hidden and won't show in +export even if they overlay the exported object. Without L<--export-id>, +this option is ignored. + +=item B<-l>, B<--export-plain-svg> + +用普通 SVG 格式匯出文件,普通 SVG 格式沒有 sodipodi: 或 inkscape: 名稱集和 RDF 後設資料。使用 +L<--export-filename> 選項指定檔案名稱。 + +=item B<--export-png-color-mode>=I<COLORMODE> + +Sets the color mode (bit depth and color type) for exported bitmaps +(Gray_1/Gray_2/Gray_4/Gray_8/Gray_16/RGB_8/RGB_16/GrayAlpha_8/GrayAlpha_16/RGBA_8/RGBA_16) + +=item B<--export-png-use-dithering>=I<false|true> + +Forces dithering or disables it (the Inkscape build must support dithering +for this). + +=item B<--export-ps-level>=I<等級> + +設定 PS 和 EPS 匯出的語言版本。目前支援 PostScript 等級 2 或 3。預設版本為 3。 + +=item B<--export-pdf-version>=I<版本> + +選擇要匯出的 PDF 版本。此選項基本上會將 PDF 版本選擇器顯示在圖形介面的 PDF-export +對話窗上。你必須從下拉式選單中選擇一種版本,例如「1.4」。預設的 pdf 匯出版本是「1.4」。 + +=item B<-T>, B<--export-text-to-path> + +在適用情形下 (匯出 PS、EPS 和 PDF),匯出時將文字物件轉換成路徑。 + +=item B<--export-latex> + +用以建立 LaTeX 文件的圖片 (適用 PS、EPS 和 PDF 匯出) ,圖片的文字則由 LaTeX 排版。當匯出成 PDF/PS/EPS +格式時,此選項會將輸出分離成一個 PDF/PS/EPS 檔 (例如用 --export-type 指定) 和 LaTeX 檔。文字不會輸出到 +PDF/PS/EPS 檔案,但是會出現在 LaTeX 檔案。這個 LaTeX 檔案會包含 PDF/PS/EPS。輸入 +(\input{image.tex}) LaTeX 檔案到你的 LaTeX 文件會顯示圖片和全部由 LaTeX 排版的文字。查閱產生的 LaTeX +檔案可得知更多資訊。也請查看 GNUPlot 的「epslatex」輸出終端機。 + +=item B<--export-ignore-filters> + +將套用濾鏡的物件 (例如這些物件套用模糊) 匯出成向量屬性,忽略濾鏡 (匯出 PS、EPS 和PDF 時)。 在預設情況下,全部套用濾鏡的物件會以 +L<--export-dpi> (預設為 96 dpi) 的解析度轉成點陣圖以維持外觀。 + +=item B<-t>, B<--export-use-hints> + +匯出 PNG 時,使用儲存在匯出物件中的 DPI 內定值和匯出檔名 (只能和 L<--export-id> 一起使用)。 當你從 Inkscape +內部匯出選取範圍時會自動設定為這些內定值。 例如,你用 Inkscape 圖形介面從 document.svg 裡將 id="path231" 的形狀以 +300 dpi 匯出成 /home/me/shape.png ,並儲存文件,之後你便可簡單地用下面的指令以相同的解析度重新匯出相同的檔案 + + inkscape -i path231 -t 文件.svg + +如果你將這個選項和 L<--export-dpi>、L<--export-width> 或 L<--export-height> 一起使用,那麼 DPI +內定值會被忽略並使用命令列上的數值。 如果你將這個選項和 L<--export-filename> +一起使用,那麼檔名內定值會被忽略並使用命令列上的檔名。 + +=item B<-b> I<顏色>, B<--export-background>=I<顏色> + +匯出 PNG 的背景顏色。 這可以是任何 SVG 支援的顏色字串,例如 "#ff007f" 或 "rgb(255, 0, 128)"。 +如果沒有設定顏色,那麼就會使用在 Inkscape 文件選項對話窗所設定的頁面顏色 (儲存在 pagecolor= sodipodi:namedview +的屬性)。 + + + +=item B<-y> I<數值>, B<--export-background-opacity>=I<數值> + +匯出 PNG 背景的不透明度。 這個數值可以是 0.0 到 1.0 之間的數值 (0.0 表示完全透明,1.0 則完全不透明) 或是大於 1 到 255 +以內的數值 (255 代表完全不透明)。 若沒有設定數值且沒有使用 -b 選項,那麼就會使用在 Inkscape 文件選項對話窗所設定的頁面不透明度 +(儲存 在 inkscape:pageopacity= sodipodi:namedview 的屬性)。 如果沒有設定數值但有使用 -b +選項,那麼會使用 255 (完全不透明)。 + +=item B<-I>, B<--query-id>=I<物件識別碼[,物件識別碼]*> + +設定在逗號分隔清單中查詢尺寸的物件識別碼 (ID)。若沒設定,查詢選項會回傳繪圖尺寸 (即全部文件物件),而非頁面或檢視框。 + +如果你用逗號分隔清單指定多個數值,使用 I<--query-id> 任何幾何查詢 (例如 (e.g. L<--query-x>)) +會回傳對應物件清單的用逗號分隔的數值清單。 + +=item B<-S>, B<--query-all> + +列印一份 SVG 文件中已定義 ID 的所有物件以逗點分隔的清單,與 x、y、寬度和高度數值同樣。 + +=item B<-X>, B<--query-x> + +查詢繪圖部份的 X 坐標或用 L<--query-id> 所指定物件的 X 坐標。回傳值的單位是 px (SVG 使用者單位)。 + +=item B<-Y>, B<--query-y> + +查詢繪圖部份的 Y 坐標或用 L<--query-id> 所指定物件的 Y 坐標。回傳值的單位是 px (SVG 使用者單位)。 + +=item B<-W>, B<--query-width> + +查詢繪圖部份的寬度或用 L<--query-id> 所指定物件的寬度。回傳值的單位是 px (SVG 使用者單位)。 + +=item B<-H>, B<--query-height> + +查詢繪圖部份的高度或用 L<--query-id> 所指定物件的高度。回傳值的單位是 px (SVG 使用者單位)。 + +=item B<--vacuum-defs> + +從 SVG 檔案的 C<E<lt>defsE<gt>> 段落中移除所有未使用的項目。如果這個選項與 --export-plain-svg 一起調用, +只有匯出的檔案會有作用。如果單獨使用會適當地修飾所指定的檔案。 + +=item B<--select>=I<物件識別碼[,物件識別碼]*> + +而 L<--select> 指令會選取指定 ID 的物件。你可用逗號分隔的清單選擇多個物件。此選項允許對選取物件執行各種動詞。使用 +C<--verb=EditDeselect> 可移除所有選取的項目。可用的物件 ID 取決於文件指定載入哪些物件。 + +=item B<--actions>=I<動作(:參數)[;動作(:參數)]*> + +動作是呼叫帶有單一參數函數的新方式。使用 L<--action-list> 指令列選項取得可用的動作識別碼 (ID) 清單。之後動作會完全取代動詞 +(verb)。目前任何動詞都可作為動作 (無參數) 使用。需要注意一點,大部分動詞需要 GUI (即使動詞並不需要使用)。使用 +L<--batch-process> 會處理結束後會自動關閉 GUI。另外全部的匯出選項都有相符合的動作 (移除選項前面的 '--' 並用 ':' 取代 +'=')。 + +只在動作有用到 L<--batch-process> 時必須使用。 + +用 export-do 動作可在任何點執行匯出。這允許單個檔案執行多次匯出。 + +=item B<--action-list> + +印出可用動作的清單。 + +=item B<--actions-file>=I<FILENAME> + +Execute all actions listed in the file. The file contents must be formatted +using the syntax of L<--actions>. This option overrides the L<--actions> +argument when both are given. + +=item B<-g>, B<--with-gui> + +試著使用圖形介面 (在 Unix 系統,即使沒有設定 $DISPLAY 也會使用 X server)。 + +=item B<-q>, B<--active-window> + +Instead of launching a new Inkscape process, this will run the command in +the most recently focused Inkscape document. + +=item B<--display>=I<DISPLAY> + +Sets the X display to use for the Inkscape window. + +=item B<--app-id-tag>=I<TAG> + +Creates a unique instance of Inkscape with the application ID +'org.inkscape.Inkscape.TAG'. This is useful to separate the Inkscape +instances when running different Inkscape versions or using different +preferences files concurrently. + +=item B<--batch-process> + +執行全部動作或動詞後關閉 GUI。 + +=item B<--shell> + +使用此參數,Inkscape 會進入互動式命令列殼層 (shell) 模式。於此模式中,你在提示符位置上輸入指令讓 Inkscape +執行,而不需針對每一道指令執行新的 Inkscape。此功能對於腳本和伺服器方面的用途極為有用:這沒有加入任何新功能,但可讓任何多次呼叫 +Inkscape 執行命令列任務 (比如匯出或轉換) 腳本的速度更快、消耗更少的記憶體。 + +在殼層 (shell) 模式 Inkscape 會預期輸入一連串動作 (或動詞)。這些操作會逐行執行,表示模擬按 Enter +鍵的典型行為。可以將全部動作彙整到同一行 (但不一定是必須這樣)。 + +This option can be combined with the L<--active-window> parameter, to +execute the shell commands in an already opened Inkscape document. + +下面範例會開啟檔案並匯出為兩種不同格式,然後開啟其他檔案並匯出單一物件: + + file-open:file1.svg; export-type:pdf; export-do; export-type:png; export-do + file-open:file2.svg; export-id:rect2; export-id-only; export-filename:rect_only.svg; export-do + +=back + +=head1 組態設定 + +主要的組態設定檔放在 ~/.config/inkscape/preferences.xml; 組態設定檔儲存各種設定值,可在 Inkscape 中變更 +(大部份在 Inkscape 偏好設定對話窗)。也可以在那裡的子目錄中放置你自己的組態設定檔: + +B<$HOME>/.config/inkscape/extensions/ - extensions. + +B<$HOME>/.config/inkscape/fonts/ - fonts. + +B<$HOME>/.config/inkscape/icons/ - icon sets. + +B<$HOME>/.config/inkscape/keys/ - 鍵盤對應。 + +B<$HOME>/.config/inkscape/paint/ - patterns and hatches. + +B<$HOME>/.config/inkscape/palettes/ - palettes. + +B<$HOME>/.config/inkscape/symbols/ - symbol files. + +B<$HOME>/.config/inkscape/templates/ - 新增檔案的範本。 + +B<$HOME>/.config/inkscape/ui/ - user interface files. + +=head1 診斷 + +程式執行成功時會回傳零或者執行失敗時回傳不為零的值。 + +各種錯誤訊息和警告可列印到 STDERR 或 STDOUT。如果程式怪異地產生一個特殊的 SVG 檔案或不正常關閉,它是 查看這次輸出的有用線索。 + +=head1 範例 + +雖然 B<Inkscape> 很明顯地主要是作為一款圖形介面的應用程式,但同樣能在命令列上處理 SVG。 + +用圖形介面開啟一個 SVG 檔案: + + inkscape 檔名.svg + +將一個 SVG 檔以預設的解析度 96 dpi 匯出成 PNG (1 SVG 使用者單位轉變成 1 點陣圖像素): + + inkscape --export-filename=filename.png filename.svg + +相同,但強制 PNG 檔案為 600x400 像素: + + inkscape --export-filename=filename.png -w 600 -h 400 filename.svg + +相同,但匯出繪圖部份 (全部物件的外框邊界),不是頁面: + + inkscape --export-filename=filename.png --export-area-drawing filename.svg + +將兩個不同檔案分別匯出四種不同的檔案格式: + + inkscape --export-type=png,ps,eps,pdf filename1.svg filename2.svg + +將 id="text1555" 物件匯出成 PNG,當從圖形介面匯出時,使用輸出檔名和上次使用的解析度: + + inkscape --export-id=text1555 --export-use-hints filename.svg + +相同,但使用預設 96 dpi 解析度,指定檔名,並且向外捉取匯出範圍為最接近整個 SVG 使用者單位的值 (維持物件的像素校正,因此最小平滑化): + + inkscape --export-id=text1555 --export-filename=text.png --export-area-snap filename.svg + +將一個 Inkscape SVG 文件轉換成普通的 SVG: + + inkscape --export-plain-svg --export-filename=filename2.svg filename1.svg + +將 SVG 文件轉成 EPS,全部的文字轉換成路徑: + + inkscape --export-filename=filename.eps --export-text-to-path filename.svg + +查詢 id="text1555" 物件的寬度: + + inkscape --query-width --query-id=text1555 filename.svg + +再製 id="path1555" 和 id="rect835" 的物件,將再製物件旋轉 90 度後,儲存 SVG 並離開: + + inkscape --select=path1555,rect835 --actions="duplicate;object-rotate-90-cw" --export-overwrite filename.svg + +選取全部有橢圓標籤的物件,將物件旋轉 30 度後,儲存檔案並離開程式。 + + inkscape --actions="select-by-element:ellipse;transform-rotate:30" --export-overwrite filename.svg + +將 ID 為 MyTriangle 的物件以半透明紫色背景匯出為 triangle_purple.png 檔案並以紅色背景匯出到 +triangle_red.png 檔案。 + + inkscape --actions="export-id:MyTriangle; export-id-only; export-background:purple; export-background-opacity:0.5;export-filename:triangle_purple.png; export-do; export-background:red; export-background-opacity:1; export-filename:triangle_red.png; export-do" filename.svg + +從標準輸入 (stdin) 讀取 SVG 並匯出成 PDF 格式: + + cat filename.svg | inkscape --pipe --export-filename=filename.pdf + +將 SVG 匯出成 PNG 格式並寫入到標準輸出 (stdout),然後用 ImageMagick 轉換程式轉成 JPG 格式: + + inkscape --export-type=png --export-filename=- filename.svg | convert - filename.jpg + +與上面的相同,但差別在於從管線讀取 (這裡可以省略 --export-filename) + + cat filename.svg | inkscape --pipe --export-type=png | convert - filename.jpg + +=head1 環境變數 + +=over 8 + +=item B<INKSCAPE_PROFILE_DIR> + +設定使用者設定檔目錄的自訂位置。 + +=item B<INKSCAPE_DATADIR> + +設定 Inkscape 資料目錄的自訂位置 (例如 B<$PREFIX>/share 是否 Inkscape 的共用檔案在 +B<$PREFIX>/share/inkscape)。 + +=item B<INKSCAPE_LOCALEDIR> + +設定翻譯分類的自訂位置。 + +=back + +訪問此網址取得更多資訊 L<http://wiki.inkscape.org/wiki/index.php/Environment_variables> + +=head1 其他資訊 + +搜尋 B<Inkscape> 資訊的最佳地點是在 L<https://www.inkscape.org/>。 +網站上有新聞、說明文件、教學、範例、郵件論壇存檔、最新發佈的程式版本、程式錯誤和功能需求資料庫、論壇...等等。 + +=head1 參見 + +L<potrace>, L<cairo>, L<rsvg>, L<batik>, L<ghostscript>, L<pstoedit>. + +SVG 相容測試工具: L<https://www.w3.org/Graphics/SVG/WG/wiki/Test_Suite_Overview> + +SVG 驗證工具: L<https://validator.w3.org/> + +I<Scalable Vector Graphics (SVG) 1.1 規範> I<W3C 建議 (Recommendation) 2011 年 8 +月 16 日> L<https://www.w3.org/TR/SVG11/> + +I<Scalable Vector Graphics (SVG) 1.2 規範> I<W3C 工作起草 (Working Draft) 2005 年 4 +月 13 日> L<https://www.w3.org/TR/SVG12/> + +I<Scalable Vector Graphics (SVG) 2 規範> I<W3C 候補建議 (Candidate Recommendation) +2016 年 9 月 15 日> L<https://www.w3.org/TR/SVG2/> + +I<Document Object Model (DOM): 等級 2 核心> I<W3C 建議 (Recommendation) 2000 年 11 +月 13 日> L<https://www.w3.org/TR/DOM-Level-2-Core/> + + + +=head1 GUI 說明 + +請閱讀在 說明 > 指導手冊 和 說明 > Inkscape 使用手冊 的資料來學習 Inkscape 圖形介面的操作。 + +除了 SVG 外,Inkscape 可以匯入 (檔案 > 匯入) 多數的點陣圖格式 (PNG、BMP、JPG、XPM、GIF 等)、 普通純文字檔 +(需要 Perl)、PS 和 EPS (需要 Ghostscript)、PDF 和 AI 格式 (AI 版本 9.0 或更新)。 + +Inkscape 可匯出 32-位元 PNG 圖片 (檔案 > 匯出 PNG 圖片),也可從 檔案 > 另存 儲存成 AI、PS、EPS、PDF、 +DXF 及一些其他格式。 + +Inkscape 能用繪圖板畫筆的壓力及傾斜感應來變化寬度、角度和一些工具的作用力,包括美工筆。 + +Inkscape 包含一個嵌入的 Potrace 點陣圖描繪引擎 (L<http://potrace.sf.net>) 圖形介面前端。 + +Inkscape 能使用外部腳本 (stdin-to-stdout 過濾器),腳本會以擴充功能選單上的命令方式呈現。腳本可以 +有設定各種參數的圖形介面對話窗,而且能透過命令列取得所選物件的 ID。Inkscape 提供各式各樣用 Python 寫成的特效模組。 + +=head1 按鍵對應 + +查看 doc/keys.html 以取得鍵盤和滑鼠快捷鍵的完整清單,或在說明選單中使用按鍵和滑鼠指令。 + +=head1 程式錯誤 + +已經知道許多程式錯誤;請到網站 (L<https://www.inkscape.org/>) 檢閱已回報的錯誤並回報新發現的問題。也請看看你使用版 +本的發佈說明中已知問題段落內容 (檔案「NEWS」)。 + +=head1 歷史 + +後來變成 Inkscape 的程式碼庫始於 1999 年的程式 Gill (由 Raph Levien 建立的 GNOME 繪圖程式)。 Gill +的最終目標是支援全部的 SVG。Raph 實現了 PostScript 貝茲曲線成像模型,包括邊框和填充、線段 +端點樣式、線段接合樣式、文字...等等。Raph 的 Gill 網頁位於 L<http://www.levien.com/svg/>。Gill +的開發工作在 2000 年時似乎已經變慢或停止。 + +接下來這個程式碼庫化身為極受歡迎的程式 Sodipodi,由 Lauris Kaplinski 主導。經過數年的發展,這個 +程式碼庫已轉變為一個強大的繪圖程式,加入了一些新特性,支援多語言,移植到 Windows 和其他操作系統,並 淘汰某些相依套件。 + +於 2003 年時由四名活躍的 Sodipodi 開發人員 - Bryce Harrington、MenTaLguY、Nathan Hurst 和 +Ted Gould 成立 Inkscape 計劃,想要以專注於 SVG 相容、介面外觀風格和開放開發機會吸引更多參與 +者的觀點為程式碼庫帶來新的方向。此計劃進展迅速,獲得許多非常活躍的貢獻和功能。 + +計劃早期的許多工作專注於程式碼的穩定和國際化。從 Sodipodi 繼承的原始圖形輸出引擎摻入許多數學角,因而 +導致當程式超出正常使用範圍時會意外地不正常關閉;用 Livarot 取代原本的圖形輸出引擎,雖然不夠完美,但 +程式錯誤明顯地減少。此計劃也有經常收養提交的程式碼的做法,並鼓勵使用者去試用程式的開發版本快照;這有助 +於迅速發現新的程式錯誤,並且保證使用者能輕易地校驗修復狀況。因此,Inkscape 發佈的版本已經普遍贏得了穩健可靠的聲譽。 + +同樣的,努力走向國際化及介面本地化,這有助於此程式獲得世界各地的幫助與貢獻。 + +大致上來說,Inkscape 已經在開放原碼的視覺魅力上產生正面的影響,作為用來製作和分享圖示、啟動畫面、網站 +設計等的工具。從某一點來看,「這只是一個繪圖程式」,但 Inkscape 已經扮演一個重要的角色,使開放原始碼 帶給廣大愛好者更多的視覺饗宴。 + +=head1 作者 + +這個程式碼庫的存在要歸功於各個時期的許多貢獻者。下列的名單當然不完整,但用來正式向齊心致力於這個程式的 許多人致謝: + +${INKSCAPE_AUTHORS} + +=head1 著作權和許可證 + +B<Copyright (C)> 1999-2023 by Authors. + +B<Inkscape> is free software; you can redistribute it and/or modify it under +the terms of the GPL version 2 or later. + + + +=for comment $Date$ + diff --git a/man/inkview.de.pod.in b/man/inkview.de.pod.in new file mode 100644 index 0000000..3d73f11 --- /dev/null +++ b/man/inkview.de.pod.in @@ -0,0 +1,150 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NAME + +Inkview - ein SVG-Betrachter und Slideshow Programm. + +=head1 ÜBERSICHT + +C<inkview [Optionen] [Dateiname ...]> + +Optionen: + + -h, --help + -V, --version + + -f, --fullscreen + -r, --recursive + -t, --timer=NUMBER + -s, --scale=NUMBER + -p, --preload + +=head1 BESCHREIBUNG + +B<Inkview> ist ein Bildbetrachter für Dateien im B<"Scalable Vector +Graphics">-Format (SVG), der auch für Diashows und Präsentationen genutzt +werden kann. Ein oder mehrere B<DATEIEN> oder B<ORDNER> können auf der +Kommandozeile angegeben werden. Inkview zeigt die SVG-Dateien in der +angegebenen Reihenfolge an. Ordner werden durch eine Liste der enthaltenen +SVG-Dateien ersetzt. + +Inkview kann auch ohne Kommandozeilenoptionen aufgerufen werden. In diesem +Fall wird ein Dateiauswahldialog angezeigt, wodurch Dateien und Ordner in +einer grafischen Benutzeroberfläche ausgewählt werden können. + +=head1 OPTIONEN + +=over 8 + +=item B<-?>, B<--help> + +Hilfe anzeigen + +=item B<-V>, B<--version> + +Inkview-Version und Erstellungsdatum anzeigen (stimmt typischerweise mit der +Inkscape-Version überein). + +=item B<-f>, B<--fullscreen> + +Inkview im Vollbildmodus starten. + +=item B<-r>, B<--recursive> + +Durchsucht die angegebenen Ordnerpfade rekursiv nach SVG-Dateien. Es werden +dadurch alle SVG-Dateien in beliebigen Unterordnern des angegebenen +Ordnerpfads geöffnet. + +=item B<-t>, B<--timer=ZAHL> + +Alle ZAHL Sekunden zum nächsten Bild wechseln. + +=item B<-s>, B<--scale=ZAHL> + +Bild um den Faktor ZAHL skaliert anzeigen, anstatt die native Größe der +Datei zu nutzen. + +=item B<-p>, B<--preload> + +Lädt alle SVG-Dateien im Voraus. Inkview muss die Bilder zwar immer noch +rendern bevor sie angezeigt werden können, allerdings stellt diese Option +sicher, dass alle SVG-Dateien bereits vorberechnet und in den +Arbeitsspeicher geladen werden. Diese Option kann auch genutzt werden um +sicherzustellen, dass alle Dateien ordnungsgemäß geöffnet werden können, +ohne dazu manuell durch alle Dateien wechseln zu müssen. + +=back + +=head1 TASTATURBEFEHLE + +=over 8 + +=item * Nach links, Seite nach oben oder Rücktaste: voriges Bild anzeigen + +=item * Nach rechts, Seite nach unten oder Leertaste: nächstes Bild anzeigen + +=item * Nach oben oder Pos1: erstes Bild anzeigen + +=item * Nach unten oder Ende: letztes Bild anzeigen + +=back + +=over 8 + +=item * Eingabetaste: Kontrollfenster anzeigen + +=item * F11: Vollbildmodus umschalten + +=item * Escape oder Q: Beenden + +=back + +=head1 BEISPIELE + +Zwei SVG-Dateien zum Ansehen öffnen: + + inkview datei1.svg datei2.svg + +Alle SVG-Dareien im mit Inkscape ausgelieferten "examples" (Beispiele) +Ordner öffnen: + + inkview B<${CMAKE_INSTALL_PREFIX}/${SHARE_INSTALL}>/inkscape/examples + +Eine Vollbild Diashow starten, die automatisch alle 5 Sekunden zum nächsten +Bild wechselt: + + inkview --fullscreen --timer=5 [files/folders ...] + +=head1 SIEHE AUCH + +L<inkscape> + +L<http://www.inkscape.org/> + +=head1 AUTOREN + +Siehe L<inkscape(1)> + +=head1 URHEBERRECHT UND LIZENZ + +B<Copyright (C)> 1999-2023 liegt bei den Autoren. + +B<Inkscape> ist freie Software. Sie dürfen es zu den Bedingungen der GPL in +Version 3 oder höher weiterverbreiten und / oder verändern. + + + +=for comment $Date$ + diff --git a/man/inkview.es.pod.in b/man/inkview.es.pod.in new file mode 100644 index 0000000..38273ad --- /dev/null +++ b/man/inkview.es.pod.in @@ -0,0 +1,148 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NOMBRE + +Inkview - un visualizado SVG y programa de diaposiitivas. + +=head1 SINOPSIS + +C<inkview [opciones] [archivo ...]> + +opciones: + + -h, --help + -V, --version + + -f, --fullscreen + -r, --recursive + -t, --timer=NÚMERO + -s, --scale=NÚMERO + -p, --preload + +=head1 DESCRIPCIÓN + +B<Inkview> es un visualizador de B<Scalable Vector Graphics (SVG)> que +también se puede utilizar para presentaciones o diapositivas. Se pueden +indicar uno o más B<ARCHIVOS> o B<CARPETAS> en la línea de comandos. Inkview +mostrará todos los archivos SVG en el orden dado. Las carpetas se expandirán +en una lista de archivos SVG contenidos. + +También se puede lanzar Inkview sin parámetros en la línea de comandos, lo +que mostrará un selector de archivos que permite seleccionar archivos y +carpetas a través de una interfaz gráfica de usuario. + +=head1 OPCIONES + +=over 8 + +=item B<-?>, B<--help> + +Mostrar opciones de ayuda + +=item B<-V>, B<--version> + +Imprime la versión y fecha de compilación de Inkscape (normalmente coincide +con la versión de Inkscape). + +=item B<-f>, B<--fullscreen> + +Lanza Inkview en modo pantalla completa. + +=item B<-r>, B<--recursive> + +Busca archivos SVG de forma recursiva en las carpetas indicadas en la línea +de comandos. Esto significa que se abrirán todos los archivos SVG en todas +las subcarpetas de la carpeta indicada. + +=item B<-t>, B<--timer=NÚMERO> + +Cambia a la siguiente imagen cada NÚMERO segundos + +=item B<-s>, B<--scale=NÚMERO> + +Muestra la imagen escalada por un factor de NÚMERO en lugar de utilizar el +tamaño natural del archivo. + +=item B<-p>, B<--preload> + +Precarga todos los archivos SVG. Inkview necesita renderizar imágenes en el +momento de mostrarlas, esta opción asegura que todos los archivos SVG estén +listos y cargados en memoria. Esta opción también se puede utilizar para +comprobar que todos los archivos se pueden abrir correctamente, sin tener +que hacerlo de forma manual. + +=back + +=head1 COMBINACIONES DE TECLADO + +=over 8 + +=item * Izquierda, RePág o Retroceso: muestra la imagen anterior + +=item * Derecha, AvPág o Espacio: muestra la siguiente imagen + +=item * Arriba o Inicio: a la primera imagen + +=item * Abajo o Fin: al a última imagen + +=back + +=over 8 + +=item * Intro: muestra la ventana de control + +=item * F11: conmuta el modo de pantalla completa + +=item * Escape o Q: terminar + +=back + +=head1 EJEMPLOS + +Abrir dos archivos SVG para visualizar: + + inkview documento1.svg documento2.svg + +Abrir todos los archivos SVG en la carpeta de ejemplos distribuidos con +Inkscape: + + inkview B<${CMAKE_INSTALL_PREFIX}/${SHARE_INSTALL}>/inkscape/examples + +Lanza una serie de diapositivas que cambia automáticamente a la siguiente +imagen cada 5 segundos: + + inkview --fullscreen --timer=5 [archivos/carpetas ...] + +=head1 VEA TAMBIÉN + +L<inkscape> + +L<http://www.inkscape.org/> + +=head1 AUTORES + +Véase L<inkscape(1)> + +=head1 DERECHOS DE AUTOR Y LICENCIA + +B<Copyright (C)> 1999-2023 by Authors. + +B<Inkscape> es software libre, lo puede redistribuir y/o modificarlo bajo +los términos de la GPL versión 3 o posterior. + + + +=for comment $Date$ + diff --git a/man/inkview.fr.pod.in b/man/inkview.fr.pod.in new file mode 100644 index 0000000..da66d21 --- /dev/null +++ b/man/inkview.fr.pod.in @@ -0,0 +1,148 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NOM + +Inkview - une visionneuse SVG et une application de diaporama. + +=head1 SYNOPSIS + +C<inkview [options] [fichier ...]> + +S<options :> + + -h, --help + -V, --version + + -f, --fullscreen + -r, --recursive + -t, --timer=N + -s, --scale=N + -p, --preload + +=head1 DESCRIPTION + +B<Inkview> est une visionneuse B<SVG (Scalable Vector Graphics)> pouvant +être utilisée pour des diaporamas ou des présentations. Un ou plusieurs +B<FICHIERS> ou B<DOSSIERS> peuvent être ouverts s'ils sont spécifiés en +ligne de commande. Tous les fichiers SVG seront affichés dans le même +ordre. Les dossiers seront eux convertis en une liste de fichiers SVG. + +Vous pouvez aussi lancer Inkview sans options en ligne de commande, ce qui +fera apparaître un sélecteur de fichiers permettant de choisir des fichiers +et des dossiers avec une interface graphique. + +=head1 OPTIONS + +=over 8 + +=item B<-?>, B<--help> + +Affiche les options de l'aide + +=item B<-V>, B<--version> + +Affiche la version d'Inkview et la date de compilation (correspond en +général à la version d'Inkscape). + +=item B<-f>, B<--fullscreen> + +Démarre Inkview en mode plein écran. + +=item B<-r>, B<--recursive> + +Recherche les fichiers SVG de façon récursive dans les dossiers spécifiés en +ligne de commande. Autrement dit, en partant des dossiers spécifiés, tous +les fichiers SVG de tous les sous-dossiers seront ouverts. + +=item B<-t>, B<--timer=N> + +Passe à l'image suivante toutes les N secondes + +=item B<-s>, B<--scale=N> + +Affiche une image redimensionnée d'un facteur N au lieu de la taille +spécifiée dans le fichier. + +=item B<-p>, B<--preload> + +Précharge tous les fichiers SVG. Inkview aura toujours besoin d'effectuer le +rendu des images à l'affichage, mais cette option garantit que tous les +fichiers SVG sont correctement lus et chargés en mémoire. Cette option peut +aussi servir à vérifier que tous les fichiers peuvent être ouverts +correctement sans avoir à les parcourir manuellement. + +=back + +=head1 RACCOURCIS CLAVIER + +=over 8 + +=item * Gauche, Page Sup. ou Retour arrière : affiche l'image précédente + +=item * Droite, Page Inf. ou Espace : affiche l'image suivante + +=item * Haut ou Début : aller à la première image + +=item * Bas ou Fin : aller à la dernière image + +=back + +=over 8 + +=item * Entrée : afficher la fenêtre de contrôle + +=item * F11 : alterner avec le mode plein écran + +=item * Échap ou Q : quitter + +=back + +=head1 EXEMPLES + +Ouvrir deux fichiers SVG pour S<visualisation :> + + inkview fichier1.svg fichier2.svg + +Ouvrir tous les fichiers SVG dans le dossier d'exemples fourni avec Inkscape +: + + inkview B<${CMAKE_INSTALL_PREFIX}/${SHARE_INSTALL}>/inkscape/examples + +Démarrer un diaporama en plein écran qui passe automatiquement à l'image +suivante toutes les 5 secondes : + + inkview --fullscreen --timer=5 [fichiers/dossiers ...] + +=head1 VOIR AUSSI + +L<inkscape> + +L<http://www.inkscape.org/> + +=head1 AUTEURS + +Voir L<inkscape(1)> + +=head1 COPYRIGHT ET LICENCE + +B<Copyright (C)> 1999-2023 par les auteurs. + +B<Inkscape> est un logiciel S<libre ;> vous pouvez le redistribuer et/ou le +modifier selon les termes de la licence GPL version 3 ou ultérieure. + + + +=for comment $Date$ + diff --git a/man/inkview.hr.pod.in b/man/inkview.hr.pod.in new file mode 100644 index 0000000..3ef7167 --- /dev/null +++ b/man/inkview.hr.pod.in @@ -0,0 +1,146 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 IME + +Inkview – program za prikaz SVG-a i prezentacija. + +=head1 SAŽETAK + +C<inkview [opcije] [datoteka …]> + +opcije: + + -h, --help + -V, --version + + -f, --fullscreen + -r, --recursive + -t, --timer=BROJ + -s, --scale=BROJ + -p, --preload + +=head1 OPIS + +B<Inkview> je preglednik B<skalabilnih vektorskih grafika (SVG)> koji se +također može koristiti za prikaz slajdova ili prezentacije. Jedna ili više +B<DATOTEKA> ili B<MAPA> se u naredbenom retku mogu odrediti za +otvaranje. Inkview će prikazati sve SVG datoteke navedenim +redoslijedom. Mape će se proširiti u popis sadržanih SVG datoteka. + +Inkview možeš pokrenuti i bez ikakvih argumenata naredbenog retka, što će +prikazati alat za odabir datoteka, koji omogućava odabir datoteka i mapa +putem grafičkog korisničkog sučelja. + +=head1 OPCIJE + +=over 8 + +=item B<-?>, B<--help> + +Prikaži opcije za pomoć + +=item B<-V>, B<--version> + +Ispiši Inkview verziju i datum gradnje (obično se podudara s Inkscape +verzijom). + +=item B<-f>, B<--fullscreen> + +Pokreni Inkview u prikazu preko cijelog ekrana. + +=item B<-r>, B<--recursive> + +Pretraži mape određene u naredbenom retku, rekurzivno za SVG datoteke. To +znači da će se otvoriti sve SVG datoteke u svim mapama određene mape. + +=item B<-t>, B<--timer=BROJ> + +Prijeđi na sljedeću sliku svakih BROJ sekundi + +=item B<-s>, B<--scale=BROJ> + +Prikaži sliku skaliranu faktorom koji je određen BROJEM, umjesto izvorne +veličine datoteke. + +=item B<-p>, B<--preload> + +Unaprijed učitava sve SVG datoteke. Inkview i dalje mora iscrtati slike +prilikom prikazivanja, no ova opcija osigurava, da su sve SVG datoteke već +obrađene i učitane u memoriju. Ova se opcija može koristiti i za provjeru, +da li se sve datoteke mogu pravilno otvoriti, bez potrebe za ručnim +pregledavanjem svih datoteka. + +=back + +=head1 TIPKOVNE FUNKCIJE + +=over 8 + +=item * Lijevo, stranica gore ili Backspace: prikaži prethodnu sliku + +=item * Desno, stranica dolje ili razmaknica: prikaži sljedeću sliku + +=item * Gore ili Home: prijeđi na prvu sliku + +=item * Dolje ili End: prijeđi na zadnju sliku + +=back + +=over 8 + +=item * Return: prikaži prozor s kontrolama + +=item * F11: uključi/isključi prikaz preko cijelog ekrana + +=item * Escape ili Q: zatvori program + +=back + +=head1 PRIMJERI + +Otvori dvije SVG datoteke za prikaz: + + inkview datoteka1.svg datoteka2.svg + +Otvori sve SVG datoteke u mapi primjera, isporučene s Inkscapeom: + + inkview B<${CMAKE_INSTALL_PREFIX}/${SHARE_INSTALL}>/inkscape/examples + +Pokreni prezentaciju preko cijelog ekrana, koja automatski mijenja slike +svakih 5 sekundi: + + inkview --fullscreen --timer=5 [datoteke/mape …] + +=head1 POGLEDAJ TAKOĐER + +L<inkscape> + +L<http://www.inkscape.org/> + +=head1 AUTORI + +Pogledaj L<inkscape(1)> + +=head1 AUTORSKA PRAVA I LICENCA + +B<Copyright (C)> 1999-2023 by Authors. + +B<Inkscape> je slobodan softver. Redistribucija i/ili promjena programa je +moguća pod uslovima, zadanima općom javnom licencom verzije 3 ili novijom. + + + +=for komentar $Date$ + diff --git a/man/inkview.hu.pod.in b/man/inkview.hu.pod.in new file mode 100644 index 0000000..1ce67ef --- /dev/null +++ b/man/inkview.hu.pod.in @@ -0,0 +1,147 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NÉV + +Inkview – SVG fájlmegjelenítő és diavetítő + +=head1 ÁTTEKINTÉS + +C<inkview [kapcsolók] [fájlnév ...]> + +kapcsolók: + + -h, --help + -V, --version + + -f, --fullscreen + -r, --recursive + -t, --timer=SZÁM + -s, --scale=SZÁM + -p, --preload + +=head1 LEÍRÁS + +Az B<Inkview> egy B<Scalable Vector Graphics (SVG)> megjelenítő, amely +diavetítésre és bemutatókra is használható. Egy vagy több B<FÁJL> vagy +B<MAPPA> adható meg parancssorban megnyitásra. Az Inkview a megadott sorban +fogja megjeleníteni az SVG fájlokat. A mappák a tartalmazott SVG fájlok +listájaként értendőek. + +Az Inkview futtatható bármilyen parancssori argumentum nélkül is, mert +ilyenkor egy fájlválasztó párbeszédablak jelenik meg, amely segítségével +fájlokat vagy mappákat lehet kijelölni a grafikus felhasználói felületen. + +=head1 KAPCSOLÓK + +=over 8 + +=item B<-?>, B<--help> + +Megjeleníti a súgóüzeneteket. + +=item B<-V>, B<--version> + +Megjeleníti az Inkview verzióját és a build dátumát (ez általában megegyezik +az Inkscape verziójával). + +=item B<-f>, B<--fullscreen> + +Inkview indítása teljes képernyős módban. + +=item B<-r>, B<--recursive> + +Rekurzívan keres SVG-fájlokat a parancssorban megadott mappákban. Ez azt +jelenti, hogy minden SVG-fájl meg lesz nyitva ennek a mappának bármelyik +almappájából. + +=item B<-t>, B<--timer=SZÁM> + +Lecseréli a képet a következőre minden SZÁM másodpercben. + +=item B<-s>, B<--scale=SZÁM> + +A képet a SZÁM tényezővel méretezve jeleníti meg a fájl natív mérete +helyett. + +=item B<-p>, B<--preload> + +Előtölti az összes SVG-fájlt. Az Inkview-nak továbbra is képeket kell +megjeleníteni, de ezzel a kapcsolóval az SVG-fájlok már értelmezve lesznek +és be lesznek töltve a memóriába. Ez a kapcsoló annak ellenőrzésére is +használható, hogy vajon a fájlok rendesen betölthetőek-e, anélkül, hogy +kézzel végig kellene rajtuk lépdelni. + +=back + +=head1 GYORSBILLENTYŰK + +=over 8 + +=item * Balra, Page Up vagy Backspace: előző kép megjelenítése + +=item * Jobbra, Page Down vagy Space: következő kép megjelenítése + +=item * Fel vagy Home: ugrás az első képre + +=item * Le vagy End: ugrás az utolsó képre + +=back + +=over 8 + +=item * Return: kezelőablak megjelenítése + +=item * F11: teljes képernyős mód átváltása + +=item * Escape vagy Q: kilépés + +=back + +=head1 PÉLDÁK + +Két SVG-fájlt nyit meg megjelenítésre: + + inkview fájl1.svg fájl2.svg + +Minden SVG-fájlt megnyit, melyek az Inkscape-pel érkeznek a példamappában: + + inkview B<${CMAKE_INSTALL_PREFIX}/${SHARE_INSTALL}>/inkscape/examples + +Megnyit egy teljes képernyős diavetítést, amely automatikusan a következő +képre lép minden 5. másodpercben: + + inkview --fullscreen --timer=5 [fájl/mappa ...] + +=head1 LÁSD MÉG + +L<inkscape> + +L<http://www.inkscape.org/> + +=head1 SZERZŐK + +Lásd: L<inkscape(1)> + +=head1 SZERZŐI JOGOK ÉS LICENC + +B<Copyright (C)> 1999–2023 a szerzők. + +Az B<Inkscape> szabad szoftver és GPL 3-as verziója szerint lehet +terjeszteni, ill. módosítani. + + + +=for comment $Date$ + diff --git a/man/inkview.ko.pod.in b/man/inkview.ko.pod.in new file mode 100644 index 0000000..fd707de --- /dev/null +++ b/man/inkview.ko.pod.in @@ -0,0 +1,137 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 이름 + +Inkview - SVG 뷰어 및 슬라이드 쇼 프로그램입니다. + +=head1 개요 + +C<inkview [options] [filename ...]> + +옵션: + + -h, --help + -V, --version + + -f, --fullscreen + -r, --recursive + -t, --timer=NUMBER + -s, --scale=NUMBER + -p, --preload + +=head1 설명 + +B<Inkview>는 슬라이드쇼나 프리젠테이션에도 사용할 수 있는 B<Scalable Vector Graphics (SVG)> +뷰어입니다. 열기를 위해 명령줄에 하나 이상의 B<파일> 또는 B<폴더>를 지정할 수 있습니다. Inkview는 모든 SVG 파일을 +지정된 순서로 표시합니다. 폴더는 포함된 SVG 파일 목록으로 확장됩니다. + +명령줄 인수 없이 Inkview를 실행할 수도 있습니다. 그러면 그래픽 사용자 인터페이스를 통해 파일과 폴더를 선택할 수 있는 파일 +선택기가 나타납니다. + +=head1 옵션 + +=over 8 + +=item B<-?>, B<--help> + +도움말 옵션 표시하기 + +=item B<-V>, B<--version> + +Inkview 버전 및 빌드 날짜를 인쇄합니다(일반적으로 Inkscape 버전과 일치함). + +=item B<-f>, B<--fullscreen> + +전체화면 모드에서 Inkview를 시작합니다. + +=item B<-r>, B<--recursive> + +SVG 파일에 대해 반복적으로 명령줄에 지정된 폴더를 검색합니다. 즉, 지정된 폴더의 모든 하위 폴더에 있는 모든 SVG 파일이 +열립니다. + +=item B<-t>, B<--timer=NUMBER> + +NUMBER초마다 다음 이미지로 변경하기 + +=item B<-s>, B<--scale=배수> + +파일의 기본 크기를 사용하는 대신 NUMBER 비율로 크기가 조정된 이미지를 표시합니다. + +=item B<-p>, B<--preload> + +모든 SVG 파일을 미리 불러옵니다. Inkview는 표시할 때 이미지를 렌더링해야 하지만, 이 옵션을 사용하면 모든 SVG 파일이 이미 +분석되어 메모리에 불러오기됩니다. 또한 이 옵션을 사용하여 모든 파일을 수동으로 순환하지 않고도 모든 파일을 제대로 열 수 있는지 확인할 +수 있습니다. + +=back + +=head1 키 바인딩 + +=over 8 + +=item * Left, Page Up, 또는 Backspace: 이전 이미지 표시 + +=item * Right, Page Down, 또는 Space: 다음 이미지 표시하기 + +=item * Up, 또는 Home: 첫 번째 이미지로 가기 + +=item * Down, 또는 End: 마지막 이미지로 가기 + +=back + +=over 8 + +=item * Return: 제어 창 표시하기 + +=item * F11: 전체화면 모드 전환하기 + +=item * Escape 또는 Q: 종료 + +=back + +=head1 예시 + +보기 위해 두 개의 SVG 파일 열기: + + inkview 파일1.svg 파일2.svg + +Inkscape와 함께 제공된 예시 폴더에서 모든 SVG 파일 열기: + + inkview B<${CMAKE_INSTALL_PREFIX}/${SHARE_INSTALL}>/inkscape/examples + +5초마다 다음 이미지로 자동 변경되는 전체 화면 슬라이드 쇼를 시작합니다: + + inkview --fullscreen --timer=5 [files/folders ...] + +=head1 참고 항목 + +L<inkscape> + +L<http://www.inkscape.org/> + +=head1 작성자 + +L<inkscape(1)> 참조 + +=head1 저작권 및 라이선스 + +B<Copyright (C)> 1999-2023 by Authors. + +B<Inkscape>는 자유 소프트웨어이므로 GPL 버전 3 이상의 조건에 따라 재배포 및/또는 수정할 수 있습니다. + + + +=for 주석 $Date$ + diff --git a/man/inkview.pod.in b/man/inkview.pod.in new file mode 100644 index 0000000..628d679 --- /dev/null +++ b/man/inkview.pod.in @@ -0,0 +1,136 @@ + ************************************************************ + * NOTE: Please do not edit this file directly. * + * * + * Changes should be applied to the source file at * + * https://gitlab.com/inkscape/inkscape-docs/documentation/ * + ************************************************************ + +=encoding UTF-8 + +=head1 NAME + +Inkview - an SVG viewer and slideshow program. + +=head1 SYNOPSIS + +C<inkview [options] [filename ...]> + +options: + + -h, --help + -V, --version + + -f, --fullscreen + -r, --recursive + -t, --timer=NUMBER + -s, --scale=NUMBER + -p, --preload + +=head1 DESCRIPTION + +B<Inkview> is an B<Scalable Vector Graphics (SVG)> viewer that can also be +used for slideshows or presentations. One or more B<FILES> or B<FOLDERS> can +be specified on the command-line for opening. Inkview will display all SVG +files in the given order. Folders will be expanded to a list of contained SVG +files. + +You can also launch Inkview without any command-line arguments, which will +bring up a file chooser that allows to select files and folders via a +graphical user interface. + +=head1 OPTIONS + +=over 8 + +=item B<-?>, B<--help> + +Show help options + +=item B<-V>, B<--version> + +Print Inkview version and build date (this is usually matches the Inkscape version). + +=item B<-f>, B<--fullscreen> + +Launch Inkview in fullscreen mode. + +=item B<-r>, B<--recursive> + +Search folders specified on the command line recursively for SVG files. +This means all SVG files in all subfolders of the specified folder will be opened. + +=item B<-t>, B<--timer=NUMBER> + +Change to the next image every NUMBER seconds + +=item B<-s>, B<--scale=NUMBER> + +Show image scaled by a factor of NUMBER instead of using the file's native size. + +=item B<-p>, B<--preload> + +Preloads all SVG files. Inkview still needs to render images upon showing, +however this option ensures all SVG files are already parsed and loaded into +memory. This option can also be used to verify if all files can be opened +properly, without having to cycle through all files manually. + +=back + +=head1 KEYBINDINGS + +=over 8 + +=item * Left, Page Up, or Backspace: show previous image + +=item * Right, Page Down, or Space: show next image + +=item * Up, or Home: go to first image + +=item * Down, or End: go to last image + +=back + +=over 8 + +=item * Return: show control window + +=item * F11: toggle fullscreen mode + +=item * Escape or Q: quit + +=back + +=head1 EXAMPLES + +Open two SVG files for viewing: + + inkview file1.svg file2.svg + +Open all SVG files in the examples folder shipped with Inkscape: + + inkview B<${CMAKE_INSTALL_PREFIX}/${SHARE_INSTALL}>/inkscape/examples + +Launch a fullscreen slideshow that automatically changes to the next image every 5 seconds: + + inkview --fullscreen --timer=5 [files/folders ...] + +=head1 SEE ALSO + +L<inkscape> + +L<http://www.inkscape.org/> + +=head1 AUTHORS + +See L<inkscape(1)> + +=head1 COPYRIGHT AND LICENSE + +B<Copyright (C)> 1999-2023 by Authors. + +B<Inkscape> is free software; you can redistribute it and/or modify it +under the terms of the GPL version 3 or later. + + +=for comment +$Date$ diff --git a/man/inkview.pt_BR.pod.in b/man/inkview.pt_BR.pod.in new file mode 100644 index 0000000..1da3708 --- /dev/null +++ b/man/inkview.pt_BR.pod.in @@ -0,0 +1,148 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NOME + +Inkview - um visualizador de SVG e programa de slideshow. + +=head1 SINOPSE + +C<inkview [options] [filename ...]> + +opções: + + -h, --help + -V, --version + + -f, --fullscreen + -r, --recursive + -t, --timer=NUMBER + -s, --scale=NUMBER + -p, --preload + +=head1 DESCRIÇÃO + +B<Inkview> é um visualizador de B<Scalable Vector Graphics (SVG)> que também +pode ser usado para slideshows ou apresentações. Um ou mais B<FILES> ou +B<FOLDERS> podem ser especificados na linha de comando para abrir. Inkview +vai mostrar todos os arquivos SVG na ordem fornecida. Pastas serão +expandidas com a lista dos arquivos SVG contidos nelas. + +Você também pode inicializar o Inkview sem argumentos na linha de comandos, +que irá trazer um escolhedor de arquivos que permite selecionar arquivos e +pastas pela interface gráfica do usuário. + +=head1 OPÇÕES + +=over 8 + +=item B<-?>, B<--help> + +Mostra opções de ajuda + +=item B<-V>, B<--version> + +Imprime a versão do Inkview e data do Build (isso geralmente confere com a +versão do Inkscape). + +=item B<-f>, B<--fullscreen> + +Iniciar Inkview em modo tela cheia. + +=item B<-r>, B<--recursive> + +Pesquisar recursivamente por pastas especificadas na linha de comando por +arquivos SVG. Isto significa que todos os arquivos SVG em todas as +subpastas da pasta especificada serão abertas. + +=item B<-t>, B<--timer=NUMBER> + +Mudar para a próxima imagem a cada NÚMERO de segundos + +=item B<-s>, B<--scale=NUMBER> + +Mostrar imagem redimensionada por um fator de NÚMERO ao invés de usar o +tamanho nativo do arquivo. + +=item B<-p>, B<--preload> + +Pré carrega todos os arquivos SVG. Inkview ainda precisa renderizar as +imagens antes de mostrá-las, entretanto esta opção garante que todos os +arquivos SVG já tenham sido analisados e carregados na memória. Esta opção +pode também ser usada para verificar se todos os arquivos foram abertos +corretamente, sem ter que percorrer todo o arquivo manualmente. + +=back + +=head1 MAPEAMENTO DE TECLAS + +=over 8 + +=item * Esquerda, Page Up, ou Backspace: mostrar imagem anterior + +=item * Direita, Page Down, ou Barra de Espaço: mostrar a próxima imagem + +=item * Acima, ou Home: vai para a primeira imagem + +=item * Baixo, ou End: vai para a última imagem + +=back + +=over 8 + +=item * Return: mostra a janela de controle + +=item * F11: alterna para o modo tela cheia + +=item * Escape ou Q: sair + +=back + +=head1 EXEMPLOS + +Abrir dois arquivos SVG para serem visualizados: + + inkview file1.svg file2.svg + +Abra todos os arquivos SVG na pasta de exemplos que foram enviados junto com +o Inkscape: + + inkview B<${CMAKE_INSTALL_PREFIX}/${SHARE_INSTALL}>/inkscape/examples + +Carregar um slideshow com tela cheia que automaticamente muda para a próxima +imagem a cada 5 segundos: + + inkview --fullscreen --timer=5 [files/folders ...] + +=head1 VEJA TAMBÉM + +L<inkscape> + +L<http://www.inkscape.org/> + +=head1 AUTORES + +Veja L<inkscape(1)> + +=head1 COPYRIGHT E LICENÇA + +B<Copyright (C)> 1999-2023 by Authors. + +B<Inkscape> é software livre; você pode redistribuí-lo e modificações-lo sob +os termos da GPL versão 3 ou mais recente. + + + +=for comentar $Date$ + diff --git a/man/inkview.zh_TW.pod.in b/man/inkview.zh_TW.pod.in new file mode 100644 index 0000000..31a78bd --- /dev/null +++ b/man/inkview.zh_TW.pod.in @@ -0,0 +1,134 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 名稱 + +Inkview - SVG 檢視軟體和投影片播放程式。 + +=head1 概要 + +C<inkview [選項] [檔名 ...]> + +選項: + + -h, --help + -V, --version + + -f, --fullscreen + -r, --recursive + -t, --timer=秒數 + -s, --scale=倍數 + -p, --preload + +=head1 描述 + +B<Inkview> 是一款 B<Scalable Vector Graphics (SVG)> +檢視程式,也可用於投影片播放或簡報。可用指令開啟一個或多個B<檔案>或B<資料夾>。Inkview 依照給定的順序顯示全部 SVG +檔案。資料夾會展開為一個內含 SVG 檔案的清單。 + +你也可以不加任何命令參數啟動 Inkview,程式會顯示檔案選擇對話窗讓使用者從圖形介面選擇檔案和資料夾。 + +=head1 選項 + +=over 8 + +=item B<-?>, B<--help> + +顯示說明選項 + +=item B<-V>, B<--version> + +印出 Inkview 版本和編譯日期 (通常與 Inkscape 版相同)。 + +=item B<-f>, B<--fullscreen> + +以全螢幕模式啟動 Inkview。 + +=item B<-r>, B<--recursive> + +遞迴搜尋命令指定資料夾中的 SVG 檔案。這表示會開啟指定資料夾底下的全部子資料夾中全部 SVG 檔案。 + +=item B<-t>, B<--timer=秒數> + +每給定的秒數切換下一張影像 + +=item B<-s>, B<--scale=倍數> + +以指定數值的縮放倍數顯示影像而非使用檔案的原始大小。 + +=item B<-p>, B<--preload> + +預先載入全部 SVG 檔案。Inkview 顯示時仍需要繪算圖像,但是此選項可確保全部 SVG +檔案已解析完成且載入到記憶體中。此選項也可用於驗證全部檔案是否能夠正常開啟,而不需要手動循序開啟檔案檢查。 + +=back + +=head1 按鍵對應 + +=over 8 + +=item * 左方向鍵, Page Up, 或倒退鍵: 顯示上一張影像 + +=item * 右方向鍵, Page Down, 或空白鍵: 顯示下一張影像 + +=item * 上方向鍵, 或 Home: 前往第一張影像 + +=item * 下方向鍵, 或 End: 前往最後一張影像 + +=back + +=over 8 + +=item * Return: 顯示控制視窗 + +=item * F11: 切換全螢幕模式 + +=item * Escape 或 Q: 離開 + +=back + +=head1 範例 + +開啟並顯示兩個 SVG 檔案: + + inkview file1.svg file2.svg + +開啟與 inkscape 連動的 examples 資料夾內全部 SVG 檔案: + + inkview B<${CMAKE_INSTALL_PREFIX}/${SHARE_INSTALL}>/inkscape/examples + +啟動全螢幕投影片播放並每 5 秒自動切換下一張影像: + + inkview --fullscreen --timer=5 [檔案/資料夾 ...] + +=head1 參見 + +L<inkscape> + +L<http://www.inkscape.org/> + +=head1 作者 + +詳見 L<inkscape(1)> + +=head1 著作權和許可證 + +B<Copyright (C)> 1999-2023 by Authors. + +B<Inkscape> 是自由軟體;你可以在遵守 GPL 版本 3 或更新版本的許可證情形下重新發佈或修改它。 + + + +=for comment $Date$ + diff --git a/man/utf8-to-roff b/man/utf8-to-roff new file mode 100644 index 0000000..9bb178f --- /dev/null +++ b/man/utf8-to-roff @@ -0,0 +1,319 @@ +if (true || '\'); then exec perl -CI "$0" "$@"; fi # ') {} +# The above uses the fact that backslash isn't special in single quotes in +# shell script, whereas in perl it escapes the following single quote. +# +# The problem it tries to solve is that we want perl to be run with -CI flag +# (to have stdin interpreted as utf-8), so we would use `#! /usr/bin/perl -CI', +# except that if we do that then perl 5.10 complains about it being too late +# to apply -CI if the script is run with `perl -CI ./utf8-to-roff', as we want +# to do from the Makefile. The reason we don't do `./utf8-to-roff' from the makefile +# is that then we require the #! line to have the right location of perl instead of +# just consulting the path. (Similarly, we could use `#! /usr/bin/env perl -CI', +# though that still requires that /usr/bin/env exist.) The reason we don't just +# remove the `-CI' from the #! line is that then the script couldn't be run correctly +# with ./utf8-to-roff. + + +# Converts a man page from utf8 (not understood by groff 1.18) to groff escapes. +# I couldn't find any existing tool to convert from utf8 to groff, though I +# seem to recall seeing some code to do so somewhere. +# +# Hereby released into public domain by Peter Moulder. +use warnings; +use strict; + +# Table generated automatically using: +# zcat /usr/share/man/man7/groff_char.7.gz |groff -man -Tutf8| col -pb | grep '\\\['| +# perl -CI -nae 'my ($ch, $seq) = @F; if (ord($ch) >= 128) { printf(" 0x\%x, q{\%s},\n", ord($ch), $seq); }' +# with č (0x10d) manually translated as cˇ (c\[ah]). (Anyone have a better translation, e.g. using +# overprint? \[vc] doesn't work, btw.) +# Similarly, ć (0x107) has been manually translated as c´ (c\[aa]), and ń (0x144) as n´ (n\[aa]). +my %map = ( + 0xd0, q{\[-D]}, + 0xf0, q{\[Sd]}, + 0xde, q{\[TP]}, + 0xfe, q{\[Tp]}, + 0xdf, q{\[ss]}, + 0xfb00, q{\[ff]}, + 0xfb01, q{\[fi]}, + 0xfb02, q{\[fl]}, + 0xfb03, q{\[Fi]}, + 0xfb04, q{\[Fl]}, + 0xc6, q{\[AE]}, + 0xe6, q{\[ae]}, + 0x152, q{\[OE]}, + 0x153, q{\[oe]}, + 0x131, q{\[.i]}, + 0xc1, q{\['A]}, + 0xc9, q{\['E]}, + 0xcd, q{\['I]}, + 0xd3, q{\['O]}, + 0xda, q{\['U]}, + 0xdd, q{\['Y]}, + 0xe1, q{\['a]}, + 0xe9, q{\['e]}, + 0xed, q{\['i]}, + 0xf3, q{\['o]}, + 0xfa, q{\['u]}, + 0xfd, q{\['y]}, + 0xc4, q{\[:A]}, + 0xcb, q{\[:E]}, + 0xcf, q{\[:I]}, + 0xd6, q{\[:O]}, + 0xdc, q{\[:U]}, + 0x178, q{\[:Y]}, + 0xe4, q{\[:a]}, + 0xeb, q{\[:e]}, + 0xef, q{\[:i]}, + 0xf6, q{\[:o]}, + 0xfc, q{\[:u]}, + 0xff, q{\[:y]}, + 0xc2, q{\[^A]}, + 0xca, q{\[^E]}, + 0xce, q{\[^I]}, + 0xd4, q{\[^O]}, + 0xdb, q{\[^U]}, + 0xe2, q{\[^a]}, + 0xea, q{\[^e]}, + 0xee, q{\[^i]}, + 0xf4, q{\[^o]}, + 0xfb, q{\[^u]}, + 0xc0, q{\[`A]}, + 0xc8, q{\[`E]}, + 0xcc, q{\[`I]}, + 0xd2, q{\[`O]}, + 0xd9, q{\[`U]}, + 0xe0, q{\[`a]}, + 0xe8, q{\[`e]}, + 0xec, q{\[`i]}, + 0xf2, q{\[`o]}, + 0xf9, q{\[`u]}, + 0xc3, q{\[~A]}, + 0xd1, q{\[~N]}, + 0xd5, q{\[~O]}, + 0xe3, q{\[~a]}, + 0xf1, q{\[~n]}, + 0xf5, q{\[~o]}, + 0x107, q{c\[aa]}, # Added manually; see above. + 0x10d, q{c\[ah]}, # Added manually; see above. + 0x160, q{\[vS]}, + 0x161, q{\[vs]}, + 0x17d, q{\[vZ]}, + 0x17e, q{\[vz]}, + 0xc7, q{\[,C]}, + 0xe7, q{\[,c]}, + 0x141, q{\[/L]}, + 0x142, q{\[/l]}, + 0x144, q{n\[aa]}, # Added manually; see above. + 0xd8, q{\[/O]}, + 0xf8, q{\[/o]}, + 0xc5, q{\[oA]}, + 0xe5, q{\[oa]}, + 0x2dd, q{\[a"]}, + 0xaf, q{\[a-]}, + 0x2d9, q{\[a.]}, + 0xb4, q{\[aa]}, + 0x2d8, q{\[ab]}, + 0xb8, q{\[ac]}, + 0xa8, q{\[ad]}, + 0x2c7, q{\[ah]}, + 0x2da, q{\[ao]}, + 0x2db, q{\[ho]}, + 0x223c, q{\[ti]}, + 0x201e, q{\[Bq]}, + 0x201a, q{\[bq]}, + 0x201c, q{\[lq]}, + 0x201d, q{\[rq]}, + 0x2018, q{\[oq]}, + 0x2019, q{\[cq]}, + 0xab, q{\[Fo]}, + 0xbb, q{\[Fc]}, + 0x2039, q{\[fo]}, + 0x203a, q{\[fc]}, + 0xa1, q{\[r!]}, + 0xbf, q{\[r?]}, + 0x2014, q{\[em]}, + 0x2013, q{\[en]}, + 0x2010, q{\[hy]}, + 0x2329, q{\[la]}, + 0x232a, q{\[ra]}, + 0x2190, q{\[<-]}, + 0x2192, q{\[->]}, + 0x2194, q{\[<>]}, + 0x2193, q{\[da]}, + 0x21d1, q{\[ua]}, + 0x21d0, q{\[lA]}, + 0x21d2, q{\[rA]}, + 0x21d4, q{\[hA]}, + 0x21d3, q{\[dA]}, + 0x21d1, q{\[uA]}, + 0x2500, q{\[an]}, + 0x2502, q{\[br]}, + 0x2502, q{\[bv]}, + 0xa6, q{\[bb]}, + 0x25ef, q{\[ci]}, + 0xb7, q{\[bu]}, + 0x2021, q{\[dd]}, + 0x2020, q{\[dg]}, + 0x25ca, q{\[lz]}, + 0x25a1, q{\[sq]}, + 0xb6, q{\[ps]}, + 0xa7, q{\[sc]}, + 0x261c, q{\[lh]}, + 0x261e, q{\[rh]}, + 0x240d, q{\[CR]}, + 0xa9, q{\[co]}, + 0xae, q{\[rg]}, + 0x2122, q{\[tm]}, + 0x21d1, q{\[Do]}, + 0xa2, q{\[ct]}, + 0x20ac, q{\[eu]}, + 0x20ac, q{\[Eu]}, + 0xa5, q{\[Ye]}, + 0xa3, q{\[Po]}, + 0xa4, q{\[Cs]}, + 0x192, q{\[Fn]}, + 0xb0, q{\[de]}, + 0x2030, q{\[%0]}, + 0x2032, q{\[fm]}, + 0x2033, q{\[sd]}, + 0xb5, q{\[mc]}, + 0xaa, q{\[Of]}, + 0xba, q{\[Om]}, + 0x2227, q{\[AN]}, + 0x2228, q{\[OR]}, + 0xac, q{\[no]}, + 0x2203, q{\[te]}, + 0x2200, q{\[fa]}, + 0x220b, q{\[st]}, + 0x2234, q{\[3d]}, + 0x2234, q{\[tf]}, + 0xbd, q{\[12]}, + 0xbc, q{\[14]}, + 0xbe, q{\[34]}, + 0xb9, q{\[S1]}, + 0xb2, q{\[S2]}, + 0xb3, q{\[S3]}, + 0xb1, q{\[+-]}, + 0xb1, q{\[t+-]}, + 0xb7, q{\[pc]}, + 0x22c5, q{\[md]}, + 0xd7, q{\[mu]}, + 0xd7, q{\[tmu]}, + 0x2297, q{\[c*]}, + 0x2295, q{\[c+]}, + 0xf7, q{\[di]}, + 0xf7, q{\[tdi]}, + 0x2044, q{\[f/]}, + 0x2217, q{\[**]}, + 0x2264, q{\[<=]}, + 0x2265, q{\[>=]}, + 0x2260, q{\[!=]}, + 0x2261, q{\[==]}, + 0x2245, q{\[=~]}, + 0x223c, q{\[ap]}, + 0x2248, q{\[~~]}, + 0x2248, q{\[~=]}, + 0x221d, q{\[pt]}, + 0x2205, q{\[es]}, + 0x2208, q{\[mo]}, + 0x2209, q{\[nm]}, + 0x2284, q{\[nb]}, + 0x2282, q{\[sb]}, + 0x2283, q{\[sp]}, + 0x2286, q{\[ib]}, + 0x2287, q{\[ip]}, + 0x2229, q{\[ca]}, + 0x222a, q{\[cu]}, + 0x2220, q{\[/_]}, + 0x22a5, q{\[pp]}, + 0x222b, q{\[is]}, + 0x2211, q{\[sum]}, + 0x220f, q{\[product]}, + 0x2207, q{\[gr]}, + 0x221a, q{\[sr]}, + 0x203e, q{\[rn]}, + 0x221e, q{\[if]}, + 0x2135, q{\[Ah]}, + 0x2111, q{\[Im]}, + 0x211c, q{\[Re]}, + 0x2118, q{\[wp]}, + 0x2202, q{\[pd]}, + 0x391, q{\[*A]}, + 0x392, q{\[*B]}, + 0x39e, q{\[*C]}, + 0x394, q{\[*D]}, + 0x395, q{\[*E]}, + 0x3a6, q{\[*F]}, + 0x393, q{\[*G]}, + 0x398, q{\[*H]}, + 0x399, q{\[*I]}, + 0x39a, q{\[*K]}, + 0x39b, q{\[*L]}, + 0x39c, q{\[*M]}, + 0x39d, q{\[*N]}, + 0x39f, q{\[*O]}, + 0x3a0, q{\[*P]}, + 0x3a8, q{\[*Q]}, + 0x3a1, q{\[*R]}, + 0x3a3, q{\[*S]}, + 0x3a4, q{\[*T]}, + 0x3a5, q{\[*U]}, + 0x3a9, q{\[*W]}, + 0x3a7, q{\[*X]}, + 0x397, q{\[*Y]}, + 0x396, q{\[*Z]}, + 0x3b1, q{\[*a]}, + 0x3b2, q{\[*b]}, + 0x3be, q{\[*c]}, + 0x3b4, q{\[*d]}, + 0x3b5, q{\[*e]}, + 0x3c6, q{\[*f]}, + 0x3d5, q{\[+f]}, + 0x3b3, q{\[*g]}, + 0x3b8, q{\[*h]}, + 0x3d1, q{\[+h]}, + 0x3b9, q{\[*i]}, + 0x3ba, q{\[*k]}, + 0x3bb, q{\[*l]}, + 0x3bc, q{\[*m]}, + 0x3bd, q{\[*n]}, + 0x3bf, q{\[*o]}, + 0x3c0, q{\[*p]}, + 0x3d6, q{\[+p]}, + 0x3c8, q{\[*q]}, + 0x3c1, q{\[*r]}, + 0x3c3, q{\[*s]}, + 0x3c4, q{\[*t]}, + 0x3c5, q{\[*u]}, + 0x3c9, q{\[*w]}, + 0x3c7, q{\[*x]}, + 0x3b7, q{\[*y]}, + 0x3b6, q{\[*z]}, + 0x3c2, q{\[ts]}, + 0x2663, q{\[CL]}, + 0x2660, q{\[SP]}, + 0x2665, q{\[HE]}, + 0x2666, q{\[DI]}, +); + +#while(<>) { +# s/([^ -~])/(ord($1) < 128 ? $1 : defined($map{$1}) ? $map{$1} : sprintf("\\u%4x", $1))/ge; +# print; +#} +#exit 0; + +my $ch; +while(defined($ch = getc(STDIN))) { + my $ord = ord($ch); + if ($ord < 128) { + print $ch; + } else { + my $out = $map{$ord}; + if (defined($out)) { + print $out; + } else { + die "Untranslatable character \\u" . sprintf("%X", ord($ch)) . " / `$ch'"; + } + } +} |