simpleyyt/jekyll-theme-next

Elegant theme for Jekyll.

NexT

精于心，简于形

NexT 是由 Hexo NexT 移植而来的 Jekyll 主题。

在线预览 Preview | Yitao's Blog | NexT 使用文档 | English Documentation

浏览器支持 Browser support

贡献 Contributing

欢迎提交问题与需求，修复代码。

开发 Development

NexT 主旨在于简洁优雅且易于使用，所以首先要尽量确保 NexT 的简洁易用性。

NexT is built for easily use with elegant appearance. First things first, always keep things simple.

捐赠

支付宝捐赠链接还是要有的，万一真的有人捐呢。

jekyll-theme-next's Issues

How to build site with minify JS and CSS

How I can build my site with minify JS and CSS. I see in demo NexT theme have main.css has minified. But I don't know what option in _config.yml can set this. And if I want to build minify JS and CSS should I need to set what options or install a new plugin?
Thanks!

侧边栏社交链接 无法使用

按照文档添加了:
social:
GitHub: https://github.com/your-user-name
Twitter: https://twitter.com/your-user-name
微博: http://weibo.com/your-user-name
豆瓣: http://douban.com/people/your-user-name
知乎: http://www.zhihu.com/people/your-user-name
但是啥都没有发生QAQ

Multiple authors

Hello,

First I'd like to say that I love this theme, great job!

As mentioned in the title of this issue: Is it possible to specify multiple authors? I mean show them in the overview section and e.g. assign author to a particular post?

有个内嵌html的问题啊

markdown表格不能控制宽度，所以我一般都是用markdown先生成html在里面改th的width值，内嵌到文章里面发表。但是我发现在文章里面如果内嵌多个html片段，从第二个开始，表格的第一行的th左边的<就会被转义，导致第一行不显示，详情在https://eggycat.github.io/s32k144/2017/09/28/S32K144_1/#
可以看到我这篇文章的第一个表格是没问题的，第二个表格第一行就变成了代码，查看源代码显示<变成了:<什么的，不知道这个是什么问题・_・?

Empty menu messes with content visibility

To reproduce, take out the menu by doing one of these:

• Comment out the menu in _config.yml
• Comment out all the menu options in _config.yml
• Comment out site-nav in header.html
• Remove class menu-item from <li class="menu-item menu-item-{{ itemName }}"> in header.html

The associated content (posts etc) in index.html disappear (they're still around but you can't see them).

Show prompt and/or line numbers

I was wondering if I can automatically show a prompt and/or line numbers in all code blocks to distinguish code input from output. I tried some options mentioned here, but unfortunately they don't work.

分类（category）的页数永远都是 1

category:
  paginate: 10
  paginate_path: "/page:num/"

设置分类为每页十个条目，我有个分类是 29 个条目，但是页数依然为 1 。无论我怎么设置分类的 paginate 参数，页数永远都是 1 。
请问这种情况如何解决。
是 bug 吗？

tags not working on github page

Hi,

I change the permalink in _config.yml

permalink: /:year/:month/:day/:title

and tags works fine on local, but github page throw 404 when access the url

http://host/tag/#/Python

分类（Categories）使用中文会导致该页面报404

---

categories: 模板

如上，会导致该篇文章404

Cannot centre align small images in posts

I tried:

1. using kramdown in the text body:
   {: style="text-align:center"}

2. customising CSS and adding the new CSS class to the image link in markdown file:
   .center-image { margin: auto; width: auto; text-align: center; display: block; }
   (I added this class to _sass/_common/components/post/post.scss)
   then in file,
   ![](link-to-image){: .center-image}

3. creating a new CSS class (as a new file) and using HTML in md file:
   .img_container { text-align: center; width: auto; margin: 0 auto; }

<img src="link-to-image" class="img_container" />
or, <div class="img_container"> <img /> </div>

Anyone got a clue what else I could try to centre align a small image? Thanks ahead!

你好，Post页数问题

你好，我的网站是建立在“http://domain.com/blog”的。
但是页面最下方的“上一页”和“下一页”没法正常载入，总是会载入到“http://domain.com/page2”
而不是“http://domain.com/blog/page2”
请问如何解决这个问题？

以及在菜单修改中，我添加了一项，希望能够从“http://domain.com/blog”回到“http://domain.com”，
但是当我在这一项旁边写上“http://domain.com”的地址后，
却载入到“http://domain.com/bloghttp://domain.com”，
请问有没有办法回去？

言语表达不是很好，希望能够理解，感谢！

Customize sidebar

Can I customize the text below the avatar in the sidebar? Currently it says Build a Jekyll blog in minutes, without touching the command line, but I can't seem to be able to change it. Ideally, it should show the subtitle value defined in _config.yml.

Furthermore, I'd like to display the tags count instead of the category count - is this possible?

二级文章目录不支持文章内跳转

如题。如果文章目录只有一级的话，点击跳转到相应位置是正常的。有两级的话就不行了。这是什么原因呢？
可以看下这篇文章的情况：http://www.flypeom.site/linux/2017/08/11/structural-command-of-shell/

我用markdown写个水平线，在网页中显示的却是虚线水平线

我用markdown写个水平线，网页中显示的却是虚线水平线，请问在哪修改

在码云上的pages报错

部署的时候显示：
部署失败

错误信息: Liquid syntax error (line 43): Unknown tag 'gist'

不知道什么原因，求助

新功能添加(Hide comment function)

Update English description of this issue
I would like to add a button that serves the purpose of hiding comments (lazy-loading & keeps page clean). Visitors can view the comments via clicking the button.
Now I have realised the function based on Disqus. However, the button was not on a proper position.
---分割线----
我想添加一个可以隐藏评论的按钮（可以节省loading时间和保证页面整洁），浏览者可以通过点击按钮来查看评论。
现在我已經针对Disqus评论实现了这个功能；但无论我如何尝试，按钮的位置都没有出现在合适的地方。
按钮测试链接，可以看到在页面最底端那个绿色按钮。

希望有人就以下小问题能给我一些帮助或建议，谢谢

• 将隐藏评论按钮放在每篇博文post-nav后，footer之前
• 优化js function

这个问题的相关commit：链接

Copyright year since 2017 shows redundant range

I set since: 2017 in _config.yml, which results into a copyright string of

© 2017 - 2017 Clemens Brunner

on my page. Is it possible to simplify this to

© 2017 Clemens Brunner

if the current year is equal to the value of since? I'm sure this can be adapted in _includes/_partials/footer.html somehow, but I don't know how.

font-awesome icon `handshake`不能显示

我尝试在_config.yml里把一个目录的图标menu_icons改为handshake时，发现此图标不能显示。
我检查了一下，发现这个图标是存在于font-awesome.css文件里的。如图（Friends前为空）：

---

另外祝新年快乐！

上篇博文的链接没有显示

Issue pic:

在每篇博文的底端，可以看到post-nav-next下一篇博文的链接（如图，显示了< Site second test post），但是没有显示上一篇文章的链接（我可以肯定上篇博文确实存在）。
我尝试过的debug：

• 我重新clone了这个repo，发现此问题依然存在（排除了我后来可能的乱改）；
• 检查了_includes/_marco/post.html有关的code block，在我看来没有问题

      {% unless is_index %}
      {% if post.prev or post.next %}
        <div class="post-nav">
          <div class="post-nav-next post-nav-item">
            {% if post.next %}
              <a href="{{ post.next.url | relative_url }}" rel="next" title="{{ post.next.title }}">
                <i class="fa fa-chevron-left"></i> {{ post.next.title }}
              </a>
            {% endif %}
          </div>

          <span class="post-nav-divider"></span>

          <div class="post-nav-prev post-nav-item">
            {% if post.prev %}
              <a href="{{ post.prev.url | relative_url }}" rel="prev" title="{{ post.prev.title }}">
                {{ post.prev.title }} <i class="fa fa-chevron-right"></i>
              </a>
            {% endif %}
          </div>
        </div>
      {% endif %}
      {% endunless %}

• 尝试修改了_sass/_common/components/post/post-nav.scss的相关代码，没有发现变化

.post-nav-next {
  a { padding-left: 15px; }
}

.post-nav-prev {
  text-align: right;

  a { padding-right: 15px; }

  .fa {
    right: 0;
    left: auto;
  }
}

• 看了某些同样使用此Jekyll主题的博客，发现有些有这个问题，有些没有。
  -- 你用来demo的有这个问题：Simpleyyt
  -- 这个没有：Doublemine
• 发现原Hexo NexT主题没有这个问题。我对比了post-nav-prev有关代码，发现功能是一致的。

因为我接触前端没有多久且实在找不到问题根源，所以开个issue；望有人解惑，谢谢了。

How to add a social icon if it is not one of the ['GitHub', 'Twitter', ...]

I tried leetcode, link works, but shows no icon, where should i add that icon.
Expecting your answers, thank you.

mathjax开关打开后，示例的blog中，数学公式还是没能正确显示

除了要打开开关外，还需要配置什么才能使用mathjax,非常感谢～～～

mathjax:
  enable: true
  per_page: false
  cdn: //cdn.bootcss.com/mathjax/2.7.1/latest.js?config=TeX-AMS-MML_HTMLorMML

Font Configs aren't being applied

To reproduce, just clone and serve. The Lato global font isn't being applied ($font-family-chinese is), and any changes to that section in _config.yml don't seem to take effect.

Sidebar position doesn't take

Changing sidebar.position in _config doesn't do anything; it's always positioned to the right.

sidebar-position-right and sidebar-position-left , set by _layout.html, seem to missing but I could be wrong.

建议添加Gitalk支持

第三方评论能用的不多了，不如完全依靠github来解决，gitalk是个很好的工具，希望可以添加。

期待，谢谢！

文章版权声明显示不正常

如图所示，under 后面应该是有个超链接的，显示不出来。
使用浏览器为 FF 52.3。

较复杂的文章结构导致目录显示失败

目录部分被截断，并且在最后还会出现一段代码。问题在https://zhzh2001.github.io/2017/08/12/history-of-turbo-pascal-v2/

show year in category/tag list page

https://simpleyyt.github.io/jekyll-theme-next/category/#/tutorial

the post is month-day post_title, can it be year-month-day post_title?

本地运行报错

我的ruby版本为2.3.3
相应的命令工具都按照http://theme-next.simpleyyt.com/getting-started.html上进行，可运行时出现了如下问题，始终不解，希望能得到帮助，谢谢！

C:\Users\Administrator\Desktop\jekyll-theme-next> bundle exec jekyll server
Configuration file: C:/Users/Administrator/Desktop/jekyll-theme-next/_config.yml
Source: C:/Users/Administrator/Desktop/jekyll-theme-next
Destination: C:/Users/Administrator/Desktop/jekyll-theme-next/_site
Incremental build: disabled. Enable with --incremental
Generating...
GitHub Metadata: No GitHub API authentication could be found. Some fields may be missing or have incorrect data.
GitHub Metadata: Error processing value 'description':
Liquid Exception: No repo name found. Specify using PAGES_REPO_NWO environment variables, 'repository' in your configuration, or set up an 'origin' git remote pointing to your github.com repository
ERROR: YOUR SITE COULD NOT BE BUILT:
------------------------------------
No repo name found. Specify using PAGES_REPO_NWO environment variables, 'repository' in your configuration, or set up an 'origin' git remote pointing to your github.com repository

Open sidebar on specific site

The sidebar can be configured in _config.yml to be displayed for all posts (post), always, only when clicked (hide), or never (remove). Is it possible to set this behavior to hide, but automatically show it for a specific site such as about/index.md?

page build failure

写了一个post，本地运行正常，但是提交到github pages一直失败，用travis build 发现这个错误

             Error: could not read file /home/travis/build/linbo/linbo.github.com/vendor/bundle/ruby/2.3.0/gems/jekyll-3.5.1/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb: Invalid date '<%= Time.now.strftime('%Y-%m-%d %H:%M:%S %z') %>': Document 'vendor/bundle/ruby/2.3.0/gems/jekyll-3.5.1/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb' does not have a valid date in the YAML front matter.

             ERROR: YOUR SITE COULD NOT BE BUILT:

                    ------------------------------------

                    Invalid date '<%= Time.now.strftime('%Y-%m-%d %H:%M:%S %z') %>': Document 'vendor/bundle/ruby/2.3.0/gems/jekyll-3.5.1/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb' does not have a valid date in the YAML front matter.

The command "bundle exec jekyll build" exited with 1.

运行jekyll后出现错误`control characters are not allowed at line 1 column 1`

macOS10.13运行bundle exec jekyll server后出现错误
Error: could not read file /path/to/file/2017-11-03-kmeans算法及其推广.md: (<unknown>): control characters are not allowed at line 1 column 1
是文件名无法正常解析吗？
如文件名2017-11-03-kmeans算法及其推广在网站上显示untitled，日期是今天的。

请问这种情况是怎么回事？需要怎么解决？？谢谢！！

另外请问文件名和文档中的title有什么关系吗？如是否需要保持一致？

Webpage shows raw html code (no rendering)

我添加了一个About页面，然后想在这个页面加一个中英文切换按钮。（此页面使用的layout为page）。切换功能没有问题。
issue如下图，当我尝试用{ }格式来链接其他code时，网页会直接给出plain code。

而当直接使用<tag>格式时，如<p>This is a test</p>，一切正常。

我发现这个问题也同样存在于404页面；就是只能在该页面的html文件内hard-coding，不能引进外部.html或.md，否则浏览器会直接显示纯代码。

百思不得其解，故来求助。先谢谢了。

补充：看到有个issue是用about.md来建立about页面。我的方式有些不同：先在根目录新建了一个名为about的directory，并在directory里新建了index.html，最后在_config.yml的menu添加了about

jemoji conflicts with table of content

请问这个问题是可以解决的还是根本就不能解决？
不仅是在post中加入emoji（例如 :smile: )会导致toc混乱，就算是把emoji改成comment（例如 <!-- :smile: -->）也还是会导致同样的结果。

_config.yml: 'plugins' configuration option has been renamed to 'plugins_dir'

The 'plugins' configuration option has been renamed to 'plugins_dir' in _config.yml.
Please update your config file accordingly.

Disable Background JS Animation on Mobiles

The JS animation (like canvas_nest, three_waves) affects reading experience on small screens. Therefore, I am trying to disable the JS animation vendor pre-loading while detecting a small screen.

What's I have done so far:
In _includes/_scripts/vendors.html, I added a if-statement to detect certain small screen devices; but I can't find a workaround to include the liquid syntax inside the JavaScript.

{% if site.canvas_nest %}
  <script type="text/javascript">
      if (!( /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent) ) ){
          // move-inside doesn't work
          {% assign js_vendors = js_vendors | append: ', ' | append: 'canvas_nest: canvas-nest/canvas-nest.min.js' %}
      }
  </script>
  {% assign js_vendors = js_vendors | append: ', ' | append: 'canvas_nest: canvas-nest/canvas-nest.min.js' %}
{% endif %}

Any helps are appreciated!

A site I built with this theme isn't updating, help? [Solved by itself - sort of]

Hello!

EDIT: I jumped the gun, I'm sorry. It's working now. Not sure what I did. Thanks anyway!!

Edit 2: I added something to my new post and it looks like GitHub isn't pushing the changes. not sure whats happening. I'll look into it more when I get off work.

Great work with this theme man! It's pretty slick.

I am building this little blog with it:

https://inthecomments.today

However I am now having trouble updating the site at all.

This morning I added a few pages and a new post, yet nothing is showing up on the site despite showing up on the repo.

I don't know if this is an issue with the theme, how I set it up, or GitHub itself.

Any help you can provide is greatly appreciated.

Thanks and great work!

Josh.

Issue with adding items to menu

Hi,

Thanks for the theme. I have run into an issue while customizing the theme. I am trying to add two new items to the menu. The items get added and the fa icons get displayed. Also, the link to the menu items are working fine. But the text below the fa icons are not getting displayed for the two new itemsI have added, whereas it's getting displayed for the other items that're originally part of the theme. Can you please tell me what step am I missing here?

Link to my page: https://shailenmishra.github.io/

In the _config.yml, I have made the following changes:

menu:
  home: /
  categories: /categories/
  teaching: /teaching/
  cv: /cv/
  archives: /archives/
  about: /about/
  tags: /tags/
  sitemap: /sitemap.xml
  commonweal: /404.html

Do I need to make any specific change to header.html in the _partials folder? Thanks!

undefined $highlight-foreground

hi, i got this error when use next as Jekyll theme :

The page build failed for the master branch with the following error: Your SCSS file assets/css/main.scss has an error on line 12: Undefined variable: "$highlight-foreground". For more information, see https://help.github.com/articles/page-build-failed-invalid-sass-or-scss/

sidebar-toggle won't show on the about page

As the initial template doesn't contain an 'about' page layout template, I added an about.html file under the root directory and configured hyperlinks. However, the sidebar-toggle button won't show (right bottom corner) as on other pages.

文章设置成今天，但是显示不出来

设置成昨天的时间才能显示出来，怎么设置 timezone?

请问怎么开启markdown的流程图支持呀？

在menu添加Project page

问题：
请问我应该如何在menu bar上添加一个新的Project选单，并使该选单显示_projects文件夹中的内容？

详述：
简单来说，我想About、Archive选单后面加一个Project选单。点击这个选单会跳转到/projects/页面。这个页面拥有和homepage一样（差不多一样）的layout。而这个页面的内容从_projects这个文件夹里的.md文件渲染而来。这样做的目的是把我的blogs和projects分开管理，projects单独当作一个showcase，类似于Daring Fireball的效果。

目前我尝试过——

1. 在_config.yml里添加

collections:
  projects:
    output: true
#以及
menu:
 projects: /projects/

2. 在root dir里添加了projects和_projects两个文件夹。前者包含一个index.html指向layout文件夹里新添的project.html；后者包含一些.md文件。
3. layout里的project.html又include _include里面的project.html。这个文件是由原本的index.html复制修改而来。里面的内容和原来差不多：

<!-- project.html -->
{% if site.paginate > 0 %}
	{% assign projects = paginator.posts %}
{% endif %}

<section id="post" class="post-expand">
  {% for project in site.projects %}
    {% assign is_index = true %}
    {% include _macro/post.html %}
  {% endfor %}
</section>

{% include _partials/pagination.html %}

现在/projects/页面能正常显示，但是_projects文件夹里的内容并没有被渲染好（比如标题是Untitled）。

希望你能帮我解答，或者指明我应该修改哪些文件来达到效果！
第一次提问，如果问得有不清楚的地方，请多包含！非常感谢！

_drafts下的文章没有显示

我新建了_drafts目录，并往里面添加了post.但就是没有显示
同时我还在_config.yml中添加了show_drafts: true的参数。
but even doesn't working!
是没支持么？

page build problem

今天更新文章总是页面生成出错，我检查了很多遍md文档的语法，都没搞定。最后把新推的博文删掉了，但是页面还是出错。
我回邮件问了下github的support，返回来的错误信息看不太懂，想请教下。

Hi there,
At this time, we're unable to include the full error message in our emails. So, the best way to see the full error associated with the failed build is to build your site locally using Jekyll and the github-pages gem:
https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll
Here's the full error message I'm seeing on our end:
Liquid Exception: undefined method `to_liquid' for :auto_ids:Symbol in assets/css/main.scss
             Fatal: NoMethodError
                    undefined method `to_liquid' for :auto_ids:Symbol
We recently updated Jekyll to a version that included a large update in Liquid to version 4.0.0. Your best option for debugging is to build your site locally to resolve this issue.

这是因为Jekyll版本更新与主题配置文件配置不兼容引起的吗？我现在根据反馈本地调试看看。如果你知道这个问题的解答的话，请你指点指点。

sidebar wont aligh to left

Tried to align the side bar to appear on the left side of the html page by setting the positionin conf file to left but it doesn't work .
is it the right way to do it ?
Thanks!

How can I remove the '>' from searches?

Hi!

Using the local search, I find that my results have a '>' after the title. I've looked at localsearch.html for too long now and I just can't see where the '>' is.

Any help would be appreciated!

没人在更新了吗

评论模块用不了了，有没有人更新下

界面响应和 TAG 布局问题

你好，主题总体非常棒。

但几个问题：

1. 动画时间太长，建议可设置关闭或者时长。不知道的还以为机器慢死或者网速慢死。视觉效果第一次看很好，但时间稍微一长，非常影响体验。
2. TAG标签建议点击后直接在同一页显示，要不点击一个TAG后还要返回再点击新TAG，体验不好。

祝你的主题越来越棒

没有弄清楚怎么使用mathjax

在_config.yml都设为per_page 和 enable 都设为 true后 只有在主页上面能看见公式 点进去查看博文详情就没有了 在_layouts/page.html 里面添加了

<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"> </script>

也没用呢

要如何添加一个about页面呢？

jekyll和hexo不太一样，要如何建立about页面呢？