Yes, this looks quite nice.

I have to admit I don't miss the integrated JavaHelp functionality. It is
21st century and people google for problems - (especially) developers don't
need integrated help anymore, imho. Should, however, the NetBeans project
want to get JavaHelp-like behavior back, then I think Jen's project would
be a very good base. Nothing has to be changed in the NetBeans modules, we
have the documentation. The registrations in

https://github.com/nigjo/nb-help/blob/main/src/main/java/de/rwthaachen/wzl/gt/nbm/nbhelp/HelpDisplayer.java

would just take care of rendering the existing help pages in the browser.
Great work! Thank you, Jens.
-jt

čt 18. 3. 2021 v 12:48 odesílatel Geertjan Wielenga
<[email protected]> napsal:
>
> Great progress, thank you for taking this on.
>
> Gj
>
> On Thu, Mar 18, 2021 at 12:33 PM Jens Hofschröer <[email protected]> wrote:
>
> > Am 08.03.2021 um 11:33 schrieb Jens Hofschröer:
> > > Hi
> > >
> > > Am 07.03.2021 um 18:49 schrieb Eric Bresie:
> > >> I’ve seen a few threads which seems to indicate the way forward is to
> > >> have
> > >> the help materials to be translated into some common format (i.e.
either
> > >> html, asciidoc, docwiki) and then render either in a
internal/external
> > >> web
> > >> view or have some new component to render the context as
applicable.  To
> > >> minimize the work on updating help, I believe the hope was these
would
> > be
> > >> basically backwards compatible to reduce the need for too much
> > >> translation.
> > >>
> > >> So all that said, is anyone actively developing an Alternative Help?
> > >  >> Or is the way forward to create help in some specific non-JavaHelp
> > > way and
> > >  > any dependencies on Java-Help replace by something else?
> > >  >
> > >
> > > May be I can extract the more generic part an open source it, but I
can
> > > not say in which time frame due to my daily work.
> >
> > Here is an eary version: https://github.com/nigjo/nb-help
> >
> > The default implementation just sends the JavaHelp page to the local
> > Browser. No navigation like in JavaHelp itself. It is possible to reuse
> > this in an RCP and the implementations can be replaced by own
> > "renderers". I updated our own help system to use this module, so this
> > might be updated in the future.
> >
> > There are currently not that many JavaDocs, but most is done via
> > services. Also there are no security checks for the output, so be aware
> > and use it only in an trusted environment.
> >
> > Jens
> >
> > --
> > http://blog.nigjo.de/netbeans/
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: [email protected]
> > For additional commands, e-mail: [email protected]
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
> >
> >
> >

Reply via email to