Jump to content

Unable to build Documenation


Wink
 Share

Recommended Posts

I wanted to contribute a few lines of documentation which show how to compile typescript code with Babylon that @Gijs provided. So as a start I cloned the Documentation and was following the Run a local copy of the documentation instructions but it "hung" on the "grunt build" step:

$ grunt build
Running "clean:json" (clean) task
>> 0 paths cleaned.

Running "execute:compileTagsClasses" (execute) task
-> executing module /home/wink/foss/Babylon/Documentation/scripts/compile-tags/compile-tags-classes.js
2016-12-13T19:26:17.930Z - info: 2.3 AbstractMesh
2016-12-13T19:26:17.946Z - info: 2.3 Action
2016-12-13T19:26:17.948Z - info: 2.3 ActionEvent
2016-12-13T19:26:17.948Z - info: 2.3 ActionManager
2016-12-13T19:26:17.951Z - info: 2.3 AnaglyphArcRotateCamera
2016-12-13T19:26:17.951Z - info: 2.3 AnaglyphFreeCamera
...

Running "execute:compileWhatsNew" (execute) task
-> executing module /home/wink/foss/Babylon/Documentation/scripts/compile-html/compile-html-whats-new.js
2016-12-13T19:26:18.838Z - info: > Whats-new.html compiled.
-> completed /home/wink/foss/Babylon/Documentation/scripts/compile-html/compile-html-whats-new.js (52ms)

>> 1 file and 0 calls executed (52ms)

Running "execute:compileHtmlClasses" (execute) task
-> module call undefined
2016-12-13T19:26:18.977Z - info: /home/wink/foss/Babylon/Documentation/public/html/class_2.3
2016-12-13T19:26:18.977Z - info: Directory html/class_2.3 is about to be cleaned...
2016-12-13T19:26:18.979Z - info: /home/wink/foss/Babylon/Documentation/public/html/class_2.4
2016-12-13T19:26:18.979Z - info: Directory html/class_2.4 is about to be cleaned...
2016-12-13T19:26:18.979Z - info: /home/wink/foss/Babylon/Documentation/public/html/class_2.5
2016-12-13T19:26:18.979Z - info: Directory html/class_2.5 is about to be cleaned...
2016-12-13T19:26:18.979Z - info: Directory html/class_2.3 is now empty.
2016-12-13T19:26:18.980Z - info: Directory html/class_2.4 is now empty.
2016-12-13T19:26:18.980Z - info: Directory html/class_2.5 is now empty.
2016-12-13T19:26:18.980Z - info: About to launch parallel compilation...
2016-12-13T19:26:19.204Z - info: > HTML page for classes_2.3 compiled.
2016-12-13T19:26:19.205Z - info: > HTML page for classes_2.4 compiled.
2016-12-13T19:26:19.208Z - info: > HTML page for classes_2.5 compiled.

2016-12-13T19:26:46.474Z - info: > All "class" for BJSv2.3 pages compiled.
2016-12-13T19:26:46.476Z - info: > All "class" for BJSv2.4 pages compiled.
2016-12-13T19:26:46.476Z - info: > All "class" for BJSv2.5 pages compiled.
2016-12-13T19:26:46.476Z - info: > ALL CLASSES PAGES COMPILED.
-> completed (27637ms)

>> 0 files and 1 call executed (27638ms)

Running "execute:compileHtmlStatics" (execute) task
-> module call undefined
2016-12-13T19:26:46.651Z - warn: File /home/wink/foss/Babylon/Documentation/content/extensions/MaterialsLibrary/fire.md doesn't exist.
2016-12-13T19:26:46.651Z - warn: File /home/wink/foss/Babylon/Documentation/content/extensions/Tree_Generators/Simple_Pine_Generator.md doesn't exist.
2016-12-13T19:26:46.656Z - warn: File /home/wink/foss/Babylon/Documentation/content/tutorials/03_Advanced/Layermasks_and_Multi-cam_Textures.md doesn't exist.
2016-12-13T19:26:48.000Z - info: > All pages for exporters have been compiled.
2016-12-13T19:26:48.000Z - info: > All pages for generals have been compiled.
2016-12-13T19:26:48.000Z - info: > All pages for overviews have been compiled.

^C  <<<<< Here I aborted after about 25 minutes

Execution Time (2016-12-13 11:26:17 UTC-8)
execute:compileHtmlClasses      27.6s  ▇▇ 2%
execute:compileHtmlStatics  26m 34.6s  ▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇ 98%
Total 27m 3.3s

In the 'Running "execute:compileHtmlClasses" (execute) task' section there was as "module call undefined" but it did finish after 27secs. It then started the 'Running "execute:compileHtmlStatics" (execute) task' which also displayed the 'module call undefined' and some warnings and then "hung" and I Ctrl-C to abort after 25 minutes. I say "hung" because my System Monitor didn't show high cpu/memory/network activity.

I'm running Arch Linux updated this morning I have nodejs-7.2.1, npm 4.0.3 and grunt-cli 1.2.0:

wink@wink-desktop:~
$ uname -a
Linux wink-desktop 4.8.12-2-ARCH #1 SMP PREEMPT Fri Dec 2 20:17:06 CET 2016 x86_64 GNU/Linux

wink@wink-desktop:~
$ node --version
v7.2.1

wink@wink-desktop:~
$ grunt --version
grunt-cli v1.2.0

wink@wink-desktop:~
$ npm --version
4.0.3

Suggestions on what I might have done wrong?

-- Wink

Link to comment
Share on other sites

Oh, I've attached a text file of my clone, npm install and build steps. And for quick perusal here is the output from the "npm install" step:

$ npm install
npm WARN deprecated [email protected]: Jade has been renamed to pug, please install the latest version of pug instead of jade
npm WARN deprecated [email protected]: Deprecated, use jstransformer
npm WARN deprecated [email protected]: Please update to minimatch 3.0.2 or higher to avoid a RegExp DoS issue
npm WARN deprecated [email protected]: Deprecated as of version 0.1.2 please use object.pick instead.
npm WARN deprecated [email protected]: graceful-fs v3.0.0 and before will fail on node releases >= v7.0. Please update to graceful-fs@^4.0.0 as soon as possible. Use 'npm ls graceful-fs' to find it in the tree.
npm WARN deprecated [email protected]: Please update to minimatch 3.0.2 or higher to avoid a RegExp DoS issue
npm WARN deprecated [email protected]: Please update to minimatch 3.0.2 or higher to avoid a RegExp DoS issue
npm WARN deprecated [email protected]: graceful-fs v3.0.0 and before will fail on node releases >= v7.0. Please update to graceful-fs@^4.0.0 as soon as possible. Use 'npm ls graceful-fs' to find it in the tree.
npm WARN prefer global [email protected] should be installed with -g
npm WARN prefer global [email protected] should be installed with -g
[email protected] /home/wink/foss/Babylon/Documentation
├── [email protected] 
├── [email protected] 
├─┬ [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ └── [email protected] 
├─┬ [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └── [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ └── [email protected] 
├─┬ [email protected] 
│ ├── [email protected] 
│ └── [email protected] 
├─┬ [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └── [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └── [email protected] 
│ │ ├── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └─┬ [email protected] 
│ │ │   ├── [email protected] 
│ │ │   └── [email protected] 
│ │ ├── [email protected] 
│ │ └── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ ├── [email protected] 
│ │ │ └── [email protected] 
│ │ ├── [email protected] 
│ │ └── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ ├── [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ ├── [email protected] 
│ │ │ └── [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ └── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ └── [email protected] 
├─┬ [email protected] 
│ └── [email protected] 
├─┬ [email protected] 
│ └── [email protected] 
├─┬ [email protected] 
│ └─┬ [email protected] 
│   ├── [email protected] 
│   ├── [email protected] 
│   ├── [email protected] 
│   ├─┬ [email protected] 
│   │ └── [email protected] 
│   └── [email protected] 
├─┬ [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └── [email protected] 
│ │ ├── [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ └── [email protected] 
├─┬ [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ └─┬ [email protected] 
│ │   ├─┬ [email protected] 
│ │   │ ├── [email protected] 
│ │   │ └── [email protected] 
│ │   ├── [email protected] 
│ │   └── [email protected] 
│ ├── [email protected] 
│ └─┬ [email protected] 
│   ├── [email protected] 
│   ├── [email protected] 
│   ├─┬ [email protected] 
│   │ └── [email protected] 
│   └── [email protected] 
├── [email protected] 
├── [email protected] 
├─┬ [email protected] 
│ └── [email protected] 
├─┬ [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └── [email protected] 
│ │ └─┬ [email protected] 
│ │   └── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ └─┬ [email protected] 
│ │   └── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├─┬ [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ ├── [email protected] 
│ │ │ └── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └── [email protected] 
│ │ └─┬ [email protected] 
│ │   ├─┬ [email protected] 
│ │   │ └── [email protected] 
│ │   └── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ ├── [email protected] 
│ │ ├── [email protected] 
│ │ └─┬ [email protected] 
│ │   ├── [email protected] 
│ │   ├─┬ [email protected] 
│ │   │ ├─┬ [email protected] 
│ │   │ │ ├─┬ [email protected] 
│ │   │ │ │ ├─┬ [email protected] 
│ │   │ │ │ │ └── [email protected] 
│ │   │ │ │ ├── [email protected] 
│ │   │ │ │ └── [email protected] 
│ │   │ │ └── [email protected] 
│ │   │ ├── [email protected] 
│ │   │ └── [email protected] 
│ │   ├── [email protected] 
│ │   └── [email protected] 
│ ├── [email protected] 
│ └─┬ [email protected] 
│   ├── [email protected] 
│   └── [email protected] 
├── [email protected] 
├─┬ [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └── [email protected] 
│ │ └── [email protected] 
│ ├─┬ [email protected] 
│ │ └─┬ [email protected] 
│ │   └── [email protected] 
│ └─┬ [email protected] 
│   └── [email protected] 
├── [email protected] 
├─┬ [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ ├── [email protected] 
│ │ │ └─┬ [email protected] 
│ │ │   └─┬ [email protected] 
│ │ │     └── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ ├── [email protected] 
│ │ │ ├─┬ [email protected] 
│ │ │ │ └── [email protected] 
│ │ │ ├── [email protected] 
│ │ │ └─┬ [email protected] 
│ │ │   └── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └── [email protected] 
│ │ ├── [email protected] 
│ │ ├── [email protected] 
│ │ └─┬ [email protected] 
│ │   └── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ ├── [email protected] 
│ │ │ └── [email protected] 
│ │ ├── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ ├─┬ [email protected] 
│ │ │ │ └── [email protected] 
│ │ │ └── [email protected] 
│ │ ├── [email protected] 
│ │ └─┬ [email protected] 
│ │   └─┬ [email protected] 
│ │     ├── [email protected] 
│ │     ├── [email protected] 
│ │     └── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ └─┬ [email protected] 
│   ├── [email protected] 
│   ├─┬ [email protected] 
│   │ ├── [email protected] 
│   │ ├─┬ [email protected] 
│   │ │ ├─┬ [email protected] 
│   │ │ │ └── [email protected] 
│   │ │ ├── [email protected] 
│   │ │ └── [email protected] 
│   │ ├── [email protected] 
│   │ ├─┬ [email protected] 
│   │ │ ├─┬ [email protected] 
│   │ │ │ └── [email protected] 
│   │ │ └── [email protected] 
│   │ ├── [email protected] 
│   │ └── [email protected] 
│   └── [email protected] 
├─┬ [email protected] 
│ ├─┬ [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ └── [email protected] 
│ │ ├── [email protected] 
│ │ └── [email protected] 
│ └── [email protected] 
├── [email protected] 
├─┬ [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ └─┬ [email protected] 
│   ├── [email protected] 
│   ├── [email protected] 
│   └── [email protected] 
├─┬ [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├─┬ [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ ├── [email protected] 
│ │ │ └── [email protected] 
│ │ ├── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ ├── [email protected] 
│ │ │ ├─┬ [email protected] 
│ │ │ │ └── [email protected] 
│ │ │ ├── [email protected] 
│ │ │ └── [email protected] 
│ │ └─┬ [email protected] 
│ │   └── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ ├── [email protected] 
│ │ ├── [email protected] 
│ │ └── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ ├─┬ [email protected] 
│ │ │ ├── [email protected] 
│ │ │ ├── [email protected] 
│ │ │ └── [email protected] 
│ │ └─┬ [email protected] 
│ │   ├── [email protected] 
│ │   ├── [email protected] 
│ │   ├── [email protected] 
│ │   ├─┬ [email protected] 
│ │   │ └── [email protected] 
│ │   ├── [email protected] 
│ │   ├─┬ [email protected] 
│ │   │ └── [email protected] 
│ │   ├── [email protected] 
│ │   ├── [email protected] 
│ │   └── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ └── [email protected] 
├─┬ [email protected] 
│ └─┬ [email protected] 
│   └── [email protected] 
├─┬ [email protected] 
│ └─┬ [email protected] 
│   └── [email protected] 
├─┬ [email protected] 
│ └── [email protected] 
├─┬ [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ └── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├─┬ [email protected] 
│ │ └── [email protected] 
│ ├── [email protected] 
│ ├─┬ [email protected] 
│ │ ├── [email protected] 
│ │ ├── [email protected] 
│ │ └── [email protected] 
│ └── [email protected] 
├── [email protected] 
├─┬ [email protected] 
│ └── [email protected] 
└─┬ [email protected] 
  ├── [email protected] 
  ├── [email protected] 
  ├── [email protected] 
  ├── [email protected] 
  ├── [email protected] 
  └── [email protected] 

 

babylonjs.doc.clone-npm-install-grunt-build.txt

Link to comment
Share on other sites

The task that is running, compileHtmlStatics showed activity in System Monitor pegging 1 of my 12 cpus at 100% for about 30 seconds and then nothing. I also used top and iotop and I don't see any measurable activity for grunt its just idle. I'll let it run overnight with my fingers crossed and report back in the AM.

Link to comment
Share on other sites

I think there is a problem with the configuration...

You can see the file https://github.com/BabylonJS/Documentation/blob/master/content/extensions/Tree_Generators/SImple_Pine_Generator.md has a capital 'I'... And linux is case-sensitive.

It's the same for Fire (and not fire.md) and 'Multi-Cam' (and not Mulit-cam). You'll have to update the file statics.json with the correct case, and everything will be good !

And you can PR the whole fix :)

Link to comment
Share on other sites

Just for reference on my linux box it took about 1m 18secs to run "grunt build":

Done, without errors.


Execution Time (2016-12-14 09:41:02 UTC-8)
execute:compileHtmlClasses  27.3s  ▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇ 35%
execute:compileHtmlStatics   4.3s  ▇▇▇▇▇▇ 6%
execute:forwarder            3.9s  ▇▇▇▇▇ 5%
execute:indexer             41.1s  ▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇ 53%
Total 1m 17.8s

 

Link to comment
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Loading...
 Share

  • Recently Browsing   0 members

    • No registered users viewing this page.
×
×
  • Create New...