py-wikimarkup 2.3.0

摘要

按照MediaWiki语法格式化文本。

用法

从Wiki返回HTML

from wikimarkup.parser import Parser

parser = Parser()
html = parser.parse(text[, show_toc=True])

返回没有某些“令人讨厌”的元素（待定：定义令人讨厌）的HTML，例如标题

from wikimarkup.parser import parselite

parselite(text)

添加新标记

您可以使用registerTagHook方法添加新标记。

from wikimarkup.parser import Parser
import cgi

def blockquoteTagHook(parser_env, body, attributes={}):
    """<quote[ cite="Person"]>A paragraph of text.</quote>"""
    text = ['<blockquote>']
    if 'cite' in attributes:
        text.append('<cite>%s</cite>' % (cgi.escape(attributes['cite']),))
    text.append(parse(body.strip()))
    text.append('</blockquote>')
    return u'\n'.join(text)

parser = Parser()
parser.registerTagHook('quote', blockquoteTagHook)

添加内部链接

您可以使用registerInternalLinkHook方法支持[[内部链接]]。默认情况下没有处理内部链接。如果没有钩子处理链接，则链接将保持不变地出现在输出中。内部链接可能有一个namespace:前缀。钩子按命名空间注册，对于无前缀的链接使用‘None’

def internalLinkHook(parser_env, namespace, body):
    ...
    return replacement

parser.registerInternalLinkHook(None, internalLinkHook)  # called for [[link]]
parser.registerInternalLinkHook('Wikipedia', hook)       # called for [[Wikipedia: Link]]
parser.registerInternalLinkHook(':en', hook)             # called for [[:en:link]
parser.registerInternalLinkHook(':', hook)               # called for [[:any:link]]
parser.registerInternalLinkHook('*', hook)               # called for [[anything]]

示例

from wikimarkup.parser import Parser

def wikipediaLinkHook(parser_env, namespace, body):
    # namespace is going to be 'Wikipedia'
    (article, pipe, text) = body.partition('|')
    href = article.strip().capitalize().replace(' ', '_')
    text = (text or article).strip()
    return '<a href="http://en.wikipedia.org/wiki/%s">%s</a>' % (href, text)

parser = Parser()
parser.registerInternalLinkHook('Wikipedia', wikipediaLinkHook)

print parser.parse("[[Wikipedia:public transport|public transportation]]")
print parser.parse("[[Wikipedia: bus]]")

import settings
from pytils.translit import slugify
from blog.models import Post

def byteflowLinkHook(parser_env, namespace, body):
    (article, pipe, text) = body.partition('|')
    slug = slugify(article.strip())
    text = (text or article).strip()
    try:
        post = Post.objects.get(slug=slug)
        href = post.get_absolute_url()
    except Post.DoesNotExist:
        href = '#'
    return '<a href="%s">%s</a>' % (href, text)

parser.registerInternalLinkHook(None, byteflowLinkHook)

parser.parse("[[Blog post title]]")