title: 博客搭建过程中的问题及解决方法 date: 2024-01-26 18:11:11 tags: [搭建博客]
这是我搭建的时候对照的视频链接[教程]Hexo & Github搭建自己的专属博客哔哩哔哩bilibili
首先要安装
[Git] https://git-scm.com/downloads
在Windows上使用Git,可以从Git官网直接Git - Downloads,然后按默认选项安 装即可。安装完成后,在开始菜单里找到“Git”->“Git Bash”,蹦出一个类似命令行窗口的东西,就 说明Git安装成功!
在Git中绑定Github账号,打开“Git Bash”,在命令框中依次输入两行命令:
git config --global user.name “Your Name” git config --global user.email email@example.com # 其中Your Name和email@example.com替换成上面注册时的账户名和邮箱
和
[NodeJs] https://git-scm.com/downloads
由于 Hexo 是基于 Node.js 驱动的一款博客框架,所以安装NodeJs https://nodejs.org/en/downl
安装之后可以输入以下命令查看是否安装成功:
git version node -v npm -v
出现版本号则安装配置成功
以上环境准备好了就可使用 npm 开始安装 Hexo 了,在命令行输入执行如下命令
npm install -g hexo-cli
安装 Hexo 完成后,在指定文件夹下打开"Git Bash",再执行下列命令,Hexo 将会在指定文件夹中新建所须要的文件:
hexo init myBlog cd myBlog npm install若是上面的命令都没报错的话,就恭喜了,运行hexo s命令,其中s是server 的缩写,在浏览器中输入 http://localhost:4000 回车就能够预览效果了。
大家可以去官网上找自己喜欢的主题下载Themes | Hexo,自己采用的主题是https://github.com/Siricee/hexo-theme-Chic,这款有明暗两种颜色。
修改在主题文件夹下的_config.ym1文件,完成自己个人的配置,
# Header 主页面标题 navname: Bentham's Blog # navigatior items 四个文件归类 nav: Posts: /archives Categories: /category Tags: /tag About: /about # favicon 图标 favicon: /favicon.ico # Profile 中间显示名字 nickname: Jeremy Bentham ### this variable is MarkDown form. # 个人描述,可以修改成自己要显示的句子 description: Lorem ipsum dolor sit amet, **consectetur adipiscing elit.**
Fusce eget urna vitae velit *eleifend interdum at ac* nisi. # 个人头像图片 avatar: /image/avatar.jpeg # main menu navigation ## links key words should not be changed. ## Complete url after key words. ## Unused key can be commented out. # 下方超链接 links: Blog: /archives # Category: # Tags: # Link: # Resume: # Publish: # Trophy: # Gallery: # RSS: # AliPay: ZhiHu: https://www.zhihu.com/people/sirice # LinkedIn: # FaceBook: # Twitter: # Skype: # CodeSandBox: # CodePen: # Sketch: # Gitlab: # Dribbble: Instagram: Reddit: # YouTube: # QQ: # Weibo: # WeChat: Github: https://github.com/Siricee # how links show: you have 2 choice--text or icon. 图标 or 文字 links_text_enable: false links_icon_enable: true # Post page ## Post_meta post_meta_enable: true post_author_enable: true post_date_enable: true post_category_enable: true ## Post copyright post_copyright_enable: true post_copyright_author_enable: true post_copyright_permalink_enable: true post_copyright_license_enable: true post_copyright_license_text: Copyright (c) 2019 CC-BY-NC-4.0 LICENSE post_copyright_slogan_enable: true post_copyright_slogan_text: Do you believe in DESTINY? ## toc post_toc_enable: true # Page page_title_enable: true # Date / Time format ## Hexo uses Moment.js to parse and display date ## You can customize the date format as defined in ## http://momentjs.com/docs/#/displaying/format/ date_format: MMMM D, YYYY time_format: H:mm:ss # stylesheets loaded in the stylesheets: - /css/style.css # scripts loaded in the end of the body scripts: - /js/script.js - /js/tocbot.min.js # tscanlin/tocbot: Build a table of contents from headings in an HTML document. # https://github.com/tscanlin/tocbot # plugin functions ## Mathjax: Math Formula Support ## https://www.mathjax.org # 数学公式 mathjax: enable: true import: demand # global or demand ## global: all pages will load mathjax,this will degrade performance and some grammers may be parsed wrong. ## demand: Recommend option,if your post need fomula, you can declare 'mathjax: true' in Front-matter
点击 Start project 或者下面的 new repository 建立一个新的仓库,注意Github 仅能使用一个同 名仓库的代码托管一个静态站点,这里. 注意仓库名一定要是: 用户名.github.io
配置 SSH key ,要使用 git 工具首先要配置一下SSH key,为部署本地博客到 Github 作准备。
git config --global user.name "用户名" git config --global user.email "邮箱地址" ssh-keygen -t rsa -C '上面的邮箱'
按照提示完成三次回车,便可生成 ssh key,采用以下指令也可以查看自己的ssh:
cat ~/.ssh/id_rsa.pub
首次使用还须要确认并添加主机到本机SSH可信列表。若返回 Hi xxx! You've successfully authenticated, but GitHub does not provide shell access. 内容,则证实添加成功。
ssh -T git@github.com
登陆 Github 上添加刚刚生成的SSH key,按如下步骤添加,右上角点击头像-> settings -> SSH and GPG keys,建立一个新的 SSH key, 标题随便,key 就填刚才生成那个,确认建立,这样在你 的 SSH keys 列表里就会看到你刚刚添加的密钥。
这是我搭建博客中遇到的最大的问题,一开始我以为是公钥添加问题,中途尝试了许多方法
运行npm install 时,卡在sill idealTree buildDeps没有反应,内心OS:明明早就配过淘宝镜像源,果然没用 检查node和npm,发现版本不匹配,按官网匹配表,npm版本太高,于是升级node,还是不行,npm失灵 删除.npmrc 清理缓存npm cache clean --force
最终解决方法HTTPS 端口使用 SSH
1.在控制台输入以下命令查看是否能连接到github,如果回复为Hi xxxxx! 表示连接成功,已加入可信列表
ssh -T git@github.com > Hi USERNAME! You've successfully authenticated, but GitHub does not provide shell access.'
如果不行,尝试一下命令: ssh -T -p 443ssh://git@ssh.github.com,这个可以按照提示建立许可连接
ssh -T -p 443 git@ssh.github.com > Hi '你的id'! You've successfully authenticated, but GitHub does not provide shell access.'
如果你能在端口 443 上通过 SSH 连接到 git@ssh.github.com
,则可覆盖你的 SSH 设置来强制与 GitHub.com 的任何连接均通过该服务器和端口运行。
到此为止,问题解决得差不多了
在输入命令 git clone ssh://git@ssh.github.com:443/'username'/'username'c.github.io时就能够正常clone仓库, 但是每次都输入更长的url难免繁琐,所以可以在你生成密钥的文件夹内新建一个config文件,输入以下内容保存:
Host github.com Hostname ssh.github.com Port 443 User git
你可以通过再次连接到 GitHub.com 来测试这是否有效:
ssh -T git@github.com > Hi USERNAME! You've successfully authenticated, but GitHub does not' > provide shell access.
此时,本地和Github的工作做得差不了,是时候把它们两个链接起来了。你也能够查看官网的部署教程。
先不着急,部署以前还须要修改配置和安装部署插件。
第一:打开项目根目录下的 _config.yml 配置文件配置参数。拉到文件末尾,填上以下配置。
第二要安装一个部署插件 hexo-deployer-git,打开“Git Bach”,输如以下指令:
npm install hexo-deployer-git --save
最后执行如下两条命令就能够部署上传啦,如下
hexo g # 先生成 hexo d # 部署到Github上
g 是 generate 缩写,d 是 deploy 缩写 这时用浏览器输入 用户名.github.io 就可以访问刚才的网站
npm cache clean --force 清理缓存
hexo g 生成
hexo sever 使用本地服务器构建网页 一般地址是localhost:4000/
hexo deploy 上传到github项目
hexo clean
在发布文章后,有时候会发现标签或分类的描述不够准确,需要修改tags或者categories的内容。
但是,当某个标签被完全替代,没有文章使用这个标签之后,会发现在标签列表里还是会出现这个标签,点击进去却并没有内容,这非常影响使用体验。
如何清除无用的标签索引呢,可以使用hexo clean
命令。
$ hexo clean $ hexo d -g
命令
hexo s -g
执行中时,命令hexo clean
会没有效果,需要先终止 hexo server服务
hexo博客中如何插入图片-CSDN博客
然后记得在hexo的source文件夹下找到该.md文件,删除每一个图片路径的文章名