Skip to content

zichy/vicco

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

vicco

vicco is brutalist blog software contained in a single PHP file. It’s named after Vicco von Bülow.

Features

  • Responsive interface to publish, edit, and delete posts
  • Text formatting
  • Linkblog functionality
  • Atom feed
  • Open Graph & Microdata support

Target audiences

  • Hackers — It’s easy to customise.
  • Hipsters — It’s crappy, you could use it as a joke.

Requirements

  • Web server with PHP
  • SSL/TLS certificate

Installation

  1. Set your credentials in index.php.
  2. Upload it to your server and make the directory writable.
  3. Open the site in your browser.
  4. Customise the configuration and submit the form.
  5. Start blogging.

Text formatting

There is some Markdown-inspired formatting.

Input Output
**strong** / __strong__ strong
*italic* / _italic_ italic
~strikethrough~ strikethrough
>quotation block

quotation block

:"inline quote": inline quote
@code@ code
[https://example.org] https://example.org
[title](https://example.org) title

FAQ

Are there any dependencies? Should I use Composer?
There are no dependencies. This is literally one PHP file.

One single file? How does this work?
Well, actually several files are created in the folder /vicco/, which serves as some kind of rudimentary flat-file database. All posts are stored in JSON.

Can I rename index.php?
You can, but the question is whether you should. (You shouldn’t.)

How did vicco come to be?
I forked this now ten-year-old script and created a nearly complete rewrite.

Is vicco secure?
I don’t know. It should be secure enough to run a crappy blog.

Testimonials

I’m a huge fan of your blog, but I get the creeps from the PHP code.
sternenseemann

cute readme
riotbib

(Send me a PR if you want to add yours!)

License

vicco is licensed under the BSD-2-Clause license.