celix-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Pepijn Noltes <pepijnnol...@gmail.com>
Subject Re: [DISCUSS] Celix site
Date Mon, 07 Jan 2019 19:57:21 GMT
On Mon, Jan 7, 2019 at 7:05 PM Roy Lenferink <rlenferink@apache.org> wrote:
>
> Thanks Pepijn! In the meantime, INFRA moved our site so from now on we're
> using our newly developed site ;)

Nice, overall looks good :)
I do see some issues with the subproject docs...


> Having a look at Apache Xerces, I noticed they are using doxygen as well
> [1]. So maybe we can follow their approach.
> I'll have a look into this as well shortly.
>
> - Roy
>
> [1] http://xerces.apache.org/xerces-c/apiDocs-3/annotated.html
>
> Op za 5 jan. 2019 om 12:09 schreef Pepijn Noltes <pepijnnoltes@gmail.com>:
>
> > Hi Roy,
> >
> > Sorry for the late reply.
> >
> > Great work, I think the website looks great. Clean design :). And
> > thanks for updating the information (i.e. how to apply patches,
> > realising, etc).
> > Do you have any idea if (and if yes, how) we can add API (i.e.
> > doxygen) information to the website?
> >
> > Greetings,
> > Pepijn
> >
> > On Wed, Jan 2, 2019 at 11:15 PM Roy Lenferink <rlenferink@apache.org>
> > wrote:
> > >
> > > Without any objections for the past 72 hours, I've merged the changes in
> > to
> > > the celix-site repository.
> > > I'll open a vote shortly for moving over from the current svnpubsub to a
> > > gitpubsub approach.
> > >
> > > - Roy
> > >
> > > Op zo 30 dec. 2018 om 18:21 schreef Roy Lenferink <rlenferink@apache.org
> > >:
> > >
> > > > Hi all,
> > > >
> > > > Just before the year ends, I finished a proof of concept which IMO may
> > > > replace the current Celix website. Our current site still resides in
> > SVN
> > > > and is using the Apache CMS for publishing any changes to the website.
> > This
> > > > way it is hard for someone to contribute changes back to our site or
> > even
> > > > for Celix committers it is hard to track down any errors during the
> > build
> > > > process. As an example, with our move to Gitbox, the link on the Celix
> > site
> > > > needed to be updated as well, which broke the side-menu its design [1]
> > > >
> > > > A few months ago, the celix-site repository was created [2] with the
> > > > intention to move to git.
> > > >
> > > > I have taken the liberty to redesign the website using Jekyll [3] as
> > > > static website generator and using bootstrap (MIT licensed) for the
> > theme
> > > > of the website [4]. The source of this is still in my fork of the
> > > > celix-site repository if anyone wants to view it [5]. The main celix
> > > > repository is added as submodule and markdown files are copied from the
> > > > celix repository to the celix-site repository were they are converted
> > to
> > > > HTML by Jekyll. I've chosen Jekyll over another static website
> > generator as
> > > > Hugo because of Jekylls support for plugins. Community support for
> > Jekyll
> > > > is a bit broader as well.
> > > >
> > > > The master branch will be used for the source of the website, whereas
> > the
> > > > asf-site branch will be used for the generated content of the website.
> > A
> > > > live example of the (latest) generated website can be viewed here [6].
> > The
> > > > download page is the only thing not working on my hosted instance, but
> > when
> > > > it will be hosted on ASF infrastructure this won't be a problem.
> > Comparing
> > > > an input markdown file [7] with the generated output [8] I can say
> > > > everything is still perfectly readable.
> > > >
> > > > Currently, I am using the publish.sh script to deploy the site from the
> > > > master to the asf-site branch, but ideally this will be executed by a
> > > > Jenkins job on builds.apache.org.
> > > >
> > > > Are there any objections before I merge the changes back to the main
> > > > celix-site repository?
> > > >
> > > > - Roy
> > > >
> > > > [1] https://celix.apache.org
> > > > [2] https://github.com/apache/celix-site
> > > > [3] https://jekyllrb.com/
> > > > [4] https://getbootstrap.com/
> > > > [5] https://github.com/rlenferink/celix-site
> > > > [6] http://celix.roylenferink.nl/
> > > > [7]
> > > >
> > https://github.com/apache/celix/blob/master/documents/getting_started/creating_a_simple_bundle.md
> > > > [8]
> > > >
> > http://celix.roylenferink.nl/docs/celix/documents/getting_started/creating_a_simple_bundle.html
> > > >
> > > >
> >

Mime
View raw message