blog/README.md

[curben.netlify.com](https://curben.netlify.com/)
===

[![Netlify Status](https://api.netlify.com/api/v1/badges/aaf73659-db84-4c41-a700-de3926022674/deploy-status)](https://app.netlify.com/sites/curben/deploys)
[![Build Status](https://gitlab.com/curben/curben.gitlab.io/badges/master/pipeline.svg)](https://gitlab.com/curben/blog/-/jobs)
[![Hexo version](https://img.shields.io/badge/hexo-3.9.0-brightgreen.svg)](https://www.npmjs.com/package/hexo)

Forked from GitLab's [Hexo](https://gitlab.com/pages/hexo) example with [Typing](https://github.com/geekplux/hexo-theme-typing) theme.

## Installation

Refer to [this post](https://curben.netlify.com/2018/09/21/how-to-create-a-hexo-blog/) for more detailed instruction.


## Changes
The following are the major changes I made compared to the upstream.

### [Hexo](https://gitlab.com/pages/hexo) site
- Update [.gitlab-ci.yml](.gitlab-ci.yml) to use the latest version of [Node.js](https://hub.docker.com/_/node/) in Alpine 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](https://github.com/geekplux/hexo-theme-typing) theme
- Homepage shows index of posts (same as /archives).
- Use the latest version of [clipboard.js](https://github.com/zenorocha/clipboard.js/) and [Fork Awesome](https://github.com/ForkAwesome/Fork-Awesome/releases) (disabled by default).
- Remove jQuery, fancyBox, web analytics, comment plugins and donation links.
- Use more [relative length](https://www.w3schools.com/CSSref/css_units.asp), instead of absolute length in the css.
- Add a "Copy" button to each code block.

### Hexo packages
- All dependencies are installed from their respective master branch, instead of npm published version.
- Removed unused packages, [hexo-generator-category](https://github.com/hexojs/hexo-generator-category) and [hexo-renderer-stylus](https://github.com/hexojs/hexo-renderer-stylus) from the [default packages](https://github.com/hexojs/hexo-starter/blob/571320ba41a83e065d7560e050eb3fa63ad74a57/package.json#L9-L17).

### Plugins
- Installed [hexo-nofollow](https://github.com/curbengh/hexo-nofollow) for SEO purpose to prevent search engines from following external links.
- Installed [hexo-yam](https://github.com/curbengh/hexo-yam) to pre-compress static assets (html, css, js and svg).

## License
The content of this blog is licensed under the [CC-BY-SA license](https://creativecommons.org/licenses/by-sa/4.0/), and the underlying source code used to format and display that content is licensed under the [MIT license](LICENSE.md), unless indicated otherwise.

---
Useful links:

- [Hexo Docs](https://hexo.io/docs/)
- [GitLab Pages](https://docs.gitlab.com/ee/user/project/pages/index.html)
Update changes to readme 2018-10-25 04:37:04 +00:00			`[curben.netlify.com](https://curben.netlify.com/)`
			`===`
Update README 2018-09-18 11:32:30 +00:00
docs: add Netlify deploy status badge https://www.netlify.com/blog/2019/01/29/sharing-the-love-with-netlify-deployment-badges/ 2019-04-12 03:53:45 +00:00			`[![Netlify Status](https://api.netlify.com/api/v1/badges/aaf73659-db84-4c41-a700-de3926022674/deploy-status)](https://app.netlify.com/sites/curben/deploys)`
docs: fix links in badge 2019-05-13 06:25:02 +00:00			`[![Build Status](https://gitlab.com/curben/curben.gitlab.io/badges/master/pipeline.svg)](https://gitlab.com/curben/blog/-/jobs)`
docs(readme): hexo 3.9.0 badge 2019-06-22 05:22:40 +00:00			`[![Hexo version](https://img.shields.io/badge/hexo-3.9.0-brightgreen.svg)](https://www.npmjs.com/package/hexo)`
Update README 2016-04-05 15:03:17 +00:00
Create installation guide 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.`
Update README 2018-09-19 06:13:34 +00:00
Create installation guide post Move the lengthy installation guide to a new blog post. 2018-09-21 04:39:51 +00:00			`## Installation`

docs(readme): remove install/usage guide 2019-08-11 18:32:43 +00:00			`Refer to [this post](https://curben.netlify.com/2018/09/21/how-to-create-a-hexo-blog/) for more detailed instruction.`
docs: update nodejs installation instruction * in readme, add instruction to install more updated nodejs * in readme, add a link to the relevant post for more detailed instruction * in posts, append 'or newer' to fedora, now that fedora v30 is released * in posts, add '--only=prod' parameter to skip devDeps 2019-05-18 05:19:46 +00:00
Update README 2018-09-18 11:32:30 +00:00
Create installation guide 2018-09-20 10:18:13 +00:00			`## Changes`
Update changes to readme 2018-10-25 04:37:04 +00:00			`The following are the major changes I made compared to the upstream.`
Create installation guide post Move the lengthy installation guide to a new blog post. 2018-09-21 04:39:51 +00:00
Update changes to readme 2018-10-25 04:37:04 +00:00			`### [Hexo](https://gitlab.com/pages/hexo) site`
			`- Update [.gitlab-ci.yml](.gitlab-ci.yml) to use the latest version of [Node.js](https://hub.docker.com/_/node/) in Alpine docker image.`
Create installation guide 2018-09-20 10:18:13 +00:00			`- Update [package.json](package.json) to use latest version of [hexo](https://www.npmjs.com/package/hexo) and its related packages.`
Update README 2018-09-18 11:32:30 +00:00			`- Replace the bundled Landscape theme with Typing theme.`

Update changes to readme 2018-10-25 04:37:04 +00:00			`### [Typing](https://github.com/geekplux/hexo-theme-typing) theme`
docs(readme): remove install/usage guide 2019-08-11 18:32:43 +00:00			`- Homepage shows index of posts (same as /archives).`
docs(readme): mention removal of jquery and fancybox 2019-06-08 05:32:47 +00:00			`- Use the latest version of [clipboard.js](https://github.com/zenorocha/clipboard.js/) and [Fork Awesome](https://github.com/ForkAwesome/Fork-Awesome/releases) (disabled by default).`
			`- Remove jQuery, fancyBox, web analytics, comment plugins and donation links.`
docs: skip installation of devDep 2019-05-13 06:43:50 +00:00			`- Use more [relative length](https://www.w3schools.com/CSSref/css_units.asp), instead of absolute length in the css.`
docs(readme): list changes to default packages 2019-08-11 18:46:35 +00:00			`- Add a "Copy" button to each code block.`
Update README 2016-04-05 15:03:17 +00:00
docs(readme): list changes to default packages 2019-08-11 18:46:35 +00:00			`### Hexo packages`
			`- All dependencies are installed from their respective master branch, instead of npm published version.`
			`- Removed unused packages, [hexo-generator-category](https://github.com/hexojs/hexo-generator-category) and [hexo-renderer-stylus](https://github.com/hexojs/hexo-renderer-stylus) from the [default packages](https://github.com/hexojs/hexo-starter/blob/571320ba41a83e065d7560e050eb3fa63ad74a57/package.json#L9-L17).`

			`### Plugins`
			`- Installed [hexo-nofollow](https://github.com/curbengh/hexo-nofollow) for SEO purpose to prevent search engines from following external links.`
			`- Installed [hexo-yam](https://github.com/curbengh/hexo-yam) to pre-compress static assets (html, css, js and svg).`
Add license 2018-10-25 04:20:01 +00:00
			`## License`
docs(readme): add license disclaimer and shorten CC 2019-06-12 08:30:35 +00:00			`The content of this blog is licensed under the [CC-BY-SA license](https://creativecommons.org/licenses/by-sa/4.0/), and the underlying source code used to format and display that content is licensed under the [MIT license](LICENSE.md), unless indicated otherwise.`
Add license 2018-10-25 04:20:01 +00:00
Create installation guide 2018-09-20 10:18:13 +00:00			`---`
			`Useful links:`
Fix links formatting 2018-10-25 04:24:27 +00:00
			`- [Hexo Docs](https://hexo.io/docs/)`
			`- [GitLab Pages](https://docs.gitlab.com/ee/user/project/pages/index.html)`
Use mobile-friendly favicon https://realfavicongenerator.net/ Undo e3b6dc8404cda5a96f64b8392b1971139180802b 2018-09-20 04:11:03 +00:00