codeblock outputclass="language-c" syntax highlighting oddity

Post here questions and problems related to editing and publishing DITA content.
Martin Honnen
Posts: 96
Joined: Tue Aug 19, 2014 12:04 pm

codeblock outputclass="language-c" syntax highlighting oddity

Post by Martin Honnen »

When I use oXygen 22 and the built-in DITA to PDF (based on XSL-FO) publishing for a sample like

Code: Select all

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic id="topic_d3q_35y_rkb">
    <title>Test</title>
    <body>
        <p>Test</p>
<codeblock outputclass="language-c">#define VALUE1 100 /* Comment */
#define VALUE2 200 /* Comment */
#define VALUE3 300 /* Comment */
#define VALUE4 400 /* Comment */
</codeblock>
<codeblock outputclass="language-javascript">const VALUE1 = 100; /* Comment */
const VALUE2 = 200; /* Comment */
const VALUE3 = 300; /* Comment */
const VALUE4 = 400; /* Comment */
</codeblock>
    </body>
</topic>
then all four lines in the language-javascript section have the same syntax colouring but for the language-c lines the first line use a black text color for the #define and green for the comment while the remaining three lines have all text in pink.
Radu
Posts: 9053
Joined: Fri Jul 09, 2004 5:18 pm

Re: codeblock outputclass="language-c" syntax highlighting oddity

Post by Radu »

Hi Martin,

Sorry for the delay, I can reproduce the problem and added an internal issue to try and fix it.
When we have a fix I will update this thread.
Maybe as a workaround there is another highlighting plugin for the DITA OT:

https://prismjsdita-ot.readthedocs.io/en/latest/

but it will work only in the HTML-based outputs and if there is a network connection. You would probably also need to uninstall our "com.oxygenxml.highlight" DITA OT plugin.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Radu
Posts: 9053
Joined: Fri Jul 09, 2004 5:18 pm

Re: codeblock outputclass="language-c" syntax highlighting oddity

Post by Radu »

Hi Martin,

I looked a little bit on this problem, as a possible fix there is this C highlight configuration file:

OXYGEN_INSTALL_DIR/frameworks/dita/DITA-OT3.x/plugins/com.oxygenxml.highlight/highlighters/c-hl.xml

and change its contents to:

Code: Select all

<?xml version="1.0" encoding="UTF-8"?>
<!-- 
Syntax highlighting definition for C
  
xslthl - XSLT Syntax Highlighting
http://sourceforge.net/projects/xslthl/
Copyright (C) 2005-2008 Michal Molhanec, Jirka Kosek, Michiel Hendriks

This software is provided 'as-is', without any express or implied
warranty.  In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not
   claim that you wrote the original software. If you use this software
   in a product, an acknowledgment in the product documentation would be
   appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
   misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.

Michal Molhanec <mol1111 at users.sourceforge.net>
Jirka Kosek <kosek at users.sourceforge.net>
Michiel Hendriks <elmuerte at users.sourceforge.net>
-->
<highlighters>
  <highlighter type="multiline-comment">
    <start>/**</start>
    <end>*/</end>
    <style>doccomment</style>
  </highlighter>
  <highlighter type="oneline-comment">
    <start><![CDATA[/// ]]></start>
    <style>doccomment</style>
  </highlighter>
  <highlighter type="multiline-comment">
    <start>/*</start>
    <end>*/</end>
  </highlighter>
  <highlighter type="oneline-comment">//</highlighter>
  <highlighter type="string">
    <string>"</string>
    <escape>\</escape>
  </highlighter>
  <highlighter type="string">
    <string>'</string>
    <escape>\</escape>
  </highlighter>
  <highlighter type="hexnumber">
    <prefix>0x</prefix>
    <suffix>ul</suffix>
    <suffix>lu</suffix>
    <suffix>u</suffix>
    <suffix>l</suffix>
    <ignoreCase />
  </highlighter>
  <highlighter type="number">
    <point>.</point>
    <pointStarts />
    <exponent>e</exponent>
    <suffix>ul</suffix>
    <suffix>lu</suffix>
    <suffix>u</suffix>
    <suffix>f</suffix>
    <suffix>l</suffix>
    <ignoreCase />
  </highlighter>
  <highlighter type="keywords">
    <keyword>auto</keyword>
    <keyword>_Bool</keyword>
    <keyword>break</keyword>
    <keyword>case</keyword>
    <keyword>char</keyword>
    <keyword>_Complex</keyword>
    <keyword>const</keyword>
    <keyword>continue</keyword>
    <keyword>default</keyword>
    <keyword>do</keyword>
    <keyword>double</keyword>
    <keyword>else</keyword>
    <keyword>enum</keyword>
    <keyword>extern</keyword>
    <keyword>float</keyword>
    <keyword>for</keyword>
    <keyword>goto</keyword>
    <keyword>if</keyword>
    <keyword>_Imaginary</keyword>
    <keyword>inline</keyword>
    <keyword>int</keyword>
    <keyword>long</keyword>
    <keyword>register</keyword>
    <keyword>restrict</keyword>
    <keyword>return</keyword>
    <keyword>short</keyword>
    <keyword>signed</keyword>
    <keyword>sizeof</keyword>
    <keyword>static</keyword>
    <keyword>struct</keyword>
    <keyword>switch</keyword>
    <keyword>typedef</keyword>
    <keyword>union</keyword>
    <keyword>unsigned</keyword>
    <keyword>void</keyword>
    <keyword>volatile</keyword>
    <keyword>while</keyword>
  </highlighter>
  <highlighter type="keywords">
    <style>directive</style>
    <keyword>define</keyword>
  </highlighter>
</highlighters>
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Radu
Posts: 9053
Joined: Fri Jul 09, 2004 5:18 pm

Re: codeblock outputclass="language-c" syntax highlighting oddity

Post by Radu »

Hi,

We recently released Oxygen 22.1 which should have this problem fixed.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Olivier
Posts: 8
Joined: Fri Apr 21, 2023 12:57 pm

Re: codeblock outputclass="language-c" syntax highlighting oddity

Post by Olivier »

Hi Radu,

Could you please advise how to use the language-python highlighters (OXYGEN_INSTALL_DIR/frameworks\dita\DITA-OT\plugins\com.oxygenxml.highlight\highlighters) to get oxygen to set functionNames() (or even a list of named keywords) to highlight in e.g. red (or any colour)?

Thanks in advance for your help as I'm stumped here..

Best regards,
Olivier
Radu
Posts: 9053
Joined: Fri Jul 09, 2004 5:18 pm

Re: codeblock outputclass="language-c" syntax highlighting oddity

Post by Radu »

Hi Olivier,
As this older forum thread is about C, maybe you could have started a new thread about Python color highlighting.
From what I tested, using a codeblock like this with the outputclass="language-python" attribute should work:

Code: Select all

<codeblock outputclass="language-python">def greet():
    print('Hello World!')

# call the function
greet()

print('Outside function')</codeblock>
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Post Reply