programing

Github 페이지의 Jekyll : Markdown에 각주를 추가하는 방법은 없나요?

nasanasas 2020. 12. 25. 10:07
반응형

Github 페이지의 Jekyll : Markdown에 각주를 추가하는 방법은 없나요?


저는 최근에 다양한 블로그를 위해 Github 페이지에서 Jekyll을 사용하는 것으로 전환했으며 Markdown을 Github로 푸시하고 처리를 처리 할 수 ​​있다는 점이 마음에 듭니다. Github UI를 사용하면 내 컴퓨터에 있지 않은 경우 게시물을 쉽게 추가하고 조정할 수 있으므로 Jekyll을 로컬에서 실행하고 미리 생성 된 사이트를 Github에 푸시하는 대신이 방법을 계속 사용하고 싶습니다.

내가 알아낼 수 없었던 한 가지는 마크 다운 각주가 작동하지 않는다는 것입니다. 이 스타일을 사용하고 있습니다.

I bet you'd like more information about this sentence [^1].

[^1]: Well lucky for you, I've included more information in footnote form.

redcarpet markdown 프로세서에 대한 각주 확장을 활성화 할 것을 제안한 게시물 (어딘가)을 찾았지만 이것도 마찬가지입니다.

markdown: redcarpet
redcarpet:
  extensions: ["footnotes"]

Github에 푸시하기 전에 정적 사이트를 미리 생성하지 않고 Markdown 각주를 사용할 수있는 방법이 있습니까?


마크 다운 구문 분석에 kramdown을 사용하고 각주를 멋지게 처리합니다.

_config.yml파일 에서 다음 행을 변경 하십시오.

markdown: redcarpet

에:

markdown: kramdown

Jekyll 3.0.0부터 kramdown이 기본 Markdown 프로세서 이므로 OP의 질문에있는 예제가 즉시 작동합니다. 패턴은 다음과 같습니다.

Some text[^1].

Some other text[^2].

The identifier in the square brackets does not have to be numeric[^my_footnote].

[^1]: Some footnote.
[^2]: Other footnote.
[^my_footnote]: This also works fine.

레드 카펫

사용하고 싶을 때 redcarpet지금 당장은 편리한 해결책이없는 것 같습니다. Redcarpet 3는 사용한 구문으로 각주지원 하지만 , Redcarpet 3은 Ruby 1.8 호환성 ( source )을 제거하기 때문에 Jekyll에 포함되지 않습니다 .

해결 방법 1 : 갈래의 Redcarpet 2 사용

Jerod Santo 의이 솔루션참조하십시오 .

다음 Gemfile내용으로 Jekyll 폴더의 루트에 라는 파일을 추가하십시오 .

source "https://rubygems.org"

gem "jekyll"
gem "redcarpet", github: "triplecanopy/redcarpet"

또는 대안으로 djui/redcarpet

Theny은 조정 _config.yml에를

markdown: redcarpet
redcarpet:
  extensions: [footnotes]

솔루션 2 : Jekyll 포크 및 Redcarpet 3 포함

이 작업을 수행하는 가장 쉬운 방법이 무엇인지 모르겠습니다. 의견을 환영합니다.

마루 쿠

각주를 지원하는 것 같습니다 ( source , source ).

참조 URL : https://stackoverflow.com/questions/19483975/jekyll-on-github-pages-any-way-to-add-footnotes-in-markdown

반응형