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

Karl Berry karl at freefriends.org
Wed Dec 4 22:52:08 CET 2024


Hi Vit,

    If I understand correctly, there isn't an automated mechanism for this. 

Correct. Adding new user-level executables is sufficiently fraught with
potential problems that I want to examine each new case individually.

    process involves placing the script file in the scripts/ directory
    on CTAN, 

The location on CTAN isn't important for this purpose, but should be
chosen according to whatever makes the most sense, as usual. User-level
scripts in TL can (and do) come from anywhere on CTAN.

Also, the file does not have to be executable on CTAN. Either way is ok. 

    politely requesting the distribution maintainers to include
    it, or writing a README file and hoping it catches someone's
    attention.

Yes. Or, if Christian and/or I fail to notice (not uncommon,
unfortunately), write this list (for TL; I don't know about MiKTeX
preferences) and mention it.

I'm guessing you already saw it, but for the record,
I write down what I could think of about scripts and TL at
https://tug.org/texlive/pkgcontrib.html#exec.  

-

The basic question from me is, what is markdown-cli? Is it useful
outside the TeX markdown package? Are there (or could there be) other
unrelated markdown "CLI"s? Because our script names have to be
reasonably identifying not just for the TeX world, but for the entire
OS, since they're going to end up in the OS distributions in, typically,
/usr/bin.  --thanks, karl.



More information about the tex-live mailing list.