叶子的宏。
foliantcontrib.macros的Python项目详细描述
#用于叶
*macro*的宏是一个带有占位符的字符串,在文档生成期间用预定义内容替换。宏是在配置中定义的。
``shell
$pip install foliantcontrib.macros
```
` ` `
` ` ` ` `
``启用预处理器,方法是:将预处理器添加到预处理器中,并在‘宏’字典中列出您的宏:
``yaml
``yaml
预处理器中,预/>宏:
foo:这是一个宏定义。
bar:“这是一个宏,参数为:{0}”
````
用法
这里是宏最简单的用法:
```yaml
预处理器:
-宏:
宏:
支持号:
支持号:'8 800 123-45-67“
``
```
这是宏宏宏宏的定义:
这是宏:
br/>支持插入您的支持电话号码,你可以放一个宏:
``降价
给你的支持团队打电话:<;宏>;支持号码<;/宏>;
这里是另一个号码:<;<;m>;支持号码<;/m>;
```
宏在文档中很有用,当相同的操作完成时,它们应该被构建到多个目标中,例如站点和pdf在一个目标中与在另一个目标中不同。
例如,要引用mkdocs中的一个页面,只需将标记文件放在链接中:
``标记
这里是[另一个页面](另一个页面.md)。
`````
因此,您可以通过锚定链接引用文档的不同部分:
``markdown
这里是[另一页](\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\(一)有权使用;另一个页面。md<;/if>;)。
```
>当您在文档中使用多个交叉引用时,这个庞大的构造会很快变旧。
if backends=“pandoc”>;{0}<;/if>;<;if backends=“mkdocs”>;{1}<;/if>;
`````
并在源代码中使用它:
``标记
这里是[另一页](<;<;宏参数=““另一页,另一页.md”>;ref<;/宏>;)。
``
`>
*macro*的宏是一个带有占位符的字符串,在文档生成期间用预定义内容替换。宏是在配置中定义的。
``shell
$pip install foliantcontrib.macros
```
` ` `
` ` ` ` `
``启用预处理器,方法是:将预处理器添加到预处理器中,并在‘宏’字典中列出您的宏:
``yaml
``yaml
预处理器中,预/>宏:
foo:这是一个宏定义。
bar:“这是一个宏,参数为:{0}”
````
用法
这里是宏最简单的用法:
```yaml
预处理器:
-宏:
宏:
支持号:
支持号:'8 800 123-45-67“
``
```
这是宏宏宏宏的定义:
这是宏:
br/>支持插入您的支持电话号码,你可以放一个宏:
``降价
给你的支持团队打电话:<;宏>;支持号码<;/宏>;
这里是另一个号码:<;<;m>;支持号码<;/m>;
```
宏在文档中很有用,当相同的操作完成时,它们应该被构建到多个目标中,例如站点和pdf在一个目标中与在另一个目标中不同。
例如,要引用mkdocs中的一个页面,只需将标记文件放在链接中:
``标记
这里是[另一个页面](另一个页面.md)。
`````
因此,您可以通过锚定链接引用文档的不同部分:
``markdown
这里是[另一页](\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\(一)有权使用;另一个页面。md<;/if>;)。
```
>当您在文档中使用多个交叉引用时,这个庞大的构造会很快变旧。
if backends=“pandoc”>;{0}<;/if>;<;if backends=“mkdocs”>;{1}<;/if>;
`````
并在源代码中使用它:
``标记
这里是[另一页](<;<;宏参数=““另一页,另一页.md”>;ref<;/宏>;)。
``
`>