2011-05-15 100 views
6

我正在爲我們的API的用戶編寫一個教程,並希望將代碼片段和完整的文件作爲示例。我可以將整個目錄結構公開爲git,供人們下載;沒問題。但我想以我可以通過要點的方式在相關頁面中嵌入特定的代碼。我可以通過Gist共享整個Git項目嗎?

我這樣做是通過將每個文件複製成要點,按下「嵌入」,並將生成的鏈接複製到我的教程頁面。

但是,將git repo全部設置爲完整文件似乎是浪費,然後必須爲每個文件複製它。有一個更好的方法嗎? (或者,如果有辦法從git中嵌入對特定文件的引用,我也可以這樣做 - 這裏的用例是說,「這是完整的示例文件」,所以我會細拉它的方式。)

謝謝。

回答

3

http://gist-it.appspot.com/

GitHub上有這樣他們的「名單」,但我們不知道什麼時候會發生。

+0

謝謝 - 試過,但不斷得到'加載失敗 - 超時' - 這是正常的嗎? – 2011-05-15 14:24:22

+1

+1不錯,很高興知道... – 2011-05-15 14:40:28

+0

@Dave Rodger - 是的,我也一樣。我之前使用過這個,所以這可能是由於該網站超過了AppSpot的限制。但正如@Mark Longair所說,你應該能夠掀起這樣的事情。也許你可以聯繫gist-it的作者來獲得一些快速的想法。 – manojlds 2011-05-15 14:46:44

2

看來,不只是那些從學家,嵌入任何文件是什麼,GitHub的計劃,但尚未完成:

不過,你可以通過從GitHub上的「raw」鏈接動態加載文件並使用SyntaxHighlighter來很好地渲染它們,從而完成這樣的工作。

+0

謝謝,馬克。很高興看到它在列表中,即使它不能立即解決我的問題。我會考慮通過你建議的路線自己做這件事。 – 2011-05-15 14:26:32

相關問題