關於ShipLang 框架
首個為AI設計的多語言技術堆疊,讓開發者專注於產品本身
框架簡介與理想
ShipLang 是首個由產品經理開發的技術堆疊,誕生於對傳統開發流程的反思。在AI時代,我們需要的不是更複雜的工具,而是能讓人專注於產品創意的簡單解決方案。
這個框架的核心理想是:讓全球化不再是產品的負擔。當你用中文寫完代碼後,世界各地的用戶都能用自己的母語訪問你的網站。多語言應該是自動的、智慧的,而不是需要人工維護數十個翻譯文件。
ShipLang 完全免費且開源,這不僅是技術分享,更是在AI時代尋找人類主體性的嘗試。科技應該服務於創造,而不是成為創造的障礙。
我們的系統定位為非程式設計師用戶，且相容於用戶和Ai的使用習慣，如下圖所示：
相容Ai而不是讓Ai相容我們（點擊看大圖）
相容Ai而不是讓Ai相容我們（點擊看大圖）
關於作者
技術原理
多語言智慧翻譯機制
多語言要實現的是,你在代碼後台寫上中文之後,用戶看到的是其他語言。
原理是,用戶首次訪問時,系統檢測當前用戶的語言設定——如果不存在該語言翻譯文件,就調用翻譯API,翻譯之後在頁面顯示翻譯後的結果,並將結果緩存到伺服器,方便之後調用;如果已經存在對應語言的翻譯文件,就直接加載,自動顯示該頁面語言。
工作流程
1. 使用者造訪頁面時,系統自動偵測瀏覽器語言偏好
2. 檢查伺服器是否已有該語言的翻譯快取文件
3. 如果快取存在,直接載入並渲染;如果不存在,呼叫AI翻譯API
4. 翻譯完成後,儲存到伺服器快取,下次存取直接使用
5. 整個過程對使用者透明,無需等待,體驗流暢
使用簡介
基礎使用方式
如果有需要翻譯為多語言的內容,在對應的PHP檔案中,把該內容加入data-i18n標籤。
例如:你要在langany.com/docs/lang-i18n網頁中,把中文的"歡迎使用"翻譯成多種語言,你要在對應PHP文件中加入:
<p data-i18n="welcome">欢迎使用</p>則當使用者使用的是英文介面時,langany.com/docs/lang-i18n對應位置會顯示"Welcome"
標籤復用機制
在增加data-i18n標籤多語言時,可以將之前用過的標籤複製過來,僅修改文字即可,不需要重新定義data-i18n標籤。
例如:定義了"你好"的標籤為"k",此時頁面中的"你好",在英文頁面中會自動翻譯為"hello"。如果還想要將"不錯"也進行多語言翻譯,可以直接複製標籤:
<p data-i18n="k">你好</p>
<p data-i18n="k">不错</p>目前市面上所有的系統中,相同標籤會被翻譯為同樣的內容,但是在ShipLang系統中,系統支援複用data-i18n標籤值。當多個元素使用相同標籤但內容不同時,系統會自動把他們轉換為k_你好、k_不錯,確保翻譯準確匹配原文。
保留原文
如果頁面中的某些文字不需要翻譯,需要保持原始的中文狀態,該文字不添加data-i18n標籤即可。
手動修改翻譯
如果對自動翻譯的內容不滿意,可以手動修改翻譯:
1. 在HTML檔案中找到要修改內容的data-i18n 標籤值
2. 在對應語言的JSON檔案中搜尋該標籤
3. 修改翻譯內容並儲存
例如：要修改https://langany.com/refund 中的"1.你好"的英語翻譯,找到標籤section1_title,在lang/en/docs/refund.json 中搜尋並修改即可。
常見問題
為什麼選擇PHP作為後端語言?
PHP部署簡單、成本低廉、生態成熟,非常適合快速上線和迭代。對於獨立開發者和小團隊來說,PHP + 虛擬主機的組合可以讓你在最低成本下服務全球用戶。 ShipLang的目標是降低門檻,而不是追求技術時髦。
翻譯品質如何保證?
ShipLang使用業界領先的AI翻譯API,翻譯品質已達到專業水準。對於關鍵內容,你也可以隨時手動修改翻譯文件。重要的是,一次翻譯,永久快取,不會產生重複的API呼叫費用。
支援哪些語言?
理論上支持全球所有主流語言。系統會根據使用者的瀏覽器語言偏好自動匹配,包括但不限於英語、日語、韓語、法語、德語、西班牙語、阿拉伯語等100+種語言。
首次翻譯需要多久時間?
首次訪問某個新語言時,翻譯通常在1-3秒內完成。之後所有造訪該語言的使用者都會直接載入快取,速度與普通網頁無異。對於使用者量大的網站,建議提前預生成常用語言的翻譯檔。
如何更新翻譯內容?
有兩種方式:一是直接修改對應語言的JSON檔,二是刪除舊的翻譯快取,系統會在下次造訪時重新翻譯。對於內容頻繁更新的頁面,建議採用版本管理機制。
標籤復用機制的優點是什麼?
傳統多語言系統要求每個翻譯內容都有唯一的標籤,這導致標籤命名困難、管理混亂。 ShipLang允許你復用標籤,系統會智慧辨識內容差異。這大大提升了開發效率,你不再需要絞盡腦汁想標籤名稱。
ShipLang適合什麼類型的專案?
特別適合需要快速全球化的專案,如SaaS產品、行銷落地頁、電商網站、內容平台等。如果你希望用最小的成本觸達全球市場,ShipLang是理想選擇。對於大型企業級應用,也可以將ShipLang作為快速原型驗證工具。
為什麼說ShipLang是為AI時代設計的?
在AI時代,翻譯不應該再是人工勞動密集型工作。 ShipLang充分利用AI的能力,讓翻譯變成自動化、智慧化的過程。同時,簡潔的架構也便於未來整合更多AI功能,如智慧內容生成、使用者行為分析等。
開始使用ShipLang
框架完全開源,你可以自由使用、修改和分發。我們相信,在AI時代,科技應該是開放的、易用的、為創造者服務的。
如果你認同這個理念,歡迎加入ShipLang社群,一起探索AI時代的產品開發新典範。