↓ Skip to main content
Yixian Wang
  1. Notes/

Hexo

·2 mins·
Table of Contents

Doc
#

  • Doc
  • Restart hexo server, each time changed yml file

NEW BLOG PROJECT
# 

hexo init blog_project_name

POST
#

creating a post
# 

# under blog folder to create a new post with name a.md
hexo new a

DRAFT
#

create a new draft
# 

hexo new draft b

test draft
# 

hexo server --draft

publish the draft
# 

# move b from _drafts folder to _posts folder
hexo publish b

PAGE
# 

hexo new page c
  • to access the page c “http://localhost:4000/about/”

SCAFFOLDS
#

For handling default content

  1. create a new file within scafoolds. e.g. giraffe.md
title: {{ title }} // title within curly brace here are just placeholder
date: {{ date }}
layout: {{ layout }}
  1. create new post with template giraffe
hexo new giraffe f

Tags & Categories
#

Within _posts folder a.md file

---
tags: [Tag1, Tag2, Tag3]
categories:
- [Cat1, Cat1.1]
- [Cat2]
- [Cat3]
---

Tag Plugins
#

Code Block
# 

{% codeblock lang:c++ %}

{% endcodeblock %}

Youtube
# 

{% youtube AnyYoutubeID %}

Asset folders
#

use hexo syntax for img: second priority
#

_config.yml post_asset_folder: true Then next time we create new post with hexo command line, it will also create a asset folder a along with a.md

  • Notice: jpg works, png not works
# within a.md
{% asset_img testdel.jpg Image Title Here %}
{% asset_link testdel.jpg %}
{% asset_path testdel.jpg %}

use markdown syntax for img: first priority
# 

# _config.yml
post_asset_folder: true
marked:
  prependRoot: true
  postAsset: true
  • Notice: create an additional folder for reference and convinence
![images](a/testdel.jpg)

Official Theme
#

Clone github to themes folder

theme: change the name here to theme-folder's name

Then restart hexo server

Creating a theme
#

  • file layout.ejs is the overview of the structure

partial
#

partial can make process modular

  • create partial folder, and a file header.ejs
# within layout.ejs
# title is the parameter
<body>
  <%- parital('partial/header', {title: 'red'}) %>
</body>
# within partial/header.ejs
# to get the parameter
<%= title %>

Variables
#