packnga 0.9.7 → 0.9.8

data/.yardopts

@@ -0,0 +1,4 @@
+--output-dir doc/reference/en
+--markup textile
+--use-cache .yardoc
+lib/**/*.rb

data/Gemfile

@@ -15,6 +15,6 @@
 # License along with this library; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
-source "http://rubygems.org/"
+source "https://rubygems.org/"
 
 gemspec

data/README.textile

@@ -12,7 +12,7 @@ Packnga is a library to translate to many languages by YARD.
 
 h2. Authors
 
-  * Haruka Yoshihara <yoshihara@clear-code.com>
+  * Haruka Yoshihara <yshr04hrk@gmail.com>
   * Kouhei Sutou <kou@clear-code.com>
 
 h2. License

data/Rakefile

@@ -1,6 +1,6 @@
 # -*- coding: utf-8; mode: ruby -*-
 #
-# Copyright (C) 2011  Haruka Yoshihara <yoshihara@clear-code.com>
+# Copyright (C) 2011-2013  Haruka Yoshihara <yoshihara@clear-code.com>
 # Copyright (C) 2011  Kouhei Sutou <kou@clear-code.com>
 #
 # This library is free software; you can redistribute it and/or
@@ -16,16 +16,16 @@
 # License along with this library; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
-require 'English'
+require "English"
 
-require 'pathname'
-require 'rubygems'
-require 'rubygems/package_task'
-require 'bundler/gem_helper'
+require "pathname"
+require "rubygems"
+require "rubygems/package_task"
+require "bundler/gem_helper"
 
 base_dir = File.join(File.dirname(__FILE__))
 
-packnga_lib_dir = File.join(base_dir, 'lib')
+packnga_lib_dir = File.join(base_dir, "lib")
 $LOAD_PATH.unshift(packnga_lib_dir)
 ENV["RUBYLIB"] = "#{packnga_lib_dir}:#{ENV['RUBYLIB']}"
 

data/doc/text/news.textile

@@ -1,5 +1,37 @@
 h1. NEWS
 
+h2. 0.9.8: 2013-06-07
+
+h3. Improvements
+
+ * [ReferenceTask] Used YARD I18n feature for translating references.
+   For it, YARD 0.8.6.1 or later is required.
+ * [ReferenceTask] Supported replacing filenames which aren't
+   supported by GitHub Pages in "reference:publication:generate" task.
+   This task renames the fimename "_index.html" (methods list page) to
+   "alphabetical_index.html", because GitHub Pages doesn't support
+   files which their filenames start with "_".
+ * [ReferenceTask] Added the task ("release:references:upload") to
+   copy generated references to a HTML directory.
+   A HTML directory, for example, is a repository of GitHub Pages. In
+   this case, this task is used to commit references to GitHub Pages.
+ * [Referencetask] Dropped support to upload .htaccess.
+ * [ReleaseTask] Used the version in your gemspec as a new version
+   when no version is specified as an argument by "release:info:update"
+   task. A new version is used to replace HTML index files.
+
+h3. Fixes
+
+ * [ReferenceTask] Generated "reference path" correctly in merged PO
+   files.
+  "reference path" is a path of a file including translated message
+   (msgid) and it's attached to its corresponded msgid.
+ * [ReleaseTask] Removed needless replaces in HTML files in the
+   task "release:info:update".
+ * [ReferenceTask] Added missing description for the task
+   "reference:publication:generate" to generate references for
+   publication.
+
 h2. 0.9.7: 2012-12-26
 
 h3. Improvements

data/doc/text/release.textile

@@ -9,14 +9,20 @@ h2. news.textileに変更点のまとめ
 $ git log -p --reverse （前回のリリースバージョン)..
 </pre>
 
-ログを"Author:"で検索しながら、ユーザにとって知る必要があるもの（ユーザに見える情報）のコミットログのみを抜き出す。
+ログを"Author:"で検索しながら、ユーザにとって知る必要があるもののコミットログのみを抜き出す。
+
+ユーザにとって必要な情報とは、仕様の変更や新しい機能の追加など、ユーザーがリリースするライブラリを使う上で影響ある情報である。
+逆に、リファクタリング、テストの変更、変数名の変更など、ユーザーが直接意識しない部分については書く必要はない。
+
 次に、抜き出したコミットログを１つずつ見て、その先頭にカテゴリ名がある場合は、":"を削除してカテゴリ名を"["と"]"で囲む。
 カテゴリ名を除いたログの先頭にある単語を過去形にし、頭文字を大文字にする。
 その後、ログを次のように分類する。
-機能などに新しく追加されたものに関してはImprovement,
-動作の変更などはChanges,
-バグの修正など前バージョンまでにあった問題を修正したものはFixesに記述する。
-また、コミットログの行末に[人名]がある場合はその人名をThanks以下に書く。
+
+* Improvements: 機能などを新しく追加したコミットのログ
+* Changes: 動作の変更など、今まであったものを変更したログ
+* Fixes: バグの修正など前バージョンまでにあった問題を修正したログ
+
+また、コミットログの行末に[人名]がある場合は、Thanksという分類を作って、その人名をThanks以下に書く。
 さらにREADMEにあるThanks以下にも名前を追加する。
 
 この作業をリリース予定日よりも前に行った場合は、目に見えるところにコミットIDをメモしておく。
@@ -40,6 +46,8 @@ h3. Fixes
 * 
 
 h3. Thanks
+
+* 
 </pre>
 
 h2. 日本語訳の作成
@@ -67,20 +75,47 @@ doc/reference/ja/file.news.htmlなどのja.poを編集した箇所が正しく
 
 h2. バージョンとリリース日の更新
 
-下記コマンドを入力して、プロジェクトページ（html/index.html、html/index.html.ja）の最新バージョンとリリース日をそれぞれ今回のリリースに合わせたものに更新する。
+ranguba.orgのindexページ（index.html、ja/index.html）の最新バージョンとリリース日をそれぞれ今回のリリースに合わせたものに更新する。
+
+まず、任意の位置で次のコマンドを実行して、ranguba.orgのリポジトリをcloneする。
+
+<pre>
+!!!command_line
+$ git clone git@github.com:ranguba/ranguba.org.git
+</pre>
+
+そして、リリースするライブラリのRakefileに次を追加する。
+
+<pre>
+!!!ruby
+Packnga::ReleaseTask.new(spec) do |task|
+  task.index_html_dir = "/path/to/ranguba.org"
+end
+</pre>
+
+その後、次のコマンドを実行して最新バージョンとリリース日を更新する。
 
 <pre>
 !!!command_line
 $ rake release:info:update OLD_VERSION=（前回リリース時のバージョン） OLD_RELEASE_DATE=（前回リリース日） RELEASE_DATE=（今回のリリース日）
 </pre>
 
+h2. .gemspecの確認
+
+（パッケージ名）.gemspecの中身が問題ないか確認する。特に初めてリリースするときは注意すること。
+
+* .yardoptsをspec.filesに指定しているか（rubydoc.infoでドキュメントを閲覧するときに必要）
+* spec.files+=のつもりでspec.files=になっていないか
+* その他、spec.files=へ指定するファイルは過不足ないか・間違っていないか（diredなどでファイル一覧を見ながら作業する）
+* 依存関係（add_{runtime/developement}_dependency）は間違っていないか
+
 h2. gemパッケージの作成
 
 下記コマンドを打ってアップロード用のgemパッケージをビルドする。
 
 <pre>
 !!!command_line
-$ make clean
+$ make clean  # rroongaのみ必要
 $ rake build
 </pre>
 
@@ -104,21 +139,27 @@ $ NO_MAKE=yes ruby1.9.1 test/run-test.rb
 
 h2. news.textileの最終的なまとめとリファレンス作成
 
-コミットIDをメモしていた場合、下記コマンドを実行してログを表示する。
+前回のリリース時から現在までの変更点をnews.textileにまとめるため、下記コマンドを実行してgitのコミットログを表示する。
 
 <pre>
 !!!command_line
-git log --reverse -p （前回のリリース時のバージョン）..（メモしていたコミットID）
+$ git log -p --reverse （前回のリリースバージョン)..
 </pre>
 
-ログを"Author:"で検索しながら、ユーザにとって知る必要があるもの（ユーザに見える情報）のコミットログのみを抜き出す。
+ログを"Author:"で検索しながら、ユーザにとって知る必要があるもののコミットログのみを抜き出す。
+
+ユーザにとって必要な情報とは、仕様の変更や新しい機能の追加など、ユーザーがリリースするライブラリを使う上で影響ある情報である。
+逆に、リファクタリング、テストの変更、変数名の変更など、ユーザーが直接意識しない部分については書く必要はない。
+
 次に、抜き出したコミットログを１つずつ見て、その先頭にカテゴリ名がある場合は、":"を削除してカテゴリ名を"["と"]"で囲む。
 カテゴリ名を除いたログの先頭にある単語を過去形にし、頭文字を大文字にする。
 その後、ログを次のように分類する。
-機能などに新しく追加されたものに関してはImprovement,
-動作の変更などはChanges,
-バグの修正など前バージョンまでにあった問題を修正したものはFixesに記述する。
-また、コミットログの行末に[人名]がある場合はその人名をThanks以下に書く。
+
+* Improvements: 機能などを新しく追加したコミットのログ
+* Changes: 動作の変更など、今まであったものを変更したログ
+* Fixes: バグの修正など前バージョンまでにあった問題を修正したログ
+
+また、コミットログの行末に[人名]がある場合は、Thanksという分類を作って、その人名をThanks以下に書く。
 さらにREADMEにあるThanks以下にも名前を追加する。
 
 下記コマンドを実行してja.poを更新する。
@@ -142,7 +183,7 @@ doc/reference/ja/file.news.htmlなどのja.poを編集した箇所が正しく
 
 h2. これまでの変更をpush
 
-ここまでに行った変更をcommitしてgit pushする。
+ここまでに行った変更をcommitしてpushする。
 
 h2. リリースバージョンのタグの作成とrubygems.orgへのパッケージのアップロード
 
@@ -153,29 +194,32 @@ h2. リリースバージョンのタグの作成とrubygems.orgへのパッケ
 $ rake release
 </pre>
 
-h2. rubyforgeにパッケージをアップロード
 
-下記コマンドを実行してアップロードする。
+h2. リファレンスをranguba.orgにアップロード
+
+次のコマンドを実行して、リファレンスをranguba.orgのリポジトリ内にコピーする。
 
 <pre>
 !!!command_line
-$ ruby1.8 -S rake release:rubyforge:upload
-$ ruby1.8 -S rake release:reference:publish
+$ rake reference:publication:generate
+$ rake release:references:upload
 </pre>
 
-rroonga以外の場合、index.html関連はrake release:html:publishでアップロードされないので、rroongaに移動してから下記コマンドを実行する。
+その後、 次のコマンドを実行してranguba.orgのリポジトリをcloneしたディレクトリに移動する。
 
 <pre>
-!!!command_line
-$ ruby1.9.1 -S rake release:html:publish
+$ cd /path/to/ranguba.org
 </pre>
 
+そして、コピーにより生じた変更をranguba.orgのリポジトリにpushする。
+ranguba.orgはGithub Pagesを使っているので、pushすると自動的にranguba.orgのサイトも更新される。
+
 h2. メーリングリストにリリースの周知
 
 メーリングリストにリリースした旨を書いたメールを流す。
 日本語の他、英語のメーリングリストにもリリースした旨を英語で書いたメールを流す。
 
-h3.日本語でのメールの具体例
+h3. 日本語でのメールの具体例
 
 <pre>
 吉原です。
@@ -304,16 +348,6 @@ yoshihara
 (yoshihara at clear-code.com)
 </pre>
 
-h2. rubyforgeのニュースを更新
-
-rroonga以外の場合、もとのディレクトリに戻る。
-下記コマンドを入力してrubyforgeの最新ニュースを更新する。
-
-<pre>
-!!!command_line
-$ rake releace:rubyforge:news:post
-</pre>
-
 h2. 次回リリース時のバージョン番号の設定
 
-rroongaはext/groonga/rb-grn.h、それ以外はlib/（パッケージ名）/version.rbにある、RB_GRN_MAJOR_VERSION,RB_GRN_MINOR_VERSION,RB_GRN_MICRO_VERSIONの値を次回リリース時のバージョンの値に変更する。
+rroongaはext/groonga/rb-grn.h、それ以外はlib/（パッケージ名）/version.rbにある、RB_GRN_MAJOR_VERSION,RB_GRN_MINOR_VERSION,RB_GRN_MICRO_VERSIONの値を次回リリース時のバージョンの値に変更し、コミットする。

data/lib/packnga/document-task.rb

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright (C) 2011-2012  Haruka Yoshihara <yoshihara@clear-code.com>
+# Copyright (C) 2011-2013  Haruka Yoshihara <yoshihara@clear-code.com>
 # Copyright (C) 2011  Kouhei Sutou <kou@clear-code.com>
 #
 # This library is free software; you can redistribute it and/or
@@ -117,10 +117,6 @@ module Packnga
       yield(@reference_task)
     end
 
-    def htaccess
-      @reference_task.htaccess
-    end
-
     private
     def define
       set_default_values

data/lib/packnga/reference-task.rb

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright (C) 2011-2012  Haruka Yoshihara <yoshihara@clear-code.com>
+# Copyright (C) 2011-2013  Haruka Yoshihara <yoshihara@clear-code.com>
 # Copyright (C) 2012  Kouhei Sutou <kou@clear-code.com>
 #
 # This library is free software; you can redistribute it and/or
@@ -91,11 +91,6 @@ module Packnga
       define_tasks
     end
 
-    # path of .htaccess.
-    def htaccess
-      html_reference_dir + ".htaccess"
-    end
-
     private
     def set_default_values
       @base_dir ||= Pathname.new("doc")
@@ -154,8 +149,8 @@ module Packnga
             po_file = "#{@po_dir}/#{language}.po"
 
             if File.exist?(po_file)
-              file po_file => @files do |t|
-                current_pot_file = "tmp.pot"
+              file po_file => @files do
+                current_pot_file = "#{@po_dir}/tmp.pot"
                 create_pot_file(current_pot_file)
                 GetText::Tools::MsgMerge.run(po_file, current_pot_file,
                                              "-o", po_file)
@@ -199,13 +194,22 @@ module Packnga
           po_file = "#{@po_dir}/#{language}.po"
           desc "Translates documents to #{language}."
           task language => [po_file, reference_base_dir, *@files] do
-            locale = YARD::I18n::Locale.new(language)
-            locale.load(@po_dir)
-            Dir.mktmpdir do |temp_dir|
-              create_translated_sources(temp_dir, locale)
-              copy_extra_files(temp_dir)
-              create_translated_documents(temp_dir, locale)
-            end
+            translate_doc_dir = "#{reference_base_dir}/#{language}"
+            rm_rf(translate_doc_dir)
+            yardoc = YARD::CLI::Yardoc.new
+            options = [
+              "--title", @spec.name,
+              "--po-dir", @po_dir,
+              "--locale", language,
+              "--charset", "utf-8",
+              "--no-private",
+              "--output-dir", translate_doc_dir
+            ]
+            options += ["--readme", @readme] if @readme
+            options += @source_files
+            options += ["-"]
+            options += @text_files
+            yardoc.run(*options)
           end
         end
       end
@@ -229,12 +233,10 @@ module Packnga
             raw_reference_dir = reference_base_dir + language.to_s
             prepared_reference_dir = html_reference_dir + language.to_s
             rm_rf(prepared_reference_dir.to_s)
-            head = erb_template("head.#{language}")
-            header = erb_template("header.#{language}")
-            footer = erb_template("footer.#{language}")
             raw_reference_dir.find do |path|
               relative_path = path.relative_path_from(raw_reference_dir)
-              prepared_path = prepared_reference_dir + relative_path
+              prepared_path = generate_prepared_path(prepared_reference_dir,
+                                                     relative_path)
               if path.directory?
                 mkdir_p(prepared_path.to_s)
               else
@@ -242,60 +244,78 @@ module Packnga
                 when /(?:file|method|class)_list\.html\z/
                   cp(path.to_s, prepared_path.to_s)
                 when /\.html\z/
-                  relative_dir_path = relative_path.dirname
-                  current_path = relative_dir_path + path.basename
-                  if current_path.basename.to_s == "index.html"
-                    current_path = current_path.dirname
-                  end
-                  top_path = html_base_dir.relative_path_from(prepared_path.dirname)
-                  package_path = top_path + @spec.name
-                  paths = {
-                    :top => top_path,
-                    :current => current_path,
-                    :package => package_path,
-                  }
-                  templates = {
-                    :head => head,
-                    :header => header,
-                    :footer => footer
-                  }
-                  content = apply_template(File.read(path.to_s),
-                                           paths,
-                                           templates,
-                                           language)
-                  File.open(prepared_path.to_s, "w") do |file|
-                    file.print(content)
-                  end
+                  create_published_file(path, relative_path, prepared_path,
+                                        language)
                 else
                   cp(path.to_s, prepared_path.to_s)
                 end
               end
             end
           end
-          File.open(htaccess, "w") do |file|
-            file.puts("RedirectMatch permanent ^/#{@spec.name}/$ " +
-                      "#{@spec.homepage}#{@spec.name}/en/")
-          end
         end
 
-        task :generate => ["reference:generate", "reference:publication:prepare"]
+        desc "Generates reference for publication."
+        task :generate => ["reference:generate",
+                           "reference:publication:prepare"]
+      end
+    end
+
+    def create_published_file(path, relative_path, prepared_path, language)
+      relative_dir_path = relative_path.dirname
+      if path.basename.to_s == "_index.html"
+        current_path = relative_dir_path + "alphabetical_index.html"
+      else
+        current_path = relative_dir_path + path.basename
+        if current_path.basename.to_s == "index.html"
+          current_path = current_path.dirname
+        end
+      end
+      top_path = html_base_dir.relative_path_from(prepared_path.dirname)
+      package_path = top_path + @spec.name
+      paths = {
+        :top     => top_path,
+        :current => current_path,
+        :package => package_path,
+      }
+      templates = {
+        :head   => erb_template("head.#{language}"),
+        :header => erb_template("header.#{language}"),
+        :footer => erb_template("footer.#{language}")
+      }
+      content = apply_templates(File.read(path.to_s),
+                                paths,
+                                templates,
+                                language)
+      content = content.gsub(/"(.*?)_index\.html"/,
+                             "\"\\1alphabetical_index.html\"")
+      File.open(prepared_path.to_s, "w") do |file|
+        file.print(content)
+      end
+    end
+
+    def generate_prepared_path(prepared_reference_dir, relative_path)
+      prepared_path = prepared_reference_dir + relative_path
+      if prepared_path.basename.to_s == "_index.html"
+        prepared_path.dirname + "alphabetical_index.html"
+      else
+        prepared_path
       end
     end
 
-    def apply_template(content, paths, templates, language)
-      content = content.sub(/lang="en"/, "lang=\"#{language}\"")
+    def apply_templates(content, paths, templates, language)
+      content = content.gsub(/lang="en"/, "lang=\"#{language}\"")
 
       title = nil
-      content = content.sub(/<title>(.+?)<\/title>/m) do
+      content = content.gsub(/<title>(.+?)<\/title>/m) do
         title = $1
         templates[:head].result(binding)
       end
 
-      content = content.sub(/<body(?:.*?)>/) do |body_start|
+      content = content.gsub(/<body(?:.*?)>/) do |body_start|
         "#{body_start}\n#{templates[:header].result(binding)}\n"
       end
 
-      content = content.sub(/<\/body/) do |body_end|
+      content = content.gsub(/<\/body/) do |body_end|
         "\n#{templates[:footer].result(binding)}\n#{body_end}"
       end
 
@@ -309,91 +329,5 @@ module Packnga
       erb.filename = file
       erb
     end
-
-    def create_translated_documents(output_dir, locale)
-      language = locale.name.to_s
-      translate_doc_dir = "#{reference_base_dir}/#{language}"
-      po_dir = File.expand_path(@po_dir)
-      mkdir_p(translate_doc_dir)
-
-      Dir.chdir(output_dir) do
-        YARD::Registry.clear
-        YARD.parse(@source_files)
-
-        options = [
-          "--title", @spec.name,
-          "-o", translate_doc_dir,
-          "--po-dir", po_dir,
-          "--locale", language,
-          "--charset", "utf-8",
-          "--no-private"
-        ]
-        options += ["--readme", @readme] if @readme
-        options += @source_files
-        options += ["-"]
-        options += @text_files
-
-        YARD::CLI::Yardoc.run(*options)
-      end
-      translated_files = File.join(output_dir, translate_doc_dir, "**")
-      FileUtils.cp_r(Dir.glob(translated_files), translate_doc_dir)
-    end
-
-    def create_translated_sources(output_dir, locale)
-      YARD.parse(@source_files)
-      create_translated_files(@source_files, output_dir) do |content|
-        code_objects = YARD::Registry.all
-        code_objects.each do |code_object|
-          original_docstring = code_object.docstring
-          content = translate_content_part(content,
-                                           original_docstring,
-                                           locale)
-
-          original_docstring.tags.each do |tag|
-            original_tag_text = tag.text
-            next if original_tag_text.nil?
-            content = translate_content_part(content,
-                                             original_tag_text,
-                                             locale)
-          end
-        end
-        content
-      end
-    end
-
-    def copy_extra_files(output_dir)
-      @extra_files.each do |file|
-        target_extra_file = File.join(output_dir, file)
-        FileUtils.mkdir_p(File.dirname(target_extra_file))
-        FileUtils.cp_r(file, target_extra_file)
-      end
-    end
-
-    def create_translated_files(original_files, output_dir)
-      original_files.each do |file|
-        translated_file = File.join(output_dir, file)
-        FileUtils.mkdir_p(File.dirname(translated_file))
-        content = File.read(file)
-
-        translated_text = yield(content)
-
-        File.open(translated_file, "w") do |file|
-          file.puts(translated_text)
-        end
-      end
-    end
-
-    def translate_content_part(content, original_text, locale)
-      translated_content = ""
-      text = YARD::I18n::Text.new(original_text)
-      translate_text = text.translate(locale)
-      original_text = original_text.each_line.collect do |line|
-        "(.+)#{Regexp.escape(line)}"
-      end
-      translate_text = translate_text.each_line.collect do |line|
-        "\\1#{line}"
-      end
-      content.sub(/#{original_text.join}/, translate_text.join)
-    end
   end
 end

data/lib/packnga/release-task.rb

@@ -50,11 +50,11 @@ module Packnga
 
     private
     def html_base_dir
-      @base_dir + "html"
+      File.join(@base_dir, "html")
     end
 
     def html_reference_dir
-      html_base_dir + @spec.name
+      File.join(html_base_dir, @spec.name)
     end
 
     def set_default_values
@@ -68,6 +68,7 @@ module Packnga
     def define_tasks
       namespace :release do
         define_info_task
+        define_reference_upload_task
         define_tag_task
       end
     end
@@ -76,35 +77,19 @@ module Packnga
       namespace :info do
         desc "Update version in index HTML."
         task :update do
-          old_version = ENV["OLD_VERSION"]
-          old_release_date = ENV["OLD_RELEASE_DATE"]
-          new_release_date = ENV["RELEASE_DATE"] || Time.now.strftime("%Y-%m-%d")
-          new_version = ENV["VERSION"]
-
-          empty_options = []
-          empty_options << "OLD_VERSION" if old_version.nil?
-          empty_options << "OLD_RELEASE_DATE" if old_release_date.nil?
-
-          unless empty_options.empty?
-            raise ArgumentError, "Specify option(s) of #{empty_options.join(", ")}."
-          end
           @index_html_dir = Pathname(@index_html_dir)
-          indexes = [@index_html_dir + "index.html", @index_html_dir + "ja/index.html"]
+          indexes = [
+            @index_html_dir + "index.html",
+            @index_html_dir + "ja/index.html"
+          ]
           indexes.each do |index|
             content = replaced_content = File.read(index)
-            [[old_version, new_version],
-             [old_release_date, new_release_date]].each do |old, new|
-              replaced_content = replaced_content.gsub(/#{Regexp.escape(old)}/, new)
-              if /\./ =~ old
-                old_underscore = old.gsub(/\./, '-')
-                new_underscore = new.gsub(/\./, '-')
-                replaced_content =
-                  replaced_content.gsub(/#{Regexp.escape(old_underscore)}/,
-                                        new_underscore)
-              end
+            package_infos.each do |key, (old, new)|
+              next if old == new
+              old_regexp = /#{Regexp.escape(old)}/
+              replaced_content = replaced_content.gsub(old_regexp, new)
             end
 
-            next if replaced_content == content
             File.open(index, "w") do |output|
               output.print(replaced_content)
             end
@@ -113,6 +98,36 @@ module Packnga
       end
     end
 
+    def package_infos
+      old_version = ENV["OLD_VERSION"]
+      old_release_date = ENV["OLD_RELEASE_DATE"]
+      new_release_date = ENV["RELEASE_DATE"] || Time.now.strftime("%Y-%m-%d")
+      new_version = ENV["VERSION"] || @spec.version.to_s
+
+      empty_options = []
+      empty_options << "OLD_VERSION" if old_version.nil?
+      empty_options << "OLD_RELEASE_DATE" if old_release_date.nil?
+      empty_options << "VERSION" if new_version.empty?
+
+      unless empty_options.empty?
+        raise ArgumentError, "Specify option(s) of #{empty_options.join(", ")}."
+      end
+
+      {
+        :version       => [old_version, new_version],
+        :release_date  => [old_release_date, new_release_date]
+      }
+    end
+
+    def define_reference_upload_task
+      namespace :references do
+        desc "Copy references to reference html directory."
+        task :upload do
+          cp_r(html_reference_dir, @index_html_dir)
+        end
+      end
+    end
+
     def define_tag_task
       desc "Tag the current revision."
       task :tag do

data/lib/packnga/version.rb

@@ -18,5 +18,5 @@
 
 module Packnga
   # Packnga version.
-  VERSION = "0.9.7"
+  VERSION = "0.9.8"
 end

data/packnga.gemspec

@@ -0,0 +1,75 @@
+# -*- coding: utf-8; mode: ruby -*-
+#
+# Copyright (C) 2012  Haruka Yoshihara <yoshihara@clear-code.com>
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License version 2.1 as published by the Free Software Foundation.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+base_dir = File.dirname(__FILE__)
+$LOAD_PATH.unshift(File.expand_path("lib", base_dir))
+require "packnga/version"
+
+version = Packnga::VERSION.dup
+
+readme_path = File.join(base_dir, "README.textile")
+entries = File.read(readme_path).split(/^h2\.\s(.*)$/)
+entry = lambda do |entry_title|
+  entries[entries.index(entry_title) + 1]
+end
+
+authors = []
+emails = []
+entry.call("Authors").each_line do |line|
+  if /\*\s*(.+)\s<([^<>]*)>$/ =~ line
+    authors << $1
+    emails << $2
+  end
+end
+
+clean_white_space = lambda do |entry|
+  entry.gsub(/(\A\n+|\n+\z)/, '') + "\n"
+end
+description = clean_white_space.call(entry.call("Description"))
+summary, description = description.split(/\n\n+/, 2)
+
+Gem::Specification.new do |spec|
+  spec.name = "packnga"
+  spec.version = version
+  spec.authors = authors
+  spec.email = emails
+  spec.summary = summary
+  spec.description = description
+
+  spec.extra_rdoc_files = ["README.textile"]
+  spec.files = ["README.textile", "Rakefile", "Gemfile", ".yardopts"]
+  spec.files += ["packnga.gemspec"]
+  Dir.chdir(base_dir) do
+    spec.files += Dir.glob("lib/**/*.rb")
+    spec.files += Dir.glob("doc/text/*.*")
+    spec.test_files = Dir.glob("test/**/*.rb")
+  end
+
+  spec.homepage = "http://ranguba.org/packnga/en/"
+  spec.licenses = ["LGPLv2"]
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency("rake")
+  spec.add_runtime_dependency("yard", ">= 0.8.6.1")
+  spec.add_runtime_dependency("gettext", ">= 2.3.6")
+  spec.add_development_dependency("test-unit")
+  spec.add_development_dependency("test-unit-notify")
+  spec.add_development_dependency("test-unit-rr")
+  spec.add_development_dependency("bundler")
+  spec.add_development_dependency("RedCloth")
+end
+

data/test/test-reference-task.rb

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright (C) 2012 Haruka Yoshihara <yoshihara@clear-code.com>
+# Copyright (C) 2013 Haruka Yoshihara <yoshihara@clear-code.com>
 #
 # This library is free software; you can redistribute it and/or
 # modify it under the terms of the GNU Lesser General Public
@@ -48,4 +48,41 @@ class ReferenceTaskTest < Test::Unit::TestCase
       Rake::Task["reference:po:update:ja"].invoke
     end
   end
+
+  def test_reference_publication_prepare
+    Dir.mktmpdir do |base_dir|
+      package_name = "packnga"
+      language = "en"
+
+      spec = Gem::Specification.new do |_spec|
+        _spec.name = package_name
+      end
+
+      Packnga::DocumentTask.new(spec) do |task|
+        task.translate_language = language
+        task.base_dir = base_dir
+      end
+
+      reference_dir = File.join(base_dir, "reference/#{language}")
+      fixtures_dir = File.join(File.dirname(__FILE__), "fixtures")
+      fixtures = Dir.glob(File.join(fixtures_dir, "{file.news,_index}.html"))
+
+      FileUtils.mkdir_p(reference_dir)
+      FileUtils.cp_r(fixtures, reference_dir)
+
+      Rake::Task["reference:publication:prepare"].invoke
+
+      html_dir = File.join(base_dir, "html/#{package_name}/#{language}")
+      Dir.chdir(html_dir) do
+        assert_true(File.exist?("file.news.html"))
+        assert_true(File.exist?("alphabetical_index.html"))
+        assert_false(File.exist?("_index.html"))
+
+        expected_file = File.join(fixtures_dir, "expected", "file.news.html")
+        expected_content = File.read(expected_file)
+        actual_content = File.read("file.news.html")
+        assert_equal(expected_content, actual_content)
+      end
+    end
+  end
 end

data/test/test-release-task.rb

@@ -0,0 +1,191 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2013 Haruka Yoshihara <yoshihara@clear-code.com>
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License version 2.1 as published by the Free Software Foundation.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+require "test/unit/rr"
+require "tmpdir"
+
+class ReleaseTaskTest < Test::Unit::TestCase
+  def teardown
+    Rake::Task.clear
+  end
+
+  class InfoUpdateTest < self
+    def test_none_version
+      Dir.mktmpdir do |base_dir|
+        index_dir = File.join(base_dir, "index_dir")
+
+        spec = Gem::Specification.new
+
+        Packnga::ReleaseTask.new(spec) do |task|
+          task.index_html_dir = index_dir
+          task.base_dir = base_dir
+        end
+
+        index = "1.0.0 2013-03-28"
+        index_file = File.join(index_dir, "index.html")
+        create_index_file(index_file, index)
+        ja_index_file = File.join(index_dir, "ja", "index.html")
+        create_index_file(ja_index_file, index)
+
+        package_infos = {
+          :old_version      => "1.0.0",
+          :old_release_date => "2013-03-28",
+          :new_release_date => "2013-04-01"
+        }
+        set_environments(package_infos)
+        assert_raise(ArgumentError) do
+          Rake::Task["release:info:update"].invoke
+        end
+      end
+    end
+
+    def test_version_in_spec
+      Dir.mktmpdir do |base_dir|
+        index_dir = File.join(base_dir, "index_dir")
+
+        spec = nil
+        Gem::Specification.new do |_spec|
+          spec = _spec
+          spec.version = "1.0.1"
+        end
+        Packnga::ReleaseTask.new(spec) do |task|
+          task.index_html_dir = index_dir
+          task.base_dir = base_dir
+        end
+
+        index = "1.0.0 2013-03-28"
+        index_file = File.join(index_dir, "index.html")
+        create_index_file(index_file, index)
+        ja_index_file = File.join(index_dir, "ja", "index.html")
+        create_index_file(ja_index_file, index)
+
+        package_infos = {
+          :old_version      => "1.0.0",
+          :old_release_date => "2013-03-28",
+          :new_release_date => "2013-04-01"
+        }
+        set_environments(package_infos)
+        Rake::Task["release:info:update"].invoke
+
+        expected_index = "1.0.1 2013-04-01"
+        assert_equal(expected_index, File.read(index_file))
+        assert_equal(expected_index, File.read(ja_index_file))
+      end
+    end
+
+    def test_version_in_env
+      Dir.mktmpdir do |base_dir|
+        index_dir = File.join(base_dir, "index_dir")
+
+        spec = Gem::Specification.new
+        Packnga::ReleaseTask.new(spec) do |task|
+          task.index_html_dir = index_dir
+          task.base_dir = base_dir
+        end
+
+        index = "1.0.0 2013-03-28"
+        index_file = File.join(index_dir, "index.html")
+        create_index_file(index_file, index)
+        ja_index_file = File.join(index_dir, "ja", "index.html")
+        create_index_file(ja_index_file, index)
+
+        package_infos = {
+          :old_version      => "1.0.0",
+          :new_version      => "1.0.1",
+          :old_release_date => "2013-03-28",
+          :new_release_date => "2013-04-01"
+        }
+        set_environments(package_infos)
+        Rake::Task["release:info:update"].invoke
+
+        expected_index = "1.0.1 2013-04-01"
+        assert_equal(expected_index, File.read(index_file))
+        assert_equal(expected_index, File.read(ja_index_file))
+      end
+    end
+
+    def test_same_versions
+      Dir.mktmpdir do |base_dir|
+        index_dir = File.join(base_dir, "index_dir")
+
+        Packnga::ReleaseTask.new(Gem::Specification.new) do |task|
+          task.index_html_dir = index_dir
+          task.base_dir = base_dir
+        end
+
+        index = "1.0.0 2013-03-28"
+        index_file = File.join(index_dir, "index.html")
+        create_index_file(index_file, index)
+        ja_index_file = File.join(index_dir, "ja", "index.html")
+        create_index_file(ja_index_file, index)
+
+        package_infos = {
+          :old_version      => "1.0.0",
+          :new_version      => "1.0.0",
+          :old_release_date => "2013-03-28",
+          :new_release_date => "2013-04-01"
+        }
+        set_environments(package_infos)
+
+        Rake::Task["release:info:update"].invoke
+        expected_index = "1.0.0 2013-04-01"
+        assert_equal(expected_index, File.read(index_file))
+        assert_equal(expected_index, File.read(ja_index_file))
+      end
+    end
+
+    private
+    def create_index_file(index_file, index)
+      FileUtils.mkdir_p(File.dirname(index_file))
+      File.open(index_file, "w") do |file|
+        file.print(index)
+      end
+    end
+
+    def set_environments(package_infos={})
+      ENV["OLD_VERSION"]      = package_infos[:old_version]
+      ENV["VERSION"]          = package_infos[:new_version]
+      ENV["OLD_RELEASE_DATE"] = package_infos[:old_release_date]
+      ENV["RELEASE_DATE"]     = package_infos[:new_release_date]
+    end
+  end
+
+  def test_upload_references
+    Dir.mktmpdir do |base_dir|
+      package_name = "packnga"
+      index_dir = File.join(base_dir, "index_dir")
+      reference_dir = File.join(base_dir, "html", package_name)
+      reference_filename = "file.html"
+
+      spec = Gem::Specification.new do |_spec|
+        _spec.name = package_name
+      end
+
+      Packnga::ReleaseTask.new(spec) do |task|
+        task.index_html_dir = index_dir
+        task.base_dir = base_dir
+      end
+
+      FileUtils.mkdir_p(reference_dir)
+      FileUtils.touch(File.join(reference_dir, reference_filename))
+
+      Rake::Task["release:references:upload"].invoke
+      uploaded_path = File.join(index_dir, reference_filename)
+      assert_true(File.exist?(uploaded_path))
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: packnga
 version: !ruby/object:Gem::Version
-  version: 0.9.7
+  version: 0.9.8
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-26 00:00:00.000000000 Z
+date: 2013-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -35,7 +35,7 @@ dependencies:
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.8.6.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -43,7 +43,7 @@ dependencies:
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.8.6.1
 - !ruby/object:Gem::Dependency
   name: gettext
   requirement: !ruby/object:Gem::Requirement
@@ -144,7 +144,7 @@ description: ! 'Packnga is a library to translate to many languages by YARD.
 
 '
 email:
-- yoshihara@clear-code.com
+- yshr04hrk@gmail.com
 - kou@clear-code.com
 executables: []
 extensions: []
@@ -154,20 +154,23 @@ files:
 - README.textile
 - Rakefile
 - Gemfile
-- lib/packnga/reference-task.rb
+- .yardopts
+- packnga.gemspec
 - lib/packnga/document-task.rb
-- lib/packnga/yard-task.rb
-- lib/packnga/version.rb
+- lib/packnga/reference-task.rb
 - lib/packnga/release-task.rb
+- lib/packnga/version.rb
+- lib/packnga/yard-task.rb
 - lib/packnga.rb
-- doc/text/tutorial.textile
-- doc/text/release.textile
 - doc/text/lgpl.txt
 - doc/text/news.textile
+- doc/text/release.textile
+- doc/text/tutorial.textile
 - test/run-test.rb
 - test/test-document-task.rb
 - test/test-reference-task.rb
-homepage: http://groonga.rubyforge.org/
+- test/test-release-task.rb
+homepage: http://ranguba.org/packnga/en/
 licenses:
 - LGPLv2
 post_install_message: 
@@ -182,7 +185,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -416471251229729484
+      hash: -2492821662086626858
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -191,7 +194,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -416471251229729484
+      hash: -2492821662086626858
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23
@@ -202,4 +205,5 @@ test_files:
 - test/run-test.rb
 - test/test-document-task.rb
 - test/test-reference-task.rb
+- test/test-release-task.rb
 has_rdoc: