added pandoc as renderer

This commit is contained in:
2026-02-08 18:03:05 -05:00
parent a56cd665b0
commit 164cb5d980
6 changed files with 33 additions and 9 deletions

View File

@@ -11,7 +11,7 @@ Top-level fields:
2. `repo_storage_dir` (string, required)
Directory where git repositories are cloned or updated.
3. `renderer` (string, optional)
Markdown renderer to use. Allowed values: `default`, `py-gfm`.
Markdown renderer to use. Allowed values: `default`, `py-gfm`, `pandoc`.
4. `git_repositories` (array, optional)
List of git repositories to manage. Default is an empty list.
5. `directories` (array, optional)
@@ -53,7 +53,7 @@ Top-level fields:
3. `author` (object, optional)
Inherited author for this directory and its children. Must resolve to a single author.
4. `renderer` (string, optional)
Markdown renderer to use for this directory. Allowed values: `default`, `py-gfm`.
Markdown renderer to use for this directory. Allowed values: `default`, `py-gfm`, `pandoc`.
If omitted, it inherits from the parent scope.
5. `subdirectories` (object, optional)
Explicit list of subdirectories to traverse.
@@ -80,6 +80,11 @@ The `renderer` field inherits implicitly: if omitted, the renderer is inherited
from the parent scope; if specified, it overrides the parent without an explicit
`inherit` flag.
Renderer dependencies:
1. `default` uses the Python `Markdown` library.
2. `py-gfm` requires the `py_gfm` package (imported as `mdx_gfm`).
3. `pandoc` requires the `pandoc` binary to be available on PATH.
`files` entries:
Each key is a Markdown file name (relative to the manifest directory).
@@ -95,7 +100,7 @@ Each value is an object with the following fields:
4. `last_modified` (string, optional)
Manual override for the post modified time in `YYYY-MM-DD hh:mm` format.
5. `renderer` (string, optional)
Markdown renderer to use for this file. Allowed values: `default`, `py-gfm`.
Markdown renderer to use for this file. Allowed values: `default`, `py-gfm`, `pandoc`.
If omitted, it inherits from the parent scope.
6. `categories` (object, optional)
Overrides categories for this file. Uses the same `content` and `inherit` fields