| [epf-dev] Some help wanted with command line publishing for epf.eclipse.org |
Hi all,
I am working on the integration of the command line publishing for http://epf.eclipse.org. The idea behind this work is to make it very easy to update the Wiki sites. It will be just a matter of selecting a library, configuration and version (tag or HEAD) from CVS. EPF Wiki will then do the checkout and publish, create the baseline process and update the wiki. No need to do it yourself manually from EPFC: checkout, publish, zip, upload to epf.eclips.org and then schedule an update.
If you want this in a new release of EPF Wiki, please vote for this bugzilla https://bugs.eclipse.org/bugs/show_bug.cgi?id=261167.
To be able to implement this feature for http://epf.eclipse.org I need some help. I want to know the configurations we want publish and the publishing options. Secondly I am sure how these publishing options are translated to the command line switches. I need some help filling in the blanks.
In CVS we have the following libraries:
1 - org.eclipse.epf/libraries/EPF_Practices
2 - org.eclipse.epf/libraries/OpenUP
3 - org.eclipse.epf/libraries/XP
4 - org.eclipse.epf/libraries/Scrum
5 - org.eclipse.epf/libraries/MAM_Practices
>From these libraries we want to publish the following configurations I think:
1: publish.all_epf_practices; publish.openup
4: Scrum Overview
5: publish.mdev.auth.mam_for_epl
(2 is no longer used, we are publishing openup from 1 and 3 needs to be upgraded)
For all configurations we want to publish I would like to know the publishing options so at the bottom of this email I have included all configurations with the publishing options. For all these options I would also like to know how to translate these to command line switches. I know some of them but not all. I think that not all publishing options can be set on the command line, this might be an issue but maybe the defaults are okay.
BTW this all made me think again it would be a nice addition to EPFC if the publishing options would be stored in the configuration and in CVS. This would simplify the command line and manual publish.
Thanks in advance,
Onno
The required and optional options are:
Required:
-libraryPath <path to method library>
-publishPath <path to publish to>
-config <configuration to select from library>
Optional:
-about <about html file>
-banner <banner image>
-bannerHeight <banner image height>
-checkLinks
-dynamic <name>
-feedback <feedback url>
-glossary
-index
-publishUnverifiedDiagrams
-title <title for published pages>
I'm unsure about:
-dynamic <name>
-publishUnverifiedDiagrams
So for the publishing options this means, I'm unsure about:
Convert broken hyperlinks to plain text:
Diagrams:
Publish activity detail diagrams that have not been manually created: -publishUnverifiedDiagrams?
Publish activity diagrams for unmodified activity extensions: ?
Layout:
Show relationship sub-folders in navigation trees: ?
Show related elements for roles, tasks and work products in navigation trees: ?
Show task descriptors in navigation trees: ?
include method content in descriptor pages: ?
Publish process usage in role, task and work product pages linking to related desriptors: ?
Default tab for activity pages:
publish.all_epf_practices
=========================
Title:
About Content:
Feedback URL:
Publish Glossary: Yes/No
Publish Index: Yes/No
Banner Image:
Check external hyperlinks:
Convert broken hyperlinks to plain text:
Diagrams:
Publish activity detail diagrams that have not been manually created: Yes/No
Publish activity diagrams for unmodified activity extensions: Yes/No
Layout:
Show relationship sub-folders in navigation trees: Yes/No
Show related elements for roles, tasks and work products in navigation trees: Yes/No
Show task descriptors in navigation trees: Yes/No
include method content in descriptor pages: Yes/No
Publish process usage in role, task and work product pages linking to related desriptors: Yes/No
Default tab for activity pages:
publish.openup
==============
Title:
About Content:
Feedback URL:
Publish Glossary: Yes/No
Publish Index: Yes/No
Banner Image:
Check external hyperlinks:
Convert broken hyperlinks to plain text:
Diagrams:
Publish activity detail diagrams that have not been manually created: Yes/No
Publish activity diagrams for unmodified activity extensions: Yes/No
Layout:
Show relationship sub-folders in navigation trees: Yes/No
Show related elements for roles, tasks and work products in navigation trees: Yes/No
Show task descriptors in navigation trees: Yes/No
include method content in descriptor pages: Yes/No
Publish process usage in role, task and work product pages linking to related desriptors: Yes/No
Default tab for activity pages:
Scrum Overview
==============
Title:
About Content:
Feedback URL:
Publish Glossary: Yes/No
Publish Index: Yes/No
Banner Image:
Check external hyperlinks:
Convert broken hyperlinks to plain text:
Diagrams:
Publish activity detail diagrams that have not been manually created: Yes/No
Publish activity diagrams for unmodified activity extensions: Yes/No
Layout:
Show relationship sub-folders in navigation trees: Yes/No
Show related elements for roles, tasks and work products in navigation trees: Yes/No
Show task descriptors in navigation trees: Yes/No
include method content in descriptor pages: Yes/No
Publish process usage in role, task and work product pages linking to related desriptors: Yes/No
Default tab for activity pages:
publish.mdev.auth.mam_for_epl
==============
Title:
About Content:
Feedback URL:
Publish Glossary: Yes/No
Publish Index: Yes/No
Banner Image:
Check external hyperlinks:
Convert broken hyperlinks to plain text:
Diagrams:
Publish activity detail diagrams that have not been manually created: Yes/No
Publish activity diagrams for unmodified activity extensions: Yes/No
Layout:
Show relationship sub-folders in navigation trees: Yes/No
Show related elements for roles, tasks and work products in navigation trees: Yes/No
Show task descriptors in navigation trees: Yes/No
include method content in descriptor pages: Yes/No
Publish process usage in role, task and work product pages linking to related desriptors: Yes/No
Default tab for activity pages: