微信公众号 CCBible/Bible101/DBible 微博@基督徒百科@Bible101@歌珊地圣经引擎@如鹰展翼而上 QQ群 4619600/226112909/226112998 同步推送#今日真道圣言#
OSIS2.1用户手册:第一章
OSIS开放圣经信息标准2.1用户手册翻译
OSIS 2.1 用户手册 第一章 OSIS介绍
欢迎使用OSIS(开放圣经信息标准TM)用户手册。OSIS是一个XML模式,它可以用来出版圣经,注释和相关文本,这些都可以非常方便的与他人交流,也可以使用HTML,PDF,POSTSCRIPT或者任何其他的希望的格式,可以在任何一台个人计算机上搜索。它提供一个来表示此类文档的一个标准化方法,它对于节省时间和经费非常重要。
作者可以为不同的潜在出版商准备唯一的初稿
接收了OSIS文档的出版商可以使用标准XML工具转换成其内部各式,或者直接打印或者电子化出版其产品(而不需要额外的转换)
软件供应商可以为他们的产品使用现存的XML软件
用户可以使用所有用户都可以自由使用的软件来交流圣经和其他文本
XML(扩展标记语言)可能对于某些OSIS用户还不是很熟悉,下面就简单介绍一下XML和本手册中会遇到的相关术语。
XML是描述性的标记语言,与规范性标记语言有所不同。例如,在描述一个段落开始的时候,规范性标记语言会带有诸如双行距、缩进5个空格等指导,以便可以被处理引擎理解。而问题在于每个处理引擎都是用不同的指令集合。
与之相对应的描述性的标记语言则使用
来标记一个段落的开始,并且用
表示段落的结束。而段落如何格式化则留给了后续的处理工作。使用描述性标记语言的一个优势在于相同的文件可以用于创建HTML、PDF或者用于分发到手机上的文件格式。另外一个主要的好处在于文件可以很方便的在不同的处理程序之间交换,因为在文件中并没有某个处理程序特定的信息。
本手册非常频繁的使用element元素和attribute属性这两个术语。元素是一个特定类型的一段文本。例如一个
元素表示在一个文本中与元素不同的另外一个结构。这些元素在XML文档中使用tag标记来表示,这样读者会看到像:
…
成对出现,或者有时<verse/>单独出现(这个也被称作milestone里程标,因为他不需要与之匹配的结束标记)。在一个已编码的文档(在XML标记中,包括元素和属性)中允许的元素和那些被一组规则指定的再其他元素中的那些元素。而为OSIS订立的这组规则使用XML模式指定,称为OSIS模式。
属性是需要被记录但是不能作为正文一部分的一个附加的信息。例如,当标记对耶稣的话语的quotation引用的使用,会使用q元素:Eli, Eli, lama sabach’thani?
,其中的who=”Jesus”就是单独用于这个引用材料即耶稣所讲的话语的属性。属性使得在一个文本片段中搜索特定表述成为了可能,例如要把耶稣所讲的所有的话语表现为红色。
本手册按照如下方式组织:
OSIS介绍(本章),开始,出版工具,你的第一个OSIS文档。介绍材料为XML何OSIS初学者准备。
XML和OSIS声明declaration。XML和OSIS声明对于所有但还不是专家用户来讲是“剪贴并粘贴”的议题。
OSIS text head文本头。要获得有用的电子文档,需要记录一些该文本的特定信息,而这些信息本身的确不是该文本的一部分。OSIS文本头就是一个OSIS文档中放此类信息的地方。
Work著作。本上下文中Work特指那些已经编码为OSIS文档的那些文本,它需要word文字在不同的时态呈现。尽管材料相当复杂,还是提供了一些简单的例子让用户来遵循,直到用户的背景达到了已经完全掌握了work元素更加复杂的方面。
Date日期格式。为了有效地搜索电子文档的日期,日期需要表示并且以同意的方式记录。本章覆盖了OSIS日期的规则。
Title Page标题页。严格来讲,标题页是由文档中其他地方的信息组成的,不过OSIS提供了将那些信息编码到一个标题页的功能,是的这方面的工作更加舒适。
DIV分区元素。OSIS文档的基本结构从将文本分区到一些大的部分开始,这些部分叫div分区元素。此类元素用于将材料组织成chapter章、book卷、testament约、annex附录和相似的大段文本。
Paragraphs段落、Quote引用和Note注解。OSIS对paragraph段落、quote引用、note注解和illustration图解的规则在本章讨论。很多现代的一本都是用段落而不是verse章节来组织圣经文本,这样用户就可以特别注意整张的内容。
Interim Summary中间摘要。这是一个到此为止已经遇到的所有的主要元素的一个简洁列表,本章展示了如何仅仅使用一些元素就可以产生圣经的有用的编码。
交叉引用其他元素的元素。这经常是这种一个引用开始和结束于不同的章节或者段落。OSIS开发出新的技术来处理这种情况,使得处理起来更加得心应手。
特定文本类型。例如书信、戏剧文本、演讲和讲员、诗歌体裁、表格、家谱和图(图解)等在这里阐述。
Milestone里程标。一个milestone里程标,就像路边的标记一样,用于标注文本中的一个特定的位置。不是所有的文本都需要里程标,但是为了一些目的,例如在标记必须的line break换行时,他们就必不可少了。
所有文本中的共同元素。有一些在所有的文本中都会出现的东西,例如abbreviation缩写、foreign words外语单词、reference引用、name命名等等。这些标记都在此汇总以方便参考。
Bible Edition圣经版本。圣经通常都有与内容无关的不同的版本。有些需要发音帮助、其他的扩展地图或者其他的一些特性。区分不同的版本非常重要,而OSIS在这方面的机制则在本章介绍。
OSIS Identifier标识。在礼拜天参加一个聚会的所有人都可以一起阅读的原因在于他们具有相同的圣经索引方式。然而,也存在其他的一些索引系统,OSIS则提供了表示这些系统以方便特定的用户社区的需求。
OSIS Reference索引参考。这个很普遍,尤其是在研究注释和其他地方的时候,来为圣经、一段章节、独立的一个章节甚至几段章节的其他的部分做参考索引。OSIS为这三方面工作也提供了手段。
不同的Versification system诗歌体裁。尽管普通用户不太会遇到,不同的诗歌体裁却是存在圣经文本中的。有些圣经提供了参考索引或者甚至是文本,使用不同的诗体。本部分覆盖了如何在OSIS中编码这部分内容。
附录。附录包括对用户很用用的参考资料。其中,有OSIS元素及其属性的快速参考表,圣经标准缩写等材料。对当今圣经译本的特定的新区是将USFM编码映射到OSIS元素中,以及其应用的简单介绍。
如果听起来好像有太多材料,请鼓起勇气来。OSIS设计的跟HTML 3.2有差不多相同数量的元素,而HTML 3.2却是迄今为止最成功的标记语言之一。除了文本的header头部分这个相当复杂的部分之外,不同用户可以使用15个甚至更少的元素来创作一个具有专业质量的圣经文本编码。一个圣经文本可以被其他的用户、出版商和其他人来生产大量的材料。请不要搞错,使用OSIS的确需要一定的努力,但是可以把圣经做成可以广泛访问,其产出是巨大的。