A clean Hugo blog theme, originally by Asuka Suzuki
anglesladder — Hugo Blog Template
By chaomifan
Angel's Ladder is a clean Hugo blog theme; this repository is a version customized for Chinese social and categorization features on top of the original.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Preview provided in the project README.
One original preview is available. Open the full image to inspect the design.
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Supports responsive layout, pagination, tags, Disqus comments, and source code highlighting
Social links changed to Weibo, WeChat, Jianshu, and email; Twitter, Facebook, etc. removed
Text category links added in the footer; articles on homepage and list pages include summaries
Theme color modified via LESS file; default color is #29abe2
Template Details
Angel's Ladder is a blog theme for Hugo. The original was developed by Asuka Suzuki, and this repository is a personalized modification by chaomifan (Ethan) based on the original. The original features include a clean design, responsive layout, pagination, tags, Disqus comments, source code highlighting, and Google Analytics.
The customizations focus on Chinese usage scenarios: adjusting the social account parameters in the header to include Weibo, WeChat, Jianshu, and email, and removing foreign social accounts such as Twitter and Facebook; adding text category links in the footer; and adding summaries to articles on the homepage and list pages. Theme configuration is done through config.toml, where parameters such as subtitle, social links, category links, avatar, copyright notice, Disqus shortname, and Google Analytics tracking ID can be set; sections corresponding to unfilled optional parameters will be hidden.
The theme color is modified by editing layouts/static/theme.less and compiling it to theme.css; the default color is #29abe2. Other style changes are written in layouts/static/custom.css. The repository was last updated in 2017, and the installation instructions in the README are based on Hugo usage at that time; compatibility with newer Hugo versions is not stated.
Is it right for your project?
Use Cases
- Building a personal Chinese blog with Hugo
- Sites needing domestic social entry points such as Weibo, WeChat, and Jianshu
- Blogs wanting to display article summaries on the homepage and list pages
- Controlling social links, avatar, and copyright display via config.toml parameters
Suitable For
- Users who use Hugo and are comfortable manually editing config.toml
- Personal blog authors writing in Chinese for domestic readers
- Sites needing Disqus comments and Google Analytics
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Clone the repository into the themes directory of your Hugo site, using the directory name angels-ladder
- 2
Replace the site's existing config.toml with the theme's web_config/config.toml
- 3
Local preview command is hugo server -t angels-ladder -D -w
- 4
To change the theme color, edit layouts/static/theme.less and compile it to theme.css
- 5
The repository was last updated in 2017; compatibility with newer Hugo versions must be verified independently
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license from the public repository; the free scope is the code of this version and does not imply that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Disqus comments are an optional external service: you must enter disqusShortname in config.toml to enable them; otherwise the comment section is hidden. You need to register a Disqus account before use.
- Google Analytics is an optional external service: it is enabled only when a Google Analytics tracking ID is entered; otherwise analytics is skipped. You need to register an account before use.
- ShareThis share buttons are an optional external service: they are displayed only when a ShareThis publisher key is entered; otherwise they are hidden. You need to register an account before use.
- Installation requires cloning the repository from GitHub into the themes directory of your Hugo site and setting the directory name to angels-ladder; it depends on Git and a Hugo environment.
- The installation steps require replacing the site's existing config.toml with the theme's web_config/config.toml, which will overwrite existing configuration; you must back up and adjust it yourself.
- Changing the theme color requires using an external LESS compiler to compile theme.less into theme.css; the theme itself does not provide compilation tools.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; they cannot be judged solely by the code's MIT license.
- External services such as domain, hosting, database, payment, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
disqusShortname = "Ethan's PMbook"
Original README
analytics = "UA-XXXXXXXX-X"
Original README
shareThis = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
Original README
git clone https://github.com/chaomifan/anglesladder.git "angels-ladder"
Original README
mv web_config/config.toml path/to/yoursite/config.toml
Original README
https://github.com/chaomifan/anglesladder/blob/master/LICENSE.mdhttps://github.com/chaomifan/anglesladder/blob/master/README.mdThen compile the LESS file by using [one of LESS compilers](http://leafo.net/lessphp/editor.html),
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- Partly documented · 68 / 100
- Technologies
- Hugo
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2017-05-02
- Screenshot last checked
- 2026-10-02
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 398593998b07ab07f79df960ac7cd86cacff4569e422fa08105caaae425fe06e
2026-10-02T17:16:48.281Z
Source file / repository# Angel's Ladder 个性化配置
## Overview
Angel's Ladder is a simple blog theme for Hugo.
* Simple and clean design
* Responsive design
* Pagination
* Tagging
* Disqus
* Source code highlighting
* Google Analytics
个性化部分:
* 修改标题栏中 社交账户的配置参数,增加 微博,微信,简书,邮件,去除不常用的 Twitter、Facebook等国外社交账户
* 在页尾增加文字分类链接
* 增加首页文章简介(summary)
* 增加列表页文字简介(summary)
## Screenshot

## Installation
将文件 Clone 到 hugo 的 themes 文件夹
```
cd themes
git clone https://github.com/chaomifan/anglesladder.git "angels-ladder"
```
使用皮肤文件夹中的 config.toml 文件 替换原本的 config 文件 (path/to/yoursite 是你 hugo 生成的网站存放路径)
````
mv web_config/config.toml path/to/yoursite/config.toml
````
预览效果(path/to/yoursite 是你 hugo 生成的网站存放路径)
````
cd path/to/yoursite
hugo server -t angels-ladder -D -w
````
## Configuration (config.toml)
**贴上我修改过的配置文件**
````
baseurl = "http://chaomifan.github.io/"
languageCode = "en-us"
title = "Ethan's PMbook"
theme = "angels-ladder"
disqusShortname = "Ethan's PMbook"
[params]
subtitle = "信心是黑暗中的灯塔,任何时候都不能丢"
about = "#"
weibo = "http://www.baidu.com"
wechat = "htttp://www.baidu.com"
jianshu = "http://www.jianshu.com/users/f5820a96231b/timeline"
github = "http://www.baidu.com"
mail = "mailto:[email protected]"
guifan = "/categories/产品规范/"
fenxi = "/categories/产品分析/"
jiqiao = "/categories/技巧分析/"
yanjiu = "/categories/技术研究/"
profile = "/images/ethan.png"
copyright = "Written by Ethan,转载请注明出处,谢谢!"
````
**原版皮肤中关于配置文件的修改说明**
To take full advantage of the features in this theme, you can add variables to your site config file.
The following is the example configuration.
````
baseurl = "http://tanksuzuki.com/"
languageCode = "ja"
title = "TANKSUZUKI.COM"
disqusShortname = "tanksuzuki"
[Params]
subtitle = "I would like to be a layer 3 switch."
facebook = "https://facebook.com/foobar"
twitter = "https://twitter.com/foobar"
github = "https://github.com/foobar"
showsRSS = true
profile = "/images/profile.png"
copyright = "Written by Asuka Suzuki"
analytics = "UA-XXXXXXXX-X"
shareThis = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
````
Details of each parameter are as follows.
| Parameter | Required | Comment |
| :--- | :--- | :--- |
| baseurl | yes | Enter the title of your site. |
| languageCode | yes | Enter the language code of HTML. Example: en, ja. |
| title | yes | Enter the title of your site. |
| disqusShortname | no | Enter the short name of the disqus. If you do not enter, disqus section is hidden. |
| subtitle | no | Enter the subtitle of your site. If you do not enter, subtitle is hidden. |
| facebook | no | Enter the URL of Facebook. If you do not enter, the link is hidden. |
| twitter | no | Enter the URL of Twitter. If you do not enter, the link is hidden. |
| github | no | Enter the URL of Github. If you do not enter, the link is hidden. |
| showsRSS | no | Enter true to show the URL of RSS. If you enter false or nothing, the link is hidden. |
| profile | no | Enter the path to the profile image. If you do not enter, profile section will be hidden. |
| copyright | no | Enter the copyright notice. If you do not enter, copyright display is hidden. |
| analytics | no | Enter the tracking ID of Google analytics. If you do not enter, the analysis will be skipped. |
| shareThis | no | Enter the publisher key of ShareThis. If you do not enter, the ShareThis buttons are hidden.
## Style Customization
To change the theme color, edit the `layouts/static/theme.less`.
Then compile the LESS file by using [one of LESS compilers](http://leafo.net/lessphp/editor.html),
and replace the content of `layouts/static/theme.css` with the compiled CSS.
The default theme color is `#29abe2`.
Please change the favorite color.
````
/* Theme color
--------------------------------------------------*/
@color: #29abe2;
````
For original styles, please edit the `layouts/static/custom.css`.
## License
Open sourced under the [MIT license](https://github.com/tanksuzuki/angels-ladder/blob/master/LICENSE.md).
## Author
* 原作者:Asuka Suzuki
* 修改:Ethan
## 参考文档
1. gohugo.io/content/summaries/
2. www.gohugo.org/theme/angles-ladder/
## Contact
[点此给我发邮件](mailto:[email protected]) :)
Explore similar templates
Compare previews and descriptions within the same stack and category.

hugo-PaperMod
A fast, clean, responsive Hugo theme for blogs and lightweight portfolios, with three layout modes (Regular, Home-Info, Profile), automatic and manual light/dark themes, Fuse.js client-side search, multilingual support, and built-in Open Graph, Twitter Cards, and Schema.org data.
Hugo · Portfolio

LoveIt
LoveIt is a clean, elegant, and feature-rich Hugo blog theme derived from LeaveIt and KeepIt, MIT-licensed. It offers light/dark modes, responsive layout, multilingual support, and search via Lunr.js or Algolia.
Hugo · Blog

hugo-coder
hugo-coder is a minimalist Hugo blog theme maintained by luizdepra under the MIT license. It provides a clean, text-focused blog appearance, configuration documentation in the docs directory, and a complete exampleSite with hugo.toml.
Hugo · Blog

blowfish
Blowfish is a Hugo personal website and blog theme built with Tailwind CSS 4, focused on lightness, simplicity, and content-first presentation.
Hugo · Blog

hugo-paper
hugo-paper is a simple, clean, and customizable Hugo blog theme configured through config.toml or hugo.toml.
Hugo · Blog

hextra
Hextra is a Hugo theme for documentation and blog sites, built on Hugo and Tailwind CSS with design referencing Nextra.
Hugo · Documentation
