| # 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 {#link} 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 <pre> and <blockquote> to markdown auto or explicit fenced code blocks | |
| - Improved dev/patches layout | |
| - Assorted other changes | |
| See [changes.txt](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](../pelicanconf.yaml) |