从工作表创建教程¶

Sage有很多 thematic tutorials 并包含在 Sage notebook （sagenb）进入教程。

警告

只有在Sage是使用python2而不是python3构建的情况下，以下操作才有效。从版本9.0开始，默认情况下是使用Python3构建Sage。因此，要么使用旧版本的Sage，要么使用python2构建Sage的新版本，方法是获取Sage tarball并执行以下操作

$ make configure
$ ./configure --with-python=2
$ make

一旦您创建了一个工作表并对文本和计算感到满意，请将其下载到一个目录中。

这里我们假设工作表调用 Tutorial.sws 这个目录叫做 make_tutorial . 我们也假设 sage 是你明智的命令；如果它不在你的 PATH 然后将其替换为Sage安装的路径，例如 /Applications/Sage-6.2.app/Contents/Resources/sage/sage 如果您正在使用Mac应用程序并将其放在应用程序目录中。

接下来，您将需要一个可选的包来解析您的工作表。使用命令：
```
$ sage --pip install beautifulsoup4
```
要安装它（或者，在Mac应用程序中，使用 Terminal Session 高级菜单 --pip install beautifulsoup4 ）
然后我们将使用 sws2rst 脚本将工作表转换为 ReStructuredText 格式。请确保与工作表位于同一目录中：
```
$ sage --sws2rst Tutorial.sws
```
这将创建一个 .rst 文件以及图像文件的子目录（如果没有图像，该子目录可能为空）。

你可以找到帮助 sws2rst 用命令 sage --sws2rst -h 一旦您安装了beautifulsoup4。
原则上，这样的文件可以直接添加到Sage的文档中（参见 developer's manual ). 但是，您可能需要先检查一下它是否正确。所以接下来我们将把这个文件编译成html文档。
- 遵循 sage --sws2rst --sphinxify . 首先，我们将打开一个Sage shell会话，其中所有适当的Sage引用都已正常工作：
```
$ sage --sh
```
  从这里，您应该能够只键入：
```
$ sphinx-quickstart
```
  然后根据提示将 .rst 归档到文档中。对于大多数情况，您只需按enter/return即可接受默认值。不过，你可能会想
  - 输入项目的名称
  - 请输入您的姓名
  - 类型 y 关于使用MathJax的问题
  记下这些说明；另一个要做的主要事情是将文件名添加到 index.rst ，然后做：
```
$ make html
```
  等待奇迹发生。要查看结果，请打开文件 make_tutorial/_build/html/Tutorial.html 使用浏览器，或使用图形文件系统导航到同一位置。
现在可以修改 .rst 文件更多，并重复编译步骤，直到它准备好包含，或只是作为一个HTML文件分发给其他Sage用户。（做 make pdf PDF版本。）

从工作表创建教程¶

Sage 中文文档

导航

Related Topics