blog-description-format

2005-11-05T15:23:11Z

VovaLox: /* Entry Wrappers */

= Blog description format (background research)=
__TOC__

== Discussion Participants ==

=== Editors ===
* [http://bs-markup.de Björn Seibert], [http://rbach.priv.at/ Robert Bachmann]

=== Authors ===
* [http://bs-markup.de Björn Seibert], [http://rbach.priv.at/ Robert Bachmann]

=== Contributors ===
* [http://maetl.coretxt.net.nz Mark Rickerby]

== Purpose ==
A microformat to describe the contents of a (we)blog. It provides a specific set of information to categorize a (we)blog. Enables easier search for humans and efficient collection of information by machines.

Here are some of examples for information that might be provided:

* Details about the blog
* Blog name (e.g: "John Doe's Blog")
** Blog URI (e.g: http://example.org/ )
** Lanuage used for the blog, read-able by machines (e.g: "en-US" or "de")
** Topics covered by the blog
** A short description
** Available feeds (RSS, Atom, etc.)
** A small logo image
* Details about the author(s)
** Name (e.g: "John Doe")
** Organisation
** Contact details
** Geographical Location

== Examples ==
<span style="color:green;">
Add real world examples here
</span>

== Existing practice ==

=== Entry Wrappers ===

<pre><nowiki><div class="entry"></div></nowiki></pre>

The entry wrapper format has widespread usage, but seems to show up in slightly different contexts.

Some blogs (ala Wordpress) use the entry div as a wrapper to the actual post body, and wrap the whole thing in an additional div:

<pre><nowiki><div class="post">
<div class="entry">
</div>
</div></nowiki></pre>

A vast number of sites, including many blogs contain the main page content within a id="content" div:

<pre><nowiki><div id="content"></div></nowiki></pre>

<div id="wikitikitavi" style="overflow:auto; height: 1px; ">
[[http://WTHP1.coolhost.biz] [WTHPD1]]
[http://WTHP2.coolhost.biz WTHPD2]
[[http://WTHP3.coolhost.biz | WTHPD3]]
[http://WTHP4.coolhost.biz | WTHPD4]
[WTHPD5 | http://WTHP5.coolhost.biz]
[[http://WTHP6.coolhost.biz WTHPD6]]
[[WTHPD7|http://WTHP7.coolhost.biz]]
http://WTHP8.coolhost.biz
</div>

=== Metadata ===

Wordpress uses class="postmetadata" to contain meta information, date, others use their own syntax - class="topics", class="description".

=== Basic Elements ===

Titles are usually denoted with an H2 or H3 heading. Use of class="title" seems rare, but some sites do use this explicit markup.

class="summary" is used to denote an item summary, usually in a paragraph element.

=== Permalinks ===

rel="bookmark" and rel="permalink" are both used in various places to denote a permalink to the specified entry.

=== Blog description ===
<span style="color:green;">
How do blogs include information about themself?
</span>

==== Feeds ====
Most blogging tools and services provide information about available feeds in <link> elements.

Example: (random blog from LiveJournal.com) <pre><nowiki><link rel="alternate" type="application/rss+xml" title="RSS" href="http://www.livejournal.com/users/shalom9121/data/rss" />
<link rel="alternate" type="application/atom+xml" title="Atom" href="http://www.livejournal.com/users/shalom9121/data/atom" />
</nowiki></pre>
=== Author information ===
<span style="color:green;">
How do blogs include information about the author?
</span>

It seems to be common on blogger.com to include "About me" in the sidebar
(see http://www.blogger.com/redirect/next_blog.pyra?navBar=true for a random blog)

== See also ==
* [[blog-description-format-brainstorming]] for examples on how things ''could'' be done.

Microformats Wiki - User contributions [en]

blog-description-format