咖啡偶-IT日常 -

「Tolgee」自行架設(self-hosted)，使用docker

2025-03-22 william github, 其他, 技術, 軟體介紹

上一篇文章「Tolgee」協助您開發多語系APP我建議公司內部使用tolgee；本篇簡易tolgee教學「tolgee該如何使用docker自行架設」。

前置作業要把docker或podman，可以看這篇RockyLinux 安裝 docker準備好。
準備好外部的資料庫容器(postgres、mariadb)，postgress可參考這篇postgres 指令(連線、安裝)。
安裝容器
這裡我採用連結外部postgres，請先行建立資料庫tolgee，
其他環境變數(標示紅字)，需自行調整。

docker-compose.yaml檔案

version: '3'

services:
  app:
    image: tolgee/tolgee:latest
    volumes:
      - ./data:/data
      - ./config.yaml:/config.yaml
    ports:
      - '8090:8080'
    deploy:
      restart_policy:
        condition: on-failure
    env_file:
      - .env
#若不使用外部postgres，可自架內部專用postgres
#  db:
#    image: postgres:13
#    environment:
#      POSTGRES_DB: tolgee
#      POSTGRES_USER: admin
#      POSTGRES_PASSWORD: admin
#    volumes:
#      - ./data/postgres:/var/lib/postgresql/data
#    ports:
#      - '5432ˊ:5432' # 讓外面也可存取

.config.yaml檔案

tolgee:
  postgres-autostart:
    enabled: false
spring:
  datasource:
    url: jdbc:postgresql://外部postgreIP:5432/tolgee
    username: 帳號
    password: 密碼

.env檔案

spring.config.additional-location: file:///config.yaml
TOLGEE_AUTHENTICATION_ENABLED=true
TOLGEE_AUTHENTICATION_INITIAL_PASSWORD=admin
TOLGEE_AUTHENTICATION_INITIAL_USERNAME=admin
TOLGEE_AUTHENTICATION_JWT_SECRET=my_jwt_secret  #長度必須大於64
#TOLGEE_MACHINE_TRANSLATION_GOOGLE_API_KEY=my_google_api_key
TOLGEE_SMTP_AUTH=true
TOLGEE_SMTP_FROM=Tolgee <no-reply@mydomain.com>
TOLGEE_SMTP_HOST=email-smtp.regional-region.amazonaws.com
TOLGEE_SMTP_PASSWORD=omg/my/password
TOLGEE_SMTP_PORT=465
TOLGEE_SMTP_SSL_ENABLED=true
TOLGEE_SMTP_USERNAME=user@company.com

# 停用自行註冊功能，只能管理者邀請
TOLGEE_AUTHENTICATION_REGISTRATIONS_ALLOWED=false

# 搞定反向代理之後，請設定網站名稱(不然邀請函只會出現ip)
TOLGEE_FRONT_END_URL=https://tolgee.test.com

安裝完畢，管理者就可以寄發邀請email，或是連結給使用者，讓使用者加入專案

心得結論

Tolgee自架版本雖說有些限制，但已經很好用了，一般小公司有開發app的人已經不得了，不需要用企業版複雜功能。

Leave a comment contrainer, docker, podman, tolgee, 翻譯

「Tolgee」協助您開發多語系APP

2025-03-22 william android, github, 技術, 軟體介紹

「Tolgee」是一款新興的翻譯輔助系統，可以協助您開發多語系APP。

目前最有名的雲端翻譯網站為 crowdin，功能強大的付費系統，很推薦使用；若公司需要自行架設(self-hosted)，可以參考weblate或tolgee，這兩樣都是較有名的免費開源翻譯系統。

以下是 Weblate 和 Tolgee 的比較表，以幫助你選擇適合的翻譯與本地化平台：

特性	Weblate	Tolgee
類型	自託管 + 雲端	自託管 + 雲端
開源	✅（完全開源）	✅（開源，但部分功能需付費）
托管方式	自託管 / Weblate 服務	自託管 / Tolgee Cloud
即時協作	✅	✅
支援的格式	40+ 種格式（JSON、YAML、PO、XLIFF、TS、ResX 等）	JSON、XLIFF、PO、YAML、TS、Java Properties 等
機器翻譯	支援 Google、DeepL、Azure、Apertium	支援 Google、DeepL、Azure
翻譯記憶庫（TM）	✅	✅
自動提議翻譯	✅	✅
語言品質檢查	✅（內建 QA 機制）	✅（內建錯誤檢查）
上下文支援	🟡（需手動提供）	✅（可透過 Tolgee SDK 自動擷取）
API & SDK	REST API，可與 Git、CI/CD 整合	REST API，專有 SDK（適用於 React、Vue、Angular 等）
Git 整合	✅（自動同步）	✅（自動同步）
視覺化翻譯（In-context）	🟡（有限支援）	✅（內建即時預覽）
權限管理	✅（細緻的角色與權限控制）	✅（細緻的角色與權限控制）
價格	免費（自託管）/ 付費雲端	免費（基本功能）/ 進階功能需付費
適合對象	開發團隊、開源專案、企業	需要即時翻譯預覽的開發團隊

實作總結(推薦使用tolgee)

Weblate 需先選定APP翻譯格式，然後再進行翻譯，這樣可以直接與APP版控整合，但跨平台APP需要重複翻譯多次(多個格式)，另外weblate本身語言翻譯很差(乾脆不要提供各國語系版)，寧願使用英文版。
Tolgee 則採先翻譯方式，然後再整合不同APP開發格式輸出，這樣只要翻譯一次即可，再匯出讓工程師使用，但無法整合git較不方便。

ps. 到本日(2025/3/22) weblate尚未支援apple string catalog翻譯檔案(.xcstrings)，很不方便；而tolgee 3/5之後支援了。

One comment android, docker, 軟體開發輔助系統

Android自動調整文字大小

2025-03-18 william android, 技術

我是個半吊子Android程式師，有時候常常被使用者罵文字版面跑掉，深深覺得andoird要能自動調整textview文字大小非常重要。

有些android使用者會調整手機預設字型大小，有些因為手機本身解析度不同，甚至摺疊手機，都會影響APP使用體驗；因此我們設計app一定要考慮文字大小。

官網已經有詳細的介紹，請點選這裡參考。

我自己則常用以下設定來解決文字大小問題。

android:autoSizeTextType="uniform"
android:autoSizeMinTextSize="20sp"
android:autoSizeMaxTextSize="24sp"
android:autoSizeStepGranularity="2sp"

windows 10 22h2啟用sslv3以及老舊加密法

2025-03-11 william 其他

windows 10 22h2 已經停用 sslv3 加密，但是有些公司郵件伺服器還在使用sslv3，以及很老舊的加密方式，所以有必要啟用他們。

要啟用sslv3，可到 Nartac Software 下載 IIS Crypto 4.0 。

執行IIS Crypto程式，如下圖所示，點選「Best Practices」-> 再選SSL3.0 ，或是全選也可，然後套用 Apply ->重開機，就可以重新讓windows 10 22h2 重振雄風繼續支援老舊加密法。

這樣就能爭取時間，趕緊升級舊系統囉。

選擇 “Cipher Suites”(如下圖) ，將能勾選的都選上，然後手動加上以下加密法，最後再一次apply，Reboot。

#請手動加入
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_3DES_EDE_CBC_SHA

Leave a comment mail, microsoft, security, thunderbird, windows

mac lid closed 如何避免mac蓋子蓋上後電源關閉

2025-02-11 william 其他

Prevent Macbook Pro to sleep when lid closed

sudo pmset -a disablesleep 1

此外還要停用進入保護模式，以及休眠

Click Lock Screen, then select the menu next to Turn display off on power adapter when inactive. Pick Never.

https://www.lifewire.com/prevent-macbook-from-sleeping-when-lid-is-closed-5203069

windows uwp怎確認網站是否可存取

2025-02-07 william 其他

   try
   {
       var request = WebRequest.Create("https://tw.yahoo.com");
       request.Timeout = 5000;
       request.Method = "HEAD";

       using (var response = (HttpWebResponse)request.GetResponse())
       {
           String s = response.StatusCode.ToString();
           response.Close();
           return s.Equals(System.Net.HttpStatusCode.OK.ToString());
       }
   }
   catch (System.Net.WebException exception)
   {
       return false;
   }

RockyLinux 9 使用usb硬碟備份，要避免硬碟進入休眠

2025-01-25 william 其他

過年要到了，小公司需要利用這時間進行系統備份，外接usb備份也很重要，備份完直接切斷usb硬碟連線，但我發現usb會進入休眠，不確定是否能終端機叫醒，因此乾脆直接改成不休眠狀態。

2013年有篇文章，有大佬分享心得

Linux官方參考資料

Leave a comment backup, linux, RockyLinux

postgres 指令(連線、安裝)

2025-01-17 william 技術

我實在太弱了，不太會用postgres，每次要連線到openproject、teedy都要想很久。

# -U 帳號
# -d 資料庫名稱
# -p 埠(預設5432)
# -h 主機
# -W 需要輸入密碼
psql -U root -d openproject -p 5432 -h localhost -W

docker 安裝postgres

docker run -d --name postgres-17 -p 5432:5432 -e POSTGRES_USER=root -e POSTGRES_PASSWORD=ilovekafeiou -v  postgres-17-data:/var/lib/postgresql/data postgres:17.4-bookworm

常用指令

# 連到資料庫
\c 資料庫名稱

# 顯示所有table
\dt

One comment database, OpenProject, postgres, teedy

讓Content-Disposition解決非英文檔案，下載亂碼問題

2025-01-14 william 技術

這是老問題了，很多老外都忽略這個，我在協助teedy翻譯時，發現下載中文檔案中文會出現空白，看一下程式原來是忘了進行編碼導致，就順手提交一下解法。

#以下為java虛擬碼
CONTENT_DISPOSITION, "inline; filename*=utf-8''" + filenameEncode( "檔名" )

private String filenameEncode(String name) {
    try {
        return java.net.URLEncoder.encode(name, "UTF-8").replace("+", "%20");
    } catch (java.io.UnsupportedEncodingException e) {
        e.printStackTrace();
        return name;
    }
}

參考：

解決HTTP Header Content-Disposition檔案名稱不能輸入中文、日文、韓文等Unicode字元

Leave a comment Github, html, java, javascript, teedy

好用的輕量級文件管理系統 Teedy

2025-01-10 william 軟體介紹

Teedy是一款很棒的輕量級文件管理軟體，以文件為本體，文件包含檔案，而文件具有唯一性。文件跟檔案不同，文件可綁定多標籤，能同時出現在不同標籤結構。

使用標籤概念，可避免傳統檔案總管，相同的檔案若存在不同目錄，會造成文件管理員維護困難(太多相同的檔案)。

Teedy 系統可綁定網域主控(Ldap)、能權限設定、可檢索，也有文件提交送審功能，功能全面。

除了上述功能，該系統具備審計軌跡Audit Log，符合ISO文管系統的基本要求，要過ISO13485、ISO62304沒難度。

Teedy系統採用微軟GitHub管轄下的開源軟體，GPL授權不用錢；軟體確效因屬於套裝軟體(off the shell)，只需做3Q即可，且其風險超低，因其開源特性，全世界的工程師都可親自檢驗，更令人放心，例如1.7版就被掃瞄可能有風險。

此開源系統缺點是翻譯超爛，我花了很多時間協助翻譯以。我增加新功能如下：
1. 檔案可決定加密或不加密
2. 檔案名稱可設定不能重複
3. 檔案軟刪除(Soft Delete)
4. 讀取(下載)檔案也會被系統紀錄
5. 檔案可移動到不同的文件
6. 好的中文翻譯
7. 一些小bug修正

本站增加新功能的docker版本請到這裡下載體驗，安裝方式請參考這裡，程式原始碼移駕這裡。
** 主開發團隊4個月(2024.9)前有commit新的1.12版，這系統維護快10年了，步調較慢，我新增的功能離該系統初衷甚遠(如檔案可不加密)，因此就不敢提交給開發團隊了，除非該團隊有注意到我這個版本(但應該不可能拉，團隊不會花時間研究我這版本) XD

最後

OpenProject用來規劃以及進度追蹤，產生的文件可以提交到Teedy進行管控，補足OpenProject文件管理的不足.

Leave a comment database, docker, Github, podman, postgres, teedy

1 2 3 ... 77 »

分享此文：

實作總結(推薦使用tolgee)

分享此文：

分享此文：

分享此文：

分享此文：

分享此文：

分享此文：

分享此文：

分享此文：

分享此文：