I believe that the work for the asciidoc documentation is ready!
Please, check this generated asciidcotor page:
http://deltaspike.apache.org/documentation/container-control-test.html
The branch with the source code is here:
https://github.com/rafabene/deltaspike/tree/documentation/documentation
Em 8/27/14, 18:14, Rafael Benevides escreveu:
Yeap. I have to agree with you.
So I've changed my strategy...
I've taken your PoC and made some minor modifications and place it on
my branch:
https://github.com/rafabene/deltaspike/tree/documentation/documentation
Note that I'm using the agreed path for documentation folder and that
I also included a Readme.md that instructs how to setup the
credentials on ~/.m2/settings.xml and what maven command that should
be used to deploy.
The result was published here:
http://deltaspike.apache.org/documentation/container-control-test.html
What is missing now is the generated html template/styles.
Em 8/27/14, 17:23, John D. Ament escreveu:
IMHO, the current approach is a bit safer and more testable. running
mvn site will generate the asciidoc. That would be a bit harder to
do if we need to support running it as a part of a staging pull.
On Wed, Aug 27, 2014 at 4:14 PM, Rafael Benevides
<[email protected] <mailto:[email protected]>> wrote:
I was trying to avoid two steps to deploy:
1 - mvn site-deploy on git repo to copy it to the CMS staging are
2 - CMS deploy to publish it
But I think that should not be a problem, Right?
So what I'll do now, based on your PoC is to make the templates of
the generated html to be close to deltaspike site style.
Em 8/27/14, 17:10, John D. Ament escreveu:
Rafael,
This shouldn't be needed any longer. Based on what I did, we can
now do a mvn site-deploy to copy everything into the CMS staging
area. Once verified go into CMS and do a publish.
John
On Wed, Aug 27, 2014 at 3:57 PM, Rafael Benevides
<[email protected] <mailto:[email protected]>> wrote:
Hi all,
This email is just to give a feedback about making CMS to
work with Github and Asciidoc.
Finally I was able to understand enough how CMS works and
probably I'm stopped where John Ament was.
What I'm doing now is writing a GitUtil Perl Module that will
be hosted at
http://svn.apache.org/repos/asf/deltaspike/site/trunk/lib/
that will be responsible for cloning the documentation (on
deltaspike git repo) and then another module will run the
build (asciidoc to html) just for [<git_root>/documentation/].
The idea is that the final documentation gets hosted at
deltaspike.apache.org/documentation/
<http://deltaspike.apache.org/documentation/> (note the sub
folder).
Further steps: Prepare a template so asciidoc generated html
uses the same style of deltaspike.apache.org
<http://deltaspike.apache.org>.
Well, the idea here is to make everyone aware about this and
also say that if is there anybody if Perl knowledge, you're
welcome to give some hints!
Thanks
--
*Rafael Benevides | Senior Software Engineer*
JBoss Developer
M: +55-61-9269-6576 <tel:%2B55-61-9269-6576>
Red Hat
Better technology. Faster innovation. Powered by community
collaboration.
See how it works at www.redhat.com <http://www.redhat.com/>
LinkedIn <http://www.linkedin.com/company/3258288> Youtube
<https://www.youtube.com/redhatlatam>
