55 lines
1.5 KiB
YAML
55 lines
1.5 KiB
YAML
|
# https://taskfile.dev
|
||
|
|
|
||
|
|
version: '3'
|
||
|
|
|
||
|
|
env:
|
||
|
|
POETRY_VIRTUALENVS_IN_PROJECT: true
|
||
|
|
|
||
|
|
vars:
|
||
|
|
DSTDIR: _build
|
||
|
|
LOCALES: en_GB en_US fr
|
||
|
|
SPHINX_OPTS: -j 4
|
||
|
|
SRCDIR: .
|
||
|
|
tasks:
|
||
|
|
default:
|
||
|
|
cmds:
|
||
|
|
- echo "To see the available tasks, run task -l"
|
||
|
|
silent: true
|
||
|
|
install:
|
||
|
|
desc: Install required dependencies
|
||
|
|
cmds:
|
||
|
|
- poetry install --no-root
|
||
|
|
- poetry run pip install --no-deps --editable ../api
|
||
|
|
clean:
|
||
|
|
desc: Remove generated artifacts
|
||
|
|
cmds:
|
||
|
|
- git clean -xdf .
|
||
|
|
dev:
|
||
|
|
desc: Start a development web server
|
||
|
|
cmds:
|
||
|
|
- poetry run sphinx-autobuild . /tmp/_build/ --port 8001
|
||
|
|
locale-gen:
|
||
|
|
desc: Generate translations
|
||
|
|
cmds:
|
||
|
|
- poetry run sphinx-build -b gettext {{.SRCDIR}} locales/gettext {{.SPHINX_OPTS}}
|
||
|
|
locale-update:
|
||
|
|
desc: Update translations
|
||
|
|
cmds:
|
||
|
|
- for: { var: LOCALES }
|
||
|
|
cmd: poetry run sphinx-intl update -p locales/gettext {{.ITEM}}
|
||
|
|
locale-prune-untranslated:
|
||
|
|
desc: Prune untranslated locales
|
||
|
|
cmds:
|
||
|
|
- poetry run _scripts/locale-prune-untranslated.py
|
||
|
|
build:
|
||
|
|
desc: Build documentation
|
||
|
|
cmds:
|
||
|
|
- poetru run sphinx-build {{.SRCDIR}} {{.DSTDIR}} {{.SPHINX_OPTS}}
|
||
|
|
build-translated:
|
||
|
|
desc: Build (translated) documentation
|
||
|
|
cmds:
|
||
|
|
- for: { var: LOCALES }
|
||
|
|
cmd: poetry run sphinx-build {{.SRCDIR}} {{.DSTDIR}}/{{.ITEM}} {{.SPHINX_OPTS}} -D language={{.IT
|
||
|
|
- for: { var: LOCALES }
|
||
|
|
cmd: poetry run sphinx-build {{.SRCDIR}} {{.DSTDIR}}/{{.ITEM}} {{.SPHINX_OPTS}} -D language={{.ITEM}}
|
||
|
|
|