Blogging structure with SEO markup
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
wnross f978f79a5d Update README.md 8 months ago
docs Jun9 updates 8 months ago
lib Rebuild article system 8 months ago
.gitignore Begin recovery of project 9 months ago
.htaccess Begin recovery of project 9 months ago
LICENSE Initial commit 9 months ago
README.md Update README.md 8 months ago
card.php Begin recovery of project 9 months ago
composer.json Rebuild article system 8 months ago
index.php Rebuild article system 8 months ago
lang.md Rebuild article system 8 months ago
marketing.php Jun9 updates 8 months ago
sitemap.php Fixed sitemap to find stylesheet, relative urls 9 months ago
template.inc Rebuild article system 8 months ago
template.inc.simple Rebuild article system 8 months ago

README.md

Blog / Knowledge Base

A lightweight, drop-in blog or knowledge base site for static or dynamic content. Designed for developers and technical users who prefer writing in Markdown or simplified PHP.

Features

  • Markdown-based article system with YAML frontmatter
  • Optional simplified PHP templates (e.g. marketing.php)
  • SEO-friendly output with sitemap generation
  • Lightweight footprint — no database required
  • Easy to theme with template.inc

Directory Structure

.
├── index.php          # Blog listing and router
├── sitemap.php        # Generates XML sitemap
├── template.inc       # Base template
├── articles/          # Markdown or PHP articles
│   ├── example.md
│   └── announcement.php
└── README.md

Writing Articles

Articles live in the articles/ folder and can be written as:

Markdown (.md)

Use YAML frontmatter to describe article metadata:

---
title: "New Feature Release"
date: 2025-06-10
tags: [update, release]
slug: new-feature-release
---

We’re happy to announce...

Simplified PHP (.php)

For more control or dynamic output, use a basic PHP file:

<!--
---
title: Special Announcement
date: "2025-06-10"
tags: ['announcement', 'promo']
---
-->
<p>This is rendered directly in PHP.</p>

Installation

This site is designed to run under any PHP 7+ web host or server:

git clone https://tea.kuzik.com/jittr/blog.git myblog
cd myblog

Ensure your server routes requests to index.php, and PHP has read access to the articles/ directory.

Configuration

  • Articles are auto-discovered from articles/
  • Optional .htaccess is provided for clean URLs (Apache)
  • Customize the look via template.inc

Security Notes

  • PHP articles are executed directly — avoid untrusted uploads.
  • No authentication is included by default.

TODO / Roadmap

  • Pagination support
  • Tag-based filtering
  • Atom/RSS feed generation
  • Admin or CLI article previewing

License

MIT — use freely for personal or commercial use.