Replace hard-coded links with definitions in _config.yml (#6392)

* ✨ Add several site definitions

* ♻️ Replace links with definitions
Except: release notes, changelogs

* 🚑️ Fix typo

* 💚 Fix invalid links

Co-authored-by: Shams Zakhour (ignore Sfshaza) <44418985+sfshaza2@users.noreply.github.com>

Author: AlexV525

_config.yml

@@ -20,14 +20,16 @@ repo:
 
   flutter: https://github.com/flutter/flutter
   samples: https://github.com/flutter/samples
+  plugins: https://github.com/flutter/plugins
+  gallery: https://github.com/flutter/gallery
 dart:
   api: https://api.dart.dev
   sdk:
     channel: stable
 sdk:
   channel: stable # When changing this value also update it in src/_assets/js/archive.js
 social:
-  twitter: https://twitter.com/flutterdev
+  twitter: https://twitter.com/FlutterDev
   youtube: https://www.youtube.com/flutterdev
 dart-site: https://dart.dev
 news: https://news.dartlang.org
@@ -39,12 +41,15 @@ pub-pkg: https://pub.dev/packages
 flutter-medium: https://medium.com/flutter
 medium: https://medium.com
 dartpad: https://dartpad.dev
+gallery: https://gallery.flutter.dev
 material: https://material.io
 so: https://stackoverflow.com
 github: https://github.com
 flutter-assets: https://flutter.github.io/assets-for-api-docs/assets
 android-dev: https://developer.android.com
 apple-dev: https://developer.apple.com
+google-blog: https://developers.googleblog.com
+developers: https://developers.google.com
 codelabs: https://codelabs.developers.google.com
 groups: https://groups.google.com
 firebase: https://firebase.google.com

src/_includes/docs/master-api.md

@@ -15,4 +15,4 @@
 {{site.alert.end}}
 
 [api.flutter.dev]: {{site.api}}
-[latest docs]: https://master-api.flutter.dev/
+[latest docs]: {{site.master-api}}

src/adoptawidget/index.md

@@ -20,7 +20,7 @@ So, for the month of November, we’re extending a special
 invitation to contribute to the Flutter project by choosing
 a Widget and improving its API documentation.
 
-[on GitHub]: {{site.github}}/flutter/flutter
+[on GitHub]: {{site.repo.flutter}}
 [api.flutter.dev]: {{site.api}}
 
 ## Contributions
@@ -29,71 +29,71 @@ a Widget and improving its API documentation.
 
 - [Chinmay-KB]({{site.github}}/Chinmay-KB) contributed to the
   [WillPopScope docs]({{site.api}}/flutter/widgets/WillPopScope-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69563))
+  ([pull request]({{site.repo.flutter}}/pull/69563))
 - [chihempat]({{site.github}}/chihempat) contributed to the
   [SliverWithKeepAliveWidget docs]({{site.api}}/flutter/widgets/SliverWithKeepAliveWidget-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69557))
+  ([pull request]({{site.repo.flutter}}/pull/69557))
 - [obitodarky]({{site.github}}/obitodarky) contributed to the
   [Stepper docs]({{site.api}}/flutter/material/Stepper-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/70092))
-- [Sameerkash]({{site.github}}/Sameerkash) found an issue with the [StatusTransitionWidget docs](https://api.flutter.dev/flutter/widgets/StatusTransitionWidget-class.html) ([issue]({{site.github}}/flutter/flutter/issues/69558))
+  ([pull request]({{site.repo.flutter}}/pull/70092))
+- [Sameerkash]({{site.github}}/Sameerkash) found an issue with the [StatusTransitionWidget docs]({{site.api}}/flutter/widgets/StatusTransitionWidget-class.html) ([issue]({{site.repo.flutter}}/issues/69558))
 - [tadaspetra]({{site.github}}/tadaspetra) contributed to the
   [MaterialBanner docs]({{site.api}}/flutter/material/MaterialBanner-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69530))
+  ([pull request]({{site.repo.flutter}}/pull/69530))
 - [IsmailAbdirahman]({{site.github}}/IsmailAbdirahman) contributed to the
   [NotificationListener docs]({{site.api}}/flutter/widgets/NotificationListener-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69524))
+  ([pull request]({{site.repo.flutter}}/pull/69524))
 - [Aneesh Rao]({{site.github}}/sidrao2006) contributed to the
   [CircularProgressIndicator docs]({{site.api}}/flutter/material/CircularProgressIndicator-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69498))
+  ([pull request]({{site.repo.flutter}}/pull/69498))
 - [Abhishek Ghaskata]({{site.github}}/Abhishek01039) contributed to the
   [Hero docs]({{site.api}}/flutter/widgets/Hero-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/74415))
+  ([pull request]({{site.repo.flutter}}/pull/74415))
 - [singhsuryanshu]({{site.github}}/singhsuryanshu) contributed to the
   [FittedBox docs](site.api}}/flutter/widgets/FittedBox-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69503))
+  ([pull request]({{site.repo.flutter}}/pull/69503))
 - [parzuko]({{site.github}}/parzuko) contributed to the
   [Draggable docs]({{site.api}}/flutter/widgets/Draggable-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69527))
+  ([pull request]({{site.repo.flutter}}/pull/69527))
 - [Oscar Robles]({{site.github}}/oroblesr) contributed to the
   [ActionListener docs]({{site.api}}/flutter/widgets/ActionListener-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69717))
+  ([pull request]({{site.repo.flutter}}/pull/69717))
 - [arps18]({{site.github}}/arps18) contributed to the
   [Shortcuts docs]({{site.api}}/flutter/widgets/Shortcuts-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69568))
+  ([pull request]({{site.repo.flutter}}/pull/69568))
 - [Sanjoli Goyal]({{site.github}}/sanjoli63) contributed to the
   [ReorderableListView docs]({{site.api}}/flutter/material/ReorderableListView-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69650))
+  ([pull request]({{site.repo.flutter}}/pull/69650))
 - [Amitpatil215]({{site.github}}/Amitpatil215) contributed to the
   [AspectRatio docs]({{site.api}}/flutter/widgets/AspectRatio-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69509))
+  ([pull request]({{site.repo.flutter}}/pull/69509))
 - [CaptainIRS]({{site.github}}/CaptainIRS) contributed to the
   [AbsorbPointer docs]({{site.api}}/flutter/widgets/AbsorbPointer-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69521))
+  ([pull request]({{site.repo.flutter}}/pull/69521))
 - [Yazeed AlKhalaf]({{site.github}}/YazeedAlKhalaf) contributed to the
   [IgnorePointer docs]({{site.api}}/flutter/widgets/IgnorePointer-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/70185))
+  ([pull request]({{site.repo.flutter}}/pull/70185))
 - [abd99]({{site.github}}/abd99) contributed to the
   [Dismissible docs]({{site.api}}/flutter/widgets/Dismissible-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69535))
+  ([pull request]({{site.repo.flutter}}/pull/69535))
 - [Mitesh Singh]({{site.github}}/singhmitesh) contributed to the
   [PageView docs]({{site.api}}/flutter/widgets/PageView-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/71174))
+  ([pull request]({{site.repo.flutter}}/pull/71174))
 - [redsolver]({{site.github}}/redsolver) contributed to the
   [Table docs]({{site.api}}/flutter/widgets/Table-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69588))
+  ([pull request]({{site.repo.flutter}}/pull/69588))
 - [tsvillain]({{site.github}}/tsvillain) contributed to the
   [Tooltip docs]({{site.api}}/flutter/material/Tooltip-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69518))
+  ([pull request]({{site.repo.flutter}}/pull/69518))
 - [Thesmader]({{site.github}}/Thesmader) contributed to the
   [SnackBar docs]({{site.api}}/flutter/material/SnackBar-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69555))
+  ([pull request]({{site.repo.flutter}}/pull/69555))
 - [Muskan Jain]({{site.github}}/Muskan4010) contributed to the
   [ColorFiltered docs]({{site.api}}/flutter/widgets/ColorFiltered-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/71093))
+  ([pull request]({{site.repo.flutter}}/pull/71093))
 - [Sergio Eric]({{site.github}}/SergioEric) contributed to the
   [PreferredSizeWidget docs]({{site.api}}/flutter/widgets/PreferredSizeWidget-class.html)
-  ([pull request]({{site.github}}/flutter/flutter/pull/69539))
+  ([pull request]({{site.repo.flutter}}/pull/69539))
 
 ## How to contribute {#how-to-contribute}
 
@@ -111,8 +111,8 @@ The [CONTRIBUTING][]
 doc has details on contributing to Flutter.
 
 
-[CONTRIBUTING]: {{site.github}}/flutter/flutter/blob/master/CONTRIBUTING.md
-[this list of issues]: {{site.github}}/flutter/flutter/issues?q=is%3Aopen+is%3Aissue+label%3A%22adopt+a+widget%22+no%3Aassignee
+[CONTRIBUTING]: {{site.repo.flutter}}/blob/master/CONTRIBUTING.md
+[this list of issues]: {{site.repo.flutter}}/issues?q=is%3Aopen+is%3Aissue+label%3A%22adopt+a+widget%22+no%3Aassignee
 
 ## Discord {#discord}
 
@@ -149,7 +149,7 @@ You can also take a look for
 [issues with the "d: api docs" label][]
 that need attention.
 
-[issues with the "d: api docs" label]: {{site.github}}/flutter/flutter/issues?q=is%3Aopen+is%3Aissue+label%3A%22d%3A+api+docs%22
+[issues with the "d: api docs" label]: {{site.repo.flutter}}/issues?q=is%3Aopen+is%3Aissue+label%3A%22d%3A+api+docs%22
 
 **Be original**
 
@@ -163,17 +163,17 @@ Each issue specifies what type of contribution we are looking for:
 * Adding references (for example, under "See also")
 * Adding more explanation to the documentation
 
-[DartPad]: {{site.github}}/flutter/flutter/tree/master/dev/snippets#templates
-[sample]: {{site.github}}/flutter/flutter/tree/master/dev/snippets#sample-tool
-[snippet]: {{site.github}}/flutter/flutter/tree/master/dev/snippets#snippet-tool
+[DartPad]: {{site.repo.flutter}}/tree/master/dev/snippets#templates
+[sample]: {{site.repo.flutter}}/tree/master/dev/snippets#sample-tool
+[snippet]: {{site.repo.flutter}}/tree/master/dev/snippets#snippet-tool
 
 ### Adding code {#adding-code}
 
 There are three ways to contribute code: a `snippet`,
 a `dartpad`, or a `sample`.
 For more details, see the [Dartdoc Generation README][].
 
-[Dartdoc Generation README]: {{site.github}}/flutter/flutter/tree/master/dev/snippets
+[Dartdoc Generation README]: {{site.repo.flutter}}/tree/master/dev/snippets
 
 Please be cognizant that writing _sample_ code has a different goal
 (and some additional constraints) compared to writing production code.
@@ -221,7 +221,7 @@ the snippet tool's [templates directory][].
 /// {@end-tool}
 ```
 
-[templates directory]: {{site.github}}/flutter/flutter/tree/master/dev/snippets/config/templates
+[templates directory]: {{site.repo.flutter}}/tree/master/dev/snippets/config/templates
 
 #### DartPad sample {#dartpad-sample}
 
@@ -277,7 +277,7 @@ and [Effective Dart - Documentation][]
 for details on how to write great documentation.
 
 [Effective Dart - Documentation]: {{site.dart-site}}/guides/language/effective-dart/documentation
-[Flutter Style Guide]: {{site.github}}/flutter/flutter/wiki/Style-guide-for-Flutter-repo#documentation-dartdocs-javadocs-etc
+[Flutter Style Guide]: {{site.repo.flutter}}/wiki/Style-guide-for-Flutter-repo#documentation-dartdocs-javadocs-etc
 
 ## Quickstart {#quickstart}
 
@@ -300,9 +300,9 @@ fork the SDK and use `git` to fetch a local copy:
 6. Run `flutter update-packages` to fetch all the Dart packages that
    Flutter uses.
 
-[Flutter repo]: {{site.github}}/flutter/flutter
+[Flutter repo]: {{site.repo.flutter}}
 [GitHub's official instructions]: https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/fork-a-repo
-[Setting up the Framework development environment]: {{site.github}}/flutter/flutter/wiki/Setting-up-the-Framework-development-environment
+[Setting up the Framework development environment]: {{site.repo.flutter}}/wiki/Setting-up-the-Framework-development-environment
 
 ### Open the code in your IDE {#open-the-code-in-your-ide}
 
@@ -338,9 +338,9 @@ To view the generated docs, open `dev/docs/doc/api/index.html`.
 For more information, see the [Dartdoc Generation README][].
 
 
-[analyze snippets]: {{site.github}}/flutter/flutter/tree/master/dev/snippets#running-sample-analysis-locally
-[Dartdoc Generation README]: {{site.github}}/flutter/flutter/tree/master/dev/snippets
-[Windows Subsystem for Linux]:https://docs.microsoft.com/en-us/windows/wsl/about
+[analyze snippets]: {{site.repo.flutter}}/tree/master/dev/snippets#running-sample-analysis-locally
+[Dartdoc Generation README]: {{site.repo.flutter}}/tree/master/dev/snippets
+[Windows Subsystem for Linux]: https://docs.microsoft.com/en-us/windows/wsl/about
 
 ### Commit the change {#commit-the-change}
 
@@ -393,4 +393,4 @@ closes #1234
 *   [Flutter Style Guide - Documentation][]
 *   [Effective Dart - Documentation][]
 
-[Flutter Style Guide - Documentation]: {{site.github}}/flutter/flutter/wiki/Style-guide-for-Flutter-repo#documentation-dartdocs-javadocs-etc
+[Flutter Style Guide - Documentation]: {{site.repo.flutter}}/wiki/Style-guide-for-Flutter-repo#documentation-dartdocs-javadocs-etc

src/ads/index.md

@@ -40,7 +40,7 @@ The following resources can help you get started:
 
 [Adding AdMob Ads to a Flutter app]: {{site.codelabs}}/codelabs/admob-ads-in-flutter#0
 [Adding AdMob banner and native inline ads to a Flutter app]: {{site.codelabs}}/codelabs/admob-inline-ads-in-flutter
-[detailed implementation guide]: https://developers.google.com/admob/flutter
+[detailed implementation guide]: {{site.developers}}/admob/flutter
 [file an issue]: {{site.github}}/googleads/googleads-mobile-flutter/issues
 [Monetizing apps with Flutter]: {{site.youtube-site}}/watch?v=m0d_pbgeeG8&feature=youtu.be
 [plugin]: {{site.pub-pkg}}/google_mobile_ads

src/apprentice-giveaway/index.md

@@ -23,7 +23,7 @@ channel for summaries, discussions, and more.
 
 For more information, watch the following video:
 
-<iframe width="560" height="315" src="https://www.youtube.com/embed/NVzIALG7CUc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+<iframe width="560" height="315" src="{{site.youtube-site}}/embed/NVzIALG7CUc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 
 ![Image of Dash with the book](/assets/images/homepage/DashWithApprenticeBook.png){:width="100%"}
 
@@ -87,7 +87,6 @@ You can find the [live stream][] on YouTube.
 [Razeware]: https://www.raywenderlich.com/
 [raywenderlich.com/flutter]: https://store.raywenderlich.com/products/flutter-apprentice-google
 [schedule]: #schedule
-[Twitter]: https://twitter.com/FlutterDev
+[Twitter]: {{site.social.twitter}}
 [YouTube]: {{site.youtube-site}}/c/FlutterCommunityVideos
 [Slack]: https://fluttercommunity.dev/joinslack
-

src/community/china.md

@@ -45,7 +45,7 @@ shell from the directory where you wish to store your local Flutter clone:
 ```terminal
 $ export PUB_HOSTED_URL=https://pub.flutter-io.cn
 $ export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
-$ git clone -b dev {{site.github}}/flutter/flutter.git
+$ git clone -b dev {{site.repo.flutter}}.git
 $ export PATH="$PWD/flutter/bin:$PATH"
 $ cd ./flutter
 $ flutter doctor

src/dash/index.md

@@ -152,7 +152,7 @@ I haven't been able to figure out how to play the mp4 file...
 
 !["Born to Hot Reload" jacket](/assets/images/dash/ShamsDashJacket.png){:width="35%"}<br>
 
-[Flutter Interact]: https://developers.google.com/events/flutter-interact
+[Flutter Interact]: {{site.developers}}/events/flutter-interact
 [Instagram account]: https://www.instagram.com/dash_the_dartlang_plushy/
 
 {% comment %}

src/desktop.md

@@ -56,7 +56,7 @@ If you want the latest version of desktop support,
 you must switch to the Flutter beta channel.
 
 
-[file an issue]: {{site.github}}/flutter/flutter/issues/new?title=[desktop]:+%3Cdescribe+issue+here%3E&labels=%E2%98%B8+platform-desktop&body=Describe+your+issue+and+include+the+command+you%27re+running,+flutter_desktop%20version,+browser+version
+[file an issue]: {{site.repo.flutter}}/issues/new?title=[desktop]:+%3Cdescribe+issue+here%3E&labels=%E2%98%B8+platform-desktop&body=Describe+your+issue+and+include+the+command+you%27re+running,+flutter_desktop%20version,+browser+version
 
 ## Requirements
 
@@ -734,7 +734,7 @@ and `com.apple.security.device.microphone` (for App Sandbox).
 For more information on this topic,
 see [Hardened Runtime][] on the Apple Developer site.
 
-[Hardened Runtime]: https://developer.apple.com/documentation/security/hardened_runtime
+[Hardened Runtime]: {{site.apple-dev}}/documentation/security/hardened_runtime
 
 ## Plugin support
 
@@ -811,7 +811,7 @@ about endorsed plugins, see the following resources:
 [Federated Plugin proposal]: /go/federated-plugins
 [Federated plugins]: /docs/development/packages-and-plugins/developing-packages#federated-plugins
 [How to write a Flutter web plugin, part 2]: {{site.flutter-medium}}/how-to-write-a-flutter-web-plugin-part-2-afdddb69ece6
-[Modern Flutter Plugin Development]: {{site.medium}}/flutter/modern-flutter-plugin-development-4c3ee015cf5a
+[Modern Flutter Plugin Development]: {{site.flutter-medium}}/modern-flutter-plugin-development-4c3ee015cf5a
 
 ## Samples and codelabs
 
@@ -846,9 +846,9 @@ Flokk [announcement blogpost][gskinner-flokk-blogpost], [repo][gskinner-flokk-re
 
 [`menubar`]: {{site.github}}/google/flutter-desktop-embedding/tree/master/plugins/menubar
 [Photo Search app]: {{site.repo.organization}}/samples/tree/master/experimental/desktop_photo_search
-[running web app]: https://gallery.flutter.dev
-[flutter-gallery-repo]: {{site.github}}/flutter/gallery
-[README]: {{site.github}}/flutter/gallery#flutter-gallery
+[running web app]: {{site.gallery}}
+[flutter-gallery-repo]: {{site.repo.gallery}}
+[README]: {{site.repo.gallery}}#flutter-gallery
 [gskinner-flokk-repo]: {{site.github}}/gskinnerTeam/flokk
 [gskinner-flokk-blogpost]: https://blog.gskinner.com/archives/2020/09/flokk-how-we-built-a-desktop-app-using-flutter.html
-[Write a Flutter desktop application]: https://codelabs.developers.google.com/codelabs/flutter-github-graphql-client/index.html
+[Write a Flutter desktop application]: {{site.codelabs}}/codelabs/flutter-github-graphql-client/index.html

src/docs/codelabs/explicit-animations.md

@@ -762,7 +762,7 @@ the `value` property to a new value.
 [Material app]: {{site.api}}/flutter/material/MaterialApp-class.html
 [performance profiling]: /docs/perf/rendering/ui-performance
 [implicit animations]: /docs/development/ui/animations/implicit-animations
-[make a Flutter app]: https://codelabs.developers.google.com/codelabs/first-flutter-app-pt1
+[make a Flutter app]: {{site.codelabs}}/codelabs/first-flutter-app-pt1
 [stateful widgets]: /docs/development/ui/interactive#stateful-and-stateless-widgets
 [step 1]: #1-use-a-tickerprovider-mixin
 [`SingleTickerProviderStateMixin`]: {{site.api}}/flutter/widgets/SingleTickerProviderStateMixin-mixin.html

src/docs/codelabs/index.md

@@ -135,7 +135,7 @@ like layout and animations:
 [Basic Flutter layout concepts]: /docs/codelabs/layout-basics
 [Building Beautiful Transitions with Material Motion for Flutter]: {{site.codelabs}}/codelabs/material-motion-flutter
 [Building scrolling experiences in Flutter]: {{site.youtube-site}}/watch?v=YY-_yrZdjGc
-[How to debug layout issues with the Flutter Inspector]: {{site.medium}}/flutter/how-to-debug-layout-issues-with-the-flutter-inspector-87460a7b9db
+[How to debug layout issues with the Flutter Inspector]: {{site.flutter-medium}}/how-to-debug-layout-issues-with-the-flutter-inspector-87460a7b9db
 [Implicit animations]: /docs/codelabs/implicit-animations
 [MDC-101 Flutter: Material Components (MDC) Basics]: {{site.codelabs}}/codelabs/mdc-101-flutter
 [MDC-102 Flutter: Material Structure and Layout]: {{site.codelabs}}/codelabs/mdc-102-flutter
@@ -203,7 +203,7 @@ Learn how to use Flutter with other technologies.
 [Build voice bots for Android with Dialogflow and Flutter]: {{site.codelabs}}/codelabs/dialogflow-flutter?hl=en&continue=https%3A%2F%2Fcodelabs.developers.google.com%2F#0
 [Build voice bots for mobile with Dialogflow and Flutter]: {{site.youtube-site}}/watch?v=O7JfSF3CJ84
 [firebase-ws]: {{site.youtube-site}}/watch?v=wUSkeTaBonA
-[Get to know Firebase for Flutter]: https://firebase.google.com/learn/codelabs/firebase-get-to-know-flutter
+[Get to know Firebase for Flutter]: {{site.firebase}}/learn/codelabs/firebase-get-to-know-flutter
 [Multi-platform Firestore Flutter]: {{site.codelabs}}/codelabs/friendlyeats-flutter/
 
 ## Testing
@@ -263,7 +263,7 @@ We also recommend the following online class:
 
 {{site.alert.note}}
   If you have trouble viewing any of the codelabs
-  on [`codelabs.developers.google.com`](https://codelabs.developers.google.com/), try 
+  on [`codelabs.developers.google.com`]({{site.codelabs}}), try 
   [this mirror of the Flutter codelabs][].
 {{site.alert.end}}