如何使用 plotly python 导出带有链接的文本注释？

Question

我正在使用 python plotly '5.1.0' 来绘制气泡图。 我想做的是还添加一些包含网页链接的文本注释。当我在 jupyter notebook 中显示图形时，一切正常，但是我没有设法将带有工作链接的绘图保存为图片（我最喜欢的格式是 pdf，但我基本上尝试了所有可用的格式）。

这可能与情节？是否有其他库可以实现这一目标？

编辑：最终目标是使用乳胶将图片插入到pdf中，因此首选与此用法直接兼容的解决方案:)

这里使用相同的玩具代码来重现该行为：

import plotly.express as px
df = px.data.gapminder()

fig = px.scatter(df.query("year==2007"), x="gdpPercap", y="lifeExp",
                 size="pop", color="continent",
                 hover_name="country", log_x=True, size_max=60)
fig.add_annotation(text="""here is my <a href="https://rdcu.be/cB1Ds"><b>paper</b></a>""", x=4, y=50)
fig.show()

结果正确显示了一个可点击的链接：

但是，当我保存它时，链接消失了：

fig.write_image("fig1.pdf", engine="kaleido") # I also tried "orca" but doesn't help

Answer 1

似乎可用的解决方案并不总是可信的。这也许可以解释为什么没有标准的。我正要建议@rosa b. 的确切解决方案，但当我试图在我的最后复制它时它对我不起作用。可能是因为我使用了具有挑战性的svg 示例，其中包含两种不同类型的超链接：一种围绕形状，另一种围绕文本，以涵盖所有可能性，如下所示：

links.svg

<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg"> 
 <!-- A link around a shape -->
 <a href="http://www.example.com">
   <circle cx="50" cy="40" r="35" stroke="green" fill="red"/>
     <text x="50" y="40" text-anchor="middle" font-size="0.5em">
       www.example.com
     </text>
 </a>

 <!-- A link around a text -->
 <a href="http://www.foo.bar">
   <text x="50" y="90" text-anchor="middle">
     Foo.Bar
   </text>
 </a>
</svg>

当我执行rosa b.的解决方案时，在Windows环境下使用以下命令：

inkscape.com --export-area-drawing --export-type="pdf" --export-filename=links.pdf --export-latex links.svg

它确实生成了一个links.tex_pdf 文件，该文件也没有正确包含指向文本超链接的链接，建议使用\href{} 手动添加它。

我尝试了另一种解决方案，即使用 Google Chrome 将 svg 打印到 pdf，因为许多 PDF 转换器会将这些超链接过滤为不需要的注释。打印必须没有页眉或页脚，并且边距为 0。这使csv 的超链接保持不变。现在面临第二个挑战，将这个好的 pdf 包含到 LaTeX 中，因为 LaTeX 包含 pdf 再次过滤注释！

我了解了一个名为 pax 的包，您可以将其包含在内以更好地添加带有链接的 pdfs。我听从了他们的建议，最终得到了以下结果：

links.tex

\documentclass[a4paper,12pt,landscape]{article}
\usepackage{hyperref}
\usepackage{pdfpages}
% pdfpages loads graphicx

\usepackage{pax}

\iffalse
  \usepackage{hyperref}
  \hypersetup{
    filebordercolor={1 1 0},
  }
\fi

\begin{document}
  \includepdf[pages=-]{links}
\end{document}

我使用在线 LaTex 编辑器 Overleaf here 试了一下，现在我们在圆圈内得到了可点击的文本，但不是在外面。

我希望这个对您特定的svg 有用。

Answer 2

简答

虽然不优雅，但我建议创建一个没有链接的图像，然后使用tikz 和hyperref 在乳胶中手动将链接添加到图像：

\documentclass{article}
\usepackage{tikz}
\usepackage{hyperref}
\begin{document}

\begin{tikzpicture}
\begin{scope}
    \node[anchor=south west,inner sep=0] (image) at (0,0){\includegraphics[width=0.7\textwidth]{scatter_without_link.png}};
\begin{scope}[x={(image.south east)},y={(image.north west)}]
    \node [anchor=west] (note) at (0.6,0.70) {\href{https://stackoverflow.com}{Link}};
\end{scope}
\end{scope}
\end{tikzpicture}

\end{document}

长答案

您可以创建带有可点击链接的 svg。使用matplotlib 的最小工作示例是

import matplotlib.pyplot as plt
fig, ax = plt.subplots()
ax.scatter([1, 2, 3], [4, 5, 6])
text = ax.annotate("Link", xy=(2,5), xytext=(2.2,5.5),
                url='https://stackoverflow.com', 
                bbox=dict(color='w', alpha=1e-6, url='https://stackoverflow.com'))
fig.savefig('scatter.svg')

然后将 svg 转换为 pdf，例如使用inkscape 和命令行：

inkscape -D --export-type="pdf" scatter.svg --export-latex

这会生成带有散点图和可点击超链接的 pdf。

但是：在将 pdf 嵌入到您的乳胶文件中时保留超链接（例如，使用 svg package 或简单地使用 \input{scatter.pdf_tex}）是一个更困难的问题，因为 pdftex 似乎从包含文件（请参阅这个 10 年前的问题 How to preserve hyperlinks in included PDF?）。

注意：如果您想使用 svg 包，请确保 (1) Inkscape 已安装并在系统路径上，并且 (2) Latex 使用 shell-escape (--shell-escape) 运行已启用。

注 2：用于在 jupyter notebook 中显示 matplotlib 示例：

%config InlineBackend.figure_formats = ['svg']
import matplotlib.pyplot as plt
%matplotlib inline
fig, ax = plt.subplots()
ax.scatter([1, 2, 3], [4, 5, 6])
text = ax.annotate("Link", ... )  # same as above
plt.plot()