Merge branch 'mbostock/parameterized' into mbostock/page-loader

observablehq · Aug 26, 2024 · 86df938 · 86df938
2 parents 6139567 + cd5df5e
commit 86df938
Show file tree

Hide file tree

Showing 66 changed files with 85 additions and 92 deletions.
diff --git a/docs/css/card.md b/docs/css/card.md
diff --git a/docs/css/color.md b/docs/css/color.md
diff --git a/docs/css/grid.md b/docs/css/grid.md
diff --git a/docs/css/note.md b/docs/css/note.md
diff --git a/docs/files.md b/docs/files.md
@@ -32,7 +32,7 @@ volcano
 
 ## Static analysis
 
-The `FileAttachment` function can _only_ be passed a static string literal; constructing a dynamic path such as `FileAttachment("my" + "file.csv")` is invalid syntax. Static analysis is used to invoke [data loaders](./loaders) at build time, and ensures that only referenced files are included in the generated output during build. This also allows a content hash in the file name for cache breaking during deploy.
+The `FileAttachment` function can _only_ be passed a static string literal; constructing a dynamic path such as <code>FileAttachment(\`frame$\{i}.png\`)</code> is invalid syntax. Static analysis is used to invoke [data loaders](./loaders) at build time, and ensures that only referenced files are included in the generated output during build. This also allows a content hash in the file name for cache breaking during deploy.
 
 If you have multiple files, you can enumerate them explicitly like so:
 

diff --git a/docs/javascript/display.md b/docs/javascript/display.md
diff --git a/docs/javascript/files.md b/docs/javascript/files.md
diff --git a/docs/javascript/generators.md b/docs/javascript/generators.md
diff --git a/docs/javascript/imports.md b/docs/javascript/imports.md
diff --git a/docs/javascript/inputs.md b/docs/javascript/inputs.md
diff --git a/docs/javascript/mutables.md b/docs/javascript/mutables.md
diff --git a/docs/javascript/promises.md b/docs/javascript/promises.md
diff --git a/docs/javascript/reactivity.md b/docs/javascript/reactivity.md
diff --git a/docs/lib/generators.md b/docs/lib/generators.md
@@ -1,3 +1,7 @@
+---
+keywords: [dark, width]
+---
+
 # Observable Generators
 
 The Observable standard library includes several generator utilities. These are available by default in Markdown as `Generators`, but you can import them explicitly:

diff --git a/docs/routing.md b/docs/routing.md
diff --git a/docs/themes.md.ts b/docs/themes.md.ts
@@ -23,7 +23,11 @@ function renderThemeSection(themes: readonly string[]): string {
 }
 
 export default function render(): string {
-  return `# Themes
+  return `---
+keywords: [light, dark]
+---
+
+# Themes
 
 <style>
 

diff --git a/examples/api/package.json b/examples/api/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/chess/package.json b/examples/chess/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/codemirror/package.json b/examples/codemirror/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/custom-input-2d/package.json b/examples/custom-input-2d/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/custom-stylesheet/package.json b/examples/custom-stylesheet/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/eia/package.json b/examples/eia/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/geotiff/package.json b/examples/geotiff/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/google-analytics/package.json b/examples/google-analytics/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/hello-world/package.json b/examples/hello-world/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/hotel-bookings/package.json b/examples/hotel-bookings/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/input-select-file/package.json b/examples/input-select-file/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/intersection-observer/package.json b/examples/intersection-observer/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-airtable/package.json b/examples/loader-airtable/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-arrow/package.json b/examples/loader-arrow/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-canvas-to-png/package.json b/examples/loader-canvas-to-png/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-census/package.json b/examples/loader-census/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-databricks/package.json b/examples/loader-databricks/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-duckdb/package.json b/examples/loader-duckdb/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-elasticsearch/package.json b/examples/loader-elasticsearch/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-github/package.json b/examples/loader-github/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-google-analytics/package.json b/examples/loader-google-analytics/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-julia-to-txt/package.json b/examples/loader-julia-to-txt/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-parquet/package.json b/examples/loader-parquet/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-postgres/package.json b/examples/loader-postgres/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-python-to-csv/package.json b/examples/loader-python-to-csv/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-python-to-parquet/package.json b/examples/loader-python-to-parquet/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-python-to-png/package.json b/examples/loader-python-to-png/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-python-to-zip/package.json b/examples/loader-python-to-zip/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-r-to-csv/package.json b/examples/loader-r-to-csv/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-r-to-jpeg/package.json b/examples/loader-r-to-jpeg/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-r-to-json/package.json b/examples/loader-r-to-json/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-r-to-zip/package.json b/examples/loader-r-to-zip/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-rust-to-json/package.json b/examples/loader-rust-to-json/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/loader-snowflake/package.json b/examples/loader-snowflake/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"

diff --git a/examples/markdown-it-container/package.json b/examples/markdown-it-container/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "clean": "rimraf src/.observablehq/cache",
-    "build": "rimraf dist && observable build",
+    "build": "observable build",
     "dev": "observable preview",
     "deploy": "observable deploy",
     "observable": "observable"