#! /usr/bin/env python3 # SPDX-License-Identifier: GPL-2.0 # # Copyright © 2025, Oracle and/or its affiliates. # Author: Vegard Nossum """Generate HTML redirects for renamed Documentation/**.rst files using the output of tools/docs/gen-renames.py. Example: tools/docs/gen-redirects.py --output Documentation/output/ < Documentation/.renames.txt """ import argparse import os import sys parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) parser.add_argument('-o', '--output', help='output directory') args = parser.parse_args() for line in sys.stdin: line = line.rstrip('\n') old_name, new_name = line.split(' ', 2) old_html_path = os.path.join(args.output, old_name + '.html') new_html_path = os.path.join(args.output, new_name + '.html') if not os.path.exists(new_html_path): print(f"warning: target does not exist: {new_html_path} (redirect from {old_html_path})") continue old_html_dir = os.path.dirname(old_html_path) if not os.path.exists(old_html_dir): os.makedirs(old_html_dir) relpath = os.path.relpath(new_name, os.path.dirname(old_name)) + '.html' with open(old_html_path, 'w') as f: print(f"""\ This page has moved

This page has moved to {new_name}.

""", file=f)