# Failed to translate the content of 'parsed-literal' directive with hyperlinks in cmake.1.rst

**URL:** https://discourse.cmake.org/t/failed-to-translate-the-content-of-parsed-literal-directive-with-hyperlinks-in-cmake-1-rst/10541
**Category:** Development
**Created:** [March 31, 2024, 12:30pm UTC](https://discourse.cmake.org/t/failed-to-translate-the-content-of-parsed-literal-directive-with-hyperlinks-in-cmake-1-rst/10541 "2024-03-31T12:30:48Z")
**Posts on this page:** 2
**Page:** 1

<div class="post-metadata">

### Author: ![hwhsu1231](https://discourse.cmake.org/user_avatar/discourse.cmake.org/hwhsu1231/32/5358_2.png) [@hwhsu1231](https://discourse.cmake.org/u/hwhsu1231)
#### Post date: [March 31, 2024, 12:30pm UTC](https://discourse.cmake.org/t/failed-to-translate-the-content-of-parsed-literal-directive-with-hyperlinks-in-cmake-1-rst/10541/1 "2024-03-31T12:30:48Z")

</div>

Hello, CMake Team.

Recently, I posted a question on Stack Overflow, asking about how to translate the content of ‘parsed-literal’ directive of Sphinx if there exist hyperlinks (against thst [part](https://github.com/Kitware/CMake/blob/v3.28.4/Help/manual/cmake.1.rst?plain=1#L9-L37) in cmake.1.rst):

> <https://stackoverflow.com/questions/78238754/how-to-translate-the-content-of-the-parsed-literal-directive-of-sphinx-if-ther>

However, after doing some other tests, I started to think whether it is some kind of bugs?

Because even if I don’t translate the hyperlink part of the ‘parsed-literal’ directive, the hyperlinks are still broken. Take the following screenshot for reference.

 ![Screenshot_20240328_170519](https://discourse.cmake.org/uploads/default/original/2X/5/51723edbb54a2044195661b2248663c6597a359d.png)

As we can see, I only translate this [line](https://github.com/Kitware/CMake/blob/b5602e7254c8ce4a6f732c017d784cd80559e5aa/Help/manual/cmake.1.rst?plain=1#L12):

```auto
cmake [<options>] -B <path-to-build> [-S <path-to-source>]

```

into:

```auto
cmake [<選項>] -B <path-to-build> [-S <path-to-source>]

```

But the hyperlinks are still broken. Is it possible a bug from [cmake.py](https://github.com/Kitware/CMake/blob/v3.28.4/Utilities/Sphinx/cmake.py)?

---

<div class="post-metadata">

### Author: ![hwhsu1231](https://discourse.cmake.org/user_avatar/discourse.cmake.org/hwhsu1231/32/5358_2.png) [@hwhsu1231](https://discourse.cmake.org/u/hwhsu1231)
#### Post date: [April 19, 2024, 4:20pm UTC](https://discourse.cmake.org/t/failed-to-translate-the-content-of-parsed-literal-directive-with-hyperlinks-in-cmake-1-rst/10541/2 "2024-04-19T16:20:23Z")

</div>

I created an issue in Sphinx:

- [Failed to translate the content of ‘parsed-literal’ directive with hyperlinks in cmake.1.rst · Issue #12278 · sphinx-doc/sphinx · GitHub](https://github.com/sphinx-doc/sphinx/issues/12278)

And there’s a duplicate issue to keep tracking it:

- [Translated parsed-literals are incorrectly rendered · Issue #12287 · sphinx-doc/sphinx · GitHub](https://github.com/sphinx-doc/sphinx/issues/12287)

It seems that this issue is actually a bug from Sphinx itself.
