Idyll 如何发布作品并获得支持?

更新时间

Idyll 提供免费公共托管服务，作品可以发布到网上，页面说明称只需几秒即可完成。发布前需要先明确产物的形态：Idyll 既能生成独立网页，也能嵌入已有页面；样式上可选内置主题或提供自定义 CSS。若想先看成品效果，官网的示例画廊（example gallery）是现成的入口；进一步的项目说明和支持信息则在页面的 Support 部分。

发布前先确定产物形态

Idyll 的定位是“用于交互式文档的标记语言”，官方概述列出三类典型用途：可探索式解释（explorable explanations）、数据驱动故事，以及给博客引擎和内容管理系统增加交互性。这决定了发布方式有两种：

  • 独立网页：适合单独分享一个交互式解释或数据故事。
  • 嵌入已有页面：适合在现有博客或 CMS 中插入交互模块，而不另起一个站点。

样式方面，内置主题可以直接套用；需要匹配品牌或版式时，再提供自定义 CSS。这一步建议在发布前完成，因为托管发布的是最终产物。

发布到免费公共托管

页面明确提供免费公共托管服务，用于把创作发布到 Web，描述为“几秒内”完成。资料没有给出具体命令、账号要求或操作菜单，因此这里不编造步骤。可核对的行动路径是：

  1. 在本地完成文档，确认它能正常渲染、交互组件（如按钮、输入控件）按预期响应变量变化。
  2. 选择产物形态：独立网页，或准备嵌入的片段。
  3. 确定样式：内置主题或自定义 CSS。
  4. 使用官方免费公共托管服务发布，然后访问生成的地址验证效果。

如果发布后交互没有生效，优先检查变量绑定和组件属性是否写对——Idyll 的交互依赖变量更新后触发组件重新渲染，属性值写错时页面可能“看起来正常但不响应”。

用示例画廊和支持部分继续深入

官网概述页设有 Example Usage 与 Support 两个小节。Example Usage 展示了默认组件的用法，例如用 Chart 组件绘制正弦曲线：

[Chart equation:`(t) => Math.sin(t)` domain:`[0, 2 * Math.PI]` samplePoints:1000 /]

这段代码目前是静态图；把 equation、domain 换成变量后，图表就能随用户操作动态更新。页面给出的做法包括用 [var name:"func" value:Math.sin /] 声明变量，再通过按钮的 onClick 修改它：

[Button onClick:`func = Math.sin`]sin[/Button]
[Button onClick:`func = Math.cos`]cos[/Button]

也可以把变量绑定到标准输入控件上，例如用输入框调整 domain 的起点和终点。这类“变量 + 组件 + 事件”的组合，正是发布前最值得在本地验证的部分。

想了解项目全貌和获取帮助，从页面 Support 部分进入；想找可参考的成品，从 example gallery 进入。两者都是官网提供的入口，不需要额外注册即可浏览。

适用条件与限制

这套流程适合想快速把交互式文档放到网上、又不想自建托管的人。需要注意：资料只说明托管服务免费、发布快，未提及存储空间、自定义域名、访问统计或长期可用性等细节，这些应在正式依赖前自行确认。若作品需要嵌入已有站点，还要确认目标 CMS 是否允许插入 Idyll 生成的页面或片段。