Jupyter 社区会议 2/28#

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

讨论区: Youtube

请注意

目的#

可以将其视为每月一次的虚拟 JupyterCon。这是一个宣布和分享 Jupyter 社区中发生的有趣事情的地方。

有关这些会议形式的更多讨论,请参阅此处的帖子。

简短报告、庆祝、表扬#

这是发布简短公告(无需讨论)的地方。

  • Isabela 非常感谢安全项目团队的灵活变通,并帮助社区会议在日历上安排了这次会议!

    • 安全会议现在是每月第一个和第三个星期二

    • 社区会议是最后一个星期二

    • 不再有冲突,可以将社区会议移到更友好的时间!:)

  • 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`
        
        • 将 Jupyter 小部件直接嵌入到 Markdown、图表、迷你图表

        • 更好地编织文档和代码

    • 正在进行的 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/讨论方面,是否正在考虑单元格元数据的更改?

        • 最简单的用例(某种程度上)标记单元格元数据以进行特殊处理或加工

与会者#

姓名

机构

GitHub 用户名

Rollin

NERSC

@rcthomas

Rowan

Curvenote / ExecutableBooks

@rowanc1

Gabriela Vives

QuantStack

GabrielaVives

韦恩·迪凯特

州立医学大学

@fomightez

Isabela Presedo-Floyd

Quansight Labs

@isabela-pf

另加 1 位。