[jira] [Created] (OFBIZ-4941) Proposal for a new help system

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13472325#comment-13472325 ]

Tom Burns edited comment on OFBIZ-4941 at 10/9/12 1:27 PM:
-----------------------------------------------------------

Jacques,

I think point 5 is confusing because I had to break the data files into two packages to keep them under 10M.
The intent in the instructions is to first copy the whole package
1. WebhelpFiles\WebhelpFiles\docbookhelp
> applications\content\data\helpdata

2. Then copy the folders
WebhelpHRAppDocbook\WebhelpHRAppDocbook\docbookhelp\humanres_en
WebhelpHRAppDocbook\WebhelpHRAppDocbook\docbookhelp\images_en
> applications\content\data\helpdata\docbookhelp\

The screen shot help_content.jpg shows you where everything should land.

I've opened access to the files in on AWS. Go to:
http://ec2-23-20-150-243.compute-1.amazonaws.com
and you can browse the file structure if any questions remain.

The good news - checked out r1395307 and applied all the changes. Everything works.

Tom

               
      was (Author: brettonwoods):
    Jacques,

I think point 5 is confusing because I had to break the data files into two packages to keep them under 10M.
The intent in the instructions is to first copy the whole package
1. WebhelpFiles\WebhelpFiles\docbookhelp
> applications\content\data\helpdata

2. Then copy the folders
WebhelpHRAppDocbook\WebhelpHRAppDocbook\docbookhelp\humanres_en
WebhelpHRAppDocbook\WebhelpHRAppDocbook\docbookhelp\images_en
> applications\content\data\helpdata

The screen shot help_content.jpg shows you where everything should land.

I've opened access to the files in on AWS. Go to:
http://ec2-23-20-150-243.compute-1.amazonaws.com
and you can browse the file structure if any questions remain.

The good news - checked out r1395307 and applied all the changes. Everything works.

Tom

                 

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13472371#comment-13472371 ]

Jacques Le Roux commented on OFBIZ-4941:
----------------------------------------

You can close access to the server, that's exactly what I have here:
{code}
D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp>dir
 Le volume dans le lecteur D s'appelle Secondaire
 Le numéro de série du volume est 441F-6A20

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp

07/10/2012  20:38    <REP>          .
07/10/2012  20:38    <REP>          ..
07/10/2012  19:38    <REP>          accounting_en
07/10/2012  19:25    <REP>          humanres_en
07/10/2012  19:38    <REP>          images_accounting_en
07/10/2012  19:25    <REP>          images_humanres_en
07/10/2012  19:38    <REP>          images_manufacturing_en
07/10/2012  19:38    <REP>          images_manufacturing_nl
07/10/2012  19:38    <REP>          images_projectmgr_en
07/10/2012  19:38    <REP>          manufacturing_en
07/10/2012  19:38    <REP>          manufacturing_nl
07/10/2012  19:38    <REP>          projectmgr_en
               0 fichier(s)                0 octets
              12 Rép(s)  50 082 443 264 octets libres
{code}

and of course all files are present:
{code}
D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp>dir /s
 Le volume dans le lecteur D s'appelle Secondaire
 Le numéro de série du volume est 441F-6A20

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp

07/10/2012  20:38    <REP>          .
07/10/2012  20:38    <REP>          ..
07/10/2012  19:38    <REP>          accounting_en
07/10/2012  19:25    <REP>          humanres_en
07/10/2012  19:38    <REP>          images_accounting_en
07/10/2012  19:25    <REP>          images_humanres_en
07/10/2012  19:38    <REP>          images_manufacturing_en
07/10/2012  19:38    <REP>          images_manufacturing_nl
07/10/2012  19:38    <REP>          images_projectmgr_en
07/10/2012  19:38    <REP>          manufacturing_en
07/10/2012  19:38    <REP>          manufacturing_nl
07/10/2012  19:38    <REP>          projectmgr_en
               0 fichier(s)                0 octets

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\accounting_en

07/10/2012  19:38    <REP>          .
07/10/2012  19:38    <REP>          ..
13/09/2012  22:08           219 387 accounting.xml
               1 fichier(s)          219 387 octets

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\humanres_en

07/10/2012  19:25    <REP>          .
07/10/2012  19:25    <REP>          ..
13/09/2012  16:53           322 717 humanres.xml
               1 fichier(s)          322 717 octets

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\images_accounting_en

07/10/2012  19:38    <REP>          .
07/10/2012  19:38    <REP>          ..
13/09/2012  19:55           117 168 man.png
               1 fichier(s)          117 168 octets

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\images_humanres_en

07/10/2012  19:25    <REP>          .
07/10/2012  19:25    <REP>          ..
13/09/2012  19:55            93 253 AccountingPayCheck.jpg
13/09/2012  19:55           231 431 AccountingSetInvoiceStatus.jpg
13/09/2012  19:55            43 397 EditTrainingApprovalsTraining.jpg
13/09/2012  19:55            74 807 EmployeeAddSecurityGroup.jpg
13/09/2012  19:55            51 883 EmployeeCreatePartyAttribute.jpg
13/09/2012  19:55            58 303 EmployeeCreateUserLogin.jpg
13/09/2012  19:55            84 588 EmployeeEditEmployeeLeaves.jpg
13/09/2012  19:55            71 838 EmployeeEditEmployeeQuals.jpg
13/09/2012  19:55            53 638 EmployeeEditEmployeeSkills.jpg
13/09/2012  19:55            51 301 EmployeeEditPartyAttribute.jpg
13/09/2012  19:55            73 366 EmployeeEditPersonalInformation.jpg
13/09/2012  19:55            70 326 EmployeeEditUserLogin.jpg
13/09/2012  19:55            60 894 EmployeeEmployments.jpg
13/09/2012  19:55            56 940 EmployeeFindEmployee.jpg
13/09/2012  19:55           106 087 EmployeeLeave.jpg
13/09/2012  19:55            38 612 EmployeeListEmployments.jpg
13/09/2012  19:55            63 828 EmployeeListEmplPositions.jpg
13/09/2012  19:55            45 033 EmployeeNewEmployee.jpg
13/09/2012  19:55           115 534 EmployeeNewEmployee.png
13/09/2012  19:55            95 524 EmployeePartyPartyContentScreen.jpg
13/09/2012  19:55            54 072 EmployeePayrollHistory.jpg
13/09/2012  19:55            73 648 EmployeePositionEdit.jpg
13/09/2012  19:55            67 253 EmployeeProfile.jpg
13/09/2012  19:55            80 842 EmployeeProfileEditPersonalInformation.jpg
13/09/2012  19:55            71 256 EmployeeProfilePerson.jpg
13/09/2012  19:55           128 141 EmployeeProfileTest.jpg
13/09/2012  19:55            79 378 EmployeeQualfication.jpg
13/09/2012  19:55            56 940 EmployeesFindEmployee.jpg
13/09/2012  19:55            63 174 EmployeeSkills.jpg
13/09/2012  19:55            98 422 EmployeesMain.jpg
13/09/2012  19:55            65 118 EmployeeTraining.jpg
13/09/2012  19:55            93 143 EmploymentAgreementEmploymentApp.jpg
13/09/2012  19:55            55 299 EmploymentApplicationNew.jpg
13/09/2012  19:55           111 976 EmploymentApplicationSearch.jpg
13/09/2012  19:55            55 445 EmploymentCreateEmployment.jpg
13/09/2012  19:55            79 736 EmploymentCreatePartyBenefit.jpg
13/09/2012  19:55            73 977 EmploymentcreateUnemploymentClaim.jpg
13/09/2012  19:55            58 353 EmploymentEdit.jpg
13/09/2012  19:55            95 339 EmploymentEditAgreementEmploymentAppls.jpg
13/09/2012  19:55           117 628 EmploymentEmplPositionView.jpg
13/09/2012  19:55            90 103 EmploymentMain.jpg
13/09/2012  19:55            47 088 EmploymentNew.jpg
13/09/2012  19:55            40 019 EmploymentNewEmployment.jpg
13/09/2012  19:55            89 225 EmploymentNewEmployment.png
13/09/2012  19:55            79 724 EmploymentPartyBenefits.jpg
13/09/2012  19:55            56 112 EmploymentPayHistories.jpg
13/09/2012  19:55            96 664 EmploymentPayrollPreferences.jpg
13/09/2012  19:55            91 982 EmploymentSearch.jpg
13/09/2012  19:55            83 520 EmploymentUnemploymentClaims.jpg
13/09/2012  19:55           111 874 FindEmployeeSkills.jpg
13/09/2012  19:55            76 263 GlobalHRSettingsEditEditSkills.jpg
13/09/2012  19:55            60 487 GlobalHRSettingsEditPositionTypes.jpg
13/09/2012  19:55            99 848 GlobalHRSettingsEditQualificationGroups.jpg
13/09/2012  19:55            98 163 GlobalHRSettingsEditQualifications.jpg
13/09/2012  19:55           117 682 GlobalHRSettingsEditSkillGroups.jpg
13/09/2012  19:55           149 273 GlobalHRSettingsEditSkills.jpg
13/09/2012  19:55            80 409 GlobalHRSettingsEmployeeLeaveType.jpg
13/09/2012  19:55            77 968 GlobalHRSettingsJobInterviewType.jpg
13/09/2012  19:55            23 309 GlobalHRSettingsMenu.jpg
13/09/2012  19:55            60 769 GlobalHRSettingsPayGradesEdit.jpg
13/09/2012  19:55            55 530 GlobalHRSettingsPayGradesNew.jpg
13/09/2012  19:55            69 092 GlobalHRSettingsPayGradesSalaryStep.jpg
13/09/2012  19:55            76 761 GlobalHRSettingsPayGradesSearch.jpg
13/09/2012  19:55            60 020 GlobalHRSettingsPositionTypeEdit.jpg
13/09/2012  19:55            55 445 GlobalHRSettingsPositionTypeNew.jpg
13/09/2012  19:55            88 727 GlobalHRSettingsPositionTypeRates.jpg
13/09/2012  19:55            79 333 GlobalHRSettingsPositionTypeSearch.jpg
13/09/2012  19:55            79 745 GlobalHRSettingsPublicHoliday.jpg
13/09/2012  19:55            70 506 GlobalHRSettingsReasonType.jpg
13/09/2012  19:55            88 340 GlobalHRSettingsResponsibilitylTypes.jpg
13/09/2012  19:55            83 031 GlobalHRSettingsSkillTypes.jpg
13/09/2012  19:55            64 209 GlobalHRSettingsTerminationReason.jpg
13/09/2012  19:55            70 209 GlobalHRSettingsTerminationTypes.jpg
13/09/2012  19:55            82 900 GlobalHRSettingsTraininClassType.jpg
13/09/2012  19:55           216 768 HelpPerformanceReview1.jpg
13/09/2012  19:55           308 538 HelpPerformanceReview2.jpg
13/09/2012  19:55           372 639 HelpRoadmap.jpg
13/09/2012  19:55           148 565 HROrganizationProfile.jpg
13/09/2012  19:55            71 966 Introduction.jpg
13/09/2012  19:55            59 349 LeaveApproval.jpg
13/09/2012  19:55            97 920 LeaveApprovalSearch.jpg
13/09/2012  19:55            66 481 LeaveEmployeeEdit.jpg
13/09/2012  19:55            56 468 LeaveEmployeeNew.jpg
13/09/2012  19:55            86 328 LeaveEmployeeSearch.jpg
13/09/2012  19:55            35 186 MainCompanyTreeView.jpg
13/09/2012  19:55            80 358 NewEmployee.jpg
13/09/2012  19:55            57 197 OFBizMainScreen.gif
13/09/2012  19:55             3 485 ofbiz_logo.gif
13/09/2012  19:55           114 230 OrganizatinMain.jpg
13/09/2012  19:55            28 318 PartyManagerAddPartyRelationship.jpg
13/09/2012  19:55           121 046 PartyManagerPartyFinancialHistory.jpg
13/09/2012  19:55            65 644 PerformanceReviewEdit.jpg
13/09/2012  19:55            52 138 PerformanceReviewEditPerfReview.jpg
13/09/2012  19:55            72 319 PerformanceReviewEditPerfReviewItems.jpg
13/09/2012  19:55           249 935 PerformanceReviewHelp1.jpg
13/09/2012  19:55            60 942 PerformanceReviewItem.jpg
13/09/2012  19:55            99 832 PerformanceReviewNew.jpg
13/09/2012  19:55            90 206 PerformanceReviewNew.png
13/09/2012  19:55            74 802 PerformanceReviewSearch.jpg
13/09/2012  19:55            71 302 PositionEdit.jpg
13/09/2012  19:55            63 075 PositionFulfillments.jpg
13/09/2012  19:55           105 749 PositionMain.jpg
13/09/2012  19:55            57 819 PositionNew.jpg
13/09/2012  19:55           102 287 PositionReportingStruct.jpg
13/09/2012  19:55            68 346 PositionResponsibilities.jpg
13/09/2012  19:55           123 829 PositionSearch.jpg
13/09/2012  19:55            99 013 PositionSummary.jpg
13/09/2012  19:55            93 130 PositionSummaryReportingStruct.jpg
13/09/2012  19:55            46 242 QualificationsCreatePartyQual.jpg
13/09/2012  19:55            87 017 QualificationsEdit.jpg
13/09/2012  19:55            84 138 QualificationsFindPartyQuals.jpg
13/09/2012  19:55            56 355 QualificationsNew.jpg
13/09/2012  19:55            56 355 QualificationsNewPartyQual.jpg
13/09/2012  19:55            84 138 QualificationsSearch.jpg
13/09/2012  19:55            89 426 RecuritmentFindApprovals.jpg
13/09/2012  19:55            55 668 RecuritmentFindInternalJobPosting.jpg
13/09/2012  19:55            55 668 RecuritmentFindJobInterview.jpg
13/09/2012  19:55            91 025 RecuritmentFindRelocation.jpg
13/09/2012  19:55            52 097 RecuritmentInternalJobPostingNew.jpg
13/09/2012  19:55            75 849 RecuritmentInternalJobPostingSearch.jpg
13/09/2012  19:55            76 404 RecuritmentJobApprovalSearch.jpg
13/09/2012  19:55            73 065 RecuritmentJobInterviewEdit.jpg
13/09/2012  19:55            64 468 RecuritmentJobInterviewNew.jpg
13/09/2012  19:55            86 263 RecuritmentJobInterviewSearch.jpg
13/09/2012  19:55            75 565 RecuritmentJobPostingSearch.jpg
13/09/2012  19:55            81 454 RecuritmentJobRelocationSearch.jpg
13/09/2012  19:55            55 668 RecuritmentJobRequisitionApply.jpg
13/09/2012  19:55            76 702 RecuritmentJobRequisitionEdit.jpg
13/09/2012  19:55            65 688 RecuritmentJobRequisitionNew.jpg
13/09/2012  19:55           104 256 RecuritmentJobRequisitionSearch.jpg
13/09/2012  19:55            47 336 ResumeEdit.jpg
13/09/2012  19:55            46 762 ResumeNew.jpg
13/09/2012  19:55            69 710 ResumeSearch.jpg
13/09/2012  19:55            35 219 SkillsAddEmployeeSkills.jpg
13/09/2012  19:55            68 568 SkillsEdit.jpg
13/09/2012  19:55            69 624 SkillsEditEmployeeSkills.jpg
13/09/2012  19:55           110 250 SkillsFindEmployeeSkills.jpg
13/09/2012  19:55            57 509 SkillsFindPartySkills.jpg
13/09/2012  19:55            47 342 SkillsNew.jpg
13/09/2012  19:55            35 219 SkillsNewPartySkill.jpg
13/09/2012  19:55           122 691 SkillsSearch.jpg
13/09/2012  19:55            77 691 TrainingCalendar.jpg
13/09/2012  19:55            97 165 TrainingCalendarAdd.jpg
13/09/2012  19:55           102 032 TrainingCalendarAddParticipant.jpg
13/09/2012  19:55           112 460 TrainingCalendarApprovals.jpg
13/09/2012  19:55            43 397 TrainingCalendarEditTrainingApprovals.jpg
13/09/2012  19:55           111 599 TrainingCalendarFindTrainingStatus.jpg
13/09/2012  19:55            52 809 TrainingCalendarTrainingCalendar.jpg
             148 fichier(s)       12 150 157 octets

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\images_manufacturing_en

07/10/2012  19:38    <REP>          .
07/10/2012  19:38    <REP>          ..
26/09/2012  16:57            49 762 MANUFACTURING_BomSimulation.jpg
26/09/2012  16:57            46 432 MANUFACTURING_CreateProductionRun.jpg
26/09/2012  16:57            59 930 MANUFACTURING_EditCalendar.jpg
26/09/2012  16:57            69 668 MANUFACTURING_EditCalendarExceptionDay.jpg
26/09/2012  16:57            70 113 MANUFACTURING_EditCalendarExceptionWeek.jpg
26/09/2012  16:57            83 905 MANUFACTURING_EditCalendarWeek.jpg
26/09/2012  16:57            73 515 MANUFACTURING_EditCostCalcs.jpg
26/09/2012  16:57           113 965 MANUFACTURING_EditProductBom.jpg
26/09/2012  16:57           132 448 MANUFACTURING_EditProductionRun.jpg
26/09/2012  16:57            67 983 MANUFACTURING_EditProductManufacturingRules.jpg
26/09/2012  16:57            44 656 MANUFACTURING_EditRouting.jpg
26/09/2012  16:57            53 944 MANUFACTURING_EditRoutingProductLink.jpg
26/09/2012  16:57            61 874 MANUFACTURING_EditRoutingTask.jpg
26/09/2012  16:57            66 723 MANUFACTURING_EditRoutingTaskAssoc.jpg
26/09/2012  16:57            56 376 MANUFACTURING_EditRoutingTaskCosts.jpg
26/09/2012  16:57            53 525 MANUFACTURING_EditRoutingTaskFixedAssets.jpg
26/09/2012  16:57            36 207 MANUFACTURING_EditRoutingTaskProduct.jpg
26/09/2012  16:57            60 789 MANUFACTURING_FindBom.jpg
26/09/2012  16:57            54 051 MANUFACTURING_FindCalendar.jpg
26/09/2012  16:57            82 767 MANUFACTURING_FindMrpPlannedEvents.jpg
26/09/2012  16:57            64 622 MANUFACTURING_FindProductionRun.jpg
26/09/2012  16:57            70 631 MANUFACTURING_FindRouting.jpg
26/09/2012  16:57           127 927 MANUFACTURING_FindRoutingTask.jpg
26/09/2012  16:57            51 149 MANUFACTURING_ListCalendarWeek.jpg
26/09/2012  16:57            47 283 MANUFACTURING_ListRoutingTaskProducts.jpg
26/09/2012  16:57            57 762 MANUFACTURING_main.jpg
26/09/2012  16:57            25 967 MANUFACTURING_ManufacturingReports.jpg
26/09/2012  16:57            35 511 MANUFACTURING_MrpExecution.jpg
26/09/2012  16:57            64 559 MANUFACTURING_ProductionRunActualComponents.jpg
26/09/2012  16:57            66 879 MANUFACTURING_ProductionRunAssocs.jpg
26/09/2012  16:57            81 530 MANUFACTURING_ProductionRunComponents.jpg
26/09/2012  16:57            78 407 MANUFACTURING_ProductionRunContent.jpg
26/09/2012  16:57            94 047 MANUFACTURING_ProductionRunCosts.jpg
26/09/2012  16:57           122 771 MANUFACTURING_ProductionRunDeclaration.jpg
26/09/2012  16:57            94 261 MANUFACTURING_ProductionRunFixedAssets.jpg
26/09/2012  16:57           101 102 MANUFACTURING_ProductionRunTasks.jpg
26/09/2012  16:57            29 436 MANUFACTURING_WorkWithShipmentPlans.jpg
              37 fichier(s)        2 552 477 octets

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\images_manufacturing_nl

07/10/2012  19:38    <REP>          .
07/10/2012  19:38    <REP>          ..
26/09/2012  16:57            49 179 MANUFACTURING_BomSimulation.jpg
26/09/2012  16:57            42 583 MANUFACTURING_CreateProductionRun.jpg
26/09/2012  16:57            49 782 MANUFACTURING_EditCalendar.jpg
26/09/2012  16:57            60 881 MANUFACTURING_EditCalendarExceptionDay.jpg
26/09/2012  16:57            59 272 MANUFACTURING_EditCalendarExceptionWeek.jpg
26/09/2012  16:57            74 864 MANUFACTURING_EditCalendarWeek.jpg
26/09/2012  16:57            74 596 MANUFACTURING_EditCostCalcs.jpg
26/09/2012  16:57           119 329 MANUFACTURING_EditProductBom.jpg
26/09/2012  16:57           139 453 MANUFACTURING_EditProductionRun.jpg
26/09/2012  16:57            65 076 MANUFACTURING_EditProductManufacturingRules.jpg
26/09/2012  16:57            44 138 MANUFACTURING_EditRouting.jpg
26/09/2012  16:57            55 483 MANUFACTURING_EditRoutingProductLink.jpg
26/09/2012  16:57            60 393 MANUFACTURING_EditRoutingTask.jpg
26/09/2012  16:57            70 629 MANUFACTURING_EditRoutingTaskAssoc.jpg
26/09/2012  16:57            54 221 MANUFACTURING_EditRoutingTaskCosts.jpg
26/09/2012  16:57            55 587 MANUFACTURING_EditRoutingTaskFixedAssets.jpg
26/09/2012  16:57            35 297 MANUFACTURING_EditRoutingTaskProduct.jpg
26/09/2012  16:57            57 000 MANUFACTURING_FindBom.jpg
26/09/2012  16:57            50 575 MANUFACTURING_FindCalendar.jpg
26/09/2012  16:57            78 592 MANUFACTURING_FindMrpPlannedEvents.jpg
26/09/2012  16:57            65 139 MANUFACTURING_FindProductionRun.jpg
26/09/2012  16:57            70 572 MANUFACTURING_FindRouting.jpg
26/09/2012  16:57           127 711 MANUFACTURING_FindRoutingTask.jpg
26/09/2012  16:57            47 493 MANUFACTURING_ListCalendarWeek.jpg
26/09/2012  16:57            45 736 MANUFACTURING_ListRoutingTaskProducts.jpg
26/09/2012  16:57            61 465 MANUFACTURING_main.jpg
26/09/2012  16:57            26 586 MANUFACTURING_ManufacturingReports.jpg
26/09/2012  16:57            33 244 MANUFACTURING_MrpExecution.jpg
26/09/2012  16:57            65 740 MANUFACTURING_ProductionRunActualComponents.jpg
26/09/2012  16:57            59 322 MANUFACTURING_ProductionRunAssocs.jpg
26/09/2012  16:57            71 983 MANUFACTURING_ProductionRunComponents.jpg
26/09/2012  16:57            69 973 MANUFACTURING_ProductionRunContent.jpg
26/09/2012  16:57            80 918 MANUFACTURING_ProductionRunCosts.jpg
26/09/2012  16:57           126 255 MANUFACTURING_ProductionRunDeclaration.jpg
26/09/2012  16:57            85 500 MANUFACTURING_ProductionRunFixedAssets.jpg
26/09/2012  16:57            89 068 MANUFACTURING_ProductionRunTasks.jpg
26/09/2012  16:57            26 308 MANUFACTURING_WorkWithShipmentPlans.jpg
              37 fichier(s)        2 449 943 octets

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\images_projectmgr_en

07/10/2012  19:38    <REP>          .
07/10/2012  19:38    <REP>          ..
22/09/2012  16:31            76 504 PROJECTMGR_EditProject.jpg
22/09/2012  16:31            77 067 PROJECTMGR_FindResource.jpg
22/09/2012  16:31           116 583 PROJECTMGR_FindTask.jpg
22/09/2012  16:31            73 441 PROJECTMGR_FindTimeSheet.jpg
22/09/2012  16:31            50 691 PROJECTMGR_main.jpg
22/09/2012  16:31            93 444 PROJECTMGR_MyTasks.jpg
22/09/2012  16:31           142 929 PROJECTMGR_projectView.jpg
22/09/2012  16:31           184 454 PROJECTMGR_RequestList.jpg
22/09/2012  16:31           225 073 requestlist.jpg
22/09/2012  16:31            76 281 ROJECTMGR_EditSkillTypes.jpg
22/09/2012  16:31            70 608 ROJECTMGR_FindProject.jpg
22/09/2012  16:31           109 154 ROJECTMGR_MyTasks.jpg
22/09/2012  16:31            81 875 ROJECTMGR_MyTimesheet.jpg
              13 fichier(s)        1 378 104 octets

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\manufacturing_en

07/10/2012  19:38    <REP>          .
07/10/2012  19:38    <REP>          ..
26/09/2012  17:08            25 960 manufacturing.xml
               1 fichier(s)           25 960 octets

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\manufacturing_nl

07/10/2012  19:38    <REP>          .
07/10/2012  19:38    <REP>          ..
26/09/2012  17:08            28 867 manufacturing.xml
               1 fichier(s)           28 867 octets

 Répertoire de D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\projectmgr_en

07/10/2012  19:38    <REP>          .
07/10/2012  19:38    <REP>          ..
22/09/2012  20:32            14 199 project.xml
22/09/2012  20:32            14 460 projectmgr.xml
               2 fichier(s)           28 659 octets

     Total des fichiers listés :
             242 fichier(s)       19 273 439 octets
              32 Rép(s)  50 082 443 264 octets libres
{code}

Actually that's what I already reported after failing following the point 5 instructions
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13472426#comment-13472426 ]

Tom Burns commented on OFBIZ-4941:
----------------------------------

Jacques,

Good, I guess there are no more issues.

Note a fix is needed relating to -
Rev 1361130
Moved the "birt" component out of framework to specialpurpose; moved all the birt reports from the applications to the birt component itself, where the _*application webapps are overriden to inject the reports*_; the end result is the same but since all these birt reports are simply a proof of concepts that cannot be used in production (for example they use hardcoded userlogin for authentication) the birt component should be probably disabled by default (but this will be discussed in the dev list).
Now it will be very easy to extract the birt component (for OFBiz Extras) or to disable it when deploying to production or when interested in sparing some hardware resources. I did some cursory tests but since the work has been challenging and rather complex I would appreciate testing help and also reviews to finds chunks of code that I could have missed and that could be moved out as well.

I've added a patch to OFBIZ-5033 that simply places remarks around the problem code. Others may have a better solution.

Tom
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

     [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Jacques Le Roux updated OFBIZ-4941:
-----------------------------------

    Attachment: content.7z

No sorry I still get the same. I attach here a zipped export of the content component w/out the libs (content.7z) for you to compare, will be the easiest way I guess ;)
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13472545#comment-13472545 ]

Tom Burns commented on OFBIZ-4941:
----------------------------------

Jacques,

To build the help apps from content.7z:
1. Add the help files to the data directory applications/content/data/helpdata/docbookhelp/...

2. Add saxon.jar to the web app root applications/content/template/docbook/webhelp/saxon.jar
Note use the jar in the WebhelpFiles\webhelp\saxon.jar some later implementations do not work and may have licensing issues.

3. Run the build targets:
content\content\content\template\docbook\webhelp>ant webhelp.accounting
content\content\content\template\docbook\webhelp>ant webhelp.humanres
etc.

Tom

               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473010#comment-13473010 ]

Jacques Le Roux commented on OFBIZ-4941:
----------------------------------------

Tom,

PS: look at then end of this comment, I kept above for the fun...

----
Mmm... I think I really need some vacation. I did not add these files in svn, so there were on my disk at the right places but not in the working copy, hence not in the export :(

I added all but
template/docbook/webhelp/test-output
webapp/ofbizhelp and its content
since those are generated and I guess should not be committed right?

Anyway when I add them the zipped file is too large to be imported here.

The help files are already in the data directory applications/content/data/helpdata/docbookhelp/...
This is obvious when you look at the result of the build I tried and pasted in comments above, here is my last try, same than before
{code}
D:\workspace\ofbizClean\applications\content\template\docbook\webhelp>ant webhelp.accounting
Buildfile: D:\workspace\ofbizClean\applications\content\template\docbook\webhelp\build.xml

clean.accounting:
   [delete] Deleting directory D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en

chunk.accounting:
    [mkdir] Created dir: D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en
     [xslt] Processing D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\accounting_en\accounting.xml to D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en\null12
9158762
     [xslt] Loading stylesheet D:\workspace\ofbizClean\applications\content\template\docbook\profiling\profile.xsl
     [xslt] Processing D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en\null129158762 to D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en\null1442042200
     [xslt] Loading stylesheet D:\workspace\ofbizClean\applications\content\template\docbook\webhelp\xsl\webhelp.xsl
     [xslt] Failed to process D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en\null129158762

BUILD FAILED
D:\workspace\ofbizClean\applications\content\template\docbook\webhelp\build.xml:143: javax.xml.transform.TransformerException: [start prefix mapping event]: uri is an empty string.
{code}

You already asked me about the saxon file:
{quote}
Do you have the saxon.jar in applications/content/template/docbook/webhelp ?
Tom
{quote}
And I replied [in the comment above|https://issues.apache.org/jira/browse/OFBIZ-4941?focusedCommentId=13471429&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-13471429]

----

Arg and you know what: it seems to work from Eclipse when running an ant target in Debug mode!!! I don't know why, but at least a track...

Ha looking at the trace, it could maybe be what I feared from start. You see the line
*[xslt] language: en*
Mine would be French (fr) from command line. Not sure it's that, but a track in the track...
{code}
Buildfile: D:\workspace\ofbizClean\applications\content\template\docbook\webhelp\build.xml
clean.accounting:
   [delete] Deleting directory D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en
chunk.accounting:
    [mkdir] Created dir: D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en
     [xslt] Processing D:\workspace\ofbizClean\applications\content\data\helpdata\docbookhelp\accounting_en\accounting.xml to D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en\null2088187697
     [xslt] Loading stylesheet D:\workspace\ofbizClean\applications\content\template\docbook\profiling\profile.xsl
     [xslt] Processing D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en\null2088187697 to D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en\null949819810
     [xslt] Loading stylesheet D:\workspace\ofbizClean\applications\content\template\docbook\webhelp\xsl\webhelp.xsl
     [xslt] language: en
     [xslt] Note: namesp. cut : stripped namespace before processing           OFBiz Documentation
     [xslt] Note: namesp. cut : processing stripped document                   OFBiz Documentation
     [xslt] language: en
     [xslt] Writing ../../../webapp/ofbizhelp/accounting_en/content/ch01.html for chapter
     [xslt] Writing ../../../webapp/ofbizhelp/accounting_en/content/ACCOUNTING_main.html for chapter(ACCOUNTING_main)
     
[...]

[copy] Copying 93 files to D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en
index.accounting:
     [copy] Copying 1 file to D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en
     [copy] Copied 1 empty directory to 1 empty directory under D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en
     [copy] Copying 4 files to D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en
     [echo] Indexing html files in ../../../webapp/ofbizhelp/accounting_en/content
     [java] Stemming enabled
     [java] The created index files are located in ..\..\..\webapp\ofbizhelp\accounting_en\content\search\.js
     [java] Indexed the contents in 6 seconds
web-images-accounting:
    [mkdir] Created dir: D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en\images_accounting_en
     [copy] Copying 1 file to D:\workspace\ofbizClean\applications\content\webapp\ofbizhelp\accounting_en\images_accounting_en
webhelp.accounting:
BUILD SUCCESSFUL
Total time: 1 minute 37 seconds
{code}

Also, I see the help when running applications\content\webapp\ofbizhelp\accounting_en\index.html but I don't see it from accounting application using the help button, is another step missing?
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473011#comment-13473011 ]

Jacques Le Roux commented on OFBIZ-4941:
----------------------------------------

When I say I don't see the help, I mean I still see the old one
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473059#comment-13473059 ]

Jacques Le Roux commented on OFBIZ-4941:
----------------------------------------

OK, I found the reason, I needed to run from OFBiz root:

"C:\Program Files\Java\jdk1.6.0_22\bin\java" -jar D:/workspace\ofbizClean/framework/base/lib/ant-launcher-1.8.4.jar -lib framework/base/lib/ant webhelp.humanres

works

So now the question is more how to integrate these targets to the globalbuild. They are resource eager (more or less 1 min on my machine for each). A perfect way would be to run them with the global build, but only when changes in content (or only applications\content\data\helpdata\docbookhelp?) would be detected...
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473074#comment-13473074 ]

Jacques Le Roux commented on OFBIZ-4941:
----------------------------------------

What is the ant target
webhelp                   Native test webhelp target
useful for? Should it be part of the OFBiz tests?
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473081#comment-13473081 ]

Jacques Le Roux commented on OFBIZ-4941:
----------------------------------------

Not sure if this is important or not, found this when running the test target:

D:\workspace\ofbizClean\applications\content\template\docbook\webhelp\xsl\webhelp-common.xsl:317:18: Warning! language: en
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473207#comment-13473207 ]

Tom Burns commented on OFBIZ-4941:
----------------------------------

Good Morning Jacques,

The webhelp target is the demo site for webhelp.
Running the task the creates a demo web site that can be invoked from:
applications/content/template/docbook/webhelp/docs/index.html

If you open that site you will find help info on "Stemmers" see:
Developer Docs > Search > New Stemmers

It has a note:
"Make sure you changed the webhelp.indexer.language property in build.properties to your language."

The message you received "Warning! language: en" traces to the line
    <xsl:message>language: <xsl:value-of select="$webhelp.indexer.language"/> </xsl:message>

Long story short, help developers in other languages need to be aware of this impact on search indexing.

I would leave the task for webhelp in the build file because there is a lot of useful information in the sample app and it takes little space.

Tom

               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473303#comment-13473303 ]

Tom Burns commented on OFBIZ-4941:
----------------------------------

Jacques,

Is everything running now in your test environment so the only issue is deployment? If so a thought on integration with the globalbuild.

My preference would be to distribute the help fully deployed so help works OOTB. What's a few more meg these days? I intentionally did not integrate the the targets to the global-build. The help developer can run the task as needed.

In the end though this is up to you.

Tom
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473308#comment-13473308 ]

Jacques Le Roux commented on OFBIZ-4941:
----------------------------------------

Yes agreed, I'm now more concerned by the build integration ;)
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473308#comment-13473308 ]

Jacques Le Roux edited comment on OFBIZ-4941 at 10/10/12 3:37 PM:
------------------------------------------------------------------

== CROSSED On WIRE ==
^Yes agreed, I'm now more concerned by the build integration ;)

Your last comment: Yes maybe the better solution indeed, with warning. Anyway we should really discuss that with the team on the dev ML, I let you fire 1st :)
               
      was (Author: jacques.le.roux):
    Yes agreed, I'm now more concerned by the build integration ;)
                 

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473328#comment-13473328 ]

Tom Burns commented on OFBIZ-4941:
----------------------------------

Jacques,

You will have to discuss with the dev ML. I am not a member.
Every time I reply to the confirmation email using any of the suggested response methods I get (n).

The confirm subscribe return message begins:

Sorry, we were unable to deliver your message to the following address.

<[hidden email]>:
Remote host said: 552 spam score (7.5) exceeded threshold...

Tom
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473378#comment-13473378 ]

Jacques Le Roux commented on OFBIZ-4941:
----------------------------------------

You answer in plain text I guess?
Which email client are you using?
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473494#comment-13473494 ]

Tom Burns commented on OFBIZ-4941:
----------------------------------

Well...

I gave it another try and happy days now I'm on everything - commits, digest, high traffic... yada yada.

Einstein's definition of insanity - "Doing the same thing and expecting..." bunk!

I'll post something in the morning.

Tom
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473540#comment-13473540 ]

Jacques Le Roux commented on OFBIZ-4941:
----------------------------------------

Could be that they changed the Spamassassin rules...
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13473556#comment-13473556 ]

Tom Burns commented on OFBIZ-4941:
----------------------------------

Or just a coincidence - may be?
A sequence of events that although accidental seems to have been planned or arranged.
or
http://www.coincidencemaybe.com/fr_home.cfm
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

[Nicolas Malin (Jira)]

    [ https://issues.apache.org/jira/browse/OFBIZ-4941?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13474687#comment-13474687 ]

Tom Burns commented on OFBIZ-4941:
----------------------------------

Jacques,

The naming conventions used for image files and docbook xml id's have to be adjusted to support components with multiple web apps.

The problem exist in the current help system. For example opening help from the Catalog and Facility main page opens the same help file since the file is keyed on the component product not the web app.

I will have to replace the files in the attached WebhelpFiles and WebhelpHRAppDocbook.

Tom
               

> Proposal for a new help system
> ------------------------------
>
>                 Key: OFBIZ-4941
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-4941
>             Project: OFBiz
>          Issue Type: Wish
>          Components: ALL COMPONENTS
>    Affects Versions: SVN trunk
>            Reporter: Jacques Le Roux
>            Priority: Minor
>             Fix For: SVN trunk
>
>         Attachments: content.7z, docbook diff.patch, docbook-xsl-1.77.1.zip, HelpAccounting.jpg, help_content.jpg, help_ofbizhelp.jpg, helppdf.zip, HelpPerformanceReview1.jpg, HelpPerformanceReview2.jpg, HelpRoadmap.jpg, help_webhlep.jpg, jh.jar, LICENSE.html, OFBIZ-4941 POC HR Help.patch, WebhelpFiles.zip, WebhelpHRAppDocbook.zip, webhelp.jpg
>
>
> Quoting Tom Burns at OFBIZ-4869
> {quote}
> This is a status update just to let anyone who is interested know that this item is being worked on.
> I started out using the OFBiz structure for help docs but after a while I needed/wanted something more expressive.
> Here is what I wound up using for development:
>     Java Help System http://java.net/projects/javahelp/content
>     DocBook 5: The Definitive Guide
>     http://www.docbook.org/tdg5/en/html/docbook.html
>     http://www.docbook.org/xml/5.0/
>     DocBook XSL: The Complete Guide
>     http://www.sagehill.net/docbookxsl/index.html
>     http://sourceforge.net/projects/docbook/files/docbook-xsl/1.77.1/docbook-xsl-1.77.1.zip
>     Help Master - FE for managing java help files. Best feature drag and drop TOC creates TOC matching file folder structure. Convenient launcher for viewing & testing. http://www.halogenware.com/software/helpmaster.html
>     XML Mind XML Editor - Free Personal Edition is far better then editing in Eclipse. download from http://www.xmlmind.com/xmleditor/download.shtml
>     Tutorial - DocBook editing with XML Mind XML Editor. Worth going through http://www.xmlmind.com/xmleditor/tutorial.html
>     Read Me First style guide from Sun (cost from Amazon 1 cent + shipping)
> Attached are some screen shots of the results.
> Every screen is/will be documented in a similar structure. This is as much for defining requirements and testing as for help. More work but worth it.
> The screenshots show a Java Help format generated using DocBook XSL. This will likely not be the final presentation format.
> Note the Performance Review screen shots do not match the trunk. There is a bug in update screen and I did some clean up of labels and drop-down list. There are issues like this all through the application so I did not want to get bogged down with patches at this time.
> {quote}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira