微信公众号 CCBible/Bible101/DBible 微博@基督徒百科@Bible101@歌珊地圣经引擎@如鹰展翼而上 QQ群 4619600/226112909/226112998 同步推送#今日真道圣言#
OSIS2.1用户手册:第二章
OSIS开放圣经信息标准2.1用户手册翻译
OSIS 2.1用户手册 2 起航
当使用XML标记语言学习OSIS时最常问的第一个问题就是“我不是搞计算机的,我能学习使用OSIS么?”如果你会打字且会使用最基本的文字处理程序或者是计算机文本编辑程序,答案就是,非常深情的,“能!”。OSIS的设计为初学者提供了一个简单的使用基本的标记来处理圣经文本的方法。“标记”是指在文本中放的一些记号,这些记号知识了那些有用的单位(即元素element)都在哪里,包括章节、引用、交叉参考和一些其他的从开头到结尾的东西。
如果你知道HTML,你在游戏中就已经是领先者了,你差不多已经知道了要使用OSIS的绝大部分的东西;OSIS用户使用和HTML(更确切的说是XML)同样的尖括号语法。基本上没有另外的元素和属性名称。有些命名如“p”、“div”则完全相同;有一些新的命名,例如“verse”。OSIS的核心元素集合只比HTML的多一点点。确切的说,我们后面会讨论有一些相对复杂的情况,但是除了这个基本的手册之外,基本上不再需要其他的信息,我们就可以做非常有用的工作了。
第二个常问的问题是:“要弄OSIS,我是否需要一个XML编辑器?”这个问题经常在一个朋友的朋友推荐了一个编辑器之后被问到,而你会去看看其价格几何。XML编辑器的价格从免费到超过一万美刀都有,而他们的易用性也参差不齐。
简单的答案是不需要,你不需要一个特定的软件。要建立一个OSIS文档,你可以使用任何你喜欢的编辑器。其中很多会进行语法高亮度显示,因为他们知道如何用颜色来表示HTML和类似语言的标记。不过,你需要一个可以对文档查错的手段–如果你的编辑器不是很知道XML并在你输入错误的时候提醒你的话,或者你用了一个开始标记却忘了其结束标记的话,你需要经常使用一个“XML验证程序”来查错。
很多的XML编辑器会根据一个模式来进行XML文档的验证。如果你不使用XML编辑器,你还是可以使用基于网页的一些验证程序来校验你的OSIS文档。这些验证程序允许你选择一个本地电脑上的程序及其模式,而该网络服务就会帮你验证。有两个这样的服务:http://apps.gotdotnet.com/xmltools/xsdvalidator/, 和http://tools.decisionsoft.com/schemaValidate.html。
一些认识OSIS文本的编辑器也会为你做这个工作,可以根据需要或者持续进行。更好的OSIS敏感的文本编辑器还会提示那些元素可以使用在哪些地方。最好的编辑器还会给你一个选择来根据需要进行预览和编辑一个格式化的全文,而不是只从某个尖括号开始查看。在诸多的工具之间做选择是根据个人的喜好,需要根据工作方式,技术成熟水平,目标,经费预算等其他因素。
示例注释:本手册提供一些OSIS标记的例子。这些例子的格式(缩进、换行等)是为了阅读方便。XML处理器不在意这些元素是否是一个挨着一个的,当然大部分人会觉得这样的文档阅读有困难。空白和换行的恰当的使用会使得你的编码工作更加方便校稿人员的阅读。当然也包括你自己,所以,为了自己的好处,耶青来使用这些。
对以后的参考:从此时开始你就会看到一个要段落以“对以后的参考”开头。当你第一次(或者第二次)阅读本手册的时候,你可以安全的跳过这些段落。他们包括一些你可能以后在使用XML更加有经验或者要解决一个特定的问题时会用到的信息。