Kuma:酷炫的 URL 技巧

如果您正在尝试自动化操作,或者想要能够从 Mozilla 开发者网络 维基中提取信息,那么可以使用一些有用的 URL 查询来帮助您。今天,我将分享这些技巧。

Kuma API

虽然我们还没有可写的 API(我们知道这是一个问题,并且正在设计一个解决方案),但我们确实有各种方法可以访问有关维基页面的一些有用信息。

命令 描述
?raw 指示 Kuma 返回页面的原始内容,不包含任何皮肤材料,例如标题、页脚等。此操作不会执行模板或脚本。例如,https://mdn.org.cn/en-US/docs/HTML/HTML5?raw
&macros 指示 Kuma 执行页面中的所有模板。例如:https://mdn.org.cn/en-US/docs/HTML/HTML5?raw&macros
&include 告诉 Kuma 去除任何具有“noinclude”类的块。这对于获取输出在包含在另一个页面中时显示的方式,而不是作为独立页面显示的方式很有用。通常,这会删除示例代码等(尽管并非总是如此)。
&section=[section-id] 指示 Kuma 仅返回具有指定锚名称的部分的内容;例如:https://mdn.org.cn/en-US/docs/HTML/HTML5?raw&section=Introduction_to_HTML5
$json 告诉 Kuma 以 JSON 对象的形式描述页面;此对象基本上与使用 KumaScript 例程 wiki.getPage() 获取的对象相同。例如:https://mdn.org.cn/en-US/docs/HTML/HTML5$json

这些提供了许多功能,希望对构建开发者工具和其他实用程序的人们有所帮助。

Kuma Feed

除了上面描述的 API 之外,我们还提供了一些 Feed。将来可能会增加更多 Feed,其中一些仍在开发中,但这些信息可能仍然对您有用。

所有 Feed 都以字符串“https://mdn.org.cn/<locale>/docs/feeds/<format>/”开头,其中<locale> 是标准语言环境字符串之一,例如“en-US”、“ja”等。请注意,目前,您指定的语言环境不会影响输出,但将来可能会影响(实际上,我希望会)。<format> 是“atom”、“rss”或“json”之一。

Feed 描述
all 所有最近更改的文章,按修改日期排序。这包括新创建的文章。每篇文章的所有更改都合并到 Feed 中的一个条目中。
revisions 对文章进行的每个修订,按修改日期排序,包括新创建的文章。每个修订在 Feed 中都有一个单独的条目。
tag/<tagname> 最近更改的文章,按修改日期排序。Feed 中仅包含具有指定标签的文章。
files 最近更改或上传的文件。
needs-review[/<reviewtype>] 已选中指定审查请求的文章列表,或者如果您未指定审查类型,则所有已请求审查的文章。审查类型可以是“tech”、“editorial”或“kumascript”之一。

例如,您可以这样获取最近更改并带有“JavaScript”标签的文章的 Atom 格式 Feed:https://mdn.org.cn/en-US/docs/feeds/atom/tag/JavaScript

总结

希望这些对您有所帮助!还有更多内容即将推出,但这些是一个很好的开始!尽情享受吧!


4 条评论

  1. les orchard

    更正一点 - 对于 Feed,通用基本 URL 为

    https://mdn.org.cn//docs/feeds//

    其中 {locale}(例如 en-US、fr、ja)是语言环境,{format} 是 rss、atom 或 json 之一。当格式为“json”时,URL 接受 ?callback 参数以将数据包装在函数调用中,类似于 JSONP。

    例如
    https://mdn.org.cn/en-US/docs/feeds/atom/tag/JavaScript
    https://mdn.org.cn/en-US/docs/feeds/rss/tag/JavaScript
    https://mdn.org.cn/en-US/docs/feeds/json/tag/JavaScript?callback=processfeed

    2012 年 8 月 9 日 06:59

  2. les orchard

    糟糕。评论吃掉了我的占位符。我的意思是这个基本 URL

    https://mdn.org.cn/{locale}/docs/feeds/{format}/

    2012 年 8 月 9 日 07:00

  3. Salman Abbas

    非常酷。也许可以启用 CORS :P

    2012 年 8 月 9 日 18:46

    1. Eric Shepherd

      我们本周讨论了 CORS。我不知道什么时候会实现,但我预计最终会实现。

      2012 年 8 月 9 日 20:31

本文评论已关闭。