blog/README.md

90 lines
2.5 KiB
Markdown
Raw Normal View History

2018-09-18 11:32:30 +00:00
curben.gitlab.io
================
2018-09-18 11:32:30 +00:00
![Build Status](https://gitlab.com/curben/curben.gitlab.io/badges/master/pipeline.svg)
![https://www.npmjs.com/package/hexo](https://img.shields.io/badge/hexo-3.7.1-blue.svg)
2016-04-05 15:03:17 +00:00
2018-09-20 10:18:13 +00:00
Forked from GitLab's [Hexo](https://gitlab.com/pages/hexo) example with [Typing](https://github.com/geekplux/hexo-theme-typing) theme.
2018-09-19 06:13:34 +00:00
## Installation
1. Change `<folder>` to a preferred name.
2018-09-20 10:18:13 +00:00
```bash
git clone https://gitlab.com/curben/curben.gitlab.io <folder>
```
2. Install Node.js.
2018-09-20 10:18:13 +00:00
```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)).
2018-09-20 10:18:13 +00:00
```bash
$ sudo npm install -g hexo-cli
$ cd <folder>
$ npm install
2018-09-20 10:18:13 +00:00
```
4. Generate static files to check for any error. You should _always_ do this before pushing/merging commits to the `master` branch.
2018-09-20 10:18:13 +00:00
```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
2018-09-20 10:18:13 +00:00
```
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)
2018-09-18 11:32:30 +00:00
2018-09-20 10:18:13 +00:00
## Changes
The following are the major changes I made from the upstream.
2018-09-20 10:18:13 +00:00
### 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.
2018-09-18 11:32:30 +00:00
- Replace the bundled Landscape theme with Typing theme.
### Typing theme
2018-09-18 11:32:30 +00:00
- Homepage shows index of posts.
- Remove header and footer display (except for `/about` page).
2018-09-19 06:13:34 +00:00
- 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 and [pre-compressed](https://docs.gitlab.com/ee/user/project/pages/introduction.html#serving-compressed-assets).
2018-09-19 09:19:07 +00:00
- Remove analytic, comment system and donation links.
2016-04-05 15:03:17 +00:00
2018-09-20 10:18:13 +00:00
---
Useful links:
[Hexo Docs](https://hexo.io/docs/)
[GitLab Pages](https://docs.gitlab.com/ee/user/project/pages/index.html)