FIX: Add pre-commit Blacken-docs hooks
- [x] Part of  #46865 (Replace xxxx with the GitHub issue number)
- [x] [Tests added and passed](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#writing-tests) if fixing a bug or adding a new feature
- [x] All [code checks passed](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#pre-commit).
- [x] Added [type annotations](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#type-hints) to new arguments/methods/functions.
- [x] Added an entry in the latest `doc/source/whatsnew/vX.X.X.rst` file if fixing a bug or adding a new feature.

This PR adds the configuration for the `blacken-docs` hook to the project's `.pre-commit-config.yaml` file. The `blacken-docs` hook applies the Black code formatter to reStructuredText (reST) files.

To accommodate potential parsing errors encountered with certain code blocks, the `--skip-errors` argument is included in the hook configuration. This argument instructs `blacken-docs` to skip errors and continue processing other files and blocks.

By including the `blacken-docs` hook with error skipping, we can ensure consistent formatting of reST files while allowing exceptions for code blocks that may contain unsupported syntax.

Please review this PR and provide any feedback or suggestions for improvement.

@noatamir @phofl SciPy Sprint 2023


Thanks for the PR! By putting `partially closes #...` in the OP, I believe merging this will automatically close the corresponding issue. This is because GitHub does not pickup on the "partially". Instead, I recommend "Part of #..." This pull request is stale because it has been open for thirty days with no activity. Please [update](https://pandas.pydata.org/pandas-docs/stable/development/contributing.html#updating-your-pull-request) and respond to this comment if you're still interested in working on this. Thanks for the pull request, but it appears to have gone stale. If interested in continuing, please merge in the main branch, address any review comments and/or failing tests, and we can reopen.