46 lines
2 KiB
Markdown
46 lines
2 KiB
Markdown
|
<!-- The hero.php file renders above this markdown content -->
|
|||
|
|
<!-- Files are combined in alphabetical order: hero.php, then index.md -->
|
|||
|
|
|
|||
|
|
## Quick Start
|
|||
|
|
|
|||
|
|
1. **Empty the content folder** – Delete everything in `/content/` to start fresh
|
|||
|
|
2. **Copy the default folder** – Copy `/app/default/` to `/custom/` (one level up from app/) to create your own theme
|
|||
|
|
3. **Add your content** – Drop `.md`, `.html`, or `.php` files in `/content/` and they're live
|
|||
|
|
4. **Customize templates** – Edit files in `/custom/templates/` to change the look
|
|||
|
|
5. **Style it** – Add CSS in `/custom/styles/styles.css` for global styles
|
|||
|
|
|
|||
|
|
## What Makes FolderWeb Different
|
|||
|
|
|
|||
|
|
**File-based routing** – Your folder structure is your URL structure. No configuration needed.
|
|||
|
|
|
|||
|
|
**No JavaScript** – Fast, simple, accessible websites that work everywhere.
|
|||
|
|
|
|||
|
|
**Modern PHP & CSS** – Clean code using the latest language features and CSS capabilities.
|
|||
|
|
|
|||
|
|
**No build step** – Edit a file, refresh the page. That's it.
|
|||
|
|
|
|||
|
|
**Decade-proof** – Minimal dependencies mean this will work for years without breaking.
|
|||
|
|
|
|||
|
|
## How This Page Works
|
|||
|
|
|
|||
|
|
This frontpage demonstrates how you can **mix different file types** to create dynamic, custom layouts:
|
|||
|
|
|
|||
|
|
- **`hero.php`** – Dynamic PHP component with live stats and styling
|
|||
|
|
- **`index.md`** – Static markdown content (this section!)
|
|||
|
|
|
|||
|
|
Files in the same directory are rendered alphabetically. Want a different order? Prefix filenames with numbers like `00-hero.php` and `01-content.md`.
|
|||
|
|
|
|||
|
|
## Features Demonstrated Here {#features}
|
|||
|
|
|
|||
|
|
Explore this demo site to see what FolderWeb can do:
|
|||
|
|
|
|||
|
|
- [Examples](/examples/) – Markdown, metadata, dates, and cover images
|
|||
|
|
- [Multilingual](/multilingual/) – Build sites in multiple languages
|
|||
|
|
- [Nested Content](/examples/nested/) – Organize content as deep as you need
|
|||
|
|
|
|||
|
|
## Philosophy
|
|||
|
|
|
|||
|
|
**Just enough, nothing more.** This framework uses minimal PHP to enable modern conveniences while remaining maintainable for years or decades.
|
|||
|
|
|
|||
|
|
Read more in `CLAUDE.md` to understand the principles behind FolderWeb.
|