问题标签 [gollum-wiki]

• 描述：

  • 我正在尝试集成包含 vimwiki 和 Gollum 的工作流程和工具。我只想添加 vimwiki 作为编辑器的扩展类型，同时由 Gollum 的内部 Markdown 处理器处理（请参阅“我尝试过的事情”#1）。
  • 最后，我还希望 Gollum 在创建新文档时也默认为“vimwiki”。
  • 我正在做的项目可以在Vimwiki-Gollum-Integration找到

• 测试细节：

  • 咕噜版本：4.1.1
  • 正在测试的文件是有效的 github markdown
  • 正在使用不同的文件名和扩展名测试相同的内容：
    • 测试x.thing
    • 废话.vimwiki
  • 使用 .md 扩展名命名的测试文件可以正常工作
  • 安装了相关的渲染宝石：
    • github-markdown
    • github标记
    • 克拉姆当
    • 红地毯
  • 所有代码都在 gollum --config 文件中进行测试
  • 我不精通红宝石

我尝试过的事情

1. 创建新的扩展和自定义渲染器
   • 这有效，除非没有理由实现自定义处理器（pandoc）
   • 这将是理想的，以便 Markdown 名称最终出现在编辑页面中。但是，我认为我不应该在这里涉及 pandoc
   • 在编辑 vimwiki 扩展时，如何让编辑页面将降价默认为 vimwiki？
   • 使用的文件：blah.vimwiki

2. 尝试替换 Markdown 主扩展和正则表达式。
   • 我不明白为什么这不起作用，除非我误解了匹配和覆盖的操作顺序。
   • 该页面将显示，扩展名被识别，但页面根本不格式化 - 将所有内容合并在一起。

3. 尝试仅替换降价扩展正则表达式
   • 结果与尝试 2 相同。
   • 页面将显示，但格式不正确

我有一个 GitLab 存储库，其中包含附加 wiki 中的文档（即不在存储库本身中）和存储库本身内的一个图像文件，我想嵌入到 wiki 页面中。

如何才能做到这一点？

[[../tree/master/pathto/myimage.jpg]]从 wiki 页面，我可以使用or[[../raw/master/pathto/myimage.jpg]]但是成功链接到图像

![](../raw/master/pathto/myimage.jpg)

似乎不起作用。

（GitLab 社区版 10.0.3）

如何在 Gollum 中使用诸如数学之类的 reStructuredText (rst) 指令？

我的 Bitbucket wiki 有包含数学内容的 rst 文件，例如

:math:`1+1`

但是 Gollum 中的任何 rst 指令都像代码一样呈现。相反，它期望$1+1$（对于内联数学）。我可以更改定义数学代码的字符，但它在 Bitbucket 中不起作用。

我正在编辑 GitLab 项目 wiki 中的页面。

如果我将页面命名为“first-last”，则 URL 为“project/wikis/first-last”，并且页面标题在句子大小写中呈现为“First-last”。如果我将页面命名为“first-(last)”，则 URL 为“project/wikis/first-(last)”，并且页面标题在句子中呈现为“First(last)”。

我希望 URL 为“project/wikis/first-last”，页面标题为“First（last）”。因此，我想覆盖页面标题。

我的理解是 GitLab 项目 wiki 在Gollum上运行。根据 Gollum 文档，页面标题可以用以下两种方法之一覆盖：

1. 启用--h1-title. 页面上的第一个 H1 级标题将覆盖页面标题。

2. 使用元数据指令。如果页面的第一行是<!-- --- title: My page title -->，则给定的值将覆盖页面标题。

我无权访问选项 1。我尝试了选项 2，但没有任何反应。

如何覆盖 GitLab wiki 页面的标题？

我想通过以下方式自定义 gollum wiki 的布局：

1. 向左移动侧边栏（默认在右侧）
2. 使页面的主体更宽。现在它只需要大约三分之一的屏幕宽度，而且文本真的很窄。

我知道我可以在我的仓库中有一个custom.css文件，当我使用该--css标志时应该加载该文件。但是，我不知道在文件中放什么，并且查看 gollum repo 中的 css 文件并没有帮助。

我们当地的黑客空间有一个 Github Wiki，我们在其中记录了我们的组织。一些资产可以由 github 操作自动生成，但为了到达那里，我们需要一些东西来触发操作。有没有办法让 Github Action 在每次编辑 wiki 时运行？

任何人都可以概述解决咕噜不渲染数学问题的步骤吗？

我正在使用 --mathjax 运行 gollum，但它不会产生预期的结果。我的咕噜版本是 5.2.1。

我正在尝试渲染此文件：https ://github.com/mojombo/gollum-demo/blob/master/Math.pod

如何增加 Gollum wiki 中页面编辑器的高度？所以，我说的是编辑页面内容的 textarea 字段。

让编辑器填充页面的可用高度是理想的，但至少更大的恒定高度将是一种真正的解脱。

我正在尝试使用 Gollum 在本地将 AsciiDoc 文档呈现为 GitLab Wiki 的一部分。.asciidoc 文件包含使用 Kroki 服务器呈现的 PlantUML 图。Kroki在文档开头是这样配置的

Kroki 服务器可以正常工作，因为我已经在 IntelliJ IDEA 中成功渲染了该文件。

为了正确渲染 PlantUML 块，我如何知道使用所需的扩展程序gollum运行？asciidoctorasciidoctor-kroki

该文档直接在 GitLab 中就像一个魅力。所以我想一定有办法。

我是一个非 Ruby 的人，正在寻找一些基本的帮助。

我认为 gollum 是创建个人 wiki 的一种简单方法，我喜欢它由简单文件支持，位于 git 中。按照简单的说明，我让它工作了！

很酷。

但我想在它周围设置一些安全措施，这样我就可以把它放到互联网上，让不请自来的人进入。因为这个 gollum-auth 看起来像门票。而且，另一个问题（How to configure Gollum-wiki to allow basic authentication and to use the username for the git commit answer by Björn Albers https://stackoverflow.com/users/2786269/bj%c3%b6rn-albers）看起来像我想要什么，但我需要一些基本的帮助来理解答案：

• “在咕噜之前加载它”是什么意思？
• 我在哪里放置 config.ru？

谢谢。

-kb