twidge - 云端在线

程序：

您的姓名

twidge - Twitter，Identica 的微博客户端

概要

tw [ -d [ -c 文件 ] 命令 [ 命令参数 ]

tw - 帮帮我

商品描述

tw 是 Twitter 等微博网站的客户端http://twitter.com/>和
同一性http://identi.ca/> (identi.ca)。 微博网站让你发短文——
段落更新，关注好友发布的更新，与大家互动
在网站中的对话风格。

tw 是一个客户端，使与微博站点的工作更快更容易。 这是
用途广泛，可以根据您想要的工作方式进行定制，并结合使用
与其他工具一起做几乎任何事情。

tw 可以很好地从 shell 交互使用。 它直接有用，因为-
是，并且使用简单的 shell 别名可以使一个高效的系统准确地执行什么操作
你要。 它完全有能力成为您唯一的微博客户端。

tw 也可以自动使用，通过 cron的(1)，或者它甚至可以与
您的电子邮件系统。

完整清单 tw 功能，以及关于如何使用它的许多建议，可以
在找到 tw 网站在http://software.complete.org/twidge>.

但是，如果您想立即开始，请跳到下面的“快速入门”部分。 为了
现在，我将总结一些 tw 特征; 网站上有更全面的清单。

特点 清单
· 方便、易学、快捷的命令行界面（做起来简单
东西，高级的东西是可能的）

· 这本内容丰富的手册，以及网站上的大量示例

· 兼容任何实现 Twitter API 的微博服务。 测试过
Twitter 和 Identica (identi.ca)。 应该与任何其他系统兼容。

· 全力支持阅读好友的活动、回复你的、以及你自己的
活性。

· 可选择的功能来记住您已经看到的内容并抑制这些更新
未来运行。

· 可选的通过 is.gd 自动缩短长 URL

· 与您的电子邮件系统的可选集成——通过电子邮件发送和接收更新。

· 专门设计用于在shell 脚本中友好使用。

· Shell 脚本可以很容易地做很多事情，比如安排未来的更新（使用
at)，忽略某些更新（与 grep的）等

· 通过多个配置文件轻松使用多个帐户。 机制
适合 shell 别名和工具。

· 小巧、极简的占地面积

· 输出格式很容易解析。 输入格式很容易生成。 配置
文件格式自由且易于生成。

· 强大的错误检测和恢复能力。

快 主页

本节将描述如何首次 tw 用户可以快速启动和运行。
它假设你已经有了 tw 编译或安装在您的系统上。 如果没有，请
按照说明进行操作 载点 源文件中的文件。

要开始，只需运行 tw 格局 在您的 shell 提示符下。 tw 会带领你
通过首次配置——非常快速且完全自我
解释！

现在，让我们开始探索。 tw 最近 -苏 将向您展示 20 个最近的更新
来自你关注的人。 第一次之后，它会记住你所看到的和
只显示新的更新。 代替 最近，你可以替换 回复 回复
给你。 你也可以运行 tw 最近 - 帮帮我，或参阅此文档，了解更多信息
命令的详细信息。 简而言之，-s 告诉系统保存您所看到的内容，而 -u
告诉它只显示你看不见的项目。

您可以通过运行订阅朋友的更新 tw 遵循 缺口. 订阅
更新 tw 本身，你会跑 tw 遵循 unixtwedge. 如果你受够了
来自某人的更新，只需使用 tw 取消关注 命令。

现在，发布您自己的更新怎么样？ 只需输入 tw 更新. 输入您的更新，然后
完成后按 Enter。 您的更新可能会滚动到屏幕末尾； 别担心
关于它。 在完成之前不要按 Enter 键。 您还可以在
命令行，如果它包含空格或 shell 字符，请注意引用它。

这就是快速游览。 有关更多示例，请参阅网站。

配置

tw 总是使用特定操作的名称调用，例如 更新 or
最近。在 tw，这些操作被称为 命令. 每个命令都有自己的
选项，在命令之后给出 tw 命令行。 完整的总结
每个命令的选项在本手册后面给出。

您可以获得所有命令的列表 tw ls命令. 任何人都可以获得帮助
个人命令 tw 命令 - 帮帮我. 全球帮助可用 tw
- 帮帮我.

全球 配置
可以指定这些选项 before 任何命令。

-c 文件

--配置=文件
默认情况下， tw 使用 ~/.twiggerc 用于配置。 使用此选项，您可以
指定备用文件。 tw 将从它读取配置信息。 在
某些情况下， tw 也会写信给它，比如 tw 格局 命令，
或 ls 命令之一的 -s 选项。

-d

-调试
启用调试输出。 此详细输出可帮助您了解 tw 是在做
并诊断您可能遇到的任何问题。

指令 IN 拨动

tw 有许多不同的命令。 使用时必须指定命令 tw。 这
部分将详细讨论每个命令。 请注意，所有命令都区分大小写
并且应该是 特定 in 小写.

所有命令都支持该选项 - 帮帮我。 跑步 tw 命令 - 帮帮我 将显示
有关命令及其选项的信息。 由于所有命令都支持这一点，因此不会
为下面的每个命令明确列出。

指令 TO 显示屏玻璃制造 的UPDATE

tw ls* [ -a [ -l [ -s [ -u ]

多个命令可以显示来自您自己或其他人的更新。 他们都有一个共同点
语法和通用选项集。 命令是 LSDM, lsd存档, 最近,
回复及 回复. 以下是常用选项：

-a

- 全部 通常，微博站点返回一页结果——通常是 20 或 100
结果，取决于操作。 指定 --all 请求 tw 至
不断地向微博站点发送请求，直到它收到一整套
的信息。 通常这是一个坏主意，但是当与 -u 结合使用时
-- 特别是如果您之前使用过 -s -- 它可能是一种对所有人进行轮询的有用方法
新的更新。

如果不小心使用，此命令会向服务器生成许多请求，并且
可以使用大量带宽。 微博网站有流量
限制，并且不会对此表示友好。 使用 --all 时要小心。

-e 命令

--执行=命令
导致任何正常输出被抑制。 相反，对于每个项目
检索到，调用给定的命令。 该命令将恰好传递四个
论据。 在 shell 脚本中使用它们时应该小心，因为
shell 元字符存在的可能性。 论据是：

1. 给定更新的更新 ID。

2. 创建更新的用户名

3. 用于在电子邮件中表示更新的建议消息 ID。 包含
括起尖括号。

4. 更新文本本身。 可能包含空格和其他 shell 元字符。

-l

- 长 默认输出格式显示昵称和消息，格式很好
展示。 使用此选项会导致输出包括以下列：消息 ID、
发件人昵称、收件人昵称（除非是直接消息，否则为空）、更新文本和日期
创建。 输出格式适合机器解析。 水平标签
字符 \t 分隔列，并保证不会出现在其他任何地方。 它
还保证使用 -l 时 \n 不会出现在一行内的任何地方。

所呈现的列预计将保持稳定。 然而，额外的
在以后的版本中，可以将列添加到这些列的右侧 tw.
行为良好的解析器应该准备好丢弃右侧的任何多余列
本文件中指定的那些。

-m 地址

--mailto=地址
导致任何正常输出被抑制。 相反，对于每个项目
检索，生成电子邮件并将其发送到给定的地址。 主题行
将包含发件人昵称和文本的前 30 个字符。 身体
将包含整个文本。 该消息是使用列出的程序发送的
配置文件中的sendmail。 如果配置中列出了mailfrom
文件，它被列为发件人地址，发件人的姓名列为
从评论。

生成并包含用于唯一标识此更新的消息 ID。
此外，将添加以 X-Twidge- 开头的标题，以及各种元数据。

应该注意的是，一个简单的脚本可以与 --exec 一起使用来实现这一点
相同的目的，但具有更大的灵活性。 该功能内置于 tw
也是为了方便。

-s

--保存
使用 -u 保存最近获取的消息的 ID 以备将来使用。 需要
对配置文件的写访问权限。

-u

- 看不见
使命令仅显示自上次使用 -s 与此特定
命令。 如果 -s 之前从未与此命令一起使用，则无效。

其中一些选项放在一起没有意义； 例如，--long、--exec 和
--mailto 是互斥的。 如果您使用此类选项，则结果未定义
同时进行。

LSDM
列出发送给您的直接消息。 注意：identi.ca 不支持直接消息，并且
这将导致该服务出错。

LSDMA存档
列出您已发送的直接消息。 注意：identi.ca 不支持直接消息，
并且此命令将导致该服务出错。

最近
列出您或您关注的人最近发表的帖子。

回复
列出微博站点上任何人最近对您的回复。

LSRT回复
列出其他人对您的状态的转发。

注意：identi.ca 不支持新式转发，并且会在此返回错误
命令。

指令 TO 显示屏玻璃制造 其他 相关信息

这些命令像其他命令一样使用 --all 和 --long，但不使用 --saveid
或 --unseen，因为这些选项没有意义。

追随者
tw 关注者 [ 选项 [ 用户名 ]

将减慢跟随您的人的列表。 如果给定一个可选的用户名，则显示人员
跟随那个用户。 如果给出 --long，则显示每个人的 ID。 你可能需要
使用 --all 获取完整列表，但这同样可能会产生大量流量。

关注
tw 正在关注 [ 选项 [ 用户名 ]

显示您关注的人的列表。 参数和动作与 with 相同
lsfollowers。

活动正式启动 指令

这些命令在服务器上执行操作。

发送
tw 发送 接受者 [ 状态 ]

原因 tw 向指定的收件人发送新的直接消息。 如果一个状态是
在命令行上给出，它必须作为单个参数提供给 tw 通过使用
如果需要，shell 引用。 如果命令行上没有给出任何状态，则单行将
从标准输入读取并用作状态。

各种微博网站更新的最大长度为140个字符。 抽动
如果您的更新尝试超过该长度，则会因错误而中止。

默认情况下，Twidge 将尝试通过 URL 缩短来缩短更新中的 URL
服务，但前提是您的更新长度超过 140 个字符。 这意味着长网址
短于 140 个字符将不会被缩短。

如果你希望所有的 URL 都被缩短而不管它们的长度，那么
在配置文件的 [DEFAULT] 或 [dmsend] 部分中设置缩短所有 = yes。

您可以通过在 [DEFAULT] 或
[dmsend] 配置文件的部分。

跟随
tw 遵循 用户名

这个命令会导致 tw 请求微博站点添加给定的
用户名添加到您关注的人员列表中。 尝试添加被认为是错误的
你已经关注的人。

设置
tw 格局

进入交互式首次设置工具。

取消关注
tw 取消关注 用户名

这个命令会导致 tw 要求微博网站删除给定的
您关注的人列表中的用户名。 尝试将被视为错误
删除您不关注的人。

更新
tw 更新 [ -i 消息标识符 | --回复 消息标识符 [ 状态 ]

tw 更新 -r

原因 tw 将新状态发布到服务器。 如果在命令上给出状态
行，它必须作为单个参数提供给 tw 通过使用 shell 引用 if
需要。 如果命令行上没有给出状态，将从 stdin 中读取一行
并用作状态。

各种微博网站更新的最大长度为140个字符。 抽动
如果您的更新尝试超过该长度，则会因错误而中止。

默认情况下，Twidge 将尝试通过 URL 缩短来缩短更新中的 URL
服务，但前提是您的更新长度超过 140 个字符。 这意味着长网址
短于 140 个字符将不会被缩短。

如果你希望所有的 URL 都被缩短而不管它们的长度，那么
在配置文件的 [DEFAULT] 或 [dmsend] 部分中设置缩短所有 = yes。

您可以通过在 [DEFAULT] 或
[dmsend] 配置文件的部分。

当给出 -r 时， tw 期望在标准输入中读取 RFC2822 电子邮件消息。 的身体
该消息将用作更新的内容。 的参考标题
消息将被简要扫描，如果合适，更新的回复属性
将反映其中提到的 Message-ID。 这样，如果您使用 tw 最近
--mailto 将最近的项目通过电子邮件发送给您，然后使用您的电子邮件回复按钮回复它们，
tw 将在 Twitter 上链接两者。 即使您省略@reply，也可以完成此链接，
但可能会让很多人感到困惑，因为大多数其他客户无法做到这一点。 你应该
仍然包括@reply。

应该指出的是，为了尽量减少规模和复杂性， tw 有一个
非常简单的电子邮件解析器。 您应该只发送纯文本消息。 不使用
HTML、RTF、附件或任何会导致 MIME 标头出现在 RFC2822 中的内容
身体。 您可能还想关闭您的签名。 tw 将转换换行符
处理消息正文时将字符转换为空格。

当给定 -i 时，预期会传递消息的内部 Twitter ID。 这个
在 Twitter 上适当地设置“回复”标志。

其他 指挥

LS命令
tw ls命令

此命令将显示所有可用的列表 tw 命令以及简短的
每个的描述。

拨动 配置 文件

tw 有一个配置文件，您可以在其中设置各种选项。 这个文件一般
生活在 ~/.twiggerc.

配置文件有多个部分。 每个部分都有一个名称并进行介绍
括号中的名称。 每个部分都有一个或多个选项。

名为 DEFAULT 的部分的特殊之处在于它提供了将使用的默认值
每当在不同部分下找不到选项时。 如果没有指定节
名称，DEFAULT 是假定的部分。 某些项目，例如 urlbase，被假定在
默认。

让我们从查看示例文件开始，然后继续检查所有选项
可用。

[默认]

; 如果您的密码包含百分号 (%)，请列出两次 (%%)

; 服务器 API 接口的路径——没有尾部斜杠
urlbase = https://twitter.com

缩短网址 = 是

; 不同命令看到的最后一个 ID。 用 -s 写入。

[最近]
最后一个 = 914881241

每当 tw 查找有关特定选项的信息，它首先检查是否
它可以在该选项的部分中找到该选项。 如果没有，它会检查 DEFAULT
部分。 如果它仍然没有找到答案，它会参考其内置的默认值。

一般 配置
这些在 DEFAULT 部分。

服务器库
用于访问微博站点 API 的基本 URL。 这应该包含
服务器名称，但不是 API 路径。 默认值为 https://api.twitter.com。 为了
Identica，你会用 http://identi.ca/api （请注意，如果某些用户遇到问题
尝试将 SSL 与 identica 一起使用）。

网址库
访问微博站点API的URL。 默认值，%(serverbase)s/1
是为推特。 要使用 Identica，您需要指定 %(serverbase)s。 不要放一个
此选项的尾部斜杠。

oauth请求令牌
用于访问 oAuth 请求令牌接口的 URL。 默认情况下，
%(serverbase)s/oauth/request_token，适用于大多数环境。

oauth访问令牌
oAuth 访问令牌 URL。 默认为 %(serverbase)s/oauth/access_token。

oauth 授权
oAuth 授权 URL。 默认为 %(serverbase)s/oauth/authorize。

oauth消费者密钥
oAuth 消费者密钥。 Twidge 已在 Twitter 和 identi.ca 上注册，并将
根据 urlbase 的内容为这两个提供合理的默认值。

oauth消费者秘密
oAuth 消费者秘密。 与 oauthconsumerkey 一样提供了默认值。

验证数据
自动写入 tw 格局. 不要改变。

执行命令 配置
这些选项可以在 DEFAULT 或在每个选项部分。 如果放在
DEFAULT，除非被覆盖，否则它们将适用于所有相关选项。

最后的 存储支持 -s 或 -u 的命令的最后一个 ID。

发件人
提供用于 From: 邮件头的电子邮件地址
tw. 通常在 [DEFAULT] 中指定以影响所有命令。 如果不
给定， tw 指定 no From: 行，让系统的邮件传输到
分配一个默认值。

应该只包含一个简单的电子邮件地址——没有括号、括号、引号或
意见。

给定后，Twidge 将昵称和此地址用于 From 行。 当不
给定，昵称被添加到主题行。

保存最后
对于“ls”类命令之一，在每次调用时隐含 -s，而不是
要求手动给出。 这个选项只需要存在； 你的价值
给它无所谓。

发邮件
存储系统上用于发送邮件的 sendmail 可执行文件的路径。
通常在 [DEFAULT] 中指定以影响所有命令。 默认为
/usr/sbin/sendmail。

缩短网址
您可以在 [update] 部分指定缩短网址。 它默认为是。 如果设置
不，会导致 tw 省略其在更新中缩短 URL 的尝试。 如果
设置为是，会导致 tw 缩短更新中的 URL，仅当后者是
长度超过 140 个字符。 见简写

起酥油
您可以在 [update] 部分中指定shortenall。 它默认为否。 如果设置为
是的，会导致 tw 始终缩短更新中的所有 URL。 它只是
如果shorterurls 设置为yes，则有意义。

网址 缩短 配置
tw 使用 is.gd 作为其默认的 URL 缩短服务。

要启用 bit.ly 或 j.ump URL 缩短器，您必须将 [bitly] 或 [jmp] 部分添加到
配置文件。 这应该包含两个条目：login 和 apikey，见
<网址：http://bit.ly/account/>. 例如：

[跳转]
登录：bitlyapidemo
apikey: R_0da49e0a9118ff35f52f629d2d71bf07

别名
您可以在配置文件中添加一个 [alias] 部分，这将有效地创建新的
命令。 例如：

【别名】
最近：lsrecent -u
回复： lsreplies -u

TIPS & HINTS

这里有一些提示和提示 tw 对你来说更愉快。

我要参加 通过 A 代表委任
如果您的连接必须通过代理，您需要设置一个环境变量。
如果您使用环境变量，您的设置也可能会影响其他应用程序
——这可能就是你想要的。 有关执行的提示，请参阅稍后的环境部分
那。

环境

tw 不直接读取任何环境变量。 然而，它确实传递了
它调用的程序的环境，例如 Curl。 这可用于指定
代理。 请参见 卷曲(1) 了解更多详情。

符合 TO

· 可扩展标记语言 (XML)http://www.w3.org/XML/> 标准 (W3C)

版权

tw，所有代码、文档、文件和构建脚本版权所有 (C) 2006-2008 John
戈尔岑。 所有代码、文档、脚本和文件都在以下许可下
除非另有说明：

该程序是免费软件； 您可以根据以下条款重新分发和/或修改它
由自由软件基金会发布的 GNU 通用公共许可证； 任何一个
许可的第2版，或（由您选择）任何更高版本。

分发此程序是希望它有用，但不作任何保证；
甚至没有对适销性或针对特定目的的适用性的暗示保证。
有关更多详细信息，请参阅 GNU 通用公共许可证。

您应该已经收到一份 GNU 通用公共许可证以及该程序；
如果没有，请写信给 Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston，
MA 02110-1301 美国

GNU 通用公共许可证在源代码中的文件 COPYING 中可用
分配。 Debian GNU/Linux 用户可以在 /usr/share/common-licenses/GPL-2 中找到它。

如果 GPL 不能用于您的使用，请给我发电子邮件； 替代条款可以是
为您的项目协商。

使用 onworks.net 服务在线使用 twidge