[英]How to add hyperlink to an image in python-docx
我使用python docx添加了一个图像。 现在,我想添加一个超级链接。 怎么做?
import io
import urllib
from docx import Document
from docx.shared import Inches
document = Document()
p = document.add_paragraph()
r = p.add_run()
url = r'http://www.example.com/a.jpg'
io_url = io.BytesIO(urllib.request.urlopen(url).read())
r.add_picture(io_url)
#TODO: add a hyperlink 'http://mywebsite.com' to r
document.save('example.docx')
非常感谢你。
似乎尚未通过docx
库实现向文档添加超链接的功能,但是在GitHub的问题单中描述了一种解决方法。
这是讨论的链接以及可用于添加超链接的特定代码片段。 您甚至可以为超链接添加color
或使其underlined
。 我不会在这里复制和粘贴代码,完全归功于参与广泛讨论的人。
下面的代码示例(对于此解决方法,在GitHub上为johanvandegriff致记。)
import docx
def add_hyperlink(paragraph, url, text, color, underline):
"""
A function that places a hyperlink within a paragraph object.
:param paragraph: The paragraph we are adding the hyperlink to.
:param url: A string containing the required url
:param text: The text displayed for the url
:return: The hyperlink object
"""
# This gets access to the document.xml.rels file and gets a new relation id value
part = paragraph.part
r_id = part.relate_to(url, docx.opc.constants.RELATIONSHIP_TYPE.HYPERLINK, is_external=True)
# Create the w:hyperlink tag and add needed values
hyperlink = docx.oxml.shared.OxmlElement('w:hyperlink')
hyperlink.set(docx.oxml.shared.qn('r:id'), r_id, )
# Create a w:r element
new_run = docx.oxml.shared.OxmlElement('w:r')
# Create a new w:rPr element
rPr = docx.oxml.shared.OxmlElement('w:rPr')
# Add color if it is given
if not color is None:
c = docx.oxml.shared.OxmlElement('w:color')
c.set(docx.oxml.shared.qn('w:val'), color)
rPr.append(c)
# Remove underlining if it is requested
if not underline:
u = docx.oxml.shared.OxmlElement('w:u')
u.set(docx.oxml.shared.qn('w:val'), 'none')
rPr.append(u)
# Join all the xml elements together add add the required text to the w:r element
new_run.append(rPr)
new_run.text = text
hyperlink.append(new_run)
paragraph._p.append(hyperlink)
return hyperlink
document = docx.Document()
p = document.add_paragraph()
#add a hyperlink with the normal formatting (blue underline)
hyperlink = add_hyperlink(p, 'http://www.google.com', 'Google', None, True)
#add a hyperlink with a custom color and no underline
hyperlink = add_hyperlink(p, 'http://www.google.com', 'Google', 'FF8822', False)
document.save('demo.docx')
我使用python-docx成功添加了一个带图片的超链接,下面的代码(在检查了上面的代码片段后,如何添加文本的超链接)。 请注意,它使用run._inline(),因此不能保证它始终有效。
new_paragraph = doc.add_paragraph()
new_run = new_paragraph.add_run()
facebook = new_run.add_picture('facebook 24x24 UAPurple.jpg', width=Cm(0.5))
r_id = new_paragraph.part.relate_to('http://facebook.com', docx.opc.constants.RELATIONSHIP_TYPE.HYPERLINK, is_external=True)
hyperlink = docx.oxml.shared.OxmlElement('a:hlinkClick')
hyperlink.set(docx.oxml.shared.qn('r:id'), r_id, )
facebook._inline.docPr.append(hyperlink)
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.