tree: 3345a8cc4d1091fa45208f3acf271ef660f46cc8 [path history] [tgz]
  1. changes.txt
  2. README.md
migration/README.md

CMS Migration

  1. Markdown conversions

    • Rename from cmsPage to md
    • All md files need a title
    • Prefer https protocol
    • Prefer internal links for flex.apache.org
    • HTML blocks must be contiguous. blank lines will move html into code blocks
    • Headings should not use trailing ##
    • Fenced code blocks differ and charactoer entities must not be used

    See changes.txt

  2. Theme Template

    CMS templates were converted into base.html

  3. Configuration

    See pelicanconf.py

  4. Pelican ASF plugin configuration

    asfgenid.py

    • ‘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