You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@camel.apache.org by Zoran Regvart <zo...@regvart.com> on 2018/09/25 08:39:04 UTC
Re: [DOC] - generator
Hi François,
thank you for offering to help! Perhaps you can take a look at the
asciidocs for the user manual we have in `docs/user-manual` and see if
the this approach can be used to generate HTML and PDF from that.
We're working on the new website in the `website` branch (I've just
rebased it), there is a build job[1] that gets triggered when you make
changes to that branch and pushes the resulting static files to
`asf-site` branch of the `camel-webiste` subproject[2].
For starters perhaps it would be nice to just have `/manual` on the
new website with the generated HTML files.
Please ping me with any questions, and feel free to change things
around this is all work in progress
zoran
[1] https://builds.apache.org/view/C/view/Apache%20Camel/job/Camel/job/website/
[2] https://github.com/apache/camel-website/tree/asf-site
On Tue, Sep 25, 2018 at 5:08 AM Francois Papon
<fr...@openobject.fr> wrote:
>
> Hi,
>
> I know there is an actual effort on the manual and documentation of the
> project and I would like to know if I can help on some items ?
>
> I made templates wich use the Apache website theme for generation of
> HTML and PDF from asciidoc files and using the asciidoc-maven-plugin.
>
> If you are interested, you can take a look here :
>
> https://github.com/fpapon/apache-manual
>
> Regards,
>
> --
> François Papon
> fpapon@apache.org
>
--
Zoran Regvart
Re: [DOC] - generator
Posted by Jean-Baptiste Onofré <jb...@nanthrax.net>.
Thanks
I gonna take a look and move forward.
Regards
JB
Le 26 sept. 2018 à 07:43, à 07:43, Francois Papon <fr...@openobject.fr> a écrit:
>Hi Zoran,
>
>I pushed a PR for a discussion around the generation.
>
>I added some guide about how to generate the HTML and PDF in the
>comments of the PR.
>
>I would have some feedbacks before go forward on this :)
>
>regards,
>
>François Papon
>fpapon@apache.org
>
>Le 25/09/2018 à 12:39, Zoran Regvart a écrit :
>> Hi François,
>> thank you for offering to help! Perhaps you can take a look at the
>> asciidocs for the user manual we have in `docs/user-manual` and see
>if
>> the this approach can be used to generate HTML and PDF from that.
>>
>> We're working on the new website in the `website` branch (I've just
>> rebased it), there is a build job[1] that gets triggered when you
>make
>> changes to that branch and pushes the resulting static files to
>> `asf-site` branch of the `camel-webiste` subproject[2].
>>
>> For starters perhaps it would be nice to just have `/manual` on the
>> new website with the generated HTML files.
>>
>> Please ping me with any questions, and feel free to change things
>> around this is all work in progress
>>
>> zoran
>>
>> [1]
>https://builds.apache.org/view/C/view/Apache%20Camel/job/Camel/job/website/
>> [2] https://github.com/apache/camel-website/tree/asf-site
>>
>> On Tue, Sep 25, 2018 at 5:08 AM Francois Papon
>> <fr...@openobject.fr> wrote:
>>> Hi,
>>>
>>> I know there is an actual effort on the manual and documentation of
>the
>>> project and I would like to know if I can help on some items ?
>>>
>>> I made templates wich use the Apache website theme for generation of
>>> HTML and PDF from asciidoc files and using the
>asciidoc-maven-plugin.
>>>
>>> If you are interested, you can take a look here :
>>>
>>> https://github.com/fpapon/apache-manual
>>>
>>> Regards,
>>>
>>> --
>>> François Papon
>>> fpapon@apache.org
>>>
>>
Re: [DOC] - generator
Posted by Francois Papon <fr...@openobject.fr>.
Great :)
I will take a look on the issue and make some proposal ;)
regards,
François Papon
fpapon@apache.org
Le 27/09/2018 à 12:19, Zoran Regvart a écrit :
> Hi François,
> we have a issue[1] in JIRA with subtasks, feel free to work on,
> comment or create new issues pertaining the new website there.
>
> And nothing is set in stone, feel free to prototype, experiment...
>
> For myself, I'm having second thoughts about the use of Hugo because
> of the issues it causes around invoking asciidoctor to render
> asciidoc...
>
> zoran
>
> [1] https://issues.apache.org/jira/browse/CAMEL-11492
> On Wed, Sep 26, 2018 at 7:00 PM Francois Papon
> <fr...@openobject.fr> wrote:
>> Thank you Zoran,
>>
>> Let me know how can I continue helping on the website and documentation :)
>>
>> regards,
>>
>> François Papon
>> fpapon@apache.org
>>
>> Le 26/09/2018 à 16:04, Zoran Regvart a écrit :
>>> Hi François,
>>> looks really good, I'll let Jean-Baptiste have a look before I merge.
>>> I've rendered the HTML and the PDF document locally, I think this only
>>> needs a tie in to the website build (I can take care of that) and
>>> we're good to go.
>>>
>>> I really like all the effort you put in making it look professional
>>> and styled with ASF brand, thank you :)
>>>
>>> zoran
>>> On Wed, Sep 26, 2018 at 1:43 PM Francois Papon
>>> <fr...@openobject.fr> wrote:
>>>> Hi Zoran,
>>>>
>>>> I pushed a PR for a discussion around the generation.
>>>>
>>>> I added some guide about how to generate the HTML and PDF in the
>>>> comments of the PR.
>>>>
>>>> I would have some feedbacks before go forward on this :)
>>>>
>>>> regards,
>>>>
>>>> François Papon
>>>> fpapon@apache.org
>>>>
>>>> Le 25/09/2018 à 12:39, Zoran Regvart a écrit :
>>>>> Hi François,
>>>>> thank you for offering to help! Perhaps you can take a look at the
>>>>> asciidocs for the user manual we have in `docs/user-manual` and see if
>>>>> the this approach can be used to generate HTML and PDF from that.
>>>>>
>>>>> We're working on the new website in the `website` branch (I've just
>>>>> rebased it), there is a build job[1] that gets triggered when you make
>>>>> changes to that branch and pushes the resulting static files to
>>>>> `asf-site` branch of the `camel-webiste` subproject[2].
>>>>>
>>>>> For starters perhaps it would be nice to just have `/manual` on the
>>>>> new website with the generated HTML files.
>>>>>
>>>>> Please ping me with any questions, and feel free to change things
>>>>> around this is all work in progress
>>>>>
>>>>> zoran
>>>>>
>>>>> [1] https://builds.apache.org/view/C/view/Apache%20Camel/job/Camel/job/website/
>>>>> [2] https://github.com/apache/camel-website/tree/asf-site
>>>>>
>>>>> On Tue, Sep 25, 2018 at 5:08 AM Francois Papon
>>>>> <fr...@openobject.fr> wrote:
>>>>>> Hi,
>>>>>>
>>>>>> I know there is an actual effort on the manual and documentation of the
>>>>>> project and I would like to know if I can help on some items ?
>>>>>>
>>>>>> I made templates wich use the Apache website theme for generation of
>>>>>> HTML and PDF from asciidoc files and using the asciidoc-maven-plugin.
>>>>>>
>>>>>> If you are interested, you can take a look here :
>>>>>>
>>>>>> https://github.com/fpapon/apache-manual
>>>>>>
>>>>>> Regards,
>>>>>>
>>>>>> --
>>>>>> François Papon
>>>>>> fpapon@apache.org
>>>>>>
>
Re: [DOC] - generator
Posted by Zoran Regvart <zo...@regvart.com>.
Hi François,
we have a issue[1] in JIRA with subtasks, feel free to work on,
comment or create new issues pertaining the new website there.
And nothing is set in stone, feel free to prototype, experiment...
For myself, I'm having second thoughts about the use of Hugo because
of the issues it causes around invoking asciidoctor to render
asciidoc...
zoran
[1] https://issues.apache.org/jira/browse/CAMEL-11492
On Wed, Sep 26, 2018 at 7:00 PM Francois Papon
<fr...@openobject.fr> wrote:
>
> Thank you Zoran,
>
> Let me know how can I continue helping on the website and documentation :)
>
> regards,
>
> François Papon
> fpapon@apache.org
>
> Le 26/09/2018 à 16:04, Zoran Regvart a écrit :
> > Hi François,
> > looks really good, I'll let Jean-Baptiste have a look before I merge.
> > I've rendered the HTML and the PDF document locally, I think this only
> > needs a tie in to the website build (I can take care of that) and
> > we're good to go.
> >
> > I really like all the effort you put in making it look professional
> > and styled with ASF brand, thank you :)
> >
> > zoran
> > On Wed, Sep 26, 2018 at 1:43 PM Francois Papon
> > <fr...@openobject.fr> wrote:
> >> Hi Zoran,
> >>
> >> I pushed a PR for a discussion around the generation.
> >>
> >> I added some guide about how to generate the HTML and PDF in the
> >> comments of the PR.
> >>
> >> I would have some feedbacks before go forward on this :)
> >>
> >> regards,
> >>
> >> François Papon
> >> fpapon@apache.org
> >>
> >> Le 25/09/2018 à 12:39, Zoran Regvart a écrit :
> >>> Hi François,
> >>> thank you for offering to help! Perhaps you can take a look at the
> >>> asciidocs for the user manual we have in `docs/user-manual` and see if
> >>> the this approach can be used to generate HTML and PDF from that.
> >>>
> >>> We're working on the new website in the `website` branch (I've just
> >>> rebased it), there is a build job[1] that gets triggered when you make
> >>> changes to that branch and pushes the resulting static files to
> >>> `asf-site` branch of the `camel-webiste` subproject[2].
> >>>
> >>> For starters perhaps it would be nice to just have `/manual` on the
> >>> new website with the generated HTML files.
> >>>
> >>> Please ping me with any questions, and feel free to change things
> >>> around this is all work in progress
> >>>
> >>> zoran
> >>>
> >>> [1] https://builds.apache.org/view/C/view/Apache%20Camel/job/Camel/job/website/
> >>> [2] https://github.com/apache/camel-website/tree/asf-site
> >>>
> >>> On Tue, Sep 25, 2018 at 5:08 AM Francois Papon
> >>> <fr...@openobject.fr> wrote:
> >>>> Hi,
> >>>>
> >>>> I know there is an actual effort on the manual and documentation of the
> >>>> project and I would like to know if I can help on some items ?
> >>>>
> >>>> I made templates wich use the Apache website theme for generation of
> >>>> HTML and PDF from asciidoc files and using the asciidoc-maven-plugin.
> >>>>
> >>>> If you are interested, you can take a look here :
> >>>>
> >>>> https://github.com/fpapon/apache-manual
> >>>>
> >>>> Regards,
> >>>>
> >>>> --
> >>>> François Papon
> >>>> fpapon@apache.org
> >>>>
> >>
> >
>
--
Zoran Regvart
Re: [DOC] - generator
Posted by Francois Papon <fr...@openobject.fr>.
Thank you Zoran,
Let me know how can I continue helping on the website and documentation :)
regards,
François Papon
fpapon@apache.org
Le 26/09/2018 à 16:04, Zoran Regvart a écrit :
> Hi François,
> looks really good, I'll let Jean-Baptiste have a look before I merge.
> I've rendered the HTML and the PDF document locally, I think this only
> needs a tie in to the website build (I can take care of that) and
> we're good to go.
>
> I really like all the effort you put in making it look professional
> and styled with ASF brand, thank you :)
>
> zoran
> On Wed, Sep 26, 2018 at 1:43 PM Francois Papon
> <fr...@openobject.fr> wrote:
>> Hi Zoran,
>>
>> I pushed a PR for a discussion around the generation.
>>
>> I added some guide about how to generate the HTML and PDF in the
>> comments of the PR.
>>
>> I would have some feedbacks before go forward on this :)
>>
>> regards,
>>
>> François Papon
>> fpapon@apache.org
>>
>> Le 25/09/2018 à 12:39, Zoran Regvart a écrit :
>>> Hi François,
>>> thank you for offering to help! Perhaps you can take a look at the
>>> asciidocs for the user manual we have in `docs/user-manual` and see if
>>> the this approach can be used to generate HTML and PDF from that.
>>>
>>> We're working on the new website in the `website` branch (I've just
>>> rebased it), there is a build job[1] that gets triggered when you make
>>> changes to that branch and pushes the resulting static files to
>>> `asf-site` branch of the `camel-webiste` subproject[2].
>>>
>>> For starters perhaps it would be nice to just have `/manual` on the
>>> new website with the generated HTML files.
>>>
>>> Please ping me with any questions, and feel free to change things
>>> around this is all work in progress
>>>
>>> zoran
>>>
>>> [1] https://builds.apache.org/view/C/view/Apache%20Camel/job/Camel/job/website/
>>> [2] https://github.com/apache/camel-website/tree/asf-site
>>>
>>> On Tue, Sep 25, 2018 at 5:08 AM Francois Papon
>>> <fr...@openobject.fr> wrote:
>>>> Hi,
>>>>
>>>> I know there is an actual effort on the manual and documentation of the
>>>> project and I would like to know if I can help on some items ?
>>>>
>>>> I made templates wich use the Apache website theme for generation of
>>>> HTML and PDF from asciidoc files and using the asciidoc-maven-plugin.
>>>>
>>>> If you are interested, you can take a look here :
>>>>
>>>> https://github.com/fpapon/apache-manual
>>>>
>>>> Regards,
>>>>
>>>> --
>>>> François Papon
>>>> fpapon@apache.org
>>>>
>>
>
Re: [DOC] - generator
Posted by Zoran Regvart <zo...@regvart.com>.
Hi François,
looks really good, I'll let Jean-Baptiste have a look before I merge.
I've rendered the HTML and the PDF document locally, I think this only
needs a tie in to the website build (I can take care of that) and
we're good to go.
I really like all the effort you put in making it look professional
and styled with ASF brand, thank you :)
zoran
On Wed, Sep 26, 2018 at 1:43 PM Francois Papon
<fr...@openobject.fr> wrote:
>
> Hi Zoran,
>
> I pushed a PR for a discussion around the generation.
>
> I added some guide about how to generate the HTML and PDF in the
> comments of the PR.
>
> I would have some feedbacks before go forward on this :)
>
> regards,
>
> François Papon
> fpapon@apache.org
>
> Le 25/09/2018 à 12:39, Zoran Regvart a écrit :
> > Hi François,
> > thank you for offering to help! Perhaps you can take a look at the
> > asciidocs for the user manual we have in `docs/user-manual` and see if
> > the this approach can be used to generate HTML and PDF from that.
> >
> > We're working on the new website in the `website` branch (I've just
> > rebased it), there is a build job[1] that gets triggered when you make
> > changes to that branch and pushes the resulting static files to
> > `asf-site` branch of the `camel-webiste` subproject[2].
> >
> > For starters perhaps it would be nice to just have `/manual` on the
> > new website with the generated HTML files.
> >
> > Please ping me with any questions, and feel free to change things
> > around this is all work in progress
> >
> > zoran
> >
> > [1] https://builds.apache.org/view/C/view/Apache%20Camel/job/Camel/job/website/
> > [2] https://github.com/apache/camel-website/tree/asf-site
> >
> > On Tue, Sep 25, 2018 at 5:08 AM Francois Papon
> > <fr...@openobject.fr> wrote:
> >> Hi,
> >>
> >> I know there is an actual effort on the manual and documentation of the
> >> project and I would like to know if I can help on some items ?
> >>
> >> I made templates wich use the Apache website theme for generation of
> >> HTML and PDF from asciidoc files and using the asciidoc-maven-plugin.
> >>
> >> If you are interested, you can take a look here :
> >>
> >> https://github.com/fpapon/apache-manual
> >>
> >> Regards,
> >>
> >> --
> >> François Papon
> >> fpapon@apache.org
> >>
> >
>
>
--
Zoran Regvart
Re: [DOC] - generator
Posted by Francois Papon <fr...@openobject.fr>.
Hi Zoran,
I pushed a PR for a discussion around the generation.
I added some guide about how to generate the HTML and PDF in the
comments of the PR.
I would have some feedbacks before go forward on this :)
regards,
François Papon
fpapon@apache.org
Le 25/09/2018 à 12:39, Zoran Regvart a écrit :
> Hi François,
> thank you for offering to help! Perhaps you can take a look at the
> asciidocs for the user manual we have in `docs/user-manual` and see if
> the this approach can be used to generate HTML and PDF from that.
>
> We're working on the new website in the `website` branch (I've just
> rebased it), there is a build job[1] that gets triggered when you make
> changes to that branch and pushes the resulting static files to
> `asf-site` branch of the `camel-webiste` subproject[2].
>
> For starters perhaps it would be nice to just have `/manual` on the
> new website with the generated HTML files.
>
> Please ping me with any questions, and feel free to change things
> around this is all work in progress
>
> zoran
>
> [1] https://builds.apache.org/view/C/view/Apache%20Camel/job/Camel/job/website/
> [2] https://github.com/apache/camel-website/tree/asf-site
>
> On Tue, Sep 25, 2018 at 5:08 AM Francois Papon
> <fr...@openobject.fr> wrote:
>> Hi,
>>
>> I know there is an actual effort on the manual and documentation of the
>> project and I would like to know if I can help on some items ?
>>
>> I made templates wich use the Apache website theme for generation of
>> HTML and PDF from asciidoc files and using the asciidoc-maven-plugin.
>>
>> If you are interested, you can take a look here :
>>
>> https://github.com/fpapon/apache-manual
>>
>> Regards,
>>
>> --
>> François Papon
>> fpapon@apache.org
>>
>
Re: [DOC] - generator
Posted by Jean-Baptiste Onofré <jb...@nanthrax.net>.
+1
We also have the same approach in Karaf.
Regards
JB
Le 25 sept. 2018 à 05:39, à 05:39, Francois Papon <fr...@openobject.fr> a écrit:
>
Re: [DOC] - generator
Posted by Francois Papon <fr...@openobject.fr>.
Hi Zoran,
Thanks, I will check for having a '/manual' with HTML files.
For the generation, I already use it for the Apache Unomi project, you
can have a preview here :
* HTML : https://unomi.incubator.apache.org/manual/latest/index.html
* PDF :
https://dist.apache.org/repos/dist/release/incubator/unomi/1.3.0-incubating/unomi-manual-1_3_x.pdf
For the ping, you prefer IRC or Slack channel ?
Regards,
François Papon
fpapon@apache.org
Le 25/09/2018 à 12:39, Zoran Regvart a écrit :
> Hi François,
> thank you for offering to help! Perhaps you can take a look at the
> asciidocs for the user manual we have in `docs/user-manual` and see if
> the this approach can be used to generate HTML and PDF from that.
>
> We're working on the new website in the `website` branch (I've just
> rebased it), there is a build job[1] that gets triggered when you make
> changes to that branch and pushes the resulting static files to
> `asf-site` branch of the `camel-webiste` subproject[2].
>
> For starters perhaps it would be nice to just have `/manual` on the
> new website with the generated HTML files.
>
> Please ping me with any questions, and feel free to change things
> around this is all work in progress
>
> zoran
>
> [1] https://builds.apache.org/view/C/view/Apache%20Camel/job/Camel/job/website/
> [2] https://github.com/apache/camel-website/tree/asf-site
>
> On Tue, Sep 25, 2018 at 5:08 AM Francois Papon
> <fr...@openobject.fr> wrote:
>> Hi,
>>
>> I know there is an actual effort on the manual and documentation of the
>> project and I would like to know if I can help on some items ?
>>
>> I made templates wich use the Apache website theme for generation of
>> HTML and PDF from asciidoc files and using the asciidoc-maven-plugin.
>>
>> If you are interested, you can take a look here :
>>
>> https://github.com/fpapon/apache-manual
>>
>> Regards,
>>
>> --
>> François Papon
>> fpapon@apache.org
>>
>