b507a0c676
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
23 lines
793 B
Markdown
23 lines
793 B
Markdown
## 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!
|