DocFX生成PDF文档

使用DocFX生成PDF文档,将在线文档转换为PDF离线文档。

关于DocFX的简单介绍使用DocFX生成文档

使用docfx 命令

1.下载

https://github.com/dotnet/docfx/releases

2.使用

创建初始项目

docfx init -q

此命令生成一个名为docfx_project的默认项目。

3.生成网站

docfx docfx_project\docfx.json --serve

现在你可以访问http://localhost:8080查看生成的网站。使用 -p 端口 可以指定端口。

生成PDF文档

安装wkhtmltopdf

下载地址:https://wkhtmltopdf.org/downloads.html

Windows (MSVC) 0.12.4 版本下载地址:

https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.4/wkhtmltox-0.12.4_msvc2015-win64.exe

下载好以后安装,安装完成,添加PATH

例如安装在 C:\Program Files\wkhtmltopdf\,在执行docfx之前设置可执行文件夹路径%PATH%:set PATH=%PATH%;C:\Program Files\wkhtmltopdf\bin。

也可以在环境变量中添加PATH。

添加用于PDF文档的toc.yml

toc.yml

- name: Articles
href: ../articles/toc.yml
- name: Api Documentation
href: ../api/toc.yml
- name: Another Api Documentation
href: ../api-vb/toc.yml

这里的 toc.yml 就相当于聚合了其他文件夹的toc.yml。默认来说每个文件夹的toc.yml 都会生成pdf文档。

在docfx.json 添加pdf部分

  "pdf": {
"content": [
{
"files": [
"api/**.yml",
"api/index.md",
"api-vb/**.yml"
],
"exclude": [
"**/toc.yml",
"**/toc.md"
]
},
{
"files": [
"articles/**.md",
"articles/**/toc.yml",
"toc.yml",
"*.md"
],
"exclude": [
"**/bin/**",
"**/obj/**",
"_site_pdf/**",
"**/toc.yml",
"**/toc.md"
]
},
{
"files": "pdf/toc.yml"
}
],
"resource": [
{
"files": [
"images/**"
],
"exclude": [
"**/bin/**",
"**/obj/**",
"_site_pdf/**"
]
}
],
"overwrite": [
{
"files": [
"apidoc/**.md"
],
"exclude": [
"**/bin/**",
"**/obj/**",
"_site_pdf/**"
]
}
],
"dest": "_site_pdf"
}

pdf 部分跟build 部分类似。

执行 docfx 命令,在 _site_pdf  文件夹下就可以看到pdf 文档了。

示例下载:http://dotnet.github.io/docfx/tutorial/walkthrough/artifacts/walkthrough3.zip

http://dotnet.github.io/docfx/tutorial/walkthrough/walkthrough_generate_pdf.html

上一篇:input date 支持placeholder属性


下一篇:Spring Boot集成JasperReports生成PDF文档