[
https://issues.apache.org/jira/browse/HIVE-28685?focusedWorklogId=950558&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-950558
]
ASF GitHub Bot logged work on HIVE-28685:
-----------------------------------------
Author: ASF GitHub Bot
Created on: 31/Dec/24 12:54
Start Date: 31/Dec/24 12:54
Worklog Time Spent: 10m
Work Description: zabetak opened a new pull request, #25:
URL: https://github.com/apache/hive-site/pull/25
Normalize all links that point to section headers using the following rules:
1. Turn all characters to lowercase
2. Remove all special characters
3. Replace spaces with dashes
Special characters are those that do not fall into one of the following
categories:
1. latin alphabet letters
2. digits
3. underscore, dash, and space characters
The normalization was performed using the following Java class:
https://github.com/zabetak/utils/blob/46aa1a5329b6421a22ca3e3e07aa35f8f7854390/src/main/java/com/github/zabetak/utils/MarkdownHeaderAnchorNormalizer.java
Issue Time Tracking
-------------------
Worklog Id: (was: 950558)
Remaining Estimate: 0h
Time Spent: 10m
> 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
> Time Spent: 10m
> Remaining Estimate: 0h
>
> 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)
