tdiary 3.2.2.20130507

data/Procfile

@@ -0,0 +1 @@
+web: bundle exec thin start -p $PORT

data/README.md

@@ -0,0 +1,33 @@
+# tDiary
+
+[![Build Status](https://secure.travis-ci.org/tdiary/tdiary-core.png)](https://travis-ci.org/tdiary/tdiary-core) [![Coverage Status](https://coveralls.io/repos/tdiary/tdiary-core/badge.png?branch=master)](https://coveralls.io/r/tdiary/tdiary-core) [![Dependency Status](https://gemnasium.com/tdiary/tdiary-core.png)](https://gemnasium.com/tdiary/tdiary-core) [![Code Climate](https://codeclimate.com/github/tdiary/tdiary-core.png)](https://codeclimate.com/github/tdiary/tdiary-core)
+
+## tDiary, The TSUKKOMI-able Weblog.
+
+At first, see doc/README-en.rd
+
+## tDiary, ツッコミ可能なWeb日記システム
+
+tDiaryはWeb日記(いわゆるブログ)を実現するオープンソースソフトウェアです。ブログサービスをレンタルするのではなく、自分でWeb日記を運用する人のためのツールです。
+
+tDiaryには以下のような特徴があります。
+
+### 長く日記を続けられます
+
+日記は大切な自分史です。安心して長く日記を書き続けられるように、tDiaryは最低でも25年間はプロジェクトを維持することを目標に開発を続けています。2011年現在で10周年になるので、あと15年間はtDiaryで日記を書き続けることができます。
+
+### レンタルサーバーユーザにやさしい
+
+必要なのはRuby(1.8.5ないしは1.9.2以降に対応)だけ。単独でCGIとして動作し、基本機能はデータベースや追加のライブラリを必要としません。
+
+### プラグインで拡張できます
+
+豊富なプラグインで、さまざまな機能を追加できます。ブログツールとして必要な機能はほとんどプラグインとして揃っています。
+
+### テーマで好きなデザインを選べます
+
+300種類を超えるデザイン・テーマを選べます。ユーザが作成したテーマを一堂に集めたテーマ・ギャラリーも見てください。
+
+### その他
+
+インストールにはドキュメント(doc/INSTALL.html)を参照して下さい。動作にはruby(1.8.5以降または1.9.2以降)と、CGIをサポートするWebサーバが必要ですが、通常のレンタルサーバーであればたいていはこの環境があるはずです。

data/Rakefile

@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+
+require 'tdiary/environment'
+require 'tdiary/tasks'
+
+require 'rake'
+require 'rake/clean'
+require 'bundler/gem_tasks' if File.exists?('tdiary.gemspec')
+
+CLEAN.include(
+	"tmp",
+	"data",
+	"index.rdf"
+)
+CLOBBER.include(
+	"rdoc",
+	"coverage"
+)
+
+# Local Variables:
+# mode: ruby
+# indent-tabs-mode: t
+# tab-width: 3
+# ruby-indent-level: 3
+# End:
+# vim: ts=3

data/bin/tdiary

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+lib = File.expand_path('../../', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'tdiary/cli'
+
+TDiary::CLI.start

data/config.ru

@@ -0,0 +1,61 @@
+$:.unshift( File::dirname( __FILE__ ).untaint )
+require 'tdiary/environment'
+require 'tdiary'
+require 'tdiary/rack/html_anchor'
+require 'tdiary/rack/valid_request_path'
+require 'tdiary/rack/auth/basic'
+require 'omniauth'
+require 'tdiary/rack/auth/omniauth'
+
+use Rack::Reloader unless ENV['RACK_ENV'] == 'production'
+
+base_dir = ''
+
+# OmniAuth settings
+use Rack::Session::Pool, :expire_after => 2592000
+use OmniAuth::Builder do
+	configure {|conf| conf.path_prefix = "#{base_dir}/auth" }
+	# provider :twitter, ENV['TWITTER_KEY'], ENV['TWITTER_SECRET']
+	# provider :github, ENV['GITHUB_KEY'], ENV['GITHUB_SECRET']
+end
+map "#{base_dir}/auth" do
+	run TDiary::Rack::Auth::OmniAuth::CallbackHandler.new
+end
+
+map "#{base_dir}/update.rb" do
+	# Basic Auth
+	use TDiary::Rack::Auth::Basic, '.htpasswd'
+
+	# OAuth
+	# use TDiary::Rack::Auth::OmniAuth, :twitter do |auth|
+	#		auth.info.nickname == 'your_twitter_screen_name'
+	# end
+
+	run TDiary::Application.new(:update)
+end
+
+map "#{base_dir}/assets" do
+	environment = Sprockets::Environment.new
+	%w(js theme).each {|path| environment.append_path File.join(TDiary.root, path) }
+
+	# if you need to auto compilation for CoffeeScript
+	# require 'tdiary/rack/assets/precompile'
+	# use TDiary::Rack::Assets::Precompile, environment
+
+	run environment
+end
+
+map "#{base_dir}/" do
+	use TDiary::Rack::HtmlAnchor
+	run Rack::Cascade.new([
+		Rack::File.new("./public/"),
+		TDiary::Rack::ValidRequestPath.new(TDiary::Application.new(:index))
+	])
+end
+
+# Local Variables:
+# mode: ruby
+# indent-tabs-mode: t
+# tab-width: 3
+# ruby-indent-level: 3
+# End:

data/data/.htaccess

@@ -0,0 +1,2 @@
+Order allow,deny
+Deny from all

data/doc/HOWTO-authenticate-in-rack.md

@@ -0,0 +1,89 @@
+How to authenticate in rack
+===========================
+
+概要
+----
+
+tDiaryをCGI/FastCGI環境で動かす場合は、WebサーバのBasic認証機能を使って認証を実現しています。一方、Rack環境で動かす場合には、Rackミドルウェアにて認証を実現します。ここでは、Rack環境での認証の導入方法を説明します。
+
+認証方法
+----
+
+Rack環境では、以下の認証方法が利用できます。
+
+  - Basic認証
+  - 外部サービス認証
+
+Basic認証はCGI/FastCGI環境と同様に、 `.htpasswd` ファイルによる認証を提供します。外部サービス認証はOpenIDやOAuthなどの仕組みを使って、TwitterやGitHubなどの外部のサービスによる認証を提供します。
+
+Basic認証の使い方
+----
+
+Basic認証では、パスワードを2つの方法で格納できます。通常はパスワードがハッシュ化されて保存される1の方法を利用してください。
+
+  1. IDとパスワードを格納する.htpasswdファイルを作成する
+  2. 設定ファイル (config.ru) にIDとパスワードを記述する
+
+htpasswdコマンドを使って`.htpasswd`ファイルを作成します。
+
+```
+htpasswd -cd .htpasswd username
+```
+
+-cオプションはファイルの新規作成、-dオプションは暗号化にCRYPT方式を利用します。現時点ではCRYPT方式にのみ対応しており、MD5やSHA1方式には対応していないため、必ず-dオプションを指定してください。
+
+外部サービス認証
+----
+
+外部サービス認証は、[OmniAuth](https://github.com/intridea/omniauth)という認証フレームワークを利用して実現しています。設定方法は、利用する外部サービスによって若干異なります。 ここでは、Twitter認証を利用する場合を例にとって説明します。
+
+### ライブラリを有効にする
+
+まず、利用する外部サービスに対応したライブラリを有効にします。Twitter認証では `omniauth-twitter` ライブラリを使用します。Gemfileにて以下の行が有効になっていることを確認してください。無ければ追加してください。
+
+```
+gem 'omniauth'
+gem 'omniauth-twitter'
+```
+
+次に設定ファイル `config.ru` を編集します。 `use OmniAuth::Builder` ブロック内の `provier :twitter` で始まる行を有効にします。
+
+```
+# OmniAuth settings
+use Rack::Session::Pool, :expire_after => 2592000
+use OmniAuth::Builder do
+	configure {|conf| conf.path_prefix = "#{base_dir}/auth" }
+	provider :twitter, ENV['TWITTER_KEY'], ENV['TWITTER_SECRET']
+end
+```
+
+### 鍵とパスワードの取得と環境変数への設定
+
+設定ファイル `config.ru` に書かれているTWITTER_KEYとTWITTER_SECRETは、Twitter認証を利用するための鍵 (Consumer key) とパスワード (Consumer secret) です。これらは[Twitterのサイト](https://dev.twitter.com/apps/new)から取得できます。
+
+鍵とパスワードを取得したら環境変数に設定します。
+
+```
+export TWITTER_KEY="your_consumer_key"
+export TWITTER_SECRET="your_consumer_secret"
+```
+
+ここではbashの例を書きましたが、環境変数の設定方法は環境によって異なります。たとえばherokuの場合は `heroku config` コマンドを使用します。もし環境変数が設定できない環境であれば、 `config.ru` を直接書き換えてください。
+
+### 編集画面へのアクセスを許可するアカウントの設定
+
+日記の編集画面へのアクセスを許可するアカウントを設定します。 `config.ru` 内の `use TDiary::Rack::Auth::OmniAuth` で始まるブロックをコメントアウトしてください。
+
+```
+map "#{base_dir}/update.rb" do
+	# use TDiary::Rack::Auth::Basic, '.htpasswd'
+	use TDiary::Rack::Auth::OmniAuth, :twitter do |auth|
+		auth.info.nickname == 'your_twitter_screen_name'
+	end
+	run TDiary::Application.new(:update)
+end
+```
+
+`your_twitter_screen_name` にあなたのTwitterアカウント名を設定します。
+
+日記の編集画面にアクセスすると、Twitterのログイン画面が表示されるようになります。編集画面へは `your_twitter_screen_name` で指定したアカウントのみがアクセスできます。

data/doc/HOWTO-make-io.md

@@ -0,0 +1,305 @@
+IOクラスの作り方
+=========
+
+概要
+--
+
+tDiaryは、保存形式や日記記述フォーマットを差し替えることができます。 保存形式はIOクラスと呼ばれるTDiary::IOBaseクラスを継承したクラスを実 装することで変更可能です。また、記述フォーマットはDiaryBaseモジュー ルをincludeしたクラスで実装します。このドキュメントでは、これらの実 装に関する解説を行います。
+
+IOクラス
+-----
+
+保存形式を変更する新たなクラスを作成し、tdiary.confで指定することで、 tDiary独自の保存形式と違う、独自の保存形式を選択できます。例えばDBMS に日記データを保存する等、異なる運用のtDiaryを作ることが可能です。こ れを実現するための仕組みを総称して「IOクラス」と呼んでいます(RubyのIO クラスとは違います)。
+
+### IOBaseクラス
+
+tdiary.rbにはTDiary::IOBaseというクラスが定義されており、これを継承 して独自のIOクラスを作成します。下記の例は、HogeIOを定義しています。
+
+```
+class HogeIO < TDiary::IOBase
+   def calendar
+      .....
+   end
+
+   .....
+end
+```
+
+### 最低限実装すべきもの
+
+IOBaseクラスにはIOクラスに共通ないくつかのメソッドがすでに実装してあ ります。これを継承したIOクラスでは、さらに以下のようなメソッドを実装 しなくてはいけません。
+
+#### calendar
+tDiaryに、日記が存在する年月を通知するためのメソッドです。実行時にtDiary から呼び出されます。
+
+返り値には、現在利用できる日記が含まれている年・月を、Hashオブジェク トで返します。Hashに含まれている各値は、キーに西暦年(Stringで4文字)、 対応する値にはArrayで月(Stringで2桁)を設定します。以下に例を示します。
+
+```
+def calendar
+   return {
+      '2001' => ['12'],
+      '2002' => ['01', '02', '03', '04', '05', '08']
+   }
+end
+```
+
+#### transaction( date )
+指定された月の日記データを読み込み、tDiaryに理解できる形で渡します。
+
+引数dateはTimeオブジェクトで、年と月のみがlocaltimeで与えられます。
+
+transactionメソッドはdateで指定された月の日記データをファイル(または その他の媒体)から読み出して、ブロックパラメタとしてtDiaryに返します。 このブロックパラメタはHashで、キーに年月日(Stringで8桁)、値に日記デー タ(後述するDiaryBaseをincludeしたクラスのインスタンス)を持ちます。
+
+ブロックパラメタを受けとったtDiaryは、それを使って日記を表示または更 新するので、transactionメソッドはその返り値に従って日記を保存する等 の処理を行えます。以下にtDiaryからの返り値を示します。実際にはこれら の論理和が返ります。
+
+  - TDiary::TDiaryBase::DIRTY\_NONE: 日記データに変更はありませんでした
+  - TDiary::TDiaryBase::DIRTY\_DIARY: 日記本文に変更がありました
+  - TDiary::TDiaryBase::DIRTY\_COMMENT: ツッコミに変更がありました
+  - TDiary::TDiaryBase::DIRTY\_REFERER: リンク元に変更がありました
+
+以下にtransactionの例を示します。
+
+```
+def trasaction( date )
+   diaries = { ... }
+   # restore data
+   dirty = yield( diaries )
+   if dirty & TDiary::TDiaryBase::DIRTY_DIARY != 0
+      ...  # saving diary data
+   if dirty & TDiary::TDiaryBase::DIRTY_COMMENT != 0
+      ...  # saving comment data
+   if dirty & TDiary::TDiaryBase::DIRTY_REFERER != 0
+      ...  # saving referer data
+   end
+end
+```
+
+#### diary\_factory( date, title, body, style = 'tDiary' )
+diary\_factoryは、指定されたフォーマットの日記オブジェクトを生成して 返します。
+
+引数dateは日付(Stringで8桁)を指定します。title、bodyはそれぞれ生成す る日記のタイトルと本文です(String)。styleは日記の記述形式を指定する 文字列で、diary\_factoryに依存します。
+
+返り値はDiaryBaseをincludeした継承したクラスのオブジェクトです。
+
+以下にdiary\_factoryの例を示します。
+
+```
+def diary_factory( date, title, body, style = 'tDiary' )
+   case style
+      when 'tDiary' DefaultDiary::new( date, title, body )
+      default raise StandardError, 'bad style'
+   end
+end
+```
+
+もし、スタイルに対応したIOクラスを作るなら、initializeでload\_styleを 呼んだ上で、以下のようにstyled\_diary\_factoryを呼ぶだけで良いです。
+
+```
+def diary_factory( date, title, body, style = 'tDiary' )
+   styled_diary_factory( date, title, body, style )
+end
+```
+
+日記データ
+-----
+
+続いて、IOクラスのtransactionメソッドの返り値に含まれる日記データが 満たすべき条件について述べます。 日記データの具体例としては tdiary/tdiary\_style.rb で定義されている TDiary::DefaultDiary を参照してください。
+
+「日記データ」は以下の要素から構成されています。
+
+  - 日付
+  - タイトル
+  - 最終更新日
+  - 0個以上のセクション
+  - 0個以上のツッコミ
+  - 0個以上のリンク元
+
+さらに「セクション」は以下の要素から構成されています。
+
+  - サブタイトル
+  - 著者
+  - 本文
+
+日記のデータ構造がこれと完全に同一である必要はなく、日記データが付加 的なデータを持ったり、 セクションがいくつかのサブセクションに分かれたりしても良いです。
+
+カテゴリ機能について
+----------
+
+カテゴリ機能とは、日記中のセクションにキーワードを付けて、 あとで同じキーワードをまとめて一覧できる機能のことです。
+
+セクションのカテゴリは、サブタイトル中で指定します。 tDiaryスタイルでは
+
+```
+[カテゴリ] サブタイトル
+```
+
+のようにカテゴリを指定することにしていますが、 IOクラス/スタイル作者が各IOクラス/スタイルに適した カテゴリ指定の文法を定義して下さい。
+
+カテゴリ機能の実装は必須ではありません。 日記データをカテゴリ機能に対応させるかどうかはIOクラスの作者が判断して下さい。
+
+日記データのクラス
+---------
+
+日記データからはその日付、タイトル、最終更新日、日記本文、 コメント、Referer、セクションなどを参照できる必要があります。
+
+もし、この日記データをスタイルとして設計するのであれば、IOクラスとは 分離して、別のファイルにする必要があります。この場合、スタイル名と ファイル名、日記データクラス名には強い依存性があります。「Hoge」という スタイルを作る場合、以下のように作る必要があります。
+
+  - スタイル名: Hoge
+  - ファイル名: hoge\_style.rb
+  - クラス名　: TDiary::HogeDiary (スタイル名.capitalize + 'Diary')
+
+### DiaryBaseモジュール
+
+tdiary.rbにはDiaryBaseというモジュールが定義されており、 日記データのクラスはこのモジュールをincludeしなければなりません。
+
+下記の例はHogeDiaryにDiaryBaseをincludeしています。
+
+```
+class HogeDiary
+   include DiaryBase
+   .....
+end
+```
+
+### CategorizableDiary/UncategorizableDiaryモジュール
+
+tdiary.rbにはCategorizableDiaryとUncategorizableDiaryというモジュールが定義されています。 日記データのクラスは、カテゴリ機能に対応している場合はCategorizableDiaryモジュールを、 カテゴリ機能に対応していない場合はUncategorizableDiaryモジュールを includeしなければなりません。
+
+下記の例はHogeDiaryにCategoriabeleDiaryをincludeしています。
+
+```
+class HogeDiary
+   include CategorizableDiary
+   .....
+end
+```
+
+### 最低限実装すべきもの
+
+DiaryBaseモジュールには日記データのクラスに必要な幾つかのメソッドが 定義されています。DiaryBaseで定義されているメソッド以外に 日記データのクラスが備えるべきメソッドは下記のものになります。 (ここでいうメソッドは Public Instance Method のことです。)
+
+  - initialize
+  - replace
+  - append
+  - each\_section
+  - to\_html
+  - to\_src
+  - style
+
+メソッドではありませんが、 インスタンス変数の @last\_modified には気をつけましょう。 日記データに変更があった場合に @last\_modified に適切なTimeオブジェクトを設定しないと、 キャッシュの更新がうまくいきません。
+
+  - @last\_modified
+
+#### initialize
+日記データを初期化します。引数はIOクラスによって違うものになります。 このメソッドでは DiaryBase#init\_diary を呼ばなくてはなりません。
+
+例
+
+```
+class HogeDiary
+   include DiaryBase
+   .....
+   def initialize(date, title, body, modified = Time::now)
+      init_diary
+      .....
+   end
+   .....
+end
+```
+
+#### replace(date, title, body)
+日記データの日付をdateに、日記本文のソースをbodyに、タイトルをtitleに変更します。 dateはTimeオブジェクト、もしくは、日付をあらわす文字列('YYYYMMDD')です。 日付を表す文字列は具体的には下のようになります。
+
+  - '20020831'
+  - '20010101'
+
+body, titleは文字列です。
+
+日記本文が変更された場合、日記本文を解釈し直す必要があります。 解釈し直す時には日記データを構成するセクションも変更されます。
+
+#### append(body, author = nil)
+日記本文を追加します。bodyは追加される日記本文です。 authorは日記を記述した人の名前で、文字列です。 authorの引数はデフォルトでnilにしなければなりません。
+
+日記本文が変更された場合、日記本文を解釈し直す必要があります。 解釈し直す時には日記データを構成するセクションも変更されます。
+
+#### each\_section
+each\_section は各セクションをブロックパラメータとして返します。
+
+下に一例を示します。ここで@sectionsはセクションを保持するArrayのオブジェクトです。
+
+```
+class HogeDiary
+   .....
+   def each_section
+      @sections.each |section|
+         yield(section)
+      end
+   end
+   .....
+end
+```
+
+#### to\_html(opt, mode = :HTML)
+日記データをHTMLに変換します。引数optは設定ファイル(tdiary.conf)の内容の一部を 保持するHashオブジェクトです。引数modeはSymbolオブジェクトで、 現在は下記のいずれかです。
+
+  - :HTML
+  - :CHTML
+
+想定しないmodeが指定された場合は、:HTMLが指定されたものとみなして下 さい。:HTMLの場合は通常のブラウザ用にHTMLに、:CHTMLの場合は携帯端末 用にcHTMLに変換しなければなりません。
+
+optの内容によって、日記のリンク先を変更しなければならないので、注意 が必要です。
+
+カテゴリ機能に対応した日記データのクラスでは、 各セクションのサブタイトル中のカテゴリ指定をcategory\_anchorプラグインの呼出しに変換して下さい。
+
+#### to\_src
+日記の本文を返します。
+
+#### style
+日記データを記述するスタイル名を返します。 tDiary標準の記述形式の場合は「tDiary」です。 この文字列は、システム上は大小文字を区別しません。
+
+セクションのクラス
+---------
+
+日記本文は幾つかのセクションに分かれます。 セクションは日記本文、セクションのタイトル、セクションを書いた人の名前 などをデータとして保持しています。 セクションクラスの例としては、tdiary/defaultio.rbにある TDiary::DefaultSectionクラスを参照してください。
+
+### 最低限実装すべきメソッド
+
+以下にセクションのクラスが実装すべきメソッドを列挙します。
+
+  - subtitle
+  - body
+  - to\_src
+  - author
+  - subtitle\_to\_html
+  - body\_to\_html
+
+カテゴリ機能に対応させるには、以下のメソッドを実装する必要があります。
+
+  - stripped\_subtitle
+  - stripped\_subtitle\_to\_html
+  - categories
+
+#### subtitleとsubtitle\_to\_html
+セクションのタイトルを文字列として返します。 タイトルがない場合はnilを返します。
+
+subtitleはスタイルの文法で記述された本文を、subtitle\_to\_htmlはHTMLに変換後の本文を返します。
+
+#### bodyとbody\_to\_html
+セクションに対応する本文を返します。返り値の文字列にはタイトルも著者も含まれません。 本文がない場合は空文字("")を返します。
+
+bodyはスタイルの文法で記述された本文を、body\_to\_htmlはHTMLに変換後の本文を返します。
+
+#### to\_src
+セクションに対応する本文を返します。返り値の文字列にはタイトルと著者が含まれます。 本文がない場合は空文字("")を返します。
+
+#### author
+セクションを書いた人の名前を文字列として返します。 書いた人の名前がない場合は nil を返します。
+
+#### stripped\_subtitleとstripped\_subtitle\_to\_html
+セクションのタイトルからカテゴリ指定部分を取り除いた文字列を返します。 タイトルがない場合や、カテゴリ指定部分を取り除いた文字列が空文字("")の場合は nilを返します。
+
+stripped\_subtitleはスタイルの文法で記述された本文を、stripped\_subtitle\_to\_htmlはHTMLに変換後の本文を返します。
+
+#### categories
+セクションのカテゴリを文字列の配列として返します。 タイトル中にカテゴリ指定がない場合は[]を返します。
+