密集的TEI概论

XML锻炼

这个短暂的练习的目的是给你一个快速的初始接触我们将使用的XML编辑器类(名为“<氧气/ >”…以下“氧气”在这个文档)。如果你已经熟悉XML,甚至如果你曾经编辑HTML文件之前,这将是非常简单的。

下载和安装氧气,去SyncRO软网站和下载免费试用软件的副本。按照说明安装在您的计算机上。(如果你有访问实验室,我们将会拿着类,你还可以练习。)

氧气的注意。这个编辑器有许多优点:它是相当便宜,容易学习,和强大的;它不仅可以帮助你编辑XML文件,而且XSLT样式表,模式和dtd,和其他类型的文件。它是与当前版本的TEI绑定和以前的主要版本。它的一个真正的缺点是,它是慢和存在。如果你快速类型,你可能逃脱。如果它的行为令人感到奇怪的是实例,如果你尝试插入一个元素,它插入错误的最可能的解释是,一你是移动的太快。

如果你计划购买氧气(不是必需的),注意,任何人在TEI成员机构包括所有学生,工作人员,和教师得到20%的折扣。问的TEI折扣代码的如果你想利用折扣。

这些指令使用覆盖TEI的词汇温柔的介绍XML(例如“元素”,“标签”,“属性”,“有效的”)。如果您的XML是生锈的,它将帮助阅读至少部分v。三世XML结构在你开始这个练习。如果你发现这个陌生的你应该在22日出席会议。但你开始,这里是一个快速的基本术语表:

元素:一个文本单元在一个XML文档,文档的一个概念上有意义的。你可能会认为元素文本的“名词”:块文本是由时间组成的。元素是由标签分隔开的,一个开始标记和结束标记。元素包含这两个标签加上他们附上的内容。元素也可以是空的:也就是说,它们可能包含任何内容。
例子:<名称>莎拉< /名称>。
一个示例空元素:< pb / >(这个符号是完全等价的< pb > < / pb >)。
属性:一个描述性的修饰符,一个元素。你可能认为属性编码的“形容词”:他们添加细节和细微的元素说什么。属性可以用来描述外观,数量,类型,以及许多其他特征的信息被编码。属性总是出现在元素的开始标记。为一个元素可以有多个属性,但每个属性每个元素只能出现一次。
例子:<名称类型=“人”>莎拉< /名称>
标签:一块标记指示元素的开始或结束。标签是由尖括号分隔开的。
一个示例开始标记:<名称type = "人" >。
一个示例结束标记:< /名称>。
有效:XML文档是有效的,当它符合规则中定义的模式。一个模式是一种表达方式对文档结构的限制,定义一个特定的标记语言;你可能熟悉的例子包括含铅,TEI, XHTML或DocBook。请注意,“DTD(文档类型定义)是一种模式。

现在练习:

发射的氧气。要有耐心,它可能需要一段时间。如果你的电脑是低内存,尽量保持其他应用程序降到最低。
在“文件”菜单上,选择“新…”;在产生的对话框中选择“来自模板”选项卡;并从列表中选择“XHTML 1.0 Strict”。为额外的挑战(选择“TEI P5裸”。)你会得到一个模板包含一个骨架的XML文档,使用XHTML标记语言(或TEI指导方针)。这种骨架已经有效的(也就是说,它包含所有所需的最低限度基本要素标记系统您选择)。你可以通过点击红色复选标记的文档图标在窗口的顶部中心(鼠标悬停说“重置缓存和验证”或“验证Doucment”)。
看一看的标记。一些元素名称相当不言自明的(你可以容易理解<标题>和<身体>元素…)。有多少标记你能找出没有阅读的文档吗?
向你自己证明这个文件是有效的:点击红色在窗口的顶部中心复选标记。氧气会想一想,然后应该给“文档是有效的”消息和绿色广场图标在窗口的底部。
现在试着将一个XML元素添加到您的骨架。在XHTML示例中,把你的光标在<身体>元素的开始标记和结束标记(即对<身体>在这里< /身体>)。(TEI示例中,有一个评论<身体>开始标记和结束标记之间:删除它。)输入一个左尖括号(<),看看会发生什么。你应该给出一个菜单清单的所有元素允许在光标的位置。一些有明显的功能,其他的可能是相当模糊的。注意:在XHTML常常需要滚动到黄色的弹出框的底部找到所选元素的描述。
使用箭头键移动在列表中,双击您选择或类型返回选中它。氧气将为您插入你选择的元素。
再次验证您的文档(点击红色复选标记)。它仍然有效吗?
输入一些文本到你刚刚插入的元素。现在选择一个词(如通过双击它),从“文件”菜单中选择“XML重构”(奇怪的词!)。你会看到一个选择列表,插入或修改文档中标记的方法。选择“环绕标签…”(注意击键sequence-much方便使用)。你会得到相同的菜单。从列表中选择一个元素和类型返回插入标记。再次验证您的文档。
试着插入一个属性。把你的光标在任何元素的开始标记,就在关闭之前>字符。(即对<名称在这里>)。现在类型之间的空间元素名称和关闭>。氧气应该显示属性名称的列表。哪些你看到取决于元素;至少,您应该看到“id”和“朗”(TEI将xml: id和xml: lang)。再次,选择一个你想和类型返回插入它。现在有一个属性,但没有属性值。输入一个引号之间的价值。再次验证。(如果您选择的属性需要特定的值,你的文档可能会失败验证。 Can you figure out what’s wrong?)
如果您的文档仍然有效,尝试创建一个错误。选择任何元素和删除一个标签(开始标记和结束标记)。现在验证文档。错误消息有意义吗?(可能不是…阅读验证错误消息是一个黑色的艺术。你可以把它捡起来,故意制造错误和看到错误消息是什么样子。)

Java堆栈溢出错误

如果你得到一个“堆栈溢出”错误消息,你可以解决这个问题,java堆栈。以下是详细说明这样做的Mac OS x如果使用GNU / Linux或Windows您可能希望看到的SyncRO软的文档。

Mac OS X,双击氧气图标

发现氧气应用程序本身(不是一个别名或码头版)
举行控制键点击它
从弹出菜单中选择“显示包内容”
新窗口(氧气),打开“内容”
可选:做一个备份Info.plist
编辑Info.plist在你最喜欢的编辑器。这可能并不像听起来那么容易,因为这不是一个通常不可见的文件,通常是与应用程序相关联。注意,它是一个XML文件,您可以编辑在氧气,但因为它不结束”。xml“你不能图标拖拽到氧气。就我个人而言,我通常将图标拖到主氧气窗口。您可能需要从列表中选择“XML文档”的可能性氧气礼物你打开它。

找到字符串“xss”。它应该看起来像:

<键> VMOptions < /关键> <字符串> -Xss650K -Xms32M -Xmx190M < /字符串>

增加“xss”开关的值,例如“-Xss2M”。您可能希望增加他人,特别是如果你的机器有很多内存。参见下面更详细的解释和价值。
保存Info.plist文件
如果它运行时,退出氧气

Mac OS X,发行`/应用程序/氧/ oxygenMac.sh`在命令行

编辑该文件/应用程序/氧/ oxygenMac.sh(可以使用氧气作为编辑,如果你喜欢)

接近尾声,找到“xss”开关。它应该看起来像:

java \ -Dcom.oxygenxml.editor.plugins -Xdock: name =氧气。dir = " $ OXYGEN_HOME /插件" \ -Xss650k \ -Xmx256m \

增加“xss”开关的值,例如“-Xss2M”。您可能希望增加他人,特别是如果你的机器有很多内存。参见下面更详细的解释和价值。

下面

开关	意义	评论	我用的
`xss`	每个线程的堆栈大小	VM中的每个线程都有一个堆栈。堆栈大小将限制线程的数量,你可以。如果堆栈大小太大你会用光内存,因为每个线程比它需要分配更多的内存。如果堆栈大小太小,最终你会得到一个栈溢出错误。	2米或4米
`xms`	最初的java堆大小	设置为1米的倍数大于1米。一些人认为,作为一般规则,应设置等于最大堆大小(- xmx)。	16米
`- xmx`	最大java堆大小	如果设置很高,氧气只需要“清理”其内存很少,但这需要更长时间	512米

我不知道,但我的猜测是,它是一个坏主意来设置任何值比你的机器有更多的内存。找出你的机器有多少内存,从苹果的菜单中选择“苹果”在您的菜单栏左端。我建议,没有任何知识或基础,最大堆大小(-Xxmx)是实际内存总量的3/4。(如果有人知道更好,请让我知道!)

一些信息从http://www.caucho.com/resin - 3.0 / - performance/jvm tuning.xtp和一些从http://edocs.beasys.com/wls/docs81/perform/JVMTuning.html 2008-03-19。