推广 MDN

喜欢 MDN?那就通过推广 MDN,将开放的 web 知识精髓分享给志同道合的 Web 开发者们吧。我们有一些主意可以帮助你进行推广。我们还有壁纸、标签、海报、动画、网站徽标等素材可供你使用。

想知道更多关于 MDN 的信息或者怎样帮助制作一个完善的 Web 文档吗?请点击关于 MDN 以及为 MDN 做贡献

在社交媒体上分享链接

你是否发现某篇 MDN 上的文章特别有用? 在 TwitterFacebookHacker News 以及 Reddit 上分享吧,或者在任何你想分享好东西的地方。到时候通过 @MozDevNet 提醒一下我们就更好了。毫无疑问,这不是强制性的。

在回答问题时带上 MDN 的链接

不管是 Stack Overflow 上的问题,还是在 Twitterverse 中的帖子,又或者是你的同事在团队闲聊时无意中提到的提问,只要是关于 Web 开发的问题,你通常能够从 MDN 上找到答案。你可以分享 MDN 上的链接,来帮助提问者获取最好的 Web 开发资料。

在技术讨论中引用 MDN

当你是在当地 JavaScript 见面会上或者是一个大型技术会议上做演讲时,MDN 经常会有一些文章能够补充你的演讲主题或者为你的听众提供进一步的知识背景。如果你的演讲有线上版本,那么通过 @MozDevNet 发给我们一个链接是很棒的事情。但最重要的事情是你把好的知识分享给那些需要它的人们。

WordPress 插件

这篇博客:一个用于推广 MDN 的 WordPress 插件可以帮助那些在自己博客上发表有关 Web 技术或者和 Mozilla 有关的产品的人提升他们博客以及 MDN 本身的质量。以下是两种方式:

  1. 当你发表一篇博客的时候,它会自动链接一些术语(比如“HTML”,“JavaScript”,“CSS"或者其他一些相关术语) 到 MDN 的词条。这可以让你在写技术博客的时候不需要做任何事就可以自动添加 MDN 相关文档的链接。这非常有用!MDN 上的术语和它们的目标页面被配置在 GitHub 上的 def-list 分支上。
  2. 在编辑博客的时候,会出现一个“告知 Mozilla 本篇文章”的复选框,此复选框会向 Mozilla 团队发出邮件。如果可能,我们可以在特定页面或者推特中提到你的这篇博客。选中此复选框并不保证这篇博客一定会在 MDN 中被提到,但是无论如何都会引起别人的注意!

安装此插件对你以及 MDN 都有很大帮助,如果你还没有安装的话,快点此进行安装吧!如果你想完善此插件,请前往 wp-promote-mdn 的 GitHub repo

JavaScript 实现

上面提到的 WordPress 插件是自动链接关键词到 MDN 相关文档的方式中的一种。如果你的博客并未运行在 WordPress 上,你可以嵌入以下 JavaScript 代码段来实现相同的功能。这段代码和 WordPress 插件的功能是完全一样的,它会自动把文章中已知的术语链接到 MDN 的相关文档上。

你可以通过更改对象 omaxLinks 属性的值,来更改关键词链接的最大数量,你也可以指定要搜索的元素、创建链接的类名、以及额外要搜索的关键词和其对应的URL。

你只需要把这段代码在</body>标签关闭前嵌入你的页面中。

<script type="text/javascript" >
    (function (d,f,a) {
        // 在这里更改设置(译者注:记得修改/去除 extraLinks 中的默认项~
        var o = {
            maxLinks: 4,
            searchElements: ['div', 'h'],
            linkClass: 'link-to-mdn',
            extraLinks: {'keywordx': 'http://example.com'}
        };

        var s=d.createElement("script");s.type="text/javascript";if(s.f){
        s.a=function(){if(s.f=="loaded"||s.f=="complete"){s.a=null;
        PromoteMDN(o)}}}else{s.onload=function({PromoteMDN(o)}}
        s.src="https://raw.githubusercontent.com/riverspirit/promote-mdn-script/master/promote-mdn.js";
        d.getElementsByTagName("head")[0].appendChild(s)
    })(document,'readyState','onreadystatechange');
</script>

这段代码会优先加载 GitHub 上的代码。如果你想把源代码保存在自己的服务器上(为了安全或者性能等),只需要从 GitHub 上下载源代码,把它添加到你自己的网站中,并修改第 9 行的 URL 即可。

网站横幅图片

如果你想在你的网站上通过横幅来宣传 MDN 的话,我们提供了数张图片供你选择:

MDN Banner: 240x240px Better Docs for a Better Web

By Developers for Developers

Better Docs for a Better Web

欢迎在你的网站上使用这些图片来作为 MDN 的友情链接!

桌面壁纸

在2006年火狐开发者大会上,Sean Martell 基于 ChrisBeard 的想法设计的图片在2007年的 SXSW 大会上轰动一时。现在提供以下分辨率的图片:

这些壁纸图片在 Creative Commons Attribution-NonCommercial 下发行。这些壁纸图片也受 Mozilla 商标政策 的保护。