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

[Vít Starý Novotný]

Thank you both for your insights.

If I understand correctly, there isn't an automated mechanism for this. The
process involves placing the script file in the scripts/ directory on CTAN,
politely requesting the distribution maintainers to include it, or writing
a README file and hoping it catches someone's attention.

I appreciate your clarification!

Best regards,
Vít

On Wed, Dec 4, 2024 at 11:20 AM Zdenek Wagner <zdenek.wagner at gmail.com>
wrote:

> 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
> >> ------------------------------------------------------------------
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://tug.org/pipermail/tex-live/attachments/20241204/ece84bf5/attachment.htm>