On 18 April 2018 at 07:43, Jan Iversen <[email protected]> wrote: > > >> On 18 Apr 2018, at 03:04, sebb <[email protected]> wrote: >> >> The SVN tree under: >> >> https://svn.apache.org/repos/asf/attic/site-test >> >> has a sample implementation of the site generation using Jekyll >> >> This uses projects.json to create the list of projects for the RH side >> of pages as well as generating the individual pages. >> >> It needs some tweaking and documenting. >> >> For simplicity the page templates were left as HTML with minimal tweaks. >> In the longer term they should be converted to markdown for easier >> maintenance. >> >> The intention is that it will only be necessary to update >> projects.json (and create the flagged file) when retiring a project. > Surely the script could easily create the flagged file/directory, which would > be one step less to do.
[I did not see that comment previously.] This only needs to be done for projects whose websites have not already been tweaked to add the headings, so there needs to be a per-project setting to control this. I've not looked into adding this to the Jekyll build, but it would not be that difficult to process the data as a separate step to extract the file names, and run that as part of a build script. It only has to be done once, so it does not really belong in the main site build. >> >> The output is currently directed to docs2/ to make it easy to compare >> the files with the originals which are in docs/. >> >> AFAICT all the project-specific parts of the website are now derived >> from the JSON file.
