RunTeXshebang – A Lua script running LaTeX document files with TeX-style shebang

In short, a TeX-style shebang (%#!) is a special kind of TeX comment that you include in your TeX/LaTeX 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, {\LaTeX} World!
        Happy {\TeX}ing.
      \end{document}
    

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

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.

Download the contents of this package in one zip archive (66.9k).