wshito / asciidoctor-chunker

The utility to create chunked HTML files from the single HTML generated by Asciidoctor.
MIT License
25 stars 7 forks source link

Unclear on meaning of warnings from new chunker #10

Closed oddhack closed 3 years ago

oddhack commented 3 years ago

First, thanks very much for doing the JS version. The performance increase is huge, and will make it viable to include the chunker in our specification CI, which wasn't practical with the roswell version due to 4-5 CPU minute runtimes.

There are a couple of warnings we're getting that I'm unclear of the meaning of, using the 0.9 release (maybe they were present in the old version as well and I just didn't notice). Here's an excerpt from the build:

node /home/tree/git/vulkan/scripts/asciidoctor-chunker/asciidoctor-chunker.js /home/tree/git/vulkan/gen/out/html/prechunked.html -o /home/tree/git/vulkan/gen/out/html

Woops, unknown contents here to be processed.
Woops, unknown contents here to be processed.
Successfully chunked! => /home/tree/git/vulkan/gen/out/html/index.html

    Local file liked from the document is missing: /home/tree/git/vulkan/gen/out/html/chunked.css?4
    Local file liked from the document is missing: /home/tree/git/vulkan/gen/out/html/chunked.js?4

I'm unclear what the 'Woops' message is complaining about. Our HTML is the output of asciidoctor so we don't have very much control over it, aside from our CSS - but if this is a problem, it would help to be given a pointer to what's causing the problem so we can try and fix it.

The 'Local file liked' (linked?) message is complaining about missing files, but the files (chunked.css / chunked.js) are present, referred to as follows:

I'll admit that I'm unsure about the purpose and validity of the '?4' following the script name - these files didn't come from us originally, and are something of a black box. I'm checking with the original author about that. If it's legal URL syntax to have a \ Githubissues.

  • Githubissues is a development platform for aggregating issues.