欧宝官网下载app文档格式

编辑本页

警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 4.3,现已不再维护。

本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。

欧宝官网下载app文档格式

Symfob娱乐下载ony文档使用的欧宝官网下载appreStructuredText作为其标记语言和斯芬克斯用于生成终端用户可阅读的格式的文档,例欧宝官网下载app如HTML和PDF。

reStructuredText

reStructuredText是一种与Markdown类似的纯文本标记语法,但语法要严格得多。如果您是reStructuredText的新手,请花一些时间通过阅读现有的文本来熟悉这种格式ob娱乐下载Symfony的欧宝官网下载app文档源代码。

如果您想了解更多关于此格式的信息,请查看reStructuredText底漆教程和reStructuredText参考

谨慎

如果你熟悉Markdown,请小心,因为有时情况非常相似但又不同:

  • Lists从一行的开头开始(不允许缩进);
  • 内联代码块使用双引号(这样的' ' ' ').

斯芬克斯

斯芬克斯是一个构建系统,它提供了从reStructuredText文档创建文档的工具。欧宝官网下载app因此,它向标准reStructuredText标记添加了新的指令和解释文本角色。阅读更多有关Sphinx标记构造

语法高亮显示

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

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

请注意

除了所有主要的编程语言,语法高亮显示器还支持各种标记和配置语言。看看列表支持的语言在语法高亮显示网站上。

配置块

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

12 3 4 5 6 7 8 9 10 11 12 13
..配置块::..代码块:yaml# YAML中的配置..xml代码:<!——XML配置——>..php代码:// PHP中的配置

之前的reStructuredText代码片段呈现如下:

  • YAML
  • XML
  • PHP
1
# YAML中的配置

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

标记格式 使用它来显示
超文本标记语言 超文本标记语言
xml XML
php PHP
yaml YAML
嫩枝 纯Twig标记
html +树枝 混合了HTML的树枝标记
html + php 混合HTML的PHP代码
ini INI
php-annotations PHP的注释

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

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

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

1 2 3 4 5
医生:“/控制器”医生:' /组件/ event_dispatch '医生:“/配置/环境”

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

1
医生:' Doctrine Associations  '

请注意

虽然它们在技术上是正确的,但避免使用如下这样的相对内部链接,因为它们会破坏生成的PDF文档中的引用:欧宝官网下载app

1 2 3 4 5
医生:“控制器”医生:“event_dispatch”医生:“环境”

到API的链接遵循不同的语法,其中必须指定链接资源的类型(方法):

1 2 3
类:“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:: 4. x指令:

1 2 3
..versionadded:: 4.2在Symfony 4.2中引入了命名的自动装配别名。ob娱乐下载

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

1 2 3 4
..在Symfony 4.2中引入了对ICU MessageFormat的支持。ob娱乐下载在此之前,多元化是由' ' transChoice '的方法。

用于弃用..弃用::4. x指令:

1 2 3
..弃用::4.2不将根节点名称传递给' ' TreeBuilder ' '在Symfony 4.2中已弃用。ob娱乐下载

每当Symfony的一个新的主要版本发布时(例如5.0、6.0等ob娱乐下载),文档的一个新分支就会从欧宝官网下载app分支。此时此刻,所有的versionadded而且弃用带有较低主版本的Sob娱乐下载ymfony版本的标签将被删除。例如,如果Symfony 5.0ob娱乐下载今天发布,4.0到4.4versionadded而且弃用标签将从新的5.0分支。

此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。