spring rest docs

    [Spring REST Docs] 빌드 시 HTML 이 생성되지 않을 때

    개요 프로젝트에서 Spring REST Docs 를 이용하여 API 문서를 만들었다. 빌드 시 adoc 파일을 바탕으로 HTML 파일을 생성하고 싶어 Spring REST Docs 공식 문서 (2.0.7.RELEASE 사용) 를 참고하였는데, 빌드를 하여도 HTML 파일이 생성되지 않는 문제가 발생했다. 결론부터 말하자면 adoc 파일을 바탕으로 빌드 시 생성되는 HTML 파일의 위치가 가 공식 문서에 나온 것과는 다른 것이 원인이었다. 원인 위의 공식 문서를 보면 src/docs/asciidoc 하위에 adoc 파일을 두었을 때, 그래들로 빌드 시 build/asciidoc/html5 하위에 html 이 생성된다. 이를 바탕으로 HTML 문서를 jar 에 패키징하려면 위와 같이 build.gradle ..