[Maria-docs] TOC link doesn't work if a heading doesn't include ASCII alphanumerics
Hello, A link in a table of contents generated by <<toc>> macro doesn't work if its corresponding heading doesn't include ASCII alphanumerics. The reason is that characters that can not be converted into ASCII alphanumerics are treated as spaces in headings. If a heading only includes the characters, its "id" attribute is an empty string. For example, this page: https://mariadb.com/kb/zh-cn/getting-started-with-indexes/ As of now, a editor need to append an extra <<style>> macro to avoid the dead link. For example: "== 第一章 <<style style="content: 'Heading One';">> <</style>>" (https://mariadb.com/kb/ja/toc/) I think a possible solution would be to treat some non-ASCII characters as ASCII alphanumerics. For example, "== 第一章" would be converted to "<h2 id="第一章">第一章</h2>". The character probably can be expressed by this regular expression: /[\p{Cyrillic}\p{Han}\p{Hangul}\p{Hiragana}\p{Katakana}]/ Thanks, -- 100の人
On Thu, Jul 16, 2015 at 2:39 AM, 100の人 <100@pokemori.jp> wrote:
A link in a table of contents generated by <<toc>> macro doesn't work if its corresponding heading doesn't include ASCII alphanumerics. The reason is that characters that can not be converted into ASCII alphanumerics are treated as spaces in headings. If a heading only includes the characters, its "id" attribute is an empty string. For example, this page: https://mariadb.com/kb/zh-cn/getting-started-with-indexes/
As of now, a editor need to append an extra <<style>> macro to avoid the dead link. For example: "== 第一章 <<style style="content: 'Heading One';">> <</style>>" (https://mariadb.com/kb/ja/toc/)
I think a possible solution would be to treat some non-ASCII characters as ASCII alphanumerics. For example, "== 第一章" would be converted to "<h2 id="第一章">第一章</h2>". The character probably can be expressed by this regular expression: /[\p{Cyrillic}\p{Han}\p{Hangul}\p{Hiragana}\p{Katakana}]/
I'll forward this on to the web team. Hopefully they'll be able to get it fixed soon. Thanks for reporting it! -- Daniel Bartholomew, MariaDB Release Manager MariaDB | http://mariadb.com
Thanks for this report, I've fixed it in git but it will not go live until
Monday.
On Thu, Jul 16, 2015 at 9:21 AM, Daniel Bartholomew
On Thu, Jul 16, 2015 at 2:39 AM, 100の人 <100@pokemori.jp> wrote:
A link in a table of contents generated by <<toc>> macro doesn't work if its corresponding heading doesn't include ASCII alphanumerics. The reason is that characters that can not be converted into ASCII alphanumerics are treated as spaces in headings. If a heading only includes the characters, its "id" attribute is an empty string. For example, this page: https://mariadb.com/kb/zh-cn/getting-started-with-indexes/
As of now, a editor need to append an extra <<style>> macro to avoid the dead link. For example: "== 第一章 <<style style="content: 'Heading One';">> <</style>>" (https://mariadb.com/kb/ja/toc/)
I think a possible solution would be to treat some non-ASCII characters as ASCII alphanumerics. For example, "== 第一章" would be converted to "<h2 id="第一章">第一章</h2>". The character probably can be expressed by this regular expression: /[\p{Cyrillic}\p{Han}\p{Hangul}\p{Hiragana}\p{Katakana}]/
I'll forward this on to the web team. Hopefully they'll be able to get it fixed soon. Thanks for reporting it!
-- Daniel Bartholomew, MariaDB Release Manager MariaDB | http://mariadb.com
_______________________________________________ Mailing list: https://launchpad.net/~maria-docs Post to : maria-docs@lists.launchpad.net Unsubscribe : https://launchpad.net/~maria-docs More help : https://help.launchpad.net/ListHelp
-- Bryan Alsdorf MariaDB Corporation | http://mariadb.com
FYI this is now live. Please let me know if you have any additional issues.
On Thu, Jul 16, 2015 at 9:30 PM, Bryan Alsdorf
Thanks for this report, I've fixed it in git but it will not go live until Monday.
On Thu, Jul 16, 2015 at 9:21 AM, Daniel Bartholomew
wrote: On Thu, Jul 16, 2015 at 2:39 AM, 100の人 <100@pokemori.jp> wrote:
A link in a table of contents generated by <<toc>> macro doesn't work if its corresponding heading doesn't include ASCII alphanumerics. The reason is that characters that can not be converted into ASCII alphanumerics are treated as spaces in headings. If a heading only includes the characters, its "id" attribute is an empty string. For example, this page: https://mariadb.com/kb/zh-cn/getting-started-with-indexes/
As of now, a editor need to append an extra <<style>> macro to avoid the dead link. For example: "== 第一章 <<style style="content: 'Heading One';">> <</style>>" (https://mariadb.com/kb/ja/toc/)
I think a possible solution would be to treat some non-ASCII characters as ASCII alphanumerics. For example, "== 第一章" would be converted to "<h2 id="第一章">第一章</h2>". The character probably can be expressed by this regular expression: /[\p{Cyrillic}\p{Han}\p{Hangul}\p{Hiragana}\p{Katakana}]/
I'll forward this on to the web team. Hopefully they'll be able to get it fixed soon. Thanks for reporting it!
-- Daniel Bartholomew, MariaDB Release Manager MariaDB | http://mariadb.com
_______________________________________________ Mailing list: https://launchpad.net/~maria-docs Post to : maria-docs@lists.launchpad.net Unsubscribe : https://launchpad.net/~maria-docs More help : https://help.launchpad.net/ListHelp
-- Bryan Alsdorf MariaDB Corporation | http://mariadb.com
-- Bryan Alsdorf MariaDB Corporation | http://mariadb.com
participants (3)
-
100の人
-
Bryan Alsdorf
-
Daniel Bartholomew