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.

Features

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

Target audiences

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

Requirements

  • Web server with PHP
  • SSL/TLS certificate

Installation

  1. Adjust the config in index.php, especially your credentials.
  2. Upload it to your server and make the directory writable.
  3. Open the site in your browser.
  4. It should work.

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.