IT story

GitHub 맛 마크 다운에 각주를 추가하는 방법?

hot-time 2020. 4. 15. 12:35
반응형

GitHub 맛 마크 다운에 각주를 추가하는 방법?


GitHub Gist에 각주를 추가하려고하는데 작동하지 않습니다.

Some long sentence. [^footnote]

[^footnote]: Test, [Link](https://google.com).

이 안내서를 따르고 있으며 내가 잘못하고 있다고 생각하지 않습니다. 누군가 내 실수를 지적 할 수 있습니까?


GitHub Flavored Markdown은 각주를 지원하지 않지만 유니 코드 문자 또는 위첨자 태그 (예 :와 같이)를 사용하여 수동으로 가짜 ¹를 지정할 수 있습니다 <sup>1</sup>.

¹ 물론 각주 번호를 유지해야 할 책임이 있기 때문에 물론 이것은 이상적이지 않습니다. 그러나 하나 또는 두 개만 있으면 합리적으로 잘 작동합니다.


이전 답변을 약간 확장하면 각주 링크를 여기에서 클릭 할 수있게 만들 수 있습니다. 먼저 아래처럼 각주를 정의하십시오

<a name="myfootnote1">1</a>: Footnote content goes here

그런 다음 문서의 다른 곳에서 다음과 같이 참조하십시오

<sup>[1](#myfootnote1)</sup>

이전 답변을 더 확장하면 id각주 링크에 속성을 추가 할 수 있습니다 .

 Bla bla <sup id="a1">[1](#f1)</sup>

그런 다음 각주 내에서 다시 연결하십시오.

<b id="f1">1</b> Footnote content here. [↩](#a1)

이렇게하면 각주 내용의 끝에 약간이 추가되어 독자들이 각주 링크가 포함 된 줄로 되돌아갑니다.


공식적으로 문서화되어 있는지는 알 수 없지만 Github에서 바닥 글 메모를 할 수 있습니다.

  1. 바닥 글 링크를 삽입 할 위치를 대괄호 (IE)로 묶은 숫자로 표시하십시오. [1]

  2. 게시물 하단에서 번호가 매겨진 마커를 참조한 다음 콜론과 링크, IE를 참조하십시오. [1]: http://www.example.com/link1

미리 본 후에는 게시물 본문에 번호가 매겨진 링크로 렌더링됩니다.


Surya와 Matteo의 솔루션을 작동시킬 수 없었습니다. 예를 들어, "(# f1)"은 방금 텍스트로 표시되었으며 링크가되지 않았습니다. 그러나 그들의 솔루션으로 인해 약간 다른 솔루션이되었습니다. (또한 각주와 원본 위첨자에 대한 링크의 형식이 약간 다릅니다.)

본문에서 :

Yadda yadda<a href="#note1" id="note1ref"><sup>1</sup></a>

문서의 끝에서 :

<a id="note1" href="#note1ref"><sup>1</sup></a>Here is the footnote text.

각주에서 위첨자를 클릭하면 원래 텍스트의 위첨자로 돌아갑니다.


짧은 메모의 경우 제목 속성이있는 앵커 요소를 제공하면 "툴팁"이 생성됩니다.

<a title="Note text goes here."><sup>n</sup></a>

그렇지 않으면 더 많은 관련 메모의 경우 가장 좋은 방법은 명명 된 링크를 수동으로 유지하는 것입니다.


Mateo 솔루션의 변형을 사용했습니다. Jekyll 기반 웹 사이트를 위해 github flavored markdown (gfm)으로 작성된 Rmd 파일에서 이것을 사용하고 있지만 다양한 컨텍스트에서 pdf를 생성하는 데 동일한 Rmd 파일이 사용되고 있습니다. Rmd 파일은 수학적으로 무겁고 수학은 웹 사이트에서 MathJax와 함께 표시됩니다. 그래서 Jekyll을 통해 처리되고 pandoc-> pdflatex와 작동하며 MathJax와 호환되는 gfm과 작동하는 솔루션이 필요했습니다.

Rmd 파일의 스 니펫 (gfm)

Here is a paragraph with an footnote <span id="a1">[[1]](#f1)</span>.

Footnotes
=========

1. <span id="f1"></span> This is a footnote. [$\hookleftarrow$](#a1)

$\hookleftarrow$항상 MathJax를 사용하도록 설정했기 때문에 라텍스입니다. 내 PDF에 올바르게 표시되도록 사용합니다. 인라인 수학에 각주를 넣으면 위첨자가 혼동되기 때문에 각주를 대괄호 안에 넣습니다.

여기에 작동합니다 : https://eeholmes.github.io/posts/2016-5-18-FI-recursion-1/

이 메모는 Rmd의 어느 곳에 나 넣을 수 있습니다. 나는 기술적으로 미주가되도록 끝에 목록을 작성하고 있습니다.


이것은 나를 위해 작동합니다 :

blablabla [<sup>1</sup>](#1)blablabla

각주 : blablabla에 대한 참조 <a class="anchor" id="1"></a>

참고 URL : https://stackoverflow.com/questions/25579868/how-to-add-footnotes-to-github-flavoured-markdown

반응형