modxcms-jp/revolution — Issue #4: 日本語訳のガイドラインについて
Author: kogu
Created: 2012-01-18 07:06:05+00:00
State: open

※ githubのissuesでの連携テストも兼ねてます。

Revoの翻訳を進めていますが、まだはっきりしたガイドラインが無いため、作りたいと考えています。

# 現況

以下のページで簡単なの方針が示されています。
http://modx.jp/blog/753.html

* 「情報の探しやすさ」を重視
* 用語はそのままカタカナ化して提示する
* 説明的な文章では意訳や使用例を加えても良い

私の作業でも、この方針と、既存の訳を参照しながら進めていますが、もう少し踏み込んだガイドラインが欲しいです。
目指すのは、新しい作業者が加わる場合や、複数人で同時に作業する場合に、度々問い合わせずに済む、足場になる程度のものです。

# ガイドラインの案
敲きとして、自分が作業で注意した点や、疑問を感じた点を示します。

## 翻訳全体の方針
全体的な日本語表現や使用文字種について。

### 文字種
* 句読点には「、」「。」を用いる
* 英数字は半角文字、漢字・ひらがな・カタカナは全角文字を用いる
* 半角カタカナは用いない

### 文体
* 「ですます体」を基本とする

### 表現の統一
* 同一の要素は同一の言葉で表現する

## 用語の翻訳
システム内に現れる用語の取り扱いについて。

### MODXの用語
* Evoで充分に浸透している用語は、それに倣う
* Revoで追加された用語は、無理のない範囲でカタカナ化する

### コンピューター用語
* 一般に定着している訳語を用いる
* カタカナ語の語尾の長音は省略しない（内閣告示ルールに則る）

### 固有名詞
* 原則として原文の表記を用いる
* 定着した日本語訳がある場合のみ訳語を用いる

## 定型文
多用される定型的な表現について。

### CRUDに関するもの
* WindowsやMacなど普及している環境で用いられる表現を参考にする
* 操作対象が明確になるよう適切な区切り等を用いる

### MODX固有のもの
* 原文に定型表現が無くても、同様の構造を持った操作や要素には定型文を見出す

### 定型文の集積
* 作業者が共有可能な場に、定型文とその分類を掲示する