「プラグイン:EditorConfig」の版間の差分

提供: MeryWiki
ナビゲーションに移動 検索に移動
編集の要約なし
 
(同じ利用者による、間の28版が非表示)
1行目: 1行目:
__NOTOC__
== EditorConfig プラグイン ==
このページは現在執筆中です。


==EditorConfig プラグイン==
異なるエディターや開発環境でのコードの整形と一貫性を確保し、効率的なコーディング環境を提供する、[https://editorconfig.org/ EditorConfig] を Mery で利用できるプラグインです。
異なるエディタや開発環境の間でコーディングスタイルを維持することができる仕組み "[https://editorconfig.org/ EditorConfig]" を Mery から使用するためのプラグインです。


動作検証にご協力いただける場合、EditorConfig 対応のエディタ「Visual Studio」や「Notepad++」、「Sublime Text 3」などの動作と比較の上で仕様かどうかの判断をしていただけると検証にかかる手間が省けるので助かります。
[[ファイル:editor-config.png|border]]


<!--
 
<span class="plainlinks button">[http://download.haijin-boys.com/download/EditorConfig-2.3.3.zip EditorConfig プラグイン Ver 2.3.3 (32 ビット版)]</span>
<span class="plainlinks button">[https://www.haijin-boys.com/download/EditorConfig-x64-1.0.5.zip EditorConfig プラグイン v1.0.5 (64 ビット版)]</span>
<div class="smalltext">
<div class="smalltext">
*1,039,649 バイト 2018/10/13
*141,556 バイト 2026/03/22
*SHA256: [https://www.virustotal.com/ja/file/4945fbf634a6121c2903c9a6e438cdca1989d9e52c1d3385ff457b09e72fa93b/analysis/1539443773/ 4945fbf634a6121c2903c9a6e438cdca1989d9e52c1d3385ff457b09e72fa93b]
*SHA256: [https://www.virustotal.com/#/file/f46a1e1e9c9370966a019ae0a6c33964df3154af59548b9acbcc5ab3cca86665 f46a1e1e9c9370966a019ae0a6c33964df3154af59548b9acbcc5ab3cca86665]
*対応 OS: Windows 10, 8, 7 (32 ビット, 64 ビット)
*対応 OS: Windows 11, 10, 8, 7, Vista, XP (64 ビット)
*その他: Mery 2.8.7 以降
*その他: Mery 2.8.7 以降
</div>
</div>
 
<span class="plainlinks button">[https://www.haijin-boys.com/download/EditorConfig-1.0.5.zip EditorConfig プラグイン v1.0.5 (32 ビット版)]</span>
<span class="plainlinks button">[http://download.haijin-boys.com/download/EditorConfig-x64-2.3.3.zip EditorConfig プラグイン Ver 2.3.3 (64 ビット版)]</span>
<div class="smalltext">
<div class="smalltext">
*1,585,152 バイト 2018/10/13
*116,069 バイト 2026/03/22
*SHA256: [https://www.virustotal.com/ja/file/15fdd1065a426f8bc94c6c40bcea72b9b380878fbda7615d0fd09ffc7b713b1a/analysis/1539444111/ 15fdd1065a426f8bc94c6c40bcea72b9b380878fbda7615d0fd09ffc7b713b1a]
*SHA256: [https://www.virustotal.com/#/file/2bc71340717d1bfd51021a7ab64394a2c9d066a2b5c01da4a23ae86eb1606ea2 2bc71340717d1bfd51021a7ab64394a2c9d066a2b5c01da4a23ae86eb1606ea2]
*対応 OS: Windows 10, 8, 7 (64 ビット)
*対応 OS: Windows 11, 10, 8, 7, Vista, XP (32 ビット, 64 ビット)
*その他: Mery 2.8.7 以降
*その他: Mery 2.8.7 以降
</div>
</div>
-->


<htmlet>amazon</htmlet>
== 機能 ==
 
* コーディング スタイルの統一: プロジェクト内でコーディング スタイルを統一し、異なるエディターや開発環境でのコードの見た目やフォーマットを一貫させます。
* 改行コードの設定: ファイルごとに改行コード (CR+LF、LF、CR) を指定でき、異なるプラットフォーム間での改行コードの違いを解決します。
* エンコーディングの指定: ファイルのエンコーディング (UTF-8、UTF-16、Latin1 など) を設定でき、文字のエンコーディングに関する問題を回避します。
* インデント設定: インデント スタイル (スペースまたはタブ) とインデント幅を指定でき、コードの整形を一貫させます。
* 末尾の空白文字の削除: 行末にある余分な空白文字を自動的に削除し、コードの整理をサポートします。
* ファイルの末尾に改行を追加: ファイルの末尾に自動的に改行を追加または削除でき、異なるエディターとの互換性を向上させます。
* プロジェクトごとの設定: プロジェクトごとに異なる <code>.editorconfig</code> ファイルを使用し、プロジェクトごとに独自のコーディング スタイルと設定を適用できます。
 
== はじめに ==
 
'''動作環境'''
* Windows 11、10、8.1、8、7、Vista、XP をサポートしています。
* Mery Ver 2.8.7 以降をインストールしている必要があります。
 
'''アーカイブに含まれるファイル'''
* Plugins/EditorConfig.dll: プラグイン本体
* ThirdPartyNotices.txt: サードパーティ製コンポーネントのライセンス
* eula.rtf: ソフトウェア使用許諾書
* CHANGELOG.txt: 変更ログ
* README.txt: 本ドキュメント


[[ファイル:EditorConfig.png]]
== インストール ==


==使用方法==
# アーカイブを展開し、<code>EditorConfig.dll</code> を <code>Mery.exe</code> のインストール先の <code>Plugins</code> フォルダーにコピーしてください。
ダウンロードしたアーカイブを適当なフォルダに解凍し「Plugins」フォルダに配置してください。
# Mery を起動すると、[ツール] メニューの [プラグイン] にインストールしたプラグインの項目が追加されます。


プラグインを導入して Mery を起動すると自動的に EditorConfig が有効になります。
== アップデート ==


Mery の [ツール > プラグイン > EditorConfig] からプラグインの有効・無効を切り替えることもできます。
* アーカイブを展開し、<code>Plugins</code> フォルダーの内容を Mery の <code>Plugins</code> フォルダーに上書きしてください。
:[[ファイル:editor-config-1.png|border]]


EditorConfig プラグインを有効にした状態でファイルを開くと、.editorconfig に記述されているルールが反映されます。
== アンインストール ==


適用されている EditorConfig の設定を確認するためには EditorConfig プラグインを有効にした状態で [ツール > プラグイン > プラグインの設定] から [EditorConfig] を選択して [プロパティ] をクリックします。
* Mery の <code>Plugins</code> フォルダーからアンインストールしたいプラグイン (*.dll) を削除してください。
:[[ファイル:editor-config-2.png|border]]


:[[ファイル:editor-config-3.png|border]]
== 使い方 ==


EditorConfig の詳細は公式サイト (https://editorconfig.org/) をご参照ください。
# Mery を起動すると、自動的に EditorConfig が有効になります。
# [ツール] メニューから [プラグイン] の [EditorConfig] を選択してプラグインの有効/無効を切り替えることができます。
# EditorConfig プラグインを有効にした状態でファイルを開くと、<code>.editorconfig</code> に記述されたルールが適用されます。
# EditorConfig の設定が適用されているか確認するためには、EditorConfig プラグインを有効にした状態で、[ツール] メニューの [プラグイン] から [プラグインの設定] を選択し、[EditorConfig] の [プロパティ] をクリックします。


ここでは簡単に .editorconfig の書き方に触れておきます。
その他、EditorConfig の詳細については[https://editorconfig.org/ 公式サイト]をご参照ください。
<source lang="ini">
 
=== .editorconfig の記述方法 ===
 
ここでは <code>.editorconfig</code> の記述方法を簡単にご紹介します。
 
<syntaxhighlight lang="ini">
root = true
root = true


57行目: 80行目:
trim_trailing_whitespace = true
trim_trailing_whitespace = true
insert_final_newline = true
insert_final_newline = true
</source>
max_line_length = 80
 
me_user_defined_guides = 7,8,73
*'''root = true'''
</syntaxhighlight>
:セクションの外側に記述するプロパティです。EditorConfig は開こうとするファイルと同じ階層の .editorconfig から上の階層にさかのぼって .editorconfig を検索します。このプロパティを true に設定すると、現在の .editorconfig で検索を停止します。


*'''[*]'''
'''root = true'''
:セクション名は対象とするファイルのパスを指定します。この文字列はワイルドカードが使用できるようになっており、例えばテキストファイルのみを対象にする場合は [*.txt] のように記述します。使用可能なワイルドカードの文字列は https://editorconfig.org/#wildcards をご参照ください。
* セクションの外側に記述するプロパティです。EditorConfig は、開こうとするファイルと同じ階層の <code>.editorconfig</code> から上の階層にさかのぼって <code>.editorconfig</code> を検索します。
* このプロパティを true に設定すると、現在の <code>.editorconfig</code> で検索を停止します。


*'''indent_style = tab'''
'''[*]'''
:tabまたはspaceを記述して、インデントにそれぞれタブを使用するか半角空白を使用するかを設定します。Mery のオプションでは [タブの代わりに空白を挿入] に該当します。
* セクション名は、対象とするファイルのパスを指定します。
* この文字列には、ワイルドカードが使用できるようになっており、たとえば、テキストファイルのみを対象にする場合は [*.txt] のように記述します。
* 使用可能なワイルドカードの文字列については、https://editorconfig.org/#wildcards をご参照ください。


*'''indent_size = 4'''
'''indent_style = tab'''
:インデントに使用する桁数またはタブの幅を数値で記述します。indent_style が tab の場合でもこのプロパティがタブ幅として使用されます。Mery のオプションでは[タブの桁数] に該当します。EditorConfig の仕様では tab_width プロパティを使用すると indent_size とは別にタブの幅を設定できるようになっていますが、Mery はインデントがタブか半角空白にかかわらず [タブの桁数] は共通なので tab_width プロパティは使用しません。
* tab または space を指定して、インデントにタブを使用するか半角空白を使用するかを設定します。
* Mery のオプションでは、[タブの代わりに空白を挿入] に該当します。


*'''end_of_line = crlf'''
'''indent_size = 4'''
:lf, cr, crlf を記述して、改行コードを設定します。
* インデントに使用する桁数またはタブの幅を数値で指定します。
* indent_style が tab の場合でも、このプロパティがタブの幅として使用されます。
* Mery のオプションでは、[タブの桁数] に該当します。
* EditorConfig の仕様では、tab_width プロパティを使用すると、indent_size とは別にタブの幅を設定できるようになっていますが、Mery ではインデントがタブか半角空白にかかわらず、[タブの桁数] は共通なので、tab_width プロパティは使用しません。


*'''charset = utf-8'''
'''end_of_line = crlf'''
:latin1, utf-8, utf-8-bom, utf-16be, utf-16le を記述して、文字のエンコードを設定します。
* lf、cr、crlf を指定して、改行コードを設定します。


*'''trim_trailing_whitespace = true'''
'''charset = utf-8'''
:保存する前に改行文字の前にある空白文字を削除する場合は true を設定します。
* latin1、utf-8、utf-8-bom、utf-16be、utf-16le を指定して、文字のエンコードを設定します。


*'''insert_final_newline = true'''
'''trim_trailing_whitespace = true'''
:保存する前にファイルが改行で終了するようにするかどうかを記述します。このプロパティを記述するとファイルの最後にある改行を削除した後、true の場合は改行を付加、false の場合は改行を付加せずに保存します。ファイルの最後にある改行に手を加えたくない場合はこのプロパティ自体を記述しないようにするか unset を設定します。
* 保存する前に改行文字の前にある空白文字を削除する場合は true を設定します。


現在のところプロパティと値の大文字小文字は区別されないようです。
'''insert_final_newline = true'''
* 保存する前にファイルの末尾に改行を含むかどうかを指定します。
* このプロパティを指定すると、ファイルの末尾にある改行を削除した後、true の場合は改行を追加し、false の場合は追加しません。
* ファイルの末尾にある改行に手を加えたくない場合は、このプロパティ自体を指定しないか、unset を設定します。


プロパティ自体が記述されていない場合はエディタ側の設定が使用されます。
'''max_line_length = 80'''
* 1 行の最大文字数 (折り返し位置) を指定します。


値に unset を設定するとそのプロパティの効果を削除してエディタ側の設定を使用します。例えば indent_size = unset と記述すれば、indent_size のプロパティを未定義とし、エディタ側の設定が適用されます。
'''me_user_defined_guides = 7,8,73'''
* ユーザー定義ガイドの位置を指定します。
* 複数指定する場合は、カンマ区切りで記述します。


プロパティの詳細は https://editorconfig.org/#supported-properties をご参照ください。
== 注意事項 ==


==注意事項==
* プロパティ自体が記述されていない場合は、エディター側の設定が適用されます。
*.editorconfig ファイルはエンコードを UTF-8、改行コードを CR+LF または LF としてください
* 値に unset を設定すると、そのプロパティの効果が削除され、エディター側の設定が使用されます。
*.editorconfig が適用されるのは [ファイルを開いた時] と [ファイルを保存する前] です。ファイルを新規作成して [名前を付けて保存] した直後は適用されません
** たとえば、indent_size = unset と記述すれば、indent_size プロパティが未定義となり、エディター側の設定が適用されます。
*indent_style, indent_size はタブを半角空白に変換したりなど、文書を自動的に整形するための機能ではありません。
** プロパティの詳細については、https://editorconfig.org/#supported-properties を参照してください。
*[ツール > プラグイン > EditorConfig] からプラグインを無効にした場合でも既に開いているファイルの設定は維持されます。エディタ側の設定を適用するためには開いているファイルを閉じてから再度開く必要があります
* <code>.editorconfig</code> ファイルは、エンコードを UTF-8 とし、改行コードを CR+LF または LF に設定してください。
* <code>.editorconfig</code> が適用されるのは、[ファイルを開いた時] と [ファイルを保存する前] です。
* indent_style indent_size は、タブを半角空白に変換するなど、文書を自動的に整形するための機能ではありません。
* [ツール] メニューから [プラグイン] の [EditorConfig] を選択してプラグインを無効にした場合でも、既に開いているファイルの設定は保持されます。
* エディター側の設定を適用するためには、開いているファイルを閉じてから再度開く必要があります。

2026年3月22日 (日) 21:49時点における最新版

EditorConfig プラグイン

異なるエディターや開発環境でのコードの整形と一貫性を確保し、効率的なコーディング環境を提供する、EditorConfig を Mery で利用できるプラグインです。


EditorConfig プラグイン v1.0.5 (64 ビット版)

EditorConfig プラグイン v1.0.5 (32 ビット版)

機能

  • コーディング スタイルの統一: プロジェクト内でコーディング スタイルを統一し、異なるエディターや開発環境でのコードの見た目やフォーマットを一貫させます。
  • 改行コードの設定: ファイルごとに改行コード (CR+LF、LF、CR) を指定でき、異なるプラットフォーム間での改行コードの違いを解決します。
  • エンコーディングの指定: ファイルのエンコーディング (UTF-8、UTF-16、Latin1 など) を設定でき、文字のエンコーディングに関する問題を回避します。
  • インデント設定: インデント スタイル (スペースまたはタブ) とインデント幅を指定でき、コードの整形を一貫させます。
  • 末尾の空白文字の削除: 行末にある余分な空白文字を自動的に削除し、コードの整理をサポートします。
  • ファイルの末尾に改行を追加: ファイルの末尾に自動的に改行を追加または削除でき、異なるエディターとの互換性を向上させます。
  • プロジェクトごとの設定: プロジェクトごとに異なる .editorconfig ファイルを使用し、プロジェクトごとに独自のコーディング スタイルと設定を適用できます。

はじめに

動作環境

  • Windows 11、10、8.1、8、7、Vista、XP をサポートしています。
  • Mery Ver 2.8.7 以降をインストールしている必要があります。

アーカイブに含まれるファイル

  • Plugins/EditorConfig.dll: プラグイン本体
  • ThirdPartyNotices.txt: サードパーティ製コンポーネントのライセンス
  • eula.rtf: ソフトウェア使用許諾書
  • CHANGELOG.txt: 変更ログ
  • README.txt: 本ドキュメント

インストール

  1. アーカイブを展開し、EditorConfig.dllMery.exe のインストール先の Plugins フォルダーにコピーしてください。
  2. Mery を起動すると、[ツール] メニューの [プラグイン] にインストールしたプラグインの項目が追加されます。

アップデート

  • アーカイブを展開し、Plugins フォルダーの内容を Mery の Plugins フォルダーに上書きしてください。

アンインストール

  • Mery の Plugins フォルダーからアンインストールしたいプラグイン (*.dll) を削除してください。

使い方

  1. Mery を起動すると、自動的に EditorConfig が有効になります。
  2. [ツール] メニューから [プラグイン] の [EditorConfig] を選択してプラグインの有効/無効を切り替えることができます。
  3. EditorConfig プラグインを有効にした状態でファイルを開くと、.editorconfig に記述されたルールが適用されます。
  4. EditorConfig の設定が適用されているか確認するためには、EditorConfig プラグインを有効にした状態で、[ツール] メニューの [プラグイン] から [プラグインの設定] を選択し、[EditorConfig] の [プロパティ] をクリックします。

その他、EditorConfig の詳細については公式サイトをご参照ください。

.editorconfig の記述方法

ここでは .editorconfig の記述方法を簡単にご紹介します。

root = true

[*]
indent_style = tab
indent_size = 4
end_of_line = crlf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true
max_line_length = 80
me_user_defined_guides = 7,8,73

root = true

  • セクションの外側に記述するプロパティです。EditorConfig は、開こうとするファイルと同じ階層の .editorconfig から上の階層にさかのぼって .editorconfig を検索します。
  • このプロパティを true に設定すると、現在の .editorconfig で検索を停止します。

[*]

  • セクション名は、対象とするファイルのパスを指定します。
  • この文字列には、ワイルドカードが使用できるようになっており、たとえば、テキストファイルのみを対象にする場合は [*.txt] のように記述します。
  • 使用可能なワイルドカードの文字列については、https://editorconfig.org/#wildcards をご参照ください。

indent_style = tab

  • tab または space を指定して、インデントにタブを使用するか半角空白を使用するかを設定します。
  • Mery のオプションでは、[タブの代わりに空白を挿入] に該当します。

indent_size = 4

  • インデントに使用する桁数またはタブの幅を数値で指定します。
  • indent_style が tab の場合でも、このプロパティがタブの幅として使用されます。
  • Mery のオプションでは、[タブの桁数] に該当します。
  • EditorConfig の仕様では、tab_width プロパティを使用すると、indent_size とは別にタブの幅を設定できるようになっていますが、Mery ではインデントがタブか半角空白にかかわらず、[タブの桁数] は共通なので、tab_width プロパティは使用しません。

end_of_line = crlf

  • lf、cr、crlf を指定して、改行コードを設定します。

charset = utf-8

  • latin1、utf-8、utf-8-bom、utf-16be、utf-16le を指定して、文字のエンコードを設定します。

trim_trailing_whitespace = true

  • 保存する前に改行文字の前にある空白文字を削除する場合は true を設定します。

insert_final_newline = true

  • 保存する前にファイルの末尾に改行を含むかどうかを指定します。
  • このプロパティを指定すると、ファイルの末尾にある改行を削除した後、true の場合は改行を追加し、false の場合は追加しません。
  • ファイルの末尾にある改行に手を加えたくない場合は、このプロパティ自体を指定しないか、unset を設定します。

max_line_length = 80

  • 1 行の最大文字数 (折り返し位置) を指定します。

me_user_defined_guides = 7,8,73

  • ユーザー定義ガイドの位置を指定します。
  • 複数指定する場合は、カンマ区切りで記述します。

注意事項

  • プロパティ自体が記述されていない場合は、エディター側の設定が適用されます。
  • 値に unset を設定すると、そのプロパティの効果が削除され、エディター側の設定が使用されます。
    • たとえば、indent_size = unset と記述すれば、indent_size プロパティが未定義となり、エディター側の設定が適用されます。
    • プロパティの詳細については、https://editorconfig.org/#supported-properties を参照してください。
  • .editorconfig ファイルは、エンコードを UTF-8 とし、改行コードを CR+LF または LF に設定してください。
  • .editorconfig が適用されるのは、[ファイルを開いた時] と [ファイルを保存する前] です。
  • indent_style と indent_size は、タブを半角空白に変換するなど、文書を自動的に整形するための機能ではありません。
  • [ツール] メニューから [プラグイン] の [EditorConfig] を選択してプラグインを無効にした場合でも、既に開いているファイルの設定は保持されます。
  • エディター側の設定を適用するためには、開いているファイルを閉じてから再度開く必要があります。
スポンサーリンク