如何自定义生成的 API 文档样式和布局？

自定义生成API文档的样式和布局通常依赖于你所使用的API文档生成工具。不同的工具如Swagger、RAML、Apiary等都提供了自己的配置方式。以下是使用Swagger进行自定义的一般步骤：

1. 配置Swagger：在你的项目中集成Swagger，通常需要引入相应的依赖库，并配置Swagger的Bean。比如，在Spring Boot项目中，你可以使用`@EnableSwagger2`注解来启用Swagger。

2. 自定义API信息：可以通过`@ApiOperation`注解来自定义每个API接口的描述、标签、响应等信息。通过`@ApiModel`和`@ApiModelProperty`注解可以定义模型的描述和属性信息。

3. 修改文档模板：Swagger允许你通过模板引擎来自定义HTML模板。例如，使用Freemarker模板来修改默认的HTML输出。

4. 调整样式：可以通过CSS来调整文档的布局和样式。你可以自定义一个样式表并通过Swagger配置将其引入。

5. 使用Swagger UI插件：Swagger UI提供了很多插件供选择，通过配置插件可以实现更加个性化的展示效果。

示例代码片段（Spring Boot中配置Swagger）：

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {
        return new ApiInfo(
                "My REST API",
                "Some custom description of API.",
                "API TOS",
                "Terms of service",
                new Contact("John Doe", "www.example.com", "myeaddress@company.com"),
                "License of API", "API license URL", Collections.emptyList());
    }
}