2017-09-29 52 views
4

我已經在Github開始了一個新項目,因爲我需要與人員合作,所以我想創建一個體面的文檔。我想爲此任務使用Github Pages,但文檔需要包含許多等式,例如https://wec-sim.github.io/WEC-Sim/theory.htmlMathjax在Github的頁面

我在網上閱讀了大量文章,Mathjax提供了一個很好的工具來閱讀瀏覽器上的方程,並且已經鏈接到Github頁面。不過,儘管我試圖遵循許多不同的策略,但我還是無法讓頁面顯示任何方程式。

您可以在我的項目https://github.com/enricoande/uuv和相應的頁面https://enricoande.github.io/uuv/找到我的項目。該頁面是從https://github.com/enricoande/uuv/blob/master/docs/README.md構建的。

最初,我根本無法顯示方程式,但可以看到Page中的文本。現在,我甚至無法看到該頁面。這已經添加文件https://github.com/enricoande/uuv/blob/master/docs/_layouts/page.html其內容

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

是否有可能,爲什麼我不能再看到我的網頁的原因是Mathjax太慢(我發現在網上對此評論)後發生了什麼?否則,你有什麼建議,我可以做些什麼來修復頁面以顯示方程?

正如你可以看到我是一個Github頁面和html的初學者。

任何建議都很好,因爲我現在完全卡住了。感謝您的幫助!

回答

1

如果你打開網頁的HTML源代碼,你會發現它包含什麼,但腳本標籤。

這是預期的,因爲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> 

然後,您必須創建一個index.html文件在您的文檔文件夾與

--- 
layout: page 
--- 

,這樣它拉在頁面模板開始(和腳本標籤)。

嘗試安裝jekyll並生成默認網站以評估良好的默認值;有關更多信息,請參閱the docs。通常,腳本標籤出現在頭部,頁眉或頁腳模板中。

+0

謝謝你的幫助。從你的解決方案中,我清楚地明白,我的頁面肯定存在html問題。如果我按照您的建議修改'page.html',頁面會再次顯示。所以,這顯然是我最初的'page.html'導致頁面無法正確顯示(沒有MathJax我沒有該文件,我猜GitHub必須使用模板)。 –

+0

我從Jekyll GitHub目錄中獲得它的掛鉤。但是,這是一個更復雜的項目。如果我只想從一個獨特的MD文件「README.md」開始,那麼在標題之後如何指定在'page.html'中指定它來讀取?它是「{{content}}」命令嗎?此外,我應該在哪裏放置''(注意,這是從上面的帖子中的MathJax讀取的命令)?在'

'之前?謝謝! –

+0

@Enrico我懷疑只是使用'{{content}}'並添加腳本標籤應該工作fin; MathJax腳本標記可以在內容之前或之後執行,MathJax不介意 –

2

如果我打開被引用的JS文件在https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML,我看到

console.warn( '警告:。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

不幸的是,我認爲我也有一個html問題,正如@Peter Krautzberger指出的那樣。 –