Literate programming keeps code and its (extensive) documentation in a single source file. The documentation is typically typeset with TeX or LaTeX. Tools are used to extract the code (for compilations) and the documentation (for processing with (La)TeX) from the source file.
1
vote
0answers
43 views
Adding LaTeX Packages to Noweb files:
I want to use my standard LaTeX packages when I write Noweb files, such as
\usepackage[T1]{fontenc}
\usepackage{palatino}
\usepackage{geometry}
But if I add these to my .nw, I get the error:
...
9
votes
3answers
191 views
(How) Can I write a .dtx file without having to comment out *everything*?
I have a reasonable understanding now of how .dtx files work. But it's a great pain having to put a % character before every line of documentation. Also, depending on which editor you're using, it ...
10
votes
3answers
129 views
What does the “driver” section do in a .dtx file?
I've read the docstrip documentation, but have yet to form an intuition about how package documentation is extracted when I simply run pdflatex package.dtx.
Let's say I'm using the simple dtxtut ...
5
votes
0answers
80 views
Capacity of ctangle exceeded [closed]
I'm interested in looking at (and maybe modifying) the code in MetaFont/MetaPost.
To generate their C code, I applied ctangle to mp.w, and got an error message saying "token capacity exceeded". ...
3
votes
4answers
189 views
Iterate through list to generate references
I would like to create a new command, in which I pass a comma-separated list, which then will be iterated to create refs.
Example:
\iteratecommand{ref1, ref2, ref3}
And within the iteratecommand ...
1
vote
2answers
167 views
Changing font size of code in lhs2tex
I am a LaTeX / Haskell newbie and this question involves lhs2tex. Please let me know if I am posting on the wrong forum. I am writing a report in which I have fragments like:
\begin{figure}
...
27
votes
2answers
1k views
Different approach to literate programming for LaTeX
I have spent a couple of hours rethinking the literate style tools we have for LaTeX, which are essentially doc, docstrip and ltxdoc. Although the traditional workflow with a good editor can be less ...
15
votes
5answers
568 views
How to do literate programming in TeX?
How can I do literate programming in TeX where TeX, or some variant, is both the used programming language and what is used for typesetting the document? Is there more than one way to do it or ...
6
votes
1answer
407 views
How to create step by step annotated programming tutorial in LaTeX?
(question inspired by How to create a crossword puzzle in LaTeX? and provided solutions)
How to make in most comfortable way in LaTeX (I use pdfLaTeX, but I am open for LuaTeX solutions) annotated, ...
9
votes
1answer
201 views
Using doc/docstrip with other computer languages
The docstrip package mentions that it can be used to strip files of computer languages other than (La)TeX. I am looking to find a way to document other languages, for example JavaScript in a literate ...
3
votes
0answers
311 views
Syntax highlighting blocks of code with LaTeX and literate programming tools [closed]
Using packages like minted (thanks to Pygments), LaTeX can generate beautifully highlighted/colored source code. Literate programming tools such as noweb and cweb can generate beautifully typeset and ...
10
votes
1answer
505 views
Polyglossia doesn't work with the ltxdoc document class
I have a package that uses the ltxdoc document class and the docstrip program for code and documentation generation. The package deals with some multilingual stuff and needs XeTeX (to be precise, ...
6
votes
2answers
1k views
How to display filenames with underscores.
The following latex code uses fancyvrb VerbatimOut and VerbatimInput environment to write out and display code. The idea is to maintain only a latex file which contains code and documentation and ...
10
votes
3answers
1k views
How to typeset Haskell ++ operator and friends?
Usually, the list concatenation operator in Haskell is printed as overlapping double plus signs in books.
(In ASCII it is just ++)
How can I typeset this sign in Haskell (in and perhaps outside of ...
2
votes
1answer
681 views
Using Sweave, how can I reliably get .PNG figures instead of .EPS or .PDF figures?
I have tried to set the options in the preamble:
\SweaveOpts{keep.source=TRUE, eps=FALSE, pdf=FALSE, png=TRUE}, but this does not reliably produce only .PNG (or indeed any!) figures. I say 'reliably' ...
