BLAZE-CONFIG(1)

📦
version 1.2.0 · 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble

💖 BLAZE-CONFIG(1) 💖

okay bestie, so this is the BlazeBlogger Documentation page for blaze-config, and it's literally the control room for your whole blog setup. let's get into it 🎀

✨ NAME ✨

blaze-config — shows you your BlazeBlogger configuration options, or sets them for you. both. it does both. main character energy fr 💅

✨ SYNOPSIS ✨

blaze-config [-qV] [-b directory] [-E editor] option [value...]

blaze-config -e [-b directory]

blaze-config -h|-v

✨ DESCRIPTION ✨

so blaze-config does one of two things: it either sets BlazeBlogger configuration options, or it displays whatever the current value of an option is. lowkey iconic.

and as if that wasn't enough, it can also crack open a configuration file in an external text editor, no cap 🦋

✨ OPTIONS ✨

🌸 Command Line Options 🌸

  • -b directory, --blogdir directory — lets you say exactly which directory your BlazeBlogger repository is chillin' in. the default is just your current working directory. 💖
  • -E editor, --editor editor — lets you name an external text editor. when you pass this, it overrides the relevant configuration option, periodt.
  • -e, --edit — lets you edit the configuration in a text editor. ✨
  • -q, --quiet — turns off all the unnecessary messages. shhh 🤫
  • -V, --verbose — turns on all the messages. this one is the default, so it's already on unless you say otherwise.
  • -h, --help — shows you usage info and dips out.
  • -v, --version — shows you version info and dips out.

🌈 Configuration Options 🌈

  • blog.title=string — the title of your blog. your whole brand 💅
  • blog.subtitle=string — a subtitle for your blog.
  • blog.description=string — a brief lil description of your blog.
  • blog.keywords=list — a comma-separated list of keywords.
  • blog.theme=string — a theme for your blog. > heads up: it has to point to a file that actually exists inside the .blaze/theme/ directory. the default is "default.html". 🎀
  • blog.style=string — a style sheet for your blog. > again, it must point to a file that exists in the .blaze/style/ directory. the default is "default.css". 🌸
  • blog.lang=string — a translation of your blog. > and yes, it must point to a file that exists in the .blaze/lang/ directory. the default is "en_US".
  • blog.posts=integer — how many blog posts get listed on a single page. the default is 10. 🔥
  • color.list=boolean — a boolean that enables ("true") or disables ("false") colors in the blaze-list output. the default is "false".
  • color.log=boolean — a boolean that enables ("true") or disables ("false") colors in the blaze-log output. the default is "false".
  • core.doctype=string — a document type. it's either "html" for HTML, or "xhtml" for the XHTML standard. the default is "html". ✨
  • core.extension=string — a file extension. the default is "html".
  • core.encoding=string — a character encoding. > note that it has to be in a form the W3C standards recognize. the default is "UTF-8".
  • core.editor=string — an external text editor. when you supply this, it overrides the system-wide settings. 💜
  • core.processor=string — an external application used to process newly added or edited blog posts and pages. > important: you must supply "%in%" and "%out%" in place of the input and output file names respectively. this option is disabled by default. 🙈
  • feed.baseurl=string — a URL of your blog, like "http://example.com" for example.
  • feed.posts=integer — how many blog posts get listed in the feed. the default is 10.
  • feed.fullposts=boolean — a boolean that enables ("true") or disables ("false") including the whole content of a blog post in the feed, even when the <!-- break --> form is used. the default is "false". 😭
  • post.author=string — where the blog post author name goes. it can sit above the post ("top"), below it ("bottom"), or nowhere on the page at all ("none"). the default is "top".
  • post.date=string — where the date of publishing goes. it can sit above the post ("top"), below it ("bottom"), or nowhere on the page ("none"). the default is top.
  • post.tags=string — where the post tags go. they can sit above the post ("top"), below it ("bottom"), or nowhere on the page ("none"). the default is "top".
  • user.name=string — your full name, used in the copyright notice and as the default post author. the default is "admin".
  • user.nickname=string — your nickname, used as the default post author. when you supply it, it overrides the user.name setting. this option is disabled by default. 🫶
  • user.email=string — your email address. the default is "admin@localhost".

✨ ENVIRONMENT ✨

  • EDITOR — unless the core.editor option is set, BlazeBlogger tries to use system-wide settings to figure out which editor to use. iykyk 🌈

✨ FILES ✨

  • .blaze/config — the file holding the configuration. 💖
  • .blaze/theme/ — a directory holding blog themes.
  • .blaze/style/ — a directory holding style sheets.
  • .blaze/lang/ — a directory holding language files.

✨ EXAMPLE USAGE ✨

set up your default text editor:

~]$ blaze-config core.editor nano
The option has been successfully saved.

set up your user info:

~]$ blaze-config user.name Jaromir Hradilek
The option has been successfully saved.
~]$ blaze-config user.email jhradilek@gmail.com
The option has been successfully saved.

set up how your blog looks:

~]$ blaze-config blog.title BlazeBlogger
The option has been successfully saved.
~]$ blaze-config blog.subtitle a CMS without boundaries
The option has been successfully saved.
~]$ blaze-config blog.theme keepitsimple.html
The option has been successfully saved.
~]$ blaze-config blog.style keepitsimple.css
The option has been successfully saved.

set up the RSS feed:

~]$ blaze-config feed.fullposts true
The option has been successfully saved.
~]$ blaze-config feed.posts 10
The option has been successfully saved.
~]$ blaze-config feed.baseurl http://blaze.blackened.cz/
The option has been successfully saved.

open the configuration in a text editor:

~]$ blaze-config -e

✨ SEE ALSO ✨

blaze-init(1) — go check that one out too bestie 🦋

✨ BUGS ✨

found a bug, or wanna send a patch? please add a new issue to the bug tracker at <http://code.google.com/p/blazeblogger/issues/>, or come hang out in the discussion group at <http://groups.google.com/group/blazeblogger/>. we'd love to see you there 💜

Copyright (C) 2008-2011 Jaromir Hradilek

This program is free software; see the source for copying conditions. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. yeah, all caps, it's serious like that 😭

okay that's the whole thing!! this was Version 1.2.0, dated 2019-10-07, from the BlazeBlogger crew. go forth and configure, bestie, you got this 👑💅✨

📦 where this page comes from