---
name: "blaze-edit"
section: "1"
platform: "linux"
package: "blazeblogger"
version: "1.2.0-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/blaze-edit"
---

# blaze-edit(1)

edits a blog post or a page in the BlazeBlogger repository

## 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

**blaze-edit** opens an existing blog post or a page with the specified *id* in an external text editor. Note that there are several special forms and placeholders that can be used in the text, and that will be replaced with a proper data when the blog is generated.

### Special Forms

- **\<!-- break --\>**

  A mark to delimit a blog post synopsis.

### 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*

  Allows you to specify a *directory* in which the BlazeBlogger repository is placed. The default option is a current working directory.

- **-E** *editor*, **--editor** *editor*

  Allows you to specify an external text *editor*. When supplied, this option overrides the relevant configuration option.

- **-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 is the default option.

- **-f**, **--force**

  Tells **blaze-edit** to create an empty source file in case it does not already exist. 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.

- **-V**, **--verbose**

  Enables displaying of all messages. This is the default option.

- **-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-config/1.md), [**blaze-add**(1)](/blaze-add/1.md), [**blaze-list**(1)](/blaze-list/1.md)

## 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/\>.

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