在reStructuredText中使用变量

Question

我在reStructuredText格式中写了一个long HOWTO，并想知道是否有一种方法可以让用户在顶部为几个变量（主机名，IP地址）指定值，这样文档的其余部分将被填充与那些自动？

Answer 1

reStructuredText是定义静态内容的标记语言。 HTML内容（我认为所需的输出格式是HTML）通常是在编译时从reStructuredText生成，然后发布/发送给用户。

要允许用户指定变量，你就需要一个解决方案的新结构化的顶部，例如：

• 附带一个JavaScript插件，用户输入的HTML文档中动态替换特定字符串的内容。
• 用户指定变量后即时生成文档。

请注意，这些例子并不一定是特别可行的解决方案。