配置文件夹

许多 Dreamweaver CS3 功能都是以 JavaScript 和 HTML 开发的扩展。配置文件夹包含这些扩展。如果要自定义或扩展 Dreamweaver 产品,需要修改配置文件夹中的文件或将源代码文件添加到一个或多个配置文件夹中。熟悉这些文件夹后,就可以找到扩展接口以及每种扩展类型的操作示例。

警告:配置文件夹中的文件涉及大部分 Dreamweaver 产品的配置。除非您知道如何自定义和扩展 Dreamweaver,否则不要对这些文件执行修改、删除或添加操作。 在您尝试自定义 Dreamweaver 之前,请阅读《扩展 Dreamweaver》(“帮助”>“扩展”>“扩展 Dreamweaver”)和《Dreamweaver API 参考》(“帮助”>“扩展”>“API 参考”)。

有些文件夹名称的意思显而易见。例如,对象保存在 Objects 文件夹中;行为保存在 Behaviors 文件夹中。但是 Shared 文件夹不对应于特定的扩展类型。Shared 文件夹是所有扩展所常用的实用程序函数、类和图像的中央存储库。

Dreamweaver CS3 的每次后续安装都会生成另一个版本的配置目录。Dreamweaver 为每个旧的配置文件夹追加一个版本号(例如,“Configuration-1”、“Configuration-2”等),版本号越大,文件夹越旧。总是将配置文件夹的最新版本简称为“Configuration”。

下列配置文件和文件夹对应于 Dreamweaver CS3 功能的组织方式:

文件/文件夹名称 内容
ActiveXNames.txt ActiveX 类 ID 的列表;用于填充 ActiveX 检查器中的 ClassID 弹出菜单。
fields.css 配置文件夹中的对话框和“属性”检查器的样式表。该文件主要用于定义表单元素的大小以帮助实现本地化(例如,如果显示连接或记录集名称的菜单为德文时需要放大 30%,则增大 fields.css 中的一两个值很容易更改所有这些菜单)。为此,任何值的调整都须谨慎,因为任何更改都可能影响多个对话框和“属性”检查器。
Extensions.txt

Dreamweaver 可识别的文件扩展名的列表。

如果将某个扩展名添加到此列表中,则在“站点”面板中双击具有该扩展名的文件时会在 Dreamweaver 中打开该文件。

Extensions.txt 还决定了在“文件”>“打开”对话框中显示哪些文件类型。默认情况下,要在该对话框中显示特定类型的文件,需要将相应的扩展名添加到 Extensions.txt 的第一行。有关详细信息,请参阅《扩展 Dreamweaver》

FTPExtensionMap.txt

文件扩展名及其关联的传输模式的列表。

此文件决定 Dreamweaver 如何上传和下载文件,是以 ASCII 模式还是以二进制模式。您可以向该列表添加项目或更改现有项目的模式。在 Macintosh 中,此文件也用于设置从非 Macintosh 服务器下载的文件的文件类型和创建者。

version.xml

version.xml 文件包含您的 Dreamweaver 安装的相关信息。不要编辑或删除此文件。

Behaviors “行为”检查器使用的文件。
  Actions

显示在“行为”检查器的“动作 (+)”弹出菜单中的项目。

出于本地化目的,每个动作均分成两个文件(一个 .js 文件和一个 .htm 文件)。HTML 文件包含行为的界面:选择“动作”弹出菜单中的动作时显示在对话框中的文本域和表单域。JavaScript 文件包含用于将行为插入文档的 JavaScript 代码。除非您精通 JavaScript 并熟悉《扩展 Dreamweaver》所述的行为 API,否则不要对此文件做任何更改。

  Events

显示在“动作”菜单底部的“显示事件”子菜单中的项目。

每个文件都是根据它所代表的浏览器或 W3C 规范命名的,并且包含 HTML 元素以及每个元素所支持的事件列表。如果文件的名称包含多个浏览器(例如“4.0 和更高版本的浏览器”),则列出的事件即为该名称中的所有浏览器支持的事件。也就是说,列出的事件代表浏览器支持的交集。

对于每个元素,均使用星号标记事件(例如,onClick="*")。这是元素的默认事件。除非在动作文件中指定,否则在将行为应用到该元素时,此事件将显示在“行为”检查器的“事件”列中。

BrowserProfiles

浏览器兼容性检查功能使用的文件。

此文件夹中的每个文件都是根据它所代表的浏览器命名的。HTML 文件包含浏览器的正式名称;因为 Issues 文件夹中的文件依赖它,所以不应更改它。XML 文件包含有关该浏览器支持和不支持的 CSS 属性和值的信息。有关浏览器配置文件的详细信息,请参阅《扩展 Dreamweaver》

  Issues

其中的文件定义了浏览器呈现问题并在用户的文档搜索这些问题。当用户运行浏览器兼容性检查时会执行此文件夹中的文件。

出于本地化目的,每个问题均分成两个文件(一个 .js 文件和一个 .htm 文件)。HTML 文件包含可本地化的字符串,当检查到问题时,会在“浏览器兼容性检查”面板中为用户显示这些字符串。(问题本身不具有任何用户界面,因此 HTML 问题文件的正文是空的。)JavaScript 文件包含 JavaScript 代码,这些代码定义与该问题相关的浏览器、从 HTML 文件返回字符串以及检测用户的文档中是否存在问题。除非您精通 JavaScript 并熟悉《扩展 Dreamweaver》所述的问题 API,否则不要对此文件做任何更改。

BuiltIn

创建各种文档的模板,包括不同的页面布局。

Classes

用于将 JavaBeans 作为数据源读取的文件。

CodeColoring

XML 文件,包含文档代码视图的颜色分配。CodeColoring 目录还具有对应于支持的脚本语言(Javascript、VBScript、C# 和 Visual Basic)的特定文件,在这些文件中,颜色被分配给代码块和关键字。

CodeHints XML 文件,包含用于在“代码”视图中进行编辑时提供代码提示的关联和内容。(请注意,许多可用作代码提示的标签和属性都来自标签库;请参阅下面的 Tag Libraries 文件夹。)
Commands

显示在“命令”菜单(以及 Dreamweaver 其它菜单)中的项目。

出于本地化目的,此文件夹中的许多命令都分成两个文件(一个 .js 文件和一个 .htm 文件)。如果有命令的话,HTML 文件包含命令的界面,即选择菜单中的命令时显示在对话框中的文本域和表单域;并且也可能包含可本地化的字符串和对外部 JavaScript 文件(包括相同名称的 .js 文件)的引用。JavaScript 文件包含使命令能够运行的 JavaScript 代码;除非您精通 JavaScript,否则不要对此文件做任何更改。

您可能会注意到 Commands 文件夹中的某些项目与 Objects 文件夹中的某些项目具有相同的名称。这是因为有些对象会启动命令。命令比对象更灵活,但只有对象才能显示在“插入”面板中。通过从对象文件调用命令,Dreamweaver 可以同时获得这两种扩展的优点。

Components

对于每个支持的服务器模型(ASP.Net/C#、ASP.Net/VisualBasic、ASP/JavaScript、ASP/VBScript、ColdFusion、JSP 和 PHP/MySQL),Components 目录均具有一个子文件夹。这些目录中的文件建立了用于管理到服务器的连接的菜单项。ColdFusion 子文件夹也包含用于定义 ColdFusion 数据源、组件 (CFC) 和 Web 服务的支持文件。

Connections

此目录中的文件决定显示在数据库面板的加号 (+) 弹出菜单中的内容。此目录也包含用于检索服务器数据的脚本(存储在 Scripts 子文件夹中)。有关数据连接的详细信息,请参阅《扩展 Dreamweaver》中的“数据库 API”。

Content

Content 文件夹包含检查拼写功能的字典文件以及“参考”面板使用的所有文件。

Data Sources

“动态数据”对话框和“绑定”面板使用的文件。

显示在这些用户界面的加号 (+) 弹出菜单中的动态数据对象取决于为站点指定的服务器模型。有关编辑 Data Sources 文件的详细信息,请参阅《扩展 Dreamweaver》中的“数据源 API”。

Debugger

JavaScript Debugger 模块的支持文件。

DocumentTypes

每个支持的文档类型的基本模板。

Encodings

Dreamweaver 的额外字符编码;用于填充“页面属性”对话框中的“文档编码”弹出菜单。

默认情况下,Dreamweaver 支持多种编码,包括 UTF-8 (Unicode)、西欧语系 (Latin1)、日语(Shift JIS、JIS、EUC)、繁体中文、简体中文和韩文。这些编码总是显示在“文档编码”弹出菜单中,并且不能删除。对于其他语言和字符集(包括西里尔语、希腊语和冰岛语)的支持由此文件夹中的文件提供。

ExtensionData

注意:仅出于向后兼容性而包含此目录中的文件,并且当前方法不通过它来使用扩展。

XML 元数据:扩展的组和成员数据,包括服务器行为。

  MM

XML 组和成员扩展数据文件。

Flash Objects

用于创建 Flash 按钮和 Flash 文本对象的 Flash 模板(.swt 文件)。

  Flash Buttons

Flash 按钮模板文件。

  Flash Buttons Preview

Flash 按钮模板的 SWF 预览。

  Flash Text

Flash 文本模板文件。

Flash Player

欢迎辞以及其它互动信息的 SWF。

Floaters

自定义浮动面板。

如果创建或下载自定义浮动面板,应将其保存在此文件夹中。

Formatters 用于应用各种显示格式(例如不同的“日期/时间”显示格式或将文本全部设置为大写或小写)的脚本。
Generator

使用 Dreamweaver 中的 Flash 对象所需的文件。

Inspectors

自定义“属性”检查器。

Dreamweaver 中的大多数“属性”检查器都内置到该产品的核心代码中,但有些检查器(例如 METATITLELINK 标签的检查器)则是以 HTML 和 JavaScript 编写的。出于本地化目的,此文件夹中的“属性”检查器都分成两个文件(一个 .js 文件和一个 .htm 文件)。HTML 文件包含检查器的界面:显示在“属性”检查器浮动面板中的文本域和表单域。JavaScript 文件包含使检查器工作的 JavaScript 代码;除非您精通 JavaScript 并熟悉《扩展 Dreamweaver》中所述的“属性”检查器 API,否则不要对此文件做任何更改。

JDBCDrivers 用于存储客户端 JDBC 驱动程序以在 Dreamweaver 中用于为 JSP 文件建立本地连接的目录。
JSExtensions

自定义共享库。

此文件夹中的自定义共享库通过添加新的 JavaScript 函数来使 Dreamweaver 的扩展变得更强大、更灵活。因为 Translators 和 Commands 文件中的一些文件依赖于这些共享库,所以不能将它们删除。要将您自己的共享库添加到 Dreamweaver,请参阅《扩展 Dreamweaver》中有关 C 级可扩展性的部分。

Menus

定义 Dreamweaver 的整个菜单结构的文件 (menus.xml) 以及该文件的一个备份副本 (menus.bak) 以允许您还原默认菜单。

menus.xml 文件指定 Dreamweaver 中所有菜单和菜单项的名称和行为(有几个明显的例外,例如“行为”和“服务器行为”面板中的 (+) 菜单;有关如何分别填充这两种菜单的信息,请参阅上面的“Behaviors”和下面的“ServerBehaviors”)。它还指定 Dreamweaver 使用的所有键盘快捷键和助记键。有关菜单命令和 menus.xml 信息,请参阅《扩展 Dreamweaver》中的“菜单和菜单命令”。

  Custom Sets

提供类似其它产品的键盘快捷键的 menu.xml 文件自定义。

  MM

控制 Dreamweaver 中许多菜单项行为的文件(称为菜单命令)。

此文件夹保留用于 Dreamweaver 附带的菜单命令。若要添加自己的菜单命令,请将它们保存在 Menus 文件夹的另一个子文件夹中。

Objects

显示在“插入”菜单和“插入”栏中的项目。

若要显示在“插入”栏和“插入”菜单中,所有 Object 文件都必须保存在 Objects 文件夹的子文件夹中并列在 insertbar.xml 和 menus.xml 文件中。有关修改这些文件的详细信息,请参阅《扩展 Dreamweaver》中的“插入栏对象”。

Plugins (Windows)
plug-ins (Macintosh)

任何可用于在 Dreamweaver 中播放活动内容(例如 Flash 和 Shockwave 影片)的插件,以及 Dreamweaver 不支持的插件列表 (UnsupportedPlugins.txt)。

当您选择播放插件内容时,Dreamweaver 会自动扫描硬盘上任何浏览器的插件文件夹以寻找合适的插件,因此不一定必须将插件保存在此文件夹中。

Queries

在“查找”或“替换”对话框中保存的搜索模式。默认情况下,此文件夹是空的。

Reports

与站点报告功能相关联的文件。

Reports 中的文件夹包含 Dreamweaver 附带的站点报告;您可以创建其它报告并保存在现有的文件夹中,或创建新的子文件夹。有关报告的详细信息,请参阅《扩展 Dreamweaver》中的“报告 API”。

  HTML Reports

用于分析 HTML(例如查找缺少 alt 属性的图像、删除空标签或查找无标题文档)的报告文件。

  Workflow

用于协助站点维护任务(例如查找特定用户签出的所有文件或查找最近修改的文档)的报告文件。

Server Behaviors

“服务器行为”检查器使用的文件。每个服务器模型(ASP.Net/C#、ASP.Net/VisualBasic、ASP/JavaScript、ASP/VBScript、ColdFusion、JSP 和 PHP/MySQL)都有一个对应的子文件夹。每个子文件夹中的 ServerBehaviors.xml 文件决定了在“服务器行为”面板的加号 (+) 菜单中显示的内容。

服务器行为创建 Web 应用程序需要的功能,例如根据用户条件筛选记录、通过记录分页、将结果列表链接到详细页,以及将记录插入结果集。有关编辑 Server Behaviors 文件的详细信息,请参阅《扩展 Dreamweaver》中的“服务器行为”。

ServerDebugOutput

ColdFusion 调试的支持文件。

Server Formats

用于设置动态数据格式的文件。每种服务器格式(ASP.Net/C#、ASP.Net/VisualBasic、ASP/JavaScript、ASP/VBScript、ColdFusion、JSP 和 PHP/MySQL)都有一个对应的子文件夹。每个子文件夹中的 Formats.xml 文件决定了在“格式”菜单中显示的内容;如果想要添加其它格式,可以(谨慎地)对它进行手动编辑。

有关编辑 Server Formats 文件的详细信息,请参阅《扩展 Dreamweaver》中的“数据格式设置”。

Server Models

定义可用的服务器模型的文件。每种服务器模型(ASP.Net/C#、ASP.Net/VisualBasic、ASP/JavaScript、ASP/VBScript、ColdFusion、JSP 和 PHP/MySQL)都有一个包含配置信息的 HTML 文件和一个对应的子文件夹(用以保存每种服务器模型的某些函数的特定实现)。
有关编辑 Server Model 文件的详细信息,请参阅《扩展 Dreamweaver》中的“服务器模型”。

Shared

由多个扩展共享的文件。(任何扩展都能引用这些目录中的文件。)

许多第三方扩展以及许多 Dreamweaver 功能都依赖于 Shared 文件中定义的函数,因此绝对不能覆盖此文件夹中的文件,并且不能修改这些文件中的现有函数。

若要添加您自己的共享文件,请在 Shared 目录中创建一个单独的文件夹来保存您的文件。

  Common

用于整个配置文件夹中的扩展的共享脚本和类。

  Controls

主要用于服务器行为的常用用户界面控件。

  Fireworks

Fireworks 集成的支持文件。

  MM

Dreamweaver 附带的扩展使用的共享脚本、图像和类。第三方扩展也可能使用这些文件,但通常可以在 Common 文件夹下的文件中找到更新的功能。

  UltraDev

Dreamweaver 附带的服务器相关扩展使用的共享脚本、图像和类。第三方扩展也可能使用这些文件,但通常可以在 Common 文件夹下的文件中找到更新的功能。

  UsableNet_508ASOEM “辅助功能”报告的支持文件(请参阅上面的“Reports”)。
Shutdown

应在 Dreamweaver 关闭时执行的命令。通常由扩展用于清除它们所创建的临时文件。

Snippets

“代码片断”面板的支持文件和默认内容。

Startup

Dreamweaver 启动时运行的脚本。

有关创建启动脚本的详细信息,请参阅《扩展 Dreamweaver》中的“文档对象模型”。

Strings

Strings 目录包含指定填充各种消息和对话框的内容的 XML 文件。

TagLibIntrospection 标签库标签导入程序的支持文件(标签导入程序位于 TagLibraries/TagImporters 目录中)。
TagLibraries 包含 Dreamweaver 支持的标记和脚本语言的标签数据库 (TagLibraries.vtm) 和标签定义文件。

这些文件夹也包含 Dreamweaver 显示给用户的编辑标签对话框界面的文件。有关详细信息,请参阅《扩展 Dreamweaver》中的“标签库和对话框”。
Third Party Source Code 为 Dreamweaver 提供功能的来自 Macromedia 外部源的文件。例如,此文件夹包含 Dreamweaver 所使用的 JavaScript 解释器。
ThirdPartyTags

定义第三方标记(例如 ASP、PHP 和自定义 HTML)的语法和标签名称的文件。

第三方标签定义文件是 XML 文件。每个 XML 文件均包含一个或多个标签规范 (tagspec),而每个标签规范都可能具有一个为标记定义图标的关联 GIF 文件。有关第三方标签和标签规范的详细信息,请参阅《扩展 Dreamweaver》

Toolbars

定义可用的工具栏以及每个工具栏上的图标和命令。

Translators 数据转换支持文件。数据转换器将专门的标记 server-side include(服务器端包括)、条件 JavaScript 语句或其它代码(如 PHP3、JSP、CFML 或 ASP)转换为 Dreamweaver 可读取和显示的代码。
Validators 向表单添加文本域输入验证的支持脚本。
WebServices

特定 Web 服务连接的支持文件。