Le 27/06/2013 17:48, David Green a
écrit :
Alex,
By pulling the plug-in into Mylyn Docs do you mean into Mylyn
WikiText or something else?
I meant the Mylyn Docs repository https://github.com/eclipse/mylyn.docs
, so yep the WikiText project :)
We would welcome any contributions that make it easier to
augment the Mylyn WikiText generation capabilities. Providing a
way to generate EMF models and an easy way to use those with
generators sounds great.
With a contribution of this size introducing new technologies
such as EMF, we'll have to consider things like general
applicability, user features versus extensibility and API,
documentation, testing and maintenance.
Yes of course, from now on the documentation is inexistant (but it
would not take too much time to write, it should just contains a few
usage examples).
We have some tests ran with the mylyn Intent build, but of course
code coverage should be increased https://hudson.eclipse.org/hudson/job/mylyn-docs-intent-0.7-nightly/549/testReport/org.eclipse.mylyn.wikitext.textile.model.tests.unit.parsing/
In regards to API & maintenance, I wrote this bridge during my
internship, although it works I would like to refactor it a bit.
Notice that the plugin is not that big:
- markup bridge: 5 000 lines of code including more that 1500 lines
of EMF-generated code http://nemo.sonarsource.org/drilldown/measures/397381?metric=ncloc&rids%5B%5D=397383).
- markup.gen (HTML & PDF generators): 1 500 lines of code
including around 600 lines of EMF-generated code http://nemo.sonarsource.org/drilldown/measures/397381?metric=ncloc&rids%5B%5D=397384
And yes as the bridge introduces new dependencies, it would be
better to embed it inside a new & separated feature in Wikitext.
I'd love to see a more concrete description and proposal so
that we can explore further.
Ok do you want me to file a bugzilla? I don't want to "force" this
integration, the fact that it is in Mylyn Intent code suits me well,
I just thought that it could interest other people.
Best regards,
Alex
David
On Thu, Jun 27, 2013 at 8:28 AM, Alex
Lagarde <alex.lagarde@xxxxxxx>
wrote:
Hi guys,
for Mylyn Intent we had to develop a bridge allowing to
represent Wikitext-parsable content as EMF models (more
details here http://t.co/pCAi3aGYVO).
This is a work in progress, an it has not been heavily used
so it probably still contains bugs, but I think it would
make cense to pull this plugin (and maybe markup.gen, which
contains HTML & LaTeX generators based on these EMF
models) in mylyn.docs.
Then we could work together on the Metamodel and on the
parser so that it can fulfil all the community needs (e.g. https://bugs.eclipse.org/bugs/show_bug.cgi?id=409694#c5).
The main benefit that I see is that we could easilly write
generators allowing to go from Wikitext to any langage. For
instance I love the LaTeX rendering, but always have a hard
time writing LaTeX documents. If I could write my doc in
textile and get a nice LaTeX-based PDF export I'll be glad
:)
Best regards,
Alex
_______________________________________________
mylyn-docs-dev mailing list
mylyn-docs-dev@xxxxxxxxxxx
http://dev.eclipse.org/mailman/listinfo/mylyn-docs-dev
--
David Green
VP of Architecture, Tasktop
Committer, Eclipse Mylyn
+1-778-588-6896 ext. 115
_______________________________________________
mylyn-docs-dev mailing list
mylyn-docs-dev@xxxxxxxxxxx
http://dev.eclipse.org/mailman/listinfo/mylyn-docs-dev
|