# HUST visual assets

This directory contains four static vector PDF assets used by the theme:

- `hust-emblem-color.pdf`: the standard-color HUST emblem.
- `hust-emblem-white.pdf`: the inverse HUST emblem for blue fields.
- `hust-name-blue.pdf`: the horizontal Chinese standard name in HUST blue.
- `hust-name-white.pdf`: the inverse horizontal Chinese standard name for
  HUST-blue backgrounds.

All four files were generated from
[`hustvisual` v1.0.0](https://ctan.org/pkg/hustvisual), using its documented
`emblem` and `name` graphics. They are bundled so presentations do not require
`hustvisual` at compile time. They should be regenerated from the same source
rather than edited, stretched, recolored, or redrawn.

The small generation sources and TeX Live 2024 compatibility shim are kept in
[`tools/assets/`](../tools/assets/).

To reproduce the PDFs from the tagged upstream source:

```powershell
git clone --depth 1 --branch v1.0.0 `
  https://github.com/hust-latex/hustvisual.git tmp/hustvisual-v1

Push-Location tmp/hustvisual-v1
l3build unpack
Pop-Location

./tools/assets/build-assets.ps1
```

The script compiles the vector definitions with XeLaTeX and runs `pdfcrop` to
produce the tight-boundary files committed in this directory.

`hustvisual` is licensed under LPPL 1.3c. The HUST emblem and standard name are
institutional identity marks; their use remains subject to the
[official HUST visual identity guidelines](https://vi.hust.edu.cn/).

This repository is an unofficial community project. Inclusion of these assets
does not imply endorsement, approval, or maintenance by Huazhong University of
Science and Technology.
