帮助标签
version available in : en it ru es ja de nl pt fr
date of creation : 20220802- date of update : 20220802- generation date : 20240612_171237
你好,你可能刚刚在安装了utags模块后,创建了"mentor"系统的超文本数据库。.
在数据库创建脚本的最后,启动gvim来编辑这个帮助文件.
gvim是utags提供超文本编辑和管理系统的基础。.
如果你不熟悉gvim,可以先参考一下 . aide vim .
. aide vim 是一个导师的超文本标签的参考,它引导你进入vim帮助文件.
要访问它,可以输入命令":ta aide_vim"并按回车键或将文本光标放在参考文献上。 . aide vim 输入shift-$,这将打开一个新的帮助文件标签。.
你现在需要通过以下方式学习如何使用该工具:
2.. commandes et macro commandes de navigation dans l'hypertexte :和演示的超文本形式
vim编辑器有一个超文本导航功能,可以分解成各种命令 :
TF 订单_线 行动
F5 标签 显示所浏览的标签堆 (标签'堆栈)
F6 po 在堆栈中上升一个标签 F7 ta 推进堆栈中的一个标签 F8 e# 在两个文本缓冲区之间切换
- 和 . mode commande vi 光标必须在超文本引用上,例如: sommaire_zh (的超文本参考资料。 . langage de balisage leger mentor 导航功能键表).
- 导航的键是"ctrl-。]qwerty键盘上的",以及ctrl-altgr-。]在Azerty上
这是更复杂的,我们已经在altgr-$上进行了模拟。
(币是在同一地点的零钱。 ]在qwerty和altgr-$中,实际上是"¤"字符。)
这条命令会转到同一窗口中所指的标签上。.
所以它相当于命令"。:你的标签"但不必在键盘上输入标签.
altgr-$ 启动宏 ggt_zh (在命令模式下输入")
钥匙 宏观 行动
altgr-$ ggt_zh 在当前vi缓冲区内进行超文本导航
µ ght_zh 做横向标记 通过对窗口进行水平分割来实现超文本导航 £ gnt_zh 通过打开一个新标签的超文本导航 § gvt_zh 通过对窗口进行垂直分割来实现超文本导航 与特定文件相连的其他宏 (见下文)
gsf_zh 转到摘要文件 文件摘要中的超文本导航 gsr_zh 转到摘要参考文件 文件摘要中的超文本导航到当前标签参考的位置 gsg_zh 归纳总结 综述中的超文本导航 (数据库中的文件引用列表) gut_zh 去标签 对utags文件的超文本导航 (数据库中文件的超文本标签索引) gag_zh 去Arbre将军 超文本导航到包含数据库中的文件树的文件) gas_zh 去源树 超文本导航到包含最后执行utags的文件树的文件) grc_zh 去交叉引用 超文本导航到交叉参考文件:搜索当前标签的引用
3.文本块 texte_structuré_zh
文本块是存储文本的结构。.
它由四种类型的元素组成,以一对分隔符为界 < >, ( ), { }和 [ ]
- 一个超文本标签或标记,放在分隔符"之间。<" et ">", 说 . étiquette mentor
.
其中只能包含以下划线字符"_"为分隔符的字母数字字符--可能是一个 . résumé de bloc
或 . commentaire mentor
放在括号里 "( )",
因此,我们有一个一般的形式:
<etiquette_de_bloc_zh>(职称) [reference_zh]
{
...
... [reference_zh] ...
...
<etiquette_de_sous_bloc_zh>(子区块标签)
{
...
... [reference_zh] ...
...
... <etiquette_dans_texte_zh> ...
...
... [reference_zh] ...
...
等等...
}
}
因此,它可以被嵌套:一个文本块可以包含其他文本块.
一个特定的块是整个文件的块,其标签行包含了:- 文件名称标签 - 文件标题 - 对文件摘要的引用.
因此,文件标签的形式是 3.2.文本中的标签
.
- 例如,对于一个名为filename的文件.
在一个 :
<nomfichier_extension_zh>(文件标题)[nomfichier_extension_zh_som]
产生这一行的宏是 fnt_zh对于一个文本文件.
还有其他的宏.
- 你可以在超文本中随意浏览,并按F6键返回到你的起点。 并按F7返回到导航树。
- 在所有这些移动中,你可能需要在一个文件中存储一个特定的位置,以便直接返回到它。.
你可以使用一个品牌的vi :例如,用字母"p"来标记当前行的位置。
并在用'p'命令在文件中移动它之后将其检索出来
- 当它扫描域树时,utags会产生一些 :
- 最重要的文件是名为"utags"的标签文件,我们可以通过该文件
通过输入命令"来访问。:你的标签"或宏 gut_zh (从今以后
我们将不再在文本中为一个宏的导师指定".
- utags文件有一个标签文件的结构,是由UNIX ctags命令为C语言源生成的。.
- 你可以在utags文件中用宏搜索一个标签的位置 frt_zh.
- 的"树文件.txt",可以通过命令访问 gag_zh (不,这不是一个玩笑).
这个文件显示了整个域树及其叶子,即文件。
例如,对于一个文件,我们可以看到导师路径和文件系统路径。.
因此,utags提供了另一种访问和组织你的文件的方式.
双重等级制度.
- 的"源文件.txt"访问的 gas_zh这是一个特定的utags命令的结果
这将只处理一个特定的域或文件,而不是处理 racine_dom_zh.
- "urefs"文件也非常重要,它是交叉参考,即
在文本中引用参考文献的文件列表.
如果你是在一个标签上,宏 frr_zh允许你找到这个标签的位置
被使用,如果你想移除它以保持超文本的一致性,这很方便。.
从逻辑上讲,它的引用也应该被删除.
要访问urefs文件而不进行搜索 :":ta refs"
开发者须知 :这个包含vim宏文件或perl脚本来源链接的文件就是一个例子。
如何在评论中用标签链接你的来源和技术规范文件。
使字母编程变得简单.
也是文件的摘要 (gsf_zh超文本中的搜索模式)将给你一个关于你的来源的概述,并链接到
到你所感兴趣的代码.用Perl程序生成html页面的例子 : mt_to_htm_pl_zh_som
(在未来的版本中有很多改进的余地,比如在源文件中加入"inside html"。
以便受益于.超文本中的搜索模式)
这些函数为代码和文档之间的不匹配这一永恒的问题提供了一个实际的解决方案.
在导师方法论的指导下,文档就像其他的代码一样.
1.. tableau des macro commandes d'edition :为导师的轻量级标记语言
宏观 助记符 评论
ebia_zh 版块插入的赞誉 插入一个大括号块
ebai_zh 编辑块状倒置括号 插入大括号来分割一个块 ebtb_zh 构建一个新版本的 \"标签\"。 创建一个 . bloc structurel 通过在标签上留下版本来完成 ebma_zh 纪念馆的荣誉 括号内是由F3-F4选择的行块。 ebmp_zh 编辑方块括号 给由F3-F4选择的行块加上括号 ebm__zh 编辑无声阻断 有一系列的ebm宏,其最后一个字母是 . modifieur de bloc etft_zh 版式标签 文本资料 有一系列的宏观ETF etf_mac_zh其最后一个字母是源文件的类型
宏观 助记符 评论
ub_zh UTags基地 启动utags,对上次扫描后修改的文件进行全数据库扫描。 (racine.扈从)
ud_zh 乌塔格酒庄 启动utags,扫描当前域中修改过的文件 uf_zh 许可证号:Utags Fichier 启动utags来分析当前文件 F11_zh ub_zh拉赛因.扈从 快捷方式 ut_zh M-F11_zh ud_zh拉赛因.一般情况下 快捷方式 ug_zh C-F11_zh uf_zh文件 快捷方式 uf_zh
- 最经常使用的命令肯定是 C-F11_zh.当你通过创建标签和参考文献来编辑一个文件时。
你将在保存修改后使用此命令,用新标签更新utags数据库。
和urefs数据库中的新参考文献.
在Utags菜单中,有一个子菜单"Exploitation",允许你保存或归档整个域。
还可以对文件的连续版本进行存档.
- 菜单项EnterDomainName用于输入环境变量的值.
- 标签DisplayCurrentDomain显示该变量的值.
- 然后,我们发现域名的措辞.出口,调用宏 fdex_zh它反过来调用 archive_domaine_sh_zh
它用"tar"命令建立一个存档文件,并将其复制到由 ARCHISUPP_zh
在一个带有导师数据库名称的目录中。 ARCHIDIR_zh.
- 措辞选择.IncrementArchiveDomain告诉 archive_domaine_sh_zh档案名称必须包括一个增量数字 以便创建一个连续的档案.例子 "utags_000.ar", "utags_001.ar"
- 接下来是一个文件子菜单,标签如下:
注意事项 :结构化数据管理将很快被提供.
这个新模块是电子表格和RDBMS功能的整合 (关系型数据库管理系统).
它是通过CSV类型的文本块实现的,其标签是RDBMS表的名称。.
脚本语言也将被整合到这个模块中,对这些数据进行编程。.
允许你快速创建任何类型的应用程序.
实施的具体例子 :从蛋白质的FASTA代码中生成蛋白质的乐谱 : partition_de_la_protéodie_stimulatrice_de_phenylalanine_ammonia_lyase_1_pisum_sativumhttp://quantum.
始终如一的数据.
net/phenylalanine_ammonia_lyase_1_pisum_sativum_sti_part_txh.
htm