在 GitHub Pages 发布网站或者软件文档现在只需要更少的步骤——精确来说是三步:
就像这样就行了——你现在已经拥有了一个网站。如果你已经对 GitHub Pages 熟悉了,你或许会对知道一些幕后的东西感兴趣,我们现在正在做一些事情去简化这个发布流程,并且让它更加如你所期待的那样在 GitHub 的其它地方创作 Markdown 内容。
---
符号分割的元数据)中解脱出来。
index.md
(或者 index.html
)的文件,我们会使用你的 README 文件作为站点的首页,就和你在 GitHub 浏览一个仓库时看到的一样。
page
布局,而如果 page
布局不存在,它会变成 default
布局。
这些改进应该能让你更快更简单的通过几次点击发布你的第一个(或者第一百个)网站,或者通过简单地添加 Markdown 文件到 /docs
目录 ,在仓库内给你的软件项目编写文档。当然,你依然可以通过额外的自定义设置(比如使用你自己的布局和样式来覆盖默认主题)来继续控制外观和体验。
虽然这些改动应该不会影响大多数现有站点的建设,但对于早期的 Jekyll 用户来说有两个潜在的陷阱:
forpageinsite.pages
),你可能会发现现在有额外的页面(比如第三方依赖库的 README 页面)在这个列表里。你可以使用配置文件里的 exclude
配置显式地排除这些文件。
null
。
如果出于任何原因你不想使用这些特性,你可以通过添加一个 .nojekyll
文件到你的站点根目录来禁用它们。
所以, GitHub Pages 生成过程是可以尽可能透明和可定制的,所有上面提到的特性都是以 Jekyll 的开源插件的形式实现的,也就是 Jekyll Optional Front Matter , Jekyll README Index , Jekyll Default Layout ,以及 Jekyll Titles from Headings 这些插件。
再者,这些变化不应该影响大多数现有站点的建设(虽然你可以安全的开始使用这些特性),但是如果你有任何问题,请联系我们。
三步发布快乐!
往期精选文章 |
---|
使用虚拟dom和JavaScript构建完全响应式的UI框架 |
扩展 Vue 组件 |
使用Three.js制作酷炫无比的无穷隧道特效 |
一个治愈JavaScript疲劳的学习计划 |
全栈工程师技能大全 |
WEB前端性能优化常见方法 |
一小时内搭建一个全栈Web应用框架 |
干货:CSS 专业技巧 |
四步实现React页面过渡动画效果 |
让你分分钟理解 JavaScript 闭包 |
小手一抖,资料全有。长按二维码关注京程一灯,阅读更多技术文章和业界动态。