def href(children, data):
"""Wrap text into a href.
>>> print(href ['www.test.org', 'important'].format().render_as('html'))
<a href="www.test.org">important</a>
>>> print(sentence ['ready', 'set', href ['www.test.org', 'go']].format().render_as('html'))
ready, set, <a href="www.test.org">go</a>.
"""
parts = _format_list(children, data)
return richtext.HRef(*parts)
def href(children, data):
"""Wrap text into a href.
>>> import pybtex.backends.html
>>> html = pybtex.backends.html.Backend()
>>> print(href ['www.test.org', 'important'].format().render(html))
<a href="www.test.org">important</a>
>>> print(sentence ['ready', 'set', href ['www.test.org', 'go']].format().render(html))
Ready, set, <a href="www.test.org">go</a>.
"""
parts = _format_list(children, data)
return richtext.HRef(*parts)
def href(children, data, url=None, external=False):
"""Wrap text into a href.
>>> print(href('www.test.org') ['important'].format().render_as('html'))
<a href="www.test.org">important</a>
>>> print(sentence ['ready', 'set', href('www.test.org') ['go']].format().render_as('html'))
ready, set, <a href="www.test.org">go</a>.
>>> print(href('www.test.org', external=True) ['important'].format().render_as('html'))
<a href="www.test.org" target="_blank">important</a>
>>> print(href('www.test.org', external=True) ['important'].format().render_as('latex'))
\\href[pdfnewwindow]{www.test.org}{important}
"""
parts = _format_list(children, data)
if url is None:
warnings.warn(
'href [url, text] is deprecated since 0.24: use uref(url) [text] instead',
DeprecationWarning,
stacklevel=2)
url, *parts = parts
return richtext.HRef(_format_data(url, data), external, *parts)
