最简单的个人在线博客 github pages

github pages

如果你希望把你的前端项目、demo 快速展示给别人,你又没有搭建一个属于自己的个人网站,github pages 能够快速的帮到你。只需要以下简单的步骤,就可以让其他人访问到你的前端页面。

1

在 github 上创建一个项目

在 github 首页点击按钮 「New」,即可进入到如下页面,填写相关的信息,然后点击最后的「Create repository」 按钮,即可创建一个项目。

2

设置站点首页

创建好之后,项目如下

点击 「Settings」 ,进入到设置页面。

找到设置页面中,左侧导航栏中的「Pages」

点击该链接,进入到 pages 的设置页面。

该页面有两个设置项。一个是 Source,表示代码源。另一个是 Theme Chooser,表示选择主题。

设置了 Source 之后,属于该项目的站点就会激活,可以通过该设置来指定项目的首页。

第一个按钮可以选择指定的分支,此时我们选择 main 主分支。

由于某些种族歧视问题,现在 github 上所有的项目,主分支已经从 master 改成了 main

image.png

第二个按钮可以选择指定的文件,此处提供了两个选项,root 根目录与 docs 目录。

对于简单的项目,我们可以将项目首页 index.html 放在根目录中,如果根目录中没有 index.html,此处会将 README.md 解析为首页。

对于 React/vue 项目来说,我们可以将 index.html 以及其他代码打包到 docs 目录中。

此处我们选择 man -> /(root),项目中只有一个 README.md,那么此文件会被解析为首页,保存一下,试试看

保存之后,改项目的链接地址会根据项目自动生成,并在 pages 设置页显示出来。该地址不会马上就可以生效,要稍微等一会儿。

成功访问,搞定!

此时我们发现页面非常简单,因此为了页面看上去稍微丰富一点,我们可以选择一个主题。

点击「Choose a theme」 按钮,进入到主题选择页面。每一个主题都有预览效果,选择一个你喜欢的主题,点击「Select theme」按钮。

想要让主题生效,就会改变我们的项目代码。

因此当我们选择一个主题时,代码会发现改变,此时我们应该往项目中提交主题对应的代码,所以当点击了「Select theme」按钮之后,会进入到一个代码的提交页面

填写本次提交的备注,然后点击按钮「Commit changes」即可。

提交之后,README.md 文件被修改,并且多了一个主题相关的配置文件

点击刚才的博客地址,观察一下生效之后的页面效果。

3

编写网页代码

通常情况下,我们并不需要选择默认的主题,而是自己编写代码。例如,我们再项目中添加一个简单的 html 文件作为演示。

你可以通过在线的方式添加文件

也可以将代码通过 git clone 指令将代码拉取下来,在本地编辑好之后,再通过其他的 git 指令提交代码,这需要对 git 有一定程度的熟悉。

我的步骤如下:

a. 拉取代码到本地文件

git clone git@github.com:yangbo5207/bo.git

// 进入到项目目录
cd bo 

b. 使用 vs code 等代码编辑器添加 index.html,随便添加一点内容如下

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>github pages 演示代码</title>
</head>
<body>
  <h1>Github pages</h1>
  <div>hello world!</div>
</body>
</html>

然后删掉刚才我们添加的主题相关的文件与内容。

c. 执行如下指令将代码提交到远程仓库

// 添加到暂存区
git add .

// 提交到本地仓库
git commit -m '自己添加文件'

// 同步远程提交
git pull

// 推送到远程仓库
git push origin main

随后项目文件变成了这样,如图

此时可能会因为构建方式的修改导致页面长时间访问不到,所以稍微等待一下即可。重新刷新访问刚才的页面,发现我的代码已经生效。

该 demo 项目访问地址为:https://yangbo5207.github.io/bo/

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,126评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,254评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,445评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,185评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,178评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,970评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,276评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,927评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,400评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,883评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,997评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,646评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,213评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,204评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,423评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,423评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,722评论 2 345

推荐阅读更多精彩内容