huxpro / huxpro.github.io

My Blog / Jekyll Themes / PWA

Hux Blog

I never expected this to become popular.

User Manual 👉

Getting Started

1. You will need Ruby and Bundler to use Jekyll. Following Using Jekyll with Bundler to fullfill the enviromental requirement.

2. Installed dependencies in the Gemfile:

$ bundle install 

3. Serve the website (localhost:4000 by default):

$ bundle exec jekyll serve  # alternatively, npm start

Development (Build From Source)

To modify the theme, you will need Grunt. There are numbers of tasks you can find in the Gruntfile.js, includes minifing JavaScript, compiling .less to .css, adding banners to keep the Apache 2.0 license intact, watching for changes, etc.

Yes, they were inherited and are extremely old-fashioned. There is no modularization and transpilation, etc.

Critical Jekyll-related code are located in _include/ and _layouts/. Most of them are Liquid templates.

This theme uses the default code syntax highlighter of jekyll, Rouge, which is compatible with Pygments theme so just pick any pygments theme css (e.g. from here and replace the content of highlight.less.

Interesting to know more? Checkout the full user manual!

Other Resources

Ports

• Hexo by @kaijun
• React-SSR by @LucasIcarus

Starter/Boilerplate

• Out of date. Helps wanted for updating it on par with the main repo

Translation

• 🇨🇳 中文文档（有点过时）

License

Apache License 2.0. Copyright (c) 2015-present Huxpro

Hux Blog is derived from Clean Blog Jekyll Theme (MIT License) Copyright (c) 2013-2016 Blackrock Digital LLC.

huxpro.github.io's Issues

当我使用HTTPS时，有些内容无法正常显示~

http://huangxuan.me
https://huangxuan.me
HAVE HTTPS:

NO HTTPS:

How to set Featured Tags

如题

footer里的github页怎样生成？

rt

用连续#表示的标题会多出一个#

生成后的网站 markdwon 语法的不同级标题的表示会多一个#，有强迫症的同学表示好纠结~~~

boilerplate生成页面img路径问题

直接clone boilerplate下来，启动serve， 发现avatar的img无法显示的。因为在config文件里绝对路径硬编码了/img/avatar-hux.jpg 所以当有baseurl: "/huxblog-boilerplate"时访问的地址就不对了。

想问问这个paginator

fork下来发现首页没有文章列表，把paginator改成site才有，但是没有分页了，这是怎么回事呢

How to improve English

header-img 可以用其他方式加载吗?

比如:
header-img: /img/example.jpg
我发现当我放一些稍大,质量高一点的图,加载速度会有点慢,所以不知道能不能直接丢个云存储空间的图片链接进去
比如:
header-img: "http://abc.com/example.jpg"
我该怎么做呢?

开源模板

我在想怎么将你这个模板变成真正的开源模板，即你这边的仓库更新后，我自己的仓库也能从你那获取更新，而自己写的文章及个人设置不会变。请问有木有解决办法？

Separate Duoshuo to Config

Fork了你的博客 准备改用你这个主题。 整体设置相对简单
但是发现一些可以优化的地方

• 多说的配置写在post.html模板里面， 这样导致需要更改模板， 配置后 通过include方式
• 对header， footer，navigator可以采用config的形式
• 首页的tag如果支持点击就完美了

设置字体大小无效

自己在设置 post-meta 的字体大小时，我看到原来是 16 px ,然后自己想改小，设置为 12 px，然后在 hux-blog.min.css 中找到对应的 css 位置，重新设置大小，设置后发现无效，但是通过 浏览器发现属性其实已经是 12 px 了。

不知道这怎么解释。

Markdown parse error

你好，很喜欢你制作的博客模版，最近在折腾我的博客，Fork了你的项目。可是在提交博文的时候，发现Markdown解析有点问题，会在标题旁多个#号，二级三级目录无法解析，表格分割线无法解析，如下：

我查看了你的博客，以及其他fork自你博客的朋友的博客，发现都存在这个问题(win、ios及Android下都存在)。我在本地用Jekyll调试也出现了这一问题，由于我在Github上预览post时发现解析正常，所以我尝试注释掉config里面的markdown：kramdown，问题依然存在。没办法了，只能来请教你了（中度强迫症患者，对页面的瑕疵不能忍，望解救）。

请教博主为何标题前面会有一个 “#” ？如何去除 或者 隐藏 ？？

使用 "##" 或者 “===========” 标题前面都会有个“#”，定位用的 ，要怎么去除呢？

超过2016-4-21文章输出不了，不知道是不是只是我的问题

为何我date输入21文章就不显示了，而且输入20 显示21？

页面底端Facebook无法显示

IE7内核下导航栏不能展开

模版很喜欢，已经用上了，不过最近发现一个小问题，在以下版本浏览器上，nav不能正常弹出

浏览器信息： Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; .NET4.0E; .NET4.0C; rv:11.0) like Gecko

Make Comments/Analytics configurable/disable

你好，想 fork 你的主题，哈哈，很棒的主题，
嗯，好吧，前端方面我是小白，所以，想提几个问题。

1. 我不需要评论，怎么彻底去掉评论叻。因为....不会有这么多人评论的，因为没这么多人访问，哈哈。
2. 我不需要统计，怎么彻底去掉统计叻。因为....同上....
3. 我不需要 Tag，怎么彻底去掉 Tag了。因为....同上...
4. 因为 blog 很多都是 code，所以，代码块的颜色优化我该怎么做呢？
5. 你真棒

MrFu-傅圆的个人博客

Baseurl not works

标签页的路劲不对，我在config.yml文件中，将baseurl改成了我的项目名字baseurl:'/blog',可是当我访问我的主页时候，可以正常显示，就是点选featured tags时，github pages就404，这个问题该如何解决呢？

Create Archive

按照步骤操作，还是收到Page build warning邮件

jekyll 已经是3.1.2
也按照说明文档更新，配置了。
求助

请教下博主类似于你博客中的portfolio页面如何设置生成？？

如题

能否加个搜索的地方呢

哪怕使用谷歌搜索也行啊

Is there a posibility that bootstrap maintains the whole responsive function rather than do it on my own

when i check out the *-blog.less file, i saw the content just like this:@media screen and (max-width: 768px), can I replace it with bootstrap's class? it may be more maintainable...

run jekyll serve failed ''cannot load such file -- jekyll-paginate“

When I use "jekyll serve" to preview my blog, I got flowing erro：

Configuration file: C:/Users/jjj/Documents/GitHub/shaoguoji.github.io/_config.yml
C:/Ruby22-x64/lib/ruby/2.2.0/rubygems/core_ext/kernel_require.rb:54:in require': cannot load such file -- jekyll-pagina te (LoadError) from C:/Ruby22-x64/lib/ruby/2.2.0/rubygems/core_ext/kernel_require.rb:54:inrequire'
from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/jekyll-3.0.1/lib/jekyll/plugin_manager.rb:30:in block in require_ge ms' from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/jekyll-3.0.1/lib/jekyll/plugin_manager.rb:27:ineach'
from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/jekyll-3.0.1/lib/jekyll/plugin_manager.rb:27:in require_gems' from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/jekyll-3.0.1/lib/jekyll/plugin_manager.rb:19:inconscientious_requi
re'
from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/jekyll-3.0.1/lib/jekyll/site.rb:97:in setup' from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/jekyll-3.0.1/lib/jekyll/site.rb:49:ininitialize'
from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/jekyll-3.0.1/lib/jekyll/commands/build.rb:30:in new' from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/jekyll-3.0.1/lib/jekyll/commands/build.rb:30:inprocess'
from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/jekyll-3.0.1/lib/jekyll/commands/serve.rb:26:in block (2 levels) in init_with_program' from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/lib/mercenary/command.rb:220:incall'
from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/lib/mercenary/command.rb:220:in block in execute' from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/lib/mercenary/command.rb:220:ineach'
from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/lib/mercenary/command.rb:220:in execute' from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/lib/mercenary/program.rb:42:ingo'
from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/lib/mercenary.rb:19:in program' from C:/Ruby22-x64/lib/ruby/gems/2.2.0/gems/jekyll-3.0.1/bin/jekyll:17:in<top (required)>'
from C:/Ruby22-x64/bin/jekyll:23:in load' from C:/Ruby22-x64/bin/jekyll:23:in

'

After update the jekyll and run jekyll again, I got another erro:

Dependency Error: Yikes! It looks like you don't have jekyll-paginate or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. The full error message from Ruby is: 'cannot load such file -- jekyll-paginate' If you run into trouble, you can find helpful resources at http://jekyllrb.com/help/!

jekyll 3.1.1 | Error: jekyll-paginate

Post hidden by invalid date format

首先感谢提供了这么漂亮的模板！

我今天使用这个写了一篇博客，但不知为什么它既没有显示在首页，也没有在Tags下，见https://github.com/candycat1992/candycat1992.github.io。

我对前端不熟悉，这是什么原因造成的呢？

Make Comments/Analytics configurable

呐……就是这样。LZ的双列模板实在是太棒了。

我比较喜欢上列留白，再加上对Bootstrap导航栏的疯狂热爱，做成了这样的一种情况hz | blog。总的设计思路是主页只保留有关技术的文章，其他杂谈在导航栏
里，不主动推送。

---

在page.html里引入bootstrap.min.css之后感觉字体不太好，想换用微软雅黑，但chrome里提示一直没有被使用，还是默认的字体。还有一些链接没有处理。都是一些小的problem，毕竟也不是专业前端，就这样吧……之后有机会再改。

新增加了 date.html，用来存放Archive，按照日期列表来存储文章。

---

在blog.css里关于label{}的情况，颜色是否应该用background-color:，仅仅用color无法改变标签的背景色。

---

还有一个小建议是在文档里增加修改多说评论和百度统计的文档。要不就会有很多莫名其妙的评论，sigh:-)

关于Trusted Domains

你好，我想问一下，如何设置多说的域名白名单呢？
我在多说后台的域名白名单中添加了自己博客的地址，可是发现评论框无法显示了，请问这是啥情况呢？
谢谢。

How to configure the site subtitle？

just like theBoilerplate of Hux Blog, i could not found the edit extrance...

post a img like this:

How to use own domain-name

打算采用你的这个模版
好像可以省好多事……

Jekyll的要求不是 http://username.github.io/projectname 么
求教：是怎么把域名改成你自己的呢

how to make Header Images looks great?

如题，很喜欢博主的背景大图色调，想请教一下怎么才能调整出那样的效果？

分类归档 ／ Archive Support

求教jekyll分类归档实现 貌似github不让用jekyll插件啊

1

1

请问data-thread-id是什么ID？如何获取？

请问一下的data-thread-id="1187623191091085319"是什么ID，从哪里获取的ID？ 谢谢！

<!-- 多说评论框 start -->
<div class="comment">
    <div class="ds-thread"
    {% if site.duoshuo_username == "Huxpro" %}
        data-thread-id="1187623191091085319"
    {% else %}
        data-thread-key="{{site.duoshuo_username}}/about"
    {% endif %}

    data-title="{{page.title}}"
    data-url="{{site.url}}/about/"></div>
</div>
<!-- 多说评论框 end -->

能不能增加一个自动生成的侧边导航栏？

加入侧边导航栏 ，让文章脉络清晰，还可以实现跳转，方便阅读。如果用 bootstrap affix 感觉要自己写，太麻烦，不知道有没有自动生成的。最近研究了几天也没有结果，但是看到了这个网站：http://beiyuu.com ，post文章里面有导航栏，且在屏幕变小时自动消失。看了一些原文件是一个js,完全不懂，如果有懂的人可以帮忙修改以嵌入到这个博客中。

没有SSH秘钥如何使用你的模板:)

正克隆到 'huxblog-boilerplate'...
Enter passphrase for key '/root/.ssh/id_rsa':

How to set Keynote blog link just like js-module-7day?

I see you blog 《JAVASCRIPT MODULARIZATION SEVEN DAY JavaScript 模块化七日谈》link is http://huangxuan.me/js-module-7day/#/ ，my blog theme mrfu.me is use your theme.
I will be in the team for technology sharing, and I see your Keynote sharing tools are great.

I see your Keynote great, but I don't know how to add to my blog. Such a link with you http://huangxuan.me/js-module-7day/#/
Could you teach me.

建议增加 RSS 输出

还是有大量老年人会使用 RSS 的输出订阅 blog

模板的clone方式

首页写的是git clone [email protected]:Huxpro/huxblog-boilerplate.git ，但这样其实没有权限，会被拒绝的。建议改成 git clone https://github.com/Huxpro/huxblog-boilerplate.git。

因为只是一个小的修改，我就不fork和pull了~

多说评论框和分享如何使用？

我已经有了多说的模板代码，应该在哪些文件中使用呢？

Chinese Document

Volunteer needed.

sidebar 的标题链接无法正确跳转

sidebar 当中的 ABOUT ME, FEATURED TAGS 的链接点击之后跳转到的是首页.

看代码大概是想转到对应的页面的

<h5><a href="{{/tags/ | prepend: site.baseurl }}">FEATURED TAGS</a></h5>

可能漏了引号

<h5><a href="{{ "/tags/" | prepend: site.baseurl }}">FEATURED TAGS</a></h5>

Missing timezone in metadata date can lead to wrong date in url

环境：
win7、jekyll

jekyll-paginate missing duplicate #18

我下了huxblog-boilerplate-master之后， 运行jekyll serve 会有提示

Deprecation: You appear to have pagination turned on, but you haven't inc
luded the jekyll-paginate gem. Ensure you have gems: [jekyll-paginate] in yo
ur configuration file.

而且首页没有 blog列表

在_config.yml 中 添加 gems: [jekyll-paginate] 之后 没有这个问题。

markdown不能生成html

当写的blog中 date如下设置时，

date:       2016-01-09 18:00:00

_site下不会生成对应的页面。
而有些时间值可以 比如

date:       2016-01-09 08:00:00

不知道这是什么情况？！
博主没有遇到过这种情况吗？

HTTPS is not fully supported

浏览器提示不安全的脚本，如果加载了脚本 就无法使用 HTTPS 了。。。。。
另外建议换种 highlight 自带的好丑啊……

Don't wrap the overflow code

我不是很懂模板的设计，想问一下，当一行代码的长度超过宽度时，使用滚动条显示，而不是自动换行。自动换行在有些情况下会很丑。

作者能不能让主题支持一下Hexo？

很喜欢的一个主题，能不能添加一下Hexo的支持，谢谢！

MathJax Support

Hi, I would like to make a pull request to make this blog support MathJax to make beautiful formulas in posts.However, I wonder which way you prefer more:

1. Just add the javascript(?) in the _layouts/default.html thus can use it in most place of the blog
2. Create a file named with mathjax_support in your _include directory and finally use a variable use_math and set its value to true to use it in some post if necessary.

By the way, you can also make this change on your own by reference this.

Short About broken when description turn off but avatar on.

In the side bar, there should be a spacing expected between avatar and SNS Link when description turned off.

移植模板时自己出了些小问题，求指教

很喜欢你做的模板，移植到自己的仓库时不知道操作了什么页面出现了些小问题，由于不懂前端代码，截了几张图片

，恳请指教下怎么修改呢？
1、博客正文页右边多出了一列滚动条
2、使用多说和disqus时页面布局紊乱了

Separate boilerplate from blog

能不能把代码单独弄一个Git仓库，因为每次更新都需要更新你写的文章。　😅

It's always loading

Looks like the web page is always loading. Anyone had this issue too?