ruben/folderweb
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Activity Actions

Add demo content and documentation for FolderWeb

Browse source 
Add about page with project philosophy and technical details

Add articles about Markdown, templates, and getting started

Implement demo content system that shows when no user content exists

Update logo to show FolderWeb branding

Improve Apache configuration for development environment
This commit is contained in:
Ruben 2025-11-01 16:47:15 +01:00
parent 36a3221dbb
commit 4c697122ab
19 changed files with 660 additions and 293 deletions
Download patch file Download diff file Expand all files Collapse all files

48
app/default/content/frontpage.php Normal file
View file

@ -0,0 +1,48 @@
<article>
<header style="text-align: center; padding: 4rem 0 2rem;">
<h1 style="font-size: clamp(2.5rem, 5vw, 4rem); margin-bottom: 1rem;">Welcome to FolderWeb</h1>
<p style="font-size: clamp(1.125rem, 2vw, 1.5rem); color: oklch(0.5 0 0); max-width: 60ch; margin: 0 auto;">
A minimalist PHP framework that turns folders into websites. No JavaScript, no build tools, just simple files.
</p>
</header>
<section style="max-width: 70ch; margin: 3rem auto;">
<h2>Getting Started</h2>
<p>
This is demo content to help you understand how FolderWeb works. To replace it with your own content:
</p>
<ol>
<li>Create a <code>/content</code> folder in your project root</li>
<li>Add your content files (<code>.md</code>, <code>.html</code>, or <code>.php</code>)</li>
<li>This demo will automatically disappear</li>
</ol>
<h2>Core Concepts</h2>
<h3>File-Based Routing</h3>
<p>
Drop a file in a folder and it's instantly accessible at a URL matching that path.
Your folder structure becomes your URL structure.
</p>
<h3>Multiple Content Types</h3>
<ul>
<li><strong>Markdown</strong> - Write in <code>.md</code> files, automatically converted to HTML</li>
<li><strong>HTML</strong> - Pure HTML files for complete control</li>
<li><strong>PHP</strong> - Dynamic content when you need it</li>
</ul>
<h3>Smart Features</h3>
<ul>
<li><strong>Metadata</strong> - Use <code>metadata.ini</code> files for titles, dates, summaries</li>
<li><strong>Date extraction</strong> - Folder names like <code>2025-11-01-title</code> automatically show dates</li>
<li><strong>Cover images</strong> - Add <code>cover.jpg</code> for list view thumbnails</li>
<li><strong>Templates</strong> - Custom templates in <code>/custom/templates/</code> override defaults</li>
</ul>
<h2>Explore the Demo</h2>
<p>
Check out the <a href="/articles/">Articles</a> and <a href="/about/">About</a> pages to see different content types in action.
</p>
</section>
</article>