copy-source-tree-docs.sh

#!/bin/bash
##
## Copyright (c) Microsoft Corporation.
## Licensed under the MIT License.
##

# Layout a few markdown files from the source tree into the doc tree so they can be read there too.
# Fixup any links to point back to the main site though.

set -eu
set -x

scriptdir=$(dirname "$(readlink -f "$0")")
# Move to the repo root.
cd "$scriptdir/.."

rm -rf doc/source/source_tree_docs/
mkdir -p doc/source/source_tree_docs/

for readme_file_path in README.md mlos_core/README.md mlos_bench/README.md mlos_viz/README.md; do
    file_dir=$(dirname "$readme_file_path")
    mkdir -p "doc/source/source_tree_docs/$file_dir"

    cp "$readme_file_path" "doc/source/source_tree_docs/$file_dir/index.md"

    case "$OSTYPE" in
        darwin*)
            sed_args='-i ""'
            ;;
        *gnu*)
            sed_args='-i'
            ;;
        default)
            echo "Unsupported OS: $OSTYPE"
            exit 1
            ;;
    esac

    # Tweak source source code links.
    sed $sed_args -r -e "s|\]\(([^:#)]+)(#[a-zA-Z0-9_-]+)?\)|\]\(https://github.com/microsoft/MLOS/tree/main/$file_dir/\1\2\)|g" \
        "doc/source/source_tree_docs/$file_dir/index.md"
    # Tweak the lexers for local expansion by pygments instead of github's.
    sed $sed_args -r -e 's/```jsonc/```json/' \
        "doc/source/source_tree_docs/$file_dir/index.md"
done

# Do an explicit fixup for some static content.
sed $sed_args -r -e 's#="[^"]*(_static/[^"]+)"#="../\1"#g' \
    "doc/source/source_tree_docs/index.md"