BLAZE-ADD(1)

✨ BLAZE-ADD(1) ✨

okay bestie, welcome to the BlazeBlogger Documentation glow-up 🎀 this is the manual page for blaze-add, and it's literally about to become your new fave command.

---

💖 NAME 💖

blaze-add — adds a blog post or a page to the BlazeBlogger repository. yes, that's the whole vibe. it puts stuff in. slay.

---

🌸 SYNOPSIS 🌸

blaze-add [-pqCPV] [-b directory] [-E editor] [-a author] [-d date] [-t
title] [-k keywords] [-T tags] [-u url] [file...]

blaze-add -h|-v

---

🦋 DESCRIPTION 🦋

so blaze-add adds a blog post or a page to the BlazeBlogger repository. that's the mission, that's the whole plot 🫶

if you hand it a file, it adds the content of that file. if you don't, it opens up an external text editor for you instead — like, it's gonna let you write your little heart out ✨

heads up bestie: there are several special forms and placeholders you can drop into the text, and they get swapped out for proper data when the blog is generated. more on those in a sec 👇

---

🌈 Special Forms 🌈

• <!-- break --> — a mark that delimits a blog post synopsis. it's giving "cut here for the teaser" 💅

---

⭐ Placeholders ⭐

these are the little magic words that get replaced with real paths when your blog gets generated:

• %root% — a relative path to the root directory of the blog.
• %home% — a relative path to the index page of the blog.
• %page[id]% — a relative path to a page with the supplied id.
• %post[id]% — a relative path to a blog post with the supplied id.
• %tag[name]% — a relative path to a tag with the supplied name.

iykyk 😌

---

💅 OPTIONS 💅

• -b directory, --blogdir directory — lets you specify a directory where the BlazeBlogger repository lives. default? the current working directory. classic.
• -E editor, --editor editor — lets you specify an external text editor. when you supply this, it overrides the relevant configuration option. no cap, it wins.
• -t title, --title title — lets you specify the title of a blog post or page.
• -a author, --author author — lets you specify the author of a blog post or page.
• -d date, --date date — lets you specify the date of publishing of a blog post or page.
• -k keywords, --keywords keywords — lets you specify a comma-separated list of keywords attached to a blog post or page.
• -T tags, --tags tags — lets you supply a comma-separated list of tags attached to a blog post.
• -u url, --url url — lets you specify the url of a blog post or page. allowed characters are letters, numbers, hyphens, and underscores. that's it, that's the guest list 🚫
• -p, --page, --pages — tells blaze-add to add a page or pages.
• -P, --post, --posts — tells blaze-add to add a blog post or blog posts. this is the default option, so it's the main character fr 👑
• -C, --no-processor — disables processing a blog post or page with an external application. for example, if you use Markdown to convert the lightweight markup language to valid HTML output, this lets you write this particular post in plain HTML directly. lowkey useful.
• -q, --quiet — disables displaying of unnecessary messages. shhh 🤫
• -V, --verbose — enables displaying of all messages. this is the default option. it's chatty and we love that for it 💬
• -h, --help — displays usage information and exits.
• -v, --version — displays version information and exits.

---

🍓 ENVIRONMENT 🍓

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

---

🎀 EXAMPLE USAGE 🎀

write a new blog post in an external text editor:

~]$ blaze-add

add a new blog post from a file:

~]$ blaze-add new_packages.txt
Successfully added the post with ID 10.

write a new page in an external text editor:

~]$ blaze-add -p

write a new page in nano:

~]$ blaze-add -p -E nano

look at us go 😭 iconic behaviour honestly

---

🔥 SEE ALSO 🔥

blaze-init(1), blaze-config(1), blaze-edit(1), blaze-remove(1), blaze-make(1)

---

💀 BUGS 💀

to report a bug or to send a patch, please, add a new issue to the bug tracker at <http://code.google.com/p/blazeblogger/issues/>, or visit the discussion group at <http://groups.google.com/group/blazeblogger/>.

don't be shy bestie, they wanna hear from you 🙈

---

👑 COPYRIGHT 👑

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.

---

and that's the whole page, bestie 💜 this was Version 1.2.0, dated 2019-10-07, brought to you by the BlazeBlogger girlies. go forth and add some posts, periodt 🧚✨