﻿--------------------------------------------------------------------------------
お気に入りプラグイン2
--------------------------------------------------------------------------------

● はじめに

	▼ 概要

		公式プラグイン「お気に入りプラグイン」を改造して若干の機能を追加したものです。

● 動作環境

	▼ 対応OS

		Windows 10 (1803) でしかテストしていませんが、開発環境である Delphi 10.3 のターゲットプラットフォームは、Windows 10、Windows 8.1、Windows 7（SP1+）、Windows Server 2016、Windows Server 2012 R2 だそうです。

	▼ Mery

	2.7.5 でしかテストしていませんが、元になった「お気に入りプラグイン」が、Mery 2.2.0 以降なので、たぶん同じと思われます。

● インストール

	アーカイブを適当なフォルダに解凍し「Plugins」フォルダに配置してください。
	(Meryを常駐している場合は終了させてください。)

	今まで「お気に入りプラグイン」を使用していた場合は Favorites\Favorites.txt を Favorites2\Favorites2.txt にコピーすると設定を引き継ぐことができます。

● アップデート

	解凍した中身をすべて上書きしてください。

● アンインストール

	レジストリは使用していません。
	Favorites2.dll を削除してください。
	設定ファイルは下記のフォルダに保存されていますので手動でフォルダごと削除してください。
	(ZIP版の Mery の場合は Favorites2.dll と同じフォルダにある Favorites2 フォルダです。)

	Windows 10, 8, 7, Vista
		C:\Users\xxxx\AppData\Roaming\Mery\Plugins\Favorites2

	Windows XP
		C:\Documents and Settings\xxxx\Application Data\Mery\Plugins\Favorites2

● 使い方

	プラグインを起動すると「お気に入りに追加」「お気に入りの整理」の2つのメニューが表示されます。
	「お気に入りに追加」をクリックすることで現在編集中のファイルが	お気に入りに追加されます。
	「お気に入りの整理」または、直接 Favorites2.txt を編集することでメニューの内容を変更することが可能です。

● Favorites2.txtの書き方

	▼「お気に入りプラグイン」と同様の機能

		下記の通りファイルのパスを記述します。
		「お気に入りに追加」をクリックすることで、このようなリストができます。

		C:\Mery\Mery.txt
		C:\Mery\Mery.his

		また以下のようにカテゴリによってサブメニューにすることもできます。

		親カテゴリ
		[TAB]子カテゴリ
		[TAB][TAB]C:\Mery\Mery.txt

		※[TAB]はキーボードのタブキーのことです。
		※ハイフン(-)のみを入力するとメニューの区切りとなります。

	▼ 追加された機能

		1. 階層を表す先頭の[TAB]に続く文字列を[TAB]で区切っておくと、この[TAB]の前をキャプションとしてメニューに表示し、[TAB]の後をファイルのパスとみなします。
		キャプションにはアンド記号(&)を使ってアクセラレータ文字が設定できます。

		メリー[TAB]C:\Mery\Mery.txt
		メリー(&M)[TAB]C:\Mery\Mery.txt

		2. フォルダを登録しておくと、エクスプローラー(または関連付けされたファイラ)でそのフォルダを開きます。
		末尾のパスデリミタ(\)はあってもなくても構いません。

		C:\Mery
		C:\Mery\

		3. [TAB]で区切って複数のファイル、フォルダを登録して、一度に開くことができます。
		この場合は、キャプションが必須です。

		メリー[TAB]C:\Mery\Mery.txt[TAB]C:\Mery\Mery.his

		4. http://、https://、mailto:、ftp://、file:// で始まる URL を登録しておくと、関連付けされたブラウザ、メーラー等で開きます。

		https://www.haijin-boys.com
		hogeさんにメール[TAB]mailto:hoge@example.jp

		5. shell: コマンドや、:: に続けて CLSID を登録しておくと、特殊フォルダやコントロールパネルを開きます。

		shell:Libraries
		マイ ドキュメント[TAB]::{450D8FBA-AD25-11D0-98A8-0800361B1103}
		既定のアプリ[TAB]shell:::{2559a1f7-21d7-11d4-bdaf-00c04f60b9f0}

		※どんなものが登録できるか、ここには書ききれないので「ファイル名を指定して実行 shell」とか「CLSID」とか検索してみてください。
		※::{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx} で開けなくても、shell:::{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx} とすると開ける場合があります。
		※Windows のバージョンによっては使えないものもあります。

		6. コマンドラインオプションをつけて開くことができます。

		10行20桁に移動<kbd>TAB</kbd>/l 10 /cl 20 C:\Mery\Mery.txt
		書き換え禁止に設定して開く<kbd>TAB</kbd>/r "C:\スペースのある フォルダ\Mery.txt"

		※パスにスペース( )を含む場合は引用符(")で囲んでください。

		7. Mery 以外のアプリケーションで開くこともできます。Mery に渡すファイル名と区別するため、頭にアスタリスク(*)をつけてください。

		*"C:\Users\xxxx\Documents\Meryの秘密 隠し設定完全解説.pdf"
		メモ帳でMery.iniを編集<kbd>TAB</kbd>*notepad %APPDATA%\Mery\Mery.ini

		※パスにスペース( )を含む場合は引用符(")で囲んでください。
		※ファイル名のみを登録すると、関連付けされたアプリケーションで開きます。
		※パスの通っていないアプリケーションはフルパスで指定してください。
		※パーセント記号(%)で挟んだ環境変数が使えます。
		※どんなものが登録できるかについては、「ファイル名を指定して実行」(<kbd>WIN</kbd> + <kbd>R</kbd> で出てくるもの) で試してみて、うまくいったら、頭に「*」付けて登録してみてください。参考:「ファイル名を指定して実行」を極める ( https://qiita.com/sta/items/4b70e6b130a1033dc2c5 )
		※「ファイル名を指定して実行」でうまくいっても、ダメな場合があります。

		8. お気に入りはリストの先頭に追加されますが、末尾に追加するようにもできます。

		Favorites2 フォルダに「Favorites2.ini」という名前の空ファイルを作っておくと、

		[File]
		Append=1

		という内容が書き込まれ、次からは末尾に追加するようになります。
		元の動作に戻したいときは、「Append=1」を「Append=0」に書き換えるか、または Favorites2.ini を削除してください。

● 著作権等

	▼ DelFusa Library, OpenFavoriteFile

		http://delfusa.main.jp/delfusafloor/opensource/first.shtml

		DelFusaタン、ありがとう! 決して悪事には使わないと誓うよw

	▼ mery-plugin-favorites

		https://github.com/haijinboys/mery-plugin-favorites

	▼ Google Noto Emoji

		License: Apache 2.0

● 免責

	本ソフトを使用して生じた損害等について、作者は責任を負いません。使用者の責任で本ソフトを使用してください。

● サポート

	ありません。
	このプラグインは Mery 公式のものではありませんので、公式プラグイン「お気に入りプラグイン」作者である Kuroさんへの問い合わせはしないで下さい。
	ご意見・ご要望などがあれば、Haijin Boys Online のフォーラム( https://www.haijin-boys.com/discussions )をお借りして、ご相談させていただければと思います。
	なお、本ソフトの最新版は、Mery Wiki のプラグインライブラリ( https://www.haijin-boys.com/wiki/%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%83%A9%E3%82%A4%E3%83%96%E3%83%A9%E3%83%AA )をお借りして公開させていただこうと思います。

● 更新履歴

	▼ 2018/10/21 (2.3.1-mkII)

		初版公開。

	▼ 2018/10/24 (2.3.1-mkIISR)

		フォルダを登録してエクスプローラーで開く機能と、複数ファイルを登録できる機能を追加。

	▼ 2018/10/27 (2.3.1-mkIITR)

		URL を登録してブラウザ等で開く機能と、特殊フォルダを登録できる機能を追加。

	▼ 2018/11/03 (2.3.1-mkIIFR)

		コマンドラインオプションをつけて開く機能と、外部のアプリケーションで開く機能を追加。

	▼ 2018/11/10 (2.3.1-mkIIMR)

		環境変数を展開する機能を追加。

	▼ 2019/05/24 (2.3.3-FH)

		本家の 2.3.3 をマージした（が、お気に入りプラグイン2に関係するのはバージョン番号のみw）。
		iniファイルで、リストの先頭に追加するか末尾に追加するかを指定できるようにした。
