diff --git a/docs/docker-compose.md b/docs/docker-compose.md index 6005adf9457..07528392f97 100644 --- a/docs/docker-compose.md +++ b/docs/docker-compose.md @@ -71,10 +71,13 @@ docker version ### 独立安装 Compose ```sh -curl -SL https://github.com/docker/compose/releases/download/v2.27.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose +curl -SL https://github.com/docker/compose/releases/download/v5.1.2/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose +sudo chmod +x /usr/local/bin/docker-compose ``` +独立版用于兼容旧项目中的 `docker-compose` 命令；如果要安装其他版本，请将 `v5.1.2` 替换为 [Compose releases](https://github.com/docker/compose/releases) 中的目标版本。 + 如果命令 `docker-compose` 安装失败，请检查你的路径。你也可以创建一个符号链接，指向 `/usr/bin` 或路径中的任何其他目录。例如 ```sh diff --git a/docs/emoji.md b/docs/emoji.md index 6755659a9f4..d9695dc61cd 100644 --- a/docs/emoji.md +++ b/docs/emoji.md @@ -988,7 +988,8 @@ Github emoji 图标标记 - [Share Emojis-With Your 🥺Fiends With An Great Way And Unique✅ |copy & download|](https://emoji-share.com/) _(emoji-share.com)_ - [Get Emoji — All Emojis to ✂️ Copy and 📋 Paste](https://getemoji.com/) _(getemoji.com)_ - [Emoji Guide – 🔥 The Ultimate Emoji Guide: 🌈 Meanings, 🍎 Platforms, 🆘 Codes and 😍 More](https://emojiguide.com/) _(emojiguide.com)_ -- [Full Emoji List, v15.0](https://unicode.org/emoji/charts/full-emoji-list.html) _(unicode.org)_ +- [Full Emoji List, v17.0](https://unicode.org/emoji/charts/full-emoji-list.html) _(unicode.org)_ +- [Emoji List, v17.0](https://unicode.org/emoji/charts/emoji-list.html) _(unicode.org)_ - [Emoji Cheat Sheet](https://www.webfx.com/tools/emoji-cheat-sheet/) _(webfx.com)_ - [EmojiCopy | Simple emoji copy and paste keyboard by JoyPixels®](https://www.emojicopy.com/) _(emojicopy.com)_ - [Emojis 🌱☀️ - Copy & Paste Online 🕵️‍♀️ | Quicktools by Picsart](https://tools.picsart.com/text/emojis/) _(tools.picsart.com)_ diff --git a/docs/fastapi.md b/docs/fastapi.md index 44d2974fc3e..3af0d2a73f6 100644 --- a/docs/fastapi.md +++ b/docs/fastapi.md @@ -1,7 +1,7 @@ FastAPI 备忘清单 === -一个用于构建 API 的现代、快速（高性能）的 web 框架，使用 Python 3.6+ 并基于标准的 Python 类型提示 +一个用于构建 API 的现代、快速（高性能）的 web 框架，使用 Python 类型提示。新版本要求请以 FastAPI 官方文档和发布说明为准。 入门 --- @@ -31,10 +31,9 @@ $ pip install "uvicorn[standard]" ```shell $ uvicorn main:app --reload +$ python -m pip show fastapi # 确认本地安装版本 ``` -Python: `3.9.5` FastAPI: `0.103.1` - ### 最小程序 下面代码会直接启动http服务，也可以使用 `uvicorn main:app --reload` @@ -678,3 +677,4 @@ FastAPI 默认支持 HTTPS，你只需要提供证书和私钥即可。 - [Python 备忘清单](./python.md) _(jaywcjlove.github.io)_ - [FastAPI 官方文档](https://fastapi.tiangolo.com/zh/tutorial/) _(fastapi.tiangolo.com)_ +- [FastAPI 版本说明](https://fastapi.tiangolo.com/release-notes/) _(fastapi.tiangolo.com)_ diff --git a/docs/flutter.md b/docs/flutter.md index 48c49075614..4e2e772336e 100644 --- a/docs/flutter.md +++ b/docs/flutter.md @@ -8,7 +8,7 @@ Flutter 备忘清单 ### macOS 操作系统上安装和配置 -> 完整教程请参阅 Flutter 中文社区的 [安装和环境配置](https://docs.flutter.cn/get-started/install) +> 完整教程请参阅 Flutter 官方文档的 [Install](https://docs.flutter.dev/install) 与中文社区的 [安装和环境配置](https://docs.flutter.cn/get-started/install)。 ```bash $ sudo softwareupdate --install-rosetta --agree-to-license @@ -19,16 +19,16 @@ $ sudo softwareupdate --install-rosetta --agree-to-license #### 获取 Flutter SDK -- 安装包来获取最新的 stable Flutter SDK： - - Intel [`flutter_macos_3.22.2-stable.zip`](https://storage.flutter-io.cn/flutter_infra_release/releases/stable/macos/flutter_macos_3.22.2-stable.zip) - - Apple 芯片 [`flutter_macos_arm64_3.22.2-stable.zip`](https://storage.flutter-io.cn/flutter_infra_release/releases/stable/macos/flutter_macos_arm64_3.22.2-stable.zip) +- 安装包来获取 stable Flutter SDK： + - Intel [`flutter_macos_3.44.0-stable.zip`](https://storage.flutter-io.cn/flutter_infra_release/releases/stable/macos/flutter_macos_3.44.0-stable.zip) + - Apple 芯片 [`flutter_macos_arm64_3.44.0-stable.zip`](https://storage.flutter-io.cn/flutter_infra_release/releases/stable/macos/flutter_macos_arm64_3.44.0-stable.zip) - 想要获取到其他版本的安装包，请参阅 [SDK 版本列表](https://docs.flutter.cn/release/archive) 页面 + 想要获取到其他版本的安装包，请参阅 [SDK archive](https://docs.flutter.dev/install/archive) 页面 - 将文件解压到目标路径, 比如: ```bash $ cd ~/development - $ unzip ~/Downloads/flutter_macos_3.22.2-stable.zip + $ unzip ~/Downloads/flutter_macos_3.44.0-stable.zip ``` - 配置 `flutter` 的 PATH 环境变量： @@ -43,11 +43,11 @@ $ sudo softwareupdate --install-rosetta --agree-to-license ### Windows 操作系统上安装和配置 -> 完整教程请参阅 Flutter 中文社区的 [安装和环境配置](https://docs.flutter.cn/get-started/install) +> 完整教程请参阅 Flutter 官方文档的 [Install](https://docs.flutter.dev/install) 与中文社区的 [安装和环境配置](https://docs.flutter.cn/get-started/install)。 -- 点击下方的安装包，获取 stable 发行通道的 Flutter SDK 最新版本： - - [flutter_windows_3.22.2-stable.zip](https://storage.flutter-io.cn/flutter_infra_release/releases/stable/windows/flutter_windows_3.22.2-stable.zip) - - 要查看其他发行通道和以往的版本，请参阅 [SDK 版本列表](https://docs.flutter.cn/release/archive) 页面 +- 点击下方的安装包，获取 stable 发行通道的 Flutter SDK： + - [flutter_windows_3.44.0-stable.zip](https://storage.flutter-io.cn/flutter_infra_release/releases/stable/windows/flutter_windows_3.44.0-stable.zip) + - 要查看其他发行通道和以往的版本，请参阅 [SDK archive](https://docs.flutter.dev/install/archive) 页面 - 将压缩包解压，然后把其中的 `flutter` 目录整个放在你想放置 `Flutter SDK` 的路径中（例如 `C:\src\flutter`） - 更新 `path` 环境变量，在开始菜单的搜索功能键入`「env」`，然后选择 `编辑系统环境变量`。在 **`用户变量`** 一栏中，检查是否有 **`Path`** 这个条目： - 如果存在这个条目，以 `;` 分隔已有的内容，加入 `flutter\bin` 目录的完整路径。 @@ -1267,5 +1267,7 @@ class _HomeState extends State with SingleTickerProviderStateMixin { - [Dart 备忘清单](./dart.md) _(jaywcjlove.github.io)_ - [flutter 官网](https://flutter.dev) _(flutter.dev)_ +- [Flutter Install](https://docs.flutter.dev/install) _(docs.flutter.dev)_ +- [Flutter SDK archive](https://docs.flutter.dev/install/archive) _(docs.flutter.dev)_ - [flutter 中文社区官网](https://flutter.cn) _(flutter.cn)_ - [flutter 中文开发者社区](https://flutterchina.club/) _(flutterchina.club)_ diff --git a/docs/gemini-cli.md b/docs/gemini-cli.md index c5f6cf04cf9..52c40a4e5a4 100644 --- a/docs/gemini-cli.md +++ b/docs/gemini-cli.md @@ -1,7 +1,7 @@ Gemini CLI 备忘清单 === -[Gemini CLI](https://geminicli.com/docs/) 可将 Google Gemini 模型直接带入终端，用于代码理解、任务自动化与工作流构建。 +[Gemini CLI](https://github.com/google-gemini/gemini-cli) 是 Google 开源的终端 AI 代理，可将 Gemini 模型带入命令行，用于代码理解、任务自动化与工作流构建。 快速开始 --- @@ -813,9 +813,5 @@ Hooks 延伸阅读 --- -- [官方文档](https://geminicli.com/docs/) _(geminicli.com)_ -- [CLI 速查表](https://geminicli.com/docs/cli/cli-reference) _(geminicli.com)_ -- [键盘快捷键参考](https://geminicli.com/docs/reference/keyboard-shortcuts) _(geminicli.com)_ -- [配置参考](https://geminicli.com/docs/reference/configuration) _(geminicli.com)_ -- [Hooks 参考](https://geminicli.com/docs/hooks/reference) _(geminicli.com)_ - [GitHub 仓库](https://github.com/google-gemini/gemini-cli) _(github.com)_ +- [Google Cloud Gemini CLI 文档](https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli) _(cloud.google.com)_ diff --git a/docs/jq.md b/docs/jq.md index a5af12d620a..aedf2838775 100644 --- a/docs/jq.md +++ b/docs/jq.md @@ -1,7 +1,7 @@ jq 备忘清单 === -这个快速参考备忘单提供了使用 [jq](https://stedolan.github.io/jq/) 命令的各种方法。 +这个快速参考备忘单提供了使用 [jq](https://jqlang.org/) 命令的各种方法。 入门 ---- @@ -10,7 +10,8 @@ jq 备忘清单 jq 就像用于 JSON 数据的 [sed](./sed.md) - 您可以使用它来切片、过滤、映射和转换结构化数据 -- [jq 官网](https://stedolan.github.io/jq/) _(stedolan.github.io)_ +- [jq 官网](https://jqlang.org/) _(jqlang.org)_ +- [jq Manual](https://jqlang.org/manual/) _(jqlang.org)_ - [jq 命令使用](https://jaywcjlove.github.io/linux-command/c/jq.html) _(jaywcjlove.github.io)_ 安装 @@ -263,5 +264,6 @@ echo "$(jq '.name = "@scope/package"' package.json)" > package.json 另见 ---- -- [jq 官网](https://stedolan.github.io/jq/) _(stedolan.github.io)_ +- [jq 官网](https://jqlang.org/) _(jqlang.org)_ +- [jq Manual](https://jqlang.org/manual/) _(jqlang.org)_ - [jq 命令使用](https://jaywcjlove.github.io/linux-command/c/jq.html) _(jaywcjlove.github.io)_ diff --git a/docs/lessjs.md b/docs/lessjs.md index 198491ff8db..082f82840df 100644 --- a/docs/lessjs.md +++ b/docs/lessjs.md @@ -17,6 +17,7 @@ Less 备忘清单 Less(Leaner Style Sheets 的缩写)是一门向后兼容的 [`CSS`](./css.md) 扩展语言 - [CSS 备忘清单](./css.md) _(jaywcjlove.github.io)_ +- [Less.js 官方文档](https://lesscss.org/) _(lesscss.org)_ - [在线编译预览](http://lesscss.org/less-preview/#eyJjb2RlIjoiI2xpYigpIHtcbiAgICAuY29sb3JzKCkge1xuICAgICAgQHByaW1hcnk6IGJsdWU7XG4gICAgICBAc2Vjb25kYXJ5OiBncmVlbjtcbiAgICB9XG4gICAgLnJ1bGVzKEBzaXplKSB7XG4gICAgICBib3JkZXI6IEBzaXplIHNvbGlkIHdoaXRlO1xuICAgIH1cbiAgfVxuICBcbiAgLmJveCB3aGVuICgjbGliLmNvbG9yc1tAcHJpbWFyeV0gPSBibHVlKSB7XG4gICAgd2lkdGg6IDEwMHB4O1xuICAgIGhlaWdodDogKCR3aWR0aCAvIDIpO1xuICB9XG4gIFxuICAuYmFyOmV4dGVuZCguYm94KSB7XG4gICAgQG1lZGlhIChtaW4td2lkdGg6IDYwMHB4KSB7XG4gICAgICB3aWR0aDogMjAwcHg7XG4gICAgICAjbGliLnJ1bGVzKDFweCk7XG4gICAgfVxuICB9IiwiYWN0aXZlVmVyc2lvbiI6IjQueCJ9) _(lesscss.org)_ 在 Node.js 环境中使用 `Less` @@ -718,7 +719,8 @@ each(range(4), { 另见 --- -- [Less.js 官网](http://lesscss.org) _(lesscss.org)_ +- [Less.js 官网](https://lesscss.org/) _(lesscss.org)_ +- [Less.js Usage](https://lesscss.org/usage/) _(lesscss.org)_ - [CSS 备忘清单](./css.md) _(jaywcjlove.github.io)_ - [Stylus 备忘清单](./stylus.md) _(jaywcjlove.github.io)_ - [在线编译预览](http://lesscss.org/less-preview/#eyJjb2RlIjoiI2xpYigpIHtcbiAgICAuY29sb3JzKCkge1xuICAgICAgQHByaW1hcnk6IGJsdWU7XG4gICAgICBAc2Vjb25kYXJ5OiBncmVlbjtcbiAgICB9XG4gICAgLnJ1bGVzKEBzaXplKSB7XG4gICAgICBib3JkZXI6IEBzaXplIHNvbGlkIHdoaXRlO1xuICAgIH1cbiAgfVxuICBcbiAgLmJveCB3aGVuICgjbGliLmNvbG9yc1tAcHJpbWFyeV0gPSBibHVlKSB7XG4gICAgd2lkdGg6IDEwMHB4O1xuICAgIGhlaWdodDogKCR3aWR0aCAvIDIpO1xuICB9XG4gIFxuICAuYmFyOmV4dGVuZCguYm94KSB7XG4gICAgQG1lZGlhIChtaW4td2lkdGg6IDYwMHB4KSB7XG4gICAgICB3aWR0aDogMjAwcHg7XG4gICAgICAjbGliLnJ1bGVzKDFweCk7XG4gICAgfVxuICB9IiwiYWN0aXZlVmVyc2lvbiI6IjQueCJ9) _(lesscss.org)_ diff --git a/docs/react.md b/docs/react.md index bd413091eb5..61a77b6b4a7 100644 --- a/docs/react.md +++ b/docs/react.md @@ -450,7 +450,7 @@ function CustomTextInput(props) { - [检测过时的 context API](https://zh-hans.reactjs.org/docs/strict-mode.html#detecting-legacy-context-api) - [确保可复用的状态](https://zh-hans.reactjs.org/docs/strict-mode.html#ensuring-reusable-state) -突出显示应用程序中潜在问题的工具。请参阅：[严格模式](https://zh-hans.reactjs.org/docs/strict-mode.html) +突出显示应用程序中潜在问题的工具。请参阅：[StrictMode](https://react.dev/reference/react/StrictMode) ### Profiler @@ -1679,7 +1679,8 @@ MyComponent.propTypes = { 另见 ---- -- [React 官方中文文档](https://zh-hans.reactjs.org/) _(zh-hans.reactjs.org)_ +- [React 官方文档](https://react.dev/) _(react.dev)_ +- [StrictMode](https://react.dev/reference/react/StrictMode) _(react.dev)_ - [反应生命周期方法图](https://projects.wojtekmaj.pl/react-lifecycle-methods-diagram/) _(projects.wojtekmaj.pl)_ - [React 16 Cheat Sheet](https://reactcheatsheet.com) - [Awesome React](https://github.com/enaqx/awesome-react) _(github.com)_ diff --git a/docs/ruby.md b/docs/ruby.md index f1a1ff26e2b..abdc14aac0a 100644 --- a/docs/ruby.md +++ b/docs/ruby.md @@ -33,10 +33,10 @@ $ rbenv install -l # 列出所有本地版本 $ rbenv install -L # 安装 Ruby 版本 -$ rbenv install 3.1.2 -$ rbenv global 3.1.2 # 为这台机器设置默认Ruby版本 +$ rbenv install 3.4.1 +$ rbenv global 3.4.1 # 为这台机器设置默认Ruby版本 # 或者 -$ rbenv local 3.1.2 # 设置此目录的 Ruby 版本 +$ rbenv local 3.4.1 # 设置此目录的 Ruby 版本 $ rbenv local --unset $ rbenv version # 显示当前活动的 Ruby 版本 => 1.9.3-p327 (set by /Users/sam/.rbenv/version) @@ -69,7 +69,7 @@ $ gem uninstall bundler ```ruby # 在项目根目录的 Gemfile 中指定 gem -ruby '2.5.6' +ruby '3.4.1' source 'https://rubygems.org' gem 'nokogiri' @@ -2444,15 +2444,17 @@ false --- - [Ruby 官网](https://www.ruby-lang.org/en/) _(ruby-lang.org)_ +- [Ruby 官方文档](https://www.ruby-lang.org/en/documentation/) _(ruby-lang.org)_ +- [Ruby 3.4 API](https://docs.ruby-lang.org/en/3.4/) _(docs.ruby-lang.org)_ - [Ruby Cheatsheet](https://github.com/lifeparticle/Ruby-Cheatsheet) _(github.com)_ -[2]: https://ruby-doc.org/core-3.1.2/Integer.html -[3]: https://ruby-doc.org/core-3.1.2/Float.html -[4]: https://ruby-doc.org/core-3.1.2/String.html -[5]: https://ruby-doc.org/core-3.1.2/Array.html -[6]: https://ruby-doc.org/core-3.1.2/Hash.html -[7]: https://ruby-doc.org/core-3.1.2/TrueClass.html -[8]: https://ruby-doc.org/core-3.1.2/FalseClass.html -[9]: https://ruby-doc.org/core-3.1.2/Symbol.html -[10]: https://ruby-doc.org/core-3.1.2/Range.html -[11]: https://ruby-doc.org/core-3.1.2/NilClass.html +[2]: https://docs.ruby-lang.org/en/3.4/Integer.html +[3]: https://docs.ruby-lang.org/en/3.4/Float.html +[4]: https://docs.ruby-lang.org/en/3.4/String.html +[5]: https://docs.ruby-lang.org/en/3.4/Array.html +[6]: https://docs.ruby-lang.org/en/3.4/Hash.html +[7]: https://docs.ruby-lang.org/en/3.4/TrueClass.html +[8]: https://docs.ruby-lang.org/en/3.4/FalseClass.html +[9]: https://docs.ruby-lang.org/en/3.4/Symbol.html +[10]: https://docs.ruby-lang.org/en/3.4/Range.html +[11]: https://docs.ruby-lang.org/en/3.4/NilClass.html diff --git a/docs/scala.md b/docs/scala.md index b24750b507c..e30bb33468f 100644 --- a/docs/scala.md +++ b/docs/scala.md @@ -4,7 +4,7 @@ Scala [![Repo Dependents](https://badgen.net/github/dependents-repo/scala/scala)](https://github.com/scala/scala/network/dependents) [![Github repo](https://badgen.net/badge/icon/Github?icon=github&label)](https://github.com/scala/scala) -本速查表可以用于快速地查找 [Scala](https://github.com/scala/scala) 语法结构 +本速查表可以用于快速地查找 [Scala](https://www.scala-lang.org/) 语法结构 入门 @@ -12,7 +12,9 @@ Scala ### 介绍 -- [Scala](https://github.com/scala/scala) 官网 _(github.com)_ +- [Scala 官网](https://www.scala-lang.org/) _(scala-lang.org)_ +- [Scala 文档](https://docs.scala-lang.org/) _(docs.scala-lang.org)_ +- [Scala 标准库 API](https://www.scala-lang.org/api/) _(scala-lang.org)_ ### 函数