Message Boards Message Boards

1
|
4635 Views
|
8 Replies
|
7 Total Likes
View groups...
Share
Share this post:

HTML documentation doesn't show images (Workbench Eclipse plugin + M13)

We are developing GTPack, a Mathematica group theory package with an extensive documentation. The workbench eclipse plugin has been powerful in writing this documentation and compiling it to the standard Mathematica form. However, I am recently facing trouble with the generation of HTML documentation pages. The "documentation build" generates all necessary images and code, but when I open the page they are not displayed.

What do I need to do to fix this issue? I am using Eclipse IDE for Java Developers (Version: 2019-12 (4.14.0)), Wolfram Workbench (10.2.43), Mathematica 13, and Ubuntu 22.04.

I provide an example below.

For example, the regular documentation page looks like this: regular Mathematica documentation

In contrast, the html version is lacking the images and looks as follows: html version

8 Replies

Hi, I have the same problem as Matthias Geilhufe but I do not see a solution to the problem in this discussion except to try a new tool. Does anyone have a solution? Thanks. Frederic

POSTED BY: Aitken Frederic

Unfortunately, the problem of generating functioning Mathematica HTML documentation persists. I am using Mathematica 13.2 and generate the HTML documentation by

PacletDocumentationBuild[GTPackDir, builddir, "HTML"];

Here, GTPackDir is the directory where the package is locally stored and builddir the directory, where the HTML documentation is supposed to be built. While all image files are generated correctly, they still cannot be seen on the actual HTML documentation pages. When opening an HTML file, I can see that images seem to be embedded with divs:

<div class="hideable">
     <div id="416978728"
         class="clipboard-input"
         data-in="In[1]:="
         data-in-num="1"
         data-in-src="data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=="
         data-src="Files/GTJx.en/I_1.png"
         data-in-width="137"
         data-in-height="18"
         data-link="https://wolfram.com/xid/0e4xv67ss28js7ojmz-g6jk4q"
         data-code="Files/GTJx.en/i_1.txt"
         ></div>
     <div id="7783792"
         class="clipboard-input"
         data-in="In[2]:="
         data-in-num="2"
         data-in-src="data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=="
         data-src="Files/GTJx.en/I_2.png"
         data-in-width="133"
         data-in-height="18"
         data-link="https://wolfram.com/xid/0e4xv67ss28js7ojmz-ew4aq"
         data-code="Files/GTJx.en/i_2.txt"
         ></div>
     <div class="clipboard-output"
         data-out=" "
         data-out-num=""
         data-out-src="data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=="
         data-src="Files/GTJx.en/O_1.png"
         data-out-width="105"
         data-out-height="107"
         ></div>
    </div>
   </div>

So I wonder if there is a modification to the style file required or if there is a general bug while generating the HTML files. For example, I can't find a css-file defining the classes "clipboard-input" and "clipboard-output".

For any help, I would be really grateful, as this issue slows down our development significantly. Is there a functioning example one could follow?

Thanks in advance!

Hi Connor,

Thanks for your reply! We currently have a website hosting GTPack, which is https://gtpack.org There we also have an HTML documentation (see https://gtpack.org/documentation/). However, this documentation is obtained using a fairly outdated approach and several patches etc. Therefore I tried: i) most recent WorkBench + Mathematica 13; ii) The Documentation tools in Mathematica 13. Both, unfortunately, give the same error with missing images at the moment.

I agree it would be best to have a separate discussion, thanks for taking time for that! I will reach out separately.

Also, thanks for bringing up the paclet option. We are currently looking in to it.

Thanks, Matthias

POSTED BY: Connor Gray

Hi Matthias, I work closely with the documentation team at WRI, and specifically on the PacletTools package.

From your description I see you're using the Workbench plugin to build the documentation. It would help me narrow things down if you could clarify which of the following is the situation you're in:

  1. You've previously built HTML that built and rendered correctly, but recently built HTML has stopped working.

  2. You've previously built notebook documentation, but not HTLM documentation. This is your first time building HTML documentation, but you're seeing problems with the built pages.

In either case, you should know that the documentation building logic in the Workbench plugin recently (earlier this year) went through a major overhaul as part of a concurrent change to bring the ability to author and build documentation into Wolfram Language itself, which greatly improved and modernized the built notebook documentation, but unfortunately caused a few issues with the built HTML documentation.

We're in the process of fixing and updating the HTML generation logic, which should be released alongside the next WL version and as an automatic paclet update.

However, in the meantime, I'd be happy to work with you directly to get you a pre-release version more quickly once it's available. If you're interested in that, please let me know and I will reach out to connect privately.

POSTED BY: Connor Gray

Hi Connor,

You can find my contact details here: https://www.chalmers.se/en/Staff/Pages/Matthias-Geilhufe.aspx

Thanks, Matthias

Have you look into the new tools? Like Paclet Repository that marks new tech ear for packages development and also makes nice doc pages like this

https://resources.wolframcloud.com/PacletRepository/resources/Wolfram/QuantumFramework

by hooking into also new Documentation Tools

https://reference.wolfram.com/language/DocumentationTools/tutorial/DocumentationToolsQuickStart.html

POSTED BY: Kapio Letto
Reply to this discussion
Community posts can be styled and formatted using the Markdown syntax.
Reply Preview
Attachments
Remove
or Discard

Group Abstract Group Abstract