Group Abstract Group Abstract

Message Boards Message Boards

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

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

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

Thank you! I wasn't aware of the new tools and tried them right away. Unfortunately, the problem persists. As before, Mathematica generated all html pages and necessary images. However, when I open a html site, the images are not shown.

Is it possible that there is an issue with the JavaScript? I only have one file in the js folder, js/3.0.0/wal.js

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