[
https://issues.apache.org/jira/browse/FLINK-18496?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17165660#comment-17165660
]
Zhilong Hong commented on FLINK-18496:
--------------------------------------
I think the issue is related to the posts.
1. In flink/docs there is no `_posts` folder, so I copy the `_posts` folder
from flink-web to flink/docs. The same issue appears in flink/docs. It fails to
build the doc, too.
2. If I move the posts from `_post` folder to other folders in flink-web, the
build succeeds.
3. If I remove the plugin "jekyll-multiple-language" in `_config.yml` and
compile the English/Chinese version separately, the build succeeds.
Since the plugin "jekyll-multiple-language" is no longer maintained since 2015,
and the last version it supports is jekyll 3, I think the plugin is
incompatible with posts in the `_post` folder. In addition, there are similar
issues in the repo of the plugin:
https://github.com/liaohuqiu/jekyll-multiple-languages/issues/19 .
Also when I remove the files in `_post` folder, the build succeeds. And the
anchors are generated correctly. So I think the upgrading the version of jekyll
can solve the anchor issue, but we need to replace "jekyll-multiple-language"
with alternatives like
https://github.com/kurtsson/jekyll-multiple-languages-plugin. The main
challenge is: their usage are different, which may introduce a lot of changes
and new issues.
> Anchors are not generated based on ZH characters
> ------------------------------------------------
>
> Key: FLINK-18496
> URL: https://issues.apache.org/jira/browse/FLINK-18496
> Project: Flink
> Issue Type: Bug
> Components: Project Website
> Reporter: Zhu Zhu
> Assignee: Zhilong Hong
> Priority: Major
> Labels: starter
>
> In ZH version pages of flink-web, the anchors are not generated based on ZH
> characters. The anchor name would be like 'section-1', 'section-2' if there
> is no EN characters. An example can be the links in the navigator of
> https://flink.apache.org/zh/contributing/contribute-code.html
> This makes it impossible to ref an anchor from the content because the anchor
> name might change unexpectedly if a new section is added.
> Note that it is a problem for flink-web only. The docs generated from the
> flink repo can properly generate ZH anchors.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
