前言
加入实验室不久就让我们搭建博客 ,有指导视频但看了一点感觉完全看不懂就没看了,自己在网上找,看朋友是怎么弄的,自己尝试摸索。别人都弄出来了,为啥我用着电脑都出问题弄不好,有一段时间几乎崩溃。我凭着强大的毅力不放弃一共搭建了有10次左右终于弄出来了。可以说所有的问题都被我遇见过(要哭死......),所以我要在这里整理我的经验,在最后面分享一下问题经验,希望能给后来人一些帮助。
一、下载软件
首先,下载Git官网 2.15.0
node.js官网8.9.0
32位或64位按自己电脑的系统来选择,如果不清楚,可以直接在官网下载32位的,可以兼容64位系统。
想要知道自己的电脑是多少位操作系统,打开“我的电脑”,在空白处单击鼠标右键,点击“属性”即可查看。
注:不同软件版本的安装与使用会有差异。曾经就遇到过因为node.js版本太低出错搭建不成功。
二、安装软件
1.安装git
- 大部分按默认安装,一路点击”Next”
-
这里选择对应的windows选项,如下图
image.png
image.png -
等待安装完成
image.png
2.安装node.js
-
Node安装更加简单,还是一路”Next”,最后等待安装完成即可
image.png
image.png
三、验证软件是否正确安装
- 同时按下Win键和R键(或者点击“开始菜单”->点击“运行”),打开运行窗口,输入“cmd”
然后输入以下命令,结果与下图相同则说明安装正确,若不正确可以卸载软件重新安装
- git --version
- node -v
- npm -v
四、申请GitHub账号
- 点击GitHub进入官网注册帐号
-
按下图分别输入用户名、邮箱、密码,然后点击注册
image.png
在这里就不多说如何注册GitHub账号了,有看不懂的英文复制粘贴翻译就好。
-
点击”New repository”,新建一个版本库
image.png -
输入Repository name:yourname.github.io(yourname与你的注册用户名一致
image.png
image.png
*最后点击”Publish page”,发布github默认生成的一个静态站点
image.png -
验证邮箱,点击个人设置
image.png -
点击”Send verification Email”发送验证邮件
image.png -
进入你的邮箱,查收验证邮件进行验证
image.png
五、安装Hexo
hexo是基于node.js的静态博客,官网也是搭建在GitHub上
-
在电脑上新建一个blog文件夹,该文件夹用于存放你的博客文件,然后右键单击选择“Git Bash”
image.png
有的是Git Bash here,是一样的,没影响。
安装hexo为了避免出现被“墙”的情况,使用淘宝NPM镜像,输入以下命令等待安装完成:
$ npm iall -g cnpm --registry=https://registry.npm.taobao.org
注意复制时不要复制"$",因为git上面已经有了
如果是第一次安装则和下图差不多,如果已安装或不确定,可以输入命令$ hexo -v看是否安装。
image.png注意:全程都要看英文的意思,看不懂复制粘贴翻译.
- 使用淘宝NPM安装Hexo
$ cnpm install -g hexo-cli
与原先的npm完全一样,只是命令改为cnpm,一样等待hexo安装完成
image.png- 出现的WARN可以不用理会,继续输入以下命令
$ cnpm install hexo --save
- 安装完成后,在输入命令,验证是否安装正确
image.png$ hexo -v
六、本地运行Hexo
-
初始化hexo
image.png - 安装生成器
$ cnpm install
*运行hexo,以后要在本地运行博客只要输入该命令即可
image.png$ hexo s -g
*停止运行,按住Ctrl+C键即可停止
七、管理博客
配置信息
使用
编辑器(绿色软件无需安装,解压即可使用)打开blog/_config.yml文件,进行配置
image.png#博客名称
title: 我的博客
#副标题
subtitle: 一天进步一点
#简介
description: 记录生活点滴
#博客作者
author: John Doe
#博客语言
language: zh-CN
#时区
timezone:
#博客地址,与申请的GitHub一致
url: http://elfwalk.github.io
root: /
#博客链接格式
permalink: :year/:month/:day/:title/
permalink_defaults:
source_dir: source
public_dir: public
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
i18n_dir: :lang
skip_render:
new_post_name: :title.md # File name of new posts
default_layout: post
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
future: true
highlight:
enable: true
line_number: true
auto_detect: true
tab_replace:
default_category: uncategorized
category_map:
tag_map:
#日期格式
date_format: YYYY-MM-DD
time_format: HH:mm:ss
#分页,每页文章数量
per_page: 10
pagination_dir: page
#博客主题
theme: landscape
#发布设置
deploy:
type: git
#elfwalk改为你的github用户名
repository: https://github.com/elfwalk/elfwalk.github.io.git
branch: master
- 写一篇文章
输入创建文章命令,生成一个md文件(/blog/source/_posts/)
$ hexo new "hello"
image.png
- 用编辑器打开hello.md文件,编写完后保存
title: hello
date: 2015-07-01 22:37:23
categories:
- 日志
- 二级目录
tags:
- hello
---
摘要:
<!--more-->
正文:
八、发布博客
配置SSH keys
我们如何让本地git项目与远程的github建立联系呢?用SSH keys。
- 生成新的SSH Key:
$ ssh-keygen -t rsa -C "邮件地址@youremail.com"
输入后,你会看到
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):
注意1: 此处的邮箱地址,你可以输入自己的邮箱地址;
注意2: 此处的「-C」的是大写的「C」
然后系统会要你输入密码:
···
Enter passphrase (empty for no passphrase):<输入加密串>
Enter same passphrase again:<再次输入加密串>
···
在回车中会提示你输入一个密码,这个密码会在你提交项目时使用,如果为空的话提交项目时则不用输入。这个设置是防止别人往你的项目里提交内容。(我当时就没输密码,直接回车)
注意:输入密码的时候没有*字样的,你直接输入就可以了。
最后看到这样的界面,就成功设置ssh key了:
image.png
- 添加SSH Key到GitHub
在本机设置SSH Key之后,需要添加到GitHub上,以完成SSH链接的设置。
1、打开本地C:\Documents and Settings\Administrator.ssh\id_rsa.pub文件。此文件里面内容为刚才生成人密钥。如果看不到这个文件,你需要设置显示隐藏文件。准确的复制这个文件的内容,才能保证设置的成功。
2、登陆github系统。点击右上角的 Account Settings—>SSH Public keys —> add another public keys
3、把你本地生成的密钥复制到里面(key文本框中), 点击 add key 就ok了
设置git身份信息
···
$ git config --global user.name "你的用户名"
$ git config --global user.email "你的邮箱"
···
(新建一个文本文档,复制粘贴修改成你的用户名和邮箱)
-
发布更新博客
···
$ hexo d -g
···
image.png
如果看到上面的图 Deploy done :git 说明搭建成功了
发布时会弹出一个窗口,需要输入github的帐号和密码。输入完之后过一会去浏览器查找你的网页又可以看到你的博客了。(访问yourname.github.io看下成果)
最后,也是最重要的,我在搭建过程中遇到了很多错误,在这分享一下错误以及解决方法。
1.node.js版本太低出错,英文显示要大于4.0版本
2.搭错了,删除文件后重搭建时,有的程序已走过,相应的步骤不用再弄了,不然会出现文件夹不是空的,又出错。
3在config。yml中改写时,一定要注意用户名,网站与GitHub要一样,冒号后要有一个空格,不然又会出错。
4.记得helo.md文件也要改,复制粘贴即可
5.记得要添加SSH密钥,曾经出现过not found git的情况,应该是没有添加密钥,没连接github。
6.还出现过error: Permission to userA.git denied to userB。
出现这个的原因是电脑上的SHH公钥已经被另一个账户使用,你没有权限。或者是你改用户名了。处理方法是打开电脑Control Panel(控制面板)——>User Account and family Safety(用户账号和家庭安全)——>Manage Windows Credential(凭证管理)——>将跟Git有关的账号删除
然后重新发布。
我搭建博客的过程大致就这样吧,写在这里回头看时又是一番感慨,佩服自己,唉。
网友评论