amakankan

amakankan は、amakan.net のためのブラウザ拡張です。

利用者用ドキュメント

インストールする

現状、Chrome ウェブストアや Mozilla Add-ons などには登録されておりません。そのため、以下のページより拡張のファイルをダウンロードしていただき、ご自身でブラウザにインストールをお願いします。

https://github.com/amakan/amakankan/releases

なお、Firefox の場合、署名を行っていない amakankan のような拡張は、通常の方法ではインストールできません（これは Firefox のアドオンのインストール画面でも説明される事項です）。 Firefox Developers Edition などの開発者用のバージョンを利用し、about:config にて xpinstall.signatures.required の値を false に変更していただく必要がありますので、ご注意ください。

amakan にログインする

読んだ本を一括登録するには、お使いのブラウザで https://amakan.net にログインしている必要があります。一括登録を行う前に、一度 https://amakan.net を開いていただき、ログインしているかどうかをお確かめください。

Amazon の商品ページから amakan の対応するページに移動する

Amazon の商品ページを開きます
ブラウザ拡張のボタンをクリックします

Amazon の購入履歴から読んだ本を一括登録する

Amazonの注文履歴ページを開きます
ブラウザ拡張のボタンをクリックします

ブクログの読書履歴から読んだ本を一括登録する

ブクログの自分の本棚のページを開きます
ブラウザ拡張のボタンをクリックします

読書メーターの読書履歴から読んだ本を一括登録する

読書メーターの自分の読んだ本のページを開きます
ブラウザ拡張のボタンをクリックします

TSUTAYA LOG の履歴ストックから読んだ本を一括登録する

TSUTAYA LOG の履歴ストックページを開きます
ブラウザ拡張のボタンをクリックします

amakan.net に移動する

上記以外のページを開きます
ブラウザ拡張のボタンをクリックします

開発者用ドキュメント

準備

このリポジトリは、Dockerを利用して開発することを想定しています。手元の環境でDockerを動かせるように準備を行ってください。

https://docs.docker.com/

watch

ファイルの変更を監視して継続的にビルドを行うには、以下のスクリプトを実行してください。

docker-compose up

build

1度だけビルドを行うには、以下のスクリプトを実行してください。

docker-compose run --rm node yarn run build

pack

拡張用のファイルを生成するには、以下のスクリプトを実行してください。

docker-compose run --rm node yarn run pack

analyze

Webpack の生成するファイルの容量を調べたい場合は、以下のスクリプトを実行してください。

docker-compose run --rm node yarn run analyze

Example output

yarn run v0.18.1
$ webpack --json | webpack-bundle-size-analyzer
moment: 120.56 KB (51.9%)
underscore: 51.67 KB (22.3%)
async: 14.01 KB (6.03%)
setimmediate: 6.32 KB (2.72%)
process: 5.17 KB (2.23%)
lodash: 5.12 KB (2.20%)
node-libs-browser: 1.33 KB (0.572%)
  timers-browserify: 1.33 KB (100%)
  <self>: 0 B (0.00%)
webpack: 1 KB (0.432%)
<self>: 26.95 KB (11.6%)
Done in 2.22s.

リリース

新しいバージョンをリリースする場合は、以下の手順に従ってください。

CHANGELOG.md を更新する
src/others/manifest-chrome.json のバージョンを更新する
src/others/manifest-filrefox.json のバージョンを更新する
Git の commit にタグを付ける (e.g. git tag v0.8.0)
Git のタグを push する (e.g. git push --tags)
GitHub の releases に拡張のファイルをアップロードする

niyari / amakankan