有很多知名的项目,例如 webpack,【原创不易,请尊重版权】转载请注明出处:www.tangshuang.net会把自己的文档托管在 .js.org 域转载请注明出处:www.tangshuang.net【转载请注明来源】名下面。作为前端开发者,如果拥有一个 .【本文受版权保护】【本文受版权保护】js.org 为后缀的域名网站,确实是一著作权归作者所有,禁止商业用途转载。转载请注明出处:www.tangshuang.net件很酷的事。那么,怎么才能拥有一个 .j【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】s.org 域名的网站呢?我在实践之后,【版权所有】唐霜 www.tangshuang.net【原创内容,转载请注明出处】把这个过程写下来给你,希望对你有用。
【版权所有,侵权必究】未经授权,禁止复制转载。原创内容,盗版必究。Js.org 项目介绍
这是一个很酷的项目,项目的发起人注册了 本文作者:唐霜,转载请注明出处。著作权归作者所有,禁止商业用途转载。js.org 域名,并且免费提供给前端开著作权归作者所有,禁止商业用途转载。【作者:唐霜】发者使用它的二级域名。你可以在这里了解它的所有,同时,你还可以在 github 上关注他们。那么,这究竟是一个怎样的项【本文受版权保护】【未经授权禁止转载】目呢?
著作权归作者所有,禁止商业用途转载。【关注微信公众号:wwwtangshuangnet】著作权归作者所有,禁止商业用途转载。【关注微信公众号:wwwtangshuangnet】实际上,我们抛开他们的技术实现,它就是一未经授权,禁止复制转载。本文作者:唐霜,转载请注明出处。个域名服务。和我们以前注册域名,并绑定到【原创不易,请尊重版权】【本文首发于唐霜的博客】自己的主机上一模一样。
著作权归作者所有,禁止商业用途转载。本文版权归作者所有,未经授权不得转载。只是,它的操作过程比一般的域名服务(域名【转载请注明来源】【版权所有】唐霜 www.tangshuang.net注册和解析)麻烦很多。
【未经授权禁止转载】【版权所有,侵权必究】由于这个域名的特殊性,几乎知会有前端开发【转载请注明来源】著作权归作者所有,禁止商业用途转载。者去申请使用它。而这些使用该服务的开发者【原创不易,请尊重版权】【本文受版权保护】,很大一部分和我一样,用它来作为自己项目本文作者:唐霜,转载请注明出处。原创内容,盗版必究。的一个文档服务,给其他人阅读自己开发的库【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】或框架如何使用。但是,实际上,作为域名服原创内容,盗版必究。【本文首发于唐霜的博客】务,它根本不挑剔它所指向的,是一个文档服【访问 www.tangshuang.net 获取更多精彩内容】【版权所有,侵权必究】务,还是一个其他任何类型的应用。你可以试【版权所有】唐霜 www.tangshuang.net【原创不易,请尊重版权】试这个网址,再看看它用 js.org 之后的效果。你可以发现,这个搭在其他服务器上的网站【原创内容,转载请注明出处】本文版权归作者所有,未经授权不得转载。,通过将 js.org 域名绑定到自己的未经授权,禁止复制转载。原创内容,盗版必究。主机,就可以让访客用 js.org 域名【访问 www.tangshuang.net 获取更多精彩内容】【原创内容,转载请注明出处】访问自己的网站了。因此,js.org 真本文作者:唐霜,转载请注明出处。【作者:唐霜】的只是一个域名服务而已,不需要觉得它非常【本文受版权保护】【转载请注明来源】麻烦,是一个有多高门槛的服务。
【本文受版权保护】转载请注明出处:www.tangshuang.net转载请注明出处:www.tangshuang.net未经授权,禁止复制转载。创建自己的 github pages
作为开发者,怎么能没有一个自己的主页呢?【原创不易,请尊重版权】原创内容,盗版必究。当然,你可以使用自己的服务器,搭建一个像本文版权归作者所有,未经授权不得转载。【关注微信公众号:wwwtangshuangnet】我一样的 wordpress 个人网站,【原创不易,请尊重版权】【版权所有】唐霜 www.tangshuang.net这当然可以。但是,服务器,每个月都需要一著作权归作者所有,禁止商业用途转载。未经授权,禁止复制转载。定的费用。而使用 github page【本文受版权保护】【版权所有】唐霜 www.tangshuang.nets 则不需要费用,它是免费的。githu【关注微信公众号:wwwtangshuangnet】未经授权,禁止复制转载。b 给每一个开发者提供了一个免费的 gi【版权所有,侵权必究】著作权归作者所有,禁止商业用途转载。thub.io 子域名,二级域名名称就是【版权所有,侵权必究】【关注微信公众号:wwwtangshuangnet】开发者的注册 id,在你开通 githu【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.netb pages 服务之后,就可以使用这个【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处:www.tangshuang.net子域名了。
【原创内容,转载请注明出处】转载请注明出处:www.tangshuang.net那么,如何创建自己的 github pa【关注微信公众号:wwwtangshuangnet】【转载请注明来源】ges 呢?按照如下步骤操作即可。
【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】第一步,确定要用来作为 pages 的项目。
在 github 上创建一个新项目,作为本文版权归作者所有,未经授权不得转载。本文版权归作者所有,未经授权不得转载。要放 pages 的项目。很多个人博客就本文版权归作者所有,未经授权不得转载。【原创内容,转载请注明出处】是这么干的,那些博主在自己的 githu【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.netb 上创建了一个名字叫 xxx.gith【版权所有,侵权必究】本文版权归作者所有,未经授权不得转载。ub.io 的项目,然后将自己的网站源码【作者:唐霜】【本文首发于唐霜的博客】 push 到这个项目中。(这里需要注意【访问 www.tangshuang.net 获取更多精彩内容】【作者:唐霜】,pages 服务只接受静态资源,你如果本文版权归作者所有,未经授权不得转载。【版权所有,侵权必究】需要进行数据存储,只能采用前后端分离的方【关注微信公众号:wwwtangshuangnet】【原创内容,转载请注明出处】式,将数据存放到另外一个地方去,gh-p转载请注明出处:www.tangshuang.net转载请注明出处:www.tangshuang.netages(github pages) 只【本文受版权保护】著作权归作者所有,禁止商业用途转载。支持静态资源服务。)
【本文首发于唐霜的博客】本文作者:唐霜,转载请注明出处。本文作者:唐霜,转载请注明出处。除了上面这种方式。假如你和我一样,想要给本文版权归作者所有,未经授权不得转载。本文作者:唐霜,转载请注明出处。单个项目创建一个文档服务,那么,你可以有【本文首发于唐霜的博客】原创内容,盗版必究。两种选择:1)在项目 master 分支本文版权归作者所有,未经授权不得转载。转载请注明出处:www.tangshuang.net根目录下方创建一个 docs 目录,用于本文版权归作者所有,未经授权不得转载。【原创不易,请尊重版权】存放文档;2)创建一个新分支 gh-pa【版权所有,侵权必究】本文作者:唐霜,转载请注明出处。ges 作为存放文档的独立分支。我选择了本文作者:唐霜,转载请注明出处。【本文首发于唐霜的博客】第一种,因为对于要访问我项目的其他人而言【本文受版权保护】【原创内容,转载请注明出处】,他们可以点击 docs 目录,进去查看【作者:唐霜】【原创不易,请尊重版权】我写的文档,而无需切换分支。
本文作者:唐霜,转载请注明出处。本文作者:唐霜,转载请注明出处。这里相当于给了你 3 种选择。那么如何选【本文受版权保护】【作者:唐霜】择呢?一般而言:a. 当你要创建一个个人原创内容,盗版必究。【关注微信公众号:wwwtangshuangnet】/机构主页时,创建一个 xxx.gith【原创内容,转载请注明出处】本文版权归作者所有,未经授权不得转载。ub.io 的项目;b. 当你在给一个项【未经授权禁止转载】著作权归作者所有,禁止商业用途转载。目创建主页时,使用该项目的 gh-pag【关注微信公众号:wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.netes 分支;c. 当你在给一个项目创建主【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】页时,使用 master 分支下的 do本文作者:唐霜,转载请注明出处。未经授权,禁止复制转载。cs 目录。
【本文受版权保护】著作权归作者所有,禁止商业用途转载。个人/机构主页和项目主页的区别是,个人/原创内容,盗版必究。【作者:唐霜】机构主页网址就是域名,而项目主页的网址是本文版权归作者所有,未经授权不得转载。【转载请注明来源】域名后面还根上了项目名。这也是为什么很多本文版权归作者所有,未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】项目单独注册了一个机构,而非直接挂在作者未经授权,禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】自己的名字下。其中 b 和 c 看上去没著作权归作者所有,禁止商业用途转载。【本文首发于唐霜的博客】啥差别,但差别还是有,如果你多出一个 d著作权归作者所有,禁止商业用途转载。【版权所有】唐霜 www.tangshuang.netocs 目录,可能影响你项目代码但纯净性【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。,这种时候,使用一个独立分支单独存放项目本文版权归作者所有,未经授权不得转载。【未经授权禁止转载】主页代码,会使项目源码比较干净。
转载请注明出处:www.tangshuang.net【关注微信公众号:wwwtangshuangnet】未经授权,禁止复制转载。【本文首发于唐霜的博客】第二步,上传网站文件。
无论你选择了哪一种方式,你需要在每一种方【原创内容,转载请注明出处】未经授权,禁止复制转载。式的根目录下,放一个 index.htm本文版权归作者所有,未经授权不得转载。转载请注明出处:www.tangshuang.netl 作为首页。(docs 目录作为 gh【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net-pages 时,把 index.htm【版权所有】唐霜 www.tangshuang.net【关注微信公众号:wwwtangshuangnet】l 放在 docs 目录下。因为只允许提【作者:唐霜】本文作者:唐霜,转载请注明出处。供静态资源,所以,基本上,你只能靠 js【未经授权禁止转载】【作者:唐霜】 来完成编程了。
【本文首发于唐霜的博客】【本文受版权保护】完成网站的制作后,把对应的内容 push【作者:唐霜】本文版权归作者所有,未经授权不得转载。 到仓库中。
著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。【原创不易,请尊重版权】第三步,开启 pages 服务。
你已经完成了前两步。接下来,我们开启 p未经授权,禁止复制转载。【版权所有】唐霜 www.tangshuang.netages 服务。点击项目顶部导航中的 Settings 菜单,
转载请注明出处:www.tangshuang.net【原创不易,请尊重版权】本文作者:唐霜,转载请注明出处。
往下拉,找到 GitHub Pages 这个部分,
【原创内容,转载请注明出处】转载请注明出处:www.tangshuang.net
选择对应的 Source 选项。在最新版的 github 后台,著作权归作者所有,禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】点击其中一个选项之后,会自动刷新页面,并【访问 www.tangshuang.net 获取更多精彩内容】【作者:唐霜】且提示你 pages 已经发布成功,你可【关注微信公众号:wwwtangshuangnet】【转载请注明来源】以访问网页上出现的网址进行访问。
【作者:唐霜】本文版权归作者所有,未经授权不得转载。➡ 根据官方提示,只有在管理员的 pus【本文受版权保护】【版权所有】唐霜 www.tangshuang.neth 才能触发 pages 网站的更新,因【原创不易,请尊重版权】【版权所有】唐霜 www.tangshuang.net此要额外注意这一点。
著作权归作者所有,禁止商业用途转载。未经授权,禁止复制转载。【本文首发于唐霜的博客】本文作者:唐霜,转载请注明出处。现在,你可以使用 yourname.gi【版权所有,侵权必究】【关注微信公众号:wwwtangshuangnet】thub.io/yourproject 【本文受版权保护】【作者:唐霜】访问你的 pages 主页了。
未经授权,禁止复制转载。转载请注明出处:www.tangshuang.net域名绑定
对于 gh-pages 服务,它本身和 【本文首发于唐霜的博客】【关注微信公众号:wwwtangshuangnet】js.org 服务没有半毛钱关系。你可以【关注微信公众号:wwwtangshuangnet】本文作者:唐霜,转载请注明出处。把 gh-pages 当作是你自己的博客著作权归作者所有,禁止商业用途转载。【转载请注明来源】,现在,你可以使用其他域名绑定到 gh-【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】pages 的主页上。
转载请注明出处:www.tangshuang.net【未经授权禁止转载】第一步,CNAME 文件。
在文档根目录创建一个名为 CNAME 的文件,在这个文件中,其内容必须只能是【本文首发于唐霜的博客】【原创不易,请尊重版权】你要绑定的域名。例如我,就在 CNAME【本文首发于唐霜的博客】未经授权,禁止复制转载。 文件中,只写入如下内容:
nautil.js.org
然后将更新后的 pages 文件 pus【转载请注明来源】转载请注明出处:www.tangshuang.neth 到项目中。 经过测试,你不需要自己创建这个 CNAM【访问 www.tangshuang.net 获取更多精彩内容】【版权所有,侵权必究】E 文件,而是在执行下一步时自动帮你生成【作者:唐霜】【版权所有,侵权必究】这个 CNAME 文件。
这个时候,当你再访问 github 给你未经授权,禁止复制转载。【原创内容,转载请注明出处】默认配的域名地址时,你会发现,网址发生了【访问 www.tangshuang.net 获取更多精彩内容】本文作者:唐霜,转载请注明出处。跳转。
本文作者:唐霜,转载请注明出处。【版权所有】唐霜 www.tangshuang.net未经授权,禁止复制转载。第二步,绑定域名。
理论上,CNAME 被 push 之后,【转载请注明来源】【关注微信公众号:wwwtangshuangnet】github 应该自动给我做域名绑定。但【本文受版权保护】【本文首发于唐霜的博客】是实际上,并没有,CNAME 文件似乎只【版权所有】唐霜 www.tangshuang.net【版权所有,侵权必究】是为了实现跳转。而要将我们自己的域名绑定【原创不易,请尊重版权】本文作者:唐霜,转载请注明出处。到 gh-pages 服务上,还必须在刚【版权所有,侵权必究】本文版权归作者所有,未经授权不得转载。才操作的设置页面,填写要绑定的域名(必须著作权归作者所有,禁止商业用途转载。【本文受版权保护】和 CNAME 中的一致)。
原创内容,盗版必究。本文作者:唐霜,转载请注明出处。【未经授权禁止转载】
填写好,点击 Save 之后,在 github 所要做的事情就【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。完成了。
【原创不易,请尊重版权】【未经授权禁止转载】原创内容,盗版必究。第三步,域名解析。
如果你不是使用 js.org 域名,你需本文作者:唐霜,转载请注明出处。转载请注明出处:www.tangshuang.net要到你的 dns 服务商处去修改对应的解【原创内容,转载请注明出处】【原创不易,请尊重版权】析记录。这条解析记录应该是一个指向 yo【本文首发于唐霜的博客】【本文受版权保护】urname.github.io 的 C【转载请注明来源】【关注微信公众号:wwwtangshuangnet】NAME 记录。
未经授权,禁止复制转载。本文版权归作者所有,未经授权不得转载。当然,如果你要使用 js.org 域名,未经授权,禁止复制转载。本文作者:唐霜,转载请注明出处。请继续往下读。
【关注微信公众号:wwwtangshuangnet】原创内容,盗版必究。【版权所有】唐霜 www.tangshuang.net申请和绑定 js.org 域名
首先,你可以到 js.org 这个网站去看看,因为它本身就已经教你如本文作者:唐霜,转载请注明出处。本文版权归作者所有,未经授权不得转载。何操作了。接下来,你需要按照下面的步骤进【本文受版权保护】【本文受版权保护】行。
本文版权归作者所有,未经授权不得转载。转载请注明出处:www.tangshuang.net原创内容,盗版必究。第一步,fork 仓库。
进入 js.org 的主仓库,点击右上角的 Fork 按钮。稍等一下刷新页面。这样,这个仓库本文作者:唐霜,转载请注明出处。原创内容,盗版必究。就被 fork 到你自己的名下。
【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】【转载请注明来源】转载请注明出处:www.tangshuang.net第二步,修改代码。
将 fork 过来到仓库 clone 到【未经授权禁止转载】【原创不易,请尊重版权】本地,然后用编辑器打开,找到 cname著作权归作者所有,禁止商业用途转载。【原创不易,请尊重版权】s_active.js 文件,在里面看一【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】下,大概知道怎么回事了吧。添加你想要到二本文版权归作者所有,未经授权不得转载。转载请注明出处:www.tangshuang.net级域名,以及 CNAME 到的网址。注意【关注微信公众号:wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】,大家的约定都是按字母顺序排序的。照葫芦转载请注明出处:www.tangshuang.net原创内容,盗版必究。画瓢改好代码。push 回 github本文版权归作者所有,未经授权不得转载。本文作者:唐霜,转载请注明出处。。
原创内容,盗版必究。转载请注明出处:www.tangshuang.net【作者:唐霜】第三步,Pull Request。
回到你 fork 的仓库页面,找到一个叫 Pull Request 的按钮。点击它,提交。
本文版权归作者所有,未经授权不得转载。【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。这样就完成了域名申请和绑定了。是不是很简原创内容,盗版必究。【原创不易,请尊重版权】单。接下来的事情,就是等待,因为中美之间的时差关系,你最好在晚上 【版权所有】唐霜 www.tangshuang.net著作权归作者所有,禁止商业用途转载。12 点之前完成上面这些操作(根据indus的提醒,他实际上是在德国工原创内容,盗版必究。【作者:唐霜】作,因此时间比我们早)。等美国那边的项目维护者上线之后,就会对你的 p【原创不易,请尊重版权】原创内容,盗版必究。ull request 进行检查,如果没【访问 www.tangshuang.net 获取更多精彩内容】【作者:唐霜】有问题,就会 approve,一切顺利,未经授权,禁止复制转载。【原创不易,请尊重版权】就会 merge,之后很快你就可以用拿到本文作者:唐霜,转载请注明出处。【版权所有,侵权必究】的域名访问你的 gh-pages 了。
如果你有兴趣,还可以继续看看 ns_ac【版权所有,侵权必究】【版权所有,侵权必究】tive.js,看完之后,你就能再次明白【转载请注明来源】著作权归作者所有,禁止商业用途转载。,js.org 就是一个域名服务项目啊。
著作权归作者所有,禁止商业用途转载。本文版权归作者所有,未经授权不得转载。【关注微信公众号:wwwtangshuangnet】未经授权,禁止复制转载。使用 docsify
这也是一个超级酷的项目,专门为前端开发者【版权所有】唐霜 www.tangshuang.net【作者:唐霜】写 gh-pages 而生。这个项目本身【原创不易,请尊重版权】未经授权,禁止复制转载。是用 vue 实现的,但是它的使用极其方【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net便,让你感受到封装是多么爽的一件事。为什【作者:唐霜】【版权所有】唐霜 www.tangshuang.net么要使用 docsify 这个项目呢?因为它实在是太方便了,它的【原创不易,请尊重版权】原创内容,盗版必究。初衷,就是为 github 上的项目写文原创内容,盗版必究。原创内容,盗版必究。档而设计的。
【版权所有,侵权必究】【版权所有,侵权必究】【未经授权禁止转载】我们在项目中怎么写文档?当然是用 mar【版权所有】唐霜 www.tangshuang.net转载请注明出处:www.tangshuang.netkdown 来写。如果你要发布一个网页来转载请注明出处:www.tangshuang.net【转载请注明来源】组织文档,怎么想都会很麻烦,比如直接用 本文版权归作者所有,未经授权不得转载。【关注微信公众号:wwwtangshuangnet】html 写,不现实;比如用 md 写完【版权所有】唐霜 www.tangshuang.net著作权归作者所有,禁止商业用途转载。之后,本地用一个工具转为 html,例如【版权所有】唐霜 www.tangshuang.net【转载请注明来源】 gitbook 做的,也不如意。而 d本文版权归作者所有,未经授权不得转载。本文版权归作者所有,未经授权不得转载。ocsify 直接通过解析 md 文档来【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。实现渲染。你写文档就是写 md 文件,不【版权所有,侵权必究】未经授权,禁止复制转载。用做任何修改。只是,在你的 docs 目未经授权,禁止复制转载。【关注微信公众号:wwwtangshuangnet】录下,再加一个 index.html 即未经授权,禁止复制转载。转载请注明出处:www.tangshuang.net可。在这个 index.html 文档中本文版权归作者所有,未经授权不得转载。【本文受版权保护】,我们直接使用 docsify 的 CD【访问 www.tangshuang.net 获取更多精彩内容】【版权所有,侵权必究】N 文件,然后整个 pages 网站就渲著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。染好了。
【作者:唐霜】本文版权归作者所有,未经授权不得转载。【转载请注明来源】你可以阅读 nautil 的文档主页,然后查看源码,就可以发现,著作权归作者所有,禁止商业用途转载。【作者:唐霜】原来事情如此简单。
【版权所有,侵权必究】原创内容,盗版必究。转载请注明出处:www.tangshuang.net小结
本文啰啰嗦嗦讲了一大通,讲明白了 git本文作者:唐霜,转载请注明出处。原创内容,盗版必究。hub pages 服务和 js.org原创内容,盗版必究。【本文首发于唐霜的博客】 服务,这两个服务的使用方法,以及整篇文【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net章联系起来,如何快速给你的项目发布一个在【未经授权禁止转载】【关注微信公众号:wwwtangshuangnet】线文档的途径。虽然没有什么技术含量,但是【关注微信公众号:wwwtangshuangnet】【作者:唐霜】对于那些有这方面需要的小伙伴,应该也是相【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。见恨晚吧。
未经授权,禁止复制转载。【版权所有】唐霜 www.tangshuang.net2020-03-08 10757 github


