Skip to content
/ weblog Public
forked from coignard/weblog

A stupidly simple plain text-based blog engine. No HTML included.

License

Notifications You must be signed in to change notification settings

nicolus/weblog

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Weblog

A minimalistic, plain text-based blog engine written in PHP, inspired by the simplicity and structure of RFC format. It's designed to display content as plain text, keeping it simple, light, and easy to set up, with no need for a database.

Weblog

Demo

See it in action here.

Features

  • Text Files as Posts: Just write your blog posts as plain text files.
  • Simple Configuration: Manage settings with an easy-to-edit YAML config file.
  • No Database Needed: No need to set up a database, as all data is stored in files.
  • Customizable Display: Adjust text width and other display settings through the configuration.

Getting Started

Installation

  1. Clone the Repository
    git clone https://github.com/coignard/weblog.git
  2. Place Your Posts Save your blog posts as .txt files in the weblog/custom-category-name/ directory.
  3. Configure Open config.yml and adjust the settings to match your preferences.

You're all set! Happy blogging!

Setting Up Your Web Server

If you're using nginx, here's a basic setup you can start with. This configuration assumes Weblog is installed in /var/www/weblog.

server {
    listen 80;
    server_name example.com;

    root /var/www/weblog;
    index index.php;
    charset utf-8;

    location / {
        try_files $uri $uri/ @rewrite;
    }

    location @rewrite {
        rewrite ^/([^/]+)$ $scheme://$host/$1/ permanent;
        rewrite ^/(.*)/$ /index.php?go=$1 last;
    }

    location ~ \.php$ {
        include fastcgi-php.conf;
        fastcgi_pass php-fpm;
    }
}

Replace example.com with your actual domain.

Usage

Navigate to your blog's URL. The homepage will display a list of all posts. Access individual posts by appending /your-post-slug/ to the URL.

Contributing

Contributions are welcome! For major changes, please open an issue first to discuss what you would like to change.

License

This project is open-sourced under the MIT License. See the LICENSE file for more details.

About

A stupidly simple plain text-based blog engine. No HTML included.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 100.0%