关于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时代的产品开发新范式。