moloch/Taskfile.yml at main · jolars/moloch · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
version: "3"

tasks:
  install:
    desc: Install the latex package locally
    cmds:
      - l3build install

  extract-dtx-docs:
    desc: Extract and convert DTX documentation to Markdown
    cmds:
      - texlua scripts/extract-dtx-docs.lua

  test:
    desc: Run the test suite, checking package functionality
    deps:
      - generate-example-images
    cmds:
      - l3build-wrapped check

  docs:
    desc: Build the documentation site (Quarto)
    dir: docs
    deps:
      - extract-dtx-docs
      - generate-example-images
    cmds:
      - quarto render

  docs-preview:
    desc: Preview the generated documentation in a web browser
    dir: docs
    cmds:
      - quarto preview

  build-manual:
    desc: Build the PDF manual
    deps:
      - extract-dtx-docs
      - generate-example-images
    cmds:
      - cd docs && quarto render --to pdf

  ctan:
    desc: Prepare the package for CTAN submission
    deps:
      - build-manual
    cmds:
      - l3build-wrapped ctan

  save-tests:
    desc: Save test expectations (fixtures) for all test files
    cmds:
      - l3build-wrapped save backgroundcolors
      - l3build-wrapped save sectionpages
      - l3build-wrapped save separation
      - l3build-wrapped save standoutnumbering
      - l3build-wrapped save test

  generate-example-images:
    desc: Compile examples and generate grid images
    cmds:
      # Generate colortheme examples from template
      - |
        cd examples
        for theme in default tomorrow paper catppuccin highcontrast; do
          for variant in light dark; do
            pdflatex -jobname="colortheme-${theme}-${variant}" \
                     -interaction=nonstopmode \
                     colortheme-template.tex
          done
        done
      # Compile other standalone examples (skip template and generated files)
      - |
        for file in examples/*.tex; do
          basename=$(basename "$file")
          if [ "$basename" != "colortheme-template.tex" ] && [ ! -f "examples/colortheme-${basename%.tex}.pdf" ]; then
            latexmk -pdf -interaction=nonstopmode -cd "$file"
          fi
        done
      # Generate grid images
      - mkdir -p docs/images
      - |
        for pdf in examples/*.pdf; do
          basename="${pdf##*/}"
          basename="${basename%.pdf}"
          ./scripts/pdf-to-grid.sh "$pdf" "docs/images/example-${basename}.png" 2 150
        done