nDiki : API

サードパーティーアプリからは Medium のストーリーはポストしかできない

昨年10月にサインアップした Medium、何か書くのに良さそうなプラットフォームだとは思っているのですがまだ活用できてません。

Ulysses や iA Writer から直接下書きを投稿できるので、うまく使えないかとちょっと試してみました。しかし結局下書きを投稿できるに過ぎないんですよね。まあ Medium 側がポスト(ストーリー)について POST しか API を提供していないので仕方がない訳ですけれども。

Ulysses や iA Writer で Markdown 形式で書いて一度 Medium に上げた下書き(やそれを公開したもの)について、再度手元で修正して反映させることができません。

一度 Medium に送ってしまったら、あとは「手元の原稿と Medium 上の記事を同じように手で修正する」か「再度 Medium に新しい草稿として上げて Medium 上でまるっとコピー&ペーストする」とかしかないです。残念。

• https://medium.com/@Naney

初全ツイート履歴ダウンロード

自分の Tweet は API で取ってきておおむね nDiki の記事にまとめてあるのですが、使い始めの頃はそんなことをしていなかったので手元にデータとして取ってありませんでした。公式機能で全ツイート履歴ダウンロードができるのは知っていましたがそのうちと思いつつずっとやり忘れていたので、ようやく腰を上げて全ツイート履歴リクエストを設定からしてみたところ、ほどなくして準備完了のメールが届きました。

ダウンロードした ZIP ファイルの中をみると、予想していた通り人間用に HTML ファイルがありました。そしてそれ以外に CSV 形式ファイル・JSON 形式ファイルが含まれていてきちんと利用しやすい形になっていて良くできているなと感心してしまいました。良いですね。

きちんと README.txt をみてみたら HTML ファイル (index.html) は JSON 形式ファイルを読んで表示するページになってました。なるほど。API のレスポンス仕様と同じ JSON 形式をエクスポートデータにしているのですね。

GitHub Flavored Markdown ファイルの Web ブラウザでのプレビューに Grip を使う

「Markdown で書いているノートを Web ブラウザで見るのに MkDocs を使う」とつぶやいたら @bsdhack 氏が Grip を紹介してくれました。

私はgithubなどのmdファイル(https://t.co/nyoqRnjsN7)を読むために python製の grip 使って↓なスクリプトを書いて使ってます。

grip --export ${1:-README.md} - | w3m -T text/html

— Mitzyuki IMAIZUMI (@bsdhack) 2018年2月28日

さっそく試してみました。

 $pip2 install grip

でインストールしたら Markdown ファイルを指定して Grip を起動します。

 grip index.md

Grip が http://localhost:6419/ で Web サーバとして立ち上がるので Web ブラウザでアクセスすると index.md の HTML 変換されたものを見ることができます。なお

 grip -b index.md

とすれば起動と同時に Web ブラウザで開いてくれます。URL でパスを指定すればそのまま同じ/サブディレクトリにある Markdown ファイルもプレビューできるので、ハイパーリンク付けをしておくことでドキュメント群をブラウジングすることもできます。なるほどお手軽で便利。 GitHub 上とほぼ同様の見慣れたデザインになるのがいいですね。

そもそも Grip は「GitHub Readme Instant Preview」で GitHub 上での表示確認のためのツールで、 GitHub の REST API を使ってレンダリング結果を生成しているので当然といえば当然だったりはします。

ただそのかわり GitHub の API を使うので

• オフラインでは使えない(オフラインレンダリングは開発中)
• 外部サービスを使って変換させたくないドキュメントには使えない

と場合によっては不便な部分があります。なお後者については GitHub Enterprise があるなら Grip でそちらを指定するとう手もあります。

GitHub に push する前にチェックしたい時はもちろん、それ以外でさっと Web ブラウザで見てみたい時にも便利なツールですね。

• https://github.com/joeyespo/grip

今日のさえずり: 「和風カツ弁当」を「和風とは?」と思いつつ食べた

2018年05月10日

• 07:18 ブランジェ浅野屋@自由が丘のミックスベリーデニッシュ。デジタルハリネズミのマクロモード。 #トイデジ #デジタルハリネズミ https://t.co/BcyHuggY3V
• 08:00 髪が伸びるのを止める何か怪しげなものがあるんだと一瞬誤読。 https://twitter.com/...
• 09:48 2018年5月10日 朝の渋谷 https://t.co/VXC7md7S8W
• 12:15 2018年8月11日オープン。 / “複合スポーツエンターテインメント施設 スポル 品川大井町” http://bit.ly/2rwwZQo
• 12:33 「和風カツ弁当」を「和風とは?」と思いつつ食べた。鰹節がかかってた。
• 12:44 @otoyo0122 ソースをかけるとなんとなく洋食風ですね。
• 16:00 drop自由が丘店。白いペンキ。 #α6300 + #SEL20F28 https://t.co/Ibluyk8tOK
• 17:15 セブン-イレブンが入っているオフィスビルでの勤務になって、いつでも「寒天ゼリーカロリー0」を食べられるようになったの良いです。
• 17:53 わくわくする方を選べばいいと思うよ!
• 19:17 Remember The Milk の API に HTTP でアクセスすると HTTPS にリダイレクトされるようになったのかな。そのせいで rumember が動かなくなっていたのでアクセスする URL を変更したら直った。
• 21:30 そういえば最後に Windows をインストールしたのっていつだろう……。
• 22:00 お、目黒にもブランジェ浅野屋あるんだ。今度寄ってみよう。
• 24:23 ようやく、ようやく Day One Sync が復旧したっぽい。一部うまく同期できないエントリがあったので再編集して更新をかけたりそれぞれのデバイスで削除したりして同じになるようにした。
• 24:31 niconico にも不正ログインきているっぽい。 / “他社流出パスワードを用いた不正ログインについて(2018/05)” http://bit.ly/2ItySYE

2018年05月30日(水)の #nNote

2018年8月16日 廃止予定の Twitter API

User Streams API : GET user

• Resource URL: https://userstream.twitter.com/1.1/user.json
• API Reference

Site Streams API : GET site

• Resource URL: https://sitestream.twitter.com/1.1/site.json
• API Reference

2018年6月19日 廃止予定の Twitter API

POST direct_messages/new

https://api.twitter.com/1.1/direct_messages/new.json

GET direct_messages/show

https://api.twitter.com/1.1/direct_messages/show.json

GET direct_messages

https://api.twitter.com/1.1/direct_messages.json

GET direct_messages/sent

https://api.twitter.com/1.1/direct_messages/sent.json

POST direct_messages/destroy

https://api.twitter.com/1.1/direct_messages/destroy.json

JavaScript コードで TaskPaper ファイルにノートを挿入する

ちょっとしたメモを Alfred for Mac から一発で TaskPaper ファイルに挿入したい。Packal 上に TaskPaper のための多機能な Alfred Workflow があるので入れたんだけれど、うまくタスク追加ができないことがあるので、自前でスクリプトを作って Alfred から呼ぶことにした。

TaskPaper ファイルはテキストファイルなので書き慣れている Perl でスクリプトを書いてもいいんだけれど、 編集の競合が避けられるし parser も書かなくて済むしということで TaskPaper の API を使うことにした。

JavaScript for Automation (JXA) を使えば JavaScript コードで TaskPaper API を呼べるっぽい。

以下指定した TaskPaper ファイルに Inbox: プロジェクトがなければ追加した上でその子供としてノートを挿入するコード(エラー処理割愛。実際にはタイムスタンプとかもノートにつけるようにした)。

 #!/usr/bin/env osascript -l JavaScript

 function TaskPaperContext(editor, options) {
   let inbox = editor.outline.evaluateItemPath("//Inbox:")[0];
   if (!inbox) {
     inbox = editor.outline.createItem("Inbox:");
     let projects = editor.outline.evaluateItemPath('@type = project')
     if (projects.length == 0) {
         editor.outline.root.appendChildren(inbox)
     } else {
       editor.outline.root.insertChildrenBefore(inbox, projects[0]);
     }
   }

   let items = ItemSerializer.deserializeItems(options.text, editor.outline, ItemSerializer.TEXTMimeType)
   editor.setCollapsed(items[0])
   inbox.appendChildren(items, inbox.firstChild)
 }

 function run(argv) {
   Application('TaskPaper').open(argv[0]).evaluate({
     script:TaskPaperContext.toString(),
     withOptions: {text: argv[1]}
   })
 }

これを inbox.scpt というファイルで保存し実行権限を与えれば

 ./inbox.scpt $HOME/tmp/test.taskpaper こんにちはこんにちは!!

という感じで呼び出せるようになる。

あとは Alfred Workflow を作ってそこからこのスクリプトを実行すれば OK だ。

今日のさえずり: はやぶさといえば「手動サーチエンジンはやぶさ」

2019年02月22日

• 07:59 はやぶさといえば「手動サーチエンジンはやぶさ」 #はやぶさ2
• 09:49 平成31年2月22日 #朝の渋谷 222 DSC-RX0 #RX0 https://t.co/yn3AjA43te
• 12:30 RICOH GR III の発表来たかー(注文した)。
• 14:45 Product Advertising API 厳しい。「まず決めたのは、PA-APIとの決別でした。PA-APIは規約が厳しいことで有名で、懸念となっていました。」 / “カエレバ誕生秘話と最近の仕様変更、そして今後について” http://bit.ly/2T4EJJa
• 19:32 Alfred で ↑ ヒストリ出すやつ、確定実行しなかったやつも残ってるんだ!
• 20:38 「今日はハッピーフライデーだ」で通じた(すぐツッコまれたけど)。

Chrome の Picture-in-Picture Extension で Google Meet の動画を最前面に

Slack コール(ビデオ通話)では動画表示用の小さいウインドウが最前面で表示される。これを MacBook Pro 内蔵ディスプレイの上部中央、内蔵カメラの直下に配置すると自然とカメラの方に視線が行くようになる。 one-on-one ミーティングなど視線を大切にしたい時に便利だ。

一方最近使っているビデオ会議ツール Google Meet (旧 Google Hangouts Meet) は Google Chrome でアクセスして使う形(Mac)のため同じことができない(Meet を開いているウィンドウは Chrome の装飾がついて大きいし、特定の Chrome のウィンドウだけを最前面に置くこともできない)。

なんかいい方法ないかなと思っていたところ Picture-in-Picture Extension (by Google) という Google Chrome 拡張機能を発見。

• Picture-in-Picture Extension (by Google)

Google 公式の拡張機能だ。これを使うと Picture-in-Picture Web API に対応している YouTube などのサービスの動画部分をフローティングウインドウとして最前面に表示させることができる。Google Meet のビデオ会議ページで使ってみたところ、動画部分をフローティングさせられた。1対1で画面共有無しの場合はこれでいけるぞ。

Google ドライブで 拡張子 md の Markdown ファイルを全文検索できるように rclone でコピーする

拡張子 md の Markdown ファイルを「バックアップと同期」アプリで新規に同期したり、 Web 版の Google ドライブでアップロードしたりすると MIME タイプが text/markdown となり全文検索対象にならない。不便。

StackEdit は Google ドライブに送る時の MIME タイプを設定で text/plain を選べるようにすることで問題を回避しているようだ。

rclone で text/plain で Google ドライブにアップロードする

クラウドストレージ上のファイルを管理するためのコマンドラインプログラム rclone でアップロードするとどうだろうと思ってやってみたところ、ちょっと設定をいじれば拡張子 md の Markdown ファイルを text/plain で Google ドライブにアップロードできることがわかった。

• https://rclone.org/

rclone では Google Drive API で新しいファイルを作成する際に、rclone 側で MIME タイプを判定している。内部的には Go の mime パッケージを使っている。

• https://golang.org/pkg/mime/

このパッケージは UNIX 系の環境では mime.type ファイルがあれば参照するようになっていたので macOS Catalina にあった /etc/apache2/mime.type ファイルの text/plain 行に md を追加して試したところ、めでたく text/plain として Google ドライブにアップロードできた。全文検索対象になることも確認。

ちなみに「バックアップと同期」アプリは /etc/apache2/mime.type 変更の影響を受けなかった。

rclone での方法が分かったわけだけれど、実際のところ Markdown ファイルの Google ドライブとの同期や読み書きを rclone だけに限定するわけにもいかないな。引き続き拡張子 txt で管理するのが現実的のようだ。

Obsidian Sync 同期を導入

Obsidian Sync と Obsidian Publish を早期割引購入が2021年9月30日までとのアナウンスがあった。Obsidian Publish は2月に購入し便利に使って満足している。

Obsidian vault の同期は Dropbox で済ませてきたので Obsidian Sync は見送ってきたのだけれど、将来使いたくなった時に「早期割引で購入していればよかった」なったら悔しいので、検討の上購入しちゃうことにした。

$48/年。クレジットカード決済での換算レート112.711円で、支払い額は5,410円だ。

end-to-end encryption である

個人的なノートは信頼できそうなクラウドサービスとだけ同期したい。まだ信頼できるに至っていない場合は暗号化して同期したい。確認したら Obsidian Sync は end-to-end encryption とのことなのでクリア。

Obsidian for Android のための FolderSync Pro 同期をやめられる

Android デバイスで Obsidian を使うのに FolderSync Pro で同期をしてきたのだけれど、いろいろ気を使うことが多いのが不満だった。

• 同期にかかる時間を考慮する
  • vault 全体を同期すると時間がかかるので、よく変更するノートだけフォルダ分けして個別に同期
• 同期タイミングを考慮する
  • 定時同期
  • 自宅・オフィスの出入りのタイミングで同期 (Tasker 使用)
  • スマートフォンのロック解除で同期 (Tasker 使用)
  • 画面の状態オフで同期 (Tasker 使用)
  • 手動

と工夫してきたけれど、それでも競合の心配は尽きなかった。

Obsidian Sync だとアプリを起動したタイミングで同期 & 編集中にセミリアルタイムで同期される。デスクトップアプリと Android アプリの両方で同じノートを開いて一方で編集すると、何秒か置いて他方に反映されていく。ヘルプによれば約10秒毎にバージョン履歴が保存されるとのことだ。競合の心配が減るのが嬉しい。

Dropbox 等のクラウドストレージへの同期だと(多分大丈夫だと思うけれど) API 利用のリミットレートが気になってしまうけれど、 Obsidian 純正のサービスだとその心配をしなくてもいいというのもあるね。

Obsidian for Android と Obsidian for iOS 両方と同期できる

Obsidian for Android の同期の選択肢は Obsidian Sync かデバイスのローカルストレージと同期できるクラウドストレージ。一方 Obsidian for iOS は Obsidian Sync か iCloud Drive が選択肢。

併用したいとなった時には Obsidian Sync が必要になるんだよね。実際そこがネックで iPhone では Obsidian を使っていなかったんだけれど、 Obsidian Sync を買ったのでこれからは両方使えるようになった。そのうち iPhone でも使ってみようかな。

PC を使っている時は vault を開いておく必要があることに注意

Obsidian を起動して vault を開いていれば、ノートを iA Write で編集したりスクリプトで書き換えたりしても検知してちゃんと同期してくれる。良い。

一方 vault を開いていないと同期されない。うっかり開き忘れていて同期されてなかったというのはありそう。そこが Dropbox などと違うところなのでちょっと注意が必要だ。

年間 $48

早期割引とはいえ同期だけで $4 はなかなかいいお値段である。

• Obsidian Sync (eary bird): $48/年
• Obsidian Publish (eary bird): $96/年
• Obsidian commercial license: $50/年

これで合計 $194/年、110円/ドル計算だと 21,340円/年だ。ひえー。

[ サブスクリプションサービス ]