Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/x-motemen/blogsync
Push and pull blog entries from/to local filesystem
https://github.com/x-motemen/blogsync
Last synced: 10 days ago
JSON representation
Push and pull blog entries from/to local filesystem
- Host: GitHub
- URL: https://github.com/x-motemen/blogsync
- Owner: x-motemen
- License: mit
- Created: 2014-12-22T04:10:10.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2023-11-25T17:13:27.000Z (12 months ago)
- Last Synced: 2024-05-09T20:59:24.399Z (6 months ago)
- Language: Go
- Homepage:
- Size: 306 KB
- Stars: 145
- Watchers: 6
- Forks: 27
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
blogsync
=======
[][actions]
[][license]
[](PkgGoDev)
[actions]: https://github.com/x-motemen/blogsync/actions?workflow=test
[coveralls]: https://coveralls.io/r/x-motemen/blogsync?branch=master
[license]: https://github.com/x-motemen/blogsync/blob/master/LICENSE
[PkgGoDev]: https://pkg.go.dev/github.com/x-motemen/blogsync
## Description
はてなBlog用のCLIクライアントです
## Installation
```console
% brew install Songmu/tap/blogsync
```
https://github.com/x-motemen/blogsync/releases から実行ファイルを直接取得できます。
ソースコードから最新版を使いたい場合は `go install github.com/x-motemen/blogsync@latest` してください。
## Usage
### Configuration
まず初めに設定ファイルを準備します。設定ファイルには以下の2種類があります。
- ローカル設定: `./blogsync.yaml`
- グローバル設定: `~/.config/blogsync/config.yaml`
両方存在する場合、設定の内容はマージされますが、ローカル設定の内容が優先されます。
設定ファイルの内容は以下のようなYAMLです。
```yaml
motemen.hatenablog.com:
username: motemen
password:
default:
local_root: /Users/motemen/Dropbox/Blog
```
各項目の意味は次のとおり:
- キー（例: `motemen.hatenablog.com` ）: ブログID (blogID)。はてなブログのダッシュボードからブログの設定画面などを開いたとき、URL に含まれる文字列です。技術的には AtomPub API における「ブログID」になります。独自ドメインを利用していない場合は配信ドメインと一致します。
- "default" という名前のキーは特別で、すべてのブログの項目のデフォルト値として扱われます。
- `.username`: そのブログに投稿するはてなユーザの ID。
- `.password`: そのブログに投稿するための API キー。はてなユーザのパスワードではありません。ブログの詳細設定画面 の「APIキー」で確認できます。
- `.local_root`: ブログのエントリを格納するパスのルート。
- `$local_root/$blogID/` 配下にエントリが格納されます。`omit_domain` 設定がされている場合はブログIDは含まれず、local\_root直下にエントリーが格納されます
- `.omit_domain`: ブログエントリを格納するパスにブログIDを含めません。
- `.owner`: 編集対象のブログオーナーが自身とは別のユーザーの場合、ブログオーナーを個別に設定できます。
#### ブログオーナーが自身とは別の場合の設定
複数人で編集するブログなどで、編集者とブログのオーナーが別ユーザーの場合は下記のように設定できます。
```yaml
example.hatenablog.com:
username: sample
password:
owner:
```
### エントリをダウンロードする（blogsync pull）
設定が完了したら、以下のコマンドを実行すると当該のブログに投稿しているエントリがその URL ローカルに保存されます。固定ページ機能を利用している場合、それもまとめてダウンロードされます。
```sh
% blogsync pull
```
この際保存されるファイルのパスは、エントリの URL ベースにしたものとなります。blogsync pull motemen.hatenablog.com した結果だとこんな感じになります（分かりやすいように少し省略しています）:
```
/Users/motemen/Dropbox/Blog/motemen.hatenablog.com/
└── entry
├── 2014
│ ├── 05
│ │ ├── 12
│ │ │ └── gulp,_TypeScript,_Browserify_で_Chrome_拡張を書く.md
│ │ └── 14
│ │ └── datetime-sh.md
│ ├── 06
│ │ ├── 01
│ │ │ └── introducing-ghq.md
│ │ ├── 03
│ │ │ └── git-hub-sync-repo-info.md
…
```
以降は blogsync pull すると、ブログエントリとローカルのファイルをつき合わせ、新しいエントリのみダウンロードされるようになります。
ちなみに、blogIDは省略可能で、省略した場合 `blogsync.yaml` に設定されているブログの内容がpullされます。
### ファイルのフォーマット
エントリのファイルはYAML Frontmatter形式のメタデータではじまり、そののち本文が続く、というフォーマットです:
```
---
Title: まだmechanizeで消耗してるの? WebDriverで銀行をスクレイピング（ProtractorとWebdriverIOを例に）
Category:
- scraping
Date: 2014-10-01T08:30:00+09:00
URL: http://motemen.hatenablog.com/entry/2014/10/01/scrape-by-protractor-webdriverio
EditURL: https://blog.hatena.ne.jp/motemen/motemen.hatenablog.com/atom/entry/8454420450066634133
---
今日はスクレイピングの話をします。…
```
今のところメタデータの内容は以下の6つ。
- Title: エントリのタイトル。
- Date: ブログに表示されるエントリの投稿日時。2006-01-02T15:04:05-07:00 といったフォーマットを期待しています。
- URL: エントリの URL。これは自動的に与えられ、書き換えても効果はありません。
- EditURL: エントリを一意に区別する URL。名前のとおり、AtomPub の編集用の URL です。
- Category: エントリーのカテゴリの配列
- Draft: この値が "yes" のとき、下書きとして扱われます。
### エントリを更新する（blogsync push）
ひとたびエントリをダウンロードしたら、そのファイルを編集することで記事を更新できます。
```sh
% blogsync push
```
例えばこんな感じですね:
```console
% blogsync push ~/Dropbox/blog/motemen.hatenablog.com/entry/2014/12/22/blogsync.md
GET ---> https://blog.hatena.ne.jp/motemen/motemen.hatenablog.com/atom/entry/8454420450077731341
200 <--- https://blog.hatena.ne.jp/motemen/motemen.hatenablog.com/atom/entry/8454420450077731341
PUT ---> https://blog.hatena.ne.jp/motemen/motemen.hatenablog.com/atom/entry/8454420450077731341
200 <--- https://blog.hatena.ne.jp/motemen/motemen.hatenablog.com/atom/entry/8454420450077731341
store /Users/motemen/Dropbox/blog/motemen.hatenablog.com/entry/2014/12/22/blogsync.md
```
ファイルがリモートの記事よりも新しくない場合は、更新リクエストは行われません。
基本的にはダウンロードしてきたファイルを更新する用途のコマンドですが、新しくファイルを配置してpushすることも可能です。
### エントリを投稿する（blogsync post）
まだはてなブログ側に存在しない記事を投稿する場合は、投稿用のコマンドで記事を投稿します。
```sh
% blogsync post <
```
blogsync post は標準入力からエントリの内容を受けとって投稿し、投稿されたエントリに対応するファイルをダウンロードします。その後は新しく作成されたファイルを編集し、push することでエントリの編集を続けられます。
このコマンドでは `--title=`、`--draft` という引数によって記事タイトルや下書き状態の指定を行えるのでこんな風に雑に、ターミナルから書き始めることもできます…
```console
% blogsync post --draft --title=blogsync motemen.hatenablog.com
さてかきはじめるか…
^D
```
### 特定のエントリを更新する (blogsync fetch)
エントリファイルを指定して、リモートの更新を取り込むことができます。
```sh
% blogsync fetch
```
### GitHub Actions
`uses: x-motemen/blogsync@v0` とすればblogsyncをインストールできます。
## Author
[motemen](https://github.com/motemen), [Songmu](https://github.com/Songmu)