blog/README.md

2.8 KiB

curben.gitlab.io

Build Status https://www.npmjs.com/package/hexo

Forked from GitLab's Hexo example with Typing theme.

Installation

  1. Change <folder> to a preferred name.
git clone https://gitlab.com/curben/curben.gitlab.io <folder>
  1. Install Node.js.
# 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
  1. Install Hexo and its dependencies (defined in package.json).
$ sudo npm install -g hexo-cli
$ cd <folder>
$ npm install
  1. Generate static files to check for any error. You should always do this before pushing/merging commits to the master branch.
$ hexo generate

Quick Start

Create a new post

$ hexo new "My New Post"

More info: Writing

Run server

$ hexo server

More info: Server

Generate static files

$ hexo generate

More info: Generating

Deploy to remote sites

$ hexo deploy

More info: Deployment

Changes

The following are the major changes I made from the upstream.

Hexo

  • Update .gitlab-ci.yml to use the latest version of Node.js in the Docker image.
  • Update package.json to use latest version of 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, fancyBox and Font Awesome
  • All js and css files are self-hosted and pre-compressed.
  • Remove analytic, comment system and donation links.

License

The content of this blog itself is licensed under the Creative Commons Attribution Share Alike 4.0 International license, and the underlying source code used to format and display that content is licensed under the MIT license.


Useful links: Hexo Docs GitLab Pages