Title: Use `:cpy-file:` throughout the Devguide by ezio-melotti · Pull Request #984 · python/devguide · GitHub
Open Graph Title: Use `:cpy-file:` throughout the Devguide by ezio-melotti · Pull Request #984 · python/devguide
X Title: Use `:cpy-file:` throughout the Devguide by ezio-melotti · Pull Request #984 · python/devguide
Description: This PR replaces the use of :file: with :cpy-file: (introduced in #961) in most places. Since the generated links are now checked by make linkcheck, I also went through and corrected some of those. There are a few broken links that I haven't touched yet: (developer-workflow/grammar: line 40) broken https://github.com/python/cpython/blob/main/Include/Python-ast.h (developer-workflow/grammar: line 33) broken https://github.com/python/cpython/blob/main/Include/token.h (internals/compiler: line 516) broken https://github.com/python/cpython/blob/main/Include/code.h (internals/compiler: line 488) broken https://github.com/python/cpython/blob/main/Python/peephole.c Include/Python-ast.h was removed by @vstinner python/cpython#24933 Include/token.h was removed by @vstinner python/cpython#92652 Include/code.h was removed by @vstinner python/cpython#32385 Python/peephole.c was removed by @markshannon python/cpython#21517 The respective sections in developer-workflow/grammar.rst and internals/compiler.rst might need to be revisited. @vstinner and @markshannon: can you advise on whether these are quick fixes that we can include in this PR or if they should be handled separately? I also found another issue with this section: https://devguide.python.org/internals/compiler/#important-files In addition to the fact that the listed files don't use any markup, the markup used for most of the files seem incorrect (it's a blockquote due to the indentation). A nested list with full paths for all the files and :cpy-file: should be a better alternative. The :cpy-file: role could also be improved to support ~, so that in that list (and in a few other places) we can hide the full path and just display the file name.
Open Graph Description: This PR replaces the use of :file: with :cpy-file: (introduced in #961) in most places. Since the generated links are now checked by make linkcheck, I also went through and corrected some of those...
X Description: This PR replaces the use of :file: with :cpy-file: (introduced in #961) in most places. Since the generated links are now checked by make linkcheck, I also went through and corrected some of those...
Opengraph URL: https://github.com/python/devguide/pull/984
X: @github
Domain: github.com
| route-pattern | /:user_id/:repository/pull/:id/files(.:format) |
| route-controller | pull_requests |
| route-action | files |
| fetch-nonce | v2:08dbc25a-dc6a-f332-9561-76d86c2a5a43 |
| current-catalog-service-hash | ae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b |
| request-id | 89FE:33D98E:7FC5B:A42E9:696AF951 |
| html-safe-nonce | 24a9a452362109fd34688ab8c98f06a3b818fd805a163a0936da5de252b87963 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4OUZFOjMzRDk4RTo3RkM1QjpBNDJFOTo2OTZBRjk1MSIsInZpc2l0b3JfaWQiOiI1NDgyNDczOTE0ODU3MzU1NjAxIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 4a50cb8833ca85c4d532c2389f29c5e0b7756bb933ce33ae9a479585f1015a26 |
| hovercard-subject-tag | pull_request:1120790382 |
| github-keyboard-shortcuts | repository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/python/devguide/pull/984/files |
| twitter:image | https://avatars.githubusercontent.com/u/25624924?s=400&v=4 |
| twitter:card | summary_large_image |
| og:image | https://avatars.githubusercontent.com/u/25624924?s=400&v=4 |
| og:image:alt | This PR replaces the use of :file: with :cpy-file: (introduced in #961) in most places. Since the generated links are now checked by make linkcheck, I also went through and corrected some of those... |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | 5f99f7c1d70f01da5b93e5ca90303359738944d8ab470e396496262c66e60b8d |
| turbo-cache-control | no-preview |
| diff-view | unified |
| go-import | github.com/python/devguide git https://github.com/python/devguide.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 63972479 |
| octolytics-dimension-repository_nwo | python/devguide |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 63972479 |
| octolytics-dimension-repository_network_root_nwo | python/devguide |
| turbo-body-classes | logged-out env-production page-responsive full-width |
| disable-turbo | true |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 82560a55c6b2054555076f46e683151ee28a19bc |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width