Merge pull request #16 from copper-project/nico/minor-improv

Minor changes, add RON syntax coloring & reword RON unicity

Author: gbin

book/book.toml

@@ -13,3 +13,4 @@ preferred-dark-theme = "navy"
 git-repository-url = "https://github.com/NRdrgz/copper-rs-book"
 site-url = "/copper-rs-book/"
 additional-css = ["theme/brand.css"]
+additional-js = ["theme/highlight-ron.js"]

book/src/ch14-missions.md

@@ -337,11 +337,11 @@ ros2 launch my_robot robot.launch.py use_sim:=true
 This works, but the logic lives in Python launch files that are completely separate from
 your node code. Errors (wrong topic names, missing remappings) only show up at runtime.
 
-In Copper, everything is in one `copperconfig.ron`:
+In Copper, all missions live in `copperconfig.ron`:
 
 ```text
 Copper:
-  copperconfig.ron    ← all missions, tasks, and connections in one place
+  copperconfig.ron    ← missions, tasks, connections
   cargo run           ← default mission
   cargo run -- direct ← alternative mission
 ```
@@ -350,12 +350,10 @@ Key differences:
 
 | | ROS 2 | Copper |
 |---|---|---|
-| **Where** | Python launch files + YAML params | Single `copperconfig.ron` |
+| **Where** | Python launch files + YAML params | `copperconfig.ron` |
 | **Validation** | Runtime (nodes may fail to connect) | Compile time (macro checks the graph) |
 | **Granularity** | Per-node conditionals | Per-task and per-connection tagging |
 | **Switching** | Launch arguments | Builder selection in `main.rs` |
-| **All variants visible** | Spread across files and conditionals | One file, all missions side by side |
+| **All variants visible** | Spread across files and conditionals | One file, all missions visible |
 
-The biggest advantage is **visibility**: you can look at one file and see every mission,
-every task, and exactly which tasks are active in which missions. There's no need to
-mentally simulate a launch file's conditional logic to figure out what will actually run.
+The main advantage: one file shows every mission and which tasks run in each.

book/theme/highlight-ron.js

@@ -0,0 +1,41 @@
+(function() {
+  "use strict";
+
+  if (typeof hljs === "undefined") return;
+
+  hljs.registerLanguage("ron", function(hljs) {
+    return {
+      name: "RON",
+      aliases: ["ron"],
+      contains: [
+        hljs.C_LINE_COMMENT_MODE,
+        hljs.C_BLOCK_COMMENT_MODE,
+        {
+          className: "string",
+          begin: '"',
+          end: '"',
+          contains: [hljs.BACKSLASH_ESCAPE],
+          illegal: "\\n"
+        },
+        {
+          className: "number",
+          begin: "\\b\\d+(\\.\\d+)?([eE][+-]?\\d+)?\\b",
+          relevance: 0
+        },
+        {
+          className: "literal",
+          begin: "\\b(true|false)\\b"
+        },
+        {
+          className: "attr",
+          begin: "[a-zA-Z_][a-zA-Z0-9_]*\\s*:",
+          relevance: 0
+        }
+      ]
+    };
+  });
+
+  document.querySelectorAll("pre code.language-ron").forEach(function(block) {
+    hljs.highlightBlock(block);
+  });
+})();