'), out);
+});
+
+test("leaves unparsable source untouched", () => {
+ const code = "const a =
;";
+ assert.equal(run(code), code);
+});
+
+test("the plugin transforms through the site's Vite, and refuses to run without it", () => {
+ const plugin = previewSrc({ vite, root: "/repo" });
+ const out = plugin.transform.handler("const a =
;", "/repo/src/A.jsx?v=1");
+ assert.match(out.code, /data-preview-src="src\/A\.jsx:1"/);
+ assert.throws(() => previewSrc({ root: "/repo" }), /needs \{ vite \}/);
+});
+
+test("paths are relative to the repository, also for a site in a subdirectory", async () => {
+ const repo = await mkdtemp(join(tmpdir(), "astro-root-"));
+ await mkdir(join(repo, ".git"));
+ await mkdir(join(repo, "site", "src"), { recursive: true });
+ assert.equal(repoRoot(join(repo, "site"), {}), repo);
+ assert.equal(repoRoot(join(repo, "site"), { PREVIEW_SRC_ROOT: "/elsewhere" }), "/elsewhere");
+
+ const out = stampSource("const a =
;", join(repo, "site", "src", "A.tsx"), repoRoot(join(repo, "site"), {}), vite);
+ assert.match(out, /data-preview-src="site\/src\/A\.tsx:1"/);
+});
diff --git a/website-comment/adapters/jekyll/README.md b/website-comment/adapters/jekyll/README.md
new file mode 100644
index 000000000..4b10b548b
--- /dev/null
+++ b/website-comment/adapters/jekyll/README.md
@@ -0,0 +1,73 @@
+
+
+# Jekyll adapter
+
+Makes a Jekyll site's preview build stamp `data-preview-src="
:"` on
+rendered elements, so the review overlay can take a reviewer from a marked
+region to the source line in the pull request's diff. See the
+[overview](../../README.md) for how this fits the rest of the preview
+system.
+
+## What gets stamped
+
+| Source | How | Granularity |
+|---|---|---|
+| Markdown pages and collection documents | From the source line kramdown records for each block, shifted past the front matter | Headings, paragraphs, list items, blockquotes, tables and rows, code blocks, definition lists, embedded HTML blocks |
+| Layouts (`_layouts/`) | Each opening HTML tag of the raw template, before Liquid runs | Every tag outside `html`, `head`, `body`, `meta`, `link`, `script`, `style`, `title`, `base`, `noscript`, `template` |
+| Includes (`include`, `include_relative`) | Same as layouts | Same as layouts |
+
+Left alone: Liquid output (`{{ "" }}`), `{% raw %}`, `{% comment %}` and
+`{% highlight %}` blocks, `
+{% raw %}literal
{% endraw %}
+
+