{"id":13870135,"url":"https://github.com/xu-cheng/texlive-action","last_synced_at":"2025-03-16T20:31:07.316Z","repository":{"id":74418186,"uuid":"261394089","full_name":"xu-cheng/texlive-action","owner":"xu-cheng","description":":octocat: GitHub Action to run arbitrary commands in a TeXLive environment","archived":false,"fork":false,"pushed_at":"2024-03-16T08:56:14.000Z","size":17,"stargazers_count":99,"open_issues_count":0,"forks_count":9,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-27T13:18:27.873Z","etag":null,"topics":["github-actions","latex","texlive"],"latest_commit_sha":null,"homepage":"https://github.com/xu-cheng/texlive-action","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xu-cheng.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["xu-cheng"]}},"created_at":"2020-05-05T07:55:51.000Z","updated_at":"2025-02-24T08:40:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"f0ce4f88-fab9-4050-a6bb-33fad88caeaf","html_url":"https://github.com/xu-cheng/texlive-action","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xu-cheng%2Ftexlive-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xu-cheng%2Ftexlive-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xu-cheng%2Ftexlive-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xu-cheng%2Ftexlive-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xu-cheng","download_url":"https://codeload.github.com/xu-cheng/texlive-action/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243830912,"owners_count":20354848,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github-actions","latex","texlive"],"created_at":"2024-08-05T20:01:31.113Z","updated_at":"2025-03-16T20:31:06.891Z","avatar_url":"https://github.com/xu-cheng.png","language":"Shell","funding_links":["https://github.com/sponsors/xu-cheng"],"categories":["Shell"],"sub_categories":[],"readme":"# texlive-action\n\n[![GitHub Actions Status](https://github.com/xu-cheng/texlive-action/workflows/Test%20Github%20Action/badge.svg)](https://github.com/xu-cheng/texlive-action/actions)\n\nGitHub Action to run arbitrary commands in a [TeXLive](https://www.tug.org/texlive/) environment.\n\nIt comes with two flavors, `full` and `small`. The `full` action has all TeXLive packages installed. The `small` one however only has basic packages installed to reduce its size. You can use `tlmgr install \u003cpackage\u003e` to install the missing packages.\nThe base image is [alpine](https://alpinelinux.org). Use `apk add \u003cpackage\u003e` to install additional system packages.\nSee [latex-docker](https://github.com/xu-cheng/latex-docker) for the scripts to build the respective docker images.\n\nThis action is suitable to run arbitrary commands in a LaTeX environment. If you simply want to compile LaTeX documents, [latex-action](https://github.com/xu-cheng/latex-action) is better recommended.\n\n## Inputs\n\n* `run`: Arbitrary bash codes to be executed. It will be executed in the form of `bash -eo pipefail -c {input}`.\n* `scheme`: The scheme of TeXLive to be used, either full or small. By default, full TeXLive is used. This input cannot co-exist with `docker_image` input.\n* `texlive_version`: The version of TeXLive to be used. Supported inputs include 2020, 2021, 2022, 2023, 2024, and latest. By default the latest TeXLive is used. This input cannot co-exist with `docker_image` input.\n* `docker_image`: Custom which docker image to be used. Only [latex-docker images](https://github.com/xu-cheng/latex-docker/pkgs/container/texlive-full) are supported.\n\n## Example\n\n* Run commands in a **full** TeXLive environment.\n\n  ```yaml\n  on: [push]\n  jobs:\n    build_latex:\n      runs-on: ubuntu-latest\n      steps:\n        - uses: actions/checkout@v4\n        - uses: xu-cheng/texlive-action@v2\n          with:\n            scheme: full\n            run: |\n              apk add make\n              make\n  ```\n\n* Run commands in a **small** TeXLive environment.\n\n  ```yaml\n  on: [push]\n  jobs:\n    build_latex:\n      runs-on: ubuntu-latest\n      steps:\n        - uses: actions/checkout@v4\n        - uses: xu-cheng/texlive-action@v2\n          with:\n            scheme: small\n            run: |\n              apk add make\n              make\n  ```\n\n* Run commands in a 2022 TeXLive environment.\n\n  ```yaml\n  on: [push]\n  jobs:\n    build_latex:\n      runs-on: ubuntu-latest\n      steps:\n        - uses: actions/checkout@v4\n        - uses: xu-cheng/texlive-action@v2\n          with:\n            texlive_version: 2022\n            run: |\n              apk add make\n              make\n  ```\n\n* Run commands using custom docker image.\n\n  ```yaml\n  on: [push]\n  jobs:\n    build_latex:\n      runs-on: ubuntu-latest\n      steps:\n        - uses: actions/checkout@v4\n        - uses: xu-cheng/texlive-action@v2\n          with:\n            docker_image: ghcr.io/xu-cheng/texlive-full:20230801\n            run: |\n              apk add make\n              make\n  ```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxu-cheng%2Ftexlive-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxu-cheng%2Ftexlive-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxu-cheng%2Ftexlive-action/lists"}