mirror of https://gitlab.com/curben/blog
96 lines
2.4 KiB
Markdown
96 lines
2.4 KiB
Markdown
curben.gitlab.io
|
|
================
|
|
|
|
|
|
|
|
|
|
Forked from GitLab's [Hexo](https://gitlab.com/pages/hexo) example with [Typing](https://github.com/geekplux/hexo-theme-typing) theme.
|
|
|
|
---
|
|
|
|
{:toc}
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
1. Change `<folder>` to a preferred name.
|
|
```bash
|
|
git clone https://gitlab.com/curben/curben.gitlab.io <folder>
|
|
```
|
|
2. Install Node.js.
|
|
```bash
|
|
# Installing npm will also install nodejs as dependency.
|
|
# Ubuntu/Debian
|
|
sudo apt-get install npm
|
|
# Fedora/Red Hat
|
|
sudo yum install npm
|
|
# Arch Linux
|
|
sudo pacman -S npm
|
|
```
|
|
3. Install Hexo and its dependencies (defined in [package.json](package.json)).
|
|
```bash
|
|
$ sudo npm install -g hexo-cli
|
|
$ cd <folder>
|
|
$ npm install
|
|
```
|
|
4. Generate static files to check for any error. You should _always_ do this before pushing/merging commits to the `master` branch.
|
|
```bash
|
|
$ hexo generate
|
|
```
|
|
|
|
## Quick Start
|
|
|
|
### Create a new post
|
|
|
|
``` bash
|
|
$ hexo new "My New Post"
|
|
```
|
|
|
|
More info: [Writing](https://hexo.io/docs/writing.html)
|
|
|
|
### Run server
|
|
|
|
``` bash
|
|
$ hexo server
|
|
```
|
|
|
|
More info: [Server](https://hexo.io/docs/server.html)
|
|
|
|
### Generate static files
|
|
|
|
``` bash
|
|
$ hexo generate
|
|
```
|
|
|
|
More info: [Generating](https://hexo.io/docs/generating.html)
|
|
|
|
### Deploy to remote sites
|
|
|
|
``` bash
|
|
$ hexo deploy
|
|
```
|
|
|
|
More info: [Deployment](https://hexo.io/docs/deployment.html)
|
|
|
|
## Changes
|
|
The following are the major changes I made from the upstream.
|
|
|
|
### Hexo
|
|
- Update [.gitlab-ci.yml](.gitlab-ci.yml) to use the latest version of [Node.js](https://hub.docker.com/_/node/) in the Docker image.
|
|
- Update [package.json](package.json) to use latest version of [hexo](https://www.npmjs.com/package/hexo) and its related packages.
|
|
- Replace the bundled Landscape theme with Typing theme.
|
|
|
|
### Typing theme
|
|
- Homepage shows index of posts.
|
|
- Remove header and footer display (except for `/about` page).
|
|
- Use the latest version of [jQuery](https://jquery.com/download/), [fancyBox](https://github.com/fancyapps/fancyBox/releases) and [Font Awesome](https://github.com/FortAwesome/Font-Awesome/releases)
|
|
- All js and css files are self-hosted.
|
|
- Remove analytic, comment system and donation links.
|
|
|
|
---
|
|
Useful links:
|
|
[Hexo Docs](https://hexo.io/docs/)
|
|
[GitLab Pages](https://docs.gitlab.com/ee/user/project/pages/index.html)
|
|
|