subversion管理しているプロジェクトのサブディレクトリをgithubに引っ越す

巡り巡って自分の目の前にある subversion 管理されたプロジェクトの一部を git 変換して github に引っ越す方法をメモ。 作業の流れ  履歴を subversion から git に変換 属性を subversion から git に変換 github に push 履歴を subversion から git に変換 branch/tag も引っ越すには、パスの切り方が subversion の推奨通りであれば –stdlayout をつけるだけでOK。 推奨から外れる場合、明示的に –trunk, –branches, –tagsで指定する。 see : http://stackoverflow.com/a/5361588 git svn clone は git svn init & git svn fetch のショートカット 属性を subversion から git

Sphinxで更新履歴ページを作成

Sphinx でドキュメント管理している時に、みんなどうやって更新履歴ページを作成しているのか気になったので、既存プロジェクトを調べてみた。 履歴管理方法 大きく分けて2通りあった。 (主流)アプリケーションのChangeLog(や History や News)ファイルを Sphinx の更新履歴ページからインクルード (少数派)更新履歴ページにベタ書き 外部ファイルをインクルードしているプロジェクト 開発フローとしては、機能改修したら ChangeLog を更新すると、ドキュメントも連動する。 Sphinx Sphinx 自体、この方法で履歴ページを管理している。 HTML : http://sphinx-doc.org/changes.html 元ファイル : http://sphinx-doc.org/_sources/changes.txt CHANGES ファイルを引っ張っている Python HTML : http://docs.python.org/3.3/whatsnew/changelog.html 元ファイル : http://docs.python.org/3.3/_sources/whatsnew/changelog.txt NEWS ファイルを引っ張っている Tornado HTML : http://www.tornadoweb.org/en/stable/releases.html 元ファイル : http://www.tornadoweb.org/en/stable/_sources/releases.txt pylons HTML : http://docs.pylonsproject.org/projects/pyramid/en/latest/changes.html 元ファイル : https://raw.github.com/Pylons/pyramid/1.4-branch/docs/changes.rst pip HTML : https://pip.readthedocs.org/en/latest/news.html 元ファイル :