ctext.org入门教程

此教程将会从使用者的角度简单介绍中国哲学书电子化计划资料库和数位图书馆中的主要操作方法，并举具体的操作实例以便示范系统的主要功能。

教程网址：
英文：https://dsturgeon.net/ctext
中文：https://dsturgeon.net/ctext-zhs
日文：https://dsturgeon.net/ctext-ja

1

首次使用前的设置

• 建立帐户：在左手栏目中，往下卷动并点击“登入”，然后在“若尚未建立本站的帐户”的表格中输入您的资料，再点“建立帐户”。
• 确认电脑字体是否已安装：在左上角点“本站介绍”，再点“字体试验页”。

书目查询

• 使用左手栏目中的“书名检索”功能。
• 检索结果中，“”图标表示该文献的内容可以直接连接到对应的扫描影印资料。
• 此外，检索结果中可能会看到以下图标：
  文字版存放于原典资料库（使用者不能直接编辑）。
  可以编辑的文字版，此文字版本是人工输入的而不是OCR结果。
  可以编辑的文字版，此文字版本是OCR结果。
  版本的影印扫描资料。
• 习题：
  • 找出《资暇集》的电子全文。
  • 在原典数据库中找出先秦两汉时代的一部经典（如：《庄子》、《荀子》等）。

全文检索

• 首先找出并打开想要检索的文字版翻译（章节或是卷），点击 左手栏目下部的“检索” 框。
• 习题：
  • 找出《论语》中带有孔子所说“君子不器”的段落。
  • 找出《庄子》中所有有提到“道”的段落。
• 当你在文本资料库中检索本文得出多个结果时，可以点击页面右上部的“显示统计”链接，打开检索结果的互动摘要。

在主要的扫描资料中找出文本

• 在ctext中，可以通过影印底本连结来检索影印资料。当文字版中带有影印连结时，书名检索结果中会显示“”的图标。
• 当文本跟扫描档案有链接时，点击左方文本中任何一个段落的“”图标，打开对应的扫面版本。
• 当你要在扫面文本中检索特定的单词或是片语，在文字版中检索对应的单词或是片语，点击左方结果中的“”图标。
• 文字版中出现的错误（特别在OCR得出的文字版中）表示片语越长越不一致。如遇到这个情况，试图检索短一点的片语或是想要检索的文本附近出现的单词。
• 习题：
  • 找出有扫描版链接的文本，检索并检视扫面版中的结果。
  • 在OCR得出的文字版中重复一次。
  • 你也可以从“图书馆”中找出扫描文本，这个检索跟你检索文字版链接会有完全一致的结果。
  • 或者，你也可以使用链接来读出每一页的扫描本。

2

找出与文本片语相似的文本

可以在先秦两汉以及类书中的文本资料库使用

• 找出文本片语，点击“”图标，打开相似段落的概要。
• 在结果一栏中，点击标题附近的“”图标，显示每一个结果和它出现的文脉。
• 习题：
  • 找出与《庄子》中“庖丁解牛”故事相似的段落。

找出两段特定文本中的相似段落

可以在先秦两汉以及类书中的文本资料库使用

• 点击左边一栏下部的“高级检索”链接。
• 在“1. 检索范围”部分中，选择第一个种类，文本或是你想要检索的文本单位。例如，在《庄子》中检索时，你可以选择“先秦和汉”，再选“道家”，再选“庄子” （第四个框中保持“[全部]”）。
• 在“3. 检索条件”部分中，打钩“相似段落搜索”下面的框，然后以同样的方法设定本文范围（范围亦可为文本类型、文本整体或文本部分）。
• 点击“Search”。结果会显示所有包含相似段落的文本。
• 习题：
  • 找出《论语》和“道家”类文献中所有相似段落。
  • 当你有结果时，点击“显示统计”的链接。
  • 做同样的检索，这一次逆转“检索范围” 和“检索条件”，然后使用“显示统计”。

以索引、引得编号检索

适用于有索引、引得讯息的文本

• 首先打开文本的页面。页面右手方有一个搜索框，对应着每一种支持文本的索引、引得编号。
• 习题：
  • 在Eric Hutton的这篇论文中，作者使用了ICS系列和哈弗燕京系列中的索引、引得编号来表示文本的引用处，因而没有直接引用中文文本，例如：
    
    
    使用索引、引得编号来找出上面所出《荀子》中对应脚注17的作者翻译和相关资料的原档中文。

找出文本中对应的索引、引得编号

适用于有索引、引得讯息的文本

• 在带有索引、引得数据的段落左手边点击“”图标。
• 在段落上移动鼠标会显示所有对应到鼠标位置的索引、引得编号。
• 如欲显示与段落中特定一段的索引、引得编号时，使用鼠标点击并将其移动到加亮为绿色的文本。所有与加亮文本有交叉的索引、引得编号会随之显示出来。
• 习题：
  • 接着以上习题，找出对应于《荀子》中“人之性恶，其善者伪也。”这一段的索引、引得编号。

文本、翻译平行检视

对应带有英文翻译的文本。

• 一般来说，当检视带有翻译的文本时，紧接着中文的一个段落（可能很长），会显示英语段落。如想让文本和翻译更接近地显示（通常是一句一句），点击文本片语左方的“”图标。使用者也可以移动鼠标指针到中文文本来显示字典信息。
• 如所检视的段落较长时，使用者可以先检索中文句子，再点击“”图标如上，直接跳到对应特定中文文本的翻译。
• 习题：
  • 使用《庄子》的文本来做实验。
  • 用这个功能检视James Legge如何在同一个文本中翻译“每至于族，吾见其难为，怵然为戒，视为止，行为迟”。

显示注释

对应于部分文本，例如《论语》、《孟子》、《墨子》、《道德经》等

• 点击文本左方的“”图标。请注意，注释本身也是独立的文本，所以你可以点所显示的注释中的链接转到注释文本。
• 习题：
  • 使用《论语》、《孟子》、《墨子》或是《道德经》做实验。

3

找出或输入罕见、异体字

• 打开网站中“字典”的部分。
• 根据所欲输入的字的情况可用以可以选择：
  • 直接输入（打字）
  • 结构查询：请参阅字典主页上的简要，
  • 部首查询：先选择部首，然后按照附加笔画查看。你可以通过点击“n strokes”标记来加大显示中的文字。
• 习题：
  • 䊫, 𥼺, 𧤴, …：在ctext.org的字典中检索这些字（要使用上述说明的方法，不要直接从这个页面复制粘贴）。
• 小贴士：如果两种组成部分都不容易输入的话，你可以输入包含其成分的任何其他字，通过分解，你可以找出成分，然后可以找出包含有那个特定成分的其他字。
• ctext上的某些文本中有统一码中不存在的汉字。这些汉字目前只能通过成分来检索。
  • 你可以为了在ctext中使用，复制和粘贴在统一码中不存在的汉字。当统一码中不存在的汉字被复制时，将会变成“ctext:nnnn”识别符号（例如，ctext:1591）。在其他软件中粘贴这类字时（例如，在Word等软体），会粘贴识别符号，而不是字或是图像。
  • 然而，您可以在ctext中点击字体的右方并选择“复制图像”来复制字的图像。这个可以粘贴在Word文档（例如，通过参照“ctext:nnnn”识别符号或是提供网站链接）
  • 例子：

4

文本编辑

最有效编辑具有扫描版本的文本方式是通过简单修改功能。请参阅以下步骤：

• 找出扫描版中出现传写错误的扫描页面。
• 点击“简单修改模式”链接。
• 系统会显示可直接编辑文字内容的输入方块。一般来说，每一行文字对应着扫描图像中的每一栏文字。
• 细心修正文本保持与扫描版一致，结束后点击“保存编辑”。
• 如果需要输入空格，请务必使用全角中文空格，而不是英文的半角空格。
• 习题：
  • 选择一件透过OCR打造的文本资料，纠正其错误。
• 详细纪录文本中每一次的修改并提供换回到更早版本的方法，是任何一种维基系统的基础–即所谓的“版本控制”。当您保存了修改之后：
  • 点击“文字版” 链接来打开您修改的文本全文
  • 往上卷动，点击“查看历史”来显示最近的历史纪录，您最近的修改会显示在最上边。
  • 每一行代表着一次修改之后的文本状态。可以通过在表的左方选择两种单选按钮，并点击“显示相差”来比较文本在两个时刻的状态。默认选择会比较文本当前状态和最新修改前的版本。点击“显示相差”来视觉化您刚刚做过的修改。

5

安装和使用插件

插件可用以扩展让网站的使用介面来支持新的功能。最常用的实例包括下载文本资料，连接到第三方提供的字典、工具等。为了使用插件，您必须先安装插件到您的帐户中（每一件插件只需做一次）。安装步骤如下：

• 打开“本站介绍” > “工具” > “插件”。
• 找出您想要安装的插件，点击“安装”。
• 在确认页面中再点击“安装”。

安装插件之后，当您打开任何在ctext.org支持的对象时（例如， “book” 或是 “chapter”插件对应的是文本章节，“character”和“word”类插件对应的是字典中的汉字或中文单词），对应的链接会显示在屏幕上方附近的一栏中。
习题：

• 安装“全文输出”插件并使用它输出文本的一章内容。
• 安装“Frequencies”插件并使用它检视文本章节中出现的汉字的频率。
• 安装任何一个带有“character” 或是“word”类的插件，在字典中找一个字，使用插件进入外部字典。

进阶主题

以下将介绍比较进阶的主题，这一些需要额外的努力以及（或是）超过这个教程范围的附加专业技能。

创造新的插件

插件是为了把ctext.org的使用介面和外部资料（通常是其他网站）相链接的XML编码。用户可以通过自己的ctext.org帐户来修改已存在的插件编码来创造新的插件。如要检视或修改当前所安装插件的内容，点击左边栏目中的“个人设定”，然后点击“直接修改个人插件XML档案”链接。

您可以通过复制“<Plugin>…</Plugin>”代码中的编码，以及修改复制内容来创造新的插件。您需要从新的插件中移除“”代码，不然，所输入的内容将来会被旧插件的新版自动取代。您也可以创造独立的XML文档（参阅多数已有的例子），存放到您的服务器，然后安装到您的ctext.org帐户。

如果您创建的新插件或是代码不被ctext介面接受的话，您可以使用W3C Markup Validator来确认您的插件文档是否有效。一个有效的插件会有绿色的字体写上“This document was successfully checked as CTPPlugin!”，看起来是这样的页面。

程序存取

为了文本采矿和数字人文研究，网站中的文本资料可以直接通过Python等程序语言来存取。这需要一些额外的设置和时间来实行（特别对于没有程序经验的用户），不过网路上也有供详细的介绍。

程序存取是通过ctext.org的应用程式介面(API)来实现的，您可以通过任何能够发送HTTP请求的程式语言或环境实行。本网特别推荐Python，因为您可以通过已有的ctext Python module使用API，这样可以降低程式开发上所需的时间。除了API的使用说明以外，您可以参考包括具体实例的API函数列单。