Slidedown

• 你会✍️幻灯片吗？
• 你会😠PowerPoint吗？
• 你会❤️Markdown吗？

你太幸运了！

将这样的Markdown转换为幻灯片

# Step 1

Create an awesome slide deck.

# Step 2

Present it to awesome people.

# Step 3

Profit?

变成这样的幻灯片

怎么做？

1. 使用pip安装slidedown

pip install slidedown

2. 开始展示你的Markdown文件

slidedown README.md

3. 打开你的浏览器

http://localhost:5678/client/index.html

交互式元素

您可以使用IDOM将交互式视图嵌入到幻灯片中，通过在你的标记中添加一个具有形式为data-idom="your_script.py"的属性的自定义HTML元素来实现，其中your_script.py应放在与slidedown相同的目录中，并且必须包含一个返回IDOM元素或VDOM字典的函数Main()或main()。所有其他data-属性将被解释为传递给该函数的参数。

Slidedown中的IDOM示例

以下标记

# Hello IDOM!

<span data-idom="hello" data-greeting="hello" />

以及一个包含以下内容的脚本hello.py

import idom

@idom.component
def Main(greeting: str):
    hi_count, set_hi_count = idom.hooks.use_state(1)
    return idom.html.button(
        {"onClick": lambda event: set_hi_count(hi_count + 1)},
        f"IDOM said {greeting} {hi_count} time(s)",
    )

应产生以下输出

配置文件

Slidedown支持一个放置在Markdown旁边的slidedown.json配置文件，以便在运行时配置选项。可用选项与帮助消息（slidedown --help）中看到的选项相匹配，除了所有使用-的地方都替换为_。例如

{
  "host": "127.0.0.1",
  "no_browser": true,
  "no_reload": false,
  "port": 5678,
  "reload_delay": 3.0,
  "reload_ignore": ["ignore-dir/*"],
  "reload_watch": ["watch-dir/*"],
  "show_options": false,
  "start_slide": 0
}