Q: 왜 Gollum이 내 코드 블록의 꺾쇠괄호를 매크로로 렌더링하나요? 그리고 어떻게 고칠 수 있나요?

Gollum은 꺾쇠괄호(예: ` [; ]`)를 포함한 인라인 코드 블록을 Gollum 매크로로 잘못 해석할 수 있습니다. 이를 방지하려면 코드 블록을 별도의 줄에 배치하고 각 줄에 triple backticks를 사용하세요: ```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 수정 사항이 포함되어 있지 않아 `[[include:]]` 태그의 절대 경로가 상대 경로로 잘못 처리되었습니다. 기존 배포 환경의 경우: 1. Gollum 배포 디렉토리에서 `bundle update gollum-lib`을 실행하여 패치된 gollum-lib 릴리스로 업그레이드하세요. 2. Gollum 서비스를 재시작하세요. 새로 설치하는 경우, 수정된 의존성이 기본적으로 포함된 최신 업데이트 Gollum 6.1.0 릴리스를 사용하세요. 위키 루트에 저장된 파일에 대해 `[[include:/other.md]]`와 같은 루트 레벨 include 예제를 사용하여 수정 사항을 확인하세요.

Question 2

왜 Gollum이 내 코드 블록의 꺾쇠괄호를 매크로로 렌더링하나요? 그리고 어떻게 고칠 수 있나요?

Accepted Answer

Gollum은 꺾쇠괄호(예: `

[;]`)를 포함한 인라인 코드 블록을 Gollum 매크로로 잘못 해석할 수 있습니다. 이를 방지하려면 코드 블록을 별도의 줄에 배치하고 각 줄에 triple backticks를 사용하세요: ```markdown ``` [][=]:

[;] ``` ``` 이렇게 하면 Gollum이 해당 내용을 매크로로 파싱하지 않습니다. Docker 이미지를 사용하는 경우 gem 변경이 필요하지 않으며, 이는 포맷팅 우회 방법입니다.

Question 3

Gollum에서 페이지 경로가 표시 텍스트보다 앞에 오는 MediaWiki/Obsidian 스타일 내부 링크를 사용하려면 어떻게 해야 하나요?

Accepted Answer

Gollum은 기본적으로 GitHub/GitLab 위키 문법인 `[[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

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트