发布 GitHub Pages,现在就像数 1, 2, 3 那样简单

在 GitHub Pages 发布网站或者软件文档现在只需要更少的步骤——精确来说是三步:

  1. 创建一个 GitHub 仓库(或者选择一个已经创建好的仓库);
  2. 像你提交其它任何文件一样,通过 GitHub 的网页提交一个 Markdown 文件;
  3. 在你的仓库设置那里激活 GitHub Pages 。

就像这样就行了——你现在已经拥有了一个网站。如果你已经对 GitHub Pages 熟悉了,你或许会对知道一些幕后的东西感兴趣,我们现在正在做一些事情去简化这个发布流程,并且让它更加如你所期待的那样在 GitHub 的其它地方创作 Markdown 内容。

  1. 所有的 Markdown 文件现在都被 GitHub Pages 渲染,把你从需要给每个文件添加 YAML 前置描述(在文件顶部由 ---符号分割的元数据)中解脱出来。
  2. 如果你没有一个名为 index.md(或者 index.html)的文件,我们会使用你的 README 文件作为站点的首页,就和你在 GitHub 浏览一个仓库时看到的一样。
  3. 如果你没有在你的站点配置文件里指定主题(或者根本就没有站点配置文件),我们将设置一个最小化的、和其它在 GitHub 上的 Markdown 文件的外观及体验相匹配的默认主题。
  4. 如果一个给定的文件没有明确的指明使用什么布局,我们将根据它的上下文指定一个。举个例子,页面会自动的变成 page布局,而如果 page布局不存在,它会变成 default布局。
  5. 如果你的页面没有一个明确的标题,并且这个文件是由 H1、H2或者 H3 标签开始的,我们会使用这个标签内容作为页面的标题,显示在浏览器的标签上。

这些改进应该能让你更快更简单的通过几次点击发布你的第一个(或者第一百个)网站,或者通过简单地添加 Markdown 文件到 /docs目录 ,在仓库内给你的软件项目编写文档。当然,你依然可以通过额外的自定义设置(比如使用你自己的布局和样式来覆盖默认主题)来继续控制外观和体验。

虽然这些改动应该不会影响大多数现有站点的建设,但对于早期的 Jekyll 用户来说有两个潜在的陷阱:

  1. 如果你的站点遍历了所有页面(例如, forpageinsite.pages),你可能会发现现在有额外的页面(比如第三方依赖库的 README 页面)在这个列表里。你可以使用配置文件里的 exclude配置显式地排除这些文件。
  2. 如果你没有指定一个页面的布局和标题,并且希望它一直保持这样(例如,假如你需要提供无样式的内容),你需要明确地将这些配置的值设为 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 闭包



小手一抖,资料全有。长按二维码关注京程一灯,阅读更多技术文章和业界动态。

本文分享自微信公众号 - 京程一灯(jingchengyideng)

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2017-10-24

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏编程软文

分布式阿波罗Apollo配置中心

为什么要使用apollo,在我们开发分布式微服务项目的时候,那些配置一旦变更,就需要重启服务,这样非常不友好。因此我们考虑动态更改配置文件当中的配置,所以把那些...

29620
来自专栏码匠的流水账

聊聊flink的Execution Plan Visualization

本文主要研究一下flink的Execution Plan Visualization

14820
来自专栏Nicky's blog

editormd实现文章详情页面预览

继之前博客写了editmd.js(国内开源的一款前端Markdown框架)实现的写文章功能之后,本博客介绍使用editormd实现文章预览功能

22320
来自专栏前端vue

vue-cli3项目创建-配置-发布

(2) 修改user module -- src/store/module/user.js

4.3K40
来自专栏成猿之路

2019开发者调查趋势与方向报告出炉

近日国外开发者平台 HankerRank 发布了 2019 年开发者技能调查报告,该报告根据对71,281位开发者的调查得出。作者从中选取了一部分,给大家解读一...

14640
来自专栏KEN DO EVERTHING

快速入门Vue

刚进公司做的第一个项目,刚好前端人手不足,需要我们后端同时兼顾前后端的工作,采用的iview UI框架,基于vue.js。

16910
来自专栏进击的全栈

认识Set和Map数据结构

tips : 由于 Set 结构没有键名,只有键值(或者说键名和键值是同一个值),所以keys方法和values方法的行为完全一致,而entries方法返回的...

17570
来自专栏娱乐心理测试

mpvue网络接口请求封装

在mpvue中我们同样使用小程序的原生API wx.request进行请求,具体方法如下:

48630
来自专栏hotqin888的专栏

用beego vue.js element axios 写flow办公流程——系列五

自己的认识:一定要用独立的前端,即vue.js前端项目必须是独立的,独立的服务,不要放beego里的view里作为tpl页面。虽然,放beego view里的t...

16400
来自专栏编程微刊

js通过input框输入属性和值,改变div的属性

js实现在input框里面输入属性和值,页面的 div的属性根据输入的属性和值进行变化。

67450

扫码关注云+社区

领取腾讯云代金券

年度创作总结 领取年终奖励