summaryrefslogtreecommitdiffstats
path: root/man/inkscape.zh_TW.pod.in
blob: cac22c6212dc1563dae5e0e08538399966946478 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
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$