BLAZE-EDIT(1)

💅 blaze-edit — the manual, but make it cute

okay bestie, welcome to blaze-edit, part of the BlazeBlogger Documentation era. this is the little command that opens up your blog post or your page in a text editor so you can ✨edit it✨. no cap.

---

🌸 NAME 🌸

blaze-edit — edits a blog post or a page in the BlazeBlogger repository 🫶

---

✨ SYNOPSIS ✨

blaze-edit [-fpqCPV] [-b directory] [-E editor] id

blaze-edit -h|-v

---

🦋 DESCRIPTION 🦋

so here's the vibe: blaze-edit opens an existing blog post or page — the one with the id you hand it — in an external text editor. main character behaviour honestly.

and like, heads up? there are some special forms and placeholders you can drop into the text, and when the blog gets generated, they get swapped out for the actual proper data. it's giving magic. 🔥

🎀 Special Forms

• <!-- break --> — a mark to delimit a blog post synopsis. that's it, that's the form.

🌈 Placeholders

• %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.

---

👑 OPTIONS 👑

• -b directory, --blogdir directory — lets you say exactly which directory the BlazeBlogger repository lives in. default? the current working directory. classic.
• -E editor, --editor editor — lets you pick your external text editor. when you supply this, it overrides the relevant configuration option. you're in charge, periodt.
• -p, --page — tells blaze-edit to edit a page or pages.
• -P, --post — tells blaze-edit to edit a blog post or blog posts. this one is the default btw.
• -f, --force — tells blaze-edit to create an empty source file in case it does not already exist. and if the core.processor option is enabled, this file is used as the input to be processed by the selected application.
• -C, --no-processor — disables processing a blog post or page with an external application.
• -q, --quiet — disables displaying of unnecessary messages. shhh 🤫
• -V, --verbose — enables displaying of all messages. this is the default option, so she's chatty by nature 💬
• -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 🍓

edit a blog post in an external text editor:

~]$ blaze-edit 10

edit a page in an external text editor:

~]$ blaze-edit -p 4

edit a page in nano:

~]$ blaze-edit -p 2 -E nano

---

💜 SEE ALSO 💜

blaze-config(1), blaze-add(1), blaze-list(1) — go read those too, iykyk 🫶

---

💀 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/>. not me sending you straight to the issue tracker 😭

---

⭐ 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.

---

fr fr, that's the whole thing. no notes. 💅

okay that's a wrap bestie — this was Version 1.2.0, dated 2019-10-07, from the BLAZE-EDIT(1) era of the BlazeBlogger Documentation. slay, go edit something iconic ✨🎀