微信公众号 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的確需要一定的努力,但是可以把聖經做成可以廣泛訪問,其產出是巨大的。