推荐系统在我们的日常生活中无处不在，它们非常有用，既可以节省时间，又可以帮助我们发现与我们的兴趣相关的东西。目前，推荐系统是消费领域最常见的机器学习算法之一[1]。...例如，我在某宝上浏览了几件黑色女式羽绒服，系统根据内容过滤算法直接提取 “黑色”、“羽绒服”、“女式” 等 item 特征，在这个应用场景下，item 具体为 “物品”。...通过对物品进行多次关联性分析，发现我多次在某宝中的点击之间的关联性，从而生成推荐结果，将“女式羽绒服” 推荐到我的某宝首页中。...FL-MV-DSSM 框架 4.1 FL-MV-DSSM 框架分析 DSSM 最初是为 web 搜索而设计的，它通过多层神经网络从用户的查询词和候选文档中提取语义向量，然后利用余弦相似度来度量查询与文档在语义空间中的相关性...在联邦多视图设置中，虽然所有视图都协同训练一个模型，但是视图之间不应该有原始数据交互，因为每个数据集 U_i 中都包含了需要被保护的私有视图特定信息。
你注意到没有一行 XML 吗？没有 web.xml 文件。此 Web 应用程序是 100％ 纯 Java，你无需处理配置任何管道或基础信息。...你可以在测试中向 document() 添加断言来创建其他代码段。...有关更多详细信息，请查看 Spring REST文档的文档。 使用代码片段 要使用生成的代码片段，你希望在项目中有一些 Asciidoctor 的内容，然后在构建时添加代码片段。...请注意，包含的片段的路径 {snippets}表示为占位符 - 是Asciidoctor 中的一个“属性”。...在这种简单的情况下，唯一的标记是在“.”在片段之前（“请求”和“响应”）顶部的“=”，它是一级标题。 然后在构建配置中，你需要将此源文件处理为你选择的文档格式。
问： 假设我有这个脚本： export.bash #!...echo $VAR 有没有一种方法可以通过只执行 export.bash 而不 source 它获取 $VAR？ 答： 不可以。 但是有几种可能的解决办法。...在调用 shell 的上下文中执行脚本: $ cat set-vars1.sh export FOO=BAR $ . set-vars1.sh $ echo $FOO BAR 另一种方法是在脚本中打印设置环境变量的命令.../set-vars2.sh)" $ echo "$FOO" BAR 在终端上执行 help export 可以查看 Bash 内置命令 export 的帮助文档： # help export export...help eval 相关阅读： 用和不用export定义变量的区别 在shell编程中$(cmd) 和 `cmd` 之间有什么区别 ----
Markdown 通过自行扩展语法或者使用 HTML 可以实现这些格式，但前者造成文档不通用的问题，后者则直接把展示结构硬编码到了文档中，将来修改会很麻烦。...处理过程分成解析和生成两步，在解析之后文档转化为 Ruby 对象，可供编程处理。 性能和安全性提升。 通过 JRuby 提供 Java 版本；通过转编译提供 JavaScript 版本。...AsciiDoctor 是一个很宏伟的项目，还有很多子项目在开发中，例如我比较关注的 Asciidoctor PDF 和 Asciidoctor EPUB3，这两个项目用于去掉现有工具链中对 DocBook...这个 gem 还被包含到几个 Linux 发行版中，其中包括 Fedora、Debian 和 Ubuntu。...为了验证它的可用性，你可以在终端中执行如下命令： $ asciidoctor --version 你应该看到关于 Asciidoctor 和 Ruby 环境信息将打印到你的终端上。
categories: Spring Components tags: spring springfox-swagger ---- Springfox Swagger 和Spring的整合已经让我们可以动态的生成接口文档了...，但是接口文档的生成、管理、导出在网上看了很多博客，着实让我走了很多弯路，都不是很满意。...配置插件执行 生成 pdf 和 html 格式的接口文档 由于compile配置，接口分组id不同，调整参数执行mvn compile(或在idea中的maven project...中点击可视化命令也可以) 2次即可。...--由asciidoc生成pdf：该段插件配置平时注释，只在需要生成文档时解开注释，且前文的操作(swagger.json生成、adoc文件生成)务必已执行完-->
详细的语法说明可以看这份文档：[http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/](http://asciidoctor.org/...Markdown 通过自行扩展语法或者使用 HTML 可以实现这些格式，但前者造成文档不通用的问题，后者则直接把展示结构硬编码到了文档中，将来修改会很麻烦。...AsciiDoctor 是一个很宏伟的项目，还有很多子项目在开发中，例如我比较关注的 Asciidoctor PDF 和 Asciidoctor EPUB3，这两个项目用于去掉现有工具链中对 DocBook...工具链层次的减少可以增加定制便利性，也更方便用户安装。 因为有 AsciiDoctor 这样设计精良的实现，我才决定把精力放到 AsciiDoc 上。...如果你在搭建复杂的文档环境，并且认为 Markdown 已经不能满足需求，那么可以试试 AsciiDoc。 (完)
swagger2markup 使用MAVEN插件生成AsciiDoc文档 使用MAVEN插件生成HTML 下节预告 Swagger生成JavaDoc ---- 在日常的工作中，特别是现在前后端分离模式之下...看得出来，我在教大家使用的都是在偷懒哦，这可不是什么好现象。。。 添加依赖 <!...可以看到，我们在yml文件中配置的信息，展示在了页面的顶部，点击用户管理: ?...还是要手写一份文档给他们吗？ 那我们不就一样很痛苦吗！！！ 作为程序员，我们是绝对不能允许这种情况发生的！ 那就让我们继续看下去。...生成离线文档 为了不让我们做痛苦的工作，我们既然已经在代码中添加了那么多的说明信息，是否有一种方式可以帮助我们来生成一份离线的文档呢？答案是肯定的。
将swagger API导出为HTML或者PDF 现在有很多项目都是使用的swagger，将API直接写在swagger文档中，使用起来非常方便，并且支持在线调试。...Asciidoctor用Ruby编写，可在所有主要操作系统上运行。 Asciidoctor提供了一个asciidoctor-maven-plugin，可以方便的在maven环境使用。...这意味着你可以写你的文档中的任何语言，使用UTF-8编码的文件，并期望Asciidoctor到文本正确转换。但是，您可能会注意到PDF中缺少某些语言的某些字符，例如中文。...例如，以从写在CJK语言文档的PDF如中国，你需要使用一个CJK主题。您可以通过安装asciidoctor-pdf-cjk-kai_gen_gothic gem获得这样的主题。...PDF中文主题在maven中的使用 那么有了命令行，我们怎么在maven中使用呢？
但是，构建的文档必须通过在项目中整合swagger-ui、或使用单独部署的swagger-ui和/v2/api-docs返回的配置信息才能展现出您所构建的API文档。...，可以是这样的URL形式，也可以是符合Swagger规范的String类型或者从文件中读取的流。...在执行了上面的测试用例之后，我们就能在当前项目的目录下获得如下内容： ? image.png 可以看到，这种方式在运行之后就生成出了5个不同的静态文件。...对于上面的生成方式，完全可以通过在pom.xml中增加如下插件来完成静态内容的生成。...在完成生成之后，可以直接通过浏览器来看查看，你就能看到类似下图的静态部署结果： ?
在项目应用中，我们会写很多文档去传递我们的设计思想、开发经验、采坑经历等等。使用Asciidoc的格式对非技术人员就不是那么的友好，或者说传递性、通用性与PDF和网页相比就差很多了。...在JVM项目中可以使用Maven的插件方式将.adoc文件格式转化为PDF、HTML、EPUB等文件格式。...Http Server或者Nginx等服务进行部署，甚至可以使用Jenkins进行自动化部署。...PDF的生成格式进行自定义，有时候为了方便，可以将其与asciidoctorj-pdf源码进行合并，手动打一个依赖包，放到自己的私服仓库中。...参考资料 Example Asciidoctor插件中文文档 Asciidoctor-PDF 中文乱码问题解决方案
大家好，又见面了，我是全栈君。...需要使用asciidoctor-maven-plugin插件，在其pom文件加上： org.asciidoctor 这时只需要通过mvnw package命令就可以生成文档了...在/target/generated-docs下有个index.html，打开这个html,显示如下，界面还算简洁： 结语 通过单元测试，生存adoc文件，再用adoc文件生存html，只需要简单的几步就可以生成一个...api文档的html文件，这个html文件你可以通网站发布出去。
在不同的文章里，我不断尝试，一点点修改样式表，使其至少符合我的审美。...在未来的版本中，gitbook有可能会加入asciidoc的支持。 相对于大家都很了解的markdown，知道asciidoc的人不多。...想了解asciidoc的语法，可以google asciidoctor syntax。...由于每篇文章末尾我都要加一段共同的内容，所以： @$(CAT) $ $(OUT)/tmp.adoc 用于生成一个临时的，包含 $(SUFFIX) 的文档，然后再用 cssliner...如果大家觉得这工具有用，也许我可以将其做成一个python命令行工具包，一条命令完成所有工作。 1. restructured text 2. 一个基于python的文档生成工具 3.
生成ASCIIDOC 在pom.xml中添加如下内容： io.github.swagger2markup<...当然你也可以生成其他格式，比如Markdown等等。...中添加如下内容： org.asciidoctor ...插件同样也有很多姿势，详见：https://github.com/asciidoctor/asciidoctor-maven-plugin[3] 生成的文件在 src/docs/asciidoc/html...（看你插件上面的配置哈），然后你就可以弄个NGINX部署了。
但是，如前文方式构建的文档必须通过在项目中整合 swagger-ui、或使用单独部署的 swagger-ui和 /v2/api-docs返回的配置信息才能展现出您所构建的API文档。...，可以是这样的URL形式，也可以是符合Swagger规范的String类型或者从文件中读取的流。.../asciidoc/generated/all"))，将转换结果输出到一个单一的文件中，这样可以最终生成html的也是单一的。...对于上面的生成方式，完全可以通过在 pom.xml中增加如下插件来完成静态内容的生成。...在完成生成之后，可以直接通过浏览器来看查看，你就能看到类似下图的静态部署结果： ? 是不是感觉似曾相识呢？是的，Spring Cloud的E版之前的文档也是这样的！！！
在apiInfo方法中配置接口文档的title(标题)、描述、termsOfServiceUrl（服务协议）、版本等相关信息 在createRestApi方法中，basePackage表示扫描哪个...当然，如果你的团队没有“约定“，那么就需要“配置”来做文档说明。我通常把这个过程叫做“为接口功能添加注释”。...对于上面的生成方式，完全可以通过在pom.xml中增加如下插件来完成静态内容的生成。...常常用于 Spring 中帮助开发者生成文档，并可以轻松的在spring boot中使用。截至2020年4月，尚未支持 OpenAPI3 标准。...也是用来在 Spring 中帮助开发者生成文档，并可以轻松的在spring boot中使用 ---- 整合springdoc-openapi 在pom.xml里面去掉springfox，添加如下的openapi
属性如下： value 用于方法描述 notes 用于提示内容 tags 用于API文档控制的标记列表，视情况而用，可以进行独立分组 3....@ApiImplicitParams 用于方法，包含多个 @ApiImplicitParam。 9.@ApiResponses @ApiResponse 用于类或者方法，描述操作的可能响应。...name 响应头名称 description 头描述 response 默认响应类 void responseContainer 参考ApiOperation中配置 Swagger 导出离线 api 文档...-- 菜单栏在左边 --> left <!...html 和 pdf，通过 mvn asciidoctor:process-asciidoc 可以导出相应格式文件 .
在2018年6月以前一直坚持用Markdown来手写接口文档，即便是那时候有同事给我推荐过，但作为一个骨子里追求极简的程序员，我一直没有想明白一个需要写一大堆注解强侵入到后端代码工具，它为什么会在中国如此风靡...，被很多的java后端应用开发者集成到自己的中。...在2018年春节我自己萌生了自己一个java rest api文档生成的工具，目的也不是去造轮子，因为我天生不喜欢闲的没事到处造轮子，而起国内已经有一些开源的Java Rest Api文档生成工具，这些工具实现机制几乎和...只是可能使用更便捷了一些，针对这些工具我没完全没有去使用的意愿。因此开发这个工具的目标非常明确，就是完全不用任何注解，能够去依赖源代码和注释直接分析出文档。...支持生成多种格式文档：Markdown、HTML5、Asciidoctor。 轻易实现在Spring Boot服务上在线查看静态HTML5 api文档。 开放文档数据，可自由实现接入文档管理系统。
简介 之前的文章我们讲到了gradle的基本使用，使用gradle的最终目的就是为了构建java项目。今天本文将会详细的讲解如何在gradle中构建java项目。...两者在build.gradle中的不同在于plugins的不同，application的plugin是： plugins { id 'application' } 而library的plugin...前面两个属性我们可以在dependencies中找到，后面一个我们可以在repositories中找到，看一个例子： repositories { mavenCentral() } dependencies...library插件有一个javadoc task，可以为java项目生成文档。...欢迎关注我的公众号:「程序那些事」,懂技术，更懂你！
一款零注解侵入的 API 文档生成工具 介绍 smart-doc是一款同时支持JAVA REST API和Apache Dubbo RPC接口文档生成的工具，smart-doc在业内率先提出基于JAVA...泛型定义推导的理念，完全基于接口源码来分析生成接口文档，不采用任何注解侵入到业务代码中。...支持生成多种格式文档：Markdown、HTML5、Asciidoctor、Postman Collection、OpenAPI 3.0。Up- 开放文档数据，可自 由实现接入文档管理系统。...支持导出错误码和定义在代码中的各种字典码到接口文档。 支持Maven、Gradle插件式轻松集成。 支持Apache Dubbo RPC接口文档生成。...当然 smart-doc 本身是只支持扫描代码生成 openapi 3.0 的文档的，也可以将生成的 openapi 3.0 文档导入到其他ui中渲染展示。 ---- 效果示例 1.
1介绍 smart-doc是一款同时支持JAVA REST API和Apache Dubbo RPC接口文档生成的工具，smart-doc在业内率先提出基于JAVA泛型定义推导的理念，完全基于接口源码来分析生成接口文档...，不采用任何注解侵入到业务代码中。...支持生成多种格式文档：Markdown、HTML5、Asciidoctor、Postman Collection、OpenAPI 3.0。Up- 开放文档数据，可自由实现接入文档管理系统。...支持导出错误码和定义在代码中的各种字典码到接口文档。 支持Maven、Gradle插件式轻松集成。 支持Apache Dubbo RPC接口文档生成。...当然 smart-doc 本身是只支持扫描代码生成 openapi 3.0 的文档的，也可以将生成的 openapi 3.0 文档导入到其他ui中渲染展示。
领取专属 10元无门槛券
手把手带您无忧上云
云服务器
即时通信 IM
ICP备案
对象存储
实时音视频
