| Attribute Name | Type | Required | Default | Description |
|---|---|---|---|---|
| file | string | Yes | n/a | The name of the config file to include |
| section | string | No | n/a | The name of the section to load |
| scope | string | no | local | How the scope of the loaded variables are treated, which must be one of local, parent or global. local means variables are loaded into the local template context. parent means variables are loaded into both the local context and the parent template that called it. global means variables are available to all templates. |
| global | boolean | No | No | Whether or not variables are visible to the parent template, same as scope=parent. NOTE: This attribute is deprecated by the scope attribute, but still supported. If scope is supplied, this value is ignored. |
This function is used for loading in variables from a configuration file into the template. See Config Files for more info.
此函式的功能在將組態檔的變數載入樣版中,更多的訊息請參閱 Config Files。
Config files may also contain sections. You can load variables from within a section with the added attribute section.
組態檔中可能還會包含區塊,所以你也可以使用屬性 section 載入區塊內的變數。
Note: Config file sections and the built-in template function called section have nothing to do with each other, they just happen to share a common naming convention.
提醒: Config file sections 與內建的 section 樣板函式不會互相干擾,她們只是使用相同的命名方式。