hexo

当我们发布一个开源项目的时候，最重要的事情之一就是要创建项目文档。对使用项目的用户来说，文档是非常有必要的，通常我们可以使用下面这些方式来创建文档： GitHub Wiki ：在 Github 上我们可以为每个项目都创建一个 wiki。Wiki 是由一系列的 Markdown 文件组成，所以我们可以用 wiki 来做项目文档。但这种方案也有一些缺点：wiki 的贡献者不会出现在项目贡献者列表中；文档的结构和布局都是有限制的，只能是 Github Wikis 的样式；文档存储在第三方平台上。 README：我们可以为项目创建一个 README.md 文件，它会直接展示在 Github（或 Gitlab、Coding 等 git 仓库）的项目页面。如果文档非常少，这中方案是非常适合的。但如果文档非常多，这个 README.md 文件就会非常大了。而且通常来说，README.md 是用来介绍项目，而不是展示文档。 自建网站：当然，我们也可以创建一个文档网站，然后放在自己的服务器上。这样我们就可以随意编辑文档。但这种方案的缺点是不便于追踪文档的变化、开发网站和文档维护相比前两种方案麻烦非常多、而且还需要自建主机。 Github Pages ：Github 也提供了一个托管项目中静态文件的功能。我们可以为项目创建一个 gh-pages 分支，Github 就会将分支中的内容当做静态站点

一、更换主题 如我用的主题是 next ，只需要解压缩到 Hexo/themes/next 目录下即可, 当然你也可以直接在 Hexo 目录下执行 git clone https://github.com/theme-next/hexo-theme-next themes/next ， 解压完成后，修改_config.yaml文件中的 theme 属性，默认是 landscape ，修改为 next ： # Extensions ## Plugins: https://hexo.io/plugins/ ## Themes: https://hexo.io/themes/ theme: next #注意：“theme:”后要带一个空格 每次修改主题后，都需要通过 hexo clean 清理一下， 然后通过 hexo g 重新生成， 最后也不要忘了通过 hexo d 重新部署。 二、Hexo的_config.yaml配置 _config.yaml文件是Hexo项目的全局配置文件，常用的属性有： # Hexo Configuration ## Docs: https://hexo.io/docs/configuration.html ## Source: https://github.com/hexojs/hexo/ # Site title: Rogn`s Blog //博客的标题

本来是想写搭建博客的详细教程的，可后来发现网上这类资料太多了。于是我就把自己觉得还不错的教程链接发给大家。这几篇文章非常详细，图文并茂。把该说的都说了。大家跟着教程一步一步来，肯定会成功的。 参考链接 1. 使用hexo+github搭建免费个人博客详细教程 2. hexo搭建个人博客--NexT主题优化 3. Hexo系列：（三）Hexo博客部署到GitHub和Coding 4. 为你的Hexo加上评论系统-Valine 5. Hexo NexT主题中添加网页标题崩溃欺骗搞怪特效 6. Hexo 教程：Hexo 博客部署到腾讯云教程 7. 我的hexo部署到腾讯云服务器 工具下载 由于搭建hexo博客，需要安装Git和Node.js。这两款都是国外的软件，有时候去官网下载速度会非常慢。下面我把自己下载好的工具分享出来。我的系统是win10 64位的。 Git和Node.js安装包下载 一些注意点和建议 1.软件安装时文件夹不要有空格和中文 2.配置文件有两个，博客根目录有一个，主题里也有一个，别搞混淆。 3.多用hexo clean 命令 4.建议下个markdown软件。个人推荐Typora 5.建议用sublime或者notepad++代替原生记事本 成果展示 Solitary 这一个是部署在国内的coding上 Solitary 这一个是部署在国外的github上 写在最后

本地安装hexo步骤 注意：本节教程只针对Windows用户，Linux和Mac用户请移步hexo安装。 安装Git 下载 msysgit 并执行即可完成安装。 安装Node.js 在 Windows 环境下安装 Node.js 非常简单，仅须下载安装文件并执行即可完成安装。 安装hexo 利用 npm 命令即可安装。（在任意位置点击鼠标右键，选择Git bash） npm install -g hexo 安装完成后，在你喜爱的文件夹下（如H:\hexo），执行以下指令(在H:\hexo内点击鼠标右键，选择Git bash)，Hexo 即会自动在目标文件夹建立网站所需要的所有文件。创建hexo文件夹 hexo init 安装依赖包 本地查看 现在我们已经搭建起本地的hexo博客了，执行以下命令(在H:\hexo)，然后到浏览器输入localhost:4000看看。 hexo generate hexo server 好了，至此，本地博客已经搭建起来了，只是本地哦，别人看不到的。下面，我们要部署到Github。 提交hexo到github步骤 注册Github账号 已有账号可以跳过，没有的，请在此进行注册，很简单，这里就不介绍了。 创建repository 在自己Github主页右下角，创建一个新的repository。比如我的Github账号是imsofter

本文讲解我在搭建Hexo博客的完整过程，主要内容包括GitHub与SSH、FAQ等。 另外还需要注意的是： Hexo博客框架和nexT主题的搭建过程本文会直接引用官方教程，一笔略过； 由于我是在Mac上搭建Hexo博客的，所有一些命令在Windows的终端中可能找不到，请自行下载安装。 下面进入正文： 一开始的时候我没有注册域名，静态生成的文章都是放在GitHub上的，这里先以这种情况来说明： GitHub创建与配置 创建GitHub账号 Step1 Set up a personal account 首先在浏览器中输入网址： https://github.com/join?source=header-home ，然后填写用户名、邮箱、密码， 注意：该邮箱地址在之后的SSH配置中有重要作用 ，最后点击 Create an account 按钮，界面如下图所示： Step2 Choose your plan 默认选择即可，直接点击 Continue 按钮，进入下一步进行邮箱验证，界面如下图所示： Step3 Tailor your experinece 登录自己设置的邮箱，点击 验证邮箱 之类的按钮后会进入 此处 ，如果在其左上角有 Your email was verified. 这样的文案表明邮箱验证成功。 配置GitHub相关信息 创建工程 如图所示：

本文由 CDFMLR 原创，收录于个人主页 https://clownote.github.io ，并同时发布到 CSDN。本人不保证 CSDN 排版正确，敬请访问 clownote 以获得良好的阅读体验。 GitHub + Hexo => 个人博客 打造一个个人博客其实很简单，我们不需要拥有一台服务器、甚至可以对 Web 开发不甚了解。 这篇文章记录我如何在 Mac 上通过 GitHub 、 Hexo 打造一个 个人博客 —— clownote 起因 我一直不喜欢 CSDN 和博客园等博客平台，但确实有写东西的习惯。写了东西就要发表，所以在之前，我把我学习计算机知识的笔记都放到了一个自己初学 Web 开发时搞的一个超级简陋的静态网站上。 但它实在是太简陋了导致使用起来 巨 麻烦，发布文章要手动把 markdown 写的文章用自己写的一个转换器渲染成 HTML，然后调用一个可以及时渲染代码颜色的 js 进去，然后 FTP 上传到服务器上，再到手动修改 index.html ，加入这篇新文章的链接… 这完全不是正常人应该用的操作！ 我一直在考虑写一个功能完整的、更方便的博客。计划是用 Flask 写后端，Vue 做前端，Git 来管理内容，然后再写一些 Apple Script、Bash Script 让这个博客系统方便在 Mac 中使用 。但最近一直忙其他项目，没时间来实现

如题hexo在构建templates时出错 报错原因是 INFO Start processing FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html Template render error: (unknown path) [Line 282, Column 5] unexpected token: % at Object._prettifyError (/home/jason/Documents/blogs/node_modules/nunjucks/src/lib.js:36:11) at Template.render (/home/jason/Documents/blogs/node_modules/nunjucks/src/environment.js:524:21) at Environment.renderString (/home/jason/Documents/blogs/node_modules/nunjucks/src/environment.js:362:17) at Promise (/home/jason/Documents/blogs/node_modules/hexo/lib/extend

一、安装Git与Node (一) 安装Git 在Windows下安装Git： 在Windows上安装Git较为简单，因此不过多叙述。 在Linux下安装Git： 使用Linux包管理工具进行安装，例如Yum， sudo yum install git 。 在Mac下安装Git： Git在Mac下既可以通过GUI的方式来安装也可以通过Command的方式来安装，使用Homebrew进行安装： sudo brew install git 。如果没有安装HomBrew，可以参考 https://brew.sh/index_zh-cn Git代理相关： 查看当前的代理设置： git config --global http.proxy git config --global https.proxy 设置当前代理： git config --global http.proxy 'http://127.0.0.1:1080' git config --global https.proxy 'http://127.0.0.1:1080' 或者: git config --global http.proxy 'socks5://127.0.0.1:1080' git config --global https.proxy 'socks5://127.0.0.1:1080' 删除代理： git

文章目录 一、前言 二、Hexo+GitHub 三、搭建环境 1、系统：ubuntu18.04 2、安装node.js 3、安装git 4、安装Hexo 四、配置GitHub 1、注册登录GitHub 2、添加仓库密匙 五、初始化博客 1、建立本地存储文档 2、部署到Github 六、发表文章 1、创建文章 2、编写文章 3、发表文章 一、前言 为什么要建立博客，如果使用果平台博客如博客园等，就会发现有一个自己的博客，就会极为方便，不受约束，没有广告，布局也可以有着自己的想法。所以有自己的博客是一件很酷的事。 二、Hexo+GitHub 为什么选择Hexo+GitHub，因为成本较低，只有学习成本; GitHub_Pages会提供免费空间，并会提供username.github.io的默认域名，则不需要购买服务器和域名。 三、搭建环境 1、系统：ubuntu18.04 2、安装node.js 在终端下输入：sudo apt-get install nodejs，安装完成即可 3、安装git 终端输入sudo apt-get install git，安装完成即可 git安装完成后输入以下命令： git config --global user.name "username" git config --global user.email "username@xx.com"

前言 这篇博文讲的Typora，不止可以用来写个人博客，还可以用来写博客园，加上自己搞个床图，在Typora上传图片就自动上传床图库上去，真的很方便。也可以在CSDN写博客，然后在那边复制过来，使用的是CSDN的床图。 我用博客园说的Windows Live Writer这个安装不了。 1. Hexo添加文章时自动打开编辑器 首先在站点目录下的scripts目录中创建一个JavaScript脚本文件。如果没有这个scripts目录，则新建一个。 scripts目录新建的JavaScript脚本文件可以任意取名。 通过这个脚本，我们用其来监听 hexo new 这个动作，并在检测到 hexo new 之后，执行编辑器打开的命令。 如果你是windows平台的Hexo用户，则将下列内容写入你的脚本：（直接复制，不用改） var spawn = require('child_process').exec; hexo.on('new', function(data){ spawn('start "markdown编辑器绝对路径.exe" ' + data.path); }); 如果你是Mac平台Hexo用户，则将下列内容写入你的脚本：（直接复制，不用改） var exec = require('child_process').exec; hexo.on('new', function