@writedocs/generator 0.4.3 → 0.4.4

package/astro.config.mjs

@@ -147,6 +147,40 @@ function collectNoindexIds(rootContentDir) {
 
 const noindexIds = siteUrl ? collectNoindexIds(contentDir) : new Set();
 
+/** O @astrojs/sitemap sempre grava um sitemap-index.xml apontando para
+ *  sitemap-0.xml, sitemap-1.xml, ... - mesmo quando há um arquivo só, que é
+ *  o caso de todo site de docs abaixo de 50.000 páginas. Aqui o único
+ *  sitemap-0.xml vira sitemap.xml (o endereço que crawler e ferramenta de
+ *  SEO procuram primeiro) e o índice é apagado. Com mais de um arquivo o
+ *  índice é necessário (o protocolo não permite um único arquivo acima de
+ *  50.000 URLs), então tudo fica como o plugin gravou. Um sitemap.xml
+ *  vindo do public/ do próprio site também não é sobrescrito. */
+function singleSitemapFile() {
+  return {
+    name: 'writedocs-single-sitemap',
+    hooks: {
+      'astro:build:done': ({ dir }) => {
+        const outDir = fileURLToPath(dir);
+        const chunks = fs.readdirSync(outDir).filter((f) => /^sitemap-\d+\.xml$/.test(f));
+        const target = path.join(outDir, 'sitemap.xml');
+        if (chunks.length !== 1) {
+          console.log(`[writedocs] ${chunks.length} sitemap files generated - keeping sitemap-index.xml.`);
+          return;
+        }
+        if (fs.existsSync(target)) {
+          console.log('[writedocs] public/sitemap.xml exists - keeping it and the generated sitemap-index.xml.');
+          return;
+        }
+        fs.renameSync(path.join(outDir, chunks[0]), target);
+        fs.rmSync(path.join(outDir, 'sitemap-index.xml'), { force: true });
+        // O próprio plugin acabou de logar "sitemap-index.xml created"; esta
+        // linha diz o que de fato ficou no build.
+        console.log(`[writedocs] Replaced ${chunks[0]} + sitemap-index.xml with a single sitemap.xml.`);
+      },
+    },
+  };
+}
+
 // writedocs.json's `redirects` array -> Astro's own `redirects` config option
 // (a plain `{ [source]: destination }` record - see redirectSchema in
 // lib/config.ts for why there's no `permanent`/status-code field: this
@@ -207,12 +241,19 @@ export default defineConfig({
     ...(siteUrl
       ? [
           sitemap({
+            // Teto do protocolo de sitemap por arquivo (o default do
+            // @astrojs/sitemap é 45.000). Até aqui, tudo cabe num único
+            // sitemap.xml - ver singleSitemapFile() abaixo.
+            entryLimit: 50000,
             filter: (page) => {
               const pathname = new URL(page).pathname;
               const id = normalizeEntryId(pathname);
               return !noindexIds.has(id);
             },
           }),
+          // Precisa vir depois do sitemap(): o Astro roda os hooks
+          // astro:build:done na ordem deste array, um de cada vez.
+          singleSitemapFile(),
         ]
       : []),
     // Lets styles.favicon/styles.logo/styles.background.images/seo.ogImage/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@writedocs/generator",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Static site generator for docs — a writedocs.json + MDX folder in, a static site out.",
   "type": "module",
   "bin": {