docs: Link uv's installation instructions to uv's website

[wangshangsam]

What does this PR do ?

• Link uv's installation instructions to uv's website.
• Add a parsing callback in docs/conf.py to convert GitHub alerts in Markdowns into RST properly. (since myst-parser doesn't seem to support it).
• Replace pyrefly's pre-commit hook from a repo hook to a local hook that runs pyrefly via uv's dev environment.

Issues

• There are situations where pip install uv is not suitable. For example, for conda users who have a default base conda environment, pip install uv would only install uv into the base environment; in this case, using the standalone installer would be more suitable. Therefore, this PR replaces pip install uv with a link to the installation instructions from uv's website.
• Myst-parser doesn't seem to support converting GitHub alerts
• When running pre-commit, since pyrefly's .pre-commit-hooks.yaml (that Meta people wrote) doesn't launch pyrefly through uv, an Executable pyrefly not found is thrown.

Usage

N/A

Before your PR is "Ready for review"

Pre checks:

• Make sure you read and followed Contributor guidelines
• Did you write any new necessary tests?
• Did you run the unit tests and functional tests locally? Visit our Testing Guide for how to run tests
• Did you add or update any necessary documentation? Visit our Document Development Guide for how to write, build and test the docs.

Additional Information

[terrykong]

great change. good point about uv install. i didn't realize that markdown had builtin admonitions.

I tried rendering it in myst-parser and sadly it doesn't recognize.

is there a way to get it to work? if not, we probably need the front page readme to be "vanilla" markdown so it renders in both places just fine (and we can use more specific myst-parser stuff in the docs/ folder)

[wangshangsam]

is there a way to get it to work?

There might be one. Something alone the direction of the adding following in conf.py:

_GITHUB_ADMONITIONS = {
    "> [!NOTE]": "note",
    "> [!TIP]": "tip",
    "> [!IMPORTANT]": "important",
    "> [!WARNING]": "warning",
    "> [!CAUTION]": "caution",
}

def run_convert_github_admonitions_to_rst(app, filename, lines):
    # loop through lines, replace github admonitions
    for i, orig_line in enumerate(lines):
        orig_line_splits = orig_line.split("\n")
        replacing = False
        for j, line in enumerate(orig_line_splits):
            # look for admonition key
            for admonition_key in _GITHUB_ADMONITIONS:
                if admonition_key in line:
                    line = line.replace(admonition_key, ":::{" + _GITHUB_ADMONITIONS[admonition_key] + "}\n")
                    # start replacing quotes in subsequent lines
                    replacing = True
                    break
            else:
                # replace indent to match directive
                if replacing and "> " in line:
                    line = line.replace("> ", "  ")
                elif replacing:
                    # missing "> ", so stop replacing and terminate directive
                    line = f"\n:::\n{line}"
                    replacing = False
            # swap line back in splits
            orig_line_splits[j] = line
        # swap line back in original
        lines[i] = "\n".join(orig_line_splits)


def setup(app):
    app.connect("source-read", run_convert_github_admonitions_to_rst)

(reference: executablebooks/MyST-Parser#845 (comment))

I'll give this a try. If it doesn't work, I'll roll back to vanilla markdown.

[wangshangsam]

Works like a charm :)

I'm pushing the conf.py change now.

[terrykong]

nice! just mentioning this issue which might be solvable with the mechanic you've introduced

#577

not blocking this PR but just leaving a comment as ref