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

[Zdenek Wagner]

Hi,

there are two major distros, TeX Live and MiKTeX. When I make a new
package, I write such information to the README file so that the
maintainers of both distros know what to do. They create a script for
taking the package from CTAN to the distro. If I upload a new version
without changing the structure of the package, they just update it in
the distro by running the script.

Zdeněk Wagner
https://www.zdenek-wagner.eu/

st 4. 12. 2024 v 11:10 odesílatel Vít Starý Novotný <witiko at gmail.com> napsal:
>
> Dear Reinhard,
>
> Thank you for your message. The script already exists on CTAN, so I assume I just need
> to add the shebang line and make the file executable in the next release then?
>
> Best,
> Vit
>
> On Wed, Dec 4, 2024 at 5:49 AM Reinhard Kotucha <reinhard.kotucha at gmx.de> wrote:
>>
>> 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
>> ------------------------------------------------------------------