跳转至

代码片段(Snippets)

SMath Studio 内置了一种通过创建用户代码片段来扩展功能的机制。这些代码片段基于常规计算创建,必要时可以嵌入到其他计算中,让用户能够多次重复使用先前准备好的逻辑。

创建代码片段

代码片段基于在 SMath Studio 中准备好的标准计算。要创建这样的代码片段,请执行以下步骤:

  1. 在 SMath Studio 中新建一个工作表。
  2. 在该工作表中添加自定义函数、过程,并定义您希望对外提供访问的变量或计量单位。
  3. 完成工作表逻辑的填写后,需要为该工作表定义元信息,为此请进入 文件 > 属性... 对话框。
  4. 在 文件属性 对话框的 摘要 选项卡中,至少设置标题、作者和描述这几个字段。
  5. 在“文件属性”对话框的 文件设置 选项卡中,设置 代码片段快捷方式 字段,这将帮助您在未来的工作表中快速插入该片段。建议为该快捷方式使用唯一且简短的文本,不含空格或特殊字符。作为示例,您可以查看 SMath Studio 内置的代码片段,例如 grads 和 degrees。
  6. 将生成的工作表保存到本地,并将其移动到您电脑上的以下文件夹: %APPDATA%\SMath\extensions\snippets

完成上述步骤后,该代码片段即可供本地使用。

使用代码片段

有两种方式可以将可用的代码片段插入到工作表中:

  1. 使用可用的动态输入助手元素列表: 在工作表页面中,开始输入代码片段的快捷方式,并从下拉列表中选择所需的片段(可以用鼠标选择,也可以根据提示用键盘完成最终选择): 动态输入助手列表中提示的 degrees 代码片段
  2. 使用 SMath Studio 内置的扩展管理器。 在打开的对话框中,从左侧列表中选择代码片段,即可显示所有本地可用的代码片段。然后选择所需的代码片段,点击粘贴按钮。

发布代码片段

将您的代码片段发布到根许可证服务器,供第三方免费访问,这是可选操作。

要使您的代码片段成为向其他用户交付的标准流程的一部分,请完成以下步骤:

  1. 访问根许可证服务器,并确认您已使用自己的账户登录。
  2. 访问扩展注册页面。
  3. 在注册表单中,将扩展类型选择为 Snippet,指定代码片段文件的路径,然后点击注册按钮。