在github/gitlab wiki中嵌入PDF

Question

我目前使用GitLab来管理我的代码仓库，这个工具一直表现得相当好。然而，我认为维基百科需要进行相当多的改进。

当您已经有文档并想要添加到维基时，这会让人非常烦恼。将表格或PDF转换为GitLab格式的Markdown可能是耗时且不容易的。

我的问题有两个方面：

1. 是否有人成功地将文件（特别是PDF）嵌入到他们的GitHub/GitLab维基中？在GitLab上这应该是可行的，但是否有简便的方法呢？我已经设置好了一个文档存储库，它可以嵌入从文档存储库链接的文件，这将非常棒。

2. 如果不能将文件嵌入到页面中，如何高效地将文档翻译为GitLab Markdown格式？

- user3817250

Answer 1

我遇到了同样的问题，所以来到这里，也许可以帮到别人。

我没有找到将 .pdf 嵌入页面的方法，但我把 .pdf 添加到了 wiki 文件夹中（就像普通页面一样）。最初，这个文件没有显示在侧边栏中，也无法从 Github 进行搜索。

然而，可以直接从其他页面或自定义侧边栏中链接它（例如 osquery's wiki 中的漂亮侧边栏）。点击链接会让你下载 .pdf（没有找到在浏览器中预览它的方法）。

- spygi

---

谢谢提供这些信息。由于翻译现有文档所需的努力，我已经放弃了Github/Gitlab维基。 - user3817250

你如何将PDF文件添加到Wiki文件夹中，就像添加普通页面一样？你的意思是我们应该将PDF文件添加到Git存储库中，然后链接到它吗？ - Olivia Stork

Answer 2

有可能这种操作类型只在云GitLab版本中不允许，因为gitlab-gollum库文档描述如此：

[[Gollum|gollum.pdf]]

- Alexander Chip

Answer 3

我使用Gitlab（自托管）的功能定期渲染MarkDown页面，以记录我的项目。

将HTML或PDF文档复制粘贴并转换为格式完美的MarkDown的最佳方法是使用Typora。 Typora具有以下非常有用的功能：

• 支持Gitlab TOC渲染（即[[_TOC_]]）
• 从HTML页面复制并粘贴到MarkDown
• 上传图片

在我看来，它非常适合与GitLab一起使用进行文档编写。

- Stefano Bossi