CMS Migration

1. Observations

   • tools/announce.sh requires many changes to update md files in git
   • several dev pages including release.md, devnotes.md, and index.md refer to the ASF CMS and will require updates
   • httpd/site/trunk/docs has already moved, but the documentation mentions it
   • various places refer to mbox archives which are now 404
   • left navigation could use right margin/padding for some long links like Apache Traffic Control

2. Markdown conversions

   • Rename all mdtext files as md files
   • Headings with needed the # between title and annotation removed
   • Definition lists are no longer supported. Made appropriate changes
   • Converted many httpd.apache.org links to internal links
   • Modified most and to markdown auto or explicit fenced code blocks
   • Improved dev/patches layout
   • Assorted other changes

   See changes.txt

3. Theme Template

   • CMS templates were converted into base.html
   • markdown is no longer allowed within the templates. mdtext parts are copied in as html.
   • Flood leftnav is controlled via metadata on page
   • Copyright year is automatically updated to the current year of the build

4. Configuration

   See pelicanconf.yaml