使用 Homebrew, apt, MacPorts, Nix 安装 noweb

项目链接

• 主页
• 仓库
• 上游文档
• 软件包管理器页面

命令和别名

• cpif
• htmltoc
• nodefs
• noindex
• noroff
• noroots
• notangle
• nountangle
• noweave
• noweb
• nuweb2noweb
• sl2h

项目历史

The Hacker's Guide is dated September 1992, with revisions in August 1994 and December 1997. Ramsey's 1994 IEEE Software article 'Literate programming simplified' and the October 1997 Linux Journal article introduced the tool and its approach to a broader audience.

noweb's core idea is a pipeline. The Hacker's Guide describes how every tool begins with a noweb source file, transforms it through simple stages, and then emits code through notangle or documentation through noweave. That architecture let users add behavior by inserting pipeline stages rather than recompiling the tool.

The homepage notes that in 2018 Ramsey released version 2.12 and put noweb on GitHub. GitHub releases later list v2_12 in 2023 and v2_13 in 2023; Homebrew packages version 2.13.

采用历史

noweb's adoption was strongest in academic and research programming circles that valued literate programming across multiple languages. The homepage links a maintained user/project list, example programs, a postcard gallery online since April 1998, and LyX support since March 1999.

Homebrew's formula API reported only 49 install-on-request events in its 365-day analytics window. That does not erase the project's historical footprint; it shows that noweb is mostly legacy, archival, academic, or enthusiast infrastructure in modern macOS package usage.

使用方式

Users write source in noweb chunks, run notangle to extract compilable code, and run noweave to generate human-readable documentation. The tool intentionally avoids language-specific prettyprinting, trading that feature away for language independence and a small syntax.

Package nerds value noweb because it is old, portable, and inspectable. It ships a cluster of Unix-style tools such as notangle, noweave, noindex, noroots, nodefs, and noweb itself, making it a small literate-programming toolkit rather than a single renderer.

为什么软件包爱好者会关心

noweb is a landmark in literate-programming tooling: less famous than WEB/CWEB, but influential because it made literate programming language-neutral and Unix-pipeline friendly. Its modern package presence is low, but its design remains a reference point for simple documentation/code extraction systems.

时间线

• 1992-09: Noweb Hacker's Guide dated September 1992.
• 1994-09: Ramsey's 'Literate programming simplified' published in IEEE Software.
• 1997-10: Linux Journal article on literate programming using noweb published.
• 1999-03: LyX support for noweb noted on the noweb homepage.
• 2018-06-28: homepage states version 2.12 was the supported 2.x version and that the project had been put on GitHub.
• 2023-08-11: GitHub release v2_13 published.

Related projects

• WEB
• CWEB
• nuweb
• LyX
• Pretzel

来源

• https://api.github.com/repos/nrnrnr/noweb
• https://api.github.com/repos/nrnrnr/noweb/releases?per_page=10
• https://formulae.brew.sh/api/formula/noweb.json
• https://github.com/nrnrnr/noweb
• https://www.cs.tufts.edu/~nr/noweb/
• https://www.cs.tufts.edu/~nr/noweb/guide.html