在 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 文件中的:
在曲折的研究过程(省略万字不提)之后,我终于把 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 中增加这一行代码:
记得把上面的 url 替换成你自己的 xml 文件的 url。
4、保存,测试,完成。
=========
这种方式,有一点点不完美的地方:
1、如果点击幻灯的 slideshare 连接,是直接在那个 iframe 里打开页面的。
2、不够通过性,希望有懂 html/js 的家伙花点时间做个通用的 gadget,然后大家把自己的幻灯片 URL 通过 wiki:gadget 参数传进去就行了,这样嵌入就会方便很多。