A header is used to specify the meta-data of a post, such as title or labels, it is also used to store information which is needed to update a post later on, such as id.
Generally, header can be simply formed as the following regardless which markup language handler you use:
!b
key1: value1
key2: value2
post content goes here
The handler will automatically reformed the header into comment after posting or updating, the format of comment depends on the markup language. For example, in reStructuredText, a header look like
.. !b
service: blogger
kind: post
title: Title of "something."
labels: comma, separated, list
categories: another, comma, separated, list
draft: False
blog: 12345
id: 54321
id_affix: foobar
url: http://example.com/2013/01/title-of-something.html
Making header into comment, so it wouldn’t be rendered out if it’s processed by tools other than b.py.
used for processing.
It could be added automatically after successfully posting.
See also
used in updating post and should not be edited by the user normally.
It could be added automatically after successfully posting.
used in updating post and should not be edited by the user normally.
It could be added automatically after successfully posting.
override the post title.
If not specified, the post title will be the filename without the extension.
type of the posting, post or page, default is post.
It could be added automatically after successfully posting.
categories, comma-separated list.
Only WordPress service uses this.
link of the post.
It could be added automatically after successfully posting.
the affix to HTML element ID.
See also
id_affix in handler options.