You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@hive.apache.org by "Stamatis Zampetakis (Jira)" <ji...@apache.org> on 2024/12/30 21:12:00 UTC

[jira] [Updated] (HIVE-28685) Broken links in website docs when headings contain special characters

     [ 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)