2017-09-29 12 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から構築されています。

当初、私は方程式を表示できませんでしたが、ページ内のテキストを見ることができました。今、私はページを見ることさえできません。これは

<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を追加した後、それは(私がオンラインこの点についてのコメントを発見した)私はもはや私のページを見ることができる理由はMathjaxが遅すぎるということであることは可能ですが起こったのか?さもなければ、方程式を表示するために私がページを修正するために何ができるかについての提案がありますか?

ご覧のとおり、私はGithubのページとhtmlの初心者です。

私は今完全に詰まっているので、どんな提案も高く評価されます。お手伝いありがとう!

答えて

1

あなたのページのHTMLソースを開くと、あなたはそれがスクリプトタグしか含まれていないことに気づくでしょう。

your page templateは実際にはテンプレートではないため、{{ content }}などの液体テンプレートタグを含める必要があるため、実際のページからコンテンツを引き出すことができます。例えば

https://github.com/jekyll/jekyll/blob/master/docs/_layouts/page.htmlあなたはその後、index.htmlそれがページテンプレートに引っ張るように

--- 
layout: page 
--- 

で始まるあなたのドキュメントフォルダ内のファイル(および作成する必要があります

--- 
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> 

を持っていますスクリプトタグ)。

jekyllをインストールし、デフォルトのサイトを生成して適切なデフォルトを評価してください。その詳細については、the docsを参照してください。通常、スクリプトタグは、頭、頭、またはフッターのテンプレートに表示されます。

+0

ありがとうございました。あなたの解決策から、私のページには確かにhtmlの問題があることが私には明らかです。あなたが示唆するように 'page.html'を修正すると、ページが再び表示されます。ですから、私の元の 'page.html'は、ページを適切に表示しないようにしました(MathJaxを使わないと、GitHubがテンプレートを使用していたはずです)。 –

+0

私はJekyll GitHubディレクトリからハングアップしています。しかし、これははるかに複雑なプロジェクトです。一意のMDファイル 'README.md'から始めるだけであれば、タイトルの後に' page.html'でどのように読むことができますか?それは '{{content}}'コマンドですか?さらに、 ''(ここでは、これは上記の記事のMathJaxから読み込むコマンドです)を置くべきですか? 「

」の直前ですか?ありがとう! –

+0

@Enrico私はちょうど '{{content}}'を使用していると思うし、scriptタグを追加するとfinしなければならない。 MathJaxのスクリプトタグはコンテンツの前後に移動できますが、MathJaxは気にしません –

2

私はhttps://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMMLで参照JSファイルを開くと、私は

console.warnを参照してください( 'WARNING:。。cdn.mathjax.orgが廃止された移行のヒントについてhttps://www.mathjax.org/cdn-shutting-down/を確認してください')

詳細な移行のヒントについては、https://www.mathjax.org/cdn-shutting-down/を確認してください。

例ソリューション

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

ありがとうございました!あなたは正しい:私はページが移行したことに気付かなかった。 –

+0

@Peter Krautzbergerが指摘しているように、不幸にも、私もhtmlの問題があると思います。 –

関連する問題