That would work but isn't the content component supposed to support localization itself?
In regards to being able to swap out a help implementation, IMO all that is really required is a service that takes in a webSiteId, view name and locale which them returns a URL. In order to swap out the implementation it's then merely a matter of overriding that service with your own URL provider. Regards Scott On 5/12/2012, at 3:33 AM, adrian.c...@sandglass-software.com wrote: > Scott, > > I agree with your last paragraph and I have suggested it in the past, but > there doesn't seem to be much interest in it. There is a much simpler way to > implement help that addresses all of our concerns: > > 1. Put Help URLs in the UI label files so they can be localized. > 2. Use the Content component to store and display Help data. > 3. Have each component initialize the database with Help data. > > OFBiz OOTB could have some Help screens available in the Content component, > but if a user wanted to use some other method, all they would need to do is > change the Help URLs in the UI label files (to point to an internal Wiki for > example). > > -Adrian > > Quoting Scott Gray <scott.g...@hotwaxmedia.com>: > >> I haven't had time yet, I was on a computer-free vacation last week and now >> have a ton to catch up on. >> >> I've read the pdf document but it's light on implementation detail so I >> guess I'll have to dig into the patch at some point. >> >> Thoughts/questions so far: >> - The build time compilation is a concern IMO, I'd like to see a help system >> that users can edit as needed with things like business specific information >> and filling in gaps for custom enhancements that the devs didn't document >> fully >> - I think I saw somewhere that it is planned to commit the generated help >> html? Why? Version control is for source code. >> - How would this approach work in multi-tenanted systems where not all apps >> are available to all tenants? If help is a complete document I'm not sure >> how it could be restricted by context? >> >> I think it's important to make a distinction between the 'prettiness' of the >> proposed implementation and the underlying design. >> >> I also think it's unfortunate that we're unable to eat our own dog food and >> use the content app properly given that documentation is ultimately content >> embedded within OFBiz. It's a great use-case for improving the content app >> really. >> >> Regards >> Scott >> >> On 4/12/2012, at 7:58 AM, Olivier Heintz wrote: >> >>> I have tested the new OFBIz webhelp for the last 3 weeks and migrated >>> some help we already have (for projectmgr) >>> >>> On a end user perspective, webhelp is clearly an enhancement, because >>> search and glossary (and better presentation) help to find the correct >>> information more quickly. >>> On a help writer perspective, docbook file structure is easier to >>> understand that dataresource - content - contentAssoc - ... >>> >>> There are still some minors problems, but in each case I have found >>> (with Tom help sometime) how to solve it. >>> >>> I'm waiting a first release is publish to trunk to send jira with these >>> enhancements. >>> >>> User Help is one of the software quality criteria and webhelp will help >>> ofbiz community to have better one. >>> Tools is not everything, but it's a good step to motivate the community >>> to contribute in this area. >>> >>> >>> Le 28/11/2012 19:22, Jacques Le Roux a écrit : >>>> Bump ? >>>> >>>> Jacques >>>> >>>> Jacques Le Roux wrote: >>>>> Yes no problems. Depending on what you are starting from, you will need >>>>> to add binaries files (from my last patch) or not (Tom's >>>>> zips) but with zips you might get some issues, already blurred in my mind. >>>>> >>>>> Thanks >>>>> >>>>> Jacques >>>>> >>>>> From: "Scott Gray" <scott.g...@hotwaxmedia.com> >>>>>> It's been all of 3 days since I asked you to wait for a thorough review, >>>>>> has that happened yet or will you just keep asking >>>>>> until no one can be bothered asking you to wait any longer? Patience is >>>>>> a virtue Jacques, the project has gone over 10 years >>>>>> without this feature and I don't think a few days/weeks/months will hurt >>>>>> any, especially considering the next release branch >>>>>> isn't due to be created for quite some time. >>>>>> >>>>>> Regards >>>>>> Scott >>>>>> >>>>>> On 19/11/2012, at 8:41 AM, Jacques Le Roux wrote: >>>>>> >>>>>>> Hi, >>>>>>> >>>>>>> We (Tom and I) are ready to commit the new help (webhelp - OFBIZ-4941) >>>>>>> in the content component where all work for us, and will >>>>>>> be completed by Tom as he suggested. There are some trivial Birt issues >>>>>>> which will dissapear when the process will be >>>>>>> completed, see my last comment. >>>>>>> >>>>>>> Is it ok to commit as is and to improve later? Mostly we want to move >>>>>>> webhelp outside of the content component in a new, to >>>>>>> stay OOTB, specialpurpose webehlp component. Or do you want this >>>>>>> addressed before? Note that if you want this addressed now we >>>>>>> expect a rapid help from those who want that... >>>>>>> >>>>>>> Thanks >>>>>>> >>>>>>> Jacques >>> >> >> > > >