rsyntaxtree 1.3.2 → 1.4.0

data/docs/assets/svg/055.svg

@@ -0,0 +1,53 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+  <svg width="359.2" height="605.25" viewBox="-15.200000000000001, 0, 374.4, 616.5" version="1.1" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <marker id="arrow" markerUnits="userSpaceOnUse" viewBox="0 0 10 10" refX="10" refY="5" markerWidth="15.200000000000001" markerHeight="15.200000000000001" orient="auto">
+      <path d="M 0 0 L 10 5 L 0 10" fill="#CC79A7"/>
+    </marker>
+    <marker id="arrowBackward" markerUnits="userSpaceOnUse" viewBox="0 0 10 10" refX="5" refY="5" markerWidth="15.200000000000001" markerHeight="15.200000000000001" orient="auto">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#CC79A7"/>
+    </marker>
+    <marker id="arrowForward" markerUnits="userSpaceOnUse" viewBox="0 0 10 10" refX="5" refY="5" markerWidth="15.200000000000001" markerHeight="15.200000000000001" orient="auto">
+      <path d="M 10 0 L 0 5 L 10 10 z" fill="#CC79A7"/>
+    </marker>
+    <marker id="arrowBothways" markerUnits="userSpaceOnUse" viewBox="0 0 30 10" refX="15" refY="5" markerWidth="45.6" markerHeight="15.200000000000001" orient="auto">
+      <path d="M 0 5 L 10 0 L 10 5 L 20 5 L 20 0 L 30 5 L 20 10 L 20 5 L 10 5 L 10 10 z" fill="#CC79A7"/>
+    </marker>
+    <pattern id="hatchBlack" x="10" y="10" width="10" height="10" patternUnits="userSpaceOnUse" patternTransform="rotate(45)">
+      <line x1="0" y="0" x2="0" y2="10" stroke="black" stroke-width="4"></line>
+    </pattern>
+    <pattern id="hatchForNode" x="10" y="10" width="10" height="10" patternUnits="userSpaceOnUse" patternTransform="rotate(45)">
+      <line x1="0" y="0" x2="0" y2="10" stroke="#0072B2" stroke-width="4"></line>
+    </pattern>
+    <pattern id="hatchForLeaf" x="10" y="10" width="10" height="10" patternUnits="userSpaceOnUse" patternTransform="rotate(45)">
+      <line x1="0" y="0" x2="0" y2="10" stroke="#009E73" stroke-width="4"></line>
+    </pattern>
+  </defs>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #0072B2; storoke-width: 0; font-size: 32px;' x='180.2' y='67.5'><tspan x='180.2' y='67.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">S</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #0072B2; storoke-width: 0; font-size: 32px;' x='75.09999999999998' y='238.5'><tspan x='75.09999999999998' y='238.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">NP</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #0072B2; storoke-width: 0; font-size: 32px;' x='15.199999999999989' y='409.5'><tspan x='15.199999999999989' y='409.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">Det</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #E63946; storoke-width: 0; font-size: 32px;' x='16.69999999999999' y='580.5'><tspan x='16.69999999999999' y='580.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">the</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #0072B2; storoke-width: 0; font-size: 32px;' x='139.5' y='409.5'><tspan x='139.5' y='409.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">N</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #457B9D; storoke-width: 0; font-size: 32px;' x='129.0' y='580.5'><tspan x='129.0' y='580.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">cat</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #0072B2; storoke-width: 0; font-size: 32px;' x='262.8' y='238.5'><tspan x='262.8' y='238.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">VP</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #0072B2; storoke-width: 0; font-size: 32px;' x='271.8' y='409.5'><tspan x='271.8' y='409.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">V</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #2A9D8F; storoke-width: 0; font-size: 32px;' x='234.8' y='580.5'><tspan x='234.8' y='580.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">sleeps</tspan>
+</text>
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='96.59999999999998' y1='182.25' x2='189.2' y2='95.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='281.8' y1='182.25' x2='189.2' y2='95.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='41.69999999999999' y1='353.25' x2='96.59999999999998' y2='266.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='151.5' y1='353.25' x2='96.59999999999998' y2='266.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='41.69999999999999' y1='524.25' x2='41.69999999999999' y2='437.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='151.5' y1='524.25' x2='151.5' y2='437.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='281.8' y1='353.25' x2='281.8' y2='266.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='281.8' y1='524.25' x2='281.8' y2='437.625' />
+</svg>

data/docs/assets/svg/056.svg

@@ -0,0 +1,73 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+  <svg width="912.0000000000001" height="776.25" viewBox="-15.200000000000001, 0, 927.2000000000002, 787.5" version="1.1" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <marker id="arrow" markerUnits="userSpaceOnUse" viewBox="0 0 10 10" refX="10" refY="5" markerWidth="15.200000000000001" markerHeight="15.200000000000001" orient="auto">
+      <path d="M 0 0 L 10 5 L 0 10" fill="#CC79A7"/>
+    </marker>
+    <marker id="arrowBackward" markerUnits="userSpaceOnUse" viewBox="0 0 10 10" refX="5" refY="5" markerWidth="15.200000000000001" markerHeight="15.200000000000001" orient="auto">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#CC79A7"/>
+    </marker>
+    <marker id="arrowForward" markerUnits="userSpaceOnUse" viewBox="0 0 10 10" refX="5" refY="5" markerWidth="15.200000000000001" markerHeight="15.200000000000001" orient="auto">
+      <path d="M 10 0 L 0 5 L 10 10 z" fill="#CC79A7"/>
+    </marker>
+    <marker id="arrowBothways" markerUnits="userSpaceOnUse" viewBox="0 0 30 10" refX="15" refY="5" markerWidth="45.6" markerHeight="15.200000000000001" orient="auto">
+      <path d="M 0 5 L 10 0 L 10 5 L 20 5 L 20 0 L 30 5 L 20 10 L 20 5 L 10 5 L 10 10 z" fill="#CC79A7"/>
+    </marker>
+    <pattern id="hatchBlack" x="10" y="10" width="10" height="10" patternUnits="userSpaceOnUse" patternTransform="rotate(45)">
+      <line x1="0" y="0" x2="0" y2="10" stroke="black" stroke-width="4"></line>
+    </pattern>
+    <pattern id="hatchForNode" x="10" y="10" width="10" height="10" patternUnits="userSpaceOnUse" patternTransform="rotate(45)">
+      <line x1="0" y="0" x2="0" y2="10" stroke="#0072B2" stroke-width="4"></line>
+    </pattern>
+    <pattern id="hatchForLeaf" x="10" y="10" width="10" height="10" patternUnits="userSpaceOnUse" patternTransform="rotate(45)">
+      <line x1="0" y="0" x2="0" y2="10" stroke="#009E73" stroke-width="4"></line>
+    </pattern>
+  </defs>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #0072B2; storoke-width: 0; font-size: 32px;' x='362.90000000000003' y='67.5'><tspan x='362.90000000000003' y='67.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">S</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: red; storoke-width: 0; font-size: 32px;' x='156.20000000000002' y='238.5'><tspan x='156.20000000000002' y='238.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">NP</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: blue; storoke-width: 0; font-size: 32px;' x='165.70000000000002' y='409.5'><tspan x='165.70000000000002' y='409.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">N</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #009E73; storoke-width: 0; font-size: 32px;' x='15.199999999999989' y='580.5'><tspan x='15.199999999999989' y='580.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">the<tspan style='fill:none;'>￭</tspan>quick<tspan style='fill:none;'>￭</tspan>brown<tspan style='fill:none;'>￭</tspan>fox</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: green; storoke-width: 0; font-size: 32px;' x='547.1000000000001' y='238.5'><tspan x='547.1000000000001' y='238.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">VP</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #0072B2; storoke-width: 0; font-size: 32px;' x='437.50000000000006' y='409.5'><tspan x='437.50000000000006' y='409.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">V</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #009E73; storoke-width: 0; font-size: 32px;' x='401.00000000000006' y='580.5'><tspan x='401.00000000000006' y='580.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">jumps</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #0072B2; storoke-width: 0; font-size: 32px;' x='665.7' y='409.5'><tspan x='665.7' y='409.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">PP</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #0072B2; storoke-width: 0; font-size: 32px;' x='578.3000000000001' y='580.5'><tspan x='578.3000000000001' y='580.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">P</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #009E73; storoke-width: 0; font-size: 32px;' x='554.8000000000001' y='751.5'><tspan x='554.8000000000001' y='751.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">over</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: purple; storoke-width: 0; font-size: 32px;' x='760.1000000000001' y='580.5'><tspan x='760.1000000000001' y='580.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">NP</tspan>
+</text>
+<text white-space='pre' alignment-baseline='text-top' style='fill: #009E73; storoke-width: 0; font-size: 32px;' x='681.6000000000001' y='751.5'><tspan x='681.6000000000001' y='751.5' style="" text-decoration="" font-family="'Noto Sans', 'Noto Sans JP', OpenMoji, 'OpenMoji Color', 'OpenMoji Black', sans-serif">the<tspan style='fill:none;'>￭</tspan>lazy<tspan style='fill:none;'>￭</tspan>dog</tspan>
+</text>
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='177.70000000000002' y1='182.25' x2='371.90000000000003' y2='95.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='566.1000000000001' y1='182.25' x2='371.90000000000003' y2='95.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='177.70000000000002' y1='353.25' x2='177.70000000000002' y2='266.625' />
+<polygon style='fill: none; stroke: black; stroke-width:2; stroke-linejoin:round;stroke-linecap:round;' points='15.199999999999989 524.25 340.2 524.25 177.70000000000002 437.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='447.50000000000006' y1='353.25' x2='566.1000000000001' y2='266.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='684.7' y1='353.25' x2='566.1000000000001' y2='266.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='447.50000000000006' y1='524.25' x2='447.50000000000006' y2='437.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='587.8000000000001' y1='524.25' x2='684.7' y2='437.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='781.6000000000001' y1='524.25' x2='684.7' y2='437.625' />
+<line style='fill: none; stroke:black; stroke-width:2; stroke-linejoin:round; stroke-linecap:round;' x1='587.8000000000001' y1='695.25' x2='587.8000000000001' y2='608.625' />
+<polygon style='fill: none; stroke: black; stroke-width:2; stroke-linejoin:round;stroke-linecap:round;' points='681.6000000000001 695.25 881.6000000000001 695.25 781.6000000000001 608.625' />
+<polyline style='stroke:red; stroke-width:2; fill:none; stroke-linejoin:round; stroke-linecap:round;'
+                            points='156.20000000000002,187.875 148.60000000000002,187.875 148.60000000000002,261.0 156.20000000000002,261.0' />
+
+<polyline style='stroke:red; stroke-width:2; fill:none; stroke-linejoin:round; stroke-linecap:round;'
+                            points='199.20000000000002,187.875 206.8,187.875 206.8,261.0 199.20000000000002,261.0' />
+
+<polyline style='stroke:green; stroke-width:2; fill:none; stroke-linejoin:round; stroke-linecap:round;'
+                            points='547.1000000000001,187.875 539.5000000000001,187.875 539.5000000000001,261.0 547.1000000000001,261.0' />
+
+<polyline style='stroke:green; stroke-width:2; fill:none; stroke-linejoin:round; stroke-linecap:round;'
+                            points='585.1000000000001,187.875 592.7000000000002,187.875 592.7000000000002,261.0 585.1000000000001,261.0' />
+</svg>

data/docs/documentation.md

@@ -121,6 +121,25 @@ If `##` is placed at the beginning of the leaf text, a rectangle is drawn instea
 
 If `###` is placed at the beginning of the leaf text, a rectangle with thicker lines is drawn.
 
+### Per-Node Styling (Color)
+
+You can specify a custom color for individual nodes using the `@color:` prefix. Both named colors and hex color codes are supported.
+
+|Sample Input|Description|
+|------------|-----------|
+|`@red:NP`|Named color (red)|
+|`@blue:VP`|Named color (blue)|
+|`@#FF5500:NP`|Hex color code|
+|`@#0A0:VP`|Short hex color code|
+
+**Markup Order**: When combining with other prefixes, use this order: `^` (triangle) → `#` (enclosure) → `@color:` (color)
+
+|Sample Input|Description|
+|------------|-----------|
+|`^@blue:NP`|Triangle connector + blue color|
+|`#@red:NP`|Square brackets + red color|
+|`^#@green:NP`|Triangle + brackets + green color|
+
 ### Escape Special Characters
 
 The backslash character `\` must be used to print certain characters used in the markup. If you do not have the `\` key on your keyboard, you can also use the yen/yuan character `¥` to escape.
@@ -153,6 +172,76 @@ Each additional connectors is distinguished by an ID number. The ID is specified
 
 A node can have any number of IDs. The same ID must appear in the text of the *two* nodes between which the additional connector is rendered. The same ID number cannot appear in more than two places.
 
+### Command Line Interface Features
+
+The following features are available only in the command-line interface.
+
+#### Penn Treebank Format
+
+RSyntaxTree automatically detects and converts Penn Treebank format to bracket notation:
+
+```
+# Penn Treebank format
+(S (NP the dog) (VP runs))
+
+# Equivalent bracket notation
+[S [NP the dog] [VP runs]]
+```
+
+**Escaping special characters in Penn Treebank format:**
+
+| Input | Displayed as |
+|-------|--------------|
+| `\(` `\)` | Parentheses `()` as literal text |
+| `\[` `\]` | Square brackets `[]` as literal text |
+
+Example:
+```
+(S (NP hello\(world\)) (VP test))
+→ [S [NP hello(world)] [VP test]]
+```
+
+#### Standard Input Support
+
+You can pipe tree data via standard input:
+
+```bash
+echo "[S [NP hello] [VP world]]" | rsyntaxtree -f svg -o ./
+cat tree.txt | rsyntaxtree -f png -o ./
+```
+
+#### Configuration File
+
+Create a `.rsyntaxtreerc` file in your home directory or current directory to set default options:
+
+```yaml
+# ~/.rsyntaxtreerc
+format: svg
+color: modern
+fontsize: 18
+leafstyle: auto
+symmetrize: off
+```
+
+CLI arguments override configuration file settings. Unknown options in the config file will generate warnings, and invalid values will cause errors with helpful messages.
+
+#### TikZ Output
+
+RSyntaxTree can generate TikZ/forest code for LaTeX documents using the `-f tikz` option. The output can be used directly in LaTeX with the `forest` package.
+
+**Limitations:** The TikZ output focuses on tree structure and does not support the following visual features:
+
+| Feature | TikZ Support |
+|---------|--------------|
+| Per-node coloring (`@color:`) | Not supported |
+| Enclosures (`#`, `##`) | Not supported |
+| Triangle connectors (`^`) | Not supported |
+| Text decoration (bold, italic) | Not supported |
+| Subscript/superscript (`_x_`, `__x__`) | Not supported |
+| Path drawing (`+1`, `+>1`) | Not supported |
+
+Users familiar with LaTeX can manually add these features to the generated TikZ code using standard LaTeX commands (e.g., `\textcolor{red}{NP}`, `\textbf{...}`).
+
 <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.0/dist/jquery.min.js"></script>
 <script src="https://cdn.jsdelivr.net/npm/lightbox2@2.11.3/src/js/lightbox.js"></script>
 

data/docs/documentation_ja.md

@@ -123,12 +123,31 @@ SVG形式を用いる場合，期待通りの表示を得るためには，ご
 
 ### リーフを囲む括弧と矩形の描画
 
-ラベルまたはリーフとなるテキストの最初に（`^` が存在する場合はその直後に） `#` を付けると，そのテキスト全体を角括弧（［ ］）で囲みます（例：`[#NP text]`, `[NP #text]`, `[NP ^#text]`）． 
+ラベルまたはリーフとなるテキストの最初に（`^` が存在する場合はその直後に） `#` を付けると，そのテキスト全体を角括弧（［ ］）で囲みます（例：`[#NP text]`, `[NP #text]`, `[NP ^#text]`）．
 
 テキストの最初に `##` を付けると，テキスト全体を矩形（ボックス）で囲みます．
 
 テキストの最初に `###` を付けると，テキスト全体を太い線の矩形（ボックス）で囲みます．
 
+### ノードごとの色指定
+
+`@color:` プレフィックスを使用して，個々のノードにカスタムカラーを指定できます．色名とHEXカラーコードの両方がサポートされています．
+
+|入力例|説明|
+|------------|-----------|
+|`@red:NP`|色名（赤）|
+|`@blue:VP`|色名（青）|
+|`@#FF5500:NP`|HEXカラーコード|
+|`@#0A0:VP`|短縮形HEXカラーコード|
+
+**マークアップの順序**：他のプレフィックスと組み合わせる場合は，次の順序を使用してください：`^`（三角形）→ `#`（囲み）→ `@color:`（色）
+
+|入力例|説明|
+|------------|-----------|
+|`^@blue:NP`|三角形コネクター＋青色|
+|`#@red:NP`|角括弧＋赤色|
+|`^#@green:NP`|三角形＋角括弧＋緑色|
+
 ### 一部の文字を表示するためのエスケープ
 
 文字装飾などのマークアップに使用される一部の文字をテキストとして表示するためには `\` によってエスケープする必要があります．使用している環境で `\` が使えない場合は `¥` で代用することができます．
@@ -164,6 +183,76 @@ IDにはどのような数字を用いても構いませんが，必ず **2箇
 
 IDにはどのような数字を用いても構いませんが，必ず **2箇所** で同じIDを指定することが必要です．同じIDを3箇所以上で指定することはできません．
 
+### コマンドラインインターフェースの機能
+
+以下の機能はコマンドラインインターフェースでのみ利用可能です．
+
+#### Penn Treebank形式
+
+RSyntaxTreeはPenn Treebank形式を自動的に検出し，括弧表記に変換します：
+
+```
+# Penn Treebank形式
+(S (NP the dog) (VP runs))
+
+# 同等の括弧表記
+[S [NP the dog] [VP runs]]
+```
+
+**Penn Treebank形式での特殊文字のエスケープ：**
+
+| 入力 | 表示 |
+|------|------|
+| `\(` `\)` | 丸括弧 `()` をそのまま表示 |
+| `\[` `\]` | 角括弧 `[]` をそのまま表示 |
+
+例：
+```
+(S (NP hello\(world\)) (VP test))
+→ [S [NP hello(world)] [VP test]]
+```
+
+#### 標準入力のサポート
+
+パイプを使って標準入力からツリーデータを渡すことができます：
+
+```bash
+echo "[S [NP hello] [VP world]]" | rsyntaxtree -f svg -o ./
+cat tree.txt | rsyntaxtree -f png -o ./
+```
+
+#### 設定ファイル
+
+ホームディレクトリまたはカレントディレクトリに `.rsyntaxtreerc` ファイルを作成して，デフォルトオプションを設定できます：
+
+```yaml
+# ~/.rsyntaxtreerc
+format: svg
+color: modern
+fontsize: 18
+leafstyle: auto
+symmetrize: off
+```
+
+コマンドライン引数は設定ファイルの設定を上書きします．設定ファイル内の不明なオプションは警告を生成し，無効な値はエラーメッセージを表示します．
+
+#### TikZ出力
+
+RSyntaxTreeは`-f tikz`オプションを使用してLaTeXドキュメント用のTikZ/forestコードを生成できます．出力は`forest`パッケージを使用してLaTeXで直接使用できます．
+
+**制限事項：** TikZ出力はツリー構造に焦点を当てており，以下の視覚的機能はサポートされていません：
+
+| 機能 | TikZサポート |
+|------|--------------|
+| ノード別カラー指定（`@color:`） | 非対応 |
+| 囲み（`#`，`##`） | 非対応 |
+| 三角形コネクタ（`^`） | 非対応 |
+| テキスト装飾（太字，斜体） | 非対応 |
+| 下付き・上付き文字（`_x_`，`__x__`） | 非対応 |
+| パス描画（`+1`，`+>1`） | 非対応 |
+
+LaTeXに精通しているユーザーは，標準的なLaTeXコマンド（例：`\textcolor{red}{NP}`，`\textbf{...}`）を使用して，生成されたTikZコードにこれらの機能を手動で追加できます．
+
 <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.0/dist/jquery.min.js"></script>
 <script src="https://cdn.jsdelivr.net/npm/lightbox2@2.11.3/src/js/lightbox.js"></script>
 

data/lib/rsyntaxtree/base_graph.rb

@@ -5,7 +5,7 @@
 #==========================
 #
 # Image utility functions to inspect text font metrics
-# Copyright (c) 2007-2024 Yoichiro Hasebe <yohasebe@gmail.com>
+# Copyright (c) 2007-2026 Yoichiro Hasebe <yohasebe@gmail.com>
 
 require_relative 'utils'
 
@@ -44,7 +44,7 @@ module RSyntaxTree
       @col_bg   = "none"
       @col_fg   = "black"
 
-      @col_line = if params[:hide_default_connectors]
+      @col_line = if params[:hide_default_connectors] == true
                     "none"
                   else
                     "black"
@@ -188,19 +188,19 @@ module RSyntaxTree
         child = children[0]
         case @leafstyle
         when "auto"
-          if child.contains_phrase || child.triangle
+          if parent.triangle || child.contains_phrase
             triangle_to_parent(parent, child)
           else
             line_to_parent(parent, child)
           end
         when "bar"
-          if child.triangle
+          if parent.triangle
             triangle_to_parent(parent, child)
           else
             line_to_parent(parent, child)
           end
         when "nothing", "none"
-          if child.triangle
+          if parent.triangle
             triangle_to_parent(parent, child)
           elsif ETYPE_LEAF != child.type
             line_to_parent(parent, child)

data/lib/rsyntaxtree/element.rb

@@ -5,14 +5,14 @@
 #==========================
 #
 # Aa class that represents a basic tree element, either node or leaf.
-# Copyright (c) 2007-2024 Yoichiro Hasebe <yohasebe@gmail.com>
+# Copyright (c) 2007-2026 Yoichiro Hasebe <yohasebe@gmail.com>
 
 require_relative "markup_parser"
 require_relative "utils"
 
 module RSyntaxTree
   class Element
-    attr_accessor :id, :parent, :type, :level, :width, :height, :content, :content_width, :content_height, :horizontal_indent, :vertical_indent, :triangle, :enclosure, :children, :font, :fontsize, :contains_phrase, :path
+    attr_accessor :id, :parent, :type, :level, :width, :height, :content, :content_width, :content_height, :horizontal_indent, :vertical_indent, :triangle, :enclosure, :children, :font, :fontsize, :contains_phrase, :path, :color
 
     def initialize(id, parent, content, level, fontset, fontsize, global)
       @global = global
@@ -49,6 +49,7 @@ module RSyntaxTree
       @paths = results[:paths]
       @enclosure = results[:enclosure]
       @triangle = results[:triangle]
+      @color = results[:color]
 
       @contains_phrase = false
       setup

data/lib/rsyntaxtree/elementlist.rb

@@ -5,7 +5,7 @@
 #==========================
 #
 # Contains a list of unordered tree elements with a defined parent
-# Copyright (c) 2007-2024 Yoichiro Hasebe <yohasebe@gmail.com>
+# Copyright (c) 2007-2026 Yoichiro Hasebe <yohasebe@gmail.com>
 
 require_relative "element"
 
@@ -33,7 +33,7 @@ module RSyntaxTree
     end
 
     def get_first
-      return nil if @elements.length.empty?
+      return nil if @elements.empty?
 
       @iterator = 0
       @elements[@iterator]
@@ -41,9 +41,7 @@ module RSyntaxTree
 
     def get_next
       @iterator += 1
-      return @elements[@iterator] if @elements[@iterator]
-
-      nil
+      @elements[@iterator]
     end
 
     def get_id(id)

data/lib/rsyntaxtree/format_converter.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+#==========================
+# format_converter.rb
+#==========================
+#
+# Converts various tree notation formats to RSyntaxTree's bracket notation
+# Copyright (c) 2007-2026 Yoichiro Hasebe <yohasebe@gmail.com>
+
+module RSyntaxTree
+  module FormatConverter
+    module_function
+
+    # Detect the format of the input string
+    # @param text [String] the input tree notation
+    # @return [Symbol] :penn or :bracket
+    def detect_format(text)
+      stripped = text.strip
+      if stripped.start_with?('(') && !stripped.start_with?('([')
+        :penn
+      else
+        :bracket
+      end
+    end
+
+    # Convert any supported format to bracket notation
+    # @param text [String] the input tree notation
+    # @return [String] bracket notation
+    def to_bracket(text)
+      case detect_format(text)
+      when :penn
+        penn_to_bracket(text)
+      else
+        text
+      end
+    end
+
+    # Convert Penn TreeBank format to bracket notation
+    # Penn: (S (NP hello) (VP world))
+    # Bracket: [S [NP hello] [VP world]]
+    # Use \( and \) to include literal parentheses in text
+    # @param text [String] Penn TreeBank notation
+    # @return [String] bracket notation
+    def penn_to_bracket(text)
+      # Normalize whitespace (collapse multiple spaces/newlines to single space)
+      normalized = text.gsub(/\s+/, ' ').strip
+
+      # Protect escaped parentheses with placeholders
+      result = normalized.gsub('\(', "\x00LPAREN\x00").gsub('\)', "\x00RPAREN\x00")
+
+      # Replace structural parentheses with brackets
+      result = result.gsub('(', '[').gsub(')', ']')
+
+      # Restore escaped parentheses as literal parentheses
+      result = result.gsub("\x00LPAREN\x00", '(').gsub("\x00RPAREN\x00", ')')
+
+      # Clean up extra spaces after opening brackets
+      result = result.gsub(/\[\s+/, '[')
+      # Clean up extra spaces before closing brackets
+      result = result.gsub(/\s+\]/, ']')
+
+      result
+    end
+  end
+end

data/lib/rsyntaxtree/markup_parser.rb

@@ -13,6 +13,11 @@ class MarkupParser < Parslet::Parser
   rule(:brackets) { str('#') }
   rule(:triangle) { str('^') }
 
+  # Color specification: @colorname: or @#hexcode:
+  rule(:color_name) { match('[a-zA-Z]').repeat(1) }
+  rule(:color_hex) { str('#') >> match('[0-9a-fA-F]').repeat(3, 6) }
+  rule(:color_spec) { str('@') >> (color_hex | color_name).as(:color_value) >> str(':') }
+
   rule(:path) { (str('+') >> str('-').maybe >> (str('>') | str('<')).maybe >> match('\d').repeat(1)).as(:path) }
   # rule(:escaped) { str('\\') >> match('[#<>{}\\^+*_=~\|\n\-]').as(:chr) }
   rule(:escaped) { str('\\') >> match('[#<>{}\\\\^+*_=~\\|\\n\\-\\[\\]]').as(:chr) }
@@ -51,7 +56,7 @@ class MarkupParser < Parslet::Parser
   rule(:markup) { (text | decoration | shape | bstroke) }
 
   rule(:line) { (cr.as(:extracr) | border | bborder | markup.repeat(1).as(:line) >> (cr | eof | str('+').present?)) }
-  rule(:lines) { triangle.maybe.as(:triangle) >> (brectangle | rectangle | brackets).maybe.as(:enclosure) >> line.repeat(1) >> path.repeat(0).as(:paths) >> (cr | eof) }
+  rule(:lines) { triangle.maybe.as(:triangle) >> (brectangle | rectangle | brackets).maybe.as(:enclosure) >> color_spec.maybe.as(:color) >> line.repeat(1) >> path.repeat(0).as(:paths) >> (cr | eof) }
   root :lines
 end
 
@@ -171,7 +176,7 @@ module Markup
 
     applied = @evaluator.apply(parsed)
 
-    results = { enclosure: :none, triangle: false, paths: [], contents: [] }
+    results = { enclosure: :none, triangle: false, paths: [], contents: [], color: nil }
     applied.each do |h|
       if h[:enclosure]
         results[:enclosure] = case h[:enclosure].to_s
@@ -187,6 +192,12 @@ module Markup
       end
       results[:triangle] = h[:triangle].to_s == '^' if h[:triangle]
       results[:paths] = h[:paths] if h[:paths]
+      # Handle color specification
+      if h[:color] && h[:color][:color_value]
+        color_value = h[:color][:color_value].to_s
+        # Prepend # if it's a hex color without it (parser captures just the hex part after #)
+        results[:color] = color_value
+      end
       results[:contents] << h if h[:type] == :text || h[:type] == :border || h[:type] == :bborder
     end
     { status: :success, results: results }

data/lib/rsyntaxtree/string_parser.rb

@@ -6,7 +6,7 @@
 #
 # Parses a phrase into leafs and nodes and store the result in an element list
 # (see element_list.rb)
-# Copyright (c) 2007-2024 Yoichiro Hasebe <yohasebe@gmail.com>
+# Copyright (c) 2007-2026 Yoichiro Hasebe <yohasebe@gmail.com>
 
 require_relative 'elementlist'
 require_relative 'element'

data/lib/rsyntaxtree/svg_graph.rb

@@ -5,7 +5,7 @@
 #==========================
 #
 # Parses an element list into an SVG tree.
-# Copyright (c) 2007-2024 Yoichiro Hasebe <yohasebe@gmail.com>
+# Copyright (c) 2007-2026 Yoichiro Hasebe <yohasebe@gmail.com>
 
 # No tempfile usage in this file
 require_relative 'base_graph'
@@ -149,7 +149,10 @@ module RSyntaxTree
       right = left + element.content_width
       txt_pos = left + (right - left) / 2
 
-      col = if element.type == ETYPE_LEAF
+      # Use element's custom color if specified, otherwise use default based on type
+      col = if element.color
+              element.color
+            elsif element.type == ETYPE_LEAF
               @col_leaf
             else
               @col_node
@@ -444,7 +447,11 @@ module RSyntaxTree
 
       path_flags.uniq.each do |k|
         targets = path_pool_target[k]
+        next if targets.nil? || targets.empty?
+
         fst = targets.shift
+        next if fst.nil?
+
         targets.each do |t|
           paths << { x1: fst[0], y1: fst[1], x2: t[0], y2: t[1], arrow: :double }
         end