====== Blogging with DokuVimKi ======

If you love [[http://www.dokuwiki.org|Dokuwiki]] and [[http://www.vim.org|Vim]]
you also propably know
[[http://www.chimeric.de/projects/dokuwiki/dokuvimki|DokuVimKi]], but do you use
it for blogging? I do, sometime at least, but what me really bugged, was that
there is no template, like the web frontend provides. But Vim wouldn't be Vim,
if it couldn't be fixed. So here is my solution.

To get it working the way I use DokuVimKi you just need to follow the following
steps:
=== How to install ===
== The shell alias ==
Put this function into your shell configuration (//.zshrc//, //.bashrc//)

<code bash>
function viDokuVimKiBlog() {
    if [ $# -lt 1 ]; then
        echo "You should give your blog article a title!"
        return
    fi
    TITLE="$*"
    DW_PATH=blog:`date +%Y:%m:%d`.`echo ${TITLE} | sed 's# #.#g'`
    vim +DokuVimKi +"DWNew ${DW_PATH}" +"silent! 0r ~/.vim/templates/blog.dokuwiki.tpl" \
    +"%s/%TITLE%/${TITLE}/g"
}
alias viblog='viDokuVimKiBlog'
</code>

== The template ==

Create a template diretory:
<code bash>
% mkdir ~/.vim/templates
</code>

Create you template called //blog.dokuwiki.tpl//:
<code bash>
% cat << EOF > ~/.vim/templates/blog.dokuwiki.tpl
====== %TITLE% ======







~~NOTOC~~
EOF
</code>

=== How to use ===

The next time you want to blog you can start the whole environment with

<code bash>
% viblog This is a new entry to my blog
</code>

This will start vim and create a new page in the namespace defined by the
**DW_PATH** variable in your shell configuration. You may need to modify it. I
use the following namespace to blog:
<code>
  blog:%year%:%month%:%day%.%title_of_entry%
</code>

=== Updates ===
**Update #1**: I've fixed the **viDokuVimKiBlog()** function. Within the if-fi-statement was an //exit//, which causes your shell/terminal to logout/close. The correct function is a simple //return//.

**Update #2**: Fixed some stupid typos.





~~NOTOC~~