Merge pull request #139 from ReScienceLab/windows-line-endings

Windows: LF checkouts, a template generator that writes the same bytes, no macOS-only open

Author: Jing-yilin

.gitattributes

@@ -0,0 +1,3 @@
+# A Windows checkout would otherwise turn every line ending into CRLF: the Windows installer
+# shipped its skills and templates that way, and a shell script checked out there does not run.
+* text=auto eol=lf

RELEASE-NOTES.md

@@ -32,6 +32,10 @@ Everything below is on `main` and reaches no install until a version is cut.
 - **`refkit shoot` works on Windows.** It finds Chrome where the Windows
   installer puts it, and uses Edge when Chrome is not there. Before, it only
   knew the macOS path.
+- **A new board folder's generator writes the same bytes on Windows.** The
+  template `gen.py` wrote boards in the Windows code page, so Chinese text or
+  an emoji came out garbled or stopped the run, and with CRLF line endings, so
+  regenerating marked every board as changed.
 
 ## v1.5.2
 

mockups/canvases/templates/gen.py

@@ -192,7 +192,7 @@ def page(title, body, extra_css=""):
 
 
 def write(name, html):
-    (OUT / (name + ".html")).write_text(html)
+    (OUT / (name + ".html")).write_text(html, encoding="utf-8", newline="\n")
     print(name, len(html))
 
 
@@ -462,6 +462,6 @@ def ref_boards():
   {"title": "Device shells: " + m + " art, 393 x 852 pt window",
    "files": [{"file": n, "label": l} for n, l, _, _ in row]} for m, row in SHELLS],
 }
-(OUT / "layout.json").write_text(json.dumps(LAYOUT, indent=2) + "\n")
+(OUT / "layout.json").write_text(json.dumps(LAYOUT, indent=2) + "\n", encoding="utf-8", newline="\n")
 print("layout.json", len(LAYOUT["rows"]), "rows")
 print("\nnext: refkit tokens", OUT)

skills/clone-prototype/SKILL.md

@@ -536,8 +536,8 @@ so there is nothing to restart. If `?canvas=<slug>` opens the wrong page
 anyway — right URL, no error — the folder holds no `.html` file yet, and an
 empty folder is not a board.
 
-```bash
-open "http://127.0.0.1:<port>/?canvas=<slug>"
+```
+http://127.0.0.1:<port>/?canvas=<slug>
 ```
 
 `#<file>` after that opens one board in the inspector, with the camera on