CTAN Comprehensive TeX Archive Network

Announcements for RunTeXshebang

Runshebang – A Lua script running document files with -style shebang

In short, a -style shebang (%#!) is a special kind of comment that you include in your / document file to tell the operating system’s shell how to run the file for the rest of the file:

      %#!lualatex foo.tex
      \documentclass{article}
      \begin{document}
        Hello, {\} World!
Happy {\}ing. \end{document}

If you are using a -style shebang, it must appear on the line that matched 20 lines or less in your document, and it has to start with a comment symbol (%) followed by a hash sign (#) and an exclamation mark (!), colloquially known as the bang, hence the name shebang for /.

runtexshebang executes the %#! line through the system shell, so only use it on documents you trust. It is a build tool invoked by the user and must not be added to shell_escape_commands.

PackageRunTeXshebang
Version1.1 2026-10-21
Copyright2021–2026 Munehiro Yamamoto
MaintainerMunehiro Yamamoto

Atom Atom 1.0 feed with announcements for package runtexshebang.
RSS RSS 2.0 feed with announcements for package runtexshebang.

Guest Book Sitemap Contact Contact Author