Joplinポータブル版のセットアップ

## はじめに
### Joplinとは
Joplinはノートアプリ（メモとToDoアプリ）らしいです。
ノートアプリを探し求めてたどり着いたのではなく、

* Markdownで（気軽に）書けるエディタが欲しい
* mermaid（または PlantUML）でフローとかシーケンスとか描画できるものがいい

と探してたどり着いたアプリのため「らしいです」と書きました。

### なぜポータブル版か

環境制約上、
* 必要なファイルを集めた状態から始めればオフラインでもセットアップできる
* このフォルダをまるっと保存しておけば、他に移してもそのまま使える
※設定ファイルに対して思っていたことですが、まるっとにメモも含まれる結果に

というアプリの方が望ましかったためポータブル版です。

Joplinのセットアップは難しくないですが、自分が作業したときに

* ぱっと見だとポータブル版をどこから入手するかわかりづらいかも
* （公式含め）ポータブル版の情報あまりないかも

となったので記事として残すことにしました。

なお「オフラインでも」と書いていることから推察できると思いますが、
同期できない環境のため同期関連の設定については書いていません。


## 本体

### ポータブル版の入手

入手ページ：Joplin > Help > [Installation](https://joplinapp.org/help/install)

ポータブル版は、「GET IT ON Windows」ボタンからではなく、
表の下にある文中のリンクからダウンロードする。

![入手ページ](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/57789/d7b5b2bb-8c9a-5b49-d50d-d2ef1864459e.png)

### 本体のインストール

説明文に書かれているとおり。
ダウンロードしたexeファイルを実行すれば必要なものが作られて起動する。

> On Windows, you may also use the Portable version. The portable application allows installing the software on a portable device such as a USB key. Simply copy the file JoplinPortable.exe in any directory on that USB key ; the application will then create a directory called "JoplinProfile" next to the executable file.

1. ダウンロードした `JoplinPortable.exe` を任意の場所において実行する
2. `JoplinPortable.exe` と同じ場所に `JoplinProfile` フォルダが作られる
3. アプリが起動する

### インストール後フォルダ

Joplin フォルダに `JoplinPortable.exe` を配置して実行するとこんな感じ。
```
Joplin
 │   JoplinPortable.exe
 │
 └─ JoplinProfile
     │   database.sqlite
     │   log.txt
     │   settings.json
     │   window-state-prod.json
     │
     ├─ cache
     ├─ plugins
     ├─ resources
     └─ tmp
```

このフォルダごと（`JoplinPortable.exe` と `JoplinProfile` フォルダをセット）であれば、配置場所を変えても問題ない。（ポータブル版なので）

## プラグイン

参照ページ：Joplin > Help > Using Joplin > [Plugins](https://joplinapp.org/help/apps/plugins)


### プラグインの入手
> Plugins are hosted within the [Joplin plugins](https://github.com/joplin/plugins) repository. The application searches and installs plugins from this location but manual download and install of the .jpl files is also supported.

[Joplinプラグインリポジトリ](https://github.com/joplin/plugins)からインストールしたいプラグイン（`.jpl`ファイル）をダウンロードする。

### プラグインのインストール

> Alternatively to install a plugin manually pressing the Plugin tools "gear" button and select Install from file then select the downloaded .jpl file. Alternatively you can copy the .jpl to your profile's plugins directory directory ~/.config/joplin-desktop/plugins (This path might be different on your device - check at the top of the Options page in the Configuration screen). The plugin will be automatically loaded and executed when you restart the application. You may need to check Joplin is not minimising to the system tray/notification area rather than fully closing.

アプリのオプション画面で「ファイルからインストール」する方法と、プラグインフォルダにファイルを配置する方法がある。
後者の方が楽なので、後者を説明する。

1. Joplinが起動している場合は終了する
   ※デフォルトで、タスクトレイでバックグラウンド処理する設定のため、
   　タスクトレイからJoplinを終了すること
2. `JoplinProfile/plugins` フォルダにダウンロードしたプラグインファイルを配置する
```
Joplin
 │   JoplinPortable.exe
 │
 └─ JoplinProfile
     │   database.sqlite
     │   log.txt
     │   settings.json
     │   window-state-prod.json
     │
     ├─ cache
     ├─ plugins    ←--- ココ
     ├─ resources
     └─ tmp
```

### インストール後の確認・設定

プラグインファイル配置後、Joplinを起動するとプラグインがロードされる。
プラグインの確認・設定は、オプション画面から行う。

オプション画面は、`Ctrl + ,` （または、メニュー「ツール」 > オプション）で表示。

**【表示例】OutlineプラグインとPlantUML2プラグインをインストールした場合**

![オプション画面](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/57789/180fa486-e939-c68b-aafa-914f6ee8bd60.png)

* 赤枠：プラグイン管理画面を表示（表示されている画面）
* 青枠：各プラグインの設定画面を表示