カケラの樹 Logo HatenaStar.jsドキュメント日本語訳

はてなスターの埋め込み用スクリプトHatenaStar.jsに添付されたドキュメントの日本語訳です。

オリジナルは以下のURIを参照してください。

http://s.hatena.ne.jp/js/HatenaStar.js

  1. HatenaStar.js - あなたのブログをもっと楽しく!

  2. ブログのヘッダに次のように記述して使います。

    <script type="text/javascript" src="http://s.hatena.com/js/HatenaStar.js"></script>
    

    あなたのブログのURLにあなたのはてなIDを結びつけるには

    http://s.hatena.com/ 英語
    http://s.hatena.ne.jp/ 日本語

    IDを結びつけると、お気に入りユーザからのコメントを受け取ることが出来ます。

  3. BloggerやMovableTypeなどの標準的なブログサイトでは、上のscriptタグを埋め込むだけではてなスターを利用することが出来ます。

    HatenaStar.jsはブログが以下のような構造を持っていることを仮定して動作します。

    H3はエントリのヘッダを意味し、それぞれのエントリへのpermalinkを内包します。
    
    

    エントリのタイトル

    他の構造を持つブログでは、追加のスクリプトかJavaScriptコードを書く必要があります。

    1. <script type="text/javascript" src="http://s.hatena.com/js/Hatena/Star/EntryLoader/WordPress.js"></script>
      
    2. <script type="text/javascript">
      //他のHTML構造のためのカスタマイズ
      //この場合、H2タグがそれぞれのエントリのヘッダとなります
      Hatena.Star.EntryLoader.headerTagAndClassName = ['h2',null];
      </script>
      
    3. Hatena.Star.EntryLoader.loadEntries = function () {
          return [
              {
                  uri: 'http://your.blog/entry/123',
                  title: 'Hello Star!',
                  star_container: $('stars-123'),
                  comment_container: $('comments-123')
              },
              {
                  uri => 'http://your.blog/entry/456',
                  ...
              }
          ];
      }
      
  4. デフォルトの設定から、ページに合わせてカスタマイズを施すことが出来ます。

    //星の画像を変更します
    Hatena.Star.Star.ImgSrc = '/images/star.gif';
    
  5. 2007-07-12 v1.3 entry.jsonをentries.jsonに変更しパフォーマンス向上
    2007-07-11 v1.2 リリースバージョン
    2007-05-30 v1.1 星の折りたたみ機能を追加
    2007-03-29 v1.0 スクリーンをTen.SubWindowに変更、ドラッグアンドドロップが可能に
    2007-03-28 v0.9 Hatena.*クラスをTen v0.05.に変更
    2007-03-25 v0.8 Safariでのポップアップ問題を修正
    2007-03-22 v0.7 コメントボタンのアクティブ状態表示を追加
    2007-03-21 v0.6 コメント関数を追加
    2007-03-05 v0.5 URIのパスをRidge-basedに変更
    2007-01-24 v0.4 Hatena.Diary.Entryクラスを追加、Hatena.Star.Entryメソッドをクラスメソッドに変更、作者パラメータを追加
    2007-01-23 v0.3 Hatena.Star.Userクラス追加、Hatena.jsとHatena.Star.jsの互換性を追加
    2007-01-06 v0.2 名前空間を変更。Hatena.*, Hatena.Star.*を使うように。
    2007-01-05 v0.1 初期バージョン
  6. Copyright (C) Hatena Inc. All Rights Reserved.

    このライブラリはフリーソフトウェアです。あなたはPerlプログラミング言語と同じライセンスの下で再配布や改変を行うことが出来ます。

雨上がりの青空を探して。