Iosevka/docker/README.md
Belleve af8f360e0e
PR: add bump ver check (#2282)
* Add bump-version check into the PR validation workflow

* Check condition for PR

* Setup step and job outputs for conditionals

* Fixup

* Limit fetch depth

* Fix typo

* Use a different checkout pattern

* Bump version

* Fixup conditional for the build stage

* Still allow the build stage even if the bump_version_check stage did found changes, as commits by github actions bot won't triggger actions

---------

Co-authored-by: GitHub Actions <actions@github.com>
2024-04-07 23:09:16 +00:00

48 lines
1.8 KiB
Markdown

## Make docker image
```
git clone --depth=1 https://github.com/be5invis/Iosevka.git $HOME/mkdkimg
cd $HOME/mkdkimg/docker
docker build -t=fontcc .
docker images | grep fontcc # Confirm that the docker image is generated successfully
fontcc latest c847d5e08886 About a minute ago 491MB
cd ../..
rm -rf mkdkimg/
```
Note: Make docker image need execute only one time.
## Usage
`docker run -it --rm -v $PWD:/work fontcc <BUILD_ARGS>`
Please refer to the `<BUILD_ARGS>` parameters to [Customized Build](../../dev/doc/custom-build.md#customized-build)
### Optional parameters (put them before `fontcc`):
1. `-e "VERSION_TAG=<tag>"`
`<tag>` can be the following values
- `main` git main branch
- `dev` git dev branch
- `v28.0.5` git [release version tags](../../../tags)
When this variable is omitted, the tag of the latest release will be selected
2. `-e "NPM_REG=<npm repository mirror url>"`
change `npm install` download repository to mirror site.
eg. change npm repos to huawei mirror
`docker run -it --rm -v $PWD:/work -e "NPM_REG=https://mirrors.huaweicloud.com/repository/npm" fontcc contents::Iosevka`
## Example
### Partially Build dev branch
```
mkdir -p $HOME/build_fonts
cd $HOME/build_fonts
docker run -it --rm -v $PWD:/work -e "VERSION_TAG=dev" fontcc contents::IosevkaSS06 ttf::IosevkaSS12 webfont::IosevkaSS15
ls -lR dist/
```
### Customized Build
```
cd $HOME/mycustomfonts
cat myfont1.toml myfont2.toml myfont3.toml > private-build-plans.toml
docker run -it --rm -v $PWD:/work fontcc ttf::myfont1 ttf::myfont2 contents::myfont3
ls -lR dist/
```
Note: You need prepare myfont1.toml myfont2.toml myfont3.toml youself, The [Customizer](https://be5invis.github.io/Iosevka/customizer) can help you easily generate font configuration file `.toml`.