[Hugo] 저고리 안쪽에 있는 Mardown의 렌더링.

4227 단어 MarkdownHugotech

TL; DR

  • 고장 제거
  • Mardown은 Hugo의 짧은 코트 내부가 잘 바뀌지 않았다
  • Shortcodes에는 두 가지 문법%과 문법<이 있는데 그 내부의 문장이 Markdown Parer에 전달되는지 여부가 다르다
  • v0.60부터 기본 해상도는goldmark가 되어 HTML의 입력을 <-- raw HTML omitted -->로 무시하기 때문에 더욱 번거롭다
  • 맨 안쪽%에서 문장 구조에서 아무것도 하지 않는 짧은 코드를 호출하고 외부의 짧은 코드를 모두 < 문법으로 부르면 된다
  • 1. Hugo의 기본


    정적 사이트 생성기Hugo를 이용하여 구축블로거엔지니어링 웹 사이트.Hugo는 Go로 쓴 것으로 Markedown에서 오는 전환이 빠르다는 말을 자주 듣는다.(나도 CI에서 매번 재생성되지만 생성 시간에 특별히 신경을 쓰지 않는다.)

    2. Hugo Shortcodes의 기본


    Hugo에서는 Shortcodes와 같은 템플릿 기능에 따라 Markdown이 표현할 수 없는 복잡한 HTML을 웹 사이트에 담을 수 있다.
    짧은 사이즈는 다음과 같은 3가지 모드가 있습니다.
  • 사용자별 짧은 메시지
  • layouts/shortcodes/(ショートコード名).html
  • 활용 주제 제공 짧은 코드
  • theme/(テーマ名)/layouts/shortcodes/(ショートコード名).html
  • Hugo주체가 제공한 공식 단신
  • 짧은 코드의 기본 구조는 HTML의 탭처럼 열리고 닫히며 다음과 같은 두 가지 구조를 사용합니다.
  • {{< ショートコード名 >}}文章{{< /ショートコード名 >}}
  • 안쪽 문장을 원시 문자열로 처리하여 아무런 변환도 하지 않음
  • 이 글에서 <문법
  • 이라고 부른다
  • {{% ショートコード名 %}}文章{{% /ショートコード名 %}}
  • 안쪽 글을 Mardown Party
  • 에 전달
  • 이 문장에서 문법%
  • 이라고 부른다
    (v0.55% 많은 사람들이 문법 행동이 변한 것 같다고 말하지만 문서를 잘 모른다.이번고장제거는심각해요.

    3. 당하는 분쟁


    원래 전체%는 문법으로 짧은 코드를 호출했지만 짧은 코드를 끼워 넣으면 <-- raw HTML omitted -->로 표시되어 원래의 글이 없어진다.이것은 v0입니다.60 이후 기본 Mardown Parser는 Blackfriday에서 goldmark로 변경됩니다.
    (HTML을 조금 포함하면 HTML 태그뿐 아니라 글의 단편을 제거해야 해 피해가 크다.)
    또한, 굿마크의 설정을 바꾸면 HTML 입력을 허용할 수 있을 것 같지만 unsafe라는 말이 나오면 싫어 다른 대처법을 찾아보기로 했다.
    config.toml
    [markup]
      [markup.goldmark]
        [markup.goldmark.renderer]
          unsafe = true
    

    4. 처리 방법


    문제는 바뀐 글을 골드마크에게 다시 전달하는 것이기 때문에 다음과 같은 아무것도 하지 않는 짧은 코드를 만들었고, 마크다운을 바꾸고 싶은 내부 문장만 그 짧은 코드% 문법 패키지로 옮겼다.이용하고 싶었던 바깥쪽 코트를 전부 < 구법으로 부르면 된다.
    (※ markdownify라는 주제를 사용하면 Shortcodes를 제공하면 가려집니다. 다른 이름을 추가해 주십시오.)
    layouts/shortcodes/markdownify.html
    {{.Inner}}
    
    index.md
    {{< (本来利用したいShortcodes) >}}
    {{% markdownify %}}
    [リンク](example.com)
    {{% /markdownify %}}
    {{< /(本来利用したいShortcodes) >}}
    

    참고 문헌

  • Parsing markdown inside shortcodes
  • Misunderstanding of shortcode syntax in 0.55
  • Shortcodes
  • Hugo v0.60 이상을 사용하면 Mardown의 HTML 태그가 "raw HTML omitted"로 사라집니다
  • 좋은 웹페이지 즐겨찾기