textout/textoutpc/tags/builtin/Label.py

#!/usr/bin/env python3

from ..base import *
import re as _re

__all__ = ["TextoutLabelTag", "TextoutTargetTag"]

_v42compat = True
_labelexpr = _re.compile('^[a-z0-9-]{1,16}$', _re.I)

class TextoutLabelTag(TextoutInlineTag):
	""" The label tag, defines an anchor at a point of the post.
		Example uses:
		
		[label=installation]Installation de tel logiciel... (no ending req.)
		[label=compilation][/label] Compilation de tel logiciel...
	"""

	aliases = ('[label]',)

	def prepare(self, name, value):
		if not _labelexpr.match(value):
			raise Exception
		self._label = value

	def begin_html(self):
		#name = 'label-{}'.format(self._label)
		#if _v42compat:
		#	name += ' ' + self._label
		name = self._label if _v42compat else 'label-{}'.format(self._label)
		return '<a name="{}"></a>'.format(name)

class TextoutTargetTag(TextoutInlineTag):
	""" The goto tag, links to an anchor defined in the post.
		Example uses:
		
		[target=installation]Check out the installation manual[/target]!
	"""

	aliases = ('[target]',)

	def prepare(self, name, value):
		if not _labelexpr.match(value):
			raise Exception
		self._label = value

	def begin_html(self):
		#name = 'label-' + self._label
		name = self._label if _v42compat else 'label-' + self._label
		return '<a href="#{}">'.format(name)

	def end_html(self):
		return '</a>'

# End of file.