[
https://issues.apache.org/jira/browse/HIVE-28685?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Stamatis Zampetakis updated HIVE-28685:
---------------------------------------
Description:
Many relative links in the [website
documentation|https://hive.apache.org/docs/latest] are broken when they point
to section headers that contain special characters.
An example of this can be seen in the [DDL manual
page|https://hive.apache.org/docs/latest/languagemanual-ddl_27362034/] ([source
code|https://github.com/apache/hive-site/blob/3aead0eeb58207a2c4400c68d5dfa45b54cf8b89/content/docs/latest/languagemanual-ddl_27362034.md]).
The following link definition points to a section header that contains slash
(special) characters.
{noformat}
[Create/Drop/Alter View]({{< ref "#create/drop/alter-view" >}})
{noformat}
Every markdown processor uses different conventions to extract implicit URLs
from headers and in most cases special characters such as slash, comma, period,
parenthesis, etc., are removed so the above reference does not work.
was:
Many relative links in the [website
documentation|https://hive.apache.org/docs/latest] are broken when they point
to section headers that contain special characters.
An example of this can be seen in the [DDL manual page|
https://hive.apache.org/docs/latest/languagemanual-ddl_27362034/]([source
code|https://github.com/apache/hive-site/blob/3aead0eeb58207a2c4400c68d5dfa45b54cf8b89/content/docs/latest/languagemanual-ddl_27362034.md]).
The following link definition points to a section header that contains slash
(special) characters.
{noformat}
[Create/Drop/Alter View]({{< ref "#create/drop/alter-view" >}})
{noformat}
Every markdown processor uses different conventions to extract implicit URLs
from headers and in most cases special characters such as slash, comma, period,
parenthesis, etc., are removed so the above reference does not work.
> Broken links in website docs when headings contain special characters
> ---------------------------------------------------------------------
>
> Key: HIVE-28685
> URL: https://issues.apache.org/jira/browse/HIVE-28685
> Project: Hive
> Issue Type: Bug
> Components: Website
> Reporter: Stamatis Zampetakis
> Assignee: Stamatis Zampetakis
> Priority: Major
>
> Many relative links in the [website
> documentation|https://hive.apache.org/docs/latest] are broken when they point
> to section headers that contain special characters.
> An example of this can be seen in the [DDL manual
> page|https://hive.apache.org/docs/latest/languagemanual-ddl_27362034/]
> ([source
> code|https://github.com/apache/hive-site/blob/3aead0eeb58207a2c4400c68d5dfa45b54cf8b89/content/docs/latest/languagemanual-ddl_27362034.md]).
> The following link definition points to a section header that contains slash
> (special) characters.
> {noformat}
> [Create/Drop/Alter View]({{< ref "#create/drop/alter-view" >}})
> {noformat}
> Every markdown processor uses different conventions to extract implicit URLs
> from headers and in most cases special characters such as slash, comma,
> period, parenthesis, etc., are removed so the above reference does not work.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
