文言 wenyan-lang

wy-lang.org | Wiki

English | 简体中文 | 繁體中文

文言文編程語言。 在线体验

🚧 请注意，中文版文档并非实时更新，仅供参考。如有歧义，请以英文版文档为主。

序

夫唐、虞之世，結繩而足治，屈指而足算。是時豈料百代之後，計算機械之巧，精於公輸之木鳶，善於武侯之流馬；程式語言之多，繁若《天官》之星宿，奇勝《山經》之走獸。鼠、蟹、鑽、魚，或以速稱。蛇、象、駱、犀，各爭文采。方知鬼之所以夜哭，天之所以雨粟。然以文言編程者 ，似所未有。此誠非文脈之所以傳，文心之所以保。嗟予小子，遂有斯志。然則數寸之烏絲猶覆於頭，萬卷之素書未破於手；一身長羁于远邦，兩耳久旷于雅言。然夫文章者吾之所宿好，程式者偶承時人之謬譽。故希孟不慚年少，莊生不望無涯。乃作斯言。誠未能嘔瀝長吉之心血，亦庶幾免於義山之流沫。既成之後，復學干將鑄劍而自飼，越王嚐糞而當先。自謂偶追《十書》之筆意，但恨少八家之淋漓。此子山所謂士衡抚掌而甘心，平子見陋而固宜。然則雖實覆甕之質，尚存斧正之望；雖乏呂相之金，易字之渴蓋同。此亦開源之大義，吾輩之所以勉勵也。一笑。

Helloworld

文言:

吾有一數。曰三。名之曰「甲」。
為是「甲」遍。
	吾有一言。曰「「問天地好在。」」。書之。
云云。

等同于以下 JavaScript:

var n = 3;
for (var i = 0; i < n; i++) {
	console.log("問天地好在。");
}

输出:

問天地好在。
問天地好在。
問天地好在。

标点符号和换行都是可选的（就像古汉语中文字是连续的），所以上面的代码等同于：

吾有一數曰三名之曰「甲」為是「甲」遍吾有一言曰「「問天地好在」」書之云云

更多复杂的例子，可以在 ./examples 中找到。比如，埃拉托斯特尼筛法、快速排序、曼德博集合、汉诺塔。

特点

• 符合古汉语语法的自然语言处理程序
• 可以编译成 JavaScript，Python，或者 Ruby
• 图灵完备
• 在线 IDE，即刻体验
• 通过几个例子快速入门

安装

编译器

使用以下命令安装本编译器：

npm install -g @wenyan/cli

尝试运行内置的例子，例如：

wenyan examples/helloworld.wy -o helloworld.js

在线 IDE

编辑器插件：

• 由antfu提供的适用于VSCode的插件
• 由voldikss提供的适用于Vim的插件
• 由absop提供的适用于Sublime Text的插件

语法表

上下文无关文法的语法描述还在构建中。同时，请查阅下面的语法表，或者在 src/parser.js 中学习其他更多语法。当然你也可以从在线 IDE 现有的例子中学习更多语法知识！

变量

流程控制

运算

容器

数组下标从一开始。而不是零。

对象

函数

导入

杂项

注释

渲染器

wenyan examples/turing.wy --render 圖靈機 --output .

src/render.js 脚本文件能把 wy 代码格式化输出成为古汉语书籍样式（历史印刷书籍）的矢量图（SVG）。同时它还可以将生成的SVG文件解析回原始文言代码。需要获取更详细的信息，请使用wenyan -h命令来获取帮助。

下图是用 wenyan 编写的 通用图灵机程序 渲染而成。

功能请求

在你打开一个新Issue之前，请先检查你的需求是否属于以下类别：

如果你可以帮助我们实现一个在需要帮助下有√的功能，请放心提交一个PR。我们将非常感谢你！如果你想帮助我们实现其他功能，也请让我们知道！谢谢。

已知问题