Skip to content

Commit a7aedb0

Browse files
committed
导航调整
为了让文档的导航更清晰,所以对几个 .. toctree:: 进行了一些调整。
1 parent 29cb7c4 commit a7aedb0

7 files changed

+102
-24
lines changed

README.markdown

+95
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,101 @@
109109
- `severity.rst`
110110
- `translations.rst`
111111

112+
### 导航调整
113+
114+
为了让文档的导航更清晰,所以对几个 `.. toctree::` 进行了一些调整。
115+
116+
**configuration.rst**
117+
118+
```diff
119+
.. index::
120+
single: Configuration
121+
122+
- 配置 Symfony (以及环境)
123+
+ 配置
124+
125+
======================================
126+
```
127+
128+
**index.rst**
129+
130+
```diff
131+
bundles
132+
+ configuration
133+
console
134+
+ controller
135+
doctrine
136+
137+
....
138+
139+
service_container
140+
+ templating
141+
testing
142+
```
143+
144+
**controller.rst**
145+
146+
```diff
147+
扩展阅读
148+
----------------------------
149+
150+
- .. toctree::
151+
- :hidden:
152+
-
153+
- templating
154+
155+
```
156+
157+
**page_creation.rst**
158+
159+
```diff
160+
深入了解HTTP和框架基础知识
161+
----------------------------
162+
163+
- .. toctree::
164+
- :hidden:
165+
-
166+
- routing
167+
168+
```
169+
170+
**routing.rst**
171+
172+
```diff
173+
扩展阅读
174+
----------------------------
175+
176+
- .. toctree::
177+
- :hidden:
178+
-
179+
- controller
180+
181+
```
182+
183+
**templating.rst**
184+
185+
```diff
186+
.. index::
187+
single: Templating
188+
189+
- 创建和使用模板
190+
+ 模板
191+
192+
......
193+
194+
扩展阅读
195+
----------------------------
196+
197+
- .. toctree::
198+
- :hidden:
199+
-
200+
- configuration
201+
202+
```
203+
204+
205+
> 这些调整不会影响正文内容,只是生成的导航位置不一样
206+
112207
## 术语约定
113208

114209
- `Route`:路由

configuration.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.. index::
22
single: Configuration
33

4-
配置 Symfony (以及环境)
4+
配置
55
======================================
66

77
Symfony应用可以安装第三方软件包(bundles,库等),为项目引入新功能(:doc:`服务 </service_container>`)。

controller.rst

-5
Original file line numberDiff line numberDiff line change
@@ -565,11 +565,6 @@ Symfony会将 ``Request`` 对象传递给任何使用 ``Request`` 类进行类
565565
扩展阅读
566566
----------------------------
567567

568-
.. toctree::
569-
:hidden:
570-
571-
templating
572-
573568
.. toctree::
574569
:maxdepth: 1
575570
:glob:

index.rst

+3
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,9 @@ Symfony中文文档
3232
:maxdepth: 1
3333

3434
bundles
35+
configuration
3536
console
37+
controller
3638
doctrine
3739
deployment
3840
email
@@ -50,6 +52,7 @@ Symfony中文文档
5052
setup
5153
serializer
5254
service_container
55+
templating
5356
testing
5457
translation
5558
validation

page_creation.rst

-5
Original file line numberDiff line numberDiff line change
@@ -296,11 +296,6 @@ Symfony的 *杀手级* 功能之一是Web调试工具栏:
296296
深入了解HTTP和框架基础知识
297297
--------------------------------------------
298298

299-
.. toctree::
300-
:hidden:
301-
302-
routing
303-
304299
.. toctree::
305300
:maxdepth: 1
306301
:glob:

routing.rst

+1-6
Original file line numberDiff line numberDiff line change
@@ -913,12 +913,7 @@ Symfony遵循这个逻辑,在带有和不带尾部斜杠的URL之间重定向
913913
现在,揭示 :doc:`控制器 </controller>` 的能力。
914914

915915
扩展阅读
916-
------------------------
917-
918-
.. toctree::
919-
:hidden:
920-
921-
controller
916+
---------------
922917

923918
.. toctree::
924919
:maxdepth: 1

templating.rst

+2-7
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.. index::
22
single: Templating
33

4-
创建和使用模板
4+
模板
55
============================
66

77
如同 :doc:`前文 </controller>` 所述,
@@ -698,14 +698,9 @@ Symfony同样在Twig中给了你一个全局的 ``app`` 变量,可以用于访
698698

699699
在深入了解Symfony的其他部分之前,请查看 :doc:`配置系统 </configuration>`。
700700

701-
更多关于模板的内容
701+
扩展阅读
702702
----------------------
703703

704-
.. toctree::
705-
:hidden:
706-
707-
configuration
708-
709704
.. toctree::
710705
:maxdepth: 1
711706
:glob:

0 commit comments

Comments
 (0)