You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ant.apache.org by J Pai <ja...@gmail.com> on 2017/05/25 04:12:34 UTC

Ivy website - fixing a Quickstart documentation live

What would be the process of having the live docs of Ivy project updated to fix/update an issue in the documentation[1]? 

The quickstart documentation refers to certain log files that get auto-generated during the doc build process. It looks like those log files weren’t uploaded and are resulting in a blank text area showing up. I can run the doc generation target locally (on 2.4.0 tag) and have someone upload those files and see if shows up fine.

[1] https://issues.apache.org/jira/browse/IVY-1542

-Jaikiran
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org

Re: Ivy website - fixing a Quickstart documentation live

Posted by Gintautas Grigelionis <g....@gmail.com>.
By the way... we'll need ant-ivy-site-styles
<https://github.com/apache/ant-ivy-site-styles>, too :-)

Gintas

Re: Ivy website - fixing a Quickstart documentation live

Posted by Gintautas Grigelionis <g....@gmail.com>.
The files mentioned in JIRA were absent for a couple of years. If they're
available, let's get them into the site repo, otherwise the css files must
be adjusted.

I remember there was a discussion about gitpubsub... perhaps if we
understand how current svnpubsub hooks are set up, going to gitpubsub
shouldn't be complicated. We'll need a dedicated repo to publish to
(ant-site-live), for starters, because that repo would aggregate publishing
from Ant, Ivy, and IvyDE. Then, we'll need a ant-site-source, and the
routines for getting parts of ant-site-live updated either from
ant-site-source or from documentation generated by builds for respective
project.

Gintas

2017-05-25 8:30 GMT+02:00 Jan Matèrne (jhm) <ap...@materne.de>:

> The whole site is in svn and a server process (svnpubsub i think) is
> getting
> the 'publish' files and pushing them to the webserver which brings them
> online.
>
> We havent thought about a migrating that to git in the last few years ;)
>
> If these files are really required, I could upload them.
>
>
> Jan
>
>
>
> > -----Ursprüngliche Nachricht-----
> > Von: Gintautas Grigelionis [mailto:g.grigelionis@gmail.com]
> > Gesendet: Donnerstag, 25. Mai 2017 06:29
> > An: Ant Developers List
> > Betreff: Re: Ivy website - fixing a Quickstart documentation live
> >
> > Is the documentation still in SVN? IVY-1542 is about site/sources/style
> > which is shared by Ivy and IvyDE. Are there any plans about migrating
> > this to Git and separating the source repo from publication repo?
> >
> > Gintas
> >
> > 2017-05-25 6:12 GMT+02:00 J Pai <ja...@gmail.com>:
> >
> > > What would be the process of having the live docs of Ivy project
> > > updated to fix/update an issue in the documentation[1]?
> > >
> > > The quickstart documentation refers to certain log files that get
> > > auto-generated during the doc build process. It looks like those log
> > > files weren’t uploaded and are resulting in a blank text area showing
> > > up. I can run the doc generation target locally (on 2.4.0 tag) and
> > > have someone upload those files and see if shows up fine.
> > >
> > > [1] https://issues.apache.org/jira/browse/IVY-1542
> > >
> > > -Jaikiran
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org For additional
> > > commands, e-mail: dev-help@ant.apache.org
> > >
> > >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> For additional commands, e-mail: dev-help@ant.apache.org
>
>

AW: Ivy website - fixing a Quickstart documentation live

Posted by "Jan Matèrne (jhm)" <ap...@materne.de>.
The whole site is in svn and a server process (svnpubsub i think) is getting
the 'publish' files and pushing them to the webserver which brings them online.

We havent thought about a migrating that to git in the last few years ;)

If these files are really required, I could upload them.


Jan



> -----Ursprüngliche Nachricht-----
> Von: Gintautas Grigelionis [mailto:g.grigelionis@gmail.com]
> Gesendet: Donnerstag, 25. Mai 2017 06:29
> An: Ant Developers List
> Betreff: Re: Ivy website - fixing a Quickstart documentation live
> 
> Is the documentation still in SVN? IVY-1542 is about site/sources/style
> which is shared by Ivy and IvyDE. Are there any plans about migrating
> this to Git and separating the source repo from publication repo?
> 
> Gintas
> 
> 2017-05-25 6:12 GMT+02:00 J Pai <ja...@gmail.com>:
> 
> > What would be the process of having the live docs of Ivy project
> > updated to fix/update an issue in the documentation[1]?
> >
> > The quickstart documentation refers to certain log files that get
> > auto-generated during the doc build process. It looks like those log
> > files weren’t uploaded and are resulting in a blank text area showing
> > up. I can run the doc generation target locally (on 2.4.0 tag) and
> > have someone upload those files and see if shows up fine.
> >
> > [1] https://issues.apache.org/jira/browse/IVY-1542
> >
> > -Jaikiran
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org For additional
> > commands, e-mail: dev-help@ant.apache.org
> >
> >


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org

Re: Ivy website - fixing a Quickstart documentation live

Posted by Gintautas Grigelionis <g....@gmail.com>.
Is the documentation still in SVN? IVY-1542 is about site/sources/style
which is shared by Ivy and IvyDE. Are there any plans about migrating this
to Git and separating the source repo from publication repo?

Gintas

2017-05-25 6:12 GMT+02:00 J Pai <ja...@gmail.com>:

> What would be the process of having the live docs of Ivy project updated
> to fix/update an issue in the documentation[1]?
>
> The quickstart documentation refers to certain log files that get
> auto-generated during the doc build process. It looks like those log files
> weren’t uploaded and are resulting in a blank text area showing up. I can
> run the doc generation target locally (on 2.4.0 tag) and have someone
> upload those files and see if shows up fine.
>
> [1] https://issues.apache.org/jira/browse/IVY-1542
>
> -Jaikiran
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> For additional commands, e-mail: dev-help@ant.apache.org
>
>

AW: Ivy website - fixing a Quickstart documentation live

Posted by "Jan Matèrne (jhm)" <ap...@materne.de>.
+1 for asciidoc.
Using xooki means using a tool only few people know ...

Jan

> -----Ursprüngliche Nachricht-----
> Von: J Pai [mailto:jai.forums2013@gmail.com]
> Gesendet: Donnerstag, 25. Mai 2017 14:03
> An: Ant Developers List
> Betreff: Re: Ivy website - fixing a Quickstart documentation live
> 
> 
> On 25-May-2017, at 5:26 PM, Nicolas Lalevée
> <ni...@hibnet.org> wrote:
> 
> 
> 
> > By the way, the Ivy documentation is managed by an hand crafted html
> editor, xooki, just is good but quite slow. I did some work some time
> ago (2 years ago, time flies!) to try to migrate to asciidoc [2]. I can
> even see that locally I have a commit which for some reason I didn’t
> pushed. If we are still interested, I can revive this.
> >
> 
> I’m very much interested in having the docs moved to asciidoc. I use it
> in almost every other project I deal with and it’s a big motivation to
> continue to write documentation and is definitely a big improvement on
> what we currently have. It doesn’t have to be something that we
> push/force in this release, but if we can transition to this
> documentation system, it’s going to be great.
> 
> -Jaikiran
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org For additional
> commands, e-mail: dev-help@ant.apache.org



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org

Re: Ivy website - fixing a Quickstart documentation live

Posted by J Pai <ja...@gmail.com>.
On 25-May-2017, at 5:26 PM, Nicolas Lalevée <ni...@hibnet.org> wrote:



> By the way, the Ivy documentation is managed by an hand crafted html editor, xooki, just is good but quite slow. I did some work some time ago (2 years ago, time flies!) to try to migrate to asciidoc [2]. I can even see that locally I have a commit which for some reason I didn’t pushed. If we are still interested, I can revive this.
> 

I’m very much interested in having the docs moved to asciidoc. I use it in almost every other project I deal with and it’s a big motivation to continue to write documentation and is definitely a big improvement on what we currently have. It doesn’t have to be something that we push/force in this release, but if we can transition to this documentation system, it’s going to be great.

-Jaikiran


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org

Re: Ivy website - fixing a Quickstart documentation live

Posted by Gintautas Grigelionis <g....@gmail.com>.
asciidocs on Jython FTW :-)

Gintas

2017-05-26 7:09 GMT+02:00 J Pai <ja...@gmail.com>:

> Thanks everyone for the inputs.
>
> I’m trying to get a proper build going locally for the site generation
> (and running into issues). Once I get a proper build and the fixes to the
> issues noted in that JIRA, I’ll send out an update. Hopefully soon.
>
> -Jaikiran
> On 25-May-2017, at 5:26 PM, Nicolas Lalevée <ni...@hibnet.org>
> wrote:
>
> The entire Ant site is in svn:
> https://svn.apache.org/repos/asf/ant/site
>
> There is a Readme.txt explaining a little bit stuff, but seems outdated
> since the migration to git. For Ivy and IvyDE, part of the site is built
> from the source for the projects. It used to be managed via svn:externals.
> Now there are ant tasks to run to the fetch of the sources. I have found an
> old discussion [1] we had about it which should help you.
>
> By the way, the Ivy documentation is managed by an hand crafted html
> editor, xooki, just is good but quite slow. I did some work some time ago
> (2 years ago, time flies!) to try to migrate to asciidoc [2]. I can even
> see that locally I have a commit which for some reason I didn’t pushed. If
> we are still interested, I can revive this.
>
> Nicolas
>
> [1] http://ant.1045680.n5.nabble.com/stuck-with-site-
> generation-issue-for-ivy-td5715758.html <http://ant.1045680.n5.nabble.
> com/stuck-with-site-generation-issue-for-ivy-td5715758.html>
> [2] https://github.com/apache/ant-ivy/tree/xooki2asciidoc <
> https://github.com/apache/ant-ivy/tree/xooki2asciidoc>
>
>
> > Le 25 mai 2017 à 06:12, J Pai <ja...@gmail.com> a écrit :
> >
> > What would be the process of having the live docs of Ivy project updated
> to fix/update an issue in the documentation[1]?
> >
> > The quickstart documentation refers to certain log files that get
> auto-generated during the doc build process. It looks like those log files
> weren’t uploaded and are resulting in a blank text area showing up. I can
> run the doc generation target locally (on 2.4.0 tag) and have someone
> upload those files and see if shows up fine.
> >
> > [1] https://issues.apache.org/jira/browse/IVY-1542
> >
> > -Jaikiran
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> > For additional commands, e-mail: dev-help@ant.apache.org
> >
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> For additional commands, e-mail: dev-help@ant.apache.org
>
>

Re: Ivy website - fixing a Quickstart documentation live

Posted by Gintautas Grigelionis <g....@gmail.com>.
Of course... here <https://github.com/asciidoctor/asciidoctor-ant> is the
Ant task. Love this commit
<https://github.com/asciidoctor/asciidoctor-ant/commit/e9f97b94bdd8e2242f685f34736bd2a35be8a3b5>
- speaking about timing :-)

Gintas

2017-05-26 18:01 GMT+02:00 Nicolas Lalevée <ni...@hibnet.org>:

> There are some Ant task for asciidoctor, and it is used in the branch
> where there is the experiment about migrating from xooki to asciidoc:
> https://github.com/apache/ant-ivy/blob/xooki2asciidoc/build-
> release.xml#L168 <https://github.com/apache/ant-ivy/blob/xooki2asciidoc/
> build-release.xml#L168>
>
> And it is nice because we can plug things into asciidoctor, like the
> management of the toc, just like xooki is currently doing:
> https://github.com/apache/ant-ivy/blob/xooki2asciidoc/
> asciidoc/templates/helpers.rb <https://github.com/apache/
> ant-ivy/blob/xooki2asciidoc/asciidoc/templates/helpers.rb>
>
> Nicolas
>
> > Le 26 mai 2017 à 17:54, Gintautas Grigelionis <g....@gmail.com>
> a écrit :
> >
> > Thanks for heads up: asciidoctorj
> > <https://github.com/asciidoctor/asciidoctorj>, then :-) There are no Ant
> > tasks, but maybe a javascript wrapper would do?
> >
> > Gintas
> >
> > 2017-05-26 17:26 GMT+02:00 Matt Sicker <bo...@gmail.com>:
> >
> >> Can't you run the original Ruby asciidoc parser via JRuby, too?
> >>
> >> On 26 May 2017 at 02:06, J Pai <ja...@gmail.com> wrote:
> >>
> >>> So I got this site generation working locally (had to fix a xooki
> script
> >>> to make it work with Nashorn. The attached patch includes the fix).
> >>>
> >>> At this point, I need help to commit the newly generated doc fixes to
> the
> >>> SVN. I’ve attached a patch file for it and will explain what it is
> doing.
> >>>
> >>> The changes/patch relates to _one_ of the more important issues noted
> in
> >>> the JIRA https://issues.apache.org/jira/browse/IVY-1542. That JIRA
> lists
> >>> more than one issue with the latest docs. However, the missing .png and
> >>> .css don’t directly contribute to anything noticeable, so I haven’t
> >>> included it in this patch (and probably will look into it separately).
> >> The
> >>> issue that this patch fixes is the more important one:
> >>>
> >>>> Code examples are missing. About 2/3 of the way down the page are two
> >>> code examples that are rendering as just a black rectangle for me. The
> >>> underlying html looks like it has <pre> tags with no content.
> >>>
> >>>
> >>> The way these tutorial docs are generated, during the build, it
> triggers
> >>> the build of quickstart examples and dumps the logs into files. The log
> >>> files are then referred to via xooki references and the contents of
> those
> >>> log files are inlined within the div tags. So I went ahead and built
> >> these
> >>> tutorials on 2.4.0 tag of Ivy project, generated those logs and then
> >>> regenerated the site with these logs in the relevant folder. The
> >> generated
> >>> documentation now has these output inlined correctly in the quickstart
> >> and
> >>> various other docs.
> >>>
> >>> The attached patch was generated with https://svn.apache.org/repos/
> >>> asf/ant/site/ as the root of the SVN checkout. So whoever is applying
> the
> >>> patch will have to cd to that directory and then apply it. Let me know
> if
> >>> you run into issues or if any changes are necessary in this patch.
> >>>
> >>> As for the other two issues noted in that JIRA, I’m planning to remove
> >>> references to the non-existent .css and .png files and submit that as a
> >>> separate patch.
> >>>
> >>> -Jaikiran
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>> On 26-May-2017, at 10:39 AM, J Pai <ja...@gmail.com> wrote:
> >>>
> >>> Thanks everyone for the inputs.
> >>>
> >>> I’m trying to get a proper build going locally for the site generation
> >>> (and running into issues). Once I get a proper build and the fixes to
> the
> >>> issues noted in that JIRA, I’ll send out an update. Hopefully soon.
> >>>
> >>> -Jaikiran
> >>> On 25-May-2017, at 5:26 PM, Nicolas Lalevée <
> nicolas.lalevee@hibnet.org>
> >>> wrote:
> >>>
> >>> The entire Ant site is in svn:
> >>> https://svn.apache.org/repos/asf/ant/site
> >>>
> >>> There is a Readme.txt explaining a little bit stuff, but seems outdated
> >>> since the migration to git. For Ivy and IvyDE, part of the site is
> built
> >>> from the source for the projects. It used to be managed via
> >> svn:externals.
> >>> Now there are ant tasks to run to the fetch of the sources. I have
> found
> >> an
> >>> old discussion [1] we had about it which should help you.
> >>>
> >>> By the way, the Ivy documentation is managed by an hand crafted html
> >>> editor, xooki, just is good but quite slow. I did some work some time
> ago
> >>> (2 years ago, time flies!) to try to migrate to asciidoc [2]. I can
> even
> >>> see that locally I have a commit which for some reason I didn’t pushed.
> >> If
> >>> we are still interested, I can revive this.
> >>>
> >>> Nicolas
> >>>
> >>> [1] http://ant.1045680.n5.nabble.com/stuck-with-site-
> >>> generation-issue-for-ivy-td5715758.html <http://ant.1045680.n5.nabble.
> >>> com/stuck-with-site-generation-issue-for-ivy-td5715758.html>
> >>> [2] https://github.com/apache/ant-ivy/tree/xooki2asciidoc <
> >>> https://github.com/apache/ant-ivy/tree/xooki2asciidoc>
> >>>
> >>>
> >>>> Le 25 mai 2017 à 06:12, J Pai <ja...@gmail.com> a écrit :
> >>>>
> >>>> What would be the process of having the live docs of Ivy project
> >> updated
> >>> to fix/update an issue in the documentation[1]?
> >>>>
> >>>> The quickstart documentation refers to certain log files that get
> >>> auto-generated during the doc build process. It looks like those log
> >> files
> >>> weren’t uploaded and are resulting in a blank text area showing up. I
> can
> >>> run the doc generation target locally (on 2.4.0 tag) and have someone
> >>> upload those files and see if shows up fine.
> >>>>
> >>>> [1] https://issues.apache.org/jira/browse/IVY-1542
> >>>>
> >>>> -Jaikiran
> >>>> ---------------------------------------------------------------------
> >>>> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> >>>> For additional commands, e-mail: dev-help@ant.apache.org
> >>>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>> ---------------------------------------------------------------------
> >>> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> >>> For additional commands, e-mail: dev-help@ant.apache.org
> >>>
> >>
> >>
> >>
> >> --
> >> Matt Sicker <bo...@gmail.com>
> >>
>
>

Re: Ivy website - fixing a Quickstart documentation live

Posted by Nicolas Lalevée <ni...@hibnet.org>.
There are some Ant task for asciidoctor, and it is used in the branch where there is the experiment about migrating from xooki to asciidoc:
https://github.com/apache/ant-ivy/blob/xooki2asciidoc/build-release.xml#L168 <https://github.com/apache/ant-ivy/blob/xooki2asciidoc/build-release.xml#L168>

And it is nice because we can plug things into asciidoctor, like the management of the toc, just like xooki is currently doing:
https://github.com/apache/ant-ivy/blob/xooki2asciidoc/asciidoc/templates/helpers.rb <https://github.com/apache/ant-ivy/blob/xooki2asciidoc/asciidoc/templates/helpers.rb>

Nicolas
 
> Le 26 mai 2017 à 17:54, Gintautas Grigelionis <g....@gmail.com> a écrit :
> 
> Thanks for heads up: asciidoctorj
> <https://github.com/asciidoctor/asciidoctorj>, then :-) There are no Ant
> tasks, but maybe a javascript wrapper would do?
> 
> Gintas
> 
> 2017-05-26 17:26 GMT+02:00 Matt Sicker <bo...@gmail.com>:
> 
>> Can't you run the original Ruby asciidoc parser via JRuby, too?
>> 
>> On 26 May 2017 at 02:06, J Pai <ja...@gmail.com> wrote:
>> 
>>> So I got this site generation working locally (had to fix a xooki script
>>> to make it work with Nashorn. The attached patch includes the fix).
>>> 
>>> At this point, I need help to commit the newly generated doc fixes to the
>>> SVN. I’ve attached a patch file for it and will explain what it is doing.
>>> 
>>> The changes/patch relates to _one_ of the more important issues noted in
>>> the JIRA https://issues.apache.org/jira/browse/IVY-1542. That JIRA lists
>>> more than one issue with the latest docs. However, the missing .png and
>>> .css don’t directly contribute to anything noticeable, so I haven’t
>>> included it in this patch (and probably will look into it separately).
>> The
>>> issue that this patch fixes is the more important one:
>>> 
>>>> Code examples are missing. About 2/3 of the way down the page are two
>>> code examples that are rendering as just a black rectangle for me. The
>>> underlying html looks like it has <pre> tags with no content.
>>> 
>>> 
>>> The way these tutorial docs are generated, during the build, it triggers
>>> the build of quickstart examples and dumps the logs into files. The log
>>> files are then referred to via xooki references and the contents of those
>>> log files are inlined within the div tags. So I went ahead and built
>> these
>>> tutorials on 2.4.0 tag of Ivy project, generated those logs and then
>>> regenerated the site with these logs in the relevant folder. The
>> generated
>>> documentation now has these output inlined correctly in the quickstart
>> and
>>> various other docs.
>>> 
>>> The attached patch was generated with https://svn.apache.org/repos/
>>> asf/ant/site/ as the root of the SVN checkout. So whoever is applying the
>>> patch will have to cd to that directory and then apply it. Let me know if
>>> you run into issues or if any changes are necessary in this patch.
>>> 
>>> As for the other two issues noted in that JIRA, I’m planning to remove
>>> references to the non-existent .css and .png files and submit that as a
>>> separate patch.
>>> 
>>> -Jaikiran
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> On 26-May-2017, at 10:39 AM, J Pai <ja...@gmail.com> wrote:
>>> 
>>> Thanks everyone for the inputs.
>>> 
>>> I’m trying to get a proper build going locally for the site generation
>>> (and running into issues). Once I get a proper build and the fixes to the
>>> issues noted in that JIRA, I’ll send out an update. Hopefully soon.
>>> 
>>> -Jaikiran
>>> On 25-May-2017, at 5:26 PM, Nicolas Lalevée <ni...@hibnet.org>
>>> wrote:
>>> 
>>> The entire Ant site is in svn:
>>> https://svn.apache.org/repos/asf/ant/site
>>> 
>>> There is a Readme.txt explaining a little bit stuff, but seems outdated
>>> since the migration to git. For Ivy and IvyDE, part of the site is built
>>> from the source for the projects. It used to be managed via
>> svn:externals.
>>> Now there are ant tasks to run to the fetch of the sources. I have found
>> an
>>> old discussion [1] we had about it which should help you.
>>> 
>>> By the way, the Ivy documentation is managed by an hand crafted html
>>> editor, xooki, just is good but quite slow. I did some work some time ago
>>> (2 years ago, time flies!) to try to migrate to asciidoc [2]. I can even
>>> see that locally I have a commit which for some reason I didn’t pushed.
>> If
>>> we are still interested, I can revive this.
>>> 
>>> Nicolas
>>> 
>>> [1] http://ant.1045680.n5.nabble.com/stuck-with-site-
>>> generation-issue-for-ivy-td5715758.html <http://ant.1045680.n5.nabble.
>>> com/stuck-with-site-generation-issue-for-ivy-td5715758.html>
>>> [2] https://github.com/apache/ant-ivy/tree/xooki2asciidoc <
>>> https://github.com/apache/ant-ivy/tree/xooki2asciidoc>
>>> 
>>> 
>>>> Le 25 mai 2017 à 06:12, J Pai <ja...@gmail.com> a écrit :
>>>> 
>>>> What would be the process of having the live docs of Ivy project
>> updated
>>> to fix/update an issue in the documentation[1]?
>>>> 
>>>> The quickstart documentation refers to certain log files that get
>>> auto-generated during the doc build process. It looks like those log
>> files
>>> weren’t uploaded and are resulting in a blank text area showing up. I can
>>> run the doc generation target locally (on 2.4.0 tag) and have someone
>>> upload those files and see if shows up fine.
>>>> 
>>>> [1] https://issues.apache.org/jira/browse/IVY-1542
>>>> 
>>>> -Jaikiran
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
>>>> For additional commands, e-mail: dev-help@ant.apache.org
>>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
>>> For additional commands, e-mail: dev-help@ant.apache.org
>>> 
>> 
>> 
>> 
>> --
>> Matt Sicker <bo...@gmail.com>
>>

Re: Ivy website - fixing a Quickstart documentation live

Posted by Gintautas Grigelionis <g....@gmail.com>.
Thanks for heads up: asciidoctorj
<https://github.com/asciidoctor/asciidoctorj>, then :-) There are no Ant
tasks, but maybe a javascript wrapper would do?

Gintas

2017-05-26 17:26 GMT+02:00 Matt Sicker <bo...@gmail.com>:

> Can't you run the original Ruby asciidoc parser via JRuby, too?
>
> On 26 May 2017 at 02:06, J Pai <ja...@gmail.com> wrote:
>
> > So I got this site generation working locally (had to fix a xooki script
> > to make it work with Nashorn. The attached patch includes the fix).
> >
> > At this point, I need help to commit the newly generated doc fixes to the
> > SVN. I’ve attached a patch file for it and will explain what it is doing.
> >
> > The changes/patch relates to _one_ of the more important issues noted in
> > the JIRA https://issues.apache.org/jira/browse/IVY-1542. That JIRA lists
> > more than one issue with the latest docs. However, the missing .png and
> > .css don’t directly contribute to anything noticeable, so I haven’t
> > included it in this patch (and probably will look into it separately).
> The
> > issue that this patch fixes is the more important one:
> >
> > > Code examples are missing. About 2/3 of the way down the page are two
> > code examples that are rendering as just a black rectangle for me. The
> > underlying html looks like it has <pre> tags with no content.
> >
> >
> > The way these tutorial docs are generated, during the build, it triggers
> > the build of quickstart examples and dumps the logs into files. The log
> > files are then referred to via xooki references and the contents of those
> > log files are inlined within the div tags. So I went ahead and built
> these
> > tutorials on 2.4.0 tag of Ivy project, generated those logs and then
> > regenerated the site with these logs in the relevant folder. The
> generated
> > documentation now has these output inlined correctly in the quickstart
> and
> > various other docs.
> >
> > The attached patch was generated with https://svn.apache.org/repos/
> > asf/ant/site/ as the root of the SVN checkout. So whoever is applying the
> > patch will have to cd to that directory and then apply it. Let me know if
> > you run into issues or if any changes are necessary in this patch.
> >
> > As for the other two issues noted in that JIRA, I’m planning to remove
> > references to the non-existent .css and .png files and submit that as a
> > separate patch.
> >
> > -Jaikiran
> >
> >
> >
> >
> >
> >
> >
> > On 26-May-2017, at 10:39 AM, J Pai <ja...@gmail.com> wrote:
> >
> > Thanks everyone for the inputs.
> >
> > I’m trying to get a proper build going locally for the site generation
> > (and running into issues). Once I get a proper build and the fixes to the
> > issues noted in that JIRA, I’ll send out an update. Hopefully soon.
> >
> > -Jaikiran
> > On 25-May-2017, at 5:26 PM, Nicolas Lalevée <ni...@hibnet.org>
> > wrote:
> >
> > The entire Ant site is in svn:
> > https://svn.apache.org/repos/asf/ant/site
> >
> > There is a Readme.txt explaining a little bit stuff, but seems outdated
> > since the migration to git. For Ivy and IvyDE, part of the site is built
> > from the source for the projects. It used to be managed via
> svn:externals.
> > Now there are ant tasks to run to the fetch of the sources. I have found
> an
> > old discussion [1] we had about it which should help you.
> >
> > By the way, the Ivy documentation is managed by an hand crafted html
> > editor, xooki, just is good but quite slow. I did some work some time ago
> > (2 years ago, time flies!) to try to migrate to asciidoc [2]. I can even
> > see that locally I have a commit which for some reason I didn’t pushed.
> If
> > we are still interested, I can revive this.
> >
> > Nicolas
> >
> > [1] http://ant.1045680.n5.nabble.com/stuck-with-site-
> > generation-issue-for-ivy-td5715758.html <http://ant.1045680.n5.nabble.
> > com/stuck-with-site-generation-issue-for-ivy-td5715758.html>
> > [2] https://github.com/apache/ant-ivy/tree/xooki2asciidoc <
> > https://github.com/apache/ant-ivy/tree/xooki2asciidoc>
> >
> >
> > > Le 25 mai 2017 à 06:12, J Pai <ja...@gmail.com> a écrit :
> > >
> > > What would be the process of having the live docs of Ivy project
> updated
> > to fix/update an issue in the documentation[1]?
> > >
> > > The quickstart documentation refers to certain log files that get
> > auto-generated during the doc build process. It looks like those log
> files
> > weren’t uploaded and are resulting in a blank text area showing up. I can
> > run the doc generation target locally (on 2.4.0 tag) and have someone
> > upload those files and see if shows up fine.
> > >
> > > [1] https://issues.apache.org/jira/browse/IVY-1542
> > >
> > > -Jaikiran
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> > > For additional commands, e-mail: dev-help@ant.apache.org
> > >
> >
> >
> >
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> > For additional commands, e-mail: dev-help@ant.apache.org
> >
>
>
>
> --
> Matt Sicker <bo...@gmail.com>
>

Re: Ivy website - fixing a Quickstart documentation live

Posted by Matt Sicker <bo...@gmail.com>.
Can't you run the original Ruby asciidoc parser via JRuby, too?

On 26 May 2017 at 02:06, J Pai <ja...@gmail.com> wrote:

> So I got this site generation working locally (had to fix a xooki script
> to make it work with Nashorn. The attached patch includes the fix).
>
> At this point, I need help to commit the newly generated doc fixes to the
> SVN. I’ve attached a patch file for it and will explain what it is doing.
>
> The changes/patch relates to _one_ of the more important issues noted in
> the JIRA https://issues.apache.org/jira/browse/IVY-1542. That JIRA lists
> more than one issue with the latest docs. However, the missing .png and
> .css don’t directly contribute to anything noticeable, so I haven’t
> included it in this patch (and probably will look into it separately). The
> issue that this patch fixes is the more important one:
>
> > Code examples are missing. About 2/3 of the way down the page are two
> code examples that are rendering as just a black rectangle for me. The
> underlying html looks like it has <pre> tags with no content.
>
>
> The way these tutorial docs are generated, during the build, it triggers
> the build of quickstart examples and dumps the logs into files. The log
> files are then referred to via xooki references and the contents of those
> log files are inlined within the div tags. So I went ahead and built these
> tutorials on 2.4.0 tag of Ivy project, generated those logs and then
> regenerated the site with these logs in the relevant folder. The generated
> documentation now has these output inlined correctly in the quickstart and
> various other docs.
>
> The attached patch was generated with https://svn.apache.org/repos/
> asf/ant/site/ as the root of the SVN checkout. So whoever is applying the
> patch will have to cd to that directory and then apply it. Let me know if
> you run into issues or if any changes are necessary in this patch.
>
> As for the other two issues noted in that JIRA, I’m planning to remove
> references to the non-existent .css and .png files and submit that as a
> separate patch.
>
> -Jaikiran
>
>
>
>
>
>
>
> On 26-May-2017, at 10:39 AM, J Pai <ja...@gmail.com> wrote:
>
> Thanks everyone for the inputs.
>
> I’m trying to get a proper build going locally for the site generation
> (and running into issues). Once I get a proper build and the fixes to the
> issues noted in that JIRA, I’ll send out an update. Hopefully soon.
>
> -Jaikiran
> On 25-May-2017, at 5:26 PM, Nicolas Lalevée <ni...@hibnet.org>
> wrote:
>
> The entire Ant site is in svn:
> https://svn.apache.org/repos/asf/ant/site
>
> There is a Readme.txt explaining a little bit stuff, but seems outdated
> since the migration to git. For Ivy and IvyDE, part of the site is built
> from the source for the projects. It used to be managed via svn:externals.
> Now there are ant tasks to run to the fetch of the sources. I have found an
> old discussion [1] we had about it which should help you.
>
> By the way, the Ivy documentation is managed by an hand crafted html
> editor, xooki, just is good but quite slow. I did some work some time ago
> (2 years ago, time flies!) to try to migrate to asciidoc [2]. I can even
> see that locally I have a commit which for some reason I didn’t pushed. If
> we are still interested, I can revive this.
>
> Nicolas
>
> [1] http://ant.1045680.n5.nabble.com/stuck-with-site-
> generation-issue-for-ivy-td5715758.html <http://ant.1045680.n5.nabble.
> com/stuck-with-site-generation-issue-for-ivy-td5715758.html>
> [2] https://github.com/apache/ant-ivy/tree/xooki2asciidoc <
> https://github.com/apache/ant-ivy/tree/xooki2asciidoc>
>
>
> > Le 25 mai 2017 à 06:12, J Pai <ja...@gmail.com> a écrit :
> >
> > What would be the process of having the live docs of Ivy project updated
> to fix/update an issue in the documentation[1]?
> >
> > The quickstart documentation refers to certain log files that get
> auto-generated during the doc build process. It looks like those log files
> weren’t uploaded and are resulting in a blank text area showing up. I can
> run the doc generation target locally (on 2.4.0 tag) and have someone
> upload those files and see if shows up fine.
> >
> > [1] https://issues.apache.org/jira/browse/IVY-1542
> >
> > -Jaikiran
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> > For additional commands, e-mail: dev-help@ant.apache.org
> >
>
>
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> For additional commands, e-mail: dev-help@ant.apache.org
>



-- 
Matt Sicker <bo...@gmail.com>

Re: Ivy website - fixing a Quickstart documentation live

Posted by J Pai <ja...@gmail.com>.
I just realized that attachments aren’t delivered to the mailing list. So here’s the gist link to the patch https://gist.github.com/jaikiran/992e642410afb5683e461d1bd6e01503 which I was talking about in my mail.


-Jaikiran
On 26-May-2017, at 12:36 PM, J Pai <ja...@gmail.com> wrote:

So I got this site generation working locally (had to fix a xooki script to make it work with Nashorn. The attached patch includes the fix). 

At this point, I need help to commit the newly generated doc fixes to the SVN. I’ve attached a patch file for it and will explain what it is doing.

The changes/patch relates to _one_ of the more important issues noted in the JIRA https://issues.apache.org/jira/browse/IVY-1542. That JIRA lists more than one issue with the latest docs. However, the missing .png and .css don’t directly contribute to anything noticeable, so I haven’t included it in this patch (and probably will look into it separately). The issue that this patch fixes is the more important one:

> Code examples are missing. About 2/3 of the way down the page are two code examples that are rendering as just a black rectangle for me. The underlying html looks like it has <pre> tags with no content.


The way these tutorial docs are generated, during the build, it triggers the build of quickstart examples and dumps the logs into files. The log files are then referred to via xooki references and the contents of those log files are inlined within the div tags. So I went ahead and built these tutorials on 2.4.0 tag of Ivy project, generated those logs and then regenerated the site with these logs in the relevant folder. The generated documentation now has these output inlined correctly in the quickstart and various other docs.

The attached patch was generated with https://svn.apache.org/repos/asf/ant/site/ as the root of the SVN checkout. So whoever is applying the patch will have to cd to that directory and then apply it. Let me know if you run into issues or if any changes are necessary in this patch.

As for the other two issues noted in that JIRA, I’m planning to remove references to the non-existent .css and .png files and submit that as a separate patch.

-Jaikiran

<fix-latest-milestone-docs.patch>




On 26-May-2017, at 10:39 AM, J Pai <ja...@gmail.com> wrote:

Thanks everyone for the inputs.

I’m trying to get a proper build going locally for the site generation (and running into issues). Once I get a proper build and the fixes to the issues noted in that JIRA, I’ll send out an update. Hopefully soon.

-Jaikiran
On 25-May-2017, at 5:26 PM, Nicolas Lalevée <ni...@hibnet.org> wrote:

The entire Ant site is in svn:
https://svn.apache.org/repos/asf/ant/site

There is a Readme.txt explaining a little bit stuff, but seems outdated since the migration to git. For Ivy and IvyDE, part of the site is built from the source for the projects. It used to be managed via svn:externals. Now there are ant tasks to run to the fetch of the sources. I have found an old discussion [1] we had about it which should help you.

By the way, the Ivy documentation is managed by an hand crafted html editor, xooki, just is good but quite slow. I did some work some time ago (2 years ago, time flies!) to try to migrate to asciidoc [2]. I can even see that locally I have a commit which for some reason I didn’t pushed. If we are still interested, I can revive this.

Nicolas

[1] http://ant.1045680.n5.nabble.com/stuck-with-site-generation-issue-for-ivy-td5715758.html <http://ant.1045680.n5.nabble.com/stuck-with-site-generation-issue-for-ivy-td5715758.html>
[2] https://github.com/apache/ant-ivy/tree/xooki2asciidoc <https://github.com/apache/ant-ivy/tree/xooki2asciidoc>


> Le 25 mai 2017 à 06:12, J Pai <ja...@gmail.com> a écrit :
> 
> What would be the process of having the live docs of Ivy project updated to fix/update an issue in the documentation[1]? 
> 
> The quickstart documentation refers to certain log files that get auto-generated during the doc build process. It looks like those log files weren’t uploaded and are resulting in a blank text area showing up. I can run the doc generation target locally (on 2.4.0 tag) and have someone upload those files and see if shows up fine.
> 
> [1] https://issues.apache.org/jira/browse/IVY-1542
> 
> -Jaikiran
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> For additional commands, e-mail: dev-help@ant.apache.org
> 





---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org

Re: Ivy website - fixing a Quickstart documentation live

Posted by J Pai <ja...@gmail.com>.
So I got this site generation working locally (had to fix a xooki script to make it work with Nashorn. The attached patch includes the fix). 

At this point, I need help to commit the newly generated doc fixes to the SVN. I’ve attached a patch file for it and will explain what it is doing.

The changes/patch relates to _one_ of the more important issues noted in the JIRA https://issues.apache.org/jira/browse/IVY-1542. That JIRA lists more than one issue with the latest docs. However, the missing .png and .css don’t directly contribute to anything noticeable, so I haven’t included it in this patch (and probably will look into it separately). The issue that this patch fixes is the more important one:

> Code examples are missing. About 2/3 of the way down the page are two code examples that are rendering as just a black rectangle for me. The underlying html looks like it has <pre> tags with no content.


The way these tutorial docs are generated, during the build, it triggers the build of quickstart examples and dumps the logs into files. The log files are then referred to via xooki references and the contents of those log files are inlined within the div tags. So I went ahead and built these tutorials on 2.4.0 tag of Ivy project, generated those logs and then regenerated the site with these logs in the relevant folder. The generated documentation now has these output inlined correctly in the quickstart and various other docs.

The attached patch was generated with https://svn.apache.org/repos/asf/ant/site/ as the root of the SVN checkout. So whoever is applying the patch will have to cd to that directory and then apply it. Let me know if you run into issues or if any changes are necessary in this patch.

As for the other two issues noted in that JIRA, I’m planning to remove references to the non-existent .css and .png files and submit that as a separate patch.

-Jaikiran

Re: Ivy website - fixing a Quickstart documentation live

Posted by J Pai <ja...@gmail.com>.
Thanks everyone for the inputs.

I’m trying to get a proper build going locally for the site generation (and running into issues). Once I get a proper build and the fixes to the issues noted in that JIRA, I’ll send out an update. Hopefully soon.

-Jaikiran
On 25-May-2017, at 5:26 PM, Nicolas Lalevée <ni...@hibnet.org> wrote:

The entire Ant site is in svn:
https://svn.apache.org/repos/asf/ant/site

There is a Readme.txt explaining a little bit stuff, but seems outdated since the migration to git. For Ivy and IvyDE, part of the site is built from the source for the projects. It used to be managed via svn:externals. Now there are ant tasks to run to the fetch of the sources. I have found an old discussion [1] we had about it which should help you.

By the way, the Ivy documentation is managed by an hand crafted html editor, xooki, just is good but quite slow. I did some work some time ago (2 years ago, time flies!) to try to migrate to asciidoc [2]. I can even see that locally I have a commit which for some reason I didn’t pushed. If we are still interested, I can revive this.

Nicolas

[1] http://ant.1045680.n5.nabble.com/stuck-with-site-generation-issue-for-ivy-td5715758.html <http://ant.1045680.n5.nabble.com/stuck-with-site-generation-issue-for-ivy-td5715758.html>
[2] https://github.com/apache/ant-ivy/tree/xooki2asciidoc <https://github.com/apache/ant-ivy/tree/xooki2asciidoc>


> Le 25 mai 2017 à 06:12, J Pai <ja...@gmail.com> a écrit :
> 
> What would be the process of having the live docs of Ivy project updated to fix/update an issue in the documentation[1]? 
> 
> The quickstart documentation refers to certain log files that get auto-generated during the doc build process. It looks like those log files weren’t uploaded and are resulting in a blank text area showing up. I can run the doc generation target locally (on 2.4.0 tag) and have someone upload those files and see if shows up fine.
> 
> [1] https://issues.apache.org/jira/browse/IVY-1542
> 
> -Jaikiran
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> For additional commands, e-mail: dev-help@ant.apache.org
> 



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org

Re: Ivy website - fixing a Quickstart documentation live

Posted by Nicolas Lalevée <ni...@hibnet.org>.
The entire Ant site is in svn:
https://svn.apache.org/repos/asf/ant/site

There is a Readme.txt explaining a little bit stuff, but seems outdated since the migration to git. For Ivy and IvyDE, part of the site is built from the source for the projects. It used to be managed via svn:externals. Now there are ant tasks to run to the fetch of the sources. I have found an old discussion [1] we had about it which should help you.

By the way, the Ivy documentation is managed by an hand crafted html editor, xooki, just is good but quite slow. I did some work some time ago (2 years ago, time flies!) to try to migrate to asciidoc [2]. I can even see that locally I have a commit which for some reason I didn’t pushed. If we are still interested, I can revive this.

Nicolas

[1] http://ant.1045680.n5.nabble.com/stuck-with-site-generation-issue-for-ivy-td5715758.html <http://ant.1045680.n5.nabble.com/stuck-with-site-generation-issue-for-ivy-td5715758.html>
[2] https://github.com/apache/ant-ivy/tree/xooki2asciidoc <https://github.com/apache/ant-ivy/tree/xooki2asciidoc>


> Le 25 mai 2017 à 06:12, J Pai <ja...@gmail.com> a écrit :
> 
> What would be the process of having the live docs of Ivy project updated to fix/update an issue in the documentation[1]? 
> 
> The quickstart documentation refers to certain log files that get auto-generated during the doc build process. It looks like those log files weren’t uploaded and are resulting in a blank text area showing up. I can run the doc generation target locally (on 2.4.0 tag) and have someone upload those files and see if shows up fine.
> 
> [1] https://issues.apache.org/jira/browse/IVY-1542
> 
> -Jaikiran
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> For additional commands, e-mail: dev-help@ant.apache.org
>