Unverified Commit a589a08a authored by Moini's avatar Moini
Browse files

Update man page (compatible with Inkscape 1.2.x)

parent ba9254a2
......@@ -18,6 +18,10 @@ C<inkscape [options] [filename_1 filename_2 ...]>
options:
-?, --help
--help-all
--help-gapplication
--help-gtk
-V, --version
--debug-info
--system-data-directory
......@@ -46,6 +50,8 @@ options:
-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
......@@ -66,10 +72,10 @@ options:
--select=OBJECT-ID[,OBJECT-ID]*
--actions=ACTION(:ARG)[;ACTION(:ARG)]*
--action-list
--verb=VERB[;VERB]*
--verb-list
-g, --with-gui
--display=DISPLAY
--app-id-tag=TAG
--batch-process
--shell
......@@ -109,6 +115,18 @@ available in the Open Source community.
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.
......@@ -291,6 +309,14 @@ 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.
......@@ -434,29 +460,18 @@ multiple exports on a single file.
Prints a list of all available actions.
=item B<--verb>=I<VERB[;VERB]*>
The L<--verb> command will execute a specific verb or list of verbs as if they were called from
a menu or button. Dialogs will appear if that is part of the verb. To
get a list of the verb IDs available, use the L<--verb-list> command line
option.
Note that the L<--verb> command requires a GUI.
=item B<-g>, B<--with-gui>
Together with L<--select> provides some basic scripting for
Inkscape from the command line. They both can receive many arguments as
needed on the command line and are executed in order on every document.
Try to use the GUI (on Unix, use the X server even if $DISPLAY is not
set).
=item B<--verb-list>
=item B<--display>=I<DISPLAY>
Lists all the verbs that are available in Inkscape by ID. This ID can
be used in defining keymaps or menus. It can also be used with
the L<--verb> command line option.
Sets the X display to use for the Inkscape window.
=item B<-g>, B<--with-gui>
=item B<--app-id-tag>=I<TAG>
Try to use the GUI (on Unix, use the X server even if $DISPLAY is not
set).
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>
......@@ -492,14 +507,24 @@ 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/ - extension effects.
B<$HOME>/.config/inkscape/extensions/ - extensions.
B<$HOME>/.config/inkscape/fonts/ - fonts.
B<$HOME>/.config/inkscape/icons/ - icons.
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.
......@@ -563,22 +588,23 @@ Query the width of the object with id="text1555":
Duplicate the objects with id="path1555" and id="rect835", rotate the duplicates 90
degrees, save SVG, and quit:
inkscape --select=path1555,rect835 --verb="EditDuplicate;ObjectRotate90;FileSave;FileQuit" filename.svg
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;FileSave;FileClose" --batch-process filename.svg
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" filename.svg
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:
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
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment