docs: add web publication instructions to the single-file html (#554)

joanise · web-flow · commit cd6755cd8384 · 2026-05-27T17:19:35.000-04:00
* docs: add webmaster instructions the single-file html

* docs: improvements suggested by Aidan
diff --git a/packages/studio-web/src/app/shared/download/download.service.ts b/packages/studio-web/src/app/shared/download/download.service.ts
@@ -205,6 +205,8 @@ Please host all assets on your server, include the font and package imports defi
         `
             <!DOCTYPE html>
 
+            <!-- DO NOT USE THIS VERSION ON A WEBSITE. See Web Publication Instructions below -->
+
             <!--
 
                                 Instructions for Opening this File
@@ -227,6 +229,22 @@ Please host all assets on your server, include the font and package imports defi
 
             -->
 
+            <!--
+
+                                   Web Publication Instructions
+
+            Before publishing this ReadAlong on a web site, please convert it to a Web
+            Bundle. This monolithic format is intended for editing and for offline use,
+            but it is not optimized for publication on a web site.
+
+            Use the ReadAlong Studio Editor to convert this to a Web Bundle zip file:
+            https://readalong-studio.mothertongues.org/#/editor
+            Load it in the Editor and download it back using the "Web Bundle" Output Format.
+
+            Publication instructions are in file "www/readme.txt" in the bundle.
+
+            -->
+
             <html lang="en">
               <head>
                 <meta charset="utf-8">
@@ -255,7 +273,7 @@ Please host all assets on your server, include the font and package imports defi
                 </read-along>
               </body>
             </html>
-          `
+            `
           .replace(/\n            /g, "\n")
           .trim(),
       ],
