[
https://issues.apache.org/jira/browse/FLINK-18496?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17165379#comment-17165379
]
Zhilong Hong commented on FLINK-18496:
--------------------------------------
I try to upgrade the version of Jekyll from 3.0.5 to 4.0.1. When I attempt to
build the website after upgrading, the bundler reports the errors like below:
{code:bash}
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-multiple-languages-2.0.3/lib/jekyll-multiple-languages/multilang.rb:55:in
`append_data_for_liquid'
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-multiple-languages-2.0.3/lib/jekyll-multiple-languages/document.rb:71:in
`to_liquid'
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-4.0.1/lib/jekyll/drops/document_drop.rb:40:in
`next'
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-4.0.1/lib/jekyll/drops/drop.rb:47:in
`public_send'
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-4.0.1/lib/jekyll/drops/drop.rb:47:in
`[]'
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-4.0.1/lib/jekyll/drops/drop.rb:168:in
`block in each'
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-4.0.1/lib/jekyll/drops/drop.rb:167:in
`each'
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-4.0.1/lib/jekyll/drops/drop.rb:167:in
`each'
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-4.0.1/lib/jekyll/drops/drop.rb:167:in
`each'
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-4.0.1/lib/jekyll/utils.rb:336:in
`duplicate_frozen_values'
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-4.0.1/lib/jekyll/utils.rb:44:in
`deep_merge_hashes!'
/srv/flink-web/.rubydeps/ruby/2.5.0/gems/jekyll-4.0.1/lib/jekyll/utils.rb:29:in
`deep_merge_hashes'
{code}
I think maybe some docs are incompatible with the plugin
jekyll-multiple-languages, because flink/docs uses jekyll 4.0.1 and
jekyll-multiple-language 2.0.3, and it goes well.
Also I attempt to build the Chinese version only, the anchors are generated
based on the characters correctly. So I think currently the major challenge is
how to fix the docs to make them compatible with new jekyll and the plugin
jekyll-multiple-languages.
I searched how to get the log of jekyll, and I got nothing on the internet. I
think this makes it harder to solve this issue.
> 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)
