⚙ Spring Rest Docs 설정

1. asciidoctor plugin 추가

**plugins {
	id 'java'
	id 'org.springframework.boot' version '2.7.8'
	id 'io.spring.dependency-management' version '1.0.15.RELEASE'
	id 'org.asciidoctor.jvm.convert' version '1.5.8'
}**

**org.asciidoctor.jvm.convert**를 사용한다.

2. snippets Dir 설정

**ext {
	set('snippetsDir', file("build/generated-snippets"))
}**

테스트 코드를 통과하고 생성된 API 문서(.adoc)를 저장하는 경로를 지정한다.

3. boot jar 설정

**bootJar {
	dependsOn asciidoctor
	from ("${asciidoctor.outputDir}/html5") {
		into 'static/docs'
	}
}**

jar 파일을 만들 때 **asciidoctor.outputDir**에 있는 html 파일을 static/docs 폴더로 이동시킨다.

4. asciidoctor 설정

**asciidoctor { 
	dependsOn test 
	inputs.dir snippetsDir 
}**

• dependsOn test 부분은 **asciidoctor**이 test 시에만 실행되게 한다.
• **inputs.dir**은 **asciidoctor**가 사용할 input 파일들의 위치가 **snippetsDir**에 존재한다는 것을 말한다.

5. task 설정

**task copyDocument(type: Copy) {
	dependsOn asciidoctor
	from file("build/docs/asciidoc")
	into file("src/main/resources/static/docs")
}**