# Conduit 手册

Conduit 是一个同步东西的程序

2007
John Stowers
2009
YunQiang Su (wzssyqa@gmail.com)
GNOME 文档工程
John
Stowers
Brent
Gueth
Conduit 手册 1.0 版
2008-01-03
此手册描述 1.0 版的 Conduit

## 什么是 Conduit

Conduit 是一个为 GNOME 设计的同步程序。它使您可以同步您的文件、照片、电子邮件、通信录、便签、日程表数据和其它任何类型的私人信息，并且同步那些数据到其它计算机、在线服务甚至其它电子设备。Conduit 管理这些同步和到其它格式的转换。例如，Conduit 使您可以；

- 与其它电脑同步您的 Tomboy 便签

- 同步您的个人信息管理器数据到您的移动电话、 iPod、>, 诺基亚网络终端、

- 上传照片到 Flickr，Picasa，Smugmug，Shutterfly 和您的 iPod

- ...还有许多

任何您可以想像到的组合，Conduit 都可以作转换和同步。

### Use Cases

- Fred 想要与 Google 便签 同步他的 tomboy 便签

- Joey 想要同步他台式机上的所有东西到他的 backpack 账户

- Nellie 想保持他笔记本和台式机上的一个目录同步

- Paul 想要是他的 evolution 通信录和他的移动电话同步

- Steve 想要使他的两台计算机上的 GNOME 首选项同步

- John 想要同步一个 OpenOffice 文档目录和在 Google Docs 上的一个副本保持同步

- Pete 想要使存放在他服务器上的照片推送到一个外部备份 (USB 硬盘或站外 ftp)

### 导言

Conduit 的目标是尽可能无缝地从移动设备或远程站点同步您的数据。这就是要尽可能如您所愿地扩展您的生活，不再受数据，设备或格式的束缚。Conduit 可以在您希望的时候将您的数据带到任何您想要的地方。您所有的移动电话都可以使用 Conduit 自动同步。什么？备份本地数据到远程服务器？自动地。

有时 Conduit 好像过于复杂，设计目标中的一项就是总是使界面尽可能简洁、直观。但是 Conduit 比这种简单化设计所能实现的强大的多。此文档将描述对于组和数据源的所有配置选项，而且下边给出了一些您可能希望同步的条目的例子；

- 一位 GNOME 用户可能将信息存放于桌面的多个地方，包括；

  - Evolution (电子邮件，日程表，通信录)

  - Tomboy (便签)

  - 目录 (重要文件)

  - 照片

  - 书签 (网页和订阅)

  - 音乐

- 用户可能使用一个或多个流行的在线服务，包括

  - Delicious (书签)

  - Gmail (书签，日程表，接收点，电子邮件，照片)

  - Flickr (照片)

- 他们也可能拥有其它电子设备，比如

  - 第二台笔记本，也运行 GNOME

  - 移动电话

  - A Nokia 770/800

  - A Palm 或 Windows Mobile Pocket PC

  - iPod

Its hard enough keeping your information organized when limited to the desktop, let alone the added burden of keeping your information in sync with any of the other services or devices listed above.

Conduit 的一个目标是使 GNOME 用户保持他们的信息同步。无论类型，无论信息的存放方式。Conduit 都可以工作。

## 理解 Conduit 界面

### 导言

Conduit 有一些在您开始之前值得理解的基本概念。了解这些概念有助于您了解一些您从未了解的使您可以使用同步的事情，例如，正确地从您的移动电话上传到 Picasa。

#### Conduit 图形界面

Conduit 图形界面的组成部分

展示了 Conduit 界面的四个主要组件；

1. 菜单

   - 文件、编辑和帮组菜单存放了适用于所有组的操作。要获取更多关于这些菜单内容的信息，往下看。

2. 数据源嵌板

   - 定位于窗口的左边，列出在您系统上所有探测出并且准备好使用的数据源。

   - 数据源是您要同步的数据的来源或目的地。请参考本文档的 数据源 节以获取怎样配置每个数据源的指导。

3. 画布嵌板

   - Used to create groups of data providers to synchronize. Drag a data source to the left of the canvas pane and one or more data sinks to the right of the data pane to create a group. For more explanation on groups please check .

4. 冲突嵌板

   - 如果在您尝试运行一个同步作业时收到了冲突提示，他们将在此处列出。要获取关于怎么样处理可能的冲突，请查看本文档的 冲突及其解决 节。

### 菜单

#### 文件菜单

- 文件保存 所有已配置的同步组。如果您已经在 中选择了 退出时保存设置 ，则组将在退出 Conduit 时自动保存。

- 文件同步所有同时同步所有组。您仍然可以继续分开地运行每一个组的同步(参看 Groups 节)

- 文件退出 关闭 Conduit。将会提示您停止任何当前正在进行的同步。

#### 编辑菜单

- Edit Clear Canvas Removes all configurations, data providers, and groups from the canvas pane. This allows you start using the canvas as it was a clean slate. The best time to use this is when you are re-configuring a large portion of your sync groups. There is no quick way to revert back after selecting this setting.

- 编辑首选项 全局 Conduit 设置，其影响您所有的同步组和 Conduit 基本操作。要获取更多信息，请查看

#### 帮助菜单

- 帮组开发人员 如果您是开发人员，并且对贡献 Conduit 感兴趣，此选项包含所有相应文档的链接。

- 帮组内容 显示此帮助文档。

- Help About显示版本号和 Conduit 开发人员列表。

### 首选项窗口

使用编辑菜单进入 Conduit 首选项。在此首选项中的设置或更改影响您所有的同步组和 Conduit 基本操作。

#### 配置标签

配置标签是配置 Conduit 的所有全局设置的地方。有六个全局设置：

- 退出时保存设置

  指示 Conduit 退出时保存所有已经配置的数据源和组。

- 显示状态图标

  在通知区域显示一个状态图标。此图标指示一个同步正在进行。

- 缩小到通知区域

  指示 Conduit 最小化到通知区域而不是面板。

- 使用内置的网页浏览器

  当一个数据源要求您登录一个网站时，此选项告诉 Conduit 使用其内置的网页浏览器。

- 当一个条目被删除时

- 当有双向冲突时

#### 数据源标签

此标签列出当前安装的数据源。

#### 数据转换标签

此标签列出 Conduit 可以执行的数据转换。

#### 映射数据库

This is a list of the UID that Conduit uses to maintain accurate sync data from different sources. Here you have the option to clear the mapping database.

### 网页登录窗口

Sometimes you will be required to log into a website associated with certain data providers. The frequency at which you may have to log in is not determined by Conduit, but by the security policy of the respective data provider. For example, Box.net requires you to log in every time Conduit is run, whereas Flickr only requires you to log in once, to give permission to Conduit to upload photos. If you are required to log into a website, and you have selected the Use Built in Web Browser from the Conduit preferences, then a window will pop up like the one shown below.

#### Conduit 登录窗口

此窗口在登录数据源站点时显示

### 数据源和组

Conduit 图形化的表示您想要同步的东西。当数据源添加到画布时，他们分为所谓的组。一个组是一些共享数据的数据源的集合。在下边的图片中，您可以看到如下部分

#### Conduit 形象地表示同步

同步组的一部分

1. A data provider for synchronizing two way whose status indicates that it is ready to be synchronized.

2. A group containing two folder dataproviders. The arrow has two ends, indicating that the two dataproviders will undergo a two way synchronization, that is data will flow in both directions, and both folders will contain the same information once the sync finishes.

3. A second folder data provider. By convention, data providers that lie on the right side of groups are called data sinks. This is because during a one way sync, data can only flow into them.

4. Facebook 和 Picasa 数据源表示向这些站点上传图像。注意，此组有三个数据源，并且箭头已经被更改以指示数据只单向流动，即图像将从 F-Spot 上传到 Facebook 和 Picasa。

## 正在同步某些东西

此节描述同步两个数据源所需要的步骤。此例给出怎样同步两个文件夹，但是此概念可以应用于您想同步的任何东西。如果您需要更多的关于特定设置的信息，请参考本文档的相应章节。

### 导言

包含两个组。此节描述重新创建组的步骤。

- 顶部的组表示两个目录间的双向同步

- 底部的组表示图像的单向同步，从 F-Spot 到 Facebook 和 Picasa 网络相册。

### 例 1：同步两个目录

下述的步骤将重新创建在上边图像中显示为 #1 的双向同步组。

1. 在您的桌面上创建三个名为 folder1 、folder2 和 folder3 的目录。拖动您选择的文件到 folder1。

2. 启动 Conduit

3. 位 folder1 添加数据源

   从数据源嵌板拖动文件夹数据源并且在画布嵌板的左侧释放它。这将作为我们将要同步的数据来源。

4. 配置 folder1

   双击你最近拖动到画布的数据源。将带您到类似如下显示的文件夹设置。向名称域输入一些易记的东西并且更改文件夹位置到您第一步中创建的文件夹。

   #### 正在配置目录 1

5. 为 folder2 添加数据源

   Drag another folder data provider from the pane on the left. This time drop it adjacent to the folder1 dataprovider. This should result in an arrow connecting it to folder1 being created.

6. 配置 folder2

   Configure the data provider so that its Folder Location points to folder2 on the desktop, and importantly, its Folder Name is the same as that entered in step #4.

7. 配置同步参数

   Right click on the associated group, and under sync options, select a two way sync. Since this is just a basic run through on how to setup a sync we are not going to go through any advanced syncing options in this section of the documentation. If you wish more information on the options available, please see .

8. 同步两个目录可以在其上右击并选择同步，或从文件菜单操作。同步完成后，您应该可以看到您放置在您台式机上的 folder1 中的文件已经位于 folder2 中。

### 例 2：导出图像到多个目标

The second group shown in shows a single F-Spot data source exporting its photos to two data sinks, a Facebook one, and a Picasa one.

1. 启动 Conduit

2. 启动 F-Spot

3. Drag a F-Spot data provider from the data provider pane and drop it onto an empty spot on the canvas. A new group containing just the F-Spot data provider will be created.

4. 拖动 Facebook 和 Picasa 数据源到刚刚创建的组。

5. 通过在其上双击配置数据源。

6. 现在同步此组以上传照片。您将被提示使用在 中显示的 Conduit 登录窗口登录 Facebook。

### 总结

所有的同步操作都完全按这样工作。仅仅的不同是您同步的数据和您使用的数据源。

1. 添加数据源以创建一个新组，或到一个现有的组。

2. 配置数据源。每个数据源要求一个唯一的配置。要获得与此有关的参考参看本文档的 Data Providers 节。

3. 配置组，选择在发生冲突等情况时要怎么做。

4. 按您的愿望同步数据源

## 网络同步

如果您家中有两台计算机，Conduit 可以用于在它们之间同步数据，直接地，不需要首先将数据存放在其它地方。下述的步骤将说明怎样同步两台分别称为 nzjrs-desktop 和 nzjrs-laptop 的计算机上的 Tomboy 便签。如下关键词将用于帮组解释设置过程。

- 图像 来自第一台计算机。

- 图像 来自第二台计算机。

### 网络同步小贴士

The process below, although describing Tomboy note synchronization, could be suitably modified to synchronize all sorts of data between two computers, including Contacts, Calendar information, and even F-Spot photos.

1. On the first computer create a synchronization group connecting Tomboy to the Network dataprovider, which is listed in the Miscellaneous category in the dataprovider pane. This makes Tomboy available for synchronization on the second computer.

   ### 第一台计算机的配置

2. After a short delay, this will result in a new category being created on the second computer. The category will take the name of the first computer, nzjrs-desktop in my case, and it shall contain any dataproviders currently available for synchronization.

3. Still on the second computer, drag the Tomboy dataprovider from the newly created category onto the canvas. Notice how its name is Remote Tomboy, indicating it refers to data on the remote, or first, computer.

   ### 第二台计算机的配置

4. 最后，在第二台计算机上，以普通方式启动同步。

5. 现在，您的两台计算机上的 tomboy 便签应该已经同步了。

### 文件同步

鉴于性能和安全原因，我们不推荐通过网络同步功能在两台计算机之间同步大量数据。我们希望将来设置这项限制。