转载

Hexo 与 Nginx 实现沉浸式多语言博客

假期的时候，打算改造下现有的博客系统。目标之一是实现多语言（主要是中英）切换，要求： 沉浸式阅读 。

查找了一下，Hexo 有如下几种工具与国际化有关：

Hexo 官方的国际化机制
Hexo 官方推荐的插件： hexo-generator-i18n
非官方推荐的插件： hexo-multilingual

逐一尝试

官方国际化机制：failed

更多是在解决模板翻译问题

hexo-generator-i18n 插件：failed

可以通过指定如下参数，对响应的模块，产生多语言文件夹。

i18n:
  type: [page, post]
  generator: [index, archive, category, tag]

最大的问题，是会在 tag 和 archive 等文件夹中，将多个语言的博客文章混在一起，达不到沉浸式阅读的要求。

hexo-multilingual：failed

通过将：

"hexo-generator-archive": "^0.1.4",
"hexo-generator-category": "^0.1.3",
"hexo-generator-index": "^0.2.0",

替换成：

"hexo-generator-multilingual-archive": "^0.2.0",
"hexo-generator-multilingual-category": "^0.3.2",
"hexo-generator-multilingual-index": "^0.3.1",

在生成的页面中，添加当前语言的信息，并通过在 source 文件夹下添加 _data 文件夹，并添加覆盖下面文件：

├── source
│   ├── _data
│   │   ├── config_cn.yml
│   │   ├── config_en.yml
│   │   ├── theme_cn.yml
│   │   └── theme_en.yml
│   ├── _posts
│   │   ├── cn
│   │   └── en

其中 config_xx.yml 中的配置，可以覆盖根目录下 _config 文件的配置，

theme_xx.yml 可以覆盖主题 themes/xxx/_config 文件的配置。

以此方式实现配置的覆盖和区分。

解决了一部分沉浸式阅读的问题，进行较为整齐的分割，但是有个重要的 Bug，运行

hexo serve

能够很好的进行语言之间的隔离，但是运行

hexo g

导出的 public 文件夹里面的文件，有如下问题：

会有一些链接没有添加 lang 信息，导致死链
配置覆盖也失效。
hexo 的其他插件，都是基于单语言前提的，这意味着， 需要同步改造所有的插件，才可以达到完美的效果 。

个人不打算花费很多的在这个事情上面。

Nginx 实现代理：bingo

我的博客是使用 Hexo 生成了静态文件，使用 Nginx 进行代理的。回想起，Nginx 在 vhost 配置中实现根据 location 规则使用不同的 alias 。

总体思路是：

建立两个独立的博客，分别处理中文和英文，以达到真正的隔离处理和沉浸式阅读
使用 Nginx 来实现转向和定位

最后方案如下。

建立两个博客目录

├── kvh.io.cn
├── kvh.io.en

分别配置中文和英文的博客，这样所有的插件都可以用了，注意 _config 文件的配置分别为：

language: 
- cn
root: /cn

和

language: 
- en
root: /en

然后你就可以愉快的写博客了。

Nginx 配置

server {

        root /home/changbinhe/kvh.io.cn/public;

        location /cn {
                alias /www/kvh.io.cn/public;
        }

        location /en {
                alias /www/kvh.io.en/public;
        }

  error_page 404 = @missing;

        location @missing {
                rewrite .* / permanent;
        }
}