-#LyX 2.1 created this file. For more info see http://www.lyx.org/
-\lyxformat 448
+#LyX 2.2 created this file. For more info see http://www.lyx.org/
+\lyxformat 503
\begin_document
\begin_header
+\origin /systemlyxdir/examples/
\textclass article
\begin_preamble
%
\language_package default
\inputencoding default
\fontencoding global
-\font_roman default
-\font_sans default
-\font_typewriter default
-\font_math auto
+\font_roman "default" "default"
+\font_sans "default" "default"
+\font_typewriter "default" "default"
+\font_math "auto" "auto"
\font_default_family default
\use_non_tex_fonts false
\font_sc false
\font_osf false
-\font_sf_scale 100
-\font_tt_scale 100
+\font_sf_scale 100 100
+\font_tt_scale 100 100
\graphics default
\default_output_format default
\output_sync 0
\use_geometry false
\use_package amsmath 0
\use_package amssymb 0
+\use_package cancel 0
\use_package esint 0
\use_package mathdots 1
\use_package mathtools 0
\use_package mhchem 1
+\use_package stackrel 0
+\use_package stmaryrd 0
\use_package undertilde 0
\cite_engine basic
-\cite_engine_type numerical
+\cite_engine_type default
\biblio_style plain
\use_bibtopic false
\use_indices false
\begin_layout Abstract
This document describes and implements a perl script for importing noweb
- files into LyX
+ files into \SpecialCharNoPassThru LyX
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Standard
-Since version 1.0.1, LyX now supports Literate Programming using
+Since version 1.0.1, \SpecialCharNoPassThru LyX
+ now supports Literate Programming using
\noun on
noweb
\noun default
.
- This addition to LyX made it very pleasant to write programs in the literate
+ This addition to \SpecialCharNoPassThru LyX
+ made it very pleasant to write programs in the literate
style (like this one).
In addition to being able to write new literate programs, it would be quite
useful if old
\noun on
noweb
\noun default
- code could be imported into LyX in some fashion.
+ code could be imported into \SpecialCharNoPassThru LyX
+ in some fashion.
That's where this program comes in.
\end_layout
\noun on
noweb
\noun default
- file to LyX.
+ file to \SpecialCharNoPassThru LyX
+.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<noweb2lyx.in>>=
+\begin_layout Plain Layout
+noweb2lyx.in
\end_layout
-\begin_layout Chunk
+\end_inset
#!@PERL@
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
#
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
# Copyright (C) 1999 Kayvan A.
Sylvan <kayvan@sylvan.com>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
# You are free to use and modify this code under the terms of
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
# the GNU General Public Licence version 2 or later.
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
#
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
# Written with assistance from:
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
# Edmar Wienskoski Jr.
<edmar-w-jr@technologist.com>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
# Amir Karger <karger@post.harvard.edu>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
#
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
# $Id: noweb2lyx.lyx,v 1.5 2005/07/18 09:42:27 jamatos Exp $
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
#
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
# NOTE: This file was automatically generated from noweb2lyx.lyx using noweb.
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
#
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Setup variables from user supplied args>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Subroutines>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
-<<Convert noweb to LyX>>
+<<Convert noweb to \SpecialCharNoPassThru LyX
+>>
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Section
@ Here is some documentation.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset ERT
+status open
-\end_layout
+\begin_layout Plain Layout
-\begin_layout Chunk
+We can do arbitrary \SpecialCharNoPassThru LaTeX
+ code here.
+\end_layout
-We can do arbitrary LaTeX code here.
-\begin_inset Newline newline
-\end_inset
+\begin_layout Plain Layout
[...
blah blah blah ...]
\end_layout
+\end_inset
+
+
+\end_layout
+
\begin_layout Standard
Code chunks look like this:
\end_layout
\end_layout
\begin_layout Standard
-When first tackling this problem, I spoke with members of the LyX team that
- knew about the literate programming extensions and reLyX (the LaTeX importing
+When first tackling this problem, I spoke with members of the \SpecialCharNoPassThru LyX
+ team that
+ knew about the literate programming extensions and re\SpecialCharNoPassThru LyX
+ (the \SpecialCharNoPassThru LaTeX
+ importing
code).
\end_layout
\begin_layout Standard
-One of the first ideas was to extend the reLyX code to understand the
+One of the first ideas was to extend the re\SpecialCharNoPassThru LyX
+ code to understand the
\noun on
noweb
\noun default
\end_inset
.
- On the other hand, it turns out that reLyX contains a very useful literal
+ On the other hand, it turns out that re\SpecialCharNoPassThru LyX
+ contains a very useful literal
quoting mechanism.
If the input file contains the construct
\end_layout
\begin_layout LyX-Code
\backslash
-begin{reLyXskip}
+begin{re\SpecialCharNoPassThru LyX
+skip}
\begin_inset Newline newline
\end_inset
{...
- LaTeX stuff ...}
+ \SpecialCharNoPassThru LaTeX
+ stuff ...}
\begin_inset Newline newline
\end_inset
\backslash
-end{reLyXskip}
+end{re\SpecialCharNoPassThru LyX
+skip}
\end_layout
\begin_layout Standard
-then reLyX will copy the surrounded code to the output file verbatim.
+then re\SpecialCharNoPassThru LyX
+ will copy the surrounded code to the output file verbatim.
Given this, the first part of the translation is easy; we simply have to
copy the code chunks into an intermediate file that surrounds them with
\family typewriter
\backslash
-begin{reLyXskip}
+begin{re\SpecialCharNoPassThru LyX
+skip}
\family default
and
\family typewriter
\backslash
-end{reLyXskip}
+end{re\SpecialCharNoPassThru LyX
+skip}
\family default
.
\end_layout
\begin_layout Standard
-Once reLyX is done with the input file, the problem is reduced to changing
- the code chunks from LyX's LaTeX layout to the Chunk layout.
+Once re\SpecialCharNoPassThru LyX
+ is done with the input file, the problem is reduced to changing
+ the code chunks from \SpecialCharNoPassThru LyX
+'s \SpecialCharNoPassThru LaTeX
+ layout to the Chunk layout.
\end_layout
\begin_layout Standard
\noun default
.
We want to be able to run it as a simple pre-processor and post-processor
- from within reLyX.
+ from within re\SpecialCharNoPassThru LyX
+.
We can accomplish this by setting the flags
\family roman
\series medium
outline for our code:
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
-<<Convert noweb to LyX>>=
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+Convert noweb to \SpecialCharNoPassThru LyX
\end_layout
-\begin_layout Chunk
+\end_inset
if (!$post_only) {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
- <<Transform noweb for reLyX>>
+ <<Transform noweb for re\SpecialCharNoPassThru LyX
+>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
if ((!$pre_only) && (!$post_only)) {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
- <<Run reLyX on intermediate file>>
+ <<Run re\SpecialCharNoPassThru LyX
+ on intermediate file>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
if (!$pre_only) {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
- <<Fix up LyX file>>
+ <<Fix up \SpecialCharNoPassThru LyX
+ file>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Clean up>>
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Section
-Making a file that reLyX can process
+Making a file that re\SpecialCharNoPassThru LyX
+ can process
\end_layout
\begin_layout Standard
In this section, we present the code that performs the task of creating
- the intermediate file that reLyX can process, using the algorithm that
+ the intermediate file that re\SpecialCharNoPassThru LyX
+ can process, using the algorithm that
we just outlined.
This algorithm is outlined in the code that follows:
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
-<<Transform noweb for reLyX>>=
+<<Transform noweb for re\SpecialCharNoPassThru LyX
+>>=
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Setup INPUT and OUTPUT>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
inputline: while(<INPUT>)
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
{
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
if (/^
\backslash
>=/) { # Beginning of a noweb chunk
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Read in and output the noweb code chunk>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
} elsif (/^@
\backslash
s+(.*)/) { # Beginning of a documentation chunk
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
print OUTPUT $1; # We do not need the ``@'' part
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
} elsif (/
\backslash
]/) { # noweb quoted code
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Perform special input quoting of [[var]]>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
} else {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
print OUTPUT; # Just let the line pass through
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Close INPUT and OUTPUT>>
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Standard
In the code above, we do some pre-processing of the noweb ``[[...]]'' construct.
- This avoids some problems with reLyX confusing lists composed of ``[[...]]''
+ This avoids some problems with re\SpecialCharNoPassThru LyX
+ confusing lists composed of ``[[...]]''
constructs.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
<<Perform special input quoting of [[var]]>>=
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
s/
\backslash
[.+?
\backslash
]{2,}/{$&}/g;
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
print OUTPUT;
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
@
\end_layout
+\end_inset
+
+
+\end_layout
+
\begin_layout Standard
While reading in the
\family roman
\noun on
noweb
\noun default
- code chunk, we transform it into a form that is usable by reLyX.
+ code chunk, we transform it into a form that is usable by re\SpecialCharNoPassThru LyX
+.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<Read in and output the noweb code chunk>>=
+\begin_layout Plain Layout
+Read in and output the noweb code chunk
\end_layout
-\begin_layout Chunk
+\end_inset
<<Save the beginning of the chunk to savedchunk>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Concatenate the rest of the chunk>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
-<<print out the chunk in a reLyXskip block>>
+<<print out the chunk in a re\SpecialCharNoPassThru LyX
+skip block>>
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Subsection
\color inherit
to read and write files.
In the code fragment above, we need to read from the input file and write
- to a file that will be later transformed by reLyX.
+ to a file that will be later transformed by re\SpecialCharNoPassThru LyX
+.
If we are being called only to pre-process the input file, then there is
no need to create a temporary file.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
-<<Setup INPUT and OUTPUT>>=
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+Setup INPUT and OUTPUT
\end_layout
-\begin_layout Chunk
+\end_inset
if ($pre_only) {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
&setup_files($input_file, $output_file);
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
} else {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
$relyx_file = "temp$$";
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
&setup_files($input_file, $relyx_file);
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Standard
, which we define below:
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
<<Subroutines>>=
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
sub setup_files {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
my($in, $out) = @_;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
open(INPUT, "<$in") || die "Cannot read $in: $!
\backslash
n";
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
open(OUTPUT, ">$out") || die "Cannot write $out: $!
\backslash
n";
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
+
+@ %def setup_files
+\end_layout
+
+\end_inset
+
-@ %def setup_files
\end_layout
\begin_layout Subsection
rest of the chunk for output.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<Save the beginning of the chunk to savedchunk>>=
+\begin_layout Plain Layout
+Save the beginning of the chunk to savedchunk
\end_layout
-\begin_layout Chunk
+\end_inset
$savedchunk = $_;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
$endLine = "";
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
<<Concatenate the rest of the chunk>>=
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
chunkline: while (<INPUT>) {
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
- last chunkline if /^@
+ last chunkline if /^@
\backslash
s+/;
-\begin_inset Newline newline
-\end_inset
+\end_layout
- $savedchunk .= $_;
-\begin_inset Newline newline
-\end_inset
+\begin_layout Plain Layout
+
+ $savedchunk .= $_;
+\end_layout
+
+\begin_layout Plain Layout
};
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
switch: {
-\begin_inset Newline newline
-\end_inset
+\end_layout
- if (/^@
+\begin_layout Plain Layout
+
+ if (/^@
\backslash
s+$/) {$savedchunk .= $_; last switch; }
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
- if (/^@
+ if (/^@
\backslash
s+%def.*$/) {$savedchunk .= $_; last switch; }
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
- if (/^@
+ if (/^@
\backslash
s+(.*)$/) {$savedchunk .= "@
\backslash
n"; $endLine = "$1
\backslash
n"; }
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
}
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
@
\end_layout
+\end_inset
+
+
+\end_layout
+
\begin_layout Subsection
Printing out the chunk
\end_layout
The final piece of the first pass of the conversion is done by this code.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<print out the chunk in a reLyXskip block>>=
+\begin_layout Plain Layout
+print out the chunk in a re\SpecialCharNoPassThru LyX
+skip block
\end_layout
-\begin_layout Chunk
+\end_inset
print OUTPUT "
\backslash
\backslash
-begin{reLyXskip}
+begin{re\SpecialCharNoPassThru LyX
+skip}
\backslash
n";
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
print OUTPUT $savedchunk;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
print OUTPUT "
\backslash
\backslash
-end{reLyXskip}
+end{re\SpecialCharNoPassThru LyX
+skip}
\backslash
n
\backslash
n";
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
print OUTPUT "$endLine";
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Standard
files.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<Close INPUT and OUTPUT>>=
+\begin_layout Plain Layout
+Close INPUT and OUTPUT
\end_layout
-\begin_layout Chunk
+\end_inset
close(INPUT);
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
close(OUTPUT);
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Section
-Running reLyX
+Running re\SpecialCharNoPassThru LyX
\end_layout
\begin_layout Standard
-In this section, we describe and implement the code that runs reLyX on the
+In this section, we describe and implement the code that runs re\SpecialCharNoPassThru LyX
+ on the
intermediate file
\family roman
\series medium
\end_layout
\begin_layout Standard
-In order to run reLyX, we need to know the article class of the input document
+In order to run re\SpecialCharNoPassThru LyX
+, we need to know the article class of the input document
(to choose the corresponding literate document layout).
For this, we need to parse the intermediate file.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<Run reLyX on intermediate file>>=
+\begin_layout Plain Layout
+Run re\SpecialCharNoPassThru LyX
+ on intermediate file
\end_layout
-\begin_layout Chunk
+\end_inset
<<Parse for document class>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
-<<Run reLyX with document class>>
+<<Run re\SpecialCharNoPassThru LyX
+ with document class>>
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Standard
\emph on
noweb2lyx.nw
\emph default
- file that is generated by LyX
+ file that is generated by \SpecialCharNoPassThru LyX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
-reLyX searches for
+re\SpecialCharNoPassThru LyX
+ searches for
\backslash
\backslash
\noun on
noweb2lyx
\noun default
- on itself and a produce a quite reasonable LyX file.
+ on itself and a produce a quite reasonable \SpecialCharNoPassThru LyX
+ file.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<Parse for document class>>=
+\begin_layout Plain Layout
+Parse for document class
\end_layout
-\begin_layout Chunk
+\end_inset
open(INPUT, "<$relyx_file") ||
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
die "Cannot read $relyx_file: $!
\backslash
n";
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
$class = "article"; # default if none found
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
parse: while(<INPUT>) {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
if (/
\backslash
docu[m]entclass{(.*)}/) {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
$class = $1;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
last parse;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
close(INPUT);
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Subsection
-Running reLyX with the corresponding literate document layout
+Running re\SpecialCharNoPassThru LyX
+ with the corresponding literate document layout
\end_layout
\begin_layout Standard
Now that we know what the document class ought to be, we do:
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset ERT
+status open
-<<Run reLyX with document class>>=
-\begin_inset Newline newline
-\end_inset
+\begin_layout Plain Layout
+
+<<Run re\SpecialCharNoPassThru LyX
+ with document class>>=
+\end_layout
+
+\begin_layout Plain Layout
$doc_class = "literate-" .
$class;
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
-die "reLyX returned non-zero: $!
+die "re\SpecialCharNoPassThru LyX
+ returned non-zero: $!
\backslash
n"
-\begin_inset Newline newline
-\end_inset
+\end_layout
- if (system("reLyX -c $doc_class $relyx_file"));
-\begin_inset Newline newline
-\end_inset
+\begin_layout Plain Layout
+
+ if (system("re\SpecialCharNoPassThru LyX
+ -c $doc_class $relyx_file"));
+\end_layout
+
+\begin_layout Plain Layout
@
\end_layout
+\end_inset
+
+
+\end_layout
+
\begin_layout Standard
-reLyX performs the main bulk of the translation work.
+re\SpecialCharNoPassThru LyX
+ performs the main bulk of the translation work.
Note that if the ``literate-
\emph on
class
\emph default
-'' document layout is not found, then reLyX will fail with an error.
+'' document layout is not found, then re\SpecialCharNoPassThru LyX
+ will fail with an error.
In that case, you may need to modify your
\noun on
noweb
\end_layout
\begin_layout Section
-Fixing the reLyX output
+Fixing the re\SpecialCharNoPassThru LyX
+ output
\end_layout
\begin_layout Standard
-We need to perform some post-processing of what reLyX produces in order
+We need to perform some post-processing of what re\SpecialCharNoPassThru LyX
+ produces in order
to have the best output for our literate document.
The outline of the post-processing steps are:
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<Fix up LyX file>>=
+\begin_layout Plain Layout
+Fix up \SpecialCharNoPassThru LyX
+ file
\end_layout
-\begin_layout Chunk
+\end_inset
<<Setup INPUT and OUTPUT for the final output>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
line: while(<INPUT>)
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
{
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Fix code chunks in latex layout>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Fix [[var]] noweb construct>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
print OUTPUT; # default
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Close INPUT and OUTPUT>>
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Standard
\color inherit
is sufficient to restart the loop.
We can use this construct to do some relatively complex parsing of the
- reLyX generated file.
+ re\SpecialCharNoPassThru LyX
+ generated file.
\end_layout
\begin_layout Subsection
is taken care of by this code:
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<Setup INPUT and OUTPUT for the final output>>=
+\begin_layout Plain Layout
+Setup INPUT and OUTPUT for the final output
\end_layout
-\begin_layout Chunk
+\end_inset
if ($post_only) {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
&setup_files("$input_file", "$output_file");
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
} else {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
&setup_files("$relyx_file.lyx", "$output_file");
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Subsection
\begin_layout Standard
Now, as we outlined before, the final step is transforming the code-chunks
- which have been put into a LaTeX layout by LyX into the Chunk layout.
+ which have been put into a \SpecialCharNoPassThru LaTeX
+ layout by \SpecialCharNoPassThru LyX
+ into the Chunk layout.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
-<<Fix code chunks in latex layout>>=
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+Fix code chunks in latex layout
\end_layout
-\begin_layout Chunk
+\end_inset
if (/
\backslash
latex latex/) { # Beginning of some latex code
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
if (($line = <INPUT>) =~ /^
\backslash
s*<</) { # code chunk
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Transform this chunk into layout chunk>>
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
} else {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
# print the
\backslash
latex latex line + next line
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
print OUTPUT "$_$line";
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
next line;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Standard
the code chunk and output a chunk layout for it:
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
<<Transform this chunk into layout chunk>>=
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
$savedchunk = "
\backslash
n
\backslash
n$line";
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
codeline: while (<INPUT>) {
-\begin_inset Newline newline
-\end_inset
+\end_layout
- $savedchunk .= $_;
-\begin_inset Newline newline
-\end_inset
+\begin_layout Plain Layout
+
+ $savedchunk .= $_;
+\end_layout
- last codeline if /^@
+\begin_layout Plain Layout
+
+ last codeline if /^@
\backslash
s+/;
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
};
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
print OUTPUT $savedchunk;
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
<<Slurp up to the end of the latex layout>>
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
@
\end_layout
+\end_inset
+
+
+\end_layout
+
\begin_layout Standard
Okay, now we just need to eat the rest of the latex layout.
There should only be a few different types of lines for us to match:
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<Slurp up to the end of the latex layout>>=
+\begin_layout Plain Layout
+Slurp up to the end of the latex layout
\end_layout
-\begin_layout Chunk
+\end_inset
slurp: while (<INPUT>) {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
last slurp if /
\backslash
latex /;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
next slurp if /
\backslash
newline/;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
next slurp if /^
\backslash
s*$/;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
warn "confused by line: $_";
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Subsection
\noun on
noweb
\noun default
- syntax means putting the ``[[quoted-code]]'' in a LaTeX layout in the LyX
+ syntax means putting the ``[[quoted-code]]'' in a \SpecialCharNoPassThru LaTeX
+ layout in the \SpecialCharNoPassThru LyX
file.
- Otherwise, LyX will backslash-quote the brackets, creating ugly output.
+ Otherwise, \SpecialCharNoPassThru LyX
+ will backslash-quote the brackets, creating ugly output.
The quoted-code is transformed by
\noun on
noweb
\noun default
- when it generates the final LaTeX code.
+ when it generates the final \SpecialCharNoPassThru LaTeX
+ code.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
-<<Fix [[var]] noweb construct>>=
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+Fix [[var]] noweb construct
\end_layout
-\begin_layout Chunk
+\end_inset
if (/
\backslash
]/) { # special code for [[var]]
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
s/
\backslash
n/g;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
print OUTPUT;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
next line;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Section
The cleanup code is very simple:
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<Clean up>>=
+\begin_layout Plain Layout
+Clean up
\end_layout
-\begin_layout Chunk
+\end_inset
system("rm -f $relyx_file*") unless ($post_only || $pre_only);
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Section
noweb2lyx
\noun default
script understands two arguments, input-file and output-file.
- It is also set up to be used internally by reLyX to pre-process or postprocess
+ It is also set up to be used internally by re\SpecialCharNoPassThru LyX
+ to pre-process or postprocess
files in the import pipeline.
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
<<Setup variables from user supplied args>>=
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
&usage() if ($#ARGV < 1); # zero or one argument
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
if ($ARGV[0] eq "-pre") {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
&usage unless ($#ARGV == 2);
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
$input_file = $ARGV[1]; $output_file = $ARGV[2]; $pre_only = 1;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
} elsif ($ARGV[0] eq "-post") {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
&usage unless ($#ARGV == 2);
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
$input_file = $ARGV[1]; $output_file = $ARGV[2]; $post_only = 1;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
} else {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
&usage unless ($#ARGV == 1);
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
$input_file = $ARGV[0]; $output_file = $ARGV[1];
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
$pre_only = 0; $post_only = 0;
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
}
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
@ %def input_file output_file pre_only post_only
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
<<Subroutines>>=
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
sub usage() {
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
print "Usage: noweb2lyx [-pre | -post] input-file output-file
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
-\begin_inset Newline newline
-\end_inset
+\end_layout
-If -pre is specified, only pre-processes the input-file for reLyX.
-\begin_inset Newline newline
-\end_inset
+\begin_layout Plain Layout
-Similarly, in the case of -post, post-processes reLyX output.
-\begin_inset Newline newline
-\end_inset
+If -pre is specified, only pre-processes the input-file for re\SpecialCharNoPassThru LyX
+.
+\end_layout
+
+\begin_layout Plain Layout
+
+Similarly, in the case of -post, post-processes re\SpecialCharNoPassThru LyX
+ output.
+\end_layout
+
+\begin_layout Plain Layout
In case of bugs, Email Kayvan Sylvan <kayvan
\backslash
@sylvan.com>.
\backslash
n";
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
exit;
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
}
-\begin_inset Newline newline
-\end_inset
+\end_layout
+
+\begin_layout Plain Layout
@ %def usage
\end_layout
+\end_inset
+
+
+\end_layout
+
\begin_layout Section
Generating the
\noun on
\end_layout
\begin_layout Standard
-The noweb2lyx script can be tangled from LyX if you set
+The noweb2lyx script can be tangled from \SpecialCharNoPassThru LyX
+ if you set
\family typewriter
\backslash
notangle -Rbuild-script $1 | env NOWEB_SOURCE=$1 NOWEB_OUTPUT_DIR=$2 sh
\end_layout
-\begin_layout Chunk
+\begin_layout Standard
+\begin_inset Flex Chunk
+status open
+
+\begin_layout Plain Layout
+
+\begin_inset Argument 1
+status open
-<<build-script>>=
+\begin_layout Plain Layout
+build-script
\end_layout
-\begin_layout Chunk
+\end_inset
PREFIX=/usr
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
notangle -Rnoweb2lyx.in noweb2lyx.nw > noweb2lyx.in
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
sed -e "s=@PERL@=$PREFIX/bin/perl=" noweb2lyx.in > noweb2lyx
\end_layout
-\begin_layout Chunk
+\begin_layout Plain Layout
chmod +x noweb2lyx
\end_layout
-\begin_layout Chunk
+\end_inset
+
-@
\end_layout
\begin_layout Standard