AzureDevOps.WikiPDFExport 项目常见问题解决方案

AzureDevOps.WikiPDFExport 项目常见问题解决方案

1. 项目基础介绍和主要编程语言

**项目介绍：**AzureDevOps.WikiPDFExport 是一个开源项目，用于将 Azure DevOps 的 Wiki 页面导出为 PDF 文件。这个工具支持保留 Wiki 页面的样式、格式以及图片，并可以生成包含目录的 PDF，使得导出的文档结构清晰、易于阅读。

**主要编程语言：**该项目使用 C# 编程语言开发，基于 .NET 6 应用程序框架。

---

2. 新手使用项目时需特别注意的三个问题及解决步骤

问题一：如何克隆项目？

**问题描述：**新手在使用前需要先获取项目的代码。

解决步骤：

1. 打开命令行工具。
2. 使用 git clone 命令克隆项目，命令格式如下：

   git clone https://github.com/MaxMelcher/AzureDevOps.WikiPDFExport.git
   

3. 等待项目克隆完成。

问题二：如何运行项目？

**问题描述：**新手可能不清楚如何执行项目以导出 PDF。

解决步骤：

1. 确保克隆了项目并且进入了项目目录。
2. 下载 azuredevops-export-wiki.exe 文件到项目目录中。
3. 在命令行中，运行以下命令来执行程序：

   ./azuredevops-export-wiki.exe
   

4. 程序将会自动检测并转换当前目录下的所有 Wiki 文件为 PDF。

问题三：如何处理附件目录？

**问题描述：**如果 Wiki 页面包含附件，新手可能不知道如何正确配置附件路径。

解决步骤：

1. 在运行 azuredevops-export-wiki.exe 命令时，添加 --attachments-path 参数来指定附件目录的路径。
2. 命令格式如下：

   ./azuredevops-export-wiki.exe --attachments-path ./attachments
   

3. 如果附件目录位于 Wiki 文件夹的同一级别，则使用 ./attachments；如果不是，请根据实际情况修改路径。

通过以上步骤，新手应该能够顺利地使用 AzureDevOps.WikiPDFExport 项目导出 PDF 文档。如果遇到其他问题，可以查看项目文档或者通过 GitHub 的 Issues 页面寻求帮助。