语法高亮显示

PHP是应用于所有代码块的默认语法高亮显示。你可以用代码块指令:

1 2 3

. .代码块:yaml{foo: bar, bar: {foo: bar, bar: baz}}

配置块

每当包含配置示例时，请使用配置块指令以所有支持的配置格式显示配置(PHP，YAML而且XML)．例子:

12 3 4 5 6 7 8 9 10 11 12 13

. .配置块::. .代码块:yaml# YAML中的配置. .xml代码:<！——XML配置——>. .php代码:// PHP中的配置

前面的reST代码片段如下所示:

1

# YAML中的配置

1

<！——XML配置——>

1

// PHP中的配置

当前支持的格式列表如下:

添加链接

最常见的链接类型是内部链接到使用以下语法的其欧宝官网下载app他文档页:

1

医生:“绝对路径/ /页面”

页名不应包括文件扩展名(首要)．例如:

1 2 3 4 5

医生:“/ book /控制器”医生:/组件/ event_dispatch /介绍的医生:“/食谱/配置/环境”

链接页面的标题将自动用作链接的文本。如果你想修改这个标题，请使用下面的语法:

1

医生:' Spooling Email  '

1 2 3 4 5

医生:“控制器”医生:“event_dispatch /介绍”医生:“环境”

到API的链接遵循不同的语法，其中必须指定链接资源的类型(名称空间，类或方法)：

1 2 3 4 5

名称空间:“ob娱乐下载Symfony \ \ \ \ BrowserKit组件”类:“ob娱乐下载Symfony组件\ \ \ \ \ \匹配器\ \ ApacheUrlMatcher路由的方法:的ob娱乐下载Symfony \ \ HttpKernel \ \ \ \组件包\ \包::构建的

到PHP文档的链接欧宝官网下载app遵循非常相似的语法:

1 2 3 4 5

: phpclass:“SimpleXMLElement”: phpmethod:DateTime:: createFromFormat”: phpfunction:“iterator_to_array”

新特性或行为变化

如果您正在记录一个全新的特性或Symfony中所做的更改，那么您应该在描述更改之前加上ob娱乐下载. .versionadded:: 2。X说明和简短说明:

1 2 3 4

. .versionadded:: 2.3askHiddenResponse方法是在Symfony 2.3中引入的。ob娱乐下载你也可以问一个问题，然后隐藏答案。这尤其[…]

如果你正在记录一个行为改变，它可能会有帮助短暂的描述行为是如何改变的:

1 2 3

. .versionadded:: 2.3include()函数是一个新的Twig特性，在ob娱乐下载Symfony 2.3。之前，使用了' ' {% include %} ' '标记。

每当一个新的Symfony小版本发布时(例如2.4、2.5等)，ob娱乐下载文档的一个新分支就会从欧宝官网下载app主分支。此时此刻，所有的versionadded已经结束维护的Syob娱乐下载mfony版本的标签将被删除。例如，如果Symfony 2.5ob娱乐下载今天发布，而2.2最近已经走到了生命的尽头，那么2.2versionadded标签将从新的2.5分支。

测试文档欧宝官网下载app

当向文档存储库提交新内容或更改任何现有资源时，一个自动流程将检查您的文档是欧宝官网下载app否没有语法错误，是否可以进行检查。

然而，如果你更喜欢在提交文档之前在自己的机器上进行本地检查，请遵循以下步骤:欧宝官网下载app

• 安装斯芬克斯；
• 使用git子模块安装Sphinx扩展:$ git子模块update——init；
• 运行使html和查看生成的HTML_build / html目录中。