diff options
author | Karl Berry <karl@freefriends.org> | 2023-04-05 20:09:08 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2023-04-05 20:09:08 +0000 |
commit | 93570294d6aa702f5ac83233dbacda328ea8fa28 (patch) | |
tree | 0abe1922134288130aaccae5e10bc78e51795b2b /Master/texmf-dist/doc | |
parent | ebd6a55d07b38530ea441b619d12f712f2652da8 (diff) |
texfindpkg (5apr23)
git-svn-id: svn://tug.org/texlive/trunk@66777 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/texfindpkg.1 | 26 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/texfindpkg.man1.pdf | bin | 0 -> 12726 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/texfindpkg/README.md | 58 |
3 files changed, 84 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/man/man1/texfindpkg.1 b/Master/texmf-dist/doc/man/man1/texfindpkg.1 new file mode 100644 index 00000000000..22d7c8534c6 --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/texfindpkg.1 @@ -0,0 +1,26 @@ +.TH texfindpkg 1 "2023-04-05" "2023D" +.SH NAME +TexFindPkg \- Install TeX packages and their dependencies +.SH SYNOPSIS +texfindpkg <action> [<options>] [<name>] +.SH DESCRIPTION +TeXFindPkg makes it easy to install TeX packages and their dependencies +by file names, command names or environment names. +.PP +The most commonly used TeXFindPkg actions are: +.IP install +Install some package and its dependencies +.IP query +Query dependencies for some package +.SH OPTIONS +Various options apply +.IP --help +Print a help message and exit +.IP --version +Print version information and exit +.SH BUGS +.SH AUTHOR +Jianrui Lyu <tolvjr@163.com> +.PP +Please log issues on the GitHub homepage: +https://github.com/lvjr/texfindpkg/issues. diff --git a/Master/texmf-dist/doc/man/man1/texfindpkg.man1.pdf b/Master/texmf-dist/doc/man/man1/texfindpkg.man1.pdf Binary files differnew file mode 100644 index 00000000000..260670a72bf --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/texfindpkg.man1.pdf diff --git a/Master/texmf-dist/doc/support/texfindpkg/README.md b/Master/texmf-dist/doc/support/texfindpkg/README.md new file mode 100644 index 00000000000..d0822b625d7 --- /dev/null +++ b/Master/texmf-dist/doc/support/texfindpkg/README.md @@ -0,0 +1,58 @@ +# TeXFindPkg tool for installing TeX packages + +``` +Description: Install TeX packages and their dependencies +Copyright: 2023 (c) Jianrui Lyu <tolvjr@163.com> +Repository: https://github.com/lvjr/texfindpkg +License: GNU General Public License v3.0 +``` + +## Introduction + +TeXFindPkg makes it easy to install TeX packages and their dependencies by file names, command names or environment names. + +- To install a package by its file name you can run `texfindpkg install array.sty`; +- To install a package by some command name you can run `texfindpkg install \fakeverb`; +- To install a package by some environment name you can run `texfindpkg install {frame}`. + +TeXFindPkg supports both TeXLive and MiKTeX distributions. At present it focuses mainly on LaTeX packages, +but may extend to ConTeXt packages if anyone would like to contribute. + +## Installation + +Your TeX distribution should have created a binary file `texfindpkg` when you install this package. +If not, you could create a symbolic link from `/usr/local/bin/texfindpkg` to `texfindpkg.lua` on Linux or MacOS, +or create a batch file `texfindpkg.bat` in binary folder of the TeX distribution with these lines on Windows: + +``` +@echo off +texlua path\to\texfindpkg.lua %* +``` + +## Usage + +``` +texfindpkg <action> [<options>] [<name>] +``` + +where `<action>` could be `install` or `query`, and `<name>` could be file name, command name or environment name. +For example: + +``` +texfindpkg install array.sty +texfindpkg install \fakeverb +texfindpkg install {frame} +texfindpkg query array.sty +texfindpkg query \fakeverb +texfindpkg query {frame} +``` + +## Building + +TeXFindPkg uses completion files of TeXstudio editor which are in `completion` folder of TeXstudio [repository](https://github.com/texstudio-org/texstudio). + +After putting `completion` folder into current folder, you can run `texlua texfindpkg.lua generate` to generate `texfindpkg.json` and `texfindpkg.json.gz` files. + +## Contributing + +Any updates of dependencies, commands or environments for packages should be contributed directly to TeXstudio project. |