The goal of A-RSnippet theme is to be comprehensive.
The goal of Hexo A-RSnippet theme is to achieve as many functionalities as possible. There are many features on my todo list. For example, there will be more than one style to show your projects on the portfolio page.
If you like A-RSnippet theme, please star the repo
You can get updated for each new version release if you subscribe to the newsletter.
- Official Hexo A-RSnippet theme website
- Please fork the repo and add your site here.
- Fully responsive: smartphone, tablet, laptop, to desktop computer
- Responsive YouTube and Vimeo videos
- Comments - Disqus
- Analytics - Google, Baidu Analytics.
- Webmaster verification
- Code Syntax Highlight
- Table of Contents
- Custom Single Page
- Tags page
- Project Portfolio page
- A list to show a specific category or tag for LeetCode problem list
- Support Latex through MathJax
- Cover image for posts and pages
- Sharing - addthis
- Navigation menu
- Social Accounts configuration (more in the future)
Please go to http://arsnippet.yingjiehu.com/tutorial for the latest tutorial.
git clone https://github.com/huyingjie/hexo-theme-A-RSnippet.git themes/a-rsnippet
_config.ymlin the root folder of the website with
Execute the following command to update the theme.
cd themes/a-rsnippet git pull
_configfile the theme and your site
_configfile and edit when necessary.
Modify the version number in your
- Copy the content of
sourcefolder in the
exampleSitefolder to your
- Create a new post:
hexo new post "post name"
- Create a new page:
hexo new page "page name"
- Run the website:
Code for An Example Website
There is an
exampleSite folder in the theme folder.
scaffolds folder contains files with empty front-matter of all layouts used on the site.
You can copy the files and folders in the
exampleSite folder to your root of the website.
External Libraries Used
Customize the Theme
Every time you change something in the
_config file, run
hexo s again.
Every time you change something in the
source folder, run
hexo g && hexo s.
Please try not editing code in the theme as hard as you can.
Replacing the theme folder is the only way to update any Hexo theme. If you edit any file in the theme folder, it will not be easy for you to update A-RSnippet theme in the future.
If you want to customize the theme, please try using following methods. There is an example site in the theme folder.
Use external libraries included in the theme.
arsnippet.jsrespectively. Their positions are as follows:
your_site_folder | -- source | -- css | -- arsnippet.css | -- js | -- arsnippet.js
You can see the example in the
Add additional images
Create a folder inside the
Add any image file inside the folder
your_site_folder | -- source | -- img | -- cover-image.png
The same logic can be applied to most types of files.
For HTML files, an additional step should be done: add the filenames in
Access the files using
/folder_name/filename.extension, such as
/is required because it represents the root path of the site.
Thank you for all contributors. Without your help, everything cannot move fast, smooth, and easy.
There are several ways you can help:
Submit your custom layout
- project portfolio
Please put CSS and JS into your layout ejs files.
Please use the filename format
Assuming I want to create a post layout with the name
elegant. The filename for the ejs file is
categoryLayoutcan be one of the following:
Fix any typo and grammar error
My native language is Chinese, not English. Please help.
The theme cannot exist without reference to other themes.
- Anisina theme which is from Hux theme : The design is beautiful. A-RSnippet theme used its design.
- NexT theme and Landscape theme: When I don't know how to achieve some functionality, I will search source code for both themes. They are awesome.
- 184 themes on the official Hexo website. I spent around 12 hours on reading read all themes and wrote down which feature I wanted to add in the future.
There are two main places to get help with A-RSnippet theme:
Except for a private channel on Discord, please use English only.
If you want to use languages other than English, please use the following format:
[your language in English] xxxx [English] yyy
[Chinese] 除了一个Discord私人频道(你可以通过Patreon加入), 在论坛和Discord里发言只允许使用英文.
[English] Except a private Discord channel (you can join in via Patreon), all discussions on the forum and Discord must use English only.
Learning A-RSnippet Theme
- Future: Youtube Channel
Style Test Reference for Each Layout
- post Layout & LeetCode Layout
heading, paragraph, link blockquote, list, form, table, abbr, acronym, sub, sup, image, Math formula, video (YouTube, Vimeo), jsfiddle, gist
- page Layout
- tag Layout
- archive Layout
- poem Layout
- portolio-slim Layout
- list-category-leetcode Layout
- list-tag-leetcode Layout
- 404 Layout
Donate & Support
Thank you for choosing A-RSnippet theme.
Before creating the A-RSnippet theme, I was angry that themes were not easy to modify and source code was hard to understand.
Now I will not do it anymore. I spent several days to finish the first version. Writing documentation required more days. It taught me that every theme requires a big amount of time to complete and every authors' effort should be respected.
Simplicity does not mean easy or not complicated.
NexT theme seems to conform to minimalism. It has lots of functionalities and customization. It is not easy.
The goal of the theme is to contain as many features as possible. Hence, this is not a simple theme. For example, there will be more than one layout to present project portfolio. Please submit your layout if it is different from mine. There are more features on the way. It will take me a lot of time.
If you like A-RSnippet theme and/or appreciate my time dedicated to the theme, please give a tip to support the development of the theme.
There are four ways:
Star the repo.
For people who don't donate through Patreon:
If you ask a question via Discord, you must use English and write a post in English in the forum to show how you solve the problem. You must send me the link to the post. Otherwise, I will not answer your question(s) in the future.
For people who donate through Patreon:
You will automatically join in a private Discord chatroom. You can ask me any question there.
There are some benefits:
- You can suggest any feature you want. I will create a poll of a list of features to be developed after each release. The polls are shown only to you. The top items will be taken care of first.
- You can ask me questions in Chinese or English in the private channel on Discord.
- You will not be obliged to write a post in English in the forum. I will do it for you.
Adding new features, fixing bugs, answering questions in the forum and Discord will take me an enormous amount of time. Hence, I decided to give up maintaining Chinese documentation. If you want to translate it into other languages, please feel free to do it. You can add a link here after completion.