모듈 문서화
모듈 전체와 해당 모듈 내의 패키지에 대한 문서는 별도의 마크다운 파일로 제공할 수 있습니다.
파일 형식
마크다운 파일 내에서 모듈 전체 및 개별 패키지에 대한 문서는 해당 1단계 헤딩으로 시작됩니다. 헤딩 텍스트는 모듈의 경우 **Module <module name>
**이어야 하며, 패키지의 경우 **Package <package qualified name>
**여야 합니다.
파일에 모듈 및 패키지 문서가 모두 포함될 필요는 없습니다. 패키지 또는 모듈 문서만 포함하는 파일을 가질 수 있습니다. 심지어 모듈 또는 패키지별로 마크다운 파일을 가질 수도 있습니다.
마크다운 문법을 사용하여 다음을 추가할 수 있습니다:
- 최대 6단계까지의 헤딩
- 굵게 또는 이탤릭체 서식으로 강조
- 링크
- 인라인 코드
- 코드 블록
- 인용 블록
다음은 모듈 및 패키지 문서를 모두 포함하는 예시 파일입니다:
text
# Module kotlin-demo
This content appears under your module name.
# Package org.jetbrains.kotlin.demo
This content appears under your package name in the packages list.
It also appears under the first-level heading on your package's page.
## Level 2 heading for package org.jetbrains.kotlin.demo
Content after this heading is also part of documentation for `org.jetbrains.kotlin.demo`
# Package org.jetbrains.kotlin.demo2
This content appears under your package name in the packages list.
It also appears under the first-level heading on your package's page.
## Level 2 heading for package org.jetbrains.kotlin.demo2
Content after this heading is also part of documentation for `org.jetbrains.kotlin.demo2`
Gradle을 사용한 예시 프로젝트를 살펴보려면 Dokka Gradle 예시를 참조하세요.
Dokka에 파일 전달
이 파일들을 Dokka에 전달하려면 Gradle, Maven 또는 CLI에 해당하는 includes 옵션을 사용해야 합니다: