T wo T r:twotr - Revision history

Rkrug: Really fix formatting?

2021-02-22T23:35:36Z

Really fix formatting?

Rkrug: Fix formatting

2021-02-22T23:13:14Z

Fix formatting

Rkrug: /* Contents */

2021-02-22T18:36:33Z

‎Contents

Rkrug: Rename some files so I could upload them.

2021-02-22T18:20:56Z

Rename some files so I could upload them.

Rkrug: TeX without TeX Revised and expanded

2021-02-22T02:25:57Z

TeX without TeX Revised and expanded

New page

== About ==

This is an update and expansion of [[TeX without TeX]] --- using TeX's
functionality (typesetting, pdf writing) using only Lua code (no \TeX
macros).

It is (I believe) an adequate framework for developing a complete
type-setting system; although one dedicated to a specific task, rather
than a general purpose system such as LaTeX or ConTeXt. It includes a
couple of example formatting commands (\Emph and \Bold), titles
(\Title), the ability to include other subsidiary text files (\Input)
and footnotes (\Footnote). It can be easily adapted and expanded to
suit your needs.

I am not much of a programmer, and knew little about TeX and even less
about Lua when I started this, so there is undoubtedly much that can
be improved. All questions, comments, suggestions, and corrections
will be appreciated. You can reach me at "destiny6 <AT> mac <DOT>
com".

== Pre-requisites ==

This system requires the luatex-plain format (from ConTeXt), so that
we have access to Open Type Fonts and other goodies. This is what I
did on my system:

# Find the luatex-plain.tex file. On my system (with TeX-Live 2020)
it was at:

<code>
/usr/local/share/texmf-dist/tex/generic/context/luatex/luatex-plain.tex
</code>

# If you just build a format file,

<code>
luatex --ini /usr/local/share/texmf-dist/tex/generic/context/luatex/luatex-plain.tex
</code>

you will probably get warnings about using the "merged" file, and not
the more current and supported files. Delete, move, or rename this
file. On my system I did:

<code>
doas mv /usr/local/share/texmf-dist/tex/generic/context/luatex/luatex-fonts-merged.lua /usr/local/share/texmf-dist/tex/generic/context/luatex/luatex-fonts-merged.lua.bak
</code>

# Now, build the format file.

<code>
luatex --ini /usr/local/share/texmf-dist/tex/generic/context/luatex/luatex-plain.tex
</code>

# We are almost done. If the resulting format file (luatex-plain.fmt)
is in the current working directory, you can use it with something
like:

<code>
luatex --fmt luatex-plain test
</code>

# But, this is too restrictive.

## Create a new executable with the name luatex-plain. Something
like:

<code>
ln -s `which luatex` /usr/local/bin/luatex-plain
</code>

## When you try to invoke it:

<code>
luatex-plain test
</code>

it will fail with a message about failing to find the proper
format file. There should be a line something like:

<code>
mktexfmt [INFO]: writing formats under ~/.texlive2020/texmf-var/web2c
</code>

so, copy the format file to that location:

<code>
cp luatex-plain.fmt ~/.texlive2020/texmf-var/web2c/
</code>

now, this should work:

<code>
luatex-plain test
</code>

Finally, run mtxrun to generate a fonts database: <br />

<code>
mtxrun --script fonts --reload --simple
</code>

== Contents ==

This files for this project are also available at:
[https://github.com/s-dismas/TeX-without-TeX-revised GitHub]

There is a Read Eval Print Loop available for interactively exploring:

[[T_wo_T_r:repl.lua|repl.lua]]

It can be invoked with <code>repl.repl()<code/>, and either
<code>quit()<code/> or <code>exit<code/> will exit it. I use Shell Mode in
Emacs, but a simple terminal or similar should also work.

Some utilites are in the file:

[[T_wo_T_r:utils.lua|utils.lua]]

The following five files comprise the system:

[[T_wo_T_r:reader.lua|reader.lua]]

[[T_wo_T_r:format.lua|format.lua]]

[[T_wo_T_r:main.lua|main.lua]]

[[T_wo_T_r:pages.lua|pages.lua]]

[[T_wo_T_r:commands.lua|commands.lua]]

The license for this software can be seen at:

[[T_wo_T_r:LICENSE.txt| License.]]

The TeX file to be compiled by luatex-plain is:

[[T_wo_T_r:test.tex|test.tex]]

The Lua file executed by <code>\directlua{dofile "test.lua"}</code>
within [[T_wo_T_r:test.tex|test.tex]] is:

[[T_wo_T_r:test.lua|test.tex]]

The main text file to be typeset is:

[[T_wo_T_r:text.txt|text.txt]]

It includes the following five files:

[[T_wo_T_r:chapter-1.txt|chapter 1]]

[[T_wo_T_r:chapter-2.txt|chapter 2]]

[[T_wo_T_r:chapter-3.txt|chapter 3]]

[[T_wo_T_r:chapter-4.txt|chapter 4]]

[[T_wo_T_r:chapter-5.txt|chapter 5]]

@@ Line 26: / Line 26: @@
 did on my system:
-# Find the luatex-plain.tex file. On my system (with TeX-Live 2020)
+<ol>
 it was at:
-  <pre>
+<pre>
-  /usr/local/share/texmf-dist/tex/generic/context/luatex/luatex-plain.tex
+/usr/local/share/texmf-dist/tex/generic/context/luatex/luatex-plain.tex
-  </pre>
+</pre>
-# If you just build a format file,
+<li> If you just build a format file,
-  <pre>
+<pre>
-  luatex --ini /usr/local/share/texmf-dist/tex/generic/context/luatex/luatex-plain.tex
+luatex --ini /usr/local/share/texmf-dist/tex/generic/context/luatex/luatex-plain.tex
-  </pre>
+</pre>
-  <pre>
+you will probably get warnings about using the "merged" file, and not
-  doas mv /usr/local/share/texmf-dist/tex/generic/context/luatex/luatex-fonts-merged.lua /usr/local/share/texmf-dist/tex/generic/context/luatex/luatex-fonts-merged.lua.bak
+the more current and supported files. Delete, move, or rename this
-  </pre>
+file. On my system I did:
-# Now, build the format file.
+<pre>
-  <pre>
+<li> Now, build the format file.
-# We are almost done. If the resulting format file (luatex-plain.fmt)
+<pre>
 is in the current working directory, you can use it with something
 like:
-  <pre>
+<pre>
-  luatex --fmt luatex-plain test
+luatex --fmt luatex-plain test
-  </pre>
+</pre>
-# But, this is too restrictive.
+<li> But, this is too restrictive.
-  ## Create a new executable with the name luatex-plain. Something
+<ol>
-  like:
+<li> Create a new executable with the name luatex-plain. Something like:
-    <pre>
+<pre>
-    ln -s `which luatex` /usr/local/bin/luatex-plain
+ln -s `which luatex` /usr/local/bin/luatex-plain
-    </pre>
+</pre>
-  ## When you try to invoke it:
+<li> When you try to invoke it:
-    <pre>
+<pre>
-    luatex-plain test
+luatex-plain test
-    </pre>
+</pre>
-  it will fail with a message about failing to find the proper
+it will fail with a message about failing to find the proper
-  format file. There should be a line something like:
+format file. There should be a line something like:
-    <pre>
+<pre>
-    mktexfmt [INFO]: writing formats under ~/.texlive2020/texmf-var/web2c
+mktexfmt [INFO]: writing formats under ~/.texlive2020/texmf-var/web2c
-    </pre>
+</pre>
-  so, copy the format file to that location:
+so, copy the format file to that location:
-    <pre>
+<pre>
-    cp luatex-plain.fmt ~/.texlive2020/texmf-var/web2c/
+cp luatex-plain.fmt ~/.texlive2020/texmf-var/web2c/
-    </pre>
+</pre>
-  now, this should work:
+now, this should work:
-    <pre>
+<pre>
-    luatex-plain test
+luatex-plain test
-    </pre>
+</pre>
-    Finally, run mtxrun to generate a fonts database: <br />
+Finally, run mtxrun to generate a fonts database: <br />
-    <pre>
+<pre>
-    mtxrun --script fonts --reload --simple
+mtxrun --script fonts --reload --simple
-    </pre>
+</pre>
 == Contents ==
-This files for this project are also available at:
+The most recent files for this project are also available at:
 [https://github.com/s-dismas/TeX-without-TeX-revised GitHub]
-There is a Read Eval Print Loop available for interactively exploring:
+There is a Read Eval Print Loop available for interactive exploring:
 [[T_wo_T_r:repl.lua|repl.lua]]

@@ Line 142: / Line 142: @@
 within [[T_wo_T_r:test.tex|test.tex]] is:
-[[T_wo_T_r:test.lua|test.tex]]
+[[T_wo_T_r:test.lua|test.lua]]
 The main text file to be typeset is:

@@ Line 146: / Line 146: @@
 The main text file to be typeset is:
-[[T_wo_T_r:text.txt|text.txt]]
+[[T_wo_T_r:text.tex|text.tex]]
 It includes the following five files:
-[[T_wo_T_r:chapter-1.txt|chapter 1]]
+[[T_wo_T_r:chapter-1.tex|chapter 1]]
-[[T_wo_T_r:chapter-2.txt|chapter 2]]
+[[T_wo_T_r:chapter-2.tex|chapter 2]]
-[[T_wo_T_r:chapter-3.txt|chapter 3]]
+[[T_wo_T_r:chapter-3.tex|chapter 3]]
-[[T_wo_T_r:chapter-4.txt|chapter 4]]
+[[T_wo_T_r:chapter-4.tex|chapter 4]]
-[[T_wo_T_r:chapter-5.txt|chapter 5]]
+[[T_wo_T_r:chapter-5.tex|chapter 5]]