-
Notifications
You must be signed in to change notification settings - Fork 532
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Reproducible TeX build environment using Docker #27
Comments
Just focus on "building docker image for consistent environment" and then the issue could be the first task to be done. The title of this issue are almost the same with #25. |
I will focus on producing the PDF file first instead, since it is pretty stable and no other task dependencies. It will serve as a foundation to build other assets too. |
Add a new Github Action to build and release the pdf file after every push to master. Using texlive/texlive docker image for reproducibility and also forward compability with tools like make4ht for future builds. Progress sysprog21#27 - Reproducible TeX build environment using Docker
Add a new Github Action to build and release the pdf file after every push to master. Using texlive/texlive docker image for reproducibility and also forward compability with tools like make4ht for future builds. Progress sysprog21#27 - Reproducible TeX build environment using Docker
Add a new Github Action to build and release the pdf file after every push to master. Using texlive/texlive docker image for reproducibility and also forward compability with tools like make4ht for future builds. Progress sysprog21#27 - Reproducible TeX build environment using Docker
Add a new Github Action to build and release the pdf file after every push to master. Using texlive/texlive docker image for reproducibility and also forward compability with tools like make4ht for future builds. Progress sysprog21#27 - Reproducible TeX build environment using Docker
Add a new Github Action to build and release the pdf file after every push to master. Using texlive/texlive docker image for reproducibility and also forward compability with tools like make4ht for future builds. Progress sysprog21#27 - Reproducible TeX build environment using Docker
Add a new Github Action to build and release the pdf file after every push to master. Using texlive/texlive docker image for reproducibility and also forward compability with tools like make4ht for future builds. Progress sysprog21#27 - Reproducible TeX build environment using Docker
Add a new Github Action to build and release the pdf file after every push to master. Using texlive/texlive docker image for reproducibility and also forward compability with tools like make4ht for future builds. Progress sysprog21#27 - Reproducible TeX build environment using Docker
Add a new Github Action to build and release the pdf file after every push to master. Using texlive/texlive docker image for reproducibility and also forward compability with tools like make4ht for future builds. Progress sysprog21#27 - Reproducible TeX build environment using Docker
Add a new GitHub Action to build and release the PDF file after every push to master. Use texlive/texlive docker image for the sake of reproducibility in preparation for future build tools like make4ht . Progress #27 - Reproducible TeX build environment using Docker
I tried to use xu-cheng/texlive-action for html building, and the following script worked for me: name: Generate HTML and deploy to GitHub Page.
on:
push:
branches:
- master
jobs:
build-deploy:
runs-on: ubuntu-latest
steps:
- name: checkout branch
uses: actions/checkout@v2
- name: install dependencies and generating files
uses: xu-cheng/texlive-action/full@v1
with:
run: |
apk add make
make html
- name: deploy site
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: ./html
publish_branch: gh-pages You can checkout the output in here |
#32 is working on it. |
Currently both workflow texlive-action and container texlive are build for general use, and they're not actually an "reproducible TeX build environment" for our project. I've build this docker image supports full TeX Live with Gnuplot and Pandoc. If you have installed # clone the source code
$ git clone https://github.com/sysprog21/lkmpg && cd lkmpg
# pull docker image and run it as container
$ docker pull twtug/lkmpg
$ docker run --rm -it -v $(pwd):/workdir twtug/lkmpg
# run commands to compile documents
$ pdflatex -shell-escap lkmpg.tex
$ make4ht --shell-escape --utf8 --format html5 --config html.cfg --output-dir html lkmpg.tex |
Hi @jserv, could you check this Dockerfile and tell me any packages should be add or remove? Moreover, do you prefer any other docker registries (Docker Hub/GitHub Packages...etc) for storing the docker image? |
Add a new Github Action to publish to the GitHub page. Use twtug/lkmpg image for reproducibility. Ref: - sysprog21#27 - https://github.com/TeXtw/docker-lkmpg
I am no expert in Docker. It seems to be comprehensive to me. |
Just consider that docker is something like virtual machine but much lighter. Dockers based on container technology and the containers are just user space of the operating system. Let me try to make a long story short:
Actually, you can just tell me the packages and software to be installed for building this project. |
I think it's working quite fine for now, we can leave it as is until we encounter a solid problem. What do you think? |
Sure! |
This is to centralize efforts of developing Github Actions and if needed a customized docker container for the purpose of building all assets (PDFs, HTMLs, etc).
or address asset upload warning softprops/action-gh-release#134)Generate HTML via make4ht #20)The text was updated successfully, but these errors were encountered: