Comments 31
А в чем «почти халява»?
Ну видимо в том что github предоставляет совершенно бесплатный хостинг. Я его очень активно использую для статических сайтов, демонстрации прототипов, и тд. Вот для примера то что недавно делал для конркурса вконтакта buger.github.com/vk_contest/. Ну и плюс конечно незаменимо для онлайн-документации проектов.
Вероятно в том, что без особого напряга получается приличная документация, с аналогом тегов, поиском и в html-формате. Которая, кроме всего прочего, лежит рядом с кодом и обновляется автоматом.
Вам этого мало? :)
Вам этого мало? :)
Вероятно, я не так выразился) Я имею ввиду в чем почти? Не нашел в посте описание того за что платить все же нужно.
Если бы я писал на python — возможно, но так как основной язык — perl, поддержки которого в sphinx я не нашел, то Natural Docs удобнее (да и выглядит привычнее).
Да там же можно просто составить конфиг файл и добавить текстовые файлы с документацией в поддерживаемых форматах и все. Все автоматом будет подхватываться из репы на github.com из папки docs. например посмотри как оформлено у проекта django-celery: github.com/ask/django-celery/tree/master/docs
А можно как-то расшифровать, что всё же происходит? Из статьи Dominic Mitchell тоже не особо понятно, что мы творим — зачем нам «make a new commit on that branch, but from a tree which is already in my repository». А то howto-стиль — это хорошо, но смысл действий тоже понимать не помешает. Опять же, зачем нужны строки
rm .git/index
git clean -fdx
rm .git/index
git clean -fdx
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Расшифровать-то можно. но придется вдаваться в дебри того, что есть object и tree в git.
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Попробуйте посмотреть book.git-scm.com/1_the_git_object_model.html и www.gitguys.com/topics/git-object-tree/.
Если коротко, то мы HEAD gh-pages ветви объявляем как ссылку на doc, который является одним из объектов нашего нового коммита — HEAD в ветке master. Деревья, корень дерева (gh-pages) как ссылка на ветвь(doc) другого дерева(master) — такая концепция, я не знаю как это можно проще представить.
>rm .git/index
>git clean -fdx
когда мы создаем новый brunch, то в нем есть все то, что и в родителе — т.е. это будет копия, а нам все эти документы не нужны. поэтому мы чистим его, удаляя из него все вообще.
так понятнее?
Вообще-то branch
Упс, хабр подложил мне свинью.
Давал ошибку Sql, а сам посты сохранял.
Сорри all.
Давал ошибку Sql, а сам посты сохранял.
Сорри all.
Sign up to leave a comment.
Natural Docs + GitHub Pages = online auto-documentation на халяву (почти)