[
https://issues.apache.org/jira/browse/HIVE-28685?focusedWorklogId=950821&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-950821
]
ASF GitHub Bot logged work on HIVE-28685:
-----------------------------------------
Author: ASF GitHub Bot
Created on: 03/Jan/25 15:21
Start Date: 03/Jan/25 15:21
Worklog Time Spent: 10m
Work Description: zabetak commented on PR #25:
URL: https://github.com/apache/hive-site/pull/25#issuecomment-2569391023
Thanks for volunteering! @Aggarwal-Raghav
The current PR has a specific purpose to fix the broken links that point to
headers with special chars. It is not possible to fix everything and things
like `[hive]({{< ref "#hive" >}})` are out-of-scope of this patch. If you find
issues that should/could be covered via the current PR please let me know here
and I will try to address those.
For any other issues, please raise separate JIRA ticket(s) and feel free to
create PRs for tackling those.
Issue Time Tracking
-------------------
Worklog Id: (was: 950821)
Time Spent: 0.5h (was: 20m)
> 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: 0.5h
> 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)
