sitepoint의 rtdsphinx-php : 다중 언어 PHP 문서를위한 간소화 된 스핑크스 골격
이 게시물은 다중 언어 PHP 문서를 작성하고 배포하도록 설계된 readthedocs 호환 Sphinx 골격 인 rtdsphinx-php를 소개합니다. 사전 구성된 지시문, 현명한 불이행 및 API 및 산문 문서에 대한 최적화 된 스타일로 프로세스를 단순화합니다.
주요 기능 :
단순화 된 현지화 :
rtdsphinx-php는 지역 개발 및 readthedocs 배포를위한 즉시 사용 가능한 현지화 설정을 제공합니다. 언어 파일이 자동으로 생성되어 번역 프로세스를 간소화합니다
유용한 유틸리티 스크립트 :
포함 스크립트 포함 스크립트는 자리 표시 자 값을 바꾸고, 변경 후 파일 업데이트 및 번역에서 HTML을 구축하는 것과 같은 작업을 자동화합니다. PHPDomain은 원활한 PHP 프로젝트 통합을 위해 사전 설치됩니다
강화 된 ReadThedocs 통합 : Custom CSS는 ReadTheDocs 테마와 최적의 시각적 통합을 보장하여 목차에서 API 메소드 링크의 모양을 향상시킵니다.
ReadTheCs 배포 :
스켈레톤은 각 언어 버전을 별도의 프로젝트로 취급하여 ReadThedocs의 다중 언어 출판 요구 사항을 지원합니다.
- 시작하기 :
전제 조건 : - 파이썬과 PIP가 설치되어 있는지 확인하십시오
저장소를 복제하십시오 : rtdsphinx-php 리포지토리를 복제하십시오 :
가상 환경 생성 (선택 사항) : - 프로젝트 종속성 관리에 권장됩니다.
의존성 설치 : 필수 패키지 설치 :
언어 파일 생성 :
새 언어에 대한 파일 생성 (예 : 일본어의 "JP") :
번역 : 파일을 디렉토리에서 편집하십시오
빌드 html : - 번역을 위해 html을 컴파일하십시오 : (일본어와 영어의 경우).
READTHEDOCS에 배포 : 각 언어에 대해 별도의 ReadTheDocs 프로젝트를 작성한 다음 주 프로젝트 설정에서 번역으로 연결합니다.
고급 기능 :
현지화 : 폴더에는 자동으로 생성 된 파일 (변환) 및 파일 (머신 읽기 가능)이 포함됩니다. 파일은
(원본 텍스트) 및
(번역 된 텍스트)를 사용합니다. GetText 및 Sphinx Handle String Extraction은 자동으로
-
유틸리티 스크립트 :
: 자리 표시 자 값 (프로젝트 이름, 저자, 슬러그)을 대체합니다
: 파일을 업데이트하고 새 파일을 생성합니다
: 파일을 컴파일하고 html을 빌드합니다
-
configure.sh
PHPDOMAIN 및 SYNTAX HIMPERTINGITING : rtdSphInx-PHP는 PHP 프로젝트에 최적화되어 있으며 기본 PHP 구문 하이라스 및 명확한 API 문서를 위해 사전 설치된 PHPDomain.
-
update.sh
.pot
.po
Custom CSS : -
build.sh
.po
READTHEDOCS 배포 : 각 언어 버전은 별도의 ReadTheCs 프로젝트가 필요하며, 주요 프로젝트 설정에서 번역으로 연결되어 있습니다.
-
결론 :
rtdsphinx-php는 PHP 프로젝트를위한 다중 언어 문서의 생성 및 배포를 단순화합니다. 오픈 소스 본성은 지역 사회의 기여를 장려하고 더 많은 청중에게 다가가는 데 도움이됩니다. 아래의 FAQ는 스핑크스를 통한 다국어 문서에 관한 일반적인 질문을 다룹니다.
자주 묻는 질문 (faqs) :
(원래 입력의 FAQS 섹션은 일반적인 문제를 직접 다루고 귀중한 정보를 제공하므로 여기에서 유지됩니다.)
스핑크스에서 번역을 어떻게 관리 할 수 있습니까?
... (원래 FAQ 컨텐츠) ...
스핑크스의 다른 언어로 된 다중 수정 문서의 모범 사례는 무엇입니까?
... (원래 FAQ 컨텐츠) ...
스핑크스를 국제화 할 수있는 방법?
... (원래 FAQ 컨텐츠) ...
스핑크스 문서와 관련된 문제를 어떻게 해결할 수 있습니까?
... (원래 FAQ 컨텐츠) ...
... (원래 FAQ 컨텐츠) ...
스핑크스에서 추가 언어에 대한 지원을 추가하려면 어떻게해야합니까?
... (원래 FAQ 컨텐츠) ...
스핑크스에서 변환 파일을 업데이트하려면?
... (원래 FAQ 컨텐츠) ...
스핑크스에서 번역 된 문서를 어떻게 만들 수 있습니까?
... (원래 FAQ 컨텐츠) ...
스핑크스에서 내 컨텐츠를 어떻게 번역 할 수 있습니까? -
... (원래 FAQ 컨텐츠) ...
국제화를 위해 Sphinx를 어떻게 구성 할 수 있습니까?
... (원래 FAQ 컨텐츠) ...
위 내용은 SitePoint ' s rtdsphinx-php가있는 빠른 다중 언어 문서의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!