SubCode

This page is about SubCode, an general preprocessor tool.

Introduction

Roshan and I—with some input from Michel—wrote a small utility we're calling SubCode. It is a generic preprocessing tool, allowing text / code generation using multiple preprocessors. The idea was basically: "It's hard to do a lot of things in a natural way in LaTeX, so it would be nice if I could make up domain-specific syntax and have it translated to LaTeX.". While we were at it, of course, we realised that we needn't restrict it to LaTeX, and so a simple tool, SubCode, was born.

To use it, you:

• Define the embedded languages' syntax and the translations to the host language.
• Write your document in the host language, with embedded fragments set off by special comments.
• Run SubCode on the document.
• Use the generated document for compilation, etc.

The code below includes a concrete example, which should make things a bit easier to understand if you're example-minded.

News

• 2006-06-24–Uploaded SubCode.

Download

• SubCode is open-source; the only available download is the Ruby source (including an example):
  • source (tgz)

More Information

Well, there's really no more information available for the time being, sorry! Please check back soon, though, or e-mail me if you have specific questions. There really ought to be a better tutorial.