ShipLang 프레임워크에 대하여

AI를 위해 설계된 최초의 다국어 기술 스택으로, 개발자들이 제품 자체에 집중할 수 있도록 해줍니다.

프레임워크 소개 및 이상

ShipLang은 제품 관리자들이 직접 개발한 최초의 기술 스택으로, 기존 개발 프로세스에 대한 고찰에서 탄생했습니다. AI 시대에 우리에게 필요한 것은 더욱 복잡한 도구가 아니라, 사람들이 제품 아이디어에 집중할 수 있도록 해주는 간편한 솔루션입니다.

이 프레임워크의 핵심 이념은 세계화가 더 이상 제품에 부담이 되지 않도록 하는 것입니다. 중국어로 코드를 작성해 놓으면 전 세계 사용자들이 모국어로 웹사이트에 접속할 수 있습니다. 다국어 지원은 수십 개의 번역 파일을 수동으로 관리하는 것이 아니라 자동화되고 지능적으로 이루어져야 합니다.

ShipLang은 완전 무료 오픈 소스 프로젝트입니다. 이는 단순히 기술을 공유하는 것을 넘어, AI 시대에 인간의 주체성을 탐구하려는 시도이기도 합니다. 기술은 창조를 위한 도구가 되어야 하며, 창조를 방해하는 장애물이 되어서는 안 됩니다.

저희 시스템은 프로그래밍 경험이 없는 사용자를 위해 설계되었으며, 아래 그림과 같이 사용자와 AI의 사용 습관 모두와 호환됩니다.

兼容Ai而不是让Ai兼容我们

AI를 AI에 맞추는 것이 아니라, AI와 호환되도록 만드세요 (이미지를 클릭하면 크게 볼 수 있습니다)

兼容Ai而不是让Ai兼容我们

AI를 AI에 맞추는 것이 아니라, AI와 호환되도록 만드세요 (이미지를 클릭하면 크게 볼 수 있습니다)

저자 소개

ShipLang의 개발자는 전통적인 의미의 프로그래머가 아니라 제품 관리자입니다. 이러한 배경 덕분에 그는 독특한 관점을 갖게 되었습니다. 즉, 극단적인 기술적 복잡성을 추구하기보다는 사용의 극도의 단순성을 추구하는 것입니다.

제품 관리자로서 저는 개발 과정에서 가장 힘든 부분이 기술적인 어려움이 아니라 반복적이고 지루하며 관련성이 떨어지는 작업이라는 것을 너무나 잘 알고 있습니다. 다국어 유지 관리가 바로 그런 예입니다. 제품 리테이어마다 수십 개의 언어 파일을 업데이트해야 하는데, 이는 비효율적일 뿐만 아니라 창의적인 열정을 억누릅니다.

ShipLang은 단순한 믿음에서 탄생했습니다. 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의 해당 위치에 "환영합니다"가 표시됩니다.

태그 재사용 메커니즘

다국어 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. Hello"의 영어 번역을 수정하려면 section1_title 태그를 찾아 lang/en/docs/refund.json 파일에서 검색한 후 수정하면 됩니다.

자주 묻는 질문

PHP를 백엔드 언어로 선택하는 이유는 무엇일까요?

PHP는 배포가 쉽고, 비용이 저렴하며, 성숙한 생태계를 갖추고 있어 빠른 배포와 반복 개발에 이상적입니다. 독립 개발자와 소규모 팀의 경우, PHP와 가상 호스팅을 결합하면 최소한의 비용으로 전 세계 사용자에게 서비스를 제공할 수 있습니다. ShipLang의 목표는 유행하는 기술을 쫓는 것이 아니라, 진입 장벽을 낮추는 것입니다.

번역 품질은 어떻게 보장할 수 있을까요?

ShipLang은 업계 최고 수준의 AI 번역 API를 사용하여 전문가 수준의 번역 품질을 제공합니다. 중요한 콘텐츠의 경우 언제든지 번역된 파일을 수동으로 수정할 수 있습니다. 특히, 한 번 제출 후 번역 결과가 영구적으로 캐시되어 API 호출 중복 요금이 발생하지 않습니다.

어떤 언어들이 지원되나요?

이론적으로는 전 세계 주요 언어를 모두 지원합니다. 시스템은 사용자의 브라우저 언어 설정에 따라 자동으로 언어를 매칭하며, 영어, 일본어, 한국어, 프랑스어, 독일어, 스페인어, 아랍어를 비롯한 100개 이상의 언어를 지원합니다.

첫 번째 번역은 얼마나 걸리나요?

사용자가 새로운 언어에 처음 접속할 때 번역이 적용되는 데는 일반적으로 1~3초가 소요됩니다. 이후 해당 언어에 접속할 때는 캐시에서 바로 로드되므로 일반 웹페이지와 동일한 속도로 표시됩니다. 사용자 수가 많은 웹사이트의 경우, 자주 사용되는 언어에 대한 번역 파일을 미리 생성해 두는 것이 좋습니다.

번역된 콘텐츠를 어떻게 업데이트하나요?

번역 방법에는 두 가지가 있습니다. 하나는 해당 언어로 된 JSON 파일을 직접 수정하는 것이고, 다른 하나는 기존 번역 캐시를 삭제하여 다음 방문 시 시스템이 다시 번역하도록 하는 것입니다. 콘텐츠가 자주 업데이트되는 페이지의 경우 버전 관리 메커니즘을 사용하는 것이 좋습니다.

태그 재사용 메커니즘의 장점은 무엇인가요?

기존의 다국어 번역 시스템은 번역된 콘텐츠마다 고유한 태그를 지정해야 하므로 태그 이름 지정 및 관리에 어려움이 있습니다. ShipLang을 사용하면 태그를 재사용할 수 있으며, 시스템이 콘텐츠 차이점을 지능적으로 식별합니다. 이를 통해 개발 효율성이 크게 향상되며, 더 이상 태그 이름을 정하는 데 골머리를 앓을 필요가 없습니다.

ShipLang은 어떤 유형의 프로젝트에 적합합니까?

ShipLang은 SaaS 제품, 마케팅 랜딩 페이지, 전자상거래 웹사이트, 콘텐츠 플랫폼 등 빠른 세계화가 필요한 프로젝트에 특히 적합합니다. 최소한의 비용으로 글로벌 시장에 진출하고 싶다면 ShipLang이 최적의 선택입니다. 대규모 엔터프라이즈 애플리케이션의 경우, ShipLang은 신속한 프로토타이핑 도구로도 활용될 수 있습니다.

ShipLang이 인공지능 시대를 위해 설계되었다고 하는 이유는 무엇일까요?

AI 시대에 번역은 더 이상 노동 집약적인 작업이 되어서는 안 됩니다. ShipLang은 AI의 역량을 최대한 활용하여 번역을 자동화하고 지능적으로 혁신합니다. 또한, 간소화된 아키텍처 덕분에 향후 지능형 콘텐츠 생성 및 사용자 행동 분석과 같은 더 많은 AI 기능을 통합할 수 있습니다.

ShipLang 시작하기

이 프레임워크는 완전한 오픈 소스이므로 자유롭게 사용, 수정 및 배포할 수 있습니다. 우리는 AI 시대에 기술은 개방적이고 사용하기 쉬워야 하며 창작자에게 도움이 되어야 한다고 믿습니다.

이러한 개념에 동의하신다면, ShipLang 커뮤니티에 참여하여 AI 시대의 새로운 제품 개발 패러다임을 함께 탐구해 보세요.