You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@any23.apache.org by Lewis John Mcgibbney <le...@gmail.com> on 2012/02/14 19:37:10 UTC
Making changes to i.a.o/Any23 site
Hi Guys,
Is it possible for someone to explain how I make changes to the site docs.
There are various links which point to Google code.
Thanks
Lewis
--
*Lewis*
Re: Making changes to i.a.o/Any23 site
Posted by Simone Tripodi <si...@apache.org>.
Hi Lewis,
read my replies inline:
> 1) Is it OK to simply modify the raw html pages int eh site checkout?
of course, but just make sure that modifications are coherent in the
xdoc sources, otherwise they would be rewritten by someone who'll
redeploy the site via mvn
> 2) Can you please check over the wiki page I created below, as it is not
> working like this for me. You need to pas th mvn commands from some folder
> which has a pom.xml (trunk folder). Therefore after changing the source
> html in $any23-site you would do the following
>
> $ cd ~/any23-trunk
> $ mvn site-deploy -Dsite.deploymentBaseUrl=$any23-trunk
>
I thin the problem is in the fact that Dsite.deploymentBaseUrl
property is not a valid URL: even if deploying on local FS, you have
to specify the file:// protocol
> This would build the project... is this correct?
Yes, because it will generates some reports, such as test reports,
that need the project has to be built.
Thanks for taking care of it!!!
best,
-Simo
http://people.apache.org/~simonetripodi/
http://simonetripodi.livejournal.com/
http://twitter.com/simonetripodi
http://www.99soft.org/
On Thu, Feb 16, 2012 at 7:31 PM, Lewis John Mcgibbney
<le...@gmail.com> wrote:
> Ok so I'm now at a stage where I need to know some more:
>
>
>
> First time building a site with Maven so apologies for the basic questions.
>
> Thanks
>
> On Thu, Feb 16, 2012 at 1:19 PM, Lewis John Mcgibbney <
> lewis.mcgibbney@gmail.com> wrote:
>
>> Hi Simone,
>>
>> Thanks for the heads up. I've documented it for everyone [1] (and given
>> the cwiki a bit of a face lift as well.)
>>
>> Thanks
>>
>> [1]
>> https://cwiki.apache.org/confluence/display/ANY23/Building+Apache+Any23+Website+HOW_TO
>>
>>
>> On Thu, Feb 16, 2012 at 10:39 AM, Simone Tripodi <simonetripodi@apache.org
>> > wrote:
>>
>>> Good morning Lewis,
>>>
>>> the procedure looks complicated, but it isn't: first, checkout the
>>> generated site:
>>>
>>> $ svn co https://svn.apache.org/repos/asf/incubator/any23/site/any23-site
>>>
>>> then, generate the site via maven, targeting the directory where you
>>> checked out the site:
>>>
>>> $mvn site-deploy
>>> -Dsite.deploymentBaseUrl=file://where/you/checked/out/the/site
>>>
>>> then, come back to the site dir and
>>>
>>> $svn ci -m "new site..."
>>>
>>> Please let me know if you experience some difficulties!!!
>>>
>>> All the best, have anice day!
>>> -SImo
>>>
>>> PS that procedure has to be documented somewhere, may I can kindly ask
>>> you to take care of it, since you're in the loop?
>>>
>>> TIA,
>>> -Simo
>>>
>>> http://people.apache.org/~simonetripodi/
>>> http://simonetripodi.livejournal.com/
>>> http://twitter.com/simonetripodi
>>> http://www.99soft.org/
>>>
>>>
>>>
>>> On Tue, Feb 14, 2012 at 7:37 PM, Lewis John Mcgibbney
>>> <le...@gmail.com> wrote:
>>> > Hi Guys,
>>> >
>>> > Is it possible for someone to explain how I make changes to the site
>>> docs.
>>> > There are various links which point to Google code.
>>> >
>>> > Thanks
>>> >
>>> > Lewis
>>> >
>>> > --
>>> > *Lewis*
>>>
>>
>>
>>
>> --
>> *Lewis*
>>
>>
>
>
> --
> *Lewis*
Re: Making changes to i.a.o/Any23 site
Posted by Lewis John Mcgibbney <le...@gmail.com>.
Ok so I'm now at a stage where I need to know some more:
1) Is it OK to simply modify the raw html pages int eh site checkout?
2) Can you please check over the wiki page I created below, as it is not
working like this for me. You need to pas th mvn commands from some folder
which has a pom.xml (trunk folder). Therefore after changing the source
html in $any23-site you would do the following
$ cd ~/any23-trunk
$ mvn site-deploy -Dsite.deploymentBaseUrl=$any23-trunk
This would build the project... is this correct?
First time building a site with Maven so apologies for the basic questions.
Thanks
On Thu, Feb 16, 2012 at 1:19 PM, Lewis John Mcgibbney <
lewis.mcgibbney@gmail.com> wrote:
> Hi Simone,
>
> Thanks for the heads up. I've documented it for everyone [1] (and given
> the cwiki a bit of a face lift as well.)
>
> Thanks
>
> [1]
> https://cwiki.apache.org/confluence/display/ANY23/Building+Apache+Any23+Website+HOW_TO
>
>
> On Thu, Feb 16, 2012 at 10:39 AM, Simone Tripodi <simonetripodi@apache.org
> > wrote:
>
>> Good morning Lewis,
>>
>> the procedure looks complicated, but it isn't: first, checkout the
>> generated site:
>>
>> $ svn co https://svn.apache.org/repos/asf/incubator/any23/site/any23-site
>>
>> then, generate the site via maven, targeting the directory where you
>> checked out the site:
>>
>> $mvn site-deploy
>> -Dsite.deploymentBaseUrl=file://where/you/checked/out/the/site
>>
>> then, come back to the site dir and
>>
>> $svn ci -m "new site..."
>>
>> Please let me know if you experience some difficulties!!!
>>
>> All the best, have anice day!
>> -SImo
>>
>> PS that procedure has to be documented somewhere, may I can kindly ask
>> you to take care of it, since you're in the loop?
>>
>> TIA,
>> -Simo
>>
>> http://people.apache.org/~simonetripodi/
>> http://simonetripodi.livejournal.com/
>> http://twitter.com/simonetripodi
>> http://www.99soft.org/
>>
>>
>>
>> On Tue, Feb 14, 2012 at 7:37 PM, Lewis John Mcgibbney
>> <le...@gmail.com> wrote:
>> > Hi Guys,
>> >
>> > Is it possible for someone to explain how I make changes to the site
>> docs.
>> > There are various links which point to Google code.
>> >
>> > Thanks
>> >
>> > Lewis
>> >
>> > --
>> > *Lewis*
>>
>
>
>
> --
> *Lewis*
>
>
--
*Lewis*
Re: Making changes to i.a.o/Any23 site
Posted by Lewis John Mcgibbney <le...@gmail.com>.
Hi Simone,
Thanks for the heads up. I've documented it for everyone [1] (and given the
cwiki a bit of a face lift as well.)
Thanks
[1]
https://cwiki.apache.org/confluence/display/ANY23/Building+Apache+Any23+Website+HOW_TO
On Thu, Feb 16, 2012 at 10:39 AM, Simone Tripodi
<si...@apache.org>wrote:
> Good morning Lewis,
>
> the procedure looks complicated, but it isn't: first, checkout the
> generated site:
>
> $ svn co https://svn.apache.org/repos/asf/incubator/any23/site/ any23-site
>
> then, generate the site via maven, targeting the directory where you
> checked out the site:
>
> $mvn site-deploy
> -Dsite.deploymentBaseUrl=file://where/you/checked/out/the/site
>
> then, come back to the site dir and
>
> $svn ci -m "new site..."
>
> Please let me know if you experience some difficulties!!!
>
> All the best, have anice day!
> -SImo
>
> PS that procedure has to be documented somewhere, may I can kindly ask
> you to take care of it, since you're in the loop?
>
> TIA,
> -Simo
>
> http://people.apache.org/~simonetripodi/
> http://simonetripodi.livejournal.com/
> http://twitter.com/simonetripodi
> http://www.99soft.org/
>
>
>
> On Tue, Feb 14, 2012 at 7:37 PM, Lewis John Mcgibbney
> <le...@gmail.com> wrote:
> > Hi Guys,
> >
> > Is it possible for someone to explain how I make changes to the site
> docs.
> > There are various links which point to Google code.
> >
> > Thanks
> >
> > Lewis
> >
> > --
> > *Lewis*
>
--
*Lewis*
Re: Making changes to i.a.o/Any23 site
Posted by Simone Tripodi <si...@apache.org>.
Good morning Lewis,
the procedure looks complicated, but it isn't: first, checkout the
generated site:
$ svn co https://svn.apache.org/repos/asf/incubator/any23/site/ any23-site
then, generate the site via maven, targeting the directory where you
checked out the site:
$mvn site-deploy -Dsite.deploymentBaseUrl=file://where/you/checked/out/the/site
then, come back to the site dir and
$svn ci -m "new site..."
Please let me know if you experience some difficulties!!!
All the best, have anice day!
-SImo
PS that procedure has to be documented somewhere, may I can kindly ask
you to take care of it, since you're in the loop?
TIA,
-Simo
http://people.apache.org/~simonetripodi/
http://simonetripodi.livejournal.com/
http://twitter.com/simonetripodi
http://www.99soft.org/
On Tue, Feb 14, 2012 at 7:37 PM, Lewis John Mcgibbney
<le...@gmail.com> wrote:
> Hi Guys,
>
> Is it possible for someone to explain how I make changes to the site docs.
> There are various links which point to Google code.
>
> Thanks
>
> Lewis
>
> --
> *Lewis*