2017-09-29 8 views
4

나는 Github에서 새 프로젝트를 시작했으며 사람과 공동 작업해야하므로 괜찮은 문서를 만들고 싶었습니다. 이 작업을 위해 Github Pages를 사용하고 싶지만 문서에 많은 방정식을 포함해야합니다 (예 : https://wec-sim.github.io/WEC-Sim/theory.html).Github의 Mathjax 페이지

Mathjax가 브라우저에서 방정식을 읽는 데 유용한 도구를 제공하고 Github 페이지에 링크 된 수많은 게시물에서 온라인으로 읽었습니다. 그러나, 나는 많은 다른 전략을 따르려고했지만, 아직 어떤 방정식을 보여주기 위해 나의 페이지를 얻을 수 없었습니다.

내 프로젝트는 https://github.com/enricoande/uuv이고 해당 페이지는 https://enricoande.github.io/uuv/입니다. 이 페이지는 https://github.com/enricoande/uuv/blob/master/docs/README.md에서 작성됩니다.

처음에는 방정식을 전혀 표시 할 수 없었지만 페이지에서 텍스트를 볼 수있었습니다. 지금, 나는 심지어 그 페이지를 볼 수 없다. 이것은 내가 더 이상 내 페이지를 볼 수있는 이유는 Mathjax (나는 온라인이 점에 대한 의견을 발견했다) 너무 느린 있다는 것을

<script type="text/javascript" 
    src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"> 
</script> 

를 읽는 것이 가능 파일 https://github.com/enricoande/uuv/blob/master/docs/_layouts/page.html를 추가 한 후 무슨 일이 있었습니까? 그렇지 않으면 방정식을 표시하기 위해 페이지를 수정하기 위해 할 수있는 것에 대한 제안 사항이 있습니까?

나는 Github 페이지 및 html 초보자입니다.

나는 지금 완전히 갇혀 있기 때문에 어떤 제안이라도 잘 부탁드립니다. 도와 주셔서 감사합니다!

답변

1

, 당신은 스크립트 태그만을 포함하지 않는 것을 알 수 있습니다.

실제로 your page template은 템플릿이 아니기 때문에 {{ content }} 또는 유사한 액체 템플릿 태그가 있어야 실제 페이지에서 콘텐츠를 가져올 수 있기 때문에 예상됩니다. 예를 들어

https://github.com/jekyll/jekyll/blob/master/docs/_layouts/page.html가있다

--- 
layout: default 
--- 

<section class="standalone"> 
    <div class="grid"> 

    <div class="unit whole"> 
     <article> 
     <h1>{{ page.title }}</h1> 
     {{ content }} 
     </article> 
    </div> 

    <div class="clear"></div> 

    </div> 
</section> 
당신은 다음 페이지 템플릿에 끌어 너무

--- 
layout: page 
--- 

로 시작하여 문서 폴더에 index.html 파일을 만들어야합니다

(그리고 스크립트 태그).

jekyll을 설치하고 기본 사이트를 생성하여 적절한 기본값을 평가하십시오. 자세한 내용은 the docs을 참조하십시오. 일반적으로 스크립트 태그는 머리글, 머리글 또는 바닥 글 서식 파일에 나타납니다.

+0

도움 주셔서 감사합니다. 귀하의 솔루션에서 이제는 분명히 내 페이지에 html 문제가 있음을 분명히 알 수 있습니다. 당신이 제안한대로'page.html'을 수정하면 페이지가 다시 표시됩니다. 그래서 분명히 원래의'page.html'가 페이지를 제대로 표시하지 못하게했습니다 (MathJax 없이는 그 파일이 없었고 GitHub가 템플릿을 사용 했음에 틀림 없었습니다). –

+0

나는 Jekyll GitHub 디렉토리에서 그걸 알아챌거야. 그러나 이것은 훨씬 더 복잡한 프로젝트입니다. 고유 한 MD 파일 인'README.md'로 시작하기를 원한다면 어떻게 제목 뒤에'page.html'에서 그 파일을 읽을 지 지정할 수 있습니까? '{{content}} '명령입니까? 게다가,''(위의 게시물에서 MathJax에서 읽는 명령입니다)을 어디에 넣어야합니까? '

'직전입니까? 감사! –

+0

@Enrico '{{content}}'를 사용하고있는 것으로 의심되며 스크립트 태그를 추가하면 지느러미가 작동합니다. MathJax 스크립트 태그는 내용 앞이나 뒤에 나타날 수 있습니다. MathJax는 마음에 들지 않습니다 –

2

내가 https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML에서 참조 된 JS 파일을 열면, 나는

console.warn 볼 ('경고 :.. cdn.mathjax.org 은퇴 된 마이그레이션 팁 https://www.mathjax.org/cdn-shutting-down/ 확인')

자세한 마이그레이션 도움말은 https://www.mathjax.org/cdn-shutting-down/을 확인하십시오. 당신이 당신의 페이지의 HTML 소스를 열면

예 솔루션

<script type="text/javascript" async 
    src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?..."> 
</script> 
+0

고마워요!당신 말이 맞아요. 나는 그 페이지가 이주했음을 알지 못했다. –

+0

불행히도 필자는 @Peter Krautzberger가 지적한 바와 같이 html 문제도 있다고 생각한다. –