如果您正在尝试自动化操作,或者想要能够从 Mozilla 开发者网络 维基中提取信息,那么可以使用一些有用的 URL 查询来帮助您。今天,我将分享这些技巧。
Kuma API
虽然我们还没有可写的 API(我们知道这是一个问题,并且正在设计一个解决方案),但我们确实有各种方法可以访问有关维基页面的一些有用信息。
命令 | 描述 |
---|---|
?raw | 指示 Kuma 返回页面的原始内容,不包含任何皮肤材料,例如标题、页脚等。此操作不会执行模板或脚本。例如,https://mdn.org.cn/en-US/docs/HTML/HTML5?raw |
¯os | 指示 Kuma 执行页面中的所有模板。例如:https://mdn.org.cn/en-US/docs/HTML/HTML5?raw¯os |
&include | 告诉 Kuma 去除任何具有“noinclude”类的块。这对于获取输出在包含在另一个页面中时显示的方式,而不是作为独立页面显示的方式很有用。通常,这会删除示例代码等(尽管并非总是如此)。 |
§ion=[section-id] | 指示 Kuma 仅返回具有指定锚名称的部分的内容;例如:https://mdn.org.cn/en-US/docs/HTML/HTML5?raw§ion=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 条评论