{"id":727,"date":"2011-01-26T22:45:20","date_gmt":"2011-01-26T22:45:20","guid":{"rendered":"http:\/\/www.readytext.co.uk\/?p=727"},"modified":"2013-11-28T09:00:14","modified_gmt":"2013-11-28T09:00:14","slug":"enabling-luatexs-use-of-pdfoutput","status":"publish","type":"post","link":"https:\/\/www.readytext.co.uk\/?p=727","title":{"rendered":"Enabling LuaTeX’s use of \\pdfoutput"},"content":{"rendered":"

In the tutorial series A minimal LuaTeX setup on Windows<\/em> I showed how to get started with a very basic LuaTeX setup for plain TeX. Actually, it is so minimal that we have not even enabled the many new primitives (low-level commands) that the LuaTeX engine provides. Without “switching on” these new commands, LuaTeX supports just the original TeX82 primitives plus the \\directlua{...}<\/code> command. It does not even understand the pdfTeX primitive \\pdfoutput<\/code> which enables choosing between PDF and DVI output via your TeX file, rather than LuaTeX’s command line options. For example, before enabling the full LuaTeX command set, if you run the following plain TeX file (say demo.tex<\/code>):<\/p>\n

\\pdfoutput=1 %select PDF output
\nHello \\TeX
\n\\bye<\/code><\/p>\n

luatex --fmt=plain demo.tex<\/code><\/p>\n


\nc:\\luatexblog\\myfiles&g>luatex --fmt=plain demo.tex
\nThis is LuaTeX, Version beta-0.65.0-2010121314 (rev 4033)
\n(.\/demo.tex
\n! Undefined control sequence.
\nl.1 \\pdfoutput
\n=1 %select PDF output
\n?<\/code><\/p>\n

Hmmm, something is strange because LuaTeX is based on pdfTeX and that, of course, understands \\pdfoutput=1<\/code>.<\/p>\n

Creating a new format: luaplain<\/h4>\n

So, how do we get access to \\pdfoutput<\/code>? One way to do this is to create a new format, derived from plain TeX, but which contains a little bit of code to enable the full LuaTeX command set. We will call this format “luaplain” because it is no longer Knuth’s original plain TeX. The task is to create the luaplain.fmt<\/code> file so that we can access the full power of LuaTeX using plain TeX (later we will extend this to LaTeX).<\/p>\n

    \n
  1. Within the minimal TDS tree (see Part 6<\/a>), create a directory called c:\\luatexblog\\texmf\\tex\\luaplain\\<\/code><\/li>\n
  2. Create a TeX file called luaplain.tex<\/code> containing the following TeX code: \\input plain
    \n\\directlua {tex.enableprimitives('', tex.extraprimitives())}<\/code><\/li>\n
  3. Start a DOS session and change the current directory to c:\\luatexblog\\texmf\\web2c\\<\/code> (which is where we store .fmt<\/code> files, as we want to create luaplain.fmt<\/code>).<\/li>\n
  4. Type the command:
    \nc:\\luatexblog\\texmf\\web2c>luatex --ini luaplain.tex \\dump<\/code><\/li>\n
  5. All being well, you should see the file luaplain.fmt<\/code> created in c:\\luatexblog\\texmf\\web2c\\<\/code><\/li>\n<\/ol>\n

    Back to our example (demo.tex<\/code>) which failed under plain TeX<\/p>\n

    \\pdfoutput=1 %select PDF output
    \nHello \\TeX
    \n\\bye<\/code><\/p>\n

    Now run LuaTeX with the command line luatex --fmt=luaplain<\/strong> demo.tex<\/code> and you should see something like this:<\/p>\n

    c:\\luatexblog\\myfiles>luatex --fmt=luaplain demo.tex
    \nThis is LuaTeX, Version beta-0.65.0-2010121314 (rev 4033)
    \n(.\/demo.tex [1{c:\/luatexblog\/texmf\/fonts\/map\/pdftex.map}] )<c:\/luatexblog\/texmf
    \n\/fonts\/type1\/public\/cm\/cmr10.PFB>
    \nOutput written on demo.pdf (1 page, 11487 bytes).
    \nTranscript written on demo.log.<\/code><\/p>\n

    Success!<\/p>\n","protected":false},"excerpt":{"rendered":"

    In the tutorial series A minimal LuaTeX setup on Windows I showed how to get started with a very basic LuaTeX setup for plain TeX. Actually, it is so minimal that we have not even enabled the many new primitives (low-level commands) that the LuaTeX engine provides. Without “switching on” these new commands, LuaTeX supports […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[15],"tags":[],"class_list":["post-727","post","type-post","status-publish","format-standard","hentry","category-examples"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/www.readytext.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/727","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.readytext.co.uk\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.readytext.co.uk\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.readytext.co.uk\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.readytext.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=727"}],"version-history":[{"count":12,"href":"https:\/\/www.readytext.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/727\/revisions"}],"predecessor-version":[{"id":3248,"href":"https:\/\/www.readytext.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/727\/revisions\/3248"}],"wp:attachment":[{"href":"https:\/\/www.readytext.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=727"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.readytext.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=727"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.readytext.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=727"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}