matjp / jweb-editor

A JWEB editor for VS Code
https://marketplace.visualstudio.com/items?itemName=mjpvs.jweb-vscode-editor
MIT License
1 stars 0 forks source link

JWEB VSCode Editor

An editor for the JWEB system of Literate Programming.

Note: I have migrated this extension to a new VS Code publisher account. Please uninstall any versions older than v0.1.5, then install the extension named JWEB VSCode Editor.

JWEB

How it works

The extension recognizes JWEB files as Markdown files having this tag at the beginning:

---
jweb:<language>
---

where language is the language specifier of the JWEB program target language. e.g. (c, cpp, js, ts).

Upon saving edits to a JWEB markdown file, a WEB file (*.w) is generated from the fenced code blocks and jtangle is called with the WEB file as input.

The target source file will be written to the same directory as the JWEB source file.

Errors and information messages are written to the Output tab.

See the settings for options to control what kind of output is shown.

Viewing and Publishing JWEB files

Since JWEB files are Markdown files your programs can be viewed and exported for publishing online, or converted to PDF for printing using other Markdown handling extensions.

If you just want to preview as you are editing, VS Code's built-in previewer will suffice.

A Markdown mathematics extension will be useful if your program text includes mathematical notation.

If you find this software useful please consider making a contribution to support the development of free and open software:

paypal