[x3d-public] TextSpecialCharactersIndex.html bug

[Don Brutzman]

Again thanks for this valuable report.

As it turns out, I think that really careful inspection shows that the pretty-print is OK, even if it is slightly different.

This is because the XML encoding cannot always be converted literally.  Multiple equivalent character-entity representations for the same character exist.

Emblematic of this issue is difference between & (character) and & (XML character entity) and & (HTML source to represent the XML character entity).

Since plain text can be confusing (and inadvertently converted) I've tried to illustrate the equivalence with the two attached figures.  Attached and online at

http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter02GeometryPrimitives/TextSpecialCharactersScreenshotPrettyPrintHtml.png
http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter02GeometryPrimitives/TextSpecialCharactersScreenshotXmlSource.png

Also added further explanation to scene description:

	"See figures and conversions to note that multiple equivalences in XML character representations lead to consistent results despite slight differences in source."

Please do ask if you think that this can be improved or corrected further.


On 4/28/2017 8:43 AM, Andreas Plesch wrote:
> http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter02GeometryPrimitives/TextSpecialCharacters.html does not display the correct x3d xml on the web page.
> 
> The .x3d itself is correct.
> 
> Here is a fixed version:
> 
> https://insidious-twister.glitch.me/
> 
> CTRL-u for source or here:
> 
> https://glitch.com/edit/#!/insidious-twister
> 
> or here:
> 
> <span class="value">
>      "Character entity substitutions:"
>      "empty string \"\" skips a line:"
>      ""
>      "apostrophe &apos; is &amp;apos;"
>      "ampersand &amp; is &amp;amp;"
>      "quote mark  \"  is &amp;quot;"
>      "backslash \\ is X3D escape character"
>      "double backslash \\\\ is X3D backslash \\ character"
>      "Pi &#928 is &amp;#928; XML character entity"
>   </span>
> 
> BTW, glitch.com <http://glitch.com> came up with the subdomain name by itself ...
> 
> Not sure, if or how to teach this x3d to html-display translation to a style sheet (or something else).
> 
> -Andreas

all the best, Don
-- 
Don Brutzman  Naval Postgraduate School, Code USW/Br       brutzman at nps.edu
Watkins 270,  MOVES Institute, Monterey CA 93943-5000 USA   +1.831.656.2149
X3D graphics, virtual worlds, navy robotics http://faculty.nps.edu/brutzman
-------------- next part --------------
A non-text attachment was scrubbed...
Name: TextSpecialCharactersScreenshotPrettyPrintHtml.png
Type: image/png
Size: 103107 bytes
Desc: not available
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20170506/e37f94b8/attachment-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: TextSpecialCharactersScreenshotXmlSource.png
Type: image/png
Size: 46334 bytes
Desc: not available
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20170506/e37f94b8/attachment-0003.png>