The current version is certainly way simpler than before, I liked it.

I agree with moving every "data" (members, projects, etc.) to its own data file.

I still prefer all typesetting performed in AsciiDoc. (I am not
telling you to do so immediately. But that is where I'd like this
initiative to go.)

As you yourself experienced from first hand by breaking
`logging.staged.apache.org` domain, anything INFRA supports comes with
a big catch. I prefer rolling our own CI-triggered Jekyll compiler,
rather than relying on the one INFRA provides. But again, this we can
tackle at a later stage. Though at least now you can relate to my
"INFRA fatigue". ;-P

On Thu, Oct 12, 2023 at 6:16 PM Christian Grobmeier
<grobme...@apache.org> wrote:
>
> Hello,
>
> I made the Jekyll branch work with the staging environment:
> https://logging.staged.apache.org/
>
> When you change something in the sources, it will be automatically deployed 
> to Staging.
>
> We also have a "news section", aka blog:
> https://logging.staged.apache.org/blog/
>
> To add or change a project, you made want to edit:
> https://github.com/apache/logging-site/blob/jekyll/_data/projects.yml
> You can edit it directly in Github UI if you prefer to try it out.
>
> It will take a few seconds to build and deploy.
>
> I want to move the Team members to a data file as well.
>
> If no objections, I'd like to move this to asf-site
>
> Kind regards,
> Christian
>
>
> On Tue, Oct 10, 2023, at 23:10, Christian Grobmeier wrote:
> > Hello,
> >
> > Based on recent comments, I made a branch for using Jekyll on the
> > leading site. It's a branch, we can discard it. The migration took me
> > 1.5h, excluding this e-mail - not much wasted.
> >
> > https://github.com/apache/logging-site/tree/jekyll
> >
> > This is not yet auto-deployed, but if nobody opposes it, I will move
> > on, merge, and autodeploy.
> >
> > Here is some info:
> >
> > Jekyll supports data files like this:
> > https://github.com/apache/logging-site/blob/jekyll/_data/projects.yml
> >
> > In the future, one could modify those data files directly from GitHub
> > UI to update a status or a team member. It would be autodeployed then.
> > The code for the output is also simple:
> >
> > https://github.com/apache/logging-site/blob/jekyll/index.html
> >
> > The amount of HTML has decreased. In addition, I was able to use
> > Flexbox, which is built-in to browsers (no more slow Bootstrap in this
> > case)
> >
> > We also can make use of SCSS now, which can use advanced CSS (in this
> > case only nesting):
> > https://github.com/apache/logging-site/blob/jekyll/css/site.scss#L44
> >
> > The current team list could be moved to a data file, too, but I left it
> > as adoc to showcase that this Jekyll page can work with adoc as well:
> > https://github.com/apache/logging-site/blob/jekyll/team-list.adoc
> >
> > If you want to work with Jekyll, you can run the scripts:
> >
> > ./run-docker-build.sh (only one time; Docker needs to be installed)
> > ./run-jekyll.sh (when you want to work)
> >
> > This way, you can build locally and check. However, you don't need to
> > do this to update tiny things quickly.
> >
> > Please let me know if you want to object; otherwise, I would love to
> > move this forward.
> >
> > If we, at some later point in time, move on to something like Antora, I
> > will gladly help to migrate; however, since we are using adoc for this
> > website as well, it should be straightforward.
> >
> > As soon as I have a go for this, I will prepare a blog section
> > announcing the latest releases and preparing everything for some
> > announcements we had in mind on the PMC list.
> >
> > Kind regards,
> > Christian

Reply via email to