michal-h21 / make4ht-action

Github Action for TeX to XML conversion using make4ht
GNU General Public License v3.0
6 stars 1 forks source link

make4ht build action

make4ht is a build system for TeX4ht, TeX to XML converter. This Docker image can be used to compile your LaTeX document in automated environment, such as Github Actions.

Examples

Usage

Sample .github/workflows/main.yml file:

name: CI 
on: [push] 
jobs: 
  build: 
   runs-on: ubuntu-latest 
   steps: 
   - uses: actions/checkout@v1 
   - name: Run make4ht 
     uses: docker://ghcr.io/michal-h21/make4ht-action:latest 
     env: 
       command: "make4ht -d out main.tex" 
   - name: Publish the web pages 
     uses:  peaceiris/actions-gh-pages@v3 
     with: 
       github_token: ${{ secrets.GITHUB_TOKEN }} 
       publish_dir: ./out 

This worflow compiles file main.tex using make4ht. The resulting main.html file is placed in the out directory, which is then served using Github Pages.