The Eido Evoluted.
JavaScript

README.yk

[load-library [path/join directories/loader "youki-article"]]

[define [template article aux] [util/trace {
	[html5-doctype]
	[tags/html {
		[tags/head {
			[tags/meta [html-attributes [charset "utf-8"]]]
			[tags/title article/title]
		}]
		[tags/body [tags/article {
			[tags/h1 article/title]
			[= article/body]
		}]]
	}]
}]]

[define [template/inject s] [begin
	[define [s/title content] [setf s/current-article/title content]]
]]

[[macro template article [invoke youki-article template article '[= 333]]] template]::

[title {Youki · 有纪}]

Youki 是一个文档生成语言,其具备完整的编程特性和完备的宏特性,使之可作任意复杂的文章。Youki 是完全开放源码的,依照 MIT 协议发布。

[section {目录}]:
	# 文法
		# 章句
		# 算式
		# 抄录
		# 它们的组合
	# 预定义函数和宏
		# 基础
		# 高级
	# 有纪华章

[section "文法"]:
	Youki 文章是由许多种元素组合而成,主要的是**章句**、**算式**和**抄录**。它们可以相互穿插嵌套,这也是 Youki 强大能力的来源。

	[section {章句}]:
		Youki 使用章句以表示文字。一段章句用花括弧围住,形如:
		
		[pre]|
			{这样。}

		当然也可以更复杂,比如包含若干个段落,类似

		[pre]|
			{
				这里的情形。

				章句中的段落用空行分隔,一个段落可以包含多行,方便
				组织比较复杂的文字。

				同一份章句中的段落必须相同缩进,每一行也是如此。

				不过你可以通过花括弧来组织缩进。花括弧 {
					里面是另一份章句,对于外面来说只相当于一个字。

					在花括弧里的段落可以增加缩进,只要其中的内容缩进保持一致即可。

					{
			其实也可以减少缩进 :)
					}
				}。
			}

		在章句里也可以包含列表,它们

		[pre]|
			- 由一系列的项目组成
			- 每一项占据一行
			+ 列表表头可以是加号、减号或者井号
			+ 表头相同的算作同一个列表
			# 使用井号可以得到有数字编号的列表
			+ 列表的每一项只能有一行
			+ 不过可以
				- 包含子列表
				- 子列表
					# 可以有很多层
					# 很多内容
			+ 当然,任何时候都可以通过 {
				花
				括
				弧
			} 来包含更复杂的内容

		不过只有段落和列表,对于生成文章来说仍然远远不够,因此 Youki 支持一种基于缩进的格式,可以插入任意复杂的模式。要使用它,你需要

		[pre]|
			[一个算式调用]:
				后面加上冒号

				然后就是缩进了的章句节。

		Youki 中绝大多数更复杂的文章组件都是用这种方式提供的,例如,

		[pre]|
			[blockquote]:
				使用 `[blockquote]:` 就可以创建引文区段

		程序员有时候会需要在文章中添加代码块,这些东西都是预先排版好的文字块,我们不想把它当成段落或者列表排版。为了处理这种情形,Youki 的做法是将上面那种「算式-冒号」中的冒号 `:` 替换成竖线 `|`,之后被缩进的地方保持原样,类似

		[pre]|
			[pre]|
				这个样子。

			[highlight javascript]|
				// 于是你就可以在这里放源码了