Configuration Documentation

Introduction

The configuration file is stored in a file called config.json, for an example, copy example-config.json to config.json (cp example-config.json config.json) and modify from there.
Currently all values in example-config.json are required, however I plan to add support for default values in the case of no value being set.
All options show an example configuartion value and the variable type + an explaination below it.

Technical configuration

"site_url": "https://example.com"
This value defines the url of your site, this used for the RSS feed to link back to post.
"port": 8080
Integer. This value defines the port that you run the blog on. Don't change this value if you don't know what that means.
"allow_signup": true
Boolean. Defines weather new people should be allowed to signup.
"timeline_length": 20
Integer. How many posts will be shown on the timeline (home page).
"enable_hitcount": true
Boolean. Enabling the hitcount (a number that represents the amount of front page loads (stored in hitcount.txt)) can slightly slow down loading of the front page.
"charset": "UTF-8"
String. This is the value in the tag in the html of all pages, you should not change this unless you know why.
"root_path": "/path/to/root/of/website" String. Anything in this directory will be in the webroot, so put favicon.ico and anything else here.

Basic Customisation

"locale": en
String. Your locale, see /locales for a list of all locales (you can open a PR for a new translation too)
"seperator": "<hr/>"
String. This is what %S represents in the formatting, this will go inbetween posts and generally to seperate out content on pages.
"site_name": "My Blog"
String. This is what %Y represents; it's the name of your instance, a human readable string.
"site_description": "Read my blogs!" String. This is what %W represents; it's the description of your instance, a human readable string.
"default_commenter_username": "Anon" String. Default commenter username if no username is inputted in comment submission.

Syndication

"rss": true
Boolean. Enable or Disable RSS feeds.
"atom": true
Boolean. Enable or Disable ATOM feeds.

Dates

Advanced Customisation

/views/* files are EJS files (used for formatting HTML) and can be editted to your liking, you might want to read the EJS docs for help.
"css": "body { background: red; }"
String. Custom CSS to be applied to all pages, if you want more complex css, you can edit custom.css.
You can also edit the custom.css file in the webroot, as by default this is linked in the global header.

Custom Strings

You can edit all the strings on the site in /locales/.json

3.1 KiB Executable File Raw Blame History