我一直在与 Wintersmith 建立一个站点,并且大部分时间都喜欢它,但我无法理解一些引擎盖下的机制。我从添加 paginator.coffee 插件的“博客”框架开始。
这个问题需要一些细节,所以最重要的是,我想要完成的是:
- 任何文件(markdown、html、json 元数据)都将在 /contents/article/<file> 或 /contents/articles/<subdir>/<file> 中获取
- 输出文件位于 /articles/YYYY/MM/DD/title-slug/
- /blog.html 列出所有文章,分页。
- /contents 下的文件(不在文章中)不被视为博客文章。Markdown 和 JSON 元数据仍然被处理,但没有永久链接的 URL,不包含在博客列表中,文件/目录结构被更直接地复制过来。
所以,我用这个建议解决了#1:我怎样才能让 Wintersmith 中的文章不在他们自己的子目录中?到目前为止,很好,#3 正在工作——分页列表包括所有帖子。#4 不是问题,这是默认行为。
在#2我找到了这个解决方案:http ://andrewphilipclark.com/2013/11/08/removing-the-boilerplate-from-wintersmith-blog-posts/ 。正如作者所提到的,他的解决方案(某种程度上)随后被合并到 Wintersmith 大师中,所以我尝试相应地设置 filenameTemplate。不幸的是,这适用于所有内容,而不仅仅是 /articles 下的内容,所以我的网站的其余部分都被冲洗掉了(中断 #4)。于是我尝试了作者的方法,使用他的代码添加了一个 blogpost.coffee 插件。这会将 /contents/articles 中的所有文件生成正确的永久链接 URL,但是由于某种原因,分页器现在将不再直接看到 /articles 下的文件(第 1 点)。
我已经尝试了很多排列和黑客攻击。尝试更改首先加载哪个插件的顺序。尝试让 PaginatorPage 扩展 BlogpostPage 而不是 Page。尝试了很多东西。我终于意识到,即使在检查了 Wintersmith 源代码中的许多核心类之后,我也不明白发生了什么。
具体来说,我无法弄清楚 contents['articles']._.pages 和 .directories 是如何设置的,这似乎是相关的。我也不明白那个下划线是什么。
归根结底,Jade/CoffeeScript/Markdown 是一个很好的组合,可以最大限度地减少编码并提高清晰度,除了当您想了解幕后发生的事情并且您不了解这些语言时。我花了一点时间来了解 Jade 和 CoffeeScript 的基础知识(Markdown 当然是微不足道的),足以了解正在发生的事情。当我不得不深入挖掘 Wintersmith 的来源时,它变得更深了。我承认我也是一个 node.js 新手,但我认为这里的大问题只是一个神奇的框架。例如,如果一些核心“插件”包含在骨架站点中而不是埋在 node_modules 中,这将是有帮助的,这样好奇的黑客就可以更快地看到事物是如何相互连接的。更详细的文档当然也会有所帮助。从概念上理解内容树、生成器、视图、模板等是一回事,但理解运行时的代码流和关系?我迷路了。
任何帮助表示赞赏。正如我所说,我爱温特史密斯,只是希望我能解除魔法。