봄 레스트 문서가 HTML을 생성하지 않음

Question

봄 휴식 문서 용 getting started guide을 한 단어 씩 따라 갔지만 생성 된 스 니펫에서 HTML을 가져올 수 없습니다.

스 니펫은 내가 구성한 디렉토리 (빌드/generated-snippets)에서 제대로 생성되지만 스 니펫에서 생성 된 html5/디렉토리는 볼 수 없습니다.

기타 문서 at some point 빌드가 실행될 때 항아리에 문서를 패키지로 수행하고 그것이 HTML5/디렉토리에있는 일부 파일을 기대하는 분명하지만이 만들어지지 않습니다 무엇을 말한다 :

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

내가 뭘 놓치고 있니?

내 프로젝트 파일, build.gradle :

buildscript { 
    repositories { 
     mavenCentral() 
    } 
    dependencies { 
     classpath 'org.springframework.boot:spring-boot-gradle-plugin:1.3.5.RELEASE' 
    } 
} 

plugins { 
    id 'org.asciidoctor.convert' version '1.5.2' 
} 

apply plugin: 'java' 
apply plugin: 'eclipse' 
apply plugin: 'spring-boot' 
apply plugin: 'jacoco' 
apply plugin: 'war' 

sourceCompatibility = 1.8 
targetCompatibility = 1.8 

ext { 
    snippetsDir = file('build/generated-snippets') 
} 

repositories { 
    mavenCentral() 
} 

dependencies { 
    compile 'org.springframework.boot:spring-boot-starter-web:1.3.5.RELEASE' 
    compile 'org.springframework.boot:spring-boot-starter-logging:1.3.5.RELEASE' 
    compile 'org.springframework.boot:spring-boot-starter-data-jpa:1.3.5.RELEASE' 
    compile 'org.springframework.boot:spring-boot-starter-data-rest:1.3.5.RELEASE' 
    compile 'org.springframework.cloud:spring-cloud-starter-aws:1.1.0.RELEASE' 
    compile 'org.postgresql:postgresql:9.4.1208' 
    compile 'commons-io:commons-io:2.5' 

    testCompile 'org.springframework.restdocs:spring-restdocs-mockmvc:1.1.0.RELEASE' 
    testCompile 'org.springframework.restdocs:spring-restdocs-core:1.1.0.RELEASE' 
    testCompile 'org.springframework.boot:spring-boot-starter-test:1.3.5.RELEASE' 
} 

jacoco { 
    toolVersion = "0.7.6.201602180812" 
    reportsDir = file("$buildDir/customJacocoReportDir") 
} 

test { 
    outputs.dir snippetsDir 
    jacoco { 
     append = false 
     destinationFile = file("$buildDir/jacoco/jacocoTest.exec") 
     classDumpFile = file("$buildDir/jacoco/classpathdumps") 
    } 
} 

asciidoctor { 
    attributes 'snippets': snippetsDir 
    inputs.dir snippetsDir 
    dependsOn test 
} 

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

    baseName = project_name 
    version = version 
    manifest { 
     attributes(
      'Implementation-Title': project_name, 
      'Implementation-Version': version 
     ) 
    } 
} 

task wrapper(type: Wrapper) { 
    gradleVersion = '2.13' 
} 

간단한 테스트 파일 I 테스트에 사용

@RunWith(SpringJUnit4ClassRunner.class) 
@SpringApplicationConfiguration(classes = Application.class) 
@WebAppConfiguration 
public class ApiDocumentation 
{ 
    @Rule 
    public JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation("build/generated-snippets"); 

    @Autowired 
    private WebApplicationContext context; 

    private MockMvc mockMvc; 

    @Before 
    public void setUp() 
    { 
     mockMvc = MockMvcBuilders.webAppContextSetup(context) 
       .apply(documentationConfiguration(restDocumentation)) 
       .build(); 
    } 

    @Test 
    public void testIndex() throws Exception 
    { 
     mockMvc.perform(get("/").accept(MediaType.APPLICATION_JSON)) 
       .andExpect(status().isOk()) 
       .andDo(document("index")); 
    } 

} 

Answer 1

이 API를-guide.adoc처럼 (AN .adoc 파일을 만듭니다)을 (Maven) 또는 src/docs/asciidoc (Gradle) 아래에 생성 된 스 니펫을 참조하십시오. 그러면 html이 지정된 디렉토리에 생성됩니다.