Hatena blog tools
はてなブログの支援用拡張です。
コマンド
コマンド |
内容 |
extension.setting |
設定(TBD) |
extension.inserttemplate |
テンプレート挿入 |
extension.post |
記事をはてなブログに投稿 |
extension.uploadPhoto |
画像をfotolifeにアップロード |
extension.selectlinksetting |
URLをカード型表示に編集 |
extension.alllinksettings |
全URLのみ行をカード型表示に編集 |
extension.setting
TBD
extension.inserttemplate
開いているファイルの先頭に、下記の記事テンプレートを挿入します。
[title]
[category]
[datetime]
[url]
[overview]
[miniTitle]
[draft]
[context]
extension.post
開いているファイルを、設定したはてなブログへ投稿します。
テンプレートの使用有無や、投稿設定などについては、別途「記事テンプレート」や「設定の追加」をご参照ください。
extension.uploadPhoto | 画像をfotolifeにアップロード
画像のパスを本文に載せることで、はてなfotolifeへのアップロードを行い、その画像をimgタグで対象パス文字列と置換します。
本コマンドは、下記操作を行ってください。
- 動作するパターンの状態にする
- コマンド「extension.uploadPhoto」を実行する
- TitleとAltに設定する文字列を入力する(任意)
本コマンドは下記パターンのとき、動作します。
- 選択中の画像のパスの場合
- カーソル行が画像のパスのみの場合
TitleとAltに設定する文字列は、未入力の場合fotolifeにアップロードした画像URLがセットされます。
アップロード可能な画像について
はてなフォトライフの仕様により、下記条件のファイルがアップロード可能です。
項目 |
内容 |
形式 |
JPEG、GIF(アニメーションGIFを含む)、PNGのいずれか |
サイズ |
長辺が10,000px |
ファイルサイズ |
10MBまで |
extension.selectlinksetting | URLをカード型表示に編集
下記パターンのとき、URL文字列をはてなブログでカード型表示する記法に編集します。
- 選択中のテキストがURL文字列の場合
- カーソル行がURL文字列のみの場合
例:
対象文字列 : https://exsample.com
実行後文字列: [https://exsample.com:embed:cite]
extension.alllinksettings | 全URLのみ行をカード型表示に編集
extension.selectlinksettingの全テキスト自動サーチ版です。
全行の検索を行い、URLのみの行に対してextension.selectlinksettingと同様の処理を行います。
記事テンプレート
下記のようなファイルでポストを行なうことで、記事をポストすることができます。
[title]
[category]
[datetime]
[url]
[overview]
[miniTitle]
[draft]
[context]
各要素の対応
各要素はこのように対応しています。
タグ |
対応内容 |
備考 |
[title] |
タイトル |
|
[category] |
カテゴリ |
カンマ区切りで複数可能) |
[datetime] |
投稿日時 |
YYYY-MM-DD( hh:mm) |
[url] |
記事URL用メモ |
(*1) |
[overview] |
記事概要用メモ |
(*1)(*2) |
[miniTitle] |
高度なタイトル設定用メモ |
(*1),(*3) |
[draft] |
下書き設定 |
[true/yes]=下書き/[false/no]=そのまま投稿 |
[context] |
本文 |
本タグ以降、全て本文とみなします。 |
*1: API上対応していない為、手動セット用。
*2: 改行に対応していません。
*3: はてなブログのエディタ上2つありますが、1つしか記述できません。
設定の追加
setting.jsonに下記要素を追加してください。
"hatenablogtools.hatenablog": {
"userId": "<User ID>",
"apiKey": "<API Key>",
"blogId": "<Blog ID>"
},
"hatenablogtools.blogcontents": {
"draft": true,
"uploadTime": "8:00",
"contentOnly": false
},
"hatenablogtools.fotolife": {
"folder": "",
"imgLinkType": "html"
},
hatenablogtools.hatenablog
はてなとのやり取りを行なうための基本設定です。
キー |
設定する値 |
userId |
はてなのユーザID(ログインID) |
apiKey |
APIキー(ダッシュボードの詳細設定から取得) |
blogId |
対象ブログのブログID |
hatenablogtools.blogcontents
はてなブログのコンテンツのデフォルト値設定です。
はてなブログアップロード時に、これらが未入力の場合、この値が採用されます。
キー |
内容 |
フォーマット |
draft |
下書き設定 |
[true/yes]=下書き/[false/no]=そのまま投稿 |
uploadTime |
投稿時刻 |
h:m |
contentOnly |
テンプレートを使わず本文のみポスト |
[true/yes]/[false/no] |
contentOnly
テンプレートを使用して投稿する場合は、falseを設定します。
テンプレートを使用せずに投稿したい場合、trueを設定します。
contentOnly=trueの状態で、はてなブログへの投稿を実行した場合、下記のようなエントリーが作成されます。
項目 |
内容 |
タイトル |
日時 |
本文 |
投稿を行った本文 |
hatenablogtools.fotolife
はてなfotolifeの設定です。
キー |
設定する値 |
folder |
画像を格納するフォルダ(未設定の場合トップフォルダにアップロードされます) |
imgLinkType |
画像アップロード後のリンク形式 |
imgLinkType
はてなフォトライフへのアップロード(uploadPhoto)で、画像のアップロードが成功した場合、記事に挿入する画像リンクの形式です。
下記のいずれかから選択します。
選択項目 |
内容 |
html |
HTMLのimgタグを使用 |
markdown |
Markdown書式を使用 |
デフォルト設定または設定値が不正な場合、htmlが適用されます。