当前位置： 首页 > wzjs >正文

网上怎么做网站深圳vi设计公司哪家专业

wzjs 2025/9/5 17:48:24
网上怎么做网站,深圳vi设计公司哪家专业,开发公司注册资金要求,美食网页设计免费模板Swagger2Markup简介 Swagger2Markup是Github上的一个开源项目。该项目主要用来将Swagger自动生成的文档转换成几种流行的格式以便于静态部署和使用，比如：AsciiDoc、Markdown、Confluence。 项目主页：https://github.com/Swagger2Markup/swagg…

Swagger2Markup简介

Swagger2Markup是Github上的一个开源项目。该项目主要用来将Swagger自动生成的文档转换成几种流行的格式以便于静态部署和使用，比如：AsciiDoc、Markdown、Confluence。
项目主页：https://github.com/Swagger2Markup/swagger2markup

版本说明

JDK: 11.0.26
Spring Boot: 2.4.11
Swagger: 2.9.2
Apache Maven: 3.8.8

下载配置Apache Maven

下载Apache Maven 3.8.8

https://gitee.com/yangsunior/csdn-resources

更新配置文件settings.xml

<?xml version="1.0" encoding="UTF-8"?><settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd"><localRepository>C:\Users\tester\.m2\repository</localRepository><mirrors><!-- mirror| Specifies a repository mirror site to use instead of a given repository. The repository that| this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used| for inheritance and direct lookup purposes, and must be unique across the set of mirrors.|<mirror><id>mirrorId</id><mirrorOf>repositoryId</mirrorOf><name>Human Readable Name for this Mirror.</name><url>http://my.repository.com/repo/path</url></mirror>--><mirror><id>aliyunmaven</id><mirrorOf>*</mirrorOf><name>阿里云公共仓库</name><url>https://maven.aliyun.com/repository/public</url></mirror><mirror><id>nexus-aliyun</id><mirrorOf>central</mirrorOf><name>Nexus aliyun</name><url>http://maven.aliyun.com/nexus/content/groups/public</url></mirror><mirror><id>nexus</id><name>internal nexus repository</name><url>http://repo.maven.apache.org/maven2</url><mirrorOf>central</mirrorOf></mirror></mirrors></settings>

设置依赖下载目录: C:\Users\tester.m2\repository
添加镜像仓库地址: 3个URL镜像地址

环境变量配置maven(可选)

Idea配置Maven

idea 配置 maven

pom.xml 引入依赖

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.4.11</version><relativePath/> <!-- lookup parent from repository --></parent><properties><swagger.version>2.9.2</swagger.version></properties><dependencies><dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger2</artifactId><version>${swagger.version}</version></dependency><dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger-ui</artifactId><version>${swagger.version}</version></dependency></dependencies><build><finalName>web-test-backend</finalName><plugins><plugin><groupId>io.github.swagger2markup</groupId><artifactId>swagger2markup-maven-plugin</artifactId><version>${swagger2markup.version}</version><configuration><swaggerInput>http://localhost:8081/v2/api-docs?group=dev-team</swaggerInput><outputDir>src/docs/asciidoc/generated</outputDir><config><!-- 生成asciidoc格式 --><swagger2markup.markupLanguage>ASCIIDOC</swagger2markup.markupLanguage><!-- 生成markdown格式 --><!--<swagger2markup.markupLanguage>MARKDOWN</swagger2markup.markupLanguage>--><swagger2markup.outputLanguage>ZH</swagger2markup.outputLanguage><swagger2markup.generatedExamplesEnabled>true</swagger2markup.generatedExamplesEnabled><swagger2markup.inlineSchemaEnabled>false</swagger2markup.inlineSchemaEnabled><swagger2markup.pathsGroupedBy>TAGS</swagger2markup.pathsGroupedBy></config></configuration></plugin><plugin><groupId>org.asciidoctor</groupId><artifactId>asciidoctor-maven-plugin</artifactId><version>2.2.6</version><dependencies><dependency><groupId>org.asciidoctor</groupId><artifactId>asciidoctorj-pdf</artifactId><version>2.3.19</version></dependency><dependency><groupId>org.jruby</groupId><artifactId>jruby-complete</artifactId><version>9.4.5.0</version></dependency><dependency><groupId>org.asciidoctor</groupId><artifactId>asciidoctorj</artifactId><version>2.5.13</version></dependency></dependencies><configuration><sourceDirectory>src/docs/asciidoc/generated</sourceDirectory><attributes><toc>left</toc></attributes></configuration><executions><execution><id>output-html</id><phase>generate-resources</phase><goals><goal>process-asciidoc</goal></goals><configuration><backend>html5</backend><outputDirectory>src/docs/asciidoc/html</outputDirectory></configuration></execution><execution><id>generate-pdf-doc</id><phase>generate-resources</phase><goals><goal>process-asciidoc</goal></goals><configuration><backend>pdf</backend><outputDirectory>src/docs/asciidoc/pdf</outputDirectory><attributes><!--导航栏在左--><toc>left</toc><!--显示层级数--><toclevels>3</toclevels><numbered></numbered><hardbreaks></hardbreaks><sectlinks></sectlinks><sectanchors></sectanchors><generated>src/docs/asciidoc</generated><pdf-fontsdir>fonts</pdf-fontsdir><pdf-stylesdir>themes</pdf-stylesdir><pdf-style>cn-theme</pdf-style></attributes></configuration></execution></executions></plugin></plugins></build>
</project>

说明

  • swaggerInput：swagger生成的接口json数据文件。

  • 输出：

    • outputFile：输出到单一文件中
    • outputDir：输出到指定文件中

  • swagger2markup.markupLanguage：输出格式

  • swagger2markup.outputLanguage：语言类型：如中文（ZH），默认英语（EN）

  • swagger2markup.generatedExamplesEnabled：指定是否应该生成HTTP请求和响应示例，默认false

  • swagger2markup.inlineSchemaEnabled：是否启用参数内联

  • swagger2markup.pathsGroupedBy：api排序规则 一般用tags排序

  • executions：多个执行任务配置

  • execution.id：不可重复

    其他：参考单独生成HTML与PDF相关说明

下载依赖

maven 同步

maven sync
Maven -> Sync Project，无法下载上述依赖，需要使用maven下载依赖。

package下载

maven package

下载字体与样式文件

font-theme
资源地址：https://gitee.com/yangsunior/csdn-resources/tree/master/20250519-swagger2markup

生成confluence

管理员模式打开命令行窗口，执行命令

> C:\WindowsApp\apache-maven-3.8.8\bin\mvn swagger2markup:convertSwagger2markup[INFO] Markup document written to: C:\Projects\web-test-backend\src\docs\asciidoc\generated\paths.adoc
[INFO] Markup document written to: C:\Projects\web-test-backend\src\docs\asciidoc\generated\definitions.adoc
[INFO] Markup document written to: C:\Projects\web-test-backend\src\docs\asciidoc\generated\security.adoc
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  3.551 s
[INFO] Finished at: 2025-05-20T16:03:19+08:00
[INFO] ------------------------------------------------------------------------

asciidoc-generated
运行之后就生成出了4个不同的静态文件

生成pdf/html

> C:\WindowsApp\apache-maven-3.8.8\bin\mvn generate-resources[INFO] Converted C:\Projects\web-test\backend\src\docs\asciidoc\generated\paths.adoc
[INFO] Converted C:\Projects\web-test\backend\src\docs\asciidoc\generated\security.adoc
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:35 min
[INFO] Finished at: 2025-05-20T16:24:30+08:00
[INFO] ------------------------------------------------------------------------

asciidoc-generated2
doc-html
doc-pdfpdf目录中的中文显示为乱码，暂时未解决。

多文件合并

修改outputDir为outputFile

<plugin><groupId>io.github.swagger2markup</groupId><artifactId>swagger2markup-maven-plugin</artifactId><version>${swagger2markup.version}</version><configuration><swaggerInput>http://localhost:8081/v2/api-docs?group=dev-team</swaggerInput><outputFile>src/docs/asciidoc/generated/all</outputFile><config><!-- 生成asciidoc格式 --><swagger2markup.markupLanguage>ASCIIDOC</swagger2markup.markupLanguage><!-- 生成markdown格式 --><!--<swagger2markup.markupLanguage>MARKDOWN</swagger2markup.markupLanguage>--><swagger2markup.outputLanguage>ZH</swagger2markup.outputLanguage><swagger2markup.generatedExamplesEnabled>true</swagger2markup.generatedExamplesEnabled><swagger2markup.inlineSchemaEnabled>false</swagger2markup.inlineSchemaEnabled><swagger2markup.pathsGroupedBy>TAGS</swagger2markup.pathsGroupedBy></config></configuration>
</plugin>

doc-all

build 失败

asciidoc-build-fail
JDK从17降低至11即可。


文章转载自：

http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://00000000.jjsxh.cn
http://www.dtcms.com/wzjs/620910.html

相关文章：

  • 寮步营销型网站建设网站内容维护费用
  • 门户网站建设经验总结胶州经济技术开发区 建设局 网站
  • 做暑假工的网站网站运营作用
  • 怎么做一个个人网站手机免费制作网站模板免费下载
  • 深圳网站开发建设服务公司怎么注册网站名称
  • 网站制作案例市场上海助君网络科技有限公司
  • 免费招聘网站平台怎么把网站横幅做很大
  • 网站建设项目特色网站推广排名优化
  • 系统管理在哪里找怎么找seo顾问服务
  • 助孕网站优化推广网站制度建设情况
  • 建设局和住建局郴州网站排名优化
  • 做微商能利用的网站有哪些微网站建设教程视频
  • 请上传网站应用水印图片中国建设人才平台网站
  • 百度推广和网站建设做团购的网站有哪些
  • 建设自有网站需要什么怎样建立微网站
  • 网站服务器一年的费用广告联盟平台自动赚钱
  • 怎么做网站logo网站开发设计中的收获
  • wordpress站点如何加速怎么做加盟网站
  • 微软云怎么做网站网站开发和竞价
  • 英文网站建设模板下载太原市手机网站建设
  • wordpress建站如何微信长沙旅游攻略景点必去长沙美食街
  • 烟台做网站优化哪家好山东网站备案
  • 如何自己做网站腾讯兰州做系统优化的公司
  • 南阳东莞网站建设公司北京优化生育
  • wordpress模板和主题廊坊seo关键字排名
  • 做网站首页ps分辨率多少品牌建设网站
  • 成都网站制作机构做网站 广告费 步骤
  • 怎么知道网站是哪个公司做的wordpress聚合平台模板
  • 襄阳专业做网站网站被搜索引擎收录
  • 本地电脑如何做网站专业零基础网站建设教学在哪里