Steps to make scripts/markdown/markdown-cli.lua executable and symlinked to system directories as markdown-cli

[Reinhard Kotucha]

On 2024-12-04 at 00:59:37 +0100, Vít Starý Novotný wrote:

 > Dear TeX Live developers,
 > 
 > I am writing to inquire about the steps required to make a Lua
 > script from a CTAN package available as an executable that is
 > automatically symlinked to system directories in TeX
 > Live. Specifically, I would like to make
 > scripts/markdown/markdown-cli.lua executable and symlinked as
 > markdown-cli.
 > 
 > >From my understanding, the script should be placed in the scripts/
 > directory of the TDS, marked as executable, and include the shebang
 > #!/usr/bin/env texlua.
 > These are adjustments I can address in my CTAN release.
 > 
 > However, I am unclear about how to mark the script for symlinking
 > to system directories and how to specify the symlink name. It seems
 > that not all executable files in the scripts/ directory are
 > automatically symlinked. Is this behavior controlled by TeX Live
 > itself through a curated list of scripts to be symlinked, or is
 > there a more general mechanism that I should use?

Hi Vit,
it's sufficient to put scripts/markdown/markdown-cli.lua on CTAN.  

TeX Live will create symlinks "markdown-cli" within the various
bin/<Unix>/ directories and a wrapper "markdown-cli.exe" in
bin/windows.

Regards,
  Reinhard

-- 
------------------------------------------------------------------
Reinhard Kotucha                            Phone: +49-511-3373112
Marschnerstr. 25
D-30167 Hannover                    mailto:reinhard.kotucha at gmx.de
------------------------------------------------------------------