使用docpad标头和github wiki

时间:2016-01-12 10:45:36

标签: github markdown docpad

Docpad页面以标题描述开头,如

---
title: "regrets"
isPost: true
active: true
tags:
  - grammar
  - notes
---

然而,当它在纯粹的markdown中呈现时,添加到github wiki中,它真的很难看。 (见下文)。 有没有办法在docpad标题上使用任何类型的格式,所以当在标记对象环境(例如github wiki)中编辑时,它对于标题不是智能的也会很好看?

或者还有像CMS这样的其他wiki,它们可以很好地编辑docpad网站的内容吗?我想让作者处理内容,然后我们可以使用docpad轻松发布。

通常就是这样:

标题:“遗憾” isPost:是的 活跃:是的 标签:    - 语法

- 注意

1 个答案:

答案 0 :(得分:0)

元数据是Markdown的非标准功能。它仅由某些实现支持,并且每个实现甚至不以相同的方式支持。如果您希望跨实现保持一致的行为,那么最好的方法是仅使用标准功能。

尽管如此,有时您可能有充分的理由使用非标准功能。但是,当你这样做时,你只需要接受它在其他实现中看起来很丑陋;元数据是一个值得注意的例子。

GitHub使用的Markdown实现之一(它们有2或3个,具体取决于您使用的站点的哪个部分)将元数据放入表中。虽然表格看起来并不好看,但至少数据是可读的。但是,要实现这一点,Markdown解析器的行为会被更改为输出不同的HTML。这不仅仅是设计默认HTML的问题。

当然,Markdown实现的大多数元数据扩展/插件实际上都会提取日期,而不是将其显示为表格。因此,为了获得您想要的行为,您可能需要为正在使用的Markdown实现构建自己的扩展/插件,然后告诉CMS使用该扩展/插件。当然,如果您使用的是第三方工具(如GitHub的wiki),那么您只能获得他们选择支持的功能,而您仍然坚持使用它。如果您想选择自己的一组功能,那么您应该运行自己的服务器,或者使用static site generatormore here)自行构建网站。在任何一种情况下,您都可以选择可用的实现/功能。