Add bilingual manual and localized docs routes

doc/manual/source/jp/language/syntax.md

@@ -0,0 +1,129 @@
+# 構文と字句
+
+この章では、表層構文の方針をまとめる。
+厳密な構文は [Grammar](./grammar.md) の EBNF を参照する。
+
+## 言語名と拡張子
+
+プロジェクト名は **Decodal** とする。
+正式な説明名は **Deferred Constraint Data Language**、略称は **DCDL** とする。
+ファイル拡張子は `.dcdl` とする。
+
+```text
+config.dcdl
+schema.dcdl
+service.dcdl
+```
+
+## Module source
+
+ファイル全体は単一の式として書ける。
+また、top-level に field 定義列を書いた場合は、暗黙の object として扱う。
+
+```dcdl
+host = String;
+port = Int default 8080;
+```
+
+上の source は以下と同じ意味である。
+
+```dcdl
+{
+    host = String;
+    port = Int default 8080;
+}
+```
+
+## コメント
+
+コメントは `#` から行末までとする。
+
+```dcdl
+# comment
+host = "127.0.0.1"; # trailing comment
+```
+
+## セミコロン
+
+オブジェクトフィールド、let 束縛、match 分岐はセミコロンで区切る。
+末尾セミコロンは許可する。
+
+```dcdl
+{
+    host = "127.0.0.1";
+    port = 8000;
+}
+```
+
+## 識別子
+
+識別子は ASCII 英字で始まり、ASCII 英数字または `_` を続けられる。
+命名規則には `lower_snake`、`lowerCamel`、`UpperCamel` を使用できる。
+
+```dcdl
+my_config
+mkConfig
+IPv4Address
+```
+
+## パス参照
+
+ドットによるフィールド参照を許可する。
+
+```dcdl
+config.host
+config.feature_hoge.enable
+```
+
+オブジェクト内では、ドットパスによるフィールド定義も許可する。
+
+```dcdl
+{
+    feature_hoge.enable = false;
+}
+```
+
+これは以下と同じ構造を表す。
+
+```dcdl
+{
+    feature_hoge = {
+        enable = false;
+    };
+}
+```
+
+## 予約語
+
+以下は予約語として扱う。
+
+```text
+let
+in
+match
+import
+default
+as
+true
+false
+```
+
+## 演算子
+
+主要な演算子は以下である。
+
+```text
++ - * /       四則演算
+++            配列結合
+! && ||       論理演算
+== != < <= > >= 比較式
+&             制約合成
+//            patch 合成
+default       fallback 指定
+as            左辺から右辺への範囲包含確認と絞り込み
+=>            関数
+.             フィールド参照 / ドットパス定義
+...           配列または連想配列の値制約
+```
+
+演算子の優先順位は [合成演算子](./operators.md) で定義する。