Q: なぜGollumは私のコードブロック内の山括弧をマクロとしてレンダリングするのでしょうか？また、どうすれば修正できますか？

Gollumは、山括弧を含むインラインコードブロック（例：` [; ]`）をGollumのマクロとして誤解釈する可能性があります。これを防ぐには、コードブロックをトリプルバッククォートで囲んだ独立した行に配置します： ```markdown ``` [ ][= ]: [; ] ``` ``` これにより、Gollumがその内容をマクロとして解析するのを防ぎます。Dockerイメージを使用している場合、gemの変更は不要です。これはフォーマットの回避策です。

Question 1

Gollum 6.1.0 の [[include]] タグが絶対ファイルパスを相対パスとして扱う問題を修正するには？

Accepted Answer

この問題は、初期の Gollum 6.1.0 リリースが gollum-lib 6.0 を使用していたために発生します。このバージョンには gollum-lib PR #452 の絶対パスインクルードの修正が含まれていなかったため、`[[include:]]` タグ内の絶対パスが相対パスとして誤って処理されていました。既存のデプロイメントの場合: 1. Gollum のデプロイメントディレクトリで `bundle update gollum-lib` を実行し、修正済みの gollum-lib リリースにアップグレードします。2. Gollum サービスを再起動します。新規インストールの場合は、修正済みの依存関係がデフォルトで同梱されている最新の更新版 Gollum 6.1.0 リリースを使用してください。wiki ルートに保存されているファイルに対して、`[[include:/other.md]]` のようなルートレベルのインクルード例で修正を確認してください。

Question 2

なぜGollumは私のコードブロック内の山括弧をマクロとしてレンダリングするのでしょうか？また、どうすれば修正できますか？

Accepted Answer

Gollumは、山括弧を含むインラインコードブロック（例：`

[;]`）をGollumのマクロとして誤解釈する可能性があります。これを防ぐには、コードブロックをトリプルバッククォートで囲んだ独立した行に配置します： ```markdown ``` [][=]:

[;] ``` ``` これにより、Gollumがその内容をマクロとして解析するのを防ぎます。Dockerイメージを使用している場合、gemの変更は不要です。これはフォーマットの回避策です。

Question 3

Gollumでページパスを表示テキストの前に置くMediaWiki/Obsidianスタイルの内部リンクを使うにはどうすればよいですか？

Accepted Answer

Gollum はデフォルトで GitHub/GitLab の wiki 構文 `[[Display text|page-name]]` を使用します。MediaWiki/Obsidian の順序である `[[page-name|Display text]]` を使用するには、`config.rb` で使用しているマークアップ形式に対して `reverse_links` を有効にします。

```ruby
# config.rb
Gollum::Markup.formats[:markdown][:reverse_links] = true
```

設定ファイルを指定して Gollum を起動します。

```bash
gollum --config config.rb
```

他の形式の場合は、`:markdown` を `:asciidoc` や `:rdoc` などの適切なキーに置き換えてください。このオプションを有効にすると、内部リンクは `[[linked-resource|visible-link-text]]` として解釈されます。

gollum

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト