Skip to content

Setup

Jump to bottom
Moda / L10n Project edited this page Nov 2, 2023 · 2 revisions

本次專案建立翻譯流程與測試網站，使用 Weblate 與 Github 搭建翻譯平台，協助譯者與校閱者在翻譯、校閱過程中的溝通與作業。

工作平台簡介

Weblate

Weblate 主要是整合版本控制（如：git）在網頁介面上編輯的翻譯工具且支援多格式的輸出，並可共用字彙庫，方便譯者達成翻譯一致信。

Weblate 使用 GNU GPLv3+ 方式授權釋出，本次專案使用「自行架設」方案建構翻譯平台。https://weblate.org/zh-hant/hosting/

目前主要開源軟體在地化使用 weblate 為翻譯平台：openSUSE, Mattermost, F-Droid, Tor Project … 與約 900 開源專案使用。https://hosted.weblate.org/projects/

Github

GitHub 是一個線上軟體原始碼代管服務平台，使用 Git 作為版本控制軟體並支援建立私有倉庫。

翻譯平台建構

本次專案使用 Weblate (docker-compose) 版本建立，並依軟體基本需求，在 AWS EC2 建立一個 t4g.medium instance、Ubuntu 22.04.1 LTS（20 GB），並全程連線使用 TLS1.3（憑證發行商 Let's Encrypt）確保資料傳遞安全與避免網絡連線被攔截和竄改。

Weblate 下載

本次專案使用 weblate (docker compose) 版本，可直接使用 git 將此版本下載。

git clone https://github.com/WeblateOrg/docker-compose.git
cd docker-compose

Weblate 設定檔

調整以下設定檔至合適的資訊：

version: '3'
services:
  weblate:
  image: weblate/weblate:latest
  ports:
    - 127.0.0.1:8787:8080
  environment:
    WEBLATE_DEBUG: 0
    WEBLATE_ADMIN_EMAIL: {admin mail}
    WEBLATE_ADMIN_PASSWORD: {admin password}
    WEBLATE_SERVER_EMAIL: {server admin mail}
    WEBLATE_DEFAULT_FROM_EMAIL: {sender mail}
    WEBLATE_EMAIL_HOST: email-smtp.us-east-1.amazonaws.com
    WEBLATE_EMAIL_HOST_USER: {AWS SES API Token}
    WEBLATE_EMAIL_HOST_PASSWORD: {AWS SES API Key}
    WEBLATE_TIME_ZONE: "Asia/Taipei"
    WEBLATE_SITE_DOMAIN: {website domain}
    WEBLATE_ENABLE_HTTPS: 1
    WEBLATE_REGISTRATION_OPEN: 0
    WEBLATE_WORKERS: 1
    CELERY_MAIN_OPTIONS: --concurrency=1
    CELERY_NOTIFY_OPTIONS: --concurrency=1
    CELERY_TRANSLATE_OPTIONS: --concurrency=1

Weblate 啟動

設定檔完成後可以在 weblate 資料夾建立與啟動。

docker compose up –build

第一次執行需要等待些許時間初始化。

Standard

系統需要先安裝部分套件

apt-get install git curl autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libdb-dev

安裝 Rbenv

curl -fsSL https://github.com/rbenv/rbenv-installer/raw/HEAD/bin/rbenv-installer | bash

逐行執行以下指令調整系統環境

echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
source ~/.bashrc

確認 rbenv 已建立

rbenv -v

安裝 Ruby 3.1.3

rbenv install 3.1.3
rbenv global 3.1.3

安裝 jekyll 文件產生器

gem install bundler jekyll

下載專案原始碼

git clone https://github.com/publiccodenet/standard.git
cd standard

安裝套件

bundle install

產生文件內容

bundle exec jekyll build

文件內容會產出到 ./_site 資料夾底下，直接透過瀏覽器開啟 ./_site/index.html 即可。

Clone this wiki locally