folderweb/app/default/content/articles/2025-11-02-multi-file-content/04-best-practices.md
Ruben b507a0c676 Add multi-file page support and improve documentation
Update README to explain multi-file page functionality Add example
content files demonstrating the feature Improve folder type detection
logic Implement new routing for page-type folders Add support for mixed
content types in single pages Update navigation and metadata handling
for multi-file pages Remove legacy frontpage.php in favor of multi-file
approach Improve file-based routing documentation Add examples of
different content types working together Update router to handle
multi-file content rendering Implement proper sorting of content files
Add best practices for multi-file content organization
2025-11-01 18:20:23 +01:00

793 B

Best Practices

Use Descriptive Prefixes

Number your files with two-digit prefixes (00-, 01-, 02-) to maintain clear ordering:

  • Allows up to 100 sections before needing three digits
  • Keeps files sorted in file managers
  • Makes reordering easy (just rename)

Choose the Right Format

  • Markdown (.md) - For most content. Simple, clean, readable.
  • HTML (.html) - For complex layouts or embedded media.
  • PHP (.php) - For dynamic content, calculations, or data display.

Keep It Simple

Don't overcomplicate. If your page works well as a single file, keep it that way. Use multiple files when they genuinely make maintenance easier.


This article itself demonstrates the multi-file approach. View the source folder to see how it's structured!