[
https://issues.apache.org/jira/browse/ZOOKEEPER-4356?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Nihal Jain updated ZOOKEEPER-4356:
----------------------------------
Description:
The code snippets defined inside a {{fenced code blocks}} renders correctly in
Markdown; but the same code snippet does not render properly in HTML sites.
This makes the docs site very ugly and difficult to comprehend. (One has to
figure out where the code block starts and where it ends.)
The issue exists throughout the docs site.
For example see one of the sample pages:
https://github.com/apache/zookeeper/blob/master/zookeeper-docs/src/main/resources/markdown/zookeeperCLI.md
!markdown_rendering.png!
vs
http://zookeeper.apache.org/doc/current/zookeeperCLI.html
!html_rendering_before_fix.png!
was:
The code snippets defined inside a `fenced code blocks` renders correctly in
Markdown; but the same code snippet does not render properly in HTML sites.
This makes the docs site very ugly and difficult to comprehend. (One has to
figure out where the code block starts and where it ends.)
The issue exists throughout the docs site.
For example see one of the sample pages:
https://github.com/apache/zookeeper/blob/master/zookeeper-docs/src/main/resources/markdown/zookeeperCLI.md
!markdown_rendering.png!
vs
http://zookeeper.apache.org/doc/current/zookeeperCLI.html
!html_rendering_before_fix.png!
> Code blocks do not render correctly in ZK docs site
> ---------------------------------------------------
>
> Key: ZOOKEEPER-4356
> URL: https://issues.apache.org/jira/browse/ZOOKEEPER-4356
> Project: ZooKeeper
> Issue Type: Bug
> Components: documentation
> Affects Versions: 3.7.0
> Reporter: Nihal Jain
> Priority: Major
> Labels: pull-request-available
> Attachments: html_rendering_after_fix.png,
> html_rendering_before_fix.png, markdown_rendering.png
>
> Time Spent: 10m
> Remaining Estimate: 0h
>
> The code snippets defined inside a {{fenced code blocks}} renders correctly
> in Markdown; but the same code snippet does not render properly in HTML
> sites. This makes the docs site very ugly and difficult to comprehend. (One
> has to figure out where the code block starts and where it ends.)
> The issue exists throughout the docs site.
> For example see one of the sample pages:
>
> https://github.com/apache/zookeeper/blob/master/zookeeper-docs/src/main/resources/markdown/zookeeperCLI.md
>
> !markdown_rendering.png!
> vs
> http://zookeeper.apache.org/doc/current/zookeeperCLI.html
> !html_rendering_before_fix.png!
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
