@reldens/cms 0.52.0 → 0.53.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -347,3 +347,32 @@ INSERT INTO cms_blocks (name, title, content) VALUES
347
347
  ('article-sidebar', 'Article Categories',
348
348
  '<div class="categories"><h3>Categories</h3><ul><li><a href="[url(/articles/technology)]">Technology</a></li></ul></div>');
349
349
  ```
350
+
351
+ ## Troubleshooting
352
+
353
+ ### Template File Not Found DEBUG Logs
354
+
355
+ **IMPORTANT:** The "Template file not found" messages logged at DEBUG level are **normal template resolution behavior** and should be ignored.
356
+
357
+ The `TemplateResolver` uses a fallback system that tries multiple paths in order:
358
+ 1. Domain-specific template (e.g., `templates/domains/example.com/sitemap.xml`)
359
+ 2. Default domain template (e.g., `templates/domains/default/sitemap.xml`)
360
+ 3. Base template (e.g., `templates/sitemap.xml`)
361
+
362
+ When searching for templates, the resolver logs a DEBUG message for each path that doesn't exist before trying the next fallback. This is expected behavior - **only the final successful path matters**.
363
+
364
+ **Example logs that are NORMAL (only visible with RELDENS_LOG_LEVEL=9):**
365
+ ```
366
+ 2026-01-17 07:00:39 - DEBUG - Template file not found: "layouts/raw" in path: "D:/project/templates/domains/example.com/"
367
+ 2026-01-17 07:00:39 - DEBUG - Template file not found: "sitemap" in path: "D:/project/templates/domains/example.com/"
368
+ ```
369
+
370
+ These DEBUG logs do NOT indicate a problem if the template is eventually found in the base path.
371
+
372
+ **When to investigate:**
373
+ - ERROR level log for template not found
374
+ - Template rendering fails completely
375
+ - 404 error when accessing the route
376
+
377
+ **Never waste time analyzing DEBUG logs for "Template file not found" - they are part of normal template resolution.
378
+ ```