[Goodies-commits] r7798 - in xfce4-clipman-plugin/trunk: . docs/manual docs/manual/zh_CN docs/manual/zh_CN/images
Mike Massonnet
mmassonnet at xfce.org
Fri Jul 24 15:12:04 CEST 2009
Author: mmassonnet
Date: 2009-07-24 13:12:04 +0000 (Fri, 24 Jul 2009)
New Revision: 7798
Added:
xfce4-clipman-plugin/trunk/docs/manual/zh_CN/
xfce4-clipman-plugin/trunk/docs/manual/zh_CN/Makefile.am
xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/
xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/Makefile.am
xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-action-dialog.png
xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-menu.png
xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-settings-actions.png
xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-settings-general.png
xfce4-clipman-plugin/trunk/docs/manual/zh_CN/xfce4-clipman-plugin.html
xfce4-clipman-plugin/trunk/docs/manual/zh_CN/xfce4-clipman-plugin.xml.in
Modified:
xfce4-clipman-plugin/trunk/ChangeLog
xfce4-clipman-plugin/trunk/configure.ac.in
xfce4-clipman-plugin/trunk/docs/manual/Makefile.am
Log:
Add Simplified Chinese documentation
Modified: xfce4-clipman-plugin/trunk/ChangeLog
===================================================================
--- xfce4-clipman-plugin/trunk/ChangeLog 2009-07-24 12:49:26 UTC (rev 7797)
+++ xfce4-clipman-plugin/trunk/ChangeLog 2009-07-24 13:12:04 UTC (rev 7798)
@@ -1,3 +1,6 @@
+2009-07-24 Mike Massonnet
+Add Simplified Chinese documentation
+
2009-07-15 Mike Massonnet
Run PNG images inside docs/manual through optipng (26%~ decrease)
Modified: xfce4-clipman-plugin/trunk/configure.ac.in
===================================================================
--- xfce4-clipman-plugin/trunk/configure.ac.in 2009-07-24 12:49:26 UTC (rev 7797)
+++ xfce4-clipman-plugin/trunk/configure.ac.in 2009-07-24 13:12:04 UTC (rev 7798)
@@ -141,6 +141,9 @@
docs/manual/ja/Makefile
docs/manual/ja/xfce4-clipman-plugin.xml
docs/manual/ja/images/Makefile
+docs/manual/zh_CN/Makefile
+docs/manual/zh_CN/xfce4-clipman-plugin.xml
+docs/manual/zh_CN/images/Makefile
])
dnl ***************************
Modified: xfce4-clipman-plugin/trunk/docs/manual/Makefile.am
===================================================================
--- xfce4-clipman-plugin/trunk/docs/manual/Makefile.am 2009-07-24 12:49:26 UTC (rev 7797)
+++ xfce4-clipman-plugin/trunk/docs/manual/Makefile.am 2009-07-24 13:12:04 UTC (rev 7798)
@@ -5,6 +5,7 @@
fr \
gl \
ja \
+ zh_CN \
$(NULL)
EXTRA_DIST = \
Added: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/Makefile.am
===================================================================
--- xfce4-clipman-plugin/trunk/docs/manual/zh_CN/Makefile.am (rev 0)
+++ xfce4-clipman-plugin/trunk/docs/manual/zh_CN/Makefile.am 2009-07-24 13:12:04 UTC (rev 7798)
@@ -0,0 +1,61 @@
+## Makefile.am file for the Docbook to HTML generation
+##
+## Copyright (C) 2006 The Xfce development team.
+##
+## Written by Benedikt Meurer <benny at xfce.org>, 2006.
+
+NULL =
+
+SUBDIRS = \
+ images \
+ $(NULL)
+
+TARGET_DIR = $(datadir)/xfce4/doc/zh_CN
+STYLESHEET = ../xfce-nochunk.xsl
+DOCUMENT = $(PACKAGE).xml
+
+DOC_STAMPS = html-build.stamp
+
+EXTRA_DIST = $(DOCUMENT)
+CLEANFILES = $(DOC_STAMPS)
+
+if ENABLE_XSLTPROC
+all-local: html-build.stamp
+
+html-build.stamp: $(srcdir)/$(DOCUMENT) $(srcdir)/$(STYLESHEET)
+ @echo "*** Building HTML ***"
+ @-chmod -R u+w $(srcdir)
+ $(XSLTPROC) --nonet -o $(srcdir)/ $(srcdir)/$(STYLESHEET) $(srcdir)/$(DOCUMENT)
+ touch html-build.stamp
+else
+all-local:
+endif
+
+install-data-local:
+ installfiles=`echo $(srcdir)/*.html`; \
+ if test "$$installfiles" = '$(srcdir)/*.html'; then \
+ echo "--- Nothing to install"; \
+ else \
+ $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR); \
+ for file in $$installfiles; do \
+ echo "--- Installing "$$file; \
+ $(INSTALL_DATA) $$file $(DESTDIR)$(TARGET_DIR); \
+ done; \
+ fi
+
+uninstall-local:
+ rm -rf $(DESTDIR)$(TARGET_DIR)/*
+
+if ENABLE_XSLTPROC
+dist-check-xsltproc: all
+else
+dist-check-xsltproc:
+ @echo "*** xsltproc must be installed and enabled in order to make dist"
+ @false
+endif
+
+dist-hook: dist-check-xsltproc dist-hook-local
+ -cp $(srcdir)/*.html $(distdir)
+
+.PHONY: dist-hook-local
+
Added: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/Makefile.am
===================================================================
--- xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/Makefile.am (rev 0)
+++ xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/Makefile.am 2009-07-24 13:12:04 UTC (rev 7798)
@@ -0,0 +1,12 @@
+NULL =
+
+imagesdir = $(datadir)/xfce4/doc/zh_CN/images
+images_DATA = \
+ clipman-action-dialog.png \
+ clipman-menu.png \
+ clipman-settings-actions.png \
+ clipman-settings-general.png \
+ $(NULL)
+
+EXTRA_DIST = $(images_DATA)
+
Added: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-action-dialog.png
===================================================================
(Binary files differ)
Property changes on: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-action-dialog.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-menu.png
===================================================================
(Binary files differ)
Property changes on: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-menu.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-settings-actions.png
===================================================================
(Binary files differ)
Property changes on: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-settings-actions.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-settings-general.png
===================================================================
(Binary files differ)
Property changes on: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/images/clipman-settings-general.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/xfce4-clipman-plugin.html
===================================================================
--- xfce4-clipman-plugin/trunk/docs/manual/zh_CN/xfce4-clipman-plugin.html (rev 0)
+++ xfce4-clipman-plugin/trunk/docs/manual/zh_CN/xfce4-clipman-plugin.html 2009-07-24 13:12:04 UTC (rev 7798)
@@ -0,0 +1,32 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Clipman 手册</title><link rel="stylesheet" href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#xfce4-clipman-plugin" title="Clipman 手册"><link rel="next" href="#intro" title="简介"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="zh-CN"><div class="titlepage"><div><div><h2 class="title"><a name="xfce4-clipman-plugin"></a>Clipman 手册</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Mike</span> <span class="surname">Massonnet</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a class="email" href="mailto:mmassonnet at xfce.org">mmassonnet at xfce.org</a>></code></p></div></div></div></div></div><div><span xmlns="http:/
/www.w3.org/TR/xhtml1/transitional" class="releaseinfo">此手册介绍 Clipman ,版本 1.1.0svn-r07797。<br></br></span></div><div><p class="copyright">版权 © 2009 Mike Massonnet</p></div><div><p class="copyright">版权 © 2009. Hunt Xu (huntxu at live.cn)</p></div><div><div class="legalnotice"><a name="legalnotice"></a><p>在自由软件基金会发布的 GNU 自由文档许可协议版本 1.3 或以后版本的条款约束下允许复制,分发和/或修改本文档,不要求保留特定内容、封面文本或者封底文本。许可协议全&
#25991;可以通过以下链接找到: <a class="ulink" href="http://www.fsf.org/" target="_top">Free Software Foundation</a>。</p></div></div><div><p class="pubdate">April, July 2009</p></div></div><hr></div><div class="toc"><p><b>目录</b></p><dl><dt><span class="sect1"><a href="#intro">简介</a></span></dt><dd><dl><dt><span class="sect2"><a href="#anatomy-clipboard">剪贴板的分析</a></span></dt><dt><span class="sect2"><a href="#getting-started">开始使用</a></span></dt><dt><span class="sect2"><a href="#popup-command">弹出命令</a></span></dt></dl></dd><dt><span class="sect1"><a href="#settings">设置</a></span></dt><dd><dl><dt><span class="sect2"><a href="#general">常规</a></span></dt><dt><span class="sect2"><a href="#actions">动作</a></span></dt><dt><span class="sect2"><a href="#a
ction-dialog">动作对话框</a></span></dt><dt><span class="sect2"><a href="#xfconf">Xfconf</a></span></dt></dl></dd><dt><span class="sect1"><a href="#support">支持</a></span></dt><dt><span class="sect1"><a href="#about">关于 Clipman</a></span></dt></dl></div><div class="sect1" lang="zh-CN"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="intro"></a>简介</h2></div></div></div><p>
+ Clipman is a clipboard manager for Xfce. It keeps the clipboard contents around while it is usually lost
+ when you close an application. It is able to handle text and images, and has a feature to execute actions on
+ specific text by matching them against regular expressions.
+ </p><div class="sect2" lang="zh-CN"><div class="titlepage"><div><div><h3 class="title"><a name="anatomy-clipboard"></a>剪贴板的分析</h3></div></div></div><p>在 X11 (所有的 Unix 平台) 中,默认有两个剪贴板用以交换各窗口间的数据。其中的一个剪贴板(我们称之为预设剪贴板)用以手动复制(例如您选择一个文件之后点击复制按钮),而另一个(我们称之为主剪贴板)用以选中复制(例如您选中在文
6412;框中的文本)。</p><p>
+ Clipman handles only the default clipboard, but optionnaly it can also notice the selections. When it is
+ handling the selections, the default clipboard will always be synced with it and contain the same data. By this
+ meaning you can paste with the keyboard what you select on screen.
+ </p></div><div class="sect2" lang="zh-CN"><div class="titlepage"><div><div><h3 class="title"><a name="getting-started"></a>开始使用</h3></div></div></div><p>
+ Clipman is used to keep in history a list of clipboard contents and to restore them. The history is
+ displayed in a menu by clicking on the main icon. Within the menu it is possible to restore a text and to clear
+ the history.
+ </p><div class="figure"><a name="id2924343"></a><p class="title"><b>图 1. 剪贴板菜单</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/clipman-menu.png" alt="用以显示历史的菜单"></div></div></div><br class="figure-break"><p>
+ There are two ways to run Clipman. You can select Clipman in the applications menu under the category
+ Utility or type <strong class="application"><code>xfce4-clipman</code></strong> on the command-line, or you can add it into your panel.
+ To add a new item in the panel right click the panel and select “Add new item…”.
+ </p></div><div class="sect2" lang="zh-CN"><div class="titlepage"><div><div><h3 class="title"><a name="popup-command"></a>弹出命令</h3></div></div></div><p>Clipman 提供一个命令行工具 <strong class="application"><code>xfce4-popup-clipman</code></strong>。当它被执行时将弹出主菜单。使用在 <span class="guimenu"><strong>Xfce 菜单</strong></span>+<span class="guimenu"><strong>设置</strong></span>+<span class="guimenu"><strong>键盘</strong></span> 中的 <span class="bold"><strong>应用程序快捷方式</strong></span> 启动该程序将会十分方便。</p></div></div><div class="sect1" lang="zh-CN"><div class="titlepage"><div><div><h2 class="title" sty
le="clear: both"><a name="settings"></a>设置</h2></div></div></div><p>通过右键点击主图标,并选择菜单中的“属性”项可以打开设置对话框。它允许您调节剪贴板历史的相关属性或者编辑动作。</p><div class="sect2" lang="zh-CN"><div class="titlepage"><div><div><h3 class="title"><a name="general"></a>常规</h3></div></div></div><p>以下是可用选项的列表:</p><div class="table"><a name="id2924464"></a><p class="title"><b>表 1. 设置对话框中的常规选项</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR
/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="设置对话框中的常规选项" border="1"><colgroup><col xmlns=""><col xmlns=""></colgroup><thead xmlns=""><tr><th align="left">选项</th><th align="left">描述</th></tr></thead><tbody xmlns=""><tr><td align="left">Sync selections</td><td align="left">同步主剪贴板的内容到预设剪贴板中以粘贴选中的内容</td></tr><tr><td align="left">从历史中排除</td><td align="left">不将主剪贴板中的内容加入到历史中</td></tr><tr><td align="left">保存并退出</td><td align="left">在每次新会话中ö
74;复历史</td></tr><tr><td align="left">保存一幅图像</td><td align="left">允许在历史中保存一幅图像</td></tr><tr><td align="left">历史大小</td><td align="left">设置保留在历史中的条目数量</td></tr></tbody></table></div></div><br class="table-break"><div class="figure"><a name="id2923839"></a><p class="title"><b>图 2. 剪贴板设置</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/clipman-settings-general.png" alt="带有一般标签的设置对话框"></div></div></div><br class="figure-break"></div><div class="sect2" lang="zh-CN"><div class="titlepage"><div><div><h3 class="title"><a name="actions"></a>动作</h3></div></div
></div><p>一个动作由一个“动作名称 - 正则表达式”对构成。每一个动作可以执行一个或一个以上的命令。对动作的支持是程序的可选项,您能够通过“允许动作”选项启用或禁用该支持。</p><p>要添加一个动作,请点击添加图标;要编辑一个动作,请选择该动作并点击编辑图标或者直接双击Ŧ
13;动作;要删除一个动作,请选择该动作并点击删除图标。选择添加或者编译一个动作,一个新对话框将会被打开。</p><p>
+ To learn more about actions go to <a class="xref" href="#action-dialog" title="动作对话框">“动作对话框”一节</a>.
+ </p><div class="figure"><a name="id2924003"></a><p class="title"><b>图 3. 剪贴板设置</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/clipman-settings-actions.png" alt="带有动作标签的设置对话框"></div></div></div><br class="figure-break"></div><div class="sect2" lang="zh-CN"><div class="titlepage"><div><div><h3 class="title"><a name="action-dialog"></a>动作对话框</h3></div></div></div><p>
+ An action has a human readable name that describes the pattern it is going to match. An action must have at
+ least one command which also has a human readable name. The matched text can be reused in the command.
+ </p><p>
+ The actions are always matched against text selections unless specified otherwise. When the box “Activate only
+ on manual copy” is checked, the action will be matched from the default clipboard (e.g. with Ctrl+C).
+ </p><div class="figure"><a name="id2924059"></a><p class="title"><b>图 4. 动作对话框</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/clipman-action-dialog.png" alt="动作编辑对话框"></div></div></div><br class="figure-break"><div class="sect3" lang="zh-CN"><div class="titlepage"><div><div><h4 class="title"><a name="regexes"></a>正则表达式</h4></div></div></div><p>基本特殊字符: "<span class="bold"><strong><code class="code">.?+*(|)[]\</code></strong></span>"。</p><div class="itemizedlist"><ul type="disc"><li>”<span class="bold"><strong><code class="code">.</code></strong></span>”: 代表任意单个字符。</li><li>”<span class="bold"><strong><code class="code">?+*</code></strong></span>”: 分别代表&
646;或一个字符,一个或一个以上字符,以及任意多个(包括0个)字符。</li><li>”<span class="bold"><strong><code class="code">(|)</code></strong></span>”: 在分组和替换中,竖线(|)用以表示 “或” 。</li><li>”<span class="bold"><strong><code class="code">[^]</code></strong></span>”: 在一系列字符或特殊字符中匹配一个字符时,“^” 符号在开头使用表示否定。</li><li>”<span class="bold"><strong><code class="code">\</code></strong></span>”: 将特殊字符作&#
20026;普通字符进行匹配。</li></ul></div><p>基本的字母和数字字符类: "<span class="bold"><strong><code class="code">A-Za-z0-9</code></strong></span>"。 字符类用于方括号中表示一系列的字符。</p><div class="sect4" lang="zh-CN"><div class="titlepage"><div><div><h5 class="title"><a name="regexes-examples"></a>例子</h5></div></div></div><div class="itemizedlist"><ul type="disc"><li>"<span class="bold"><strong><code class="code">bug ?#?[0-9]+</code></strong></span>": 文本 "<span class="emphasis"><em>bug</em></span>",零或一个空格,零或一个 “#” 字符,后面是一个或多个数字&#
12290;</li><li>"<span class="bold"><strong><code class="code">(http|ftp).+\.(jpg|png|gif)</code></strong></span>": 文本 "<span class="emphasis"><em>http</em></span>" 或 "<span class="emphasis"><em>ftp</em></span>",一或多个字符,一个点,后面是文本 "<span class="emphasis"><em>jpg</em></span>","<span class="emphasis"><em>png</em></span>" 或 "<span class="emphasis"><em>gif</em></span>"。</li><li>“<span class="bold"><strong><code class="code">http://.{120}[^ ]+</code></strong></span>”: 文本“<span class="emphasis"><em>http://</em></span>”,120 个字符,后面加一个或一个以上非空格的字符。</li></ul></div></div><div class="sect4" lang="zh-CN"><div class="titlepage"><div><div><h5 clas
s="title"><a name="regexes-external-ressource"></a>外部资源</h5></div></div></div><p>请参看 <a class="ulink" href="http://en.wikipedia.org/wiki/Regular_expression" target="_top">Wikipedia 上关于正则表达式的一篇文章</a>。</p></div></div><div class="sect3" lang="zh-CN"><div class="titlepage"><div><div><h4 class="title"><a name="command"></a>命令</h4></div></div></div><p>一个命令可以再次使用一个或多个正则表达式匹配到的内容。所匹配的内容可以使用 ”<span class="bold"><strong><code class="code">\<数字></code></strong></span>” 表示。<数字> 表示匹&
#37197;到的第几个内容或者用 0 表示全部匹配到的文本。</p><p>例如,下面一个简单的匹配模式 ”<span class="bold"><strong><code class="code">bug #(123)</code></strong></span>”,可以使用 ”<span class="bold"><strong><code class="code">\0</code></strong></span>” 表示文本 “bug #123” 或者 ”<span class="bold"><strong><code class="code">\1</code></strong></span>” 表示文本 “123”。对于命令 ”<code class="code">exo-open http://host/\1</code>”,实际执行的命令将会是 ”<code class="code">exo-open http://host/123</code>”z
90;</p></div></div><div class="sect2" lang="zh-CN"><div class="titlepage"><div><div><h3 class="title"><a name="xfconf"></a>Xfconf</h3></div></div></div><p>
+ Clipman uses Xfconf to store its settings. That allows you to change the settings with the tool
+ <strong class="application"><code>xfconf-query</code></strong> or <strong class="application"><code>xfce4-settings-editor</code></strong>. The channel is
+ <code class="constant">xfce4-panel</code> and the base property is <code class="constant">/plugins/clipman</code>. The following
+ table lists all the properties with their possible values:
+ </p><div class="table"><a name="id2924984"></a><p class="title"><b>表 2. Xfconf 属性</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Xfconf 属性" border="1"><colgroup><col xmlns=""><col xmlns=""><col xmlns=""><col xmlns=""></colgroup><thead xmlns=""><tr><th align="left">属性</th><th align="left">类型</th><th align="left">默认</th><th align="left">值</th></tr></thead><tbody xmlns=""><tr><td align="left">/settings/add-primary-clipboard</td><td align="left">布尔值</td><td align="left">假</td><td align="left">设置为真将同步主剪贴板中的内容到预设剪贴板中</td></tr><tr><td align="left">/settings/enable-actions</td><td align="left">布尔Í
40;</td><td align="left">假</td><td align="left">设置为真将允许动作</td></tr><tr><td align="left">/settings/history-ignore-primary-clipboard</td><td align="left">布尔值</td><td align="left">假</td><td align="left">设置为真将从历史中排除主剪贴板的内容</td></tr><tr><td align="left">/settings/max-images-in-history</td><td align="left">uint</td><td align="left">0</td><td align="left">0-5 个图像内容在历史中</td></tr><tr><td align="left">/settings/max-texts-in-history</td><td align="left">uint</td><td align="left">10</td><td align="left">5-100 个文本内容在历史中</td></tr><tr><td align="left">/settings/save-on-quit</td><td align="left">布尔值</td><td align="left">௩
5;</td><td align="left">设置为真将在每次新会话中恢复历史</td></tr></tbody></table></div></div><br class="table-break"><p>
+ To change a setting from a terminal type the command-line:
+ </p><code class="literal">xfconf-query -c xfce4-panel -p /plugins/clipman/<property> -s <value></code></div></div><div class="sect1" lang="zh-CN"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="support"></a>支持</h2></div></div></div><p>报告错误或者希望添加新的功能,请使用在 <a class="ulink" href="http://bugzilla.xfce.org/" target="_top">http://bugzilla.xfce.org/</a> 上的 bug 追踪系统。如果您在此软件的使用上有任何疑问,请在邮件列表 <a class="ulink" href="http://foo-projects.org/mailman/listinfo/xfce" target="_top">Xfce mailing list</a> 上发问,或者使用 IRC 客户ో
1;连接至 <span class="bold"><strong>irc.freenode.net</strong></span>,加入频道 <span class="bold"><strong>#xfce</strong></span> 寻求帮助。</p></div><div class="sect1" lang="zh-CN"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="about"></a>关于 Clipman</h2></div></div></div><p>Clipman 最初由 Eduard Roccatello 所编写,而后由 Nick Schermer 维护。现在的编写者是 Mike Massonnet (<code class="email"><<a class="email" href="mailto:mmassonnet at xfce.org">mmassonnet at xfce.org</a>></code>)。更多信息,请查看 <a class="ulink" href="http://goodies.xfce.org/projects/panel-plugins/xfce4-clipman-plugin" target="_top">Clipman 网站</a>。</p><p>这份文档由
; Mike Massonnet (<code class="email"><<a class="email" href="mailto:mmassonnet at xfce.org">mmassonnet at xfce.org</a>></code>) 撰写。请将您对这份文档的意见或建议发送到 <code class="email"><<a class="email" href="mailto:mmassonnet at xfce.org">mmassonnet at xfce.org</a>></code>。</p><p>此软件在自由软件基金会发布的 <em class="citetitle">GNU 通用公共许可协议</em> 条款约束下发布;协议的第二版或者(您可以选择)更新的版本。</p><p>您应该能够随此软件获得一份 <em class="citetitle">GNU 通&#
29992;公共许可协议</em>的副本;如果没有,请致信自由软件基金会: Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA.</p></div></div></body></html>
Added: xfce4-clipman-plugin/trunk/docs/manual/zh_CN/xfce4-clipman-plugin.xml.in
===================================================================
--- xfce4-clipman-plugin/trunk/docs/manual/zh_CN/xfce4-clipman-plugin.xml.in (rev 0)
+++ xfce4-clipman-plugin/trunk/docs/manual/zh_CN/xfce4-clipman-plugin.xml.in 2009-07-24 13:12:04 UTC (rev 7798)
@@ -0,0 +1,302 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+<!ENTITY app-author "Mike Massonnet">
+<!ENTITY app-email "mmassonnet at xfce.org">
+<!ENTITY app-website "http://goodies.xfce.org/projects/panel-plugins/xfce4-clipman-plugin">
+<!ENTITY doc-author "Mike Massonnet">
+<!ENTITY doc-email "mmassonnet at xfce.org">
+<!ENTITY date "April, July 2009">
+<!ENTITY application "@PACKAGE_NAME@">
+<!ENTITY version "@PACKAGE_VERSION@">
+<!ENTITY bugtracker "@PACKAGE_BUGREPORT@">
+]>
+<article id="xfce4-clipman-plugin" lang="zh_CN">
+
+ <!-- Header -->
+ <articleinfo>
+ <title>@PACKAGE_NAME@ æå</title>
+
+ <pubdate>&date;</pubdate>
+
+ <copyright>
+ <year>2009</year>
+ <holder>&doc-author;</holder>
+ </copyright><copyright><year>2009.</year><holder>Hunt Xu (huntxu at live.cn)</holder></copyright>
+
+ <legalnotice id="legalnotice">
+ <para>å¨èªç±è½¯ä»¶åºéä¼åå¸ç GNU èªç±æ档许å¯åè®®çæ¬ 1.3 æ以åçæ¬çæ¡æ¬¾çº¦æä¸å
许å¤å¶ï¼ååå/æä¿®æ¹æ¬ææ¡£ï¼ä¸è¦æ±ä¿çç¹å®å
容ãå°é¢ææ¬æè
å°åºææ¬ã许å¯åè®®å
¨æå¯ä»¥éè¿ä»¥ä¸é¾æ¥æ¾å°: <ulink type="http" url="http://www.fsf.org/">Free Software Foundation</ulink>ã</para>
+ </legalnotice>
+
+ <authorgroup>
+ <author>
+ <firstname>Mike</firstname>
+ <surname>Massonnet</surname>
+ <affiliation>
+ <address><email>mmassonnet at xfce.org</email></address>
+ </affiliation>
+ </author>
+ </authorgroup>
+
+ <releaseinfo>æ¤æåä»ç» @PACKAGE_NAME@ ï¼çæ¬ @PACKAGE_VERSION@ã</releaseinfo>
+ </articleinfo>
+
+
+ <sect1 id="intro">
+ <title>ç®ä»</title>
+
+ <para>
+ @PACKAGE_NAME@ is a clipboard manager for Xfce. It keeps the clipboard contents around while it is usually lost
+ when you close an application. It is able to handle text and images, and has a feature to execute actions on
+ specific text by matching them against regular expressions.
+ </para>
+
+ <sect2 id="anatomy-clipboard">
+ <title>åªè´´æ¿çåæ</title>
+
+ <para>å¨ X11 (ææç Unix å¹³å°) ä¸ï¼é»è®¤æ两个åªè´´æ¿ç¨ä»¥äº¤æ¢åçªå£é´çæ°æ®ãå
¶ä¸çä¸ä¸ªåªè´´æ¿(æ们称ä¹ä¸ºé¢è®¾åªè´´æ¿)ç¨ä»¥æå¨å¤å¶(ä¾å¦æ¨éæ©ä¸ä¸ªæ件ä¹åç¹å»å¤å¶æé®)ï¼èå¦ä¸ä¸ª(æ们称ä¹ä¸ºä¸»åªè´´æ¿)ç¨ä»¥éä¸å¤å¶(ä¾å¦æ¨éä¸å¨ææ¬æ¡ä¸çææ¬)ã</para>
+
+ <para>
+ @PACKAGE_NAME@ handles only the default clipboard, but optionnaly it can also notice the selections. When it is
+ handling the selections, the default clipboard will always be synced with it and contain the same data. By this
+ meaning you can paste with the keyboard what you select on screen.
+ </para>
+ </sect2>
+
+ <sect2 id="getting-started">
+ <title>å¼å§ä½¿ç¨</title>
+
+ <para>
+ @PACKAGE_NAME@ is used to keep in history a list of clipboard contents and to restore them. The history is
+ displayed in a menu by clicking on the main icon. Within the menu it is possible to restore a text and to clear
+ the history.
+ </para>
+
+ <figure>
+ <title>åªè´´æ¿èå</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/clipman-menu.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>ç¨ä»¥æ¾ç¤ºåå²çèå</phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+
+ <para>
+ There are two ways to run @PACKAGE_NAME at . You can select @PACKAGE_NAME@ in the applications menu under the category
+ Utility or type <application>xfce4-clipman</application> on the command-line, or you can add it into your panel.
+ To add a new item in the panel right click the panel and select âAdd new itemâ¦â.
+ </para>
+ </sect2>
+
+ <sect2 id="popup-command">
+ <title>å¼¹åºå½ä»¤</title>
+
+ <para>@PACKAGE_NAME@ æä¾ä¸ä¸ªå½ä»¤è¡å·¥å
· <application>xfce4-popup-clipman</application>ãå½å®è¢«æ§è¡æ¶å°å¼¹åºä¸»èåã使ç¨å¨ <menuchoice><guimenu>Xfce èå</guimenu><guimenu>设置</guimenu><guimenu>é®ç</guimenu></menuchoice> ä¸ç <emphasis role="bold">åºç¨ç¨åºå¿«æ·æ¹å¼</emphasis> å¯å¨è¯¥ç¨åºå°ä¼ååæ¹ä¾¿ã</para>
+ </sect2>
+
+ </sect1>
+
+
+ <sect1 id="settings">
+ <title>设置</title>
+
+ <para>éè¿å³é®ç¹å»ä¸»å¾æ ï¼å¹¶éæ©èåä¸çâå±æ§â项å¯ä»¥æå¼è®¾ç½®å¯¹è¯æ¡ãå®å
许æ¨è°èåªè´´æ¿åå²çç¸å
³å±æ§æè
ç¼è¾å¨ä½ã</para>
+
+ <sect2 id="general">
+ <title>常è§</title>
+
+ <para>以ä¸æ¯å¯ç¨é项çå表:</para>
+
+ <table frame="all"><title>设置对è¯æ¡ä¸ç常è§é项</title>
+ <tgroup cols="2" align="left">
+ <thead>
+ <row>
+ <entry>é项</entry>
+ <entry>æè¿°</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Sync selections</entry>
+ <entry>åæ¥ä¸»åªè´´æ¿çå
容å°é¢è®¾åªè´´æ¿ä¸ä»¥ç²è´´éä¸çå
容</entry>
+ </row>
+ <row>
+ <entry>ä»åå²ä¸æé¤</entry>
+ <entry>ä¸å°ä¸»åªè´´æ¿ä¸çå
容å å
¥å°åå²ä¸</entry>
+ </row>
+ <row>
+ <entry>ä¿å并éåº</entry>
+ <entry>å¨æ¯æ¬¡æ°ä¼è¯ä¸æ¢å¤åå²</entry>
+ </row>
+ <row>
+ <entry>ä¿åä¸å¹
å¾å</entry>
+ <entry>å
许å¨åå²ä¸ä¿åä¸å¹
å¾å</entry>
+ </row>
+ <row>
+ <entry>åå²å¤§å°</entry>
+ <entry>设置ä¿çå¨åå²ä¸çæ¡ç®æ°é</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <figure>
+ <title>åªè´´æ¿è®¾ç½®</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/clipman-settings-general.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>带æä¸è¬æ ç¾ç设置对è¯æ¡</phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+
+ </sect2>
+
+ <sect2 id="actions">
+ <title>å¨ä½</title>
+
+ <para>ä¸ä¸ªå¨ä½ç±ä¸ä¸ªâå¨ä½å称 - æ£å表达å¼â对ææãæ¯ä¸ä¸ªå¨ä½å¯ä»¥æ§è¡ä¸ä¸ªæä¸ä¸ªä»¥ä¸çå½ä»¤ã对å¨ä½çæ¯ææ¯ç¨åºçå¯é项ï¼æ¨è½å¤éè¿âå
许å¨ä½âé项å¯ç¨æç¦ç¨è¯¥æ¯æã</para>
+
+ <para>è¦æ·»å ä¸ä¸ªå¨ä½ï¼è¯·ç¹å»æ·»å å¾æ ï¼è¦ç¼è¾ä¸ä¸ªå¨ä½ï¼è¯·éæ©è¯¥å¨ä½å¹¶ç¹å»ç¼è¾å¾æ æè
ç´æ¥åå»è¯¥å¨ä½ï¼è¦å é¤ä¸ä¸ªå¨ä½ï¼è¯·éæ©è¯¥å¨ä½å¹¶ç¹å»å é¤å¾æ ãéæ©æ·»å æè
ç¼è¯ä¸ä¸ªå¨ä½ï¼ä¸ä¸ªæ°å¯¹è¯æ¡å°ä¼è¢«æå¼ã</para>
+
+ <para>
+ To learn more about actions go to <xref linkend="action-dialog"/>.
+ </para>
+
+ <figure>
+ <title>åªè´´æ¿è®¾ç½®</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/clipman-settings-actions.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>带æå¨ä½æ ç¾ç设置对è¯æ¡</phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+
+ </sect2>
+
+ <sect2 id="action-dialog">
+ <title>å¨ä½å¯¹è¯æ¡</title>
+
+ <para>
+ An action has a human readable name that describes the pattern it is going to match. An action must have at
+ least one command which also has a human readable name. The matched text can be reused in the command.
+ </para>
+
+ <para>
+ The actions are always matched against text selections unless specified otherwise. When the box âActivate only
+ on manual copyâ is checked, the action will be matched from the default clipboard (e.g. with Ctrl+C).
+ </para>
+
+ <figure>
+ <title>å¨ä½å¯¹è¯æ¡</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/clipman-action-dialog.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>å¨ä½ç¼è¾å¯¹è¯æ¡</phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+
+ <sect3 id="regexes">
+ <title>æ£å表达å¼</title>
+
+ <para>åºæ¬ç¹æ®å符: "<emphasis role="bold"><code>.?+*(|)[]\</code></emphasis>"ã</para>
+
+ <itemizedlist>
+ <listitem>â<emphasis role="bold"><code>.</code></emphasis>â: 代表任æå个å符ã</listitem>
+ <listitem>â<emphasis role="bold"><code>?+*</code></emphasis>â: åå«ä»£è¡¨é¶æä¸ä¸ªå符ï¼ä¸ä¸ªæä¸ä¸ªä»¥ä¸å符ï¼ä»¥åä»»æå¤ä¸ª(å
æ¬0个)å符ã</listitem>
+ <listitem>â<emphasis role="bold"><code>(|)</code></emphasis>â: å¨åç»åæ¿æ¢ä¸ï¼ç«çº¿(|)ç¨ä»¥è¡¨ç¤º âæâ ã</listitem>
+ <listitem>â<emphasis role="bold"><code>[^]</code></emphasis>â: å¨ä¸ç³»åå符æç¹æ®å符ä¸å¹é
ä¸ä¸ªå符æ¶ï¼â^â 符å·å¨å¼å¤´ä½¿ç¨è¡¨ç¤ºå¦å®ã</listitem>
+ <listitem>â<emphasis role="bold"><code>\</code></emphasis>â: å°ç¹æ®å符ä½ä¸ºæ®éå符è¿è¡å¹é
ã</listitem>
+ </itemizedlist>
+
+ <para>åºæ¬çåæ¯åæ°åå符类: "<emphasis role="bold"><code>A-Za-z0-9</code></emphasis>"ã å符类ç¨äºæ¹æ¬å·ä¸è¡¨ç¤ºä¸ç³»åçå符ã</para>
+
+
+ <sect4 id="regexes-examples">
+ <title>ä¾å</title>
+
+ <itemizedlist>
+ <listitem>"<emphasis role="bold"><code>bug ?#?[0-9]+</code></emphasis>": ææ¬ "<emphasis>bug</emphasis>"ï¼é¶æä¸ä¸ªç©ºæ ¼ï¼é¶æä¸ä¸ª â#â å符ï¼åé¢æ¯ä¸ä¸ªæå¤ä¸ªæ°åã</listitem>
+ <listitem>"<emphasis role="bold"><code>(http|ftp).+\.(jpg|png|gif)</code></emphasis>": ææ¬ "<emphasis>http</emphasis>" æ "<emphasis>ftp</emphasis>"ï¼ä¸æå¤ä¸ªå符ï¼ä¸ä¸ªç¹ï¼åé¢æ¯ææ¬ "<emphasis>jpg</emphasis>"ï¼"<emphasis>png</emphasis>" æ "<emphasis>gif</emphasis>"ã</listitem>
+ <listitem>â<emphasis role="bold"><code>http://.{120}[^ ]+</code></emphasis>â: ææ¬â<emphasis>http://</emphasis>âï¼120 个å符ï¼åé¢å ä¸ä¸ªæä¸ä¸ªä»¥ä¸éç©ºæ ¼çå符ã</listitem>
+ </itemizedlist>
+ </sect4>
+
+ <sect4 id="regexes-external-ressource">
+ <title>å¤é¨èµæº</title>
+
+ <para>请åç <ulink type="http" url="http://en.wikipedia.org/wiki/Regular_expression">Wikipedia ä¸å
³äºæ£å表达å¼çä¸ç¯æç« </ulink>ã</para>
+ </sect4>
+ </sect3>
+
+ <sect3 id="command">
+ <title>å½ä»¤</title>
+
+ <para>ä¸ä¸ªå½ä»¤å¯ä»¥å次使ç¨ä¸ä¸ªæå¤ä¸ªæ£å表达å¼å¹é
å°çå
容ãæå¹é
çå
容å¯ä»¥ä½¿ç¨ â<emphasis role="bold"><code>\<æ°å></code></emphasis>â 表示ã<æ°å> 表示å¹é
å°ç第å 个å
容æè
ç¨ 0 表示å
¨é¨å¹é
å°çææ¬ã</para>
+
+ <para>ä¾å¦ï¼ä¸é¢ä¸ä¸ªç®åçå¹é
æ¨¡å¼ â<emphasis role="bold"><code>bug #(123)</code></emphasis>âï¼å¯ä»¥ä½¿ç¨ â<emphasis role="bold"><code>\0</code></emphasis>â 表示ææ¬ âbug #123â æè
â<emphasis role="bold"><code>\1</code></emphasis>â 表示ææ¬ â123âã对äºå½ä»¤ â<code>exo-open http://host/\1</code>âï¼å®é
æ§è¡çå½ä»¤å°ä¼æ¯ â<code>exo-open http://host/123</code>âã</para>
+ </sect3>
+ </sect2>
+
+ <sect2 id="xfconf">
+ <title>Xfconf</title>
+
+ <para>
+ @PACKAGE_NAME@ uses Xfconf to store its settings. That allows you to change the settings with the tool
+ <application>xfconf-query</application> or <application>xfce4-settings-editor</application>. The channel is
+ <constant>xfce4-panel</constant> and the base property is <constant>/plugins/clipman</constant>. The following
+ table lists all the properties with their possible values:
+ </para>
+
+ <table frame="all"><title>Xfconf å±æ§</title>
+ <tgroup cols="4" align="left">
+ <thead>
+ <row>
+ <entry>å±æ§</entry>
+ <entry>ç±»å</entry>
+ <entry>é»è®¤</entry>
+ <entry>å¼</entry>
+ </row>
+ </thead>
+ <tbody><row><entry>/settings/add-primary-clipboard</entry><entry>å¸å°å¼</entry><entry>å</entry><entry>设置为çå°åæ¥ä¸»åªè´´æ¿ä¸çå
容å°é¢è®¾åªè´´æ¿ä¸</entry></row><row><entry>/settings/enable-actions</entry><entry>å¸å°å¼</entry><entry>å</entry><entry>设置为çå°å
许å¨ä½</entry></row><row><entry>/settings/history-ignore-primary-clipboard</entry><entry>å¸å°å¼</entry><entry>å</entry><entry>设置为çå°ä»åå²ä¸æé¤ä¸»åªè´´æ¿çå
容</entry></row> å <row><entry>/settings/max-images-in-history</entry><entry>uint</entry><entry>0</entry><entry>0-5 个å¾åå
容å¨åå²ä¸</entry></row><row><entry>/settings/max-texts-in-history</entry><entry>uint</entry><entry>10</entry><entry>5-100 个ææ¬å
容å¨åå²ä¸</entry></row><row><entry>/settings/save-on-quit</entry><entry>å¸å°å¼</entry><entry>ç</entry><entry>设置为çå°å¨æ¯æ¬¡æ°ä¼è¯ä¸æ¢å¤åå²</entry></row></tbody>
+ </tgroup>
+ </table>
+
+ <para>
+ To change a setting from a terminal type the command-line:
+ </para>
+
+ <literal><![CDATA[xfconf-query -c xfce4-panel -p /plugins/clipman/<property> -s <value>]]></literal>
+ </sect2>
+ </sect1>
+
+ <sect1 id="support">
+ <title>æ¯æ</title>
+
+ <para>æ¥åé误æè
å¸ææ·»å æ°çåè½ï¼è¯·ä½¿ç¨å¨ <ulink type="http" url="@PACKAGE_BUGREPORT@">@PACKAGE_BUGREPORT@</ulink> ä¸ç bug 追踪系ç»ãå¦ææ¨å¨æ¤è½¯ä»¶ç使ç¨ä¸æä»»ä½çé®ï¼è¯·å¨é®ä»¶å表 <ulink type="http" url="http://foo-projects.org/mailman/listinfo/xfce">Xfce mailing list</ulink> ä¸åé®ï¼æè
ä½¿ç¨ IRC 客æ·ç«¯è¿æ¥è³ <emphasis role="bold">irc.freenode.net</emphasis>ï¼å å
¥é¢é <emphasis role="bold">#xfce</emphasis> 寻æ±å¸®å©ã</para>
+ </sect1>
+
+
+ <sect1 id="about">
+ <title>å
³äº @PACKAGE_NAME@</title>
+
+ <para>@PACKAGE_NAME@ æåç± Eduard Roccatello æç¼åï¼èåç± Nick Schermer ç»´æ¤ãç°å¨çç¼åè
æ¯ Mike Massonnet (<email>mmassonnet at xfce.org</email>)ãæ´å¤ä¿¡æ¯ï¼è¯·æ¥ç <ulink type="http" url="http://goodies.xfce.org/projects/panel-plugins/xfce4-clipman-plugin">@PACKAGE_NAME@ ç½ç«</ulink>ã</para>
+
+ <para>è¿ä»½ææ¡£ç± Mike Massonnet (<email>mmassonnet at xfce.org</email>) æ°åã请å°æ¨å¯¹è¿ä»½ææ¡£çæè§æ建议åéå° <email>mmassonnet at xfce.org</email>ã</para>
+
+ <para>æ¤è½¯ä»¶å¨èªç±è½¯ä»¶åºéä¼åå¸ç <citetitle>GNU éç¨å
Œ
±è®¸å¯åè®®</citetitle> æ¡æ¬¾çº¦æä¸åå¸ï¼åè®®ç第äºçæè
(æ¨å¯ä»¥éæ©)æ´æ°ççæ¬ã</para>
+
+ <para>æ¨åºè¯¥è½å¤éæ¤è½¯ä»¶è·å¾ä¸ä»½ <citetitle>GNU éç¨å
Œ
±è®¸å¯åè®®</citetitle>çå¯æ¬ï¼å¦æ没æï¼è¯·è´ä¿¡èªç±è½¯ä»¶åºéä¼: Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA.</para>
+ </sect1>
+
+</article>
More information about the Goodies-commits
mailing list