Function generate_markdown_chapter

build_ebook.py:106–134

(
    chapter: MarkdownChapter, converted_image_dir: Path
)

def generate_markdown_chapter(
    chapter: MarkdownChapter, converted_image_dir: Path
) -> str:
    contents = f"# {chapter.title}\n\n{chapter.contents}"

    # Adjust titles based on depth of chapter itself
    if chapter.depth > 0:

        def adjust_title_depth(match: Match) -> str:
            return ("#" * chapter.depth) + match.group(0)

        contents = re.sub(r"#+ ", adjust_title_depth, contents)

    # Fix image links
    contents = contents.replace("/images/", f"{converted_image_dir.as_posix()}/")
    contents = contents.replace(".svg", ".png")

    # Fix remaining relative links
    contents = contents.replace("(/code", "(https://vulkan-tutorial.com/code")
    contents = contents.replace("(/resources", "(https://vulkan-tutorial.com/resources")

    # Fix chapter references
    def fix_chapter_reference(match: Match) -> str:
        target = match.group(1).lower().replace("_", "-").split("/")[-1]
        return f"](#{target})"

    contents = re.sub(r"\]\(!([^)]+)\)", fix_chapter_reference, contents)

    return contents


def compile_full_markdown(