Merge branch 'main' into check-example-graph

deno.json

@@ -4,6 +4,7 @@
     "@std/assert": "jsr:@std/assert@^1.0.6",
     "@std/dotenv": "jsr:@std/dotenv@^0.225.2",
     "@std/fs": "jsr:@std/fs@^0.229.3",
+    "@std/html": "jsr:@std/html@^1.0.3",
     "@std/media-types": "jsr:@std/media-types@^1.0.3",
     "@std/path": "jsr:@std/path@^1.0.8",
     "ga4": "https://raw.githubusercontent.com/denoland/ga4/04a1ce209116f158b5ef1658b957bdb109db68ed/mod.ts",

reference.page.jsx

@@ -1,4 +1,6 @@
 import { walkSync } from "@std/fs/walk";
+import { unescape } from "@std/html/entities";
+import entityList from "@std/html/named-entity-list.json" with { type: "json" };
 
 export const layout = "raw.tsx";
 
@@ -24,7 +26,9 @@ export default function* () {
       let title = "";
       try {
         const match = titleRegexp.exec(content);
-        title = match[1].slice(0, -"documentation".length) + "- Deno Docs";
+        const titleFirst = match[1].slice(0, -"documentation".length);
+
+        title = unescape(titleFirst, { entityList }) + "- Deno Docs";
       } catch (e) {
         if (!file.path.endsWith("prototype.html")) {
           console.error(file.path);

runtime/reference/cli/compiler.md

@@ -84,6 +84,29 @@ To include non-statically analyzable dynamic imports, specify an
 deno compile --include calc.ts --include better_calc.ts main.ts
 ```
 
+## Including Data Files or Directories
+
+Starting in Deno 2.1, you can include files or directories in the executable by
+specifying them via the `--include <path>` flag.
+
+```shell
+deno compile --include names.csv --include data main.ts
+```
+
+Then read the file relative to the directory path of the current module via
+`import.meta.dirname`:
+
+```ts
+// main.ts
+const names = Deno.readTextFileSync(import.meta.dirname + "/names.csv");
+const dataFiles = Deno.readDirSync(import.meta.dirname + "/data");
+
+// use names and dataFiles here
+```
+
+Note this currently only works for files on the file system and not remote
+files.
+
 ## Workers
 
 Similarly to non-statically analyzable dynamic imports, code for