Question

我使用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')

非常感谢。

Answer 1

似乎docx库尚未实现向文档添加超链接的功能，但是在GitHub的问题单中有一个解决方法。

以下是讨论中的link＆amp;您可以用来添加超链接的特定代码段。您甚至可以将超链接设为color或将其设为underlined。我不会复制＆amp;在这里粘贴代码，完全归功于参与广泛讨论的人。

下面的代码示例（对于此解决方法，在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')

Answer 2

我使用带有以下代码的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)

如何在python-docx中为图像添加超链接

2 个答案: