openSUSE / docbookrx

(An early version of) a DocBook to AsciiDoc converter written in Ruby.
MIT License
1 stars 2 forks source link

<replaceable> is converted to useless element #33

Open r0ckarong opened 5 years ago

r0ckarong commented 5 years ago

Basically the same as #32. Replaceable in regular text should become single backtick literal.

Inside screen it should only be the text in the tags without additional formatting.

kkaempf commented 5 years ago

Needs example

r0ckarong commented 5 years ago

Input: https://github.com/SUSE/doc-caasp/blob/adoc/xml/admin_software.xml#L216

Output: https://github.com/SUSE/doc-caasp/blame/adoc/adoc/admin_software.adoc#L152

These [replaceable] should be removed and the string encased in single backticks.

r0ckarong commented 5 years ago

Replaceable doesn't work in code examples so it needs to be stripped from all inline and examples. Otherwise you end up with a single backtick to start the inline code and then various backticks for the replaceable notation. Example:

Input: https://github.com/SUSE/doc-caasp/blob/adoc/xml/admin_software.xml#L1061

Output: https://github.com/SUSE/doc-caasp/blame/adoc/adoc/admin_software.adoc#L785