Jupyter 社区电话会议 2/28

日期: 2023年2月28日，太平洋时间上午8点 (你的时区)

讨论区: Youtube

请注意：

• 社区电话会被录制并发布到这个播放列表

• 这些笔记将被记录并发布在这里

• 所有在场人员都需遵守 Jupyter 行为准则

目的

把它想象成一个每月的虚拟 JupyterCon。这是一个宣布和分享 Jupyter 社区中发生的趣事的地方。

关于这些调用格式的更多讨论，请参见这里。

简报、庆祝、表扬

这是一个发布简短公告的地方（不需要讨论）。

• 伊莎贝拉 非常感谢安全项目团队能够灵活应对，并帮助社区电话会议在这个时间表上安排了时间！

  • 安全会议现定于每月的第一个和第三个星期二举行

  • 社区电话是上周二

  • 不再有冲突了，可以将社区电话会议移到更友好的时间！ :)

• Isabela 治理更新：软件指导委员会正在安排办公时间，并恢复所有其他职责。

议程项目

• @rowanc1 @agoose77 - jupyterlab-myst 概述和演示 https://github.com/executablebooks/jupyterlab-myst

  • MyST: 在可执行书籍项目中孵化的标记语言，上周独立出来

    • 10% 的 Python 文档是用 MyST 编写的，并且这一比例正在增加。

  • 向Javascript世界迈进 => 更好地与JupyterLab集成

  • 请访问 myst-tools.org，这是项目的全新网站。

  • MyST: 支持科学文档和出版物，导出为多种高质量PDF格式

    • 还渲染了 Jupyter 笔记本的静态版本

    • 需要添加哪些元数据和前言

    • 如何将计算思维引入出版

  • JupyterLab MyST 扩展

    • 文档顶部的丰富元数据（YAML）

      • 执行元数据单元格会为笔记本生成一个漂亮的顶部块

      • 比自定义HTML更好，可解析，更易于编辑和查看

    • 提示块：

      • 像“:::{important}”这样的括号指令

      • 还有像下拉菜单这样的类信息

    • 交叉引用

    • 在Markdown单元格中的内联执行

      • 语法可能会有变动

      • 角色和指令，例如：

        {eval}`1+1`
      

      • 直接在 Markdown、图形、迷你图表中嵌入 Jupyter 小部件

      • 更好的文档与代码结合

  • 正在进行中的 nbformat 研讨会和 MyST

    • 讨论扩展开发的挑战

    • 特别是，在文档中嵌入计算，最初并未被设想

    • 输入类型可能需要扩展

  • 静态发布，另见 https://thebe.readthedocs.io/en/stable/

    • 编写具有交互性的文档

    • 发布机制

    • 帮助促进互动性和计算体验，以实现文档的最终共享

  • 混合HTML和MyST及无障碍性？

    • 在开发过程中牢记这些问题

    • 使用小部件会变得更加困难

    • 努力使用与 Jupyter 相同的技术组件

    • => 随着 Jupyter 在上游小部件空间中的改进，这些改进会传播到这里

    • 可存档性、语义HTML、关注无障碍评分

      • https://myst-tools.org/docs/mystjs/accessibility-and-performance

• 正在进行中的 nbformat 工作坊讨论 @isabela-pf

  • 我们在笔记本中没有指定一种 Markdown 类型

  • 这在用户测试期间造成了一定的困难

  • 至少知道我们遵循哪种 Markdown 规范会很好

  • 存在网页可访问性指南，但它们之间的关联并不总是清晰。

  • 更清晰的说明会有帮助，因为住宿安排是在HTML级别挂钩的

  • 在研讨会上 @rowanc1:

    • 分成3组

      • 基于文本的格式，除了标准格式（例如 jupytext）

      • 细胞类型工作流程

      • 单元格内的Markdown格式

    • 笔记本的狂野西部，单元格元数据，人们如何使用它？

      • 值得注意的例子

        • 不通过 Jupyter/JupyterLab 的前端接口

        • 存储在单元格元数据中的可视化状态

        • 命名空间在注释中

      • 在单元格元数据方面，是否有关于PR/讨论的变更？

        • 讨论: ???

        • 或许 Jupyter 讨论区: 笔记本元数据用户体验

      • 最简单的使用案例（有点）标记单元元数据以进行特殊处理或处理

其他共享链接

这是一个存储在社区电话讨论中分享的链接的空间，这些链接可能与议程项目相关或独立于议程项目。

与会者

名称	机构	GitHub 用户名
Rollin	NERSC	@rcthomas
罗恩	Curvenote / ExecutableBooks	@rowanc1
加布里埃拉·维维斯	QuantStack	加布里埃拉·维维斯
韦恩·德卡特	上州医科大学	@fomightez
伊莎贝拉·普雷塞多-弗洛伊德	Quansight Labs	@isabela-pf

再加一个。