# properties-mode - Java の properties ファイルを編集したりする

- Author: miyamuko <URL:mailto:miyamuko (at) mtb.biglobe.ne.jp>
- URL: <URL:http://miyamuko.s56.xrea.com/xyzzy/properties-mode.html>
- Version: $Id: properties-mode.l,v 1.12 2004/08/09 14:03:17 miyamuko Exp $

## 1 説明

Java の properties ファイルを編集するためのメジャーモードです。

- ロード時に `native2ascii -reverse` を勝手に実行
- 保存時に `native2ascii` を勝手に実行
- 適当なインデント
- 適当な色づけ
- 前のキーをコピーできる
- カラムの自動調整

## 2 インストール

NetInstaller でインストールした場合は 3 以降を、 NetInstaller + `ni-autoload` を使っている人は 4 以降で OK です。

1. アーカイブをダウンロードします。

   <URL:http://miyamuko.s56.xrea.com/xyzzy/archives/properties-mode.zip>

2. アーカイブを展開して、$XYZZY/site-lisp 配下にファイルをコピーします。

3. 拡張子が properties のファイルを開いたときに自動的に properties-mode になるように ~/.xyzzy または $XYZZY/site-lisp/siteinit.l に以下のコードを追加します。

       ;; properties-mode
       (load-library "properties-mode")
       (pushnew '("\\.properties$" . properties-mode) *auto-mode-alist* :test 'equal)

4. 設定を反映させるには xyzzy を再起動してください。

   ※siteinit.l に記述した場合には再ダンプが必要です。

## 3 リファレンス

### 3.1 キー割り当て

`TAB`

  インデントする。

  - 継続行なら value の開始とインデントをそろえます。
  - プロパティを継続する文字がない場合、通常インデントしません。

  プロパティを複数行にわたって書く場合は次のように値の先頭をそろえるように インデントします。

      font = family1 family2 family3 family4 \
             - size1 size2 size3 size4 size5 \
             - bold italic underline

  key の直後で改行した場合は次のようにインデントします。 (`*properties-indent-level*` が 2 の場合)

      fontLabel=\
        Font

`RET`
  改行＋インデント付け。
`C-M-\`

  前のキーをコピーする。

  連続して実行するとさかのぼってキーをコピーしてきます。

`C-c n`
  リージョンを `native2ascii -reverse` します。
`C-c a`
  リージョンを `native2ascii` します。
`C-c C-a`
  リージョンのプロパティのカラムをそろえる。

  - before

        a.b=      c
        a b
        a.b.c: d

  - after

        a.b   =     c
        a           b
        a.b.c :     d

`C-c C-o`
  リージョンのセパレータ周りの余計な空白を除去します。

  - before

        a.b  = c
        a      b

  - after

        a.b=c
        a b

`C-c C-c`
  リージョンをコメントアウトします。
`C-c C-u`
  リージョンをコメント解除します。
`C-/`
  現在行のコメント・非コメントを切り替えます。
`C-c C-s C-v`

  バッファ全体を csv に変換します。

  csv-mode がインストールされていて `*properties-auto-csv-mode*` が non-nil の場合、変換後自動的に csv-mode を実行します。

### 3.2 変数

`*properties-indent-level*`

  継続行のインデント幅を設定します。 デフォルト値は 2 です。

      properties.key = \
      ____properties.value

  例:

      ;; インデント幅を 4 にする
      (setq *properties-indent-level* 4)

`*properties-n2a-buffer-name*`
  native2ascii した結果のバッファ名です。
`*properties-auto-csv-mode*`

  `properties-convert-to-csv` を実行したときに自動的に csv-mode にするかどうかのフラグです。

  non-nil かつ csv-mode がインストールされている場合、 自動的に csv-mode にします。

  デフォルトは t です。

`*properties-auto-native2ascii*`

  自動的に native2ascii を実行するかどうかのフラグです。

  non-nil なら自動的にロード時・保存時に native2ascii します。

  デフォルトは t です。

## 4 関連するかもしれないページ

java.util.properties#load
  <URL:http://java.sun.com/j2se/1.4/ja/docs/ja/api/java/util/Properties.html#load(java.io.InputStream)>

## 5 ライセンス

properties-mode は修正 BSD ライセンスに基づいて利用可能です。

    Copyright (C) 2003-2004 MIYAMUKO Katsuyuki. All rights reserved.

    Redistribution and use in source and binary forms, with or without
    modification, are permitted provided that the following conditions are
    met:

    1 Redistributions of source code must retain the above copyright notice,
    this list of conditions and the following disclaimer as the first lines
    of this file unmodified.

    2 Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions and the following disclaimer in the
    documentation and/or other materials provided with the distribution.

    THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
    ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
    ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
    FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
    DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
    OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
    HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
    LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
    OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
    SUCH DAMAGE.