[
https://issues.apache.org/jira/browse/HIVE-28685?focusedWorklogId=950813&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-950813
]
ASF GitHub Bot logged work on HIVE-28685:
-----------------------------------------
Author: ASF GitHub Bot
Created on: 03/Jan/25 14:13
Start Date: 03/Jan/25 14:13
Worklog Time Spent: 10m
Work Description: Aggarwal-Raghav commented on PR #25:
URL: https://github.com/apache/hive-site/pull/25#issuecomment-2569279566
@zabetak , there are still few places which has broken links. For example:
https://github.com/apache/hive-site/blob/3aead0eeb58207a2c4400c68d5dfa45b54cf8b89/content/docs/latest/adminmanual-configuration_27362070.md?plain=1#L29
<img width="1265" alt="Screenshot 2025-01-03 at 7 38 22 PM"
src="https://github.com/user-attachments/assets/c943e646-85c0-468a-b373-6ea8eb7a6c8d";
/>
and also some commands have backslash before underscore, in many places:
<img width="528" alt="Screenshot 2025-01-03 at 7 42 57 PM"
src="https://github.com/user-attachments/assets/e8459d7c-fe47-45ad-b3a7-aa705575ef26";
/>
**I would like to help here, if someone has not picked it up?**
Issue Time Tracking
-------------------
Worklog Id: (was: 950813)
Time Spent: 20m (was: 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
> Labels: pull-request-available
> Attachments: MarkdownHeaderAnchorNormalizer.java
>
> Time Spent: 20m
> 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)
