Add typedoc support to build environment

[graup]

RTD supports sphinx-js and jsdoc. It works well with build: image: latest.

Recently sphinx-js added typedoc support for typescript. Could typedoc be installed in the builder image? Or is there a way to install it myself?

npm install -g typedoc

Ref #3338

[humitos]

@graup we are already installing jsdoc with npm, so I think it won't be a problem to another npm dependency.

The line that has to be modified is this one:

https://github.com/rtfd/readthedocs-docker-images/blob/master/Dockerfile#L62

Thanks!

[graup]

@humitos can we get this PR merged? thanks

[graup]

As a quick update, I successfully tested the typedoc integration here. It works with sphinx-js as the only requirement, the new latest docker image, and the Python 3 interpreter. I also had to write a setup.py script than does npm install because typedoc needs all the npm packages to properly parse the code.

Thanks!

[humitos]

@graup thanks a lot for the update on this!

I also had to write a setup.py script than does npm install because typedoc needs all the npm packages to properly parse the code.

Makes sense. I took a look at the dependencies are they does not look to be "general dependencies that we have to include in our image" so I think it's fine to do it in that way (I'd put the os.system call in the docs/conf.py though, since it's only for the documentation and not to install the package --My $0.02)

[humitos]

There is a newer a simpler way to specify typedoc now. Check out this comment #3069 (comment)