此扩展定义了一个名为'sagecellserver'的指令，允许在sphinx文档中嵌入sage cell。要了解更多关于sage cell服务器的信息，请访问：http://aleph.sagemath.org/static/about.html

安装

1. 安装此扩展：'python setup.py install --user'
2. 将 'layout.html' 移动到您的 '_templates' 目录。如有必要，更改sagecell路径
3. 在 'conf.py' 中将 'icsecontrib.sagecellserver' 添加到您的扩展中

如何使用

用法示例：

.. sagecellserver::

    sage: A = matrix([[1,1],[-1,1]])
    sage: D = [vector([0,0]), vector([1,0])]
    sage: @interact
    sage: def f(A = matrix([[1,1],[-1,1]]), D = '[[0,0],[1,0]]', k=(3..17)):
    ...       print "Det = ", A.det()
    ...       D = matrix(eval(D)).rows()
    ...       def Dn(k):
    ...           ans = []
    ...           for d in Tuples(D, k):
    ...               s = sum(A^n*d[n] for n in range(k))
    ...               ans.append(s)
    ...           return ans
    ...       G = points([v.list() for v in Dn(k)],size=50)
    ...       show(G, frame=True, axes=False)


.. end of output

选项

可以通过将 'prompt_tag' 选项添加到 False 来删除 sage 提示：

.. sagecellserver::
    :prompt_tag: False

将 'prompt_tag' 设置为 True 与删除 ':prompt_tag:' 有相同的效果。

在生成 latex/pdf 时，sagecell 代码可以显示在 '\begin{verbatim}' 和 '\end{verbatim}' 标签内，或作为单个 \textbf 'SAGE CELL' 消息。此消息是 sage cell 存在的提醒。例如，此文本可以手动替换为 sagcell 示例的截图（通常是 @interact 示例）。

此选项由 'is_verbatim' 选项控制。默认为 'True'。

.. sagecellserver::
    :is_verbatim: True