在 google code 项目首页（或 wiki）嵌入 slideshare

赖勇浩（http://laiyonghao.com）

我的开源项目 都是 host 在 google code 上的，而我的幻灯片 ，都是 host 在 slideshare 上的。之前倒也没有要把 slideshare 的幻灯嵌入项目首页或 Wiki 的需求，但 12 月份举办的珠三角技术沙龙 上，我写了个幻灯片 来讲我最近开放出来的 python-message ，然后我就想把这个幻灯片当成临时性的项目文档了，想把它嵌入到项目首页中去。在尝试的过程中，才发现 google code 的 wiki 语法 只支持限制的 html tags，想把带有 embed 或 iframe 标签的 slideshare 嵌进去，常规武器全部无效。

仔细研读 wiki 语法，发现它支持一种叫 gadgets 的东西，通过编写下面这一行代码，可以在里面嵌入一个完整的 html 页面，而页面的内容，是包含在 xml 文件中的：

<wiki:gadget url="http://example.com/gadget.xml" height="200" border="0" /> 

在曲折的研究过程（省略万字不提）之后，我终于把 slide share 嵌入了 Google code 项目首页，因为首页跟 wiki 用的是同一套东西，所以相信大家可以把这经验应用到 wiki 上去。大家可以点击这里 查看嵌入效果，看起来颇完美，不是吗？

最后，跟大家分享真正的嵌入方法：

1、打开 https://python-message.googlecode.com/svn/trunk/doc/python-message-0.1.0-slide-gadget.xml，把这个 xml 保存下来，最好 add 到你的项目 svn，然后 commit 上去。

2、把 Slideshare 的嵌入代码复制下来，用它覆盖掉 xml 文件中 <![CDATA[...]]> 中的那段 html 代码。

3、记下你的 xml 在 svn 上的 url，然后在 wiki 中增加这一行代码：

<wiki:gadget url="https://python-message.googlecode.com/svn/trunk/doc/python-message-0.1.0-slide-gadget.xml" width="700" height="360" border="0" />

记得把上面的 url 替换成你自己的 xml 文件的 url。

4、保存，测试，完成。

=========

这种方式，有一点点不完美的地方：

1、如果点击幻灯的 slideshare 连接，是直接在那个 iframe 里打开页面的。

2、不够通过性，希望有懂 html/js 的家伙花点时间做个通用的 gadget，然后大家把自己的幻灯片 URL 通过 wiki:gadget 参数传进去就行了，这样嵌入就会方便很多。