2013-11-22T18:47:18の更新内容

works/tools/HatenaBlogTools/index.wiki.txt

current previous
1,23 1,19
 
${smdncms:title,はてなブログ用ツール}
${smdncms:title,はてなブログ用ツール}
 
${smdncms:keywords,はてなブログ,はてなブログAtomPub API}
${smdncms:keywords,はてなブログ,はてなブログAtomPub API}
 

        

        
~
[[はてなブログAtomPub API:http://developer.hatena.ne.jp/ja/documents/blog/apis/atom]]を使って[[はてなブログ:http://hatenablog.com/]]のカテゴリを一括変更したり記事をエクスポートするためのコマンドラインツール集です。
[[はてなブログAtomPub API:http://developer.hatena.ne.jp/ja/documents/blog/apis/atom]]を使って[[はてなブログ:http://hatenablog.com/]]の記事を編集するコマンドラインツール集です。
 

        

        
 
*ダウンロード
*ダウンロード
 
MIT X11ライセンスでのリリースとなります。 動作確認はUbuntu+Mono環境でのみ行なっています。 Windows+.NET Framework環境でも動作すると思いますが、未検証です。
MIT X11ライセンスでのリリースとなります。 動作確認はUbuntu+Mono環境でのみ行なっています。 Windows+.NET Framework環境でも動作すると思いますが、未検証です。
 

        

        
 
**最新版
**最新版
 
-パッケージ
-パッケージ
+
--${smdncms:distfilelink,HatenaBlogTools-1.01.zip,HatenaBlogTools version 1.01}
+
-ソースコード
+
--${smdncms:distfilelink,HatenaBlogTools-1.01.tar.bz2,HatenaBlogTools version 1.01}
+

          
+
**過去のバージョン
+
-パッケージ
 
--${smdncms:distfilelink,HatenaBlogTools-1.00.zip,HatenaBlogTools version 1.00}
--${smdncms:distfilelink,HatenaBlogTools-1.00.zip,HatenaBlogTools version 1.00}
 
-ソースコード
-ソースコード
 
--${smdncms:distfilelink,HatenaBlogTools-1.00.tar.bz2,HatenaBlogTools version 1.00}
--${smdncms:distfilelink,HatenaBlogTools-1.00.tar.bz2,HatenaBlogTools version 1.00}
 

        

        
-
//**過去のバージョン
-

          
 
#googleadunit
#googleadunit
 

        

        
 
*使い方
*使い方
37,6 33,8
 
&var{新カテゴリ};に何も指定しない場合、そのカテゴリは削除されます。 例えば``foo:``と指定すればカテゴリ[foo]は削除されます。
&var{新カテゴリ};に何も指定しない場合、そのカテゴリは削除されます。 例えば``foo:``と指定すればカテゴリ[foo]は削除されます。
 
:``-n``|オプション。 実際に変更は行わず、変更されるカテゴリの一覧を表示して終了します。 変更される記事の確認など動作テストの際に使います。
:``-n``|オプション。 実際に変更は行わず、変更されるカテゴリの一覧を表示して終了します。 変更される記事の確認など動作テストの際に使います。
 

        

        
-
%%&color(crimson){''注意''};:2013-11-18現在、このツールでカテゴリの変更・削除を行うと、変更対象のエントリに設定されている''カスタムURLとアイキャッチ画像がデフォルトの状態に戻されます''。 この問題は現在はてなに問い合わせ中です。%% 現在は修正されています。
-

          
 
#prompt(動作例){{
#prompt(動作例){{
 
$ mono ModifyCategory.exe -id hatena -blogid hatena.hatenablog.jp -apikey xxxxxx テスト:test
$ mono ModifyCategory.exe -id hatena -blogid hatena.hatenablog.jp -apikey xxxxxx テスト:test
 
以下のカテゴリを変更します
以下のカテゴリを変更します
62,42 60,21
 
変更を元に戻す機能はありません。 変更対象の記事が多い場合は、カテゴリを1つずつ確認しながら変更する、事前にサブブログを使って動作テストすることをおすすめします。
変更を元に戻す機能はありません。 変更対象の記事が多い場合は、カテゴリを1つずつ確認しながら変更する、事前にサブブログを使って動作テストすることをおすすめします。
 

        

        
 
**DumpAllEntries.exe
**DumpAllEntries.exe
~
すべてのブロク記事をダンプするツールです。 はてなブログからのエクスポートなどに使うことができます。
すべてのブロク記事をAtomフィード形式でダンプするツールです。 エクスポートなどに使うことができますが、記事ごとの設定がダンプされないほか、ダンプしたものを書き戻す機能もないのでバックアップ用途には使えません。
 

        

        
 
#prompt(使用例){{
#prompt(使用例){{
~
DumpAllEntries.exe -id hatena -blogid hatena.hatenablog.jp -apikey xxxxxx -format mt 出力ファイル名
DumpAllEntries.exe -id hatena -blogid hatena.hatenablog.jp -apikey xxxxxx 出力ファイル名
 
}}
}}
 

        

        
 
:``-id &var{はてなID};``|必須。 はてなのユーザーIDを指定してください。
:``-id &var{はてなID};``|必須。 はてなのユーザーIDを指定してください。
~
:``-blogid &var{ブログID};``|必須。 記事をダンプするはてなブログのドメインを指定してください。
:``-blogid &var{ブログID};``|必須。 編集するはてなブログのドメインを指定してください。
 
:``-apikey &var{APIキー};``|必須。 [[ブログの詳細設定:http://blog.hatena.ne.jp/my/config/detail]]に記載されているAtomPubのAPIキーを指定してください。
:``-apikey &var{APIキー};``|必須。 [[ブログの詳細設定:http://blog.hatena.ne.jp/my/config/detail]]に記載されているAtomPubのAPIキーを指定してください。
~
:``-format &var{出力フォーマット};``|オプション。 ``mt``を指定するとMovable Type形式、``hatena``を指定するとはてなの日記データ形式で出力します。 省略した場合はAtomフィード形式で出力します。
:``&var{出力ファイル名};``|必須。 ダンプした結果を保存する際のファイル名を指定してください。 ``-``を指定した場合は標準出力に書き出します。
+
:``&var{出力ファイル名};``|オプション。 ダンプした結果を保存する際のファイル名を指定してください。 省略した場合、``-``を指定した場合は標準出力に書き出します。
+

          
+
このツールでは記事ごとの設定や記事に付けられたコメントはダンプされません(はてなブログAtomPubの仕様)。 そのため、このツールで出力された結果を再度インポートしても完全には記事を復元できないため、バックアップ用途に使うことはできません。
+

          
+
その他、フォーマット毎の制限事項は以下のとおりです。
+

          
+
-Movable Type形式の制限事項
+
--常にUTF-8で出力します。
+
--メタデータはAUTHOR, TITLE, STATUS, DATE, TAGSのみを出力します。
+
--カテゴリはすべてタグ(TAGS)として出力します。 PRIMARY CATEGORYおよびCATEGORYは出力しません。
+
--エントリ本文(BODY)にはオリジナル文面ではなく各種記法から変換されたHTML(hatena:formatted-content)を出力します。
+
--はてなブログ・はてなダイアリーにてインポートできることを確認しています。 それ以外のブログサービスでのインポート可能かどうかは未検証です。
+
-はてな日記データ形式の制限事項
+
--常にUTF-8で出力します。
+
--すべてはてな記法で記述されているものとして出力します。 Markdown形式・見たままモードで書かれている記事であってもインポートする際にははてな記法として扱われます。
+
--記事中で見出し記法(``*~~``)を使用していてもそのまま出力するため、インポートする際には個別の記事として扱われます。
+
--はてなグループにてインポート出来ることを確認しています。 それ以外のサービスでインポート可能かどうか未検証です。
 

        

        
 
*不具合・要望等
*不具合・要望等
 
不具合・要望等は[[掲示板>misc/forum/tools]]へどうぞ。
不具合・要望等は[[掲示板>misc/forum/tools]]へどうぞ。
 

        

        
 
*変更履歴 [#changes]
*変更履歴 [#changes]
+
**version 1.01 / 2013-11-22 [#changes_v1.01]
+
-DumpAllEntries.exe
+
--Movable Type形式・はてな日記データ形式でのダンプをサポート
+

          
 
**version 1.00 / 2013-11-18 [#changes_v1.00]
**version 1.00 / 2013-11-18 [#changes_v1.00]
 
-初版
-初版