介绍
Literate Programming是一种软件开发方式,其原理是将程序代码和文档混合在一起,以便更好的理解程序。
npm包literate-programming-lib是一个基于Literate Programming方式的前端开发工具库,通过这个库可以将文档和代码混合在一起进行开发,并且将代码和文档分离,仅仅将最终生成的文档包含在生成的代码中。
literate-programming-lib提供了一系列的工具函数和API,支持在文档中引用变量、调用函数、定义变量等功能。
安装
在使用literate-programming-lib之前,需要先在项目中安装该npm包。可以通过以下命令进行安装:
--- ------- ------------------------
使用
引入literate-programming-lib
在使用literate-programming-lib之前,需要将它引入到项目中。在项目的入口文件中,可以通过以下语句进行引入:
----- - -- - - ------------------------------------
编写文档
在使用literate-programming-lib进行开发时,需要将文档和代码混合在一起进行开发。文档部分采用markdown格式书写。
- ------ ------------------ ------------------ ------- ------------- -------- ------ -- - ------ - - -- -
接下来我们来测试一下这个函数:
----- ------ - ------ --- -------------------- -- -
------------------------------------------------------ ----------------------------- --- ---- ----------------------------------------------------------------------------------------- ----- ----- - -- - - ------------------------------------ ---- - ------ ------------------ ------------------ ------- ------- --------------- -------- --- -------- ------ -- - ------ - - -- - ----------- --- ----------- --- ---- --------------- -------- -------- ---- -------------- ----- ----- --- ------- - ---------- - ----- ------ - ------ --- -------------------- -- - --
在代码块中,可以使用<<add>>
这种标记来引用函数和变量。在文档中,可以使用<<test>>
这种标记来引用测试代码块。
在代码中要使用到文档中定义的变量时,可以使用lp.get
函数来获取变量的值。
总结
通过使用npm包literate-programming-lib,我们可以将文档和代码混合在一起进行开发,更好的理解程序。同时也能够将文档和代码分离,仅仅将最终生成的文档包含在生成的代码中,保证程序的代码质量。
来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/67180