Theia: Documentation & Examples

[rodenp]

Firstly awesome this Theia you are building. 👍
I’m looking at contributing to/extending Theia and am struggling with lack of documentation.
Is there somewhere that outlines all the classes and methods?
In particular I’m wanting to know how I can create a separate palette of draggable components and their associated bindings to events.

[rodenp]

I'm really surprised that there has been no response to my question.

Without good documentation this wonderful thing you are creating will not get the hands of many people who could contribute and help turn this into a stunning project.

So please can someone help with guidance on how to find documentation.

Thanks

[maks-rafalko]

I'm also very interested in getting any kind of useful documentation, API references, how-tos and tutorials.

Now it looks like a black box, unfortunately. So big 👍 on getting a reply

[akosyakov]

Hi, sorry, right now we don't have so many documentations, but there is some.

You could start by looking at https://www.theia-ide.org/doc/index.html
There is a Theia workshop to learn how to add custom widgets: https://github.com/TypeFox/theia-workshop

There are plenty of extensions contributing various languages and widgets. You can find one which does something similar to what you want and look at its implementation. List of all extensions: https://www.npmjs.com/search?q=keywords:theia-extension

In particular I’m wanting to know how I can create a separate palette of draggable components and their associated bindings to events.

It sounds very vague, sorry. If you have more concrete questions, we can help.

[rodenp]

Thanks Anton for the guidance.

To give you an example of what i am after, here is a command palette from eclipse just as a guide.
I would like to be able to display such a palette in the IDE left pane under for example the File tree and be able to drag and drop from this palette.

Does this make more sense?

Thanks again
Peter

[rodenp]

The helper applications are great.
But how would i implement a widget in the left pane instead of the middle pane

[rodenp]

I haven't heard anything back about this.

Can someone help with more info on how to build a palette of UI components that I could drag and drop from the left pane into the central pane.

Your guidance is much appreciated.

[akosyakov]

@rodenp look at ApplicationShell.WidgetOptions, there you can specify a shell area to which a widget should be attached. Attaching is done via ApplicationShell.addWidget(widget, options).

If your widget should be a singleton, like a navigator, then look at AbstractViewContribution and its implementations. It's a base class for contributions providing views (singleton widgets).

[rodenp]

Thank you Anton for your response.
For me it is too little to help.
I'm sorry that without any proper documentation i will forever be asking questions.
I find very often with projects that are poorly documented rely on super clever people who can dive deep with little guidance.
I am not one of those people and I need guidance to a certain point before i like an infant can stand on my own two feet.
So I will have to wait for the documentation to catch up before I invest any further time with this project.
It has great potential that I can see, but for me right now its just too up in the clouds.