This directory contains make rules for managing Markdown files.

Usage: make <command> [<ENV_VAR>=<value> <ENV_VAR>=<value> ...]

Generates an asset URL (derived from the current Git hash) for inclusion in a project Markdown file.

$ make markdown-asset-url MARKDOWN_ASSET_PATH='./README.md'

The command supports the following environment variables:

• MARKDOWN_ASSET_PATH: a file path relative to the project root directory; e.g., ./README.md.

Updates the table of contents of namespace Markdown files.

$ make markdown-namespace-tocs

The command supports the following environment variables:

• MARKDOWN_PATTERN: filename pattern; e.g., *.md.
• MARKDOWN_FILTER: file path pattern; e.g., .*/math/base/special/.*

$ make markdown-namespace-tocs MARKDOWN_PATTERN='README.md' MARKDOWN_FILTER='.*/math/base/special/.*'

This command is useful when wanting to glob for Markdown files (e.g., process all Markdown files for a particular package).

Updates the table of contents of a specified list of namespace Markdown files.

$ make markdown-namespace-tocs-files FILES='/foo/foo.md /foo/bar.md'

The command supports the following environment variables:

• FILES: list of Markdown files.

This command is useful when wanting to process a list of Markdown files generated by some other command (e.g., a list of changed Markdown files obtained via git diff).

Updates Markdown files by resolving package identifiers to GitHub repository URLs.

$ make markdown-pkg-urls

The command supports the following environment variables:

• MARKDOWN_PATTERN: filename pattern; e.g., *.md.
• MARKDOWN_FILTER: file path pattern; e.g., .*/math/base/special/.*

$ make markdown-pkg-urls MARKDOWN_PATTERN='README.md' MARKDOWN_FILTER='.*/math/base/special/.*'

This command is useful when wanting to glob for Markdown files (e.g., process all Markdown files for a particular package).

Updates a specified list of Markdown files by resolving package identifiers to GitHub repository URLs.

$ make markdown-pkg-urls-files FILES='/foo/foo.md /foo/bar.md'

The command supports the following environment variables:

• FILES: list of Markdown files.

This command is useful when wanting to process a list of Markdown files generated by some other command (e.g., a list of changed Markdown files obtained via git diff).

Updates Markdown files by updating related packages sections (i.e., "See Also" sections).

$ make markdown-related

The command supports the following environment variables:

• MARKDOWN_PATTERN: filename pattern; e.g., *.md.
• MARKDOWN_FILTER: file path pattern; e.g., .*/math/base/special/.*

$ make markdown-related MARKDOWN_PATTERN='README.md' MARKDOWN_FILTER='.*/math/base/special/.*'

This command is useful when wanting to glob for Markdown files (e.g., process all Markdown files for a particular package).

Updates a specified list of Markdown files by updating their related packages sections.

$ make markdown-related-files FILES='/foo/foo.md /foo/bar.md'

The command supports the following environment variables:

• FILES: list of Markdown files.

This command is useful when wanting to process a list of Markdown files generated by some other command (e.g., a list of changed Markdown files obtained via git diff).

Processes Markdown files containing Markdown equation elements.

$ make markdown-equations

The command supports the following environment variables:

• MARKDOWN_PATTERN: filename pattern; e.g., *.md.
• MARKDOWN_FILTER: file path pattern; e.g., .*/math/base/special/.*

$ make markdown-equations MARKDOWN_PATTERN='README.md' MARKDOWN_FILTER='.*/math/base/special/.*'

This command is useful when wanting to glob for Markdown files (e.g., process all Markdown files for a particular package).

Processed files are committed to source control. Accordingly, this command must be run on a clean working directory.

Transforms Markdown files containing equation comment markup to include image equation elements.

$ make markdown-img-equations

The command supports the following environment variables:

• MARKDOWN_PATTERN: filename pattern; e.g., *.md.
• MARKDOWN_FILTER: file path pattern; e.g., .*/math/base/special/.*

$ make markdown-img-equations MARKDOWN_PATTERN='README.md' MARKDOWN_FILTER='.*/math/base/special/.*'

This command is useful when wanting to glob for Markdown files (e.g., process all Markdown files for a particular package).

Transforms a specified list of Markdown files containing equation comment markup to include image equation elements.

$ make markdown-img-equations-files FILES='/foo/foo.md /foo/bar.md'

The command supports the following environment variables:

• FILES: list of Markdown files.

This command is useful when wanting to process a list of Markdown files generated by some other command (e.g., a list of changed Markdown files obtained via git diff).

Inserts resource URLs into Markdown image equation elements.

$ make markdown-img-equations-src-urls

The command supports the following environment variables:

• MARKDOWN_PATTERN: filename pattern; e.g., *.md.
• MARKDOWN_FILTER: file path pattern; e.g., .*/math/base/special/.*

$ make markdown-img-equations-src-urls MARKDOWN_PATTERN='README.md' MARKDOWN_FILTER='.*/math/base/special/.*'

This command is useful when wanting to glob for Markdown files (e.g., process all Markdown files for a particular package).

This command assumes that image SVG equation files already exist and have been committed to source control. See markdown-svg-equations.

Inserts resource URLs into Markdown image equation elements for a specified list of Markdown files.

$ make markdown-img-equations-src-urls-files FILES='/foo/foo.md /foo/bar.md'

The command supports the following environment variables:

• FILES: list of Markdown files.

This command is useful when wanting to process a list of Markdown files generated by some other command (e.g., a list of changed Markdown files obtained via git diff).

Generates SVG equation files from Markdown equation comments.

$ make markdown-svg-equations

The command supports the following environment variables:

• MARKDOWN_PATTERN: filename pattern; e.g., *.md.
• MARKDOWN_FILTER: file path pattern; e.g., .*/math/base/special/.*

$ make markdown-svg-equations MARKDOWN_PATTERN='README.md' MARKDOWN_FILTER='.*/math/base/special/.*'

This command is useful when wanting to glob for Markdown files (e.g., process all Markdown files for a particular package).

Generates SVG equation files from Markdown equation comments for a specified list of Markdown files.

$ make markdown-svg-equations-files FILES='/foo/foo.md /foo/bar.md'

The command supports the following environment variables:

• FILES: list of Markdown files.

This command is useful when wanting to process a list of Markdown files generated by some other command (e.g., a list of changed Markdown files obtained via git diff).

Removes SVG equation files.

$ make clean-markdown-svg-equations

The command supports the following environment variables:

• SVG_EQUATIONS_PATTERN: filename pattern; e.g., equation*.svg.
• SVG_EQUATIONS_FILTER: file path pattern; e.g., .*/math/base/special/.*

$ make clean-markdown-svg-equations SVG_EQUATIONS_PATTERN='equation*.svg' SVG_EQUATIONS_FILTER='.*/math/base/special/.*'