On Sun, 20 Apr 2025 at 09:44, sebb <seb...@gmail.com> wrote:
> On Sun, 20 Apr 2025 at 01:10, Niall Pemberton <niall.pember...@gmail.com>
> wrote:
> >
> > Hi,
> >
> > I have created a PoC to move the current Attic site generation from XDOC
> &
> > Forrest to Markdown & Jekyll:
> > https://github.com/niallkp/attic-jekyll-site
> >
> > Each project has a YAML file with details about it and its retirement and
> > that drives everything:
> > - generates a project page
> > - updates the Process Tracking Page
> > - updates the menu/list of projects in the Attic
> > - Generates the "flag" files for the Attic Banner on the site & Wiki
> >
> > At the moment it is pretty much functionally complete, but I've put a
> TODO
> > list in the README.md or the project:
> > https://github.com/niallkp/attic-jekyll-site/blob/main/README.md
> >
> > Thoughts/feedback welcome
>
> Looks good, and could be worth pursuing, but there are some missing
> features that are essential for a full evaluation.
>
> There needs to be an action to generate the output so it can be checked.
> Ideally so the site can be viewed directly.
>
I have manually published the generated site here for now, so you can have
a look:
https://niallkp.github.io/
Niall
>
> It looks like the CWKI flags are generated as part of the website.
> However, the Confluence webserver host does not have access to the
> Attic website (unlike the TLP server, which hosts Attic as well as the
> retired sites).
>
> I don't think it makes sense to checkout the entire Attic website on
> the Confluence server merely to get access to the flag files.
> Probably need to use a separate GHA to generate the required files in
> a separate branch.
> (AFAICT, Git does not support checkout of a sub-directory, at least
> not in a way that can be used by Puppet config)
>
> There are some Python scripts in the existing codebase that need to be
> converted to use the new format.
> Probably only retire.py needs significant work.
>
> Minor nit: the plugin files say that the flagged files are used by a
> Lua filter to decide whether to add the banner.
> That is not the case; the httpd config extracts the project name from
> the request, and checks to see if there is a flag file with that name.
> If so, the Lua filter is applied to the output.
>
> > Thanks
> >
> > Niall
>
