问是否有一种方法可以在DocPad中包含/呈现来自外部“from”的文件？

EN

答案将是相当简单的:相对符号链接。Docpad处理得很好。

这样，要在文档中有一个README.md的符号链接，就应该这样做(使用src/ pwd的pwd)：

ln -s ../../README.md readme.html.md

或者，如果文档来自项目的一个模块内：

ln -s ../../node_modules/foobar/docs/ docs

这两种变体都工作得很好。

注意:Symlink可能很棘手。关于一些常见的问题，请参考以下内容：

• https://github.com/docpad/docpad/issues/878#issuecomment-53197720
• https://github.com/docpad/docpad/issues/878#issuecomment-53209674

DocPad本机支持将文档存储在默认的src文件夹之外。您这样做的方式是通过DocPad配置文件中的DocPad配置文件配置选项(例如docpad.coffee)。就像这样：

 path = require('path')
 docpadConfig = {

        documentsPaths: [
            'documents'
            path.resolve('..','data','documents')
        ]
 ....

当然，如果您只想在文件系统的某个位置包含任意的单独的文件，那么这个结果就会下降。在这种情况下，符号链接将是最好的选择。

模板助手也可以用于此，因为他们可以做任何你想做的事。

例如，贝弗里学习中心网站使用模板帮助器通过相对路径呈现任意文件，作为代码示例：

1. 模板助手：https://github.com/bevry/learn/blob/6e202638f2321eec2633d1dbeaf1078bdb953562/docpad.coffee#L244-L257
2. 使用模板Helper：https://github.com/bevry/documentation/blob/f24901251d19ec1cfa56fcee14c2c6836c0a995c/node/handsonnode/03-server.html.md.eco

如果您也希望呈现它们，则可以将此解决方案与文本插件结合使用。

这种组合应该是这样的：

1. DocPad配置文件中的模板帮助程序： docpadConfig = templateData: readProjectPath：(relativePath) -> fullPath = require('path').join(__dirname，(relativePath)返回@readFullPath( fullPath ) readRelativePath：( relativePath) -> fullPath= @getPath(relativePath)返回@readFullPath(fullPath) readFullPath：(fullPath) -> result = require('fs').readFileSync(fullPath)如果结果实例错误抛出结果返回result.toString()
2. 使用Eco作为模板引擎的文本插件模板帮助程序： <%- @readProjectPath('README.md') %>