CMS Migration

  1. Markdown conversions

    • Rename from mdtext to md
    • All files must have a title
    • Switched some spans to divs
    • Included alt text for images and switched some imag tags to markdown
    • Cleaned up list indentation paticulatly in ./content/
    • Changed many fully qualified hyperlinks to to be internal particularly on ./content/

    See changes.txt

  2. Theme Template

    CMS templates were converted into base.html

  3. Configuration


  4. Pelican ASF plugin configuration

    • ‘unsafe_tags’: True # allow style, script, and iframe tags
    • ‘metadata’: False # no metadata replacement in markdown files
    • ‘elements’: False # CMS didn't use mdx_elementid featuresz
    • ‘headings’: True # Fix up headings w/ permalinks
    • ‘headings_re’: r'^h[1-4]'
    • ‘permalinks’: True,
    • ‘toc’: False # does not use [TOC]
    • ‘toc_headers’: r“h[1-4]”,
    • ‘tables’: True # Fix up for markdown table class
  5. Documentation branches

    Setup two branches for documentation that is updated separately from the main site.

    • builds branch has the documentation from TLP releases.
    • docs branch has the documentation from Incubating releases.