HowToRelease

2008-05-02 00:06:55 +0900 (428d); rev 5

「Ruby リファレンスマニュアル刷新計画」のリリース手順の説明です。

リリースするものとそのファイル名

リリース物ファイル名(案)
パッケージ版ruby-refm-x.y.z-dynamic.tar.gz, zip, tar.bz2
chm版ruby-refm-x.y.z-chm.zip
web版http://doc.loveruby.net/refm/api/
静的html版 (将来的に)rubyrefm-x.y.z-html.tar.gz
info版 (将来的に)rubyrefm-x.y.z-info.tar.gz

リリース手順

仮のリリース手順を書いておきます。今回のリリースが終わったら、それを振り返りつつ追記してください。

  1. リリース物を作る(後述)
  2. リリースのアナウンス文を書く
  3. アナウンス文のレビュー (ML にて)
  4. Subversion レポジトリにリリースタグを打つ
  5. リリースパッケージを作ってサイトに置く
  6. ruby-list にリリースのアナウンス
  7. ruby-lang.org にリリースのアナウンス

リリース物の作り方

パッケージ版

まずbitclustとdoctreeをcheckoutしておきます。checkout済みの場合はsvn upで最新にします。

> svn co http://i.loveruby.net/svn/rubydoc/bitclust/trunk bitclust
> svn co http://i.loveruby.net/svn/rubydoc/doctree/trunk rubydoc

Windows環境の場合はexerbと7-zip32.dllとtar32.dllを入れておきます。 Windows以外の環境の場合は7za,zip,tar,gzip,bzip2を入れておきます。

> ruby bitclust/packer.rb --output-dir="ruby-refm-1.9.0-dynamic-snapshot"

を実行すると ruby-refm-1.9.0-dynamic-snapshot.tar.bz2, ruby-refm-1.9.0-dynamic-snapshot.tar.gz, ruby-refm-1.9.0-dynamic-snapshot.zip が作成されます。

Windows以外の環境の場合はあらかじめexerbで作成したserver.exeとserver.exyを用意しておき、--output-dirに指定するディレクトリに入れておくとアーカイブに含めることができます。

リリースしたファイルの置き場所は http://www.ruby-lang.org/ja/man/archive/ と ftp.ruby-lang.org/pub/ruby/doc/ です。

最後に、svn cp でタグを打っておきます。

chm版

まずbc-tochm.rbでdbからchm用の素材を作ります(ここまではOS非依存)。

> ruby bc-tochm.rb -d ./db -o ./chm

次に、MicrosoftのHTML Help Workshopでchmファイルにまとめます(Windowsが必要)。

> hhc.exe ./chm/refm.hhp

これで ./chm/refm.chm が作成できます。


system revision 1.162