从旧的Sage工作表(.sws)创建教程¶

很多教学材料都是以Sage工作表格式编写的，在过渡到Python3和删除SageNB包之后，Sage不再支持这种格式。

但是，可以转换Sage工作表文件。创建工作表并对文本和计算感到满意后，将其下载到目录中。

在这里，我们假设该工作表的名称为 Tutorial.sws 该目录被称为 make_tutorial 。我们还假设 sage 是您的Sage命令；如果它不在您的 PATH 然后将其替换为您的Sage安装路径，例如 /Applications/Sage-9.2.app/Contents/Resources/sage/sage 如果您正在使用Mac应用程序，并已将其放置在您的应用程序目录中。

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

您可以在以下位置找到帮助 sws2rst 使用命令 sage --sws2rst -h 一旦你安装了漂亮的水。
原则上，这样的文件可以直接添加到Sage的文档中(请参阅 developer's manual )。但是，您可能想先检查一下它看起来是否正确。所以接下来我们将把这个文件编译成html文档。
- 遵循的说明 sage --sws2rst --sphinxify 。首先，我们将打开一个SageShell会话，其中所有适当的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工作表(.sws)创建教程¶

上一主题

下一主题