fix overflow of mathjax equations; merge hexo-related posts
This commit is contained in:
@@ -4,6 +4,8 @@ tags:
|
||||
- 博客
|
||||
- Hexo
|
||||
- Next
|
||||
- 不蒜子
|
||||
- Tag Cloud
|
||||
categories:
|
||||
- - Blog
|
||||
- Hexo
|
||||
@@ -12,19 +14,112 @@ abbrlink: b158f1b4
|
||||
date: 2020-11-28 01:27:30
|
||||
---
|
||||
|
||||
# 主题安装
|
||||
|
||||
# 瞎折腾/~~美化~~侧边栏
|
||||
NexT 官方提供了两种安装主题的方式，一种是使用将主题作为 node.js 的 Package，直接使用 `npm install` 命令进行安装，另一种是将主题 `git clone` 到 `<path-to-blog>/theme.next` 目录下。
|
||||
|
||||
在博客根目录下的 `source/_data` 文件夹中新建 `sidebar.swig` 文件。
|
||||
这里更推荐将 NexT 主题作为 node.js 的 Package 进行安装，可以让整个博客文件夹更加紧凑，也方便使用 `npm` 管理版本。安装最新 Release 版 NexT 主题的命令如下：
|
||||
|
||||
``` bash
|
||||
npm install hexo-theme-next@latest
|
||||
```
|
||||
|
||||
安装完成后在 Hexo 的配置中将主题切换为 `next` 即可，即
|
||||
|
||||
``` diff _config.yml
|
||||
- theme: landscape
|
||||
+ theme: next
|
||||
```
|
||||
|
||||
<!-- more -->
|
||||
|
||||
# 环境依赖
|
||||
|
||||
> 更新于 2023 年 4 月 15 日
|
||||
|
||||
| Package 名称 | 版本 |
|
||||
| :--------------------------: | :------: |
|
||||
| `hexo` | `6.3.0` |
|
||||
| `hexo-abbrlink` | `2.2.1` |
|
||||
| `hexo-deployer-git` | `4.0.0` |
|
||||
| `hexo-filter-github-emojis` | `3.0.5` |
|
||||
| `hexo-generator-archive` | `2.0.0` |
|
||||
| `hexo-generator-category` | `2.0.0` |
|
||||
| `hexo-generator-index` | `3.0.0` |
|
||||
| `hexo-generator-searchdb` | `1.4.1` |
|
||||
| `hexo-generator-sitemap` | `3.0.1` |
|
||||
| `hexo-generator-tag` | `2.0.0` |
|
||||
| `hexo-helper-live2d` | `3.1.1` |
|
||||
| `hexo-neat` | `1.0.9` |
|
||||
| `hexo-related-popular-posts` | `5.0.1` |
|
||||
| `hexo-related-posts` | `1.5.1` |
|
||||
| `hexo-renderer-ejs` | `2.0.0` |
|
||||
| `hexo-renderer-pandoc` | `0.3.1` |
|
||||
| `hexo-renderer-stylus` | `2.1.0` |
|
||||
| `hexo-server` | `3.0.0` |
|
||||
| `hexo-tag-cloud` | `2.1.*` |
|
||||
| `hexo-theme-landscape` | `0.0.3` |
|
||||
| `hexo-theme-next` | `8.15.1` |
|
||||
| `hexo-word-counter` | `0.1.0` |
|
||||
|
||||
# 侧边栏
|
||||
|
||||
## 新建侧边栏配置文件
|
||||
|
||||
> 由于 NexT 8.0.0 版本后将 `.swig` 模板换成了 `.njk` 模板，因此不同版本需要额外区分。
|
||||
|
||||
{% tabs New Sidebar Config %}
|
||||
<!-- tab NexT 8.0.0 版本及以上-->
|
||||
在博客根目录下的 `source/_data` 文件夹中新建 `sidebar.njk` 文件，并在 NexT 主题配置中启用文件。
|
||||
|
||||
``` diff _config.next.yml
|
||||
custom_file_path:
|
||||
- #sidebar: source/_data/sidebar.njk
|
||||
+ sidebar: source/_data/sidebar.njk
|
||||
```
|
||||
<!-- endtab -->
|
||||
|
||||
<!-- tab NexT 8.0.0 版本以下-->
|
||||
在博客根目录下的 `source/_data` 文件夹中新建 `sidebar.swig` 文件，并在 NexT 主题配置中启用文件。
|
||||
|
||||
``` diff _config.next.yml
|
||||
custom_file_path:
|
||||
- #sidebar: source/_data/sidebar.swig
|
||||
+ sidebar: source/_data/sidebar.swig
|
||||
```
|
||||
<!-- endtab -->
|
||||
|
||||
{% endtabs %}
|
||||
|
||||
## 添加 Tag Cloud
|
||||
|
||||
安装 `hexo-tag-cloud` 插件。
|
||||
首先安装 [`hexo-tag-cloud`](https://github.com/D0n9X1n/hexo-tag-cloud) 插件。
|
||||
|
||||
``` shell
|
||||
npm install hexo-tag-cloud --save
|
||||
```
|
||||
|
||||
{% tabs Sidebar tag cloud %}
|
||||
<!-- tab NexT 8.0.0 版本及以上-->
|
||||
添加相关代码写入 `sidebar.njk`。不喜欢标题的把 `<h3 class="widget-title">Tag Cloud</h3>` 去掉即可。
|
||||
|
||||
``` html source/_data/sidebar.njk
|
||||
{% if site.tags.length > 1 %}
|
||||
<script type="text/javascript" charset="utf-8" src="/js/tagcloud.js"></script>
|
||||
<script type="text/javascript" charset="utf-8" src="/js/tagcanvas.js"></script>
|
||||
<div class="widget-wrap">
|
||||
<h3 class="widget-title">Tag Cloud</h3>
|
||||
<div id="myCanvasContainer" class="widget tagcloud" style="font-size:20px;">
|
||||
<canvas width="220" height="200" id="resCanvas" style="width=100%">
|
||||
{{ list_tags() }}
|
||||
</canvas>
|
||||
</div>
|
||||
</div>
|
||||
{% endif %}
|
||||
```
|
||||
<!-- endtab -->
|
||||
|
||||
<!-- tab NexT 8.0.0 版本以下-->
|
||||
添加相关代码写入 `sidebar.swig`。不喜欢标题的把 `<h3 class="widget-title">Tag Cloud</h3>` 去掉即可。
|
||||
|
||||
``` html source/_data/sidebar.swig
|
||||
@@ -41,26 +136,22 @@ npm install hexo-tag-cloud --save
|
||||
</div>
|
||||
{% endif %}
|
||||
```
|
||||
<!-- endtab -->
|
||||
|
||||
<!-- more -->
|
||||
{% endtabs %}
|
||||
|
||||
# 瞎折腾/~~美化~~页面
|
||||
# 页面
|
||||
|
||||
在博客根目录下的 `source/_data` 文件夹中新建 `variables.styl` 文件。
|
||||
|
||||
``` shell
|
||||
cd hexo
|
||||
vi source/_data/variables.styl
|
||||
```
|
||||
|
||||
## 页面圆角
|
||||
|
||||
在 `variables.styl` 文件里添加圆角半径值
|
||||
|
||||
``` stylus source/_data/variables.styl
|
||||
// 圆角设置
|
||||
$border-radius-inner = 0px; // 内部圆角半径
|
||||
$border-radius = 8px; // 外部圆角半径
|
||||
$border-radius-inner = 10px;
|
||||
$border-radius = 10px;
|
||||
```
|
||||
|
||||
# 需要修改源代码的操作
|
||||
@@ -91,7 +182,158 @@ initSidebarDimension: function() {
|
||||
},
|
||||
```
|
||||
|
||||
- 参考文档：[Hexo Next 博客自定义配置 -> 更改-sidebar-大小](https://yi-yun.github.io/Hexo-Next-Custom/#更改-sidebar-大小https://yi-yun.github.io/Hexo-Next-Custom/#更改-sidebar-大小)
|
||||
- 参考文档：[Hexo Next 博客自定义配置 -> 更改-sidebar-大小](https://yi-yun.github.io/Hexo-Next-Custom/#更改-sidebar-大小)
|
||||
|
||||
# 数学公式
|
||||
|
||||
## MathJax 渲染带编号公式导致行溢出的问题
|
||||
|
||||
在移植博客的时候发现，带编号的长公式（如 `equation` 和 `align` 环境）在窄屏幕上（如手机）显示时会出现行溢出的问题，通过 Google Chrome 检查了一番发现，`mjx-container` 在渲染后会多出 `min-width` 属性，且每个公式的 `min-width` 不同，导致 `overflow` 无法触发，因为 `min-width` 和公式宽度是相等的，不会存在 Overflow 的情况。
|
||||
|
||||
``` css
|
||||
element.style {
|
||||
font-size: 121.3%;
|
||||
min-width: 35.348em;
|
||||
position: relative;
|
||||
}
|
||||
```
|
||||
|
||||
MathJax 的 [Github Issue](https://github.com/mathjax/MathJax/issues/2280) 中也出现了类似讨论，官方将这种行为解释为“为了避免公式和编号重叠”而做出的选择。然而实际操作中发现，在 Google Chrome 检查页面中，将 `min-width` 手动修改为 `0` 后，可以正常触发 Overflow，并生成水平方向的 Scroll Bar，且公式和编号没有重叠。
|
||||
|
||||
因此突发奇想，能不能指定 `!important` 属性，将生成的 `min-width` 强行覆盖掉呢？于是做了如下尝试：
|
||||
|
||||
``` stylus source/_data/styles.styl
|
||||
mjx-container.MathJax.CtxtMenu_Attached_0 {
|
||||
min-width: auto !important;
|
||||
}
|
||||
```
|
||||
|
||||
然后带编号的公式就可以正常显示 Scroll Bar 了！
|
||||
|
||||
# 不蒜子
|
||||
|
||||
## 什么是不蒜子
|
||||
|
||||
[不蒜子](https://busuanzi.ibruce.info/)是 [Bruce](http://ibruce.info/) 开发的一款轻量级的网页计数器，可以将网站访问计数直接显示在网页上。
|
||||
|
||||
## 启用不蒜子
|
||||
|
||||
NexT 预置了不蒜子提供的网页计数功能。只需要在配置文件中启用即可。
|
||||
|
||||
``` yaml next/_config.yml
|
||||
# Show Views / Visitors of the website / page with busuanzi.
|
||||
# Get more information on http://ibruce.info/2015/04/04/busuanzi
|
||||
busuanzi_count:
|
||||
enable: true # 启用不蒜子
|
||||
total_visitors: true # 网站总访客数
|
||||
total_visitors_icon: fa fa-user
|
||||
total_views: true # 网站总浏览数
|
||||
total_views_icon: fa fa-eye
|
||||
post_views: true # 文章浏览数
|
||||
post_views_icon: fa fa-eye
|
||||
```
|
||||
|
||||
## 不蒜子和 Live2D 冲突的问题 （2020-11-27）
|
||||
|
||||
> Hexo 版本：5.2.0
|
||||
>
|
||||
> NexT 版本：8.0.2
|
||||
>
|
||||
> 不蒜子版本: 2.3
|
||||
|
||||
### 问题描述
|
||||
|
||||
添加 Live2D 前的不蒜子显示情况如下。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
添加 Live2D 后，不蒜子在页面中不显示。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 问题原因
|
||||
|
||||
经查，添加 Live2D 后网页的不蒜子部分源码的 `style` 从 `"display: inline;"` 替换为了 `"display: none;"`。
|
||||
|
||||
``` html 不蒜子不正常显示的网页源码
|
||||
<span class="post-meta-item" title="阅读次数" id="busuanzi_container_page_pv" style="display: none;">
|
||||
<span class="post-meta-item-icon">
|
||||
<i class="fa fa-eye"></i>
|
||||
</span>
|
||||
<span class="post-meta-item-text"> 阅读次数：</span>
|
||||
<span id="busuanzi_value_page_pv">19</span>
|
||||
</span>
|
||||
```
|
||||
|
||||
``` html 不蒜子正常显示的网页源码
|
||||
<span class="post-meta-item" title="阅读次数" id="busuanzi_container_page_pv" style="display: inline;">
|
||||
<span class="post-meta-item-icon">
|
||||
<i class="fa fa-eye"></i>
|
||||
</span>
|
||||
<span class="post-meta-item-text"> 阅读次数：</span>
|
||||
<span id="busuanzi_value_page_pv">18</span>
|
||||
</span>
|
||||
```
|
||||
|
||||
### 解决方法
|
||||
|
||||
在网页生成引擎中修改代码，去掉不蒜子部分的 `id` 和 `style` 属性，重新生成网页即可解决该问题。若将 `class` 属性一并删除，会导不蒜子部分和前面的其他显示部分缺少分隔符，如下图。
|
||||
|
||||
|
||||
|
||||
具体需要修改两个文件，`next/layout/_third-party/statistics/busuanzi-counter.swig` 中修改的是网页页脚部分的不蒜子显示，`next/layout/_macro/post.swig` 中修改的博客文章阅览数的不蒜子显示。
|
||||
|
||||
``` html next/layout/_third-party/statistics/busuanzi-counter.swig
|
||||
{%- if theme.busuanzi_count.total_visitors %}
|
||||
<span class="post-meta-item" id="busuanzi_container_site_uv" style="display: inline;">
|
||||
<!-- ... -->
|
||||
</span>
|
||||
{%- endif %}
|
||||
|
||||
<!-- ... -->
|
||||
|
||||
{%- if theme.busuanzi_count.total_views %}
|
||||
<span class="post-meta-item" id="busuanzi_container_site_pv" style="display: inline;">
|
||||
<!-- ... -->
|
||||
</span>
|
||||
{%- endif %}
|
||||
```
|
||||
|
||||
``` html next/layout/_macro/post.swig
|
||||
{%- if not is_index and theme.busuanzi_count.enable and theme.busuanzi_count.post_views %}
|
||||
<span class="post-meta-item" title="{{ __('post.views') }}" id="busuanzi_container_page_pv" style="display: inline;">
|
||||
<!-- ... -->
|
||||
</span>
|
||||
{%- endif %}
|
||||
```
|
||||
|
||||
## 不蒜子和 Live2D 冲突的问题 （2023-04-08）
|
||||
|
||||
> Hexo 版本：6.3.0
|
||||
>
|
||||
> NexT 版本：8.15.1
|
||||
>
|
||||
> 不蒜子版本: 2.3
|
||||
|
||||
重新捣鼓博客的时候发现不蒜子又不显示了，依然已经不维护的 `hexo-helper-live2d` 插件导致的。2020 年的方法写的模棱两可，NexT 的一些网页架构也有了细微改变，因此将新的解决方法附于下方。很多方法是通过直接修改 NexT 主题下的源文件实现的，但是 NexT 并不推荐这样的写法，因为主题目录下的文件是会随着主题更新而被覆盖的，而且不便于使用 Git 管理。经过寻找，在 NexT 的 Github Issues 中找到了优雅的解决方法。
|
||||
|
||||
在 `source/_data/styles.styl` 中添加如下代码即可解决。
|
||||
|
||||
``` styl source/_data/styles.styl
|
||||
#busuanzi_container_site_uv, #busuanzi_container_site_pv, #busuanzi_container_page_pv {
|
||||
display: inline !important;
|
||||
}
|
||||
```
|
||||
|
||||
> REF:
|
||||
>
|
||||
> 1. 上述解决方法来源：[【必读】更新说明及常见问题](https://github.com/next-theme/hexo-theme-next/issues/4#issuecomment-690864794)
|
||||
>
|
||||
> 2. 这篇文章分析了 `hexo-helper-live2d` 插件导致不蒜子不显示的根本原因：[busuanzi 访问量统计与 live2d 插件同时使用导致 busuanzi 不显示的根本原因以及解决方法](https://ouuan.moe/post/2022/08/busuanzi-and-live2d)
|
||||
|
||||
# 重装系统后配置 Hexo-Next
|
||||
|
||||
|
||||
Reference in New Issue
Block a user