Hi Cuba team
Could you please shed some light on how can we build the help system files and contents for the application developed in CUBA?
Mortoza
Hi Cuba team
Could you please shed some light on how can we build the help system files and contents for the application developed in CUBA?
Mortoza
Hi Mortoza,
What do you mean - a documentation for an application like CUBA manual, or context help embedded in the application UI?
Hi Konstantin,
A Context help embedded in the application UI. This can be context sensitive and help systems with search options, links from one help context to another context through different texts contents etc.
Hello Mortoza,
I can suggest two options:
Regards,
Gleb
Thanks for those hints. which method have you used in CUBA STUDIO? Do you have any sample app that I can refer to for more details?
Hi,
i created a help system that looks somewhat like the studio solution as a CUBA application: GitHub - mariodavid/cuba-example-help-system: CUBA platform example that allows to show help messages for particular screens
It is based on an entity that stores the help content. You can open the help system via “F1” in the main window.
It may be a starting point for you. Perhaps i will change it into a app component so that it can be used for other users.
Bye
Mario
Thanks Mario, that will be great if you can make it a component. I shall try that out.
@Konstantin / @Gleb
May we know what is the framework you have used for the current version of documentation, it looks pretty nice and have scroll-able responsive menu for different devices.
The platform documentation, starting with version 6.0, is written using the Asciidoc syntax. To convert the Asciidoc document to HTML, the Asciidoctor processor is used (http://asciidoctor.org/). You can read the Asciidoc syntax from the following links:
Styles (including responsive) are written in CSS. Search and other interactive staff are written in JavaScript.
Regards,
Gleb.
Hi Mario
I have couple of questions:
Hi,
generally, this is just a POC and i just mentioned it as a starting point for your development. It has some problems that lead me to write this question. Linking between different content is not part of it. I would assume that it would require another approach of storing the content. So when you want to build something like this, you can just take it as an example…
the F1 shortcut as well as the whole side panel is registered in the ExtMainWindow.
probably with something like this: Test and seed data in CUBA applications – Road to CUBA and beyond...
Bye
Mario
Thanks
@CUBA team,
Do you have any plan for any ApplicationHelp system component or anything like to be part of the framework?