Merge branch 'main' into fil/save-search-query

.github/workflows/deploy.yml

@@ -31,10 +31,6 @@ jobs:
           key: data-${{ hashFiles('docs/data/*') }}-${{ steps.date.outputs.date }}
       - run: yarn build
       - run: yarn docs:build
-      - uses: cloudflare/pages-action@1
-        with:
-          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
-          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
-          projectName: framework
-          directory: docs/.observablehq/dist
-          gitHubToken: ${{ secrets.GITHUB_TOKEN }}
+      - run: yarn docs:deploy
+        env:
+          OBSERVABLE_TOKEN: ${{ secrets.OBSERVABLE_API_TOKEN }}

.gitignore

@@ -4,8 +4,6 @@
 /coverage/
 /dist/
 /docs/.observablehq/dist/
-/docs/theme/*.md
-/docs/themes.md
 /test/build/
 /test/output/**/*-changed.*
 /test/output/build/**/*-changed/

docs/.observablehq/deploy.json

@@ -1,5 +1,5 @@
 {
-  "projectId": "497663d656fa5557",
-  "workspaceLogin": "observablehq",
-  "projectSlug": "cli"
+  "projectId": "b385d10b723e37b6",
+  "projectSlug": "framework",
+  "workspaceLogin": "observablehq"
 }

docs/config.md

@@ -155,6 +155,10 @@ The pages list should _not_ include the home page (`/`) as this is automatically
 
 Whether to show the previous & next links in the footer; defaults to true. The pages are linked in the same order as they appear in the sidebar.
 
+## dynamicPaths <a href="https://github.com/observablehq/framework/pull/1523" class="observablehq-version-badge" data-version="prerelease" title="Added in #1523"></a>
+
+The list of [parameterized pages](./params) and [dynamic pages](./page-loaders) to generate, either as a (synchronous) iterable of strings, or a function that returns an async iterable of strings if you wish to load the list of dynamic pages asynchronously.
+
 ## head
 
 An HTML fragment to add to the head. Defaults to the empty string. If specified as a function, receives an object with the page’s `title`, (front-matter) `data`, and `path`, and must return a string.
@@ -224,7 +228,7 @@ These additional results may also point to external links if the **path** is spe
 ```js run=false
 export default {
   search: {
-    async* index() {
+    async *index() {
       yield {
         path: "https://example.com",
         title: "Example",
@@ -237,7 +241,7 @@ export default {
 
 ## interpreters <a href="https://github.com/observablehq/framework/releases/tag/v1.3.0" class="observablehq-version-badge" data-version="^1.3.0" title="Added in 1.3.0"></a>
 
-The **interpreters** option specifies additional interpreted languages for data loaders, indicating the file extension and associated interpreter. (See [loader routing](./loaders#routing) for more.) The default list of interpreters is:
+The **interpreters** option specifies additional interpreted languages for data loaders, indicating the file extension and associated interpreter. (See [loader routing](./data-loaders#routing) for more.) The default list of interpreters is:
 
 ```js run=false
 {
@@ -300,3 +304,7 @@ The set of replacements for straight double and single quotes used when the [**t
 ## linkify <a href="https://github.com/observablehq/framework/releases/tag/v1.7.0" class="observablehq-version-badge" data-version="^1.7.0" title="Added in 1.7.0"></a>
 
 If true (the default), automatically convert URL-like text to links in Markdown.
+
+## globalStylesheets <a href="https://github.com/observablehq/framework/pull/1597" class="observablehq-version-badge" data-version="prerelease" title="Added in #1597"></a>
+
+An array of links to global stylesheets to add to every page’s head, in addition to the [page stylesheet](#style). Defaults to loading [Source Serif 4](https://fonts.google.com/specimen/Source+Serif+4) from Google Fonts.