2011-05-06 28 views
1

我不確定這是否可能,但這是我想要做的:如何自動發佈我的github回購頁面上的數學標記?

我想創建一個literate program,託管在github上,並且由此產生的人性化文獻自動發佈在我的github的項目頁面上。通過「自動發佈」,我的意思是我可以在本地機器上運行一個以「git push origin master」結尾的腳本,並最終在github上發佈一個人性化的,包含數學的文檔。我願意爲達到目標而做出妥協,但更簡單,更好。

很多人不知道什麼是文學編程,所以我會總結一下。這是一個系統,您可以編寫單個文檔,該文檔可以翻譯成源代碼或人性化文檔。其目的是以英文(或其他自然語言)非常清楚地解釋該算法,並且當用戶有興趣閱讀有關您的算法以及直接使用該算法時,該算法被認爲是有用的。有些人(如Donald Knuth)認爲文學編程是構建任何複雜軟件的關鍵工具。

這樣做的一個想法是生成類似於README.md文件的文件作爲literate程序的輸出,但我不知道github的markdown格式中有任何數學支持。它看起來像Github的維基可能支持一些數學,但我不知道如何使代碼生成的維基 - 因爲我想能夠從我的機器做git push origin master,並有github wiki自動更新。 (另外,爲了理解爲什麼數學支持很重要:我來自一個總是使用TeX或LaTeX編寫論文的世界,而且我對其他作者用於LaTeX的一般系統也感興趣)

任何想法如何實現?

回答

1

維基是由他們自己的git repo支持的,所以你可以推送它並自動更新。這是一個不同於主要的回購。據我所知,維基只支持這些內容,而不是主要的回購降價處理器。

+0

謝謝。有什麼方法可以找出我如何在任何標記語言中支持數學?我一直在尋找文檔,但在任何情況下,它看起來像數學支持是github默認不支持的擴展。 – Tyler 2011-05-07 00:47:19

+1

維基編輯器的幫助應該爲您提供所需的信息,您爲該頁選擇了哪種標記語言:https://img.skitch.com/20110507-rq75yf2yc1taqpa8jtdme4w83u.jpg – Tekkub 2011-05-07 01:31:50

+0

我剛剛嘗試過Tekkub的示例,它似乎不再支持? – 2011-10-09 01:54:11

相關問題