Skip to content

A simple blog software that doesn't require a database, and separates content from presentation.

License

Notifications You must be signed in to change notification settings

robertdherb/just-a-blog

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

just-a-blog

A simple blog software that doesn't require a database, and separates content from presentation.

Features

  • Respects the user
    • just-a-blog tries to stay out of your way as much as possible.
    • Doesn't force jquery or any other framework on you.
    • Degrades gracefully for screenreaders or text-only environments
    • You can use your preferred tool for editing pages and posts.
  • Compatible
    • just-a-blog only requires PHP5+. No databases are necessary.
    • Can port existing HTML pages and posts directly into just-a-blog with no need to reformat. (Just remember to change the extension to .md)
  • Full customization - Since just-a-blog strives to be small and lightweight, editing it should be extremely easy.
  • No frameworks, no package managers. Just put the php files on your server in your preferred method. I guess you could do this with other softwares, but JAB encourages it.

Install

Installing is dead simple. Simply git clone https://github.com/robertdherb/just-a-blog in the directory you serve http pages from. You will also need to make some changes to your httpd to allow it to serve canonical URLs.

Use

Place markdown files in the posts/ directory. The file name should be the post's title. For instance, a post titled, "My First Post" should be in the file posts/my-first-post.md.

Pages work the same, but are placed in the pages/ directory.

Do not delete pages/home.md. Alter it however you like, but it needs to exist.

Posts are sorted by last edit time. This moves recently edited posts to the top of the list. This may or may not be a desirable outcome for you.

TODO

  • Make it easier to siwtch cannonical URLs on and off
  • Maybe categories/tags?
  • Make better use of the write_html() function in functions.php (lots of display-related stuff currently can't be changed without editing that file!)

Contact

Send an email to just-a-blog@robertdherb.com, or try to find me on Skype (rawbherb) or Steam (abigtimeoperator)

License

just-a-blog is currently released under the BSD 2-Clause License. See LICENSE for more details.

Credits

just-a-blog uses Parsedown by Emanuil Rusev.

About

A simple blog software that doesn't require a database, and separates content from presentation.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published