mirror of https://gitlab.com/curben/blog
post(hexo-guide): link hexo.io guides
This commit is contained in:
parent
a0f37396f4
commit
996ea52384
|
@ -2,10 +2,13 @@
|
||||||
title: How to create a Hexo blog on GitHub Pages
|
title: How to create a Hexo blog on GitHub Pages
|
||||||
excerpt: Host your Hexo blog for free on GitHub Pages.
|
excerpt: Host your Hexo blog for free on GitHub Pages.
|
||||||
date: 2018-11-10
|
date: 2018-11-10
|
||||||
|
updated: 2020-11-17
|
||||||
tags:
|
tags:
|
||||||
- hexo
|
- hexo
|
||||||
---
|
---
|
||||||
|
|
||||||
|
> I recommend the [official guide](https://hexo.io/docs/github-pages) (which I co-authored) for more updated content.
|
||||||
|
|
||||||
In {% post_link how-to-create-a-hexo-blog 'previous post' %}, I showed you how to create a blog using [Hexo](https://hexo.io) and host it on [GitLab Pages](https://about.gitlab.com/features/pages/). Here's how to host it on [GitHub Pages](https://pages.github.com/):
|
In {% post_link how-to-create-a-hexo-blog 'previous post' %}, I showed you how to create a blog using [Hexo](https://hexo.io) and host it on [GitLab Pages](https://about.gitlab.com/features/pages/). Here's how to host it on [GitHub Pages](https://pages.github.com/):
|
||||||
|
|
||||||
## GitHub repository
|
## GitHub repository
|
||||||
|
|
|
@ -1,13 +1,15 @@
|
||||||
---
|
---
|
||||||
title: How to create a Hexo blog on GitLab Pages
|
title: How to create a Hexo blog using GitLab and Netlify
|
||||||
excerpt: Create a website/blog using Hexo on GitLab Pages for free using this detailed guide.
|
excerpt: Deploy a Hexo website/blog using Netlify from a GitLab repo.
|
||||||
date: 2018-09-21
|
date: 2018-09-21
|
||||||
updated: 2018-11-10
|
updated: 2020-11-17
|
||||||
tags:
|
tags:
|
||||||
- hexo
|
- hexo
|
||||||
- gitlab
|
- gitlab
|
||||||
---
|
---
|
||||||
|
|
||||||
|
> Refer to the [this guide](https://hexo.io/docs/gitlab-pages) (co-authored by me) if you prefer to use GitLab Pages instead of Netlify
|
||||||
|
|
||||||
Create a website/blog using Hexo on [GitLab Pages](https://about.gitlab.com/features/pages/) for free using the following guide. Refer to my {% post_link hexo-blog-github 'another guide' %} for [GitHub Pages](https://pages.github.com/).
|
Create a website/blog using Hexo on [GitLab Pages](https://about.gitlab.com/features/pages/) for free using the following guide. Refer to my {% post_link hexo-blog-github 'another guide' %} for [GitHub Pages](https://pages.github.com/).
|
||||||
|
|
||||||
## GitLab project
|
## GitLab project
|
||||||
|
@ -20,7 +22,7 @@ Create a website/blog using Hexo on [GitLab Pages](https://about.gitlab.com/feat
|
||||||
1. To create a new post (through GitLab.com), create a new `<post-title>.md` file in `source/_posts` folder.
|
1. To create a new post (through GitLab.com), create a new `<post-title>.md` file in `source/_posts` folder.
|
||||||
2. Start with the following header/[front-matter](https://hexo.io/docs/front-matter):
|
2. Start with the following header/[front-matter](https://hexo.io/docs/front-matter):
|
||||||
|
|
||||||
```
|
``` yml _posts/test-page.md
|
||||||
---
|
---
|
||||||
title: Test page
|
title: Test page
|
||||||
date: yyyy-mm-dd hh:mm:ss
|
date: yyyy-mm-dd hh:mm:ss
|
||||||
|
@ -39,20 +41,20 @@ Create a website/blog using Hexo on [GitLab Pages](https://about.gitlab.com/feat
|
||||||
3. Install Node.js and Hexo using the [official guide](https://hexo.io/docs/).
|
3. Install Node.js and Hexo using the [official guide](https://hexo.io/docs/).
|
||||||
4. Create a [new post](#Writing). Then generate static files to check for any error. You should always do this before pushing/merging commits to the `master` branch.
|
4. Create a [new post](#Writing). Then generate static files to check for any error. You should always do this before pushing/merging commits to the `master` branch.
|
||||||
|
|
||||||
```bash
|
```
|
||||||
$ hexo generate
|
$ hexo generate
|
||||||
```
|
```
|
||||||
|
|
||||||
5. (Optional) Start Hexo server on `http://localhost:4000` to preview the blog.
|
5. (Optional) Start Hexo server on `http://localhost:4000` to preview the blog.
|
||||||
|
|
||||||
```bash
|
```
|
||||||
$ hexo server
|
$ hexo server
|
||||||
```
|
```
|
||||||
More info: [Server](https://hexo.io/docs/server)
|
More info: [Server](https://hexo.io/docs/server)
|
||||||
|
|
||||||
6. Git add, commit and push the file to your GitHub repo.
|
6. Git add, commit and push the file to your GitHub repo.
|
||||||
|
|
||||||
``` bash
|
```
|
||||||
$ git add 'source/_posts/your-post.md'
|
$ git add 'source/_posts/your-post.md'
|
||||||
$ git commit -a -m 'Commit Message'
|
$ git commit -a -m 'Commit Message'
|
||||||
$ git push -u
|
$ git push -u
|
||||||
|
@ -70,13 +72,13 @@ $ git push -u
|
||||||
## Writing
|
## Writing
|
||||||
1. Create a new post (using Hexo)
|
1. Create a new post (using Hexo)
|
||||||
|
|
||||||
``` bash
|
```
|
||||||
$ hexo new "My New Post"
|
$ hexo new "My New Post"
|
||||||
```
|
```
|
||||||
|
|
||||||
2. `My-New-Post.md` is created to the `source/_posts` folder, with the following header/[front-matter](https://hexo.io/docs/front-matter):
|
2. `My-New-Post.md` is created to the `source/_posts` folder, with the following header/[front-matter](https://hexo.io/docs/front-matter):
|
||||||
|
|
||||||
```
|
``` yml _posts/my-new-post.md
|
||||||
---
|
---
|
||||||
title: My New Post
|
title: My New Post
|
||||||
date: yyyy-mm-dd hh:mm:ss
|
date: yyyy-mm-dd hh:mm:ss
|
||||||
|
@ -91,19 +93,18 @@ More info: [Writing](https://hexo.io/docs/writing.html)
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
### Naming
|
### Naming
|
||||||
Change the website's author and name
|
Change the website's author and name:
|
||||||
`_config.yml`:
|
|
||||||
|
|
||||||
```yml
|
``` yml _config.yml
|
||||||
title:
|
title:
|
||||||
excerpt:
|
excerpt:
|
||||||
description:
|
description:
|
||||||
author:
|
author:
|
||||||
```
|
```
|
||||||
|
|
||||||
`themes/typing/_config.yml`:
|
Change the theme's setting:
|
||||||
|
|
||||||
```yml
|
``` yml themes/typing/_config.yml
|
||||||
menu:
|
menu:
|
||||||
GitLab: <your-gitlab-project-link>
|
GitLab: <your-gitlab-project-link>
|
||||||
# Customize /about page
|
# Customize /about page
|
||||||
|
@ -134,10 +135,10 @@ If you don't have any plan to send merge requests to the upstream, you can remov
|
||||||
## Useful links:
|
## Useful links:
|
||||||
Configuration files for this blog deployment:
|
Configuration files for this blog deployment:
|
||||||
|
|
||||||
- [.gitlab-ci.yml](https://gitlab.com/curben/blog/blob/master/.gitlab-ci.yml)
|
- [netlify.toml](https://gitlab.com/curben/blog/blob/master/netlify.toml)
|
||||||
- [_config.yml](https://gitlab.com/curben/blog/blob/master/_config.yml)
|
- [_config.yml](https://gitlab.com/curben/blog/blob/master/_config.yml)
|
||||||
- [package.json](https://gitlab.com/curben/blog/blob/master/package.json)
|
- [package.json](https://gitlab.com/curben/blog/blob/master/package.json)
|
||||||
- [netlify.toml](https://gitlab.com/curben/blog/blob/master/netlify.toml) *for Netlify deployment only*
|
- [.gitlab-ci.yml](https://gitlab.com/curben/blog/blob/master/.gitlab-ci.yml) _testing only, not for deployment_
|
||||||
|
|
||||||
Docs:
|
Docs:
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue