사용 가능하고 지원되는 Antora 컴포넌트
이 페이지에서는 사용자 정의 사이트 생성기 파이프라인으로 조립할 수 있는 Antora 컴포넌트 목록을 확인할 수 있습니다. Antora는 모듈식 아키텍처를 가지고 있어 컴포넌트를 쉽게 제거하고 교체할 수 있습니다. API 덕분에 Asciidoctor 확장도 통합할 수 있습니다.
핵심 컴포넌트
핵심 컴포넌트는 Site Generator Default 컴포넌트에 의해 파이프라인으로 조립됩니다. 핵심 컴포넌트들은 함께 버전 관리됩니다.
현재는 동일한 버전의 핵심 컴포넌트만이 함께 작동하도록 설계되어 있습니다. 예를 들어, 사용자 정의 사이트 생성기에서 Content Classifier와 Page Composer를 사용하려면 각 컴포넌트의 버전이 동일한지 확인해야 합니다.
CLI(@antora/cli)를 사이트 생성기(@antora/site-generator)와 함께 사용하는 경우, CLI와 사이트 생성기의 버전만 동기화하면 됩니다.
사용자 정의 사이트 생성기를 만드는 경우, 사용하는 각 개별 컴포넌트의 동기화를 유지해야 합니다.
확장 컴포넌트
확장 컴포넌트는 특별한 사용 사례에 대한 핵심 기능을 제공합니다. 확장 컴포넌트의 예로는 Amazon S3 버킷용 파일 게시자 제공자가 있습니다. 일반적으로 사용 가능한 상태가 되면, 확장 컴포넌트는 개별적으로 릴리스되고 버전 관리됩니다.
지원되는 핵심 및 확장 컴포넌트 매트릭스
| 이름 / 패키지 | 설명 | 핵심 | 확장 | 라이선스 |
|---|---|---|---|---|
AsciiDoc Loader |
Antora에서 AsciiDoc 콘텐츠를 처리하기 위한 재사용 가능한 라이브러리입니다. AsciiDoc 콘텐츠를 AsciiDoc Document 객체(AST)로 로드합니다. |
✅ |
||
CLI |
Antora용 명령줄 인터페이스(CLI)입니다. |
✅ |
||
Content Aggregator |
여러 로컬 및 원격 git 저장소에 분산된 콘텐츠를 가져와 집계합니다. |
✅ |
||
Content Classifier |
집계된 콘텐츠를 가상 파일 카탈로그로 구성합니다. |
✅ |
||
Document Converter |
AsciiDoc 문서를 삽입 가능한 HTML로 변환합니다. |
✅ |
||
Logger |
애플리케이션 메시지의 로깅, 형식 지정 및 보고를 위한 인프라를 제공합니다. |
✅ |
||
Navigation Builder |
탐색 파일에서 소스를 가져온 탐색 카탈로그를 구축합니다. 이 탐색 카탈로그는 페이지에 사이트 탐색을 추가하는 데 사용할 수 있습니다. |
✅ |
||
Page Composer |
콘텐츠 카탈로그의 각 페이지 파일의 삽입 가능한 HTML 콘텐츠를 HTML 페이지 레이아웃으로 감쌉니다. 이 단계에서 생성된 사이트의 독립 실행형 HTML 페이지가 생성됩니다. |
✅ |
||
Playbook Builder |
사용자 입력에서 플레이북 객체를 구축하는 구성 컴포넌트입니다. |
✅ |
||
Redirect Producer |
등록된 별칭에서 주어진 페이지로의 리디렉션(HTTP 리디렉션)을 생성합니다. |
✅ |
||
Site Generator |
Antora용 사이트 생성기입니다.
정적 문서 사이트를 생성하고 게시하기 위해 Antora CLI의 @antora/site-generator-default에서 이름이 변경되었습니다. |
✅ |
||
Site Mapper |
사이트의 사이트맵 파일을 생성합니다. 이 파일들은 크롤러가 읽도록 의도된 것으로, URL로 모든 게시된 페이지의 목록을 제공합니다. |
✅ |
||
File Publisher |
가상 파일 카탈로그의 게시 가능한 파일을 플레이북에 지정된 대상에 게시(즉, 작성)합니다. @antora/site-publisher에서 이름이 변경되었습니다. |
✅ |
||
UI Loader |
UI 번들을 다운로드하고 캐시한 다음, 해당 번들에서 파일을 추출하여 UI 카탈로그로 로드합니다. UI 파일은 Antora 문서 파이프라인의 끝에서 콘텐츠 파일과 결합되어 완전한 사이트를 생성합니다. |
✅ |
||
Lunr Extension |
Lunr와 통합하여 Antora 문서 사이트에 Lunr 기반의 오프라인 전체 텍스트 검색을 추가하는 Antora 확장입니다. |
✅ |