Discussion:
[Docutils-develop] [docutils:feature-requests] #53 Replace substitutions in emphasized/bold text
Walter Doekes
2016-11-15 16:00:54 UTC
Permalink
---

** [feature-requests:#53] Replace substitutions in emphasized/bold text**

**Status:** open
**Group:** Default
**Created:** Tue Nov 15, 2016 04:00 PM UTC by Walter Doekes
**Last Updated:** Tue Nov 15, 2016 04:00 PM UTC
**Owner:** nobody


Previously filed here: https://github.com/sphinx-doc/sphinx/issues/3151

Using |RST| substitutions inside other formatting does not work -- as far as I can tell.

For example:

this is written in |RST|

works, while

*this is written in |RST|*

does not.

Authors of our documents expect to be able to use the emphasis tags around entire paragraphs, and when common substitutions inside it, fail, it creates confusion. Even more, since pandoc(1) *does* support it.

I haven't found an easy way to work around the lack of this feature.

Is this something you could consider implementing?

Cheers,
Walter Doekes


---

Sent from sourceforge.net because docutils-***@lists.sourceforge.net is subscribed to https://sourceforge.net/p/docutils/feature-requests/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list.
Günter Milde
2016-11-15 18:49:36 UTC
Permalink
Your observation is correct, substitutions (like any other inline markup) do not work inside other inline markup.

Inline markup cannot be nested.
-- http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#inline-markup

This is an unfortunate limitation and a long-standing TODO issue:
http://docutils.sourceforge.net/docs/dev/todo.html#nested-inline-markup
https://sourceforge.net/p/docutils/feature-requests/22/

A workaround for emphasizing complete paragraphs would be marking it with a suitable class argument and style with CSS::

.. class:: emphasized

This is an emphasizes paragraph with **working** inline markup.
Also |H2O| would be substituted.


---

** [feature-requests:#53] Replace substitutions in emphasized/bold text**

**Status:** open
**Group:** Default
**Created:** Tue Nov 15, 2016 04:00 PM UTC by Walter Doekes
**Last Updated:** Tue Nov 15, 2016 04:00 PM UTC
**Owner:** nobody


Previously filed here: https://github.com/sphinx-doc/sphinx/issues/3151

Using |RST| substitutions inside other formatting does not work -- as far as I can tell.

For example:

this is written in |RST|

works, while

*this is written in |RST|*

does not.

Authors of our documents expect to be able to use the emphasis tags around entire paragraphs, and when common substitutions inside it, fail, it creates confusion. Even more, since pandoc(1) *does* support it.

I haven't found an easy way to work around the lack of this feature.

Is this something you could consider implementing?

Cheers,
Walter Doekes


---

Sent from sourceforge.net because docutils-***@lists.sourceforge.net is subscribed to https://sourceforge.net/p/docutils/feature-requests/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list.
Walter Doekes
2016-11-16 14:31:04 UTC
Permalink
Thanks for the quick reply!

The `.. class:: emphasized` would work for html output (`rst-class` in the Sphinx case) but not for LaTeX output.

But this gives me some other ideas for workarounds. TY


---

** [feature-requests:#53] Replace substitutions in emphasized/bold text**

**Status:** open
**Group:** Default
**Created:** Tue Nov 15, 2016 04:00 PM UTC by Walter Doekes
**Last Updated:** Tue Nov 15, 2016 06:49 PM UTC
**Owner:** nobody


Previously filed here: https://github.com/sphinx-doc/sphinx/issues/3151

Using |RST| substitutions inside other formatting does not work -- as far as I can tell.

For example:

this is written in |RST|

works, while

*this is written in |RST|*

does not.

Authors of our documents expect to be able to use the emphasis tags around entire paragraphs, and when common substitutions inside it, fail, it creates confusion. Even more, since pandoc(1) *does* support it.

I haven't found an easy way to work around the lack of this feature.

Is this something you could consider implementing?

Cheers,
Walter Doekes


---

Sent from sourceforge.net because docutils-***@lists.sourceforge.net is subscribed to https://sourceforge.net/p/docutils/feature-requests/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list.
Günter Milde
2017-04-19 20:18:53 UTC
Permalink
With the right preamble code, this would also work with (Docutils) LaTeX export. The Sphinx' LaTeX writer is an early spin of missing many of the recent (and not so recent) improvements in the Docutils variant.


---

** [feature-requests:#53] Replace substitutions in emphasized/bold text**

**Status:** open
**Group:** Default
**Created:** Tue Nov 15, 2016 04:00 PM UTC by Walter Doekes
**Last Updated:** Wed Nov 16, 2016 02:31 PM UTC
**Owner:** nobody


Previously filed here: https://github.com/sphinx-doc/sphinx/issues/3151

Using |RST| substitutions inside other formatting does not work -- as far as I can tell.

For example:

this is written in |RST|

works, while

*this is written in |RST|*

does not.

Authors of our documents expect to be able to use the emphasis tags around entire paragraphs, and when common substitutions inside it, fail, it creates confusion. Even more, since pandoc(1) *does* support it.

I haven't found an easy way to work around the lack of this feature.

Is this something you could consider implementing?

Cheers,
Walter Doekes


---

Sent from sourceforge.net because docutils-***@lists.sourceforge.net is subscribed to https://sourceforge.net/p/docutils/feature-requests/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list.
Günter Milde
2017-04-19 20:21:31 UTC
Permalink
- **status**: open --> closed-duplicate
- **Comment**:

Closing this report as a duplicate of the "support nested inline markup" request.
(cf. https://sourceforge.net/p/docutils/feature-requests/22/).



---

** [feature-requests:#53] Replace substitutions in emphasized/bold text**

**Status:** closed-duplicate
**Group:** Default
**Created:** Tue Nov 15, 2016 04:00 PM UTC by Walter Doekes
**Last Updated:** Wed Nov 16, 2016 02:31 PM UTC
**Owner:** nobody


Previously filed here: https://github.com/sphinx-doc/sphinx/issues/3151

Using |RST| substitutions inside other formatting does not work -- as far as I can tell.

For example:

this is written in |RST|

works, while

*this is written in |RST|*

does not.

Authors of our documents expect to be able to use the emphasis tags around entire paragraphs, and when common substitutions inside it, fail, it creates confusion. Even more, since pandoc(1) *does* support it.

I haven't found an easy way to work around the lack of this feature.

Is this something you could consider implementing?

Cheers,
Walter Doekes


---

Sent from sourceforge.net because docutils-***@lists.sourceforge.net is subscribed to https://sourceforge.net/p/docutils/feature-requests/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options. Or, if this is a mailing list, you can unsubscribe from the mailing list.
Loading...