I use Blogofile version 0.7.1 that I installed with easy install.
I wanted to make my own filter, and used the following documentation page as a reference:
http://docs.blogofile.com/en/latest/filters.htmlUnfortunately, I encountered issues, some of which I managed to figure out, others are still open. I will appreciate getting help or helpful comments on these.
1. I could not find where the default filter chain is located. I did a search on all files in the _template folder but could not find anything. I suspect that blog.content contains content already filtered by markdown and syntax_highlight in some default way. If this is the case, I think it should be documented as it is a bit confusing.
2. For out of the box Blogofile, post.mako does not inherit from base.mako, so using the filter macro as advised in the earlier linked page produced weird python errors.
3. My filters is using a regex to substitute a special tag similar to the $$code tag. The problem is that sometimes the excerpt cut the tag in the middle and when the regex is run on the excerpt, no match is found. This will display part of the tag in the excerpt text. I checked with $$code, and it does not syntax highlight in the excerpt, but there is also no remaining part of the opening tag.
4. I discovered that my filter is run too many times, which may lead to performance issues, this is because the filtering happens in post.mako, and this template is included in many others (categories, chronological etc.). I wish there were a way to "activate" the filter where markdown and syntax highlighting filters are located. So when blog.content i used in a template, it is already filtered by my filter.
5. It is worth noting that there is also an option to extend the markdown engine itself (
http://packages.python.org/Markdown/extensions/api.html). Have not tried it yet, but I believe it will not solve the excerpt cut in the middle issue.
Thank you,
Artium