样例：使用tkz-graph嵌入图像

使用tkz-graph包可以在你的文档中嵌入高清晰度的图像,它是基于pgf库的tikz前端来构建的。要使用这些组件就必须在系统目录中安装TeX,但某些TeX发行版仓库中可能并没有导入它们的最新版本。所以最好将它们放在你个人的texmf工具链里。安装、维护、自定义你的TeX安装并不在本文档的讨论范围内,不过你可以去查找相关的问题、文档来找到答案。一些必要的注意事项可以在全功能的TeX体验里看到。

首先,我们需要将相关的软件包添加到最终的LaTeX文档的preamble区种。使用dvi不能正确生成图像,所以我们建议使用pdflatex引擎进行渲染。在Sage命令行中输入类似view(graphs.CompleteGraph(4))的命令可以成功生成一个包含完整图形$K_4$的PDF文件。

为了在notebook中获得类似的体验,必须使用”mathjax避免列表”来禁用MathJax处理包含图形的LaTeX代码。图像被包含在tikzpicture环境中,所以将这个标识包含在避免列表中的一个不错的选择。 现在,工作表中的view(graphs.CompleteGraph(4))应该调用了pdflatex创建PDF,然后convert将提取出PNG图形以插入到工作表的输出单元格中。以下命令说明了在笔记本中获取由LaTeX处理的图形的步骤。

  1. sage: from sage.graphs.graph_latex import setup_latex_preamble
  2. sage: setup_latex_preamble()
  3. sage: latex.extra_preamble() # 取决于系统中TeX的安装位置
  4. '\\usepackage{tikz}\n\\usepackage{tkz-graph}\n\\usepackage{tkz-berge}\n'
  5. sage: latex.engine('pdflatex')
  6. sage: latex.add_to_mathjax_avoid_list('tikzpicture') # not tested
  7. sage: latex.mathjax_avoid_list() # not tested
  8. ['tikz', 'tikzpicture']

现在,输入类似view(graphs.CompleteGraph(4))的命令让pdflatex处理tkz-graph得到的图形并插入到notebook中。请注意,有多个调整tkz-graph在LaTeX中呈现图形的方式的选项(这不在本节讨论范围内),有关说明和详细信息,请参见参考手册标题为”LaTeX的图形选项”的部分。