d.hatena.mac
                            はてなダイアリー用マクロ
                                Ver 1.0.0 beta 3
                          秀丸 Ver.8 (8.02以上) 専用版

　これは、d.hatena.macのreadmeファイル<README.txt>です。

1. 概要説明
1-1. d.hatena.macってなに？
 　秀丸エディッタ用のマクロです。
 　秀丸で編集中の文章をはてなダイアリー(以下「はてダ」)に投稿したり、記事を取得したり、記事の編集や削除ができます。下書きへも同様の操作が行え、下書きから公開記事にすることもできます。
 　このマクロを使えば、凝った内容とかでなければ、ブラウザを使ってはてダサイト上で行うよりももっと簡単で素早く投稿や編集が行えると思います。
 　あ、もちろん対象は自身の(IDとパスワードを知っている)はてダだけです。記事の取得にもID・パスワードが必要です。

 　現在はベータバージョンです。このバージョンでの既知の不具合として、削除した記事が記事一覧メニューに表示され続けるというのがあり、原因調査中です(削除自体は正常にできます。また投稿や編集した記事については適切にメニューに反映されています)。

1-2. だれとく？
 　はてダの記事が長文で(文字ばっかりで)、何度も編集・投稿することが多い場合などには役に立てると思います。
 　また、秀丸で編集中の文章/プログラムソースを引用することが多いようなときや、記事の編集・推敲を秀丸でしたい場合にも便利にお使いいただけると思います。
 　なお、自称初心者の方の使用はお勧めしていません。

1-3. で、具体的な機能は？
 　はてダの日記・下書を取得、投稿、修正、削除、下書きの公開などです。IDやパスワードを入力して操作します。
 　投稿、修正を選ぶと、編集中の文章の先頭行をタイトルに、2行目以降を日記本文にして処理を進めます。
 　取得、修正、削除するときにメニューから対象となる記事を指定できます。
 　下書きの公開は、いったん当該の下書き記事を取得し、データ先頭の「draft」という文字列を「blog」に変更した後「修正」を選択したらできます。

1-4. それ以外の機能は？
 　文章の先頭に「date:日時」とだけ記載された行があれば、記載の日時付けの記事として投稿します。
 　文章の先頭に「blog:アカウント名」とだけ記載された行があれば、記載の"アカウント名"に対するはてダを操作します。"blog"ではなく"draft"となっていた場合は下書きに保存します。
 　その他、はてな記法やカテゴリ(タグ)を挿入する機能もあります。
 　詳細は配布ファイルに同梱の<d.hatena.mac.html>をご覧ください。

1-5. できそうでできない機能は何？
 　はてダのAtomPub(AtomAPI)でできないことはこのマクロでもほぼできません。APIできることは「はてダの日記・下書を参照、投稿、編集、削除、下書きの公開」なので、それ以外のことはあきらめてください。
 　はてな内自動リンクとかをもっと簡単にはれたらいいのですが、アイデアがないので保留です。
 (はてダの特定の記事へのリンクとかって結局ブラウザを開いてURIを確かめないとだめですよね。なんかそれって本末転倒というか、じゃあそのままブラウザではてダを書けばええやんって...。)

1-6. 雑多なこと
1-6-1. どこで手に入れることができるの？どこから手に入れたっけ？
 　後述する<2. 配布場所>をご覧ください。

1-6-2. 誰が作っているの？誰に連絡したらいいの？
 　後述する<6. コンタクト、サポート>をご覧ください。
 　なお、作者の知識の粋を尽くして作っているため、それ以上の事態になったら、サポートが十分にできない可能性があります。また、そのため、自称初心者の方の使用はお勧めしていません。

1-6-3. 私の環境でも使えますか？
 　後述する<4. 必要なもの>をご覧ください。<7. 謝辞、免責、ライセンス>もお読みください。

1-6-4. インストールやアンインストール、バージョンアップの方法は？
 　後述する<5. インストールとバージョンアップ、アンインストール>をご覧ください。

1-6-5. 使い方や設定方法は？
 　配布ファイルに同梱されている<d.hatena.mac.html>をご覧ください。

1-6-6. 改版履歴をみたいです。
 　どうしてもみたいのなら、配布ファイルに同梱されている<d.hatena.mac.history.txt>をご覧ください。
 　詳細な改版履歴を確認したい場合は、後述する<2. 配布場所>に記載のgithubサイトでgitレポジトリも公開しています。


2. 配布場所

 　以下のURLからダウンロードできます。
 http://hide.maruo.co.jp/lib/macro/d_hatena_mac.html
 　見つからない場合は、以下のURLから「hatena」などで検索してみてください。
 http://hide.maruo.co.jp/lib/macro/index.html

 　また、以下のURLからもダウンロードできます。
 http://github.com/taketori/d.hatena.mac/downloads
 　gitのリポジトリも公開しています。


3. 配布ファイルに同梱されているもの

(フォルダ構造)
│ README.txt                            「README」。このファイルです。
│ d.hatena.mac.html                     「マニュアル」。使い方や設定方法を記載しています。
│ d.hatena.mac.history.txt              「改版履歴」
│ d.hatena.mac                          「メインマクロ」
│ d.hatena.mac.makedata.mac             「データ生成マクロ」。
│                                         編集中の文章を投稿データとして生成します。
│ d.hatena.mac.xml                      「データひな形XML」
│                                         上記マクロで使われるデータのひな形。
│ d.hatena.mac.insnotations.mac.sample  「はてな記法入力マクロ」のサンプル。
│ d.hatena.mac.ini.sample               「.INI(動作設定を記載したファイル)」のサンプル。
│ d.hatena.mac.YourID.tags.list.sample  「カテゴリ補完用辞書ファイル」のサンプル。
│ d.hatena.mac.Settings.cs.sample       「IDパスワード設定ファイル」のサンプル。
└src
     d.hatena.mac.cs                     「本マクロ用実行ファイル ソース」
                                           メインマクロ実行時にcsc.exeを使ってコンパイルされ、
                                           生成された実行ファイルを用いて暗号化とかします。
     x10d.HidemaruMacro.Date2String.cs   「本マクロ用実行ファイル ライブラリDate2String」
     x10d.HidemaruMacro.GUI.cs           「本マクロ用実行ファイル ライブラリGUI」
     x10d.HidemaruMacro.IniIO.cs         「本マクロ用実行ファイル ライブラリIniIO」


4. 必要なもの

 　以下のような環境が必要です。他にもあるかもしれませんが、一般的なユーザなら多分大丈夫でしょう。

 ・秀丸エディッタ Ver 8.02以上が動作する。
 ・秀丸エディッタ同梱DLL・COM・cmd.exe・csc.exe(.NET Framework 1.1.4322以上)の 読み出し・実行ができ、編集中のファイル・はてなダイアリの読み出し・書き込みができ、本マクロのあるフォルダとその配下のフォルダにてファイルを作成・実行・書き込みできる 環境。

   .NET Framework は WindowsXP SP2以上ならほぼ確実にインストールされていると思います。

5. インストールとバージョンアップ、アンインストール

 1. インストールは他の秀丸エディッタ用のマクロと同様です。
  　配布ファイルに同梱の全てのファイルを、同じフォルダに(フォルダ構造を保ったまま)展開してください。

 2. 配布ファイルに同梱のd.hatena.mac.Settings.cs.sampleは、(コピーして)改名してファイル名末尾の".sample"を削除してください。
  　前「d.hatena.mac.Settings.cs.sample」→「d.hatena.mac.Settings.cs」

  　その他、必須ではありませんがおすすめする準備があります。詳細は同梱のマニュアル<d.hatena.mac.html>をご覧ください。

 ・使い方、設定方法は、同梱のマニュアルをご覧ください。

 ・バージョンアップ時の注意
 　メインマクロにIDなどを記載した場合は、マクロをインストールするたびに設定し直す必要があります。

 ・アンインストール時のお知らせ
 　レジストリには書き込んでいません。また、マクロと同じフォルダ以外にはファイルを作りません。


6. コンタクト、サポート
6-1. 不具合報告及び要望などでの連絡先

 　メールや掲示板でお問い合わせの際は、本マクロについてであることがわかるように、題名にマクロ名を併記してください。

 ・twitter
   http://www.twitter.com/x10d/

 ・メール
   src＠x10d.jp (＠を半角に変更してから送信してください。)

 ・掲示板: コミュニテックス「4. 公開マクロ サポート会議室（秀丸エディタ関連）」
   http://www.maruo.co.jp/turukame/4/index.html

 ・githubのレポジトリ
   http://github.com/taketori/d.hatena.mac/
   Issuesもどうぞ。

6-2. それ以外の内容で作者に連絡を取りたい場合は、以下の方法で。

 ・twitter
   http://www.twitter.com/x10d/

 ・メール
   taketori＠x10d.jp (＠を半角に変更してから送信してください。)


7. 謝辞、免責、ライセンス

 　特に以下の皆様に感謝申し上げます。
 ・秀丸及びその関連DLL、及び幾多の便利なマクロを作成し公開されている作者の皆様。
 ・Windowsや秀丸のマクロ、WSHおよびC#について調査し、情報をまとめ、公開されている皆様。
 ・このマクロをお使いいただき、フィードバックしていただいた皆様。

 　作者の知識の粋を尽くして作っているため、それ以上の事態になったら、サポートが十分にできない可能性があります。また、そのため、自称初心者の方の使用はお勧めしていません。
 　このマクロに関する一切の不都合について、作者はその責を負いません。
 　詳細は、次項を参照してください。

7-1. 免責、ライセンス条項

 著作権は、私 "たけとり"、"taketori"、及び "x10d.jp" が2010年から保有しています。
 ライセンスは、いわゆる「修正BSD」です。

 Copyright (c) 2010, たけとり
 All rights reserved.
 ソースコード形式かバイナリ形式か、変更するかしないかを問わず、以下の条件を満たす場合に限り、再頒布および使用が許可されます。

 ソースコードを再頒布する場合、上記の著作権表示、本条件一覧、および下記免責条項を含めること。
 バイナリ形式で再頒布する場合、頒布物に付属のドキュメント等の資料に、上記の著作権表示、本条件一覧、および下記免責条項を含めること。
 書面による特別の許可なしに、本ソフトウェアから派生した製品の宣伝または販売促進に、たけとり及びtaketori、並びにx10d、x10d.jp、及びエクステンド、エクステンド・ジャパンの名前またはコントリビューターの名前を使用してはならない。
 本ソフトウェアは、著作権者およびコントリビューターによって「現状のまま」提供されており、明示黙示を問わず、商業的な使用可能性、および特定の目的に対する適合性に関する暗黙の保証も含め、またそれに限定されない、いかなる保証もありません。著作権者もコントリビューターも、事由のいかんを問わず、 損害発生の原因いかんを問わず、かつ責任の根拠が契約であるか厳格責任であるか（過失その他の）不法行為であるかを問わず、仮にそのような損害が発生する可能性を知らされていたとしても、本ソフトウェアの使用によって発生した（代替品または代用サービスの調達、使用の喪失、データの喪失、利益の喪失、業務の中断も含め、またそれに限定されない）直接損害、間接損害、偶発的な損害、特別損害、懲罰的損害、または結果損害について、一切責任を負わないものとします。

EOF