동기

현재 Elasticsearch 문서는 일본어 번역 버전이 v5.4인 것 뿐입니다. 최신 릴리스는 v7.5.
v5.4 참조
Elastic 문서
거기서, 사내의 성과 발표 재료의 의미도 겸해, 최신판의 번역에 공헌하려고 생각한 것이 본 기사의 동기입니다.
Elasticsearch 문서는 Asciidoc으로 작성되었으며 아래에 빌드 도구도 공개되어 있으므로
이번에는 그것을 사용한 빌드를 사용해 보았습니다.
htps : // 기주 b. 코 m / 에 s 치 c / 두 cs

절차

1. 문서 빌드 도구 소스 복제

git clone https://github.com/elastic/docs.git

2. 빌드 & 실행

cd docs/
./build_docs --doc README.asciidoc --open

※docker를 인스톨 하고 있을 필요가 있습니다.

빌드가 끝나면 브라우저가 시작되고 다음과 유사한 페이지가 열립니다.
--doc 에 빌드 대상을 지정, 또, --open 옵션을 지정하는 것으로 빌드 후에 자동적으로 브라우저를 기동해, 페이지를 표시합니다.

3. Elasticsearch 소스 복제

위에서 빌드한 것은 본 빌드 툴의 튜토리얼용 페이지라고 하는 느낌으로, Elasticsearch 및 그 외 Elastic 제품의 문서와는 다릅니다.
다음은 Elasticsearch 문서를 빌드해 보겠습니다.
문서 전체의 빌드 등 나중을 위해서, 문서 빌드 툴의 디렉토리(docs)와 같은 장소에 클론하는 것이 좋을 것 같습니다.

git clone https://github.com/elastic/elasticsearch.git

4. 빌드

이번에는 일단 단일 페이지를 빌드해 보겠습니다.

 ./build_docs --doc ../elasticsearch/docs/reference/getting-started.asciidoc --lenient --open

--lenient 옵션을 지정하면 다른 파일과의 종속성 등으로 인한 오류를 무시하고 실행할 수 있습니다.

다음과 같은 페이지가 생성되었습니다.

5. 번역

이번의 주목적인 번역을 해 보았습니다.
번역 후의 파일(이번은 getting-started.asciidoc)을 바꿔서 같은 빌드 커멘드를 실행.

 ./build_docs --doc ../elasticsearch/docs/reference/getting-started.asciidoc --lenient --open

번역 후 페이지를 만들 수 있었습니다.

결론

사실, Elasticsearch에 상기 번역의 풀릭을 던졌습니다만, 훌륭하게 연주되었습니다. 아래 참조.
htps : // 기주 b. 코 m / 에 s 치 c / 에 에 s 치 c 세아 rch / 푸 l / 49958
슬프게도, 현재 문서 번역의 커밋은 받아들이지 않는 모습. .
그렇지만, 공부도 겸해 좀 더 번역은 계속해 나가려고 생각하고 있습니다.

Advent Calender의 예정일을 지나 투고하고 있음에도 불구하고 얇은 내용이 되어 버렸습니다.
이번은 페이지 단체의 빌드를 시도했지만, 향후 레퍼런스 전체의 빌드도 시험할 생각입니다.

이상.