mirror of
https://github.com/booklore-app/booklore.git
synced 2026-02-18 00:17:53 +01:00
feat(i18n): add Weblate integration and auth translations (#2727)
* feat(i18n): add Weblate integration and auth translations for all languages * chore: cache-bust Weblate widget URL
This commit is contained in:
ACX
183
scripts/weblate-setup.sh
Executable file
183
scripts/weblate-setup.sh
Executable file
@@ -0,0 +1,183 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# Weblate Setup Script for BookLore
|
||||
#
|
||||
# Creates the Weblate project and all 25 translation components via the API.
|
||||
# Run once after creating your Hosted Weblate account.
|
||||
#
|
||||
# Prerequisites:
|
||||
# 1. Get your API token from https://hosted.weblate.org/accounts/profile/#api
|
||||
# 2. Ensure your GitHub repo (booklore-app/booklore) is public (required for Libre plan)
|
||||
#
|
||||
# Usage:
|
||||
# WEBLATE_TOKEN=your-api-token ./scripts/weblate-setup.sh
|
||||
#
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
# ─── Configuration ────────────────────────────────────────────────────────────
|
||||
WEBLATE_URL="${WEBLATE_URL:-https://hosted.weblate.org}"
|
||||
API="${WEBLATE_URL}/api"
|
||||
TOKEN="${WEBLATE_TOKEN:?Set WEBLATE_TOKEN to your Weblate API token}"
|
||||
|
||||
PROJECT_NAME="BookLore"
|
||||
PROJECT_SLUG="booklore"
|
||||
PROJECT_WEB="https://github.com/booklore-app/booklore"
|
||||
|
||||
REPO_URL="https://github.com/booklore-app/booklore.git"
|
||||
REPO_BRANCH="develop"
|
||||
FILE_BASE="booklore-ui/src/i18n"
|
||||
|
||||
SOURCE_LANG="en"
|
||||
|
||||
# All languages the project supports
|
||||
LANGUAGES="en es de fr it nl pl pt ru"
|
||||
|
||||
# All 25 translation domain files (without .json extension)
|
||||
COMPONENTS=(
|
||||
common
|
||||
auth
|
||||
nav
|
||||
dashboard
|
||||
settings
|
||||
settings-email
|
||||
settings-reader
|
||||
settings-view
|
||||
settings-metadata
|
||||
settings-library-metadata
|
||||
settings-application
|
||||
settings-users
|
||||
settings-naming
|
||||
settings-opds
|
||||
settings-tasks
|
||||
settings-auth
|
||||
settings-device
|
||||
settings-profile
|
||||
app
|
||||
shared
|
||||
layout
|
||||
library-creator
|
||||
bookdrop
|
||||
metadata
|
||||
)
|
||||
|
||||
# ─── Helpers ──────────────────────────────────────────────────────────────────
|
||||
auth_header="Authorization: Token ${TOKEN}"
|
||||
content_type="Content-Type: application/json"
|
||||
|
||||
api_post() {
|
||||
local endpoint="$1"
|
||||
local data="$2"
|
||||
local response
|
||||
response=$(curl -s -w "\n%{http_code}" -X POST "${API}${endpoint}" \
|
||||
-H "${auth_header}" \
|
||||
-H "${content_type}" \
|
||||
-d "${data}")
|
||||
local http_code
|
||||
http_code=$(echo "$response" | tail -1)
|
||||
local body
|
||||
body=$(echo "$response" | sed '$d')
|
||||
|
||||
if [[ "$http_code" -ge 200 && "$http_code" -lt 300 ]]; then
|
||||
echo " OK (${http_code})"
|
||||
return 0
|
||||
elif [[ "$http_code" == "400" ]] && echo "$body" | grep -q "already exists"; then
|
||||
echo " Already exists, skipping"
|
||||
return 0
|
||||
else
|
||||
echo " FAILED (${http_code}): ${body}"
|
||||
return 1
|
||||
fi
|
||||
}
|
||||
|
||||
# Pretty name from slug: settings-email -> Settings Email
|
||||
pretty_name() {
|
||||
echo "$1" | sed 's/-/ /g' | awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) tolower(substr($i,2))}1'
|
||||
}
|
||||
|
||||
# ─── Step 1: Create Project ──────────────────────────────────────────────────
|
||||
echo "=== Creating project: ${PROJECT_NAME} ==="
|
||||
api_post "/projects/" "$(cat <<EOF
|
||||
{
|
||||
"name": "${PROJECT_NAME}",
|
||||
"slug": "${PROJECT_SLUG}",
|
||||
"web": "${PROJECT_WEB}",
|
||||
"source_language": {
|
||||
"code": "${SOURCE_LANG}"
|
||||
}
|
||||
}
|
||||
EOF
|
||||
)"
|
||||
|
||||
# ─── Step 2: Create Components ───────────────────────────────────────────────
|
||||
echo ""
|
||||
echo "=== Creating ${#COMPONENTS[@]} translation components ==="
|
||||
echo ""
|
||||
|
||||
first=true
|
||||
for comp in "${COMPONENTS[@]}"; do
|
||||
name=$(pretty_name "$comp")
|
||||
file_mask="${FILE_BASE}/*/${comp}.json"
|
||||
source_file="${FILE_BASE}/${SOURCE_LANG}/${comp}.json"
|
||||
|
||||
echo "Creating component: ${name} (${comp})"
|
||||
|
||||
# The first component links to the VCS repo directly.
|
||||
# Subsequent components use "repo" linking to share the same repo checkout.
|
||||
if $first; then
|
||||
api_post "/projects/${PROJECT_SLUG}/components/" "$(cat <<EOF
|
||||
{
|
||||
"name": "${name}",
|
||||
"slug": "${comp}",
|
||||
"file_format": "json-nested",
|
||||
"filemask": "${file_mask}",
|
||||
"template": "${source_file}",
|
||||
"repo": "${REPO_URL}",
|
||||
"branch": "${REPO_BRANCH}",
|
||||
"push": "",
|
||||
"source_language": {
|
||||
"code": "${SOURCE_LANG}"
|
||||
},
|
||||
"new_lang": "none",
|
||||
"manage_units": false,
|
||||
"check_flags": "python-brace-format",
|
||||
"language_regex": "^(en|es|de|fr|it|nl|pl|pt|ru)$"
|
||||
}
|
||||
EOF
|
||||
)"
|
||||
first=false
|
||||
else
|
||||
# Link to the first component's repo to save disk space and API calls
|
||||
api_post "/projects/${PROJECT_SLUG}/components/" "$(cat <<EOF
|
||||
{
|
||||
"name": "${name}",
|
||||
"slug": "${comp}",
|
||||
"file_format": "json-nested",
|
||||
"filemask": "${file_mask}",
|
||||
"template": "${source_file}",
|
||||
"repo": "weblate://${PROJECT_SLUG}/common",
|
||||
"source_language": {
|
||||
"code": "${SOURCE_LANG}"
|
||||
},
|
||||
"new_lang": "none",
|
||||
"manage_units": false,
|
||||
"check_flags": "python-brace-format",
|
||||
"language_regex": "^(en|es|de|fr|it|nl|pl|pt|ru)$"
|
||||
}
|
||||
EOF
|
||||
)"
|
||||
fi
|
||||
done
|
||||
|
||||
echo ""
|
||||
echo "=== Setup complete ==="
|
||||
echo ""
|
||||
echo "Next steps:"
|
||||
echo " 1. Visit ${WEBLATE_URL}/projects/${PROJECT_SLUG}/ to verify"
|
||||
echo " 2. If you want Weblate to push translations back:"
|
||||
echo " - Add a deploy key with write access to your GitHub repo"
|
||||
echo " - Update the 'common' component push URL to: ${REPO_URL}"
|
||||
echo " - Set push branch to: weblate-translations"
|
||||
echo " 3. Alternatively, enable the GitHub PR add-on for automatic PRs"
|
||||
echo " 4. Share the translation URL with contributors!"
|
||||
echo ""
|
||||
Reference in New Issue
Block a user