扩展Dreamweaver：自定义第三方标签的解析
因为最近一直在做Dreamweaver插件的开发，中文的资料非常少，自己英文又差，查看英文资料的时候不由头昏脑胀。迫不得已把其中一些重要的内容翻译成中文之后，看的时候才觉得爽快不少。本节选自Dreamweaver8附带的《ExtendingDreamweaver8》，翻译的时候参考了一下侠客岛翻译的《Dreamweaver4中文帮助》。不过老实不客气地说，我有点怀疑那个帮助的某些部分是用金山快译之类的软件翻译的，反正读起来比英文还难懂。
服务器端技术，比如ASP、MacromediaColdFusion，JSP，以及PHP在HTML文件里面使用特殊的非HTML语法，服务器在这些代码的基础上创建和提供HTML格式的内容。当Dreamweaver检测到非HTML标签，Dreamweaver会调用第三方标签的定义文件来比较它们，这些文件指定Dreamweaver如何读取和显示这些标签。
举个例子，在标准的HTML语言之外，ASP文件还包含了供服务器解析的ASP代码。ASP代码看起来和HTML标签类似，它由一对标签，开始的<和关闭的>，来作标记。在Dreamweaver的Configuration/ThirdPartyTags文件夹里有一个名为Tags.xml的文件，这个文件就是用来描述包括ASP在内的各种第三方标签规范的，并定义了Dreamweaver如何来显示这些代码。使用这种方法，ASP代码在Tags.xml中已经被规范了，所以Dreamweaver不会再试着在<...>之间解析任何代码。不过在设计视图里面，它会显示一个图标以表示这是ASP代码。你可以定义自己的标签，并且能为每套标签创建一个新的标签库文件，来指定Dreamweaver如何读取和显示你的标签。
注意：这部分说明了如何定义Dreamweaver显示一个自定义标签的方法，但是没有描述如何编辑自定义标签的内容或是属性。如何创建属性检查器来检查和修改自定义标签的属性，请查看属性检查器以获得相关信息。
每个标签库文件都会定义一个或者多个自定义标签的名称、类型、内容模式、显示规范和图标。你可以创建任意数量的标签库文件，但是它们必须位于Configuration/ThirdPartyTags文件夹以便被Dreamweaver读取和处理。标签库文件使用.xml文件扩展名。
提示：如果你同时进行着好几个不同网站的工作（假定当你是个自由职业者的时候），你可以把所有的标签规范定义在一个文件里面，并存放在一个特殊的站点上，将来由其他人维护这个站点的时候，你就可以完整地把包含自定义图标和属性检查器在内的标签库移交给他。
你需要使用一个名为tagspec的XML标签来定义一个标签规范。举例来说，下面的代码表示一个名为happy的标签规范。
你可以使用tagspec来定义两种标签：
·HTML格式的普通标签
happy标签范例是一个HTML格式的普通标签。它开始于标签，在开始标签与结束标签之间包含数据，最后结束于标签。
·字符串界定的标签
字符串界定的标签用一个字符串开始，用另一个字符串结束，它们和HTML空标签（诸如img之类）有类似之处，因为它们既不包含内容也没有关闭标签。如果happy也是一个字符串界定的标签，那它的定义规范里面必须包括start_string与end_string两个属性。ASP标签都是字符串界定的标签，它们从<开始，到>结束，也没有关闭标签。
下面的信息罗列了tagspec标签的各个属性和有效值。带有星号（“*”）的属性表示不适用于字符串界定的标签，可选属性则使用了大括号（{}）来标识；不难推断，其他没有使用大括号标识的都属于必要的属性。
说明
关于第三方标签的预设信息
属性
tag_name，{tag_type}，{render_contents}，{content_model}，{start_string}，{end_string}，{detect_in_attribute}，{parse_attributes}，icon，icon_width，icon_height，{equivalent_tag}，{is_visual}，{server_model}
tag_name表示自定义的名称。对于字符串界定的标签，tag_name仅用于检测一个特定的属性检查器是否适用于这个标签。如果属性检查器的第一行在符合规范的位置（其实就是在第一行的声明里面）包含了这个标签名并标上星号（“*”），那么这个检查器将被允许检查该类型的标签。举个例子，ASP代码的标签名就是ASP，允许检查ASP代码的检查器必须在第一行包含*ASP*。关于属性检查器API的信息，请参看属性检查器。
tag_type确定这个标签是空的（像前面提到的img那样），还是允许在开始与关闭标签之间放置内容（像code标签那样）。这个属性对于普通（非字符串界定的）标签是必要的，但是对字符串界定的标签不生效，因为他们总是空的。有效值包括"empty"和"nonempty"。
render_contents确定在设计视图中，该标签显示内容，还是代之以特定的图标。该属性仅对非空标签是必要的，对于空标签则不生效（空标签本身没有内容可供显示）。该属性仅应用于插入到属性外部的标签，如果一个标签插入其他标签的属性值内，它的内容将不会显示（这一段有点难理解，我想到的是RealMedia、Flash之类的Object，里面的那些param标签？）。有效值为"true"或者是"false"。
content_model描述这个标签能包含哪种内容，还有这个标签能插入到HTML文件的什么地方。有效值包括"block_model"，"head_model"，"marker_model"，以及"script_model"：
·block_model表示该标签可以包含div、p之类的块状对象，并且该标签只可以出现在body区域，或者是插入到其他的body-content标签内，比如div、layer以及td等。
·head_model表示该标签只能包含文字而且只能出现在HEAD范围内。
·marker_model表示该标签能包含任何有效的HTML代码，并且可以放在HTML文件内的任何位置。Dreamweaver内置的HTML检验程序将忽略定义为marker_model的标签。不过，检验程序不会忽略这些标签包含的内容；所以，尽管标签本身可以随处放置，但是它的内容却可能导致HTML的某些地方产生错误。例如，纯文本不能出现（除去合法的head元素）在文档的head区域，所以你不能把一个包含纯文本的marker_model标签放在head区域（如果你要这么做，那你必须把这个标签的内容模式由marker_model替换为head_model）。使用marker_model的标签将会在一行内显示（位于p或者div这样的块状元素内——举个例子，在一个段落里面），如果想让这个标签内显示它自己的段落，前后都留出空行，那么建议不要使用这个模式。
·script_model让这个标签可以放置在文档内HTML标签之间的任何位置。当Dreamweaver检测到使用该模式的标签，将忽略该标签的所有内容。使用这种标记（比如某些ColdFusion标签）后Dreamweaver将不会解析。
start_string指定一个分隔符作为字符串界定的标签的起始点。字符串界定的标签可以被放置在任何可以插入注释的地方。对于start_string和end_string之间的代码，Dreamweaver既不会去解析，也不会去编码或者是作链接。当end_string已经被定义的时候，这个属性是必需的。
end_string指定一个分隔符作为字符串界定的标签的结束点。同样，当start_string已经被定义的时候，这个属性是必需的。
detect_in_attribute指定是否要忽略start_string和end_string之间的所有代码（或者是在开始和结束标签之间，如果这两个字符串没有被定义），不管这些代码之间插入属性还是值。它的默认值是"false"，不过一般情况下字符串界定的标签应该把这个值设置为"true"。例如，ASP标签规范指定detect_in_attribute="true"，这样就算ASP标签内部有包含属性值的引号，也将被Dreamweaver忽略。
parse_attributes表示是否要解析该标签的属性。如果设置为"true"（默认值），Dreamweaver将解析这些属性；如果设置为"false"，Dreamweaver将把引号外部的“>”出现之前的所有代码代码全部忽略。例如，诸如cfif诸如的标签应该将这个属性设置为"false"（因为在这样的标签里面，Dreamweaver无法将其作为一对属性名称／值的组合来解析）。
icon指定匹配该标签的图标的路径和文件名。该属性对于空标签是必要的，另外对那些内容不能显示在文档窗口的设计视图中的非空标签也同样是必要的。
icon_width指定图标的像素宽度。
icon_height指定图标的像素高度。
equivalent_tag为ColdFusion里某些和表单关联的标签指定简单的HTML等价物。其他标签不能使用该属性。
is_visual指定该标签是否在页面上可见。例如，ColdFusion标签cfgraph没有指定is_visual的值（因此使用默认值"true"），ColdFusion标签cfset指定了is_visual的值为"false"。在预设对话框的“不可见元素”一栏内，你可以控制服务器标签的可见性；可视化服务器标签与不可视化服务器标签的可见性可以分开设置。
server_model，如果设置了该属性，表示tagspec标签仅可应用于属于指定服务器模式的页面。如果没有设置，则tagspec可以应用于所有页面。例如，ASP和JSP的定界符是一样的，但是适用JSP的tagspec标签指定了服务器模式为"JSP"，所以当Dreamweaver在JSP页面检测到特定的定界符，它会显示一个JSP的图标；当在非JSP页面检测到相同的代码，它会显示ASP图标。
内容
无（空标签）。
容器
无。
示例
自定义标签在设计视图如何显示
自定义标签在文档窗口的设计视图中显示的方式，决定于tagspec标签的tag_type属性和render_contents属性的值（请参看自定义第三方标签的解析）。如果tag_type的值为"empty"，就显示icon属性定义的指定图标。如果tag_type的值为"nonempty"，但是render_contents的值为"false"，也会像空标签那样显示图标。下面的例子演示了我们刚才定义的happy标签的一个实例如何插入到HTML代码中：
Thisisaparagraphthatincludesaninstanceofthehappytag(Joe).
因为在标签规范里，render_contents已经被设置为"false"，所以happy标签（单词joe）将不被显示，开始和关闭标签包括它们之间的内容将被替换成一个简单的图标。
对于一个render_contents值为"true"的非空标签，设计视图不会将其显示为图标，而是显示开始标签与关闭标签之间的内容（比如标签之间的文本，就像这样：这里是开始与关闭标签之间的内容）。如果在菜单选项中，查看>可视化助理>不可见元素已经被选中，那么这些内容将会使用“代码颜色”参数指定的第三方标签颜色来高亮显示（“代码颜色”仅应用于标签库文件定义的标签）
如何更改第三方标签的高亮颜色：
1、选择菜单选项中的编辑>首选参数，然后选择“代码颜色”栏。
2、点击第三方标签颜色框以显示颜色选择器。
3、选择一种颜色，然后点击“确定”并关闭预设对话框。关于如何选择颜色，另请参看使用Dreamweaver。
避免改写第三方标签
Dreamweaver会在HTML代码中校正某些特定的错误，详细信息请参考使用Dreamweaver。默认情况下，Dreamweaver禁止在特定文件扩展名的文件中更改HTML代码，这些文件名包括.asp（ASP）、.cfm（ColdFusion）、.jsp（JSP），以及.php（PHP）。这样的默认设置是为了保证Dreamweaver不会意外地修改任何包含在非HTML标签里面的代码。你可以更改Dreamweaver的默认改写行为，以便在打开这类文件的时候改写HTML代码，并且你也可以在Dreamweaver禁止改写的文件类型列表里面加入其他的文件类型。
当你把某些特殊字符输入到属性检查器的时候，Dreamweaver会把它们编码成数值。一般来说，让Dreamweaver执行这种编码是最好的，因为这些特殊字符在跨越不同的平台和浏览器的时候，将可能被更好地显示。不过，因为这种编码会影响第三方标签，所以当你在编辑包括第三方标签的文件时，你可能要更改Dreamweaver的编码行为。
允许Dreamweaver在更多类型的文件中改写HTML：
1、选择菜单选项中的编辑>首选参数，然后选择“代码改写”栏
2、选择下面的任何一项：
·修正非法嵌套标签或未结束标签
·删除多余的结束标签
3、执行下面的一项：
·从“从不改写代码：在带有扩展的文件中”的文件扩展名列表里面删除一个或多个。
·取消“从不改写代码：在带有扩展的文件中”选项。请注意：这样会导致Dreamweaver可以在任何类型的文件中改写HTML代码。
添加Dreamweaver禁止改写的文件类型：
1、选择菜单选项中的编辑>首选参数，然后选择“代码改写”栏
2、选择下面的任何一项：
·修正非法嵌套标签或未结束标签
·删除多余的结束标签
3、确认“从不改写代码：在带有扩展的文件中”项已被选中，把新的文件扩展名加入文本框的列表中。
如果新的文件类型不会显示在“文件>打开”对话框的弹出菜单内，你可能需要把它增加到Configuration/Extensions.txt文件夹里面。详细信息，请参看改变默认的文件类型。
关闭Dreamweaver的编码选项：
1、选择菜单选项中的编辑>首选参数，然后选择“代码改写”栏
2、取消两个“特殊字符编码”选项中的任何一个。
关于“代码改写”参数选择的其他信息，请参看使用Dreamweaver。
