You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@camel.apache.org by Tadayoshi Sato <sa...@gmail.com> on 2018/10/30 08:59:02 UTC
Hosted web site
Hi all,
I've been working on migrating docs, and while there are still a number of
pages to be migrated yet it's also becoming in good shape. I think it's
good time to host the docs somewhere so that everyone can read and further
contribute to the site.
I'm aware that recently Francois and Zoran worked on doc site generation
and https://github.com/apache/camel-website. Is it currently accessible
online? Can we publish the static site somewhere like GH Pages, surge.sh,
or Netlify?
The docs are already available on GH as asciidoc but the problem is that
links of reference style i.e. <<jms-component,JMS>> do not work on the
plain GH. I believe we need some place where those reference style links
are also rendered.
Best regards,
Tadayoshi
Re: Hosted web site
Posted by Zoran Regvart <zo...@regvart.com>.
Hi Tadayoshi & Cameleers,
any changes you make on the `camel-website` on the `asf-site` branch
will get overwritten by the build job[1] for the `website` branch in
the `camel` repository. So you need to do all the work on the
`website` branch in the `camel` git repository.
I'm still trying to find a optimal Jenkinsfile[2] configuration to
build the website only when needed.
zoran
[1] https://builds.apache.org/view/C/view/Apache%20Camel/job/Camel/job/website/
[2] https://github.com/apache/camel/blob/99ba1d017c0b5d248fed699276941efb58cdb448/Jenkinsfile#L47-L82
On Wed, Oct 31, 2018 at 1:58 AM, Tadayoshi Sato
<sa...@gmail.com> wrote:
> Awesome stuff, Zoran! Thank you.
>
> I'll peek into the asf-site branch and try to polish it.
--
Zoran Regvart
Re: Hosted web site
Posted by Tadayoshi Sato <sa...@gmail.com>.
Awesome stuff, Zoran! Thank you.
I'll peek into the asf-site branch and try to polish it.
Best regards,
Tadayoshi
On Tue, Oct 30, 2018 at 10:13 PM Andrea Cosentino
<an...@yahoo.com.invalid> wrote:
> Great stuff!
>
> --
> Andrea Cosentino
> ----------------------------------
> Apache Camel PMC Chair
> Apache Karaf Committer
> Apache Servicemix PMC Member
> Email: ancosen1985@yahoo.com
> Twitter: @oscerd2
> Github: oscerd
>
>
>
>
>
>
> On Tuesday, October 30, 2018, 2:05:04 PM GMT+1, Zoran Regvart <
> zoran@regvart.com> wrote:
>
>
>
>
>
> Hi Tadayoshi & Cameleers,
> so the staging site now works* it's at:
>
> https://camel.apache.org/staging/
>
> *and by that I mean: the content of camel-website's asf-site branch is
> published there. It is pretty much broken at the moment, CSS and links
> are generated with absolute values, I need to take a look and make
> them relative so that the website can be nested in that /staging
> directory.
>
> zoran
>
> On Tue, Oct 30, 2018 at 11:40 AM, Zoran Regvart <zo...@regvart.com> wrote:
> > Hi Tadayoshi,
> > I'm really sorry I had little time to look into this, the process
> > should look like this:
> >
> > We make changes on the camel.git gitbox repository (or GitHub mirror)
> > to the `website` branch (till it's merged over to `master`), Jenkins
> > builds the website (Jenkinsfile on `website` branch does this[1]) and
> > pushes to the camel-website.git repository's `asf-site` branch. Then a
> > script provided by the INFRA[2] should sync with the website's
> > /staging directory.
> >
> > I think we need a `asf-site-staging` and a `asf-site` branches on
> > `camel-website.git` repository and a way to merge from one repository
> > to the other (Jenkins job?), but let's make some smaller steps first.
> >
> > zoran
> >
> > [1]
> https://gitbox.apache.org/repos/asf?p=camel.git;a=blob;f=Jenkinsfile;h=f094a624332bed955c686ec4a9951aeaa004c258;hb=refs/heads/website#l47
> > [2] https://issues.apache.org/jira/browse/INFRA-15969
> >
> > On Tue, Oct 30, 2018 at 9:59 AM, Tadayoshi Sato
> > <sa...@gmail.com> wrote:
> >> Hi all,
> >>
> >> I've been working on migrating docs, and while there are still a number
> of
> >> pages to be migrated yet it's also becoming in good shape. I think it's
> >> good time to host the docs somewhere so that everyone can read and
> further
> >> contribute to the site.
> >>
> >> I'm aware that recently Francois and Zoran worked on doc site generation
> >> and https://github.com/apache/camel-website. Is it currently accessible
> >> online? Can we publish the static site somewhere like GH Pages,
> surge.sh,
> >> or Netlify?
> >>
> >> The docs are already available on GH as asciidoc but the problem is that
> >> links of reference style i.e. <<jms-component,JMS>> do not work on the
> >> plain GH. I believe we need some place where those reference style links
> >> are also rendered.
> >>
> >> Best regards,
> >> Tadayoshi
> >
> >
> >
> > --
> > Zoran Regvart
>
>
>
> --
> Zoran Regvart
>
Re: Hosted web site
Posted by Andrea Cosentino <an...@yahoo.com.INVALID>.
Great stuff!
--
Andrea Cosentino
----------------------------------
Apache Camel PMC Chair
Apache Karaf Committer
Apache Servicemix PMC Member
Email: ancosen1985@yahoo.com
Twitter: @oscerd2
Github: oscerd
On Tuesday, October 30, 2018, 2:05:04 PM GMT+1, Zoran Regvart <zo...@regvart.com> wrote:
Hi Tadayoshi & Cameleers,
so the staging site now works* it's at:
https://camel.apache.org/staging/
*and by that I mean: the content of camel-website's asf-site branch is
published there. It is pretty much broken at the moment, CSS and links
are generated with absolute values, I need to take a look and make
them relative so that the website can be nested in that /staging
directory.
zoran
On Tue, Oct 30, 2018 at 11:40 AM, Zoran Regvart <zo...@regvart.com> wrote:
> Hi Tadayoshi,
> I'm really sorry I had little time to look into this, the process
> should look like this:
>
> We make changes on the camel.git gitbox repository (or GitHub mirror)
> to the `website` branch (till it's merged over to `master`), Jenkins
> builds the website (Jenkinsfile on `website` branch does this[1]) and
> pushes to the camel-website.git repository's `asf-site` branch. Then a
> script provided by the INFRA[2] should sync with the website's
> /staging directory.
>
> I think we need a `asf-site-staging` and a `asf-site` branches on
> `camel-website.git` repository and a way to merge from one repository
> to the other (Jenkins job?), but let's make some smaller steps first.
>
> zoran
>
> [1] https://gitbox.apache.org/repos/asf?p=camel.git;a=blob;f=Jenkinsfile;h=f094a624332bed955c686ec4a9951aeaa004c258;hb=refs/heads/website#l47
> [2] https://issues.apache.org/jira/browse/INFRA-15969
>
> On Tue, Oct 30, 2018 at 9:59 AM, Tadayoshi Sato
> <sa...@gmail.com> wrote:
>> Hi all,
>>
>> I've been working on migrating docs, and while there are still a number of
>> pages to be migrated yet it's also becoming in good shape. I think it's
>> good time to host the docs somewhere so that everyone can read and further
>> contribute to the site.
>>
>> I'm aware that recently Francois and Zoran worked on doc site generation
>> and https://github.com/apache/camel-website. Is it currently accessible
>> online? Can we publish the static site somewhere like GH Pages, surge.sh,
>> or Netlify?
>>
>> The docs are already available on GH as asciidoc but the problem is that
>> links of reference style i.e. <<jms-component,JMS>> do not work on the
>> plain GH. I believe we need some place where those reference style links
>> are also rendered.
>>
>> Best regards,
>> Tadayoshi
>
>
>
> --
> Zoran Regvart
--
Zoran Regvart
Re: Hosted web site
Posted by Jean-Baptiste Onofré <jb...@nanthrax.net>.
It sounds good to me: having several hands and help.
I'm working on new stuff around OSGi/Karaf for Camel.
Regards
JB
On 31/10/2018 07:14, Francois Papon wrote:
> Hi,
>
> It's great, thanks Zoran!
>
> I can take a look about the breaking CSS and links.
>
> I'm sorry, I was very busy this month and I could not work on the website :(
>
> It would be better now!
>
> regards,
>
> François Papon
> fpapon@apache.org
>
> Le 30/10/2018 à 17:04, Zoran Regvart a écrit :
>> Hi Tadayoshi & Cameleers,
>> so the staging site now works* it's at:
>>
>> https://camel.apache.org/staging/
>>
>> *and by that I mean: the content of camel-website's asf-site branch is
>> published there. It is pretty much broken at the moment, CSS and links
>> are generated with absolute values, I need to take a look and make
>> them relative so that the website can be nested in that /staging
>> directory.
>>
>> zoran
>>
>> On Tue, Oct 30, 2018 at 11:40 AM, Zoran Regvart <zo...@regvart.com> wrote:
>>> Hi Tadayoshi,
>>> I'm really sorry I had little time to look into this, the process
>>> should look like this:
>>>
>>> We make changes on the camel.git gitbox repository (or GitHub mirror)
>>> to the `website` branch (till it's merged over to `master`), Jenkins
>>> builds the website (Jenkinsfile on `website` branch does this[1]) and
>>> pushes to the camel-website.git repository's `asf-site` branch. Then a
>>> script provided by the INFRA[2] should sync with the website's
>>> /staging directory.
>>>
>>> I think we need a `asf-site-staging` and a `asf-site` branches on
>>> `camel-website.git` repository and a way to merge from one repository
>>> to the other (Jenkins job?), but let's make some smaller steps first.
>>>
>>> zoran
>>>
>>> [1] https://gitbox.apache.org/repos/asf?p=camel.git;a=blob;f=Jenkinsfile;h=f094a624332bed955c686ec4a9951aeaa004c258;hb=refs/heads/website#l47
>>> [2] https://issues.apache.org/jira/browse/INFRA-15969
>>>
>>> On Tue, Oct 30, 2018 at 9:59 AM, Tadayoshi Sato
>>> <sa...@gmail.com> wrote:
>>>> Hi all,
>>>>
>>>> I've been working on migrating docs, and while there are still a number of
>>>> pages to be migrated yet it's also becoming in good shape. I think it's
>>>> good time to host the docs somewhere so that everyone can read and further
>>>> contribute to the site.
>>>>
>>>> I'm aware that recently Francois and Zoran worked on doc site generation
>>>> and https://github.com/apache/camel-website. Is it currently accessible
>>>> online? Can we publish the static site somewhere like GH Pages, surge.sh,
>>>> or Netlify?
>>>>
>>>> The docs are already available on GH as asciidoc but the problem is that
>>>> links of reference style i.e. <<jms-component,JMS>> do not work on the
>>>> plain GH. I believe we need some place where those reference style links
>>>> are also rendered.
>>>>
>>>> Best regards,
>>>> Tadayoshi
>>>
>>>
>>> --
>>> Zoran Regvart
>>
>>
>
Re: Hosted web site
Posted by Zoran Regvart <zo...@regvart.com>.
Hi Nicola & Cameleers,
On Wed, Oct 31, 2018 at 8:49 AM, Nicola Ferraro <ni...@gmail.com> wrote:
> It would be technically possible to have both websites persisted on master,
> so that we just swap them when the new one is ready?
Yes, they are independent.
The current website at camel.apache.org published via buildbot[1] by
running `org.apache.cxf.cwiki.SiteExporter` and exporting the content
from Confluence, and all this is in SVN[2].
As I understood yesterday there is a Puppet-controlled publishing that
is triggered if we push to `camel-website`'s `asf-site` branch to
camel.apache.org/staging.
Once we're ready we can just change that configuration to point to
/content and it should, in theory, replace the current website.
We might think about having a staging and a production build, but
let's have the staging site built first.
zoran
[1] https://ci.apache.org/builders/camel-site-production
[2] https://svn.apache.org/viewvc/camel/website/
[3] https://github.com/apache/infrastructure-puppet/blob/74a229f36f019d38ca08c26f8652c2d5ae0e37c3/modules/gitwcsub/files/config/gitwcsub.cfg#L53
--
Zoran Regvart
Re: Hosted web site
Posted by Onder SEZGIN <on...@apache.org>.
Great work. Thanks Zoran.
On Wed, Oct 31, 2018 at 10:49 AM Nicola Ferraro <ni...@gmail.com>
wrote:
> That's nice Zoran. I think it's a good first step is to have something that
> is displayed on the web, so that we can iterate.
>
> It would be technically possible to have both websites persisted on master,
> so that we just swap them when the new one is ready?
>
> Nicola
>
> On Wed, Oct 31, 2018 at 7:15 AM Francois Papon <
> francois.papon@openobject.fr>
> wrote:
>
> > Hi,
> >
> > It's great, thanks Zoran!
> >
> > I can take a look about the breaking CSS and links.
> >
> > I'm sorry, I was very busy this month and I could not work on the website
> > :(
> >
> > It would be better now!
> >
> > regards,
> >
> > François Papon
> > fpapon@apache.org
> >
> > Le 30/10/2018 à 17:04, Zoran Regvart a écrit :
> > > Hi Tadayoshi & Cameleers,
> > > so the staging site now works* it's at:
> > >
> > > https://camel.apache.org/staging/
> > >
> > > *and by that I mean: the content of camel-website's asf-site branch is
> > > published there. It is pretty much broken at the moment, CSS and links
> > > are generated with absolute values, I need to take a look and make
> > > them relative so that the website can be nested in that /staging
> > > directory.
> > >
> > > zoran
> > >
> > > On Tue, Oct 30, 2018 at 11:40 AM, Zoran Regvart <zo...@regvart.com>
> > wrote:
> > >> Hi Tadayoshi,
> > >> I'm really sorry I had little time to look into this, the process
> > >> should look like this:
> > >>
> > >> We make changes on the camel.git gitbox repository (or GitHub mirror)
> > >> to the `website` branch (till it's merged over to `master`), Jenkins
> > >> builds the website (Jenkinsfile on `website` branch does this[1]) and
> > >> pushes to the camel-website.git repository's `asf-site` branch. Then a
> > >> script provided by the INFRA[2] should sync with the website's
> > >> /staging directory.
> > >>
> > >> I think we need a `asf-site-staging` and a `asf-site` branches on
> > >> `camel-website.git` repository and a way to merge from one repository
> > >> to the other (Jenkins job?), but let's make some smaller steps first.
> > >>
> > >> zoran
> > >>
> > >> [1]
> >
> https://gitbox.apache.org/repos/asf?p=camel.git;a=blob;f=Jenkinsfile;h=f094a624332bed955c686ec4a9951aeaa004c258;hb=refs/heads/website#l47
> > >> [2] https://issues.apache.org/jira/browse/INFRA-15969
> > >>
> > >> On Tue, Oct 30, 2018 at 9:59 AM, Tadayoshi Sato
> > >> <sa...@gmail.com> wrote:
> > >>> Hi all,
> > >>>
> > >>> I've been working on migrating docs, and while there are still a
> > number of
> > >>> pages to be migrated yet it's also becoming in good shape. I think
> it's
> > >>> good time to host the docs somewhere so that everyone can read and
> > further
> > >>> contribute to the site.
> > >>>
> > >>> I'm aware that recently Francois and Zoran worked on doc site
> > generation
> > >>> and https://github.com/apache/camel-website. Is it currently
> > accessible
> > >>> online? Can we publish the static site somewhere like GH Pages,
> > surge.sh,
> > >>> or Netlify?
> > >>>
> > >>> The docs are already available on GH as asciidoc but the problem is
> > that
> > >>> links of reference style i.e. <<jms-component,JMS>> do not work on
> the
> > >>> plain GH. I believe we need some place where those reference style
> > links
> > >>> are also rendered.
> > >>>
> > >>> Best regards,
> > >>> Tadayoshi
> > >>
> > >>
> > >> --
> > >> Zoran Regvart
> > >
> > >
> >
> >
>
Re: Hosted web site
Posted by Nicola Ferraro <ni...@gmail.com>.
That's nice Zoran. I think it's a good first step is to have something that
is displayed on the web, so that we can iterate.
It would be technically possible to have both websites persisted on master,
so that we just swap them when the new one is ready?
Nicola
On Wed, Oct 31, 2018 at 7:15 AM Francois Papon <fr...@openobject.fr>
wrote:
> Hi,
>
> It's great, thanks Zoran!
>
> I can take a look about the breaking CSS and links.
>
> I'm sorry, I was very busy this month and I could not work on the website
> :(
>
> It would be better now!
>
> regards,
>
> François Papon
> fpapon@apache.org
>
> Le 30/10/2018 à 17:04, Zoran Regvart a écrit :
> > Hi Tadayoshi & Cameleers,
> > so the staging site now works* it's at:
> >
> > https://camel.apache.org/staging/
> >
> > *and by that I mean: the content of camel-website's asf-site branch is
> > published there. It is pretty much broken at the moment, CSS and links
> > are generated with absolute values, I need to take a look and make
> > them relative so that the website can be nested in that /staging
> > directory.
> >
> > zoran
> >
> > On Tue, Oct 30, 2018 at 11:40 AM, Zoran Regvart <zo...@regvart.com>
> wrote:
> >> Hi Tadayoshi,
> >> I'm really sorry I had little time to look into this, the process
> >> should look like this:
> >>
> >> We make changes on the camel.git gitbox repository (or GitHub mirror)
> >> to the `website` branch (till it's merged over to `master`), Jenkins
> >> builds the website (Jenkinsfile on `website` branch does this[1]) and
> >> pushes to the camel-website.git repository's `asf-site` branch. Then a
> >> script provided by the INFRA[2] should sync with the website's
> >> /staging directory.
> >>
> >> I think we need a `asf-site-staging` and a `asf-site` branches on
> >> `camel-website.git` repository and a way to merge from one repository
> >> to the other (Jenkins job?), but let's make some smaller steps first.
> >>
> >> zoran
> >>
> >> [1]
> https://gitbox.apache.org/repos/asf?p=camel.git;a=blob;f=Jenkinsfile;h=f094a624332bed955c686ec4a9951aeaa004c258;hb=refs/heads/website#l47
> >> [2] https://issues.apache.org/jira/browse/INFRA-15969
> >>
> >> On Tue, Oct 30, 2018 at 9:59 AM, Tadayoshi Sato
> >> <sa...@gmail.com> wrote:
> >>> Hi all,
> >>>
> >>> I've been working on migrating docs, and while there are still a
> number of
> >>> pages to be migrated yet it's also becoming in good shape. I think it's
> >>> good time to host the docs somewhere so that everyone can read and
> further
> >>> contribute to the site.
> >>>
> >>> I'm aware that recently Francois and Zoran worked on doc site
> generation
> >>> and https://github.com/apache/camel-website. Is it currently
> accessible
> >>> online? Can we publish the static site somewhere like GH Pages,
> surge.sh,
> >>> or Netlify?
> >>>
> >>> The docs are already available on GH as asciidoc but the problem is
> that
> >>> links of reference style i.e. <<jms-component,JMS>> do not work on the
> >>> plain GH. I believe we need some place where those reference style
> links
> >>> are also rendered.
> >>>
> >>> Best regards,
> >>> Tadayoshi
> >>
> >>
> >> --
> >> Zoran Regvart
> >
> >
>
>
Re: Hosted web site
Posted by Zoran Regvart <zo...@regvart.com>.
Hi Francois & Cameleers,
don't be sorry, we appreciate all the help, the website is long
overdue mostly because we all can't find the time to work on it...
zoran
On Wed, Oct 31, 2018 at 7:14 AM, Francois Papon
<fr...@openobject.fr> wrote:
> Hi,
>
> It's great, thanks Zoran!
>
> I can take a look about the breaking CSS and links.
>
> I'm sorry, I was very busy this month and I could not work on the website :(
>
> It would be better now!
>
> regards,
>
> François Papon
> fpapon@apache.org
>
> Le 30/10/2018 à 17:04, Zoran Regvart a écrit :
>> Hi Tadayoshi & Cameleers,
>> so the staging site now works* it's at:
>>
>> https://camel.apache.org/staging/
>>
>> *and by that I mean: the content of camel-website's asf-site branch is
>> published there. It is pretty much broken at the moment, CSS and links
>> are generated with absolute values, I need to take a look and make
>> them relative so that the website can be nested in that /staging
>> directory.
>>
>> zoran
>>
>> On Tue, Oct 30, 2018 at 11:40 AM, Zoran Regvart <zo...@regvart.com> wrote:
>>> Hi Tadayoshi,
>>> I'm really sorry I had little time to look into this, the process
>>> should look like this:
>>>
>>> We make changes on the camel.git gitbox repository (or GitHub mirror)
>>> to the `website` branch (till it's merged over to `master`), Jenkins
>>> builds the website (Jenkinsfile on `website` branch does this[1]) and
>>> pushes to the camel-website.git repository's `asf-site` branch. Then a
>>> script provided by the INFRA[2] should sync with the website's
>>> /staging directory.
>>>
>>> I think we need a `asf-site-staging` and a `asf-site` branches on
>>> `camel-website.git` repository and a way to merge from one repository
>>> to the other (Jenkins job?), but let's make some smaller steps first.
>>>
>>> zoran
>>>
>>> [1] https://gitbox.apache.org/repos/asf?p=camel.git;a=blob;f=Jenkinsfile;h=f094a624332bed955c686ec4a9951aeaa004c258;hb=refs/heads/website#l47
>>> [2] https://issues.apache.org/jira/browse/INFRA-15969
>>>
>>> On Tue, Oct 30, 2018 at 9:59 AM, Tadayoshi Sato
>>> <sa...@gmail.com> wrote:
>>>> Hi all,
>>>>
>>>> I've been working on migrating docs, and while there are still a number of
>>>> pages to be migrated yet it's also becoming in good shape. I think it's
>>>> good time to host the docs somewhere so that everyone can read and further
>>>> contribute to the site.
>>>>
>>>> I'm aware that recently Francois and Zoran worked on doc site generation
>>>> and https://github.com/apache/camel-website. Is it currently accessible
>>>> online? Can we publish the static site somewhere like GH Pages, surge.sh,
>>>> or Netlify?
>>>>
>>>> The docs are already available on GH as asciidoc but the problem is that
>>>> links of reference style i.e. <<jms-component,JMS>> do not work on the
>>>> plain GH. I believe we need some place where those reference style links
>>>> are also rendered.
>>>>
>>>> Best regards,
>>>> Tadayoshi
>>>
>>>
>>> --
>>> Zoran Regvart
>>
>>
>
--
Zoran Regvart
Re: Hosted web site
Posted by Francois Papon <fr...@openobject.fr>.
Hi,
It's great, thanks Zoran!
I can take a look about the breaking CSS and links.
I'm sorry, I was very busy this month and I could not work on the website :(
It would be better now!
regards,
François Papon
fpapon@apache.org
Le 30/10/2018 à 17:04, Zoran Regvart a écrit :
> Hi Tadayoshi & Cameleers,
> so the staging site now works* it's at:
>
> https://camel.apache.org/staging/
>
> *and by that I mean: the content of camel-website's asf-site branch is
> published there. It is pretty much broken at the moment, CSS and links
> are generated with absolute values, I need to take a look and make
> them relative so that the website can be nested in that /staging
> directory.
>
> zoran
>
> On Tue, Oct 30, 2018 at 11:40 AM, Zoran Regvart <zo...@regvart.com> wrote:
>> Hi Tadayoshi,
>> I'm really sorry I had little time to look into this, the process
>> should look like this:
>>
>> We make changes on the camel.git gitbox repository (or GitHub mirror)
>> to the `website` branch (till it's merged over to `master`), Jenkins
>> builds the website (Jenkinsfile on `website` branch does this[1]) and
>> pushes to the camel-website.git repository's `asf-site` branch. Then a
>> script provided by the INFRA[2] should sync with the website's
>> /staging directory.
>>
>> I think we need a `asf-site-staging` and a `asf-site` branches on
>> `camel-website.git` repository and a way to merge from one repository
>> to the other (Jenkins job?), but let's make some smaller steps first.
>>
>> zoran
>>
>> [1] https://gitbox.apache.org/repos/asf?p=camel.git;a=blob;f=Jenkinsfile;h=f094a624332bed955c686ec4a9951aeaa004c258;hb=refs/heads/website#l47
>> [2] https://issues.apache.org/jira/browse/INFRA-15969
>>
>> On Tue, Oct 30, 2018 at 9:59 AM, Tadayoshi Sato
>> <sa...@gmail.com> wrote:
>>> Hi all,
>>>
>>> I've been working on migrating docs, and while there are still a number of
>>> pages to be migrated yet it's also becoming in good shape. I think it's
>>> good time to host the docs somewhere so that everyone can read and further
>>> contribute to the site.
>>>
>>> I'm aware that recently Francois and Zoran worked on doc site generation
>>> and https://github.com/apache/camel-website. Is it currently accessible
>>> online? Can we publish the static site somewhere like GH Pages, surge.sh,
>>> or Netlify?
>>>
>>> The docs are already available on GH as asciidoc but the problem is that
>>> links of reference style i.e. <<jms-component,JMS>> do not work on the
>>> plain GH. I believe we need some place where those reference style links
>>> are also rendered.
>>>
>>> Best regards,
>>> Tadayoshi
>>
>>
>> --
>> Zoran Regvart
>
>
Re: Hosted web site
Posted by Zoran Regvart <zo...@regvart.com>.
Hi Tadayoshi & Cameleers,
so the staging site now works* it's at:
https://camel.apache.org/staging/
*and by that I mean: the content of camel-website's asf-site branch is
published there. It is pretty much broken at the moment, CSS and links
are generated with absolute values, I need to take a look and make
them relative so that the website can be nested in that /staging
directory.
zoran
On Tue, Oct 30, 2018 at 11:40 AM, Zoran Regvart <zo...@regvart.com> wrote:
> Hi Tadayoshi,
> I'm really sorry I had little time to look into this, the process
> should look like this:
>
> We make changes on the camel.git gitbox repository (or GitHub mirror)
> to the `website` branch (till it's merged over to `master`), Jenkins
> builds the website (Jenkinsfile on `website` branch does this[1]) and
> pushes to the camel-website.git repository's `asf-site` branch. Then a
> script provided by the INFRA[2] should sync with the website's
> /staging directory.
>
> I think we need a `asf-site-staging` and a `asf-site` branches on
> `camel-website.git` repository and a way to merge from one repository
> to the other (Jenkins job?), but let's make some smaller steps first.
>
> zoran
>
> [1] https://gitbox.apache.org/repos/asf?p=camel.git;a=blob;f=Jenkinsfile;h=f094a624332bed955c686ec4a9951aeaa004c258;hb=refs/heads/website#l47
> [2] https://issues.apache.org/jira/browse/INFRA-15969
>
> On Tue, Oct 30, 2018 at 9:59 AM, Tadayoshi Sato
> <sa...@gmail.com> wrote:
>> Hi all,
>>
>> I've been working on migrating docs, and while there are still a number of
>> pages to be migrated yet it's also becoming in good shape. I think it's
>> good time to host the docs somewhere so that everyone can read and further
>> contribute to the site.
>>
>> I'm aware that recently Francois and Zoran worked on doc site generation
>> and https://github.com/apache/camel-website. Is it currently accessible
>> online? Can we publish the static site somewhere like GH Pages, surge.sh,
>> or Netlify?
>>
>> The docs are already available on GH as asciidoc but the problem is that
>> links of reference style i.e. <<jms-component,JMS>> do not work on the
>> plain GH. I believe we need some place where those reference style links
>> are also rendered.
>>
>> Best regards,
>> Tadayoshi
>
>
>
> --
> Zoran Regvart
--
Zoran Regvart
Re: Hosted web site
Posted by Zoran Regvart <zo...@regvart.com>.
Hi Tadayoshi,
I'm really sorry I had little time to look into this, the process
should look like this:
We make changes on the camel.git gitbox repository (or GitHub mirror)
to the `website` branch (till it's merged over to `master`), Jenkins
builds the website (Jenkinsfile on `website` branch does this[1]) and
pushes to the camel-website.git repository's `asf-site` branch. Then a
script provided by the INFRA[2] should sync with the website's
/staging directory.
I think we need a `asf-site-staging` and a `asf-site` branches on
`camel-website.git` repository and a way to merge from one repository
to the other (Jenkins job?), but let's make some smaller steps first.
zoran
[1] https://gitbox.apache.org/repos/asf?p=camel.git;a=blob;f=Jenkinsfile;h=f094a624332bed955c686ec4a9951aeaa004c258;hb=refs/heads/website#l47
[2] https://issues.apache.org/jira/browse/INFRA-15969
On Tue, Oct 30, 2018 at 9:59 AM, Tadayoshi Sato
<sa...@gmail.com> wrote:
> Hi all,
>
> I've been working on migrating docs, and while there are still a number of
> pages to be migrated yet it's also becoming in good shape. I think it's
> good time to host the docs somewhere so that everyone can read and further
> contribute to the site.
>
> I'm aware that recently Francois and Zoran worked on doc site generation
> and https://github.com/apache/camel-website. Is it currently accessible
> online? Can we publish the static site somewhere like GH Pages, surge.sh,
> or Netlify?
>
> The docs are already available on GH as asciidoc but the problem is that
> links of reference style i.e. <<jms-component,JMS>> do not work on the
> plain GH. I believe we need some place where those reference style links
> are also rendered.
>
> Best regards,
> Tadayoshi
--
Zoran Regvart