48 lines
1.8 KiB
Markdown
48 lines
1.8 KiB
Markdown
# FolderWeb
|
|
|
|
**Just enough, nothing more.** Drop Markdown files in folders, and they become pages. No database, no build process.
|
|
|
|
## What is FolderWeb?
|
|
|
|
FolderWeb is a content publishing framework where your file system is your content management system. Create a folder structure that mirrors your site hierarchy, drop files into folders, and they immediately become pages.
|
|
|
|
**Core principle**: Simplicity and longevity over features and complexity.
|
|
|
|
## Key Features
|
|
|
|
- **File-based routing**: `content/blog/post/` → `yoursite.com/blog/post/`
|
|
- **Multi-language support**: Built-in i18n with URL prefixes
|
|
- **Template system**: Override defaults with custom templates
|
|
- **Modern CSS**: CSS variables, nesting, OKLCH colors, grid layouts
|
|
- **No build process**: Save and refresh—see changes immediately
|
|
|
|
## Example Structure
|
|
|
|
```
|
|
project/
|
|
├── app/ # App (never modify)
|
|
├── content/ # Your website content
|
|
│ ├── front.md # Home page
|
|
│ ├── about/ # About page
|
|
│ │ └── about-me.md
|
|
│ └── blog/ # Blog with list view
|
|
│ ├── metadata.ini # Configure template
|
|
│ ├── 2025-11-01-first-post/
|
|
│ │ ├── first-post.md
|
|
│ │ ├── cover.jpg
|
|
│ │ └── metadata.ini
|
|
│ └── 2025-11-02-second-post/
|
|
│ └── another-post.md
|
|
└── custom/ # Your customizations
|
|
├── templates/ # Custom templates
|
|
├── styles/ # Custom CSS
|
|
└── config.ini # Configuration
|
|
```
|
|
|
|
## Documentation
|
|
|
|
**Complete documentation available in [`docs/`](docs/)**
|
|
|
|
## Learn More
|
|
|
|
Start with the **[Getting Started Tutorial](docs/tutorial/00-getting-started.md)** or browse the **[complete documentation](docs/)**.
|