seeman - 云端在线

程序：

您的姓名

seetxt/西曼 ‐用于 X 窗口的 GUI 文本文件和手册页（“手册页”）查看器。

概要

看txt [文本文件] [-x 搜索词]
看门人 [手册页] [-s 部分] [-x 搜索词]

商品描述

Seetxt和seeman（合称：“see”）是同一个程序，只是名字不同
指示是否正在加载手册页或常规文本文件。 随后，该
调用名称无关紧要——GUI 始终可用于查看这两种文件。
See 为每个用户独立维护文档“元数据”，允许您保留
只读系统文件（包括手册页）的书签和高亮显示
直观的方式。 另请参阅分层查找、超链接适当搜索，并且可以
设置为监视现有文件（例如日志）的更改。

默认情况下，请参阅以“服务器模式”运行：命令行请求将发送到正在运行的
服务器而不是启动一个新实例。 这有助于促进与文件的集成
浏览器，其中大多数允许您在查看文本时注册要使用的命令
文档。

See 使用标题栏来发布一些程序消息。 您可以拖放文本文件
从另一个应用程序窗口进入文本区域进行查看（这不会移动或复制
文件在任何地方，并且不适用于手册页）。

召唤 配置

要开始“查看”（或向现有服务器发送请求），请使用 看txt or 西门，
然后是文件名，然后是任何选项。 文件名必须在选项之前。 如果不
给出文件名，即使有服务器正在运行，也会启动一个新的 see 实例。
如果文件名本身以破折号开头，请确保使用完整路径或“./”。 你
还可以使用完整路径名或“./”查看路径外的手册页。 见会参考
到属于“***”部分的页面（在文件列表等中）。

所有选项都是以破折号开头的单个字符。

-s 部分
用于指示要使用的手册页部分而不是默认值，例如。 “西门
printf -s 3"。不要在路径外联机帮助页中使用它。

-x 术语
See 将对“term”执行初始查找所有文本搜索，突出显示所有
实例。 要搜索短语（即包含空格的术语），请将术语括起来
在引号中。

-v 显示版本。 本文档适用于 0.72 版。

-h 显示有用的“使用”消息。

注意 关于我们 符号链接 IN 文件 路径： 如果在当前工作目录中加载文件
没有路径，see 使用该文件的真实路径。 但是，如果该目录也是
符号链接，然后您使用文件的完整路径加载文件 - a 符号链接
某处 in 它， see 将使用该路径。 这对于文件列表和
seedata（书签/突出显示），因为该信息按文件名保存，包括
路径，并且符号链接的路径将与“真实路径”不匹配。

“ 导航 BAR AND 文件列表

GUI 的左上角是三个按钮：一个“返回”按钮，一个包含名称的按钮
当前文件，以及一个“前进”按钮。 中间按钮将显示文件列表。
这是以前查看过的文件的列表，按“后进先出”的顺序排列。 你可以选择
通过双击左键从此列表中的文件（将该文件移动到顶部
列表）。 您还可以使用后退和前进按钮，有或没有文件列表
窗口打开，跳过列表（以这种方式加载的文件不会改变位置）。
切换文件时会记录光标的最后位置，方便切换回来
在文件之间来回并保持行位置而无需费心放置
书签。 为列表中的所有文件保存此信息，即使在调用之间，
并且在实例之间共享。 文件列表保存在磁盘上，您应该定义一个
在您的配置中的位置（见下文）； 如果没有，see 将使用全局列表
从其运行时目录。

如果需要，您可以手动编辑磁盘上的文件列表。 注意格式变了
在 0.61 和 0.70 之间，您的旧文件列表将不兼容。 纠正它：所有
文件和联机帮助页名称后必须跟一个 |，然后是 man 括号中的 (section)
页。 可选地，然后有一个 $NUM，其中“NUM”是一个整数——这是
加载时光标的字符位置。 栏本身 (|) 和节一样是强制性的
对于联机帮助页。 您将收到有关无效条目的警告。 另请阅读关于
上面调用选项下的文件路径中的符号链接。

BOTTOM 切换 AND 文字 进入

See界面底部有五个切换按钮，其中两个看起来
就像设置时闪烁绿色的小圆灯。 直接点击灯光切换
它。 左边的灯打开和关闭服务器（参见下面的服务器模式）。 正确的
light 对当前文件设置监视，这意味着它将每隔一段时间重新加载
包括任何新的变化。 此间隔的默认值为 XNUMX 秒（请参阅配置、
下文）。

注意：超过默认 1 Mb 的文件不会重新加载——它们被拖尾。 这意味着如果
文件大小已增加，将从末尾取出等于差异的数量，并且
添加到显示中。 如果“更改”是结尾的补充（例如
发生在正常日志中）。 但是如果你想监视一个非常大的文本文件以供其他
（随机）更改，您必须调整默认的 1 Mb 限制，请参阅配置。 这个
不适用于手册页。 如果光标在被观察文件的末尾，则显示
即使文件已经增长，也应该保留在那里。

文本条目周围中心的三个按钮是用于文本搜索的控件。
如果您在文本条目中输入内容并按回车键，see 将执行“查找全部”
样式搜索，以黄色突出显示找到的术语并移动视图以包括
一审。 您现在可以使用 ctrl-n 将光标移动到下一个实例，然后
使用 ctrl-p 返回上一个实例。 如果您切换“推送”并输入新搜索
项，上次搜索的所有实例将变为紫色突出显示，而新的
术语将是黄色的。 重新加载，或设置导致重新加载的手表，将删除
强调。 别担心，有一个命令历史，可以很容易地重复搜索
使用文本条目中的箭头键（此历史记录不会在
调用）。

通常，搜索不区分大小写。 要使搜索区分大小写，请切换
“案件”。 要将搜索词作为正则表达式处理，请切换“regexp”（例如：查找
“for”而不是“foreach”，搜索“\bfor\b”作为正则表达式）。 这些是 POSIX 风格的常规
表达式，就像“grep”命令一样。 文本条目左侧的数字显示
在上次搜索中找到的实例数。 您可以使用“ctrl-/”将焦点设置为
文本条目，而不是用鼠标单击它。

有几个组合键可能对导航文本区域很有用：alt-left
或 Home 移动到行首，alt-right 一次跳转 27 个字符，End
移动到行尾。 Ctrl-home 移动到文档的最开头，
ctrl-end 到最后。

主要 网站地图

当鼠标指针在正文中时，通过右键调用主菜单
区域。 如果合适，所有条目都有 ctrl 宏或“热键”，可以在任何地方使用。
如果您有一个 Seedata 文件并“复制到”菜单上可以有多达 XNUMX 个项目
定义在的目录 ~/.seeconfig。 某些项目（例如复制、帮助、退出）是自
解释性的，不包括在这里。

文件列表 (ctrl-f)
这将打开文件列表窗口（参见上面的文件列表）。

查看书签（ctrl-s）
如果当前文件存在任何书签，它们将随文件一起加载。
书签显示为行号，为了帮助识别它们，前 31 个
行中的字符（如果该行为空白或少于 31 个字符，
数字旁边可能会出现两个或多个文本行）。 你移动到书签
双击左键。 您可以使用两者从列表中删除书签
按钮/按钮-3。 书签在放置时自动保存并
删除。 请参阅根据文件的完整路径名加载书签（除了
手册页），因此如果文件已被移动，则不会显示保存的书签。
但是，用于所有文件的书签索引本身只是一个纯文本文件
如果需要，可以轻松编辑（请参阅下面的配置）。 这需要
您在配置中定义了一个“seedata”文件。

放置书签 (ctrl-m)
为包含文本光标的行添加一个新书签。 书签是
自动保存（如果您有 seedata 文件）。

重新加载 (ctrl-l)
这会更新显示以反映文件的当前状态。 文件结束
1 MB，文件是“tailed”的（参见上一节中的注意），这对于
长日志等。要实际重新加载整个文件（如果它很大），请使用
文件列表（文件列表中的第一个文件始终是最后加载的文件）。 这
光标和视图将返回到与之前相同的行号（可能会也可能不会
显然是同一行），除非这是一个大的“尾”文件，在这种情况下
视图移动到最后。

适当的搜索 (ctrl-a)
列出在主文本区域中“apropos”搜索手册页的结果，使用
底部文本条目中的任何术语。 个别页面名称是双重的
绿色下划线和超链接。 双击左键显示页面。

(un) 数行 (ctrl-3)
添加或删除左侧的行号。 行号仅适用于文件
少于 100000 行。 对长度超过 XNUMX 个的文件执行搜索时
千行，建议先关闭行号。

蓝色粗体 (ctrl-h)
这将“粗体蓝色”标签应用于当前选定的文本。 此标记将
每次加载此文件时再次出现在 see 中（如果路径相同），直到
你“解开”它。

斜体红色 (alt-r)
将“斜体红色”标签应用于当前选定的文本。 刚才说的
关于斜体红色对于粗体蓝色同样如此。

取消标记 (ctrl-u)
从当前选定的文本中删除任何标记/标记。 提示：取消标记时，
如果有空格，请在要删除的标签周围使用适当的条带
包括。 这可能看起来无关紧要，但是如果文件更改并且您有一组
一两个空白字符意外突出显示，那些“隐藏”突出显示
会突然出现。 它们也可能在 seedata 文件中造成混淆（请参阅
配置，如下）。

换行模式 (ctrl-w)
为您提供三种断开比显示器长的线条的选择：不换行、换行
在字上，或精确换行。 默认是自动换行。

发送给编辑器 (ctrl-e)
这会发出用户定义的命令以将文件发送到文本编辑器。 个人的
最喜欢的：“vim 远程”。 然而，由于大多数 *nix 安装没有 vim
以这种方式编译，默认为“gedit”。 请参阅下面的配置。

复制 (ctrl-o)
如果您在您的目录中定义了有效的“复制到”目录，则会出现这
〜/.seeconfig 文件。 它将文本条目中的任何内容作为文件的名称
并将文本缓冲区的内容复制到此文件中，使用“复制到”路径
附加（您可以包含子目录）。 如果缓冲区包含一个文本文件，则
新文件将是一个精确的副本。 如果您选择了文本，则查看将仅包括
新文件中的选定文本，因此您可以保存部分缓冲区而不是
所有的。 复制与下一个选项结合使用最有用......

执行 (ctrl-x)
这将通过 shell 作为命令执行文本条目中的任何内容并打印
文本视图中的输出。 See 保持显示更新直到命令
退出。 您无法进行交互，这并不是真正用作控制台。
但是，您可以做的是将命令应用于文本缓冲区的内容，就像
它是一个文件，使用“SEEBUF”而不是文件名（实际上，这是写出的
到临时文件）。 例如：如果您只想查看缓冲区中的行
包含单词“word”，输入“grep word SEEBUF”； 这将清除显示
并打印结果，就好像之前的显示是您刚刚搜索的文件一样。 如果
您在显示中选择了文本，查看将仅使用选定的文本
赛博。 您可以使用上面的“copy-out”保存结果，实际上这个选项
如果您定义了“复制到”目录，则只会出现在菜单中（请参阅
配置）。 默认情况下，see 将 stderr 重定向到显示。 如果对于某些
原因你不想要这个，设置“无重定向”（再次参见配置）。 你也
在标题栏中获取返回值（通常为 0）。

重新配置 (F2)
这将重新处理您的配置文件 (~./seeconfig) 并向您显示
再次出现“配置”屏幕。 通过“尺寸：”更改几何图形可能不需要
放置直到您重新启动看到。

服务器 MODE

将新文件加载到正在运行的 see 实例中的唯一方法（除非它在“文件
list”，上面）是使用拖放、适当的搜索（用于联机帮助页）或服务器。

“服务器模式”允许你发送远程命令来查看，主要是为了它可以
包含在文件浏览器的用户菜单中，由其他应用程序操作，或
从命令行操作。 示例：要在 GNOME 的 nautilus 文件浏览器中使用 see，
在 nautilus 中的文本文件上单击“打开方式”，选择自定义命令，然后键入“seetxt”。
从现在开始，nautilus 将为您提供使用seetxt 查看文本文件的选项。

当服务器运行时，左边的绿灯会闪烁，任何命令
包含文件名或联机帮助页的行调用将转到它（包括请求
来自其他应用程序，例如您的文件浏览器）。 大多数网络浏览器都以这种方式工作——如果
您单击电子邮件客户端中的链接，它将出现在正在运行的 Web 浏览器中，并且
不启动另一个。

服务器使用默认为的本地套接字 〜/.seesock 但它可以设置在
配置文件。 如果服务器由于某种原因拒绝启动，退出查看并擦除
这个套接字文件（它应该只在服务器运行时存在）。

一次只能运行一台服务器。 您可以通过单击关闭服务器
界面左侧闪烁的指示灯。

配置

See 不需要任何配置即可工作，尽管没有它您可能无法
使用所有功能。 一个示例配置文件安装到
INSTALLDIR/share/seetxt-runtime（INSTALLDIR 在构建时设置，可能 在/ usr /本地 if
您从源代码构建并且没有选择任何不同的东西，或者 在/ usr 如果你从安装
一个预先构建的包）。 将 .seeconfig 复制到您的主目录中并使其适应您的
需要。 字段名称不区分大小写，以 # 开头的行将被忽略。
配置可能会影响以下内容：

·“文本字体”例如“文本字体：helvetica 12”

· “尺寸”，例如，“尺寸：1200 800”。 这是文本区域的尺寸
像素。

· 文件加载确认：正常情况下，查看新文件时会要求您确认
加载。 您可以通过在一行中单独包含“不确认”来跳过此步骤。

· "seedata:" 这是一个文本文件的位置，用于存储标记和书签。例如。
“seedata：/home/user/seedata”。 不要使用波浪号 (~)。 您可以编辑seedata
文件，但要小心遵循那里的结构：联机帮助页需要节号
在括号内。 0.70 之前的版本不需要这个，你可能需要添加
如果您的页面书签未在 0.70+ 版本中加载，请手动选择该部分。
之后有一个星号分隔的书签行号列表。 这
第一个数字是书签的数量。 然后可以有一个“R”（红色）和或
“B”（蓝色），有更多星号分隔的整数。 这些是成对的字符
位置（开始和结束）的亮点。 例如，尝试将其插入到您的
见数据文件：

看txt(1)*2*143*263*B*15226*15269*R*15464*15659*

有无配置文件，第一次使用see，它会创建一个seedata
为您提供文件（默认为 〜/.seedata）。 这是唯一的永久文件
自动在您的主目录中创建。 另请阅读关于符号链接的注意事项
上面调用选项下的文件路径。

·“文件列表：”这是一个文本文件的位置，用于保存查看文件的历史记录
in. 默认为INSTALLDIR/share/seetxt-runtime/filelist，也就是world
读/写。 多个 see 实例可能共享同一个文件列表； 它不是
锁定或保持打开状态。

· "seesocket:" 用作服务器套接字的路径和名称； 默认是
〜/.seesock （同样，不要使用波浪号）。 此路径名的全长不能为
超过 106 个字符（这是本地 unix 套接字的限制）。 不要
实际创建此文件。

·“观察间隔：”是“观察”文件时更新之间的秒数
（使用右侧闪烁切换，参见上面的切换和界面）； 默认的
是十秒。 指示灯以与手表时间无关的恒定速率闪烁。

·“背景：”设置文本区域的背景颜色（例如，“背景：矢车菊蓝”）。
see 使用的文本高光（红色、蓝色、绿色和青色）相当高
对比度，但如果您出于任何原因想调整背景，请从中选择一种颜色
/usr/share/X11/rgb.txt（名称中有空格的除外），或使用十六进制RGB
格式（例如，#ffffff）。

· "tail at:" 设置文件大小边界，在该边界处使用 "tailing" 而不是 a
完全重新加载，以字节为单位。 （例如，“尾在：5000000”）。 默认值为 1000000。请参阅
请注意上面 BOTTOM TOGGLES 的开头。

· "copy to:" 是一个目录，在其中放置来自 "copy out" 操作的文件（参见
上面的主菜单）。 例如，“复制到：/home/user/Desktop”。 如果您没有复制到
目录，您不能执行任何复制。

· stderr 重定向与“执行”菜单选项（见上文）。 转标准错误
重定向关闭，在一行中单独包含“无重定向”。

· "editor:" 设置要使用的编辑器命令（例如，"editor: vim ‐-remote"）； 见主菜单
上面有更详细的解释。

.seeconfig 文件中的错误值可能会导致故障 o_O

错误

大多数错误消息，无论是在标题栏还是弹出窗口中，都应该是不言自明的。

文件短读
如果您尝试加载非文本文件，就会发生这种情况，因为查看将在零处停止
字节，意味着读取的文本量小于实际文件长度。

无法创建临时文件
See 将您的主目录用于两个可能存在时间很短的临时文件，
.seeTMP 和 .seeTP（这些不应该作为垃圾留下，你可以擦除
如果你找到它们）。 未经许可，功能将被
降低。

无法更新文件列表！ （错误 #3）
只有当 see 能够读取文件列表但不能写入文件列表时才会发生这种情况。 在
在这种情况下，您需要更改/添加“文件列表：”条目 〜/.seeconfig or
有写入文件的权限。 默认系统范围的文件列表应该
安装时已设置模式666； 如果没有，您的系统管理员需要
“chmod 666”文件列表。

无法验证文本（错误 #4）
您的文件中有一个非 utf8 字符（不可打印的东西）。

记不清
你的电脑永远不会耗尽内存，我保证。

版权

版权所有 (C) 2008、2009、2010 马克·托马斯·埃里克森。 允许复制，
根据 GNU 自由文档的条款分发和/或修改本文档
许可证，版本 1.3 或自由软件基金会发布的任何更高版本
(http://www.gnu.org/licenses/fdl.html).

访问seetxt主页： http://seetxt.sf.net

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