Могу ли я поделиться всем проектом Git через Gist?

Я пишу учебник для пользователей нашего API и хочу включить фрагменты кода и полные файлы для примера. Я могу предоставить всю структуру каталогов в виде git, чтобы люди могли ее скачать; нет проблем. Но я хотел бы встроить конкретный код на соответствующие страницы так, как я могу через суть.

Я делаю это, копируя каждый файл в gist, нажимая «вставить» и копируя полученную ссылку на мою страницу с руководством.

Тем не менее, кажется расточительным иметь репозиторий git с полными файлами, а затем дублировать его для каждого файла. Есть лучший способ сделать это?

(В качестве альтернативы, если есть способ внедрить ссылку на конкретный файл из git, я мог бы сделать и это — вариант использования здесь — сказать «вот полный пример файла», так что я был бы в порядке, вытащив его, что путь.)

Спасибо.


git gist
person Dave Rodger    schedule 15.05.2011    source источник

Ответы (2)


arrow_upward
3
arrow_downward

Существует http://gist-it.appspot.com/

GitHub имеет это в своем «списке», но мы не знаем, когда это произойдет.

person manojlds    schedule 15.05.2011
comment
Спасибо, попробовал, но постоянно получаю сообщение «Ошибка загрузки — истекло время ожидания» — это нормально? - person Dave Rodger; 15.05.2011
comment
@ Дэйв Роджер - Да, я получаю то же самое. Я использовал это раньше, так что это может быть связано с тем, что сайт выходит за пределы AppSpot. Но, как сказал @Mark Longair, вы должны быть в состоянии сделать что-то подобное. Может быть, вы можете связаться с автором gist-it для некоторых быстрых идей. - person manojlds; 15.05.2011
comment
Ошибка загрузки предназначена только для функции автоматической генерации на главной странице. Если вы соберете ссылку вручную, как показано (или с помощью самодельного скрипта), она все равно будет работать. - person Paŭlo Ebermann; 15.05.2011
comment
@Paŭlo Ebermann Да, ты прав. Спасибо что подметил это. @DaveRodger - вы можете построить <script> самостоятельно, как показано на сайте, и это работает. Я только что попробовал. - person manojlds; 15.05.2011
comment
Кто-нибудь знает, поддерживает ли github это сейчас? или вам все еще нужно использовать что-то вроде gist-it.appspot. - person Dimitry; 24.04.2013

arrow_upward
2
arrow_downward

Кажется, встраивание любого файла, а не только из gists, — это то, что GitHub планирует, но еще не сделал:

Однако вы можете сделать что-то подобное самостоятельно, динамически загружая файлы по «сырым» ссылкам на GitHub и используя SyntaxHighlighter чтобы красиво их изобразить.

person Mark Longair    schedule 15.05.2011
comment
Спасибо, Марк. Приятно видеть, что это в их списке, даже если это не решает мою проблему сразу. Я подумаю, чтобы сделать это самостоятельно по предложенному вами маршруту. - person Dave Rodger; 15.05.2011