Stamatis Zampetakis created HIVE-28685:
------------------------------------------

             Summary: 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


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)

Reply via email to