Apostrophe中key-resources-pages模板找不到问题求助

咱们先把问题核心理清楚：当你自定义继承apostrophe-pieces-pages的页面模块时，Apostrophe默认的模板查找逻辑可能没优先定位到你的模块目录，反而跑去apostrophe-pages里找了。下面是具体的修复步骤：

1. 把模板放到正确的位置 #

你的key-resources-pages模块目录结构得按规范来，模板必须放在模块内部的指定路径下：

modules/
  key-resources-pages/
    views/
      pages/
        key-resources-pages.html
    index.js

只有放在模块内的views/pages/目录下，Apostrophe才会优先从这里找模板，而不是去系统默认的apostrophe-pages目录里碰运气。

2. 正确配置模块的继承关系 #

在modules/key-resources-pages/index.js里，得明确继承apostrophe-pieces-pages，还要关联对应的pieces模块（比如你的pieces模块叫key-resources）：

module.exports = {
  extend: 'apostrophe-pieces-pages',
  piecesModuleName: 'key-resources', // 这里要和你的pieces模块名称完全对应
  label: 'Key Resources Page'
};

3. 在app.js里正确注册模块 #

确保你同时注册了pieces模块和对应的pages模块，并且在apostrophe-pages的类型列表里添加它：

modules: {
  // ...其他已有的模块
  'key-resources': {},
  'key-resources-pages': {},
  'apostrophe-pages': {
    types: [
      // ...其他页面类型
      {
        name: 'key-resources-pages',
        label: 'Key Resources Page'
      }
    ]
  }
}

4. 手动指定模板路径（可选，用于排查顽固问题） #

如果上面的步骤还没解决，可以在模块配置里强制指定模板查找路径，把当前模块的目录设为优先：

module.exports = {
  extend: 'apostrophe-pieces-pages',
  piecesModuleName: 'key-resources',
  construct: function(self, options) {
    // 覆盖默认的模板路径逻辑，优先用当前模块的views目录
    self.templatePath = function(name) {
      return self.apos.utils.resolveModulePath(self, 'views/' + name);
    };
  }
};

5. 清理缓存并重启服务 #

有时候Apostrophe的缓存会搞事情，执行下面的命令清理缓存后重启服务：

rm -rf data/tmp
node app.js

做完这些操作，系统应该就能正确找到key-resources-pages模块里的模板文件了。

内容的提问来源于stack exchange，提问作者Tortilaman