diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/changelog.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/changelog.md index cdd06284..35550f8e 100644 --- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/changelog.md +++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/changelog.md @@ -1,6 +1,6 @@ --- slug: /changelog/ -sidebar_position: 7 +sidebar_position: 8 --- # Changelog diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/community.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/community.md index d6547662..e76cf5f5 100644 --- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/community.md +++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/community.md @@ -1,6 +1,6 @@ --- slug: /community/ -sidebar_position: 8 +sidebar_position: 9 --- # Community @@ -11,27 +11,9 @@ Some of the work to improve the Task ecosystem is done by the community, be it i [@DeronW](https://github.com/DeronW) maintains the [Chinese translation](https://task-zh.readthedocs.io/zh_CN/latest/) of the website [on this repository](https://github.com/DeronW/task). -## Editor Integrations +## Integrations -### JSON Schema - -Initial work on the schema was made by [@KROSF](https://github.com/KROSF) on [this Gist](https://gist.github.com/KROSF/c5435acf590acd632f71bb720f685895). The schema is currently available at https://taskfile.dev/schema.json and linked at https://json.schemastore.org/taskfile.json so it is be used automatically many code editors, like VSCode. Contributions can be done by editing [this file](https://github.com/go-task/task/blob/main/docs/static/schema.json). - -### Visual Studio Code extension - -Additionally, there's also some work done by [@paulvarache](https://github.com/paulvarache) in making an Visual Studio Code extension, which has its code [here](https://github.com/paulvarache/vscode-taskfile) and is published [here](https://marketplace.visualstudio.com/items?itemName=paulvarache.vscode-taskfile). - -### Sublime Text 4 package - -There is a convenience wrapper for initializing and running tasks from Sublime Text's command palette. The package is developed by [@biozz](https://github.com/biozz), the source code is available [here](https://github.com/biozz/sublime-taskfile) and it is published on Package Control [here](https://packagecontrol.io/packages/Taskfile). - -### IntelliJ plugin - -There's a JetBrains IntelliJ plugin done by [@lechuckroh](https://github.com/lechuckroh), which has its code [here](https://github.com/lechuckroh/task-intellij-plugin) and is published [here](https://plugins.jetbrains.com/plugin/17058-taskfile). - -## Other Integrations - -- [mk](https://github.com/pycontribs/mk) command line tool recognizes Taskfiles natively. +Many of our integrations are contributed and maintained by the community. You can view the full list of community integrations [here](./integrations#community-integrations). ## Installation methods diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/contributing.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/contributing.md index 8f455dd6..a58f9103 100644 --- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/contributing.md +++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/contributing.md @@ -1,6 +1,6 @@ --- slug: /contributing/ -sidebar_position: 9 +sidebar_position: 10 --- # Contributing diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/donate.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/donate.md index 87e4cfb2..ca43c4fb 100644 --- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/donate.md +++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/donate.md @@ -1,6 +1,6 @@ --- slug: /donate/ -sidebar_position: 12 +sidebar_position: 13 --- # Doe diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/faq.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/faq.md index b6794f35..27abfdd4 100644 --- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/faq.md +++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/faq.md @@ -1,6 +1,6 @@ --- slug: /faq/ -sidebar_position: 5 +sidebar_position: 6 --- # FAQ diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/integrations.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/integrations.md new file mode 100644 index 00000000..896951a1 --- /dev/null +++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/integrations.md @@ -0,0 +1,62 @@ +--- +slug: /integrations/ +sidebar_position: 5 +--- + +# Integrations + +## Visual Studio Code Extension + +Task has an [official extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=task.vscode-task). The code for this project can be found [here](https://github.com/go-task/vscode-task). To use this extension, you must have Task v3.23.0+ installed on your system. + +This extension provides the following features (and more): + +- View tasks in the sidebar. +- Run tasks from the sidebar and command palette. +- Go to definition from the sidebar and command palette. +- Run last task command. +- Multi-root workspace support. +- Initialize a Taskfile in the current workspace. + +To get autocompletion and validation for your Taskfile, see the [Schema](#schema) section below. + +![Task for Visual Studio Code](https://github.com/go-task/vscode-task/blob/main/res/preview.png?raw=true) + +## Schema + +This was initially created by [@KROSF](https://github.com/KROSF) in [this Gist](https://gist.github.com/KROSF/c5435acf590acd632f71bb720f685895) and is now officially maintained in [this file](https://github.com/go-task/task/blob/master/docs/static/schema.json) and made available at https://taskfile.dev/schema.json. This schema can be used to validate Taskfiles and provide autocompletion in many code editors: + +### Visual Studio Code + +To integrate the schema into VS Code, you need to install the [YAML extension](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml) by Red Hat. Any `Taskfile.yml` in your project should automatically be detected and validation/autocompletion should work. If this doesn't work or you want to manually configure it for files with a different name, you can add the following to your `settings.json`: + +```json +// settings.json +{ + "yaml.schemas": { + "https://taskfile.dev/schema.json": [ + "**/Taskfile.yml", + "./path/to/any/other/taskfile.yml" + ] + } +} +``` + +You can also configure the schema directly inside of a Taskfile by adding the following comment to the top of the file: + +```yaml +# yaml-language-server: $schema=https://taskfile.dev/schema.json +version: '3' +``` + +You can find more information on this in the [YAML language server project](https://github.com/redhat-developer/yaml-language-server). + +## Community Integrations + +In addition to our official integrations, there is an amazing community of developers who have created their own integrations for Task: + +- [Sublime Text Plugin](https://packagecontrol.io/packages/Taskfile) [[source](https://github.com/biozz/sublime-taskfile)] by [@biozz](https://github.com/biozz) +- [IntelliJ Plugin](https://plugins.jetbrains.com/plugin/17058-taskfile) [[source](https://github.com/lechuckroh/task-intellij-plugin)] by [@lechuckroh](https://github.com/lechuckroh) +- [mk](https://github.com/pycontribs/mk) command line tool recognizes Taskfiles natively. + +If you have made something that integrates with Task, please feel free to open a PR to add it to this list. diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/releasing.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/releasing.md index 501e7a32..c1617c54 100644 --- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/releasing.md +++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/releasing.md @@ -1,6 +1,6 @@ --- slug: /releasing/ -sidebar_position: 10 +sidebar_position: 11 --- # Releasing diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/styleguide.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/styleguide.md index 9be67fb6..adbf5eb1 100644 --- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/styleguide.md +++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/styleguide.md @@ -1,6 +1,6 @@ --- slug: /styleguide/ -sidebar_position: 6 +sidebar_position: 7 --- # Styleguide diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/taskfile_versions.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/taskfile_versions.md index 08dbd547..b4996d42 100644 --- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/taskfile_versions.md +++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/taskfile_versions.md @@ -1,6 +1,6 @@ --- slug: /taskfile-versions/ -sidebar_position: 11 +sidebar_position: 12 --- # Taskfile Versions diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/translate.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/translate.md index aa325f67..d4ef05ca 100644 --- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/translate.md +++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/translate.md @@ -1,6 +1,6 @@ --- slug: /translate/ -sidebar_position: 13 +sidebar_position: 14 --- # Traduza diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/changelog.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/changelog.md index cdd06284..35550f8e 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/changelog.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/changelog.md @@ -1,6 +1,6 @@ --- slug: /changelog/ -sidebar_position: 7 +sidebar_position: 8 --- # Changelog diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/community.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/community.md index d6547662..e76cf5f5 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/community.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/community.md @@ -1,6 +1,6 @@ --- slug: /community/ -sidebar_position: 8 +sidebar_position: 9 --- # Community @@ -11,27 +11,9 @@ Some of the work to improve the Task ecosystem is done by the community, be it i [@DeronW](https://github.com/DeronW) maintains the [Chinese translation](https://task-zh.readthedocs.io/zh_CN/latest/) of the website [on this repository](https://github.com/DeronW/task). -## Editor Integrations +## Integrations -### JSON Schema - -Initial work on the schema was made by [@KROSF](https://github.com/KROSF) on [this Gist](https://gist.github.com/KROSF/c5435acf590acd632f71bb720f685895). The schema is currently available at https://taskfile.dev/schema.json and linked at https://json.schemastore.org/taskfile.json so it is be used automatically many code editors, like VSCode. Contributions can be done by editing [this file](https://github.com/go-task/task/blob/main/docs/static/schema.json). - -### Visual Studio Code extension - -Additionally, there's also some work done by [@paulvarache](https://github.com/paulvarache) in making an Visual Studio Code extension, which has its code [here](https://github.com/paulvarache/vscode-taskfile) and is published [here](https://marketplace.visualstudio.com/items?itemName=paulvarache.vscode-taskfile). - -### Sublime Text 4 package - -There is a convenience wrapper for initializing and running tasks from Sublime Text's command palette. The package is developed by [@biozz](https://github.com/biozz), the source code is available [here](https://github.com/biozz/sublime-taskfile) and it is published on Package Control [here](https://packagecontrol.io/packages/Taskfile). - -### IntelliJ plugin - -There's a JetBrains IntelliJ plugin done by [@lechuckroh](https://github.com/lechuckroh), which has its code [here](https://github.com/lechuckroh/task-intellij-plugin) and is published [here](https://plugins.jetbrains.com/plugin/17058-taskfile). - -## Other Integrations - -- [mk](https://github.com/pycontribs/mk) command line tool recognizes Taskfiles natively. +Many of our integrations are contributed and maintained by the community. You can view the full list of community integrations [here](./integrations#community-integrations). ## Installation methods diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/contributing.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/contributing.md index 8f455dd6..a58f9103 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/contributing.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/contributing.md @@ -1,6 +1,6 @@ --- slug: /contributing/ -sidebar_position: 9 +sidebar_position: 10 --- # Contributing diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/donate.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/donate.md index 58615f53..6b520d7f 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/donate.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/donate.md @@ -1,6 +1,6 @@ --- slug: /donate/ -sidebar_position: 12 +sidebar_position: 13 --- # Donate diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/faq.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/faq.md index b6794f35..27abfdd4 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/faq.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/faq.md @@ -1,6 +1,6 @@ --- slug: /faq/ -sidebar_position: 5 +sidebar_position: 6 --- # FAQ diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/integrations.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/integrations.md new file mode 100644 index 00000000..896951a1 --- /dev/null +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/integrations.md @@ -0,0 +1,62 @@ +--- +slug: /integrations/ +sidebar_position: 5 +--- + +# Integrations + +## Visual Studio Code Extension + +Task has an [official extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=task.vscode-task). The code for this project can be found [here](https://github.com/go-task/vscode-task). To use this extension, you must have Task v3.23.0+ installed on your system. + +This extension provides the following features (and more): + +- View tasks in the sidebar. +- Run tasks from the sidebar and command palette. +- Go to definition from the sidebar and command palette. +- Run last task command. +- Multi-root workspace support. +- Initialize a Taskfile in the current workspace. + +To get autocompletion and validation for your Taskfile, see the [Schema](#schema) section below. + +![Task for Visual Studio Code](https://github.com/go-task/vscode-task/blob/main/res/preview.png?raw=true) + +## Schema + +This was initially created by [@KROSF](https://github.com/KROSF) in [this Gist](https://gist.github.com/KROSF/c5435acf590acd632f71bb720f685895) and is now officially maintained in [this file](https://github.com/go-task/task/blob/master/docs/static/schema.json) and made available at https://taskfile.dev/schema.json. This schema can be used to validate Taskfiles and provide autocompletion in many code editors: + +### Visual Studio Code + +To integrate the schema into VS Code, you need to install the [YAML extension](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml) by Red Hat. Any `Taskfile.yml` in your project should automatically be detected and validation/autocompletion should work. If this doesn't work or you want to manually configure it for files with a different name, you can add the following to your `settings.json`: + +```json +// settings.json +{ + "yaml.schemas": { + "https://taskfile.dev/schema.json": [ + "**/Taskfile.yml", + "./path/to/any/other/taskfile.yml" + ] + } +} +``` + +You can also configure the schema directly inside of a Taskfile by adding the following comment to the top of the file: + +```yaml +# yaml-language-server: $schema=https://taskfile.dev/schema.json +version: '3' +``` + +You can find more information on this in the [YAML language server project](https://github.com/redhat-developer/yaml-language-server). + +## Community Integrations + +In addition to our official integrations, there is an amazing community of developers who have created their own integrations for Task: + +- [Sublime Text Plugin](https://packagecontrol.io/packages/Taskfile) [[source](https://github.com/biozz/sublime-taskfile)] by [@biozz](https://github.com/biozz) +- [IntelliJ Plugin](https://plugins.jetbrains.com/plugin/17058-taskfile) [[source](https://github.com/lechuckroh/task-intellij-plugin)] by [@lechuckroh](https://github.com/lechuckroh) +- [mk](https://github.com/pycontribs/mk) command line tool recognizes Taskfiles natively. + +If you have made something that integrates with Task, please feel free to open a PR to add it to this list. diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/releasing.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/releasing.md index 501e7a32..c1617c54 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/releasing.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/releasing.md @@ -1,6 +1,6 @@ --- slug: /releasing/ -sidebar_position: 10 +sidebar_position: 11 --- # Releasing diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/styleguide.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/styleguide.md index 9be67fb6..adbf5eb1 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/styleguide.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/styleguide.md @@ -1,6 +1,6 @@ --- slug: /styleguide/ -sidebar_position: 6 +sidebar_position: 7 --- # Styleguide diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/taskfile_versions.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/taskfile_versions.md index 08dbd547..b4996d42 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/taskfile_versions.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/taskfile_versions.md @@ -1,6 +1,6 @@ --- slug: /taskfile-versions/ -sidebar_position: 11 +sidebar_position: 12 --- # Taskfile Versions diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/translate.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/translate.md index 145ee5e9..56c2fbea 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/translate.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/translate.md @@ -1,6 +1,6 @@ --- slug: /translate/ -sidebar_position: 13 +sidebar_position: 14 --- # Translate diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/changelog.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/changelog.md index 997c54a7..e13da0a7 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/changelog.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/changelog.md @@ -1,6 +1,6 @@ --- slug: /changelog/ -sidebar_position: 7 +sidebar_position: 8 --- # 更新日志 diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/community.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/community.md index c4388a3e..b2f6e96b 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/community.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/community.md @@ -1,6 +1,6 @@ --- slug: /community/ -sidebar_position: 8 +sidebar_position: 9 --- # 社区 @@ -11,27 +11,9 @@ sidebar_position: 8 [@DeronW](https://github.com/DeronW) 在 [此存储库](https://github.com/DeronW/task) 中维护网站的 [中文翻译](https://task-zh.readthedocs.io/zh_CN/latest/)。 -## 编辑器集成 +## Integrations -### JSON Schema - -Schema 的初步工作是由 [@KROSF](https://github.com/KROSF) 在此 [Gist](https://gist.github.com/KROSF/c5435acf590acd632f71bb720f685895) 上完成的。 这个 Schema 目前在 https://taskfile.dev/schema.json 上可用，并在 https://json.schemastore.org/taskfile.json 上添加了链接，因此它可以自动在许多代码编辑器使用，例如 VSCode。 可以通过编辑 [此文件](https://github.com/go-task/task/blob/main/docs/static/schema.json) 来完成贡献。 - -### Visual Studio Code 扩展 - -另外，在开发 Visual Studio Code 扩展过程中， 还有一些工作由 [@paulvarache](https://github.com/paulvarache) 完成， 代码在 [这里](https://github.com/paulvarache/vscode-taskfile) 并发布到了 [这里](https://marketplace.visualstudio.com/items?itemName=paulvarache.vscode-taskfile)。 - -### Sublime Text 4 包 - -通过 Sublime Text 的命令面板有一个简便的安装运行方法。 这个包是由 [@biozz](https://github.com/biozz) 开发的， 源代码在 [这里](https://github.com/biozz/sublime-taskfile) 并且发布到了包管理 [这里](https://packagecontrol.io/packages/Taskfile)。 - -### IntelliJ 插件 - -JetBrains IntelliJ 插件由 [@lechuckroh](https://github.com/lechuckroh) 完成， 代码在 [这里](https://github.com/lechuckroh/task-intellij-plugin) 并且发布到了 [这里](https://plugins.jetbrains.com/plugin/17058-taskfile)。 - -## 其他集成 - -- [mk](https://github.com/pycontribs/mk) 命令行工具可以原生识别任务文件。 +Many of our integrations are contributed and maintained by the community. You can view the full list of community integrations [here](./integrations#community-integrations). ## 安装方法 diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/contributing.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/contributing.md index 5d1d78a6..6b6cf850 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/contributing.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/contributing.md @@ -1,6 +1,6 @@ --- slug: /contributing/ -sidebar_position: 9 +sidebar_position: 10 --- # 贡献 diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/donate.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/donate.md index 0f2e11ac..c27d4cf1 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/donate.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/donate.md @@ -1,6 +1,6 @@ --- slug: /donate/ -sidebar_position: 12 +sidebar_position: 13 --- # 赞助 diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/faq.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/faq.md index 01ad4038..e412f8c6 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/faq.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/faq.md @@ -1,6 +1,6 @@ --- slug: /faq/ -sidebar_position: 5 +sidebar_position: 6 --- # 常见问题 diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/integrations.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/integrations.md new file mode 100644 index 00000000..896951a1 --- /dev/null +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/integrations.md @@ -0,0 +1,62 @@ +--- +slug: /integrations/ +sidebar_position: 5 +--- + +# Integrations + +## Visual Studio Code Extension + +Task has an [official extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=task.vscode-task). The code for this project can be found [here](https://github.com/go-task/vscode-task). To use this extension, you must have Task v3.23.0+ installed on your system. + +This extension provides the following features (and more): + +- View tasks in the sidebar. +- Run tasks from the sidebar and command palette. +- Go to definition from the sidebar and command palette. +- Run last task command. +- Multi-root workspace support. +- Initialize a Taskfile in the current workspace. + +To get autocompletion and validation for your Taskfile, see the [Schema](#schema) section below. + +![Task for Visual Studio Code](https://github.com/go-task/vscode-task/blob/main/res/preview.png?raw=true) + +## Schema + +This was initially created by [@KROSF](https://github.com/KROSF) in [this Gist](https://gist.github.com/KROSF/c5435acf590acd632f71bb720f685895) and is now officially maintained in [this file](https://github.com/go-task/task/blob/master/docs/static/schema.json) and made available at https://taskfile.dev/schema.json. This schema can be used to validate Taskfiles and provide autocompletion in many code editors: + +### Visual Studio Code + +To integrate the schema into VS Code, you need to install the [YAML extension](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml) by Red Hat. Any `Taskfile.yml` in your project should automatically be detected and validation/autocompletion should work. If this doesn't work or you want to manually configure it for files with a different name, you can add the following to your `settings.json`: + +```json +// settings.json +{ + "yaml.schemas": { + "https://taskfile.dev/schema.json": [ + "**/Taskfile.yml", + "./path/to/any/other/taskfile.yml" + ] + } +} +``` + +You can also configure the schema directly inside of a Taskfile by adding the following comment to the top of the file: + +```yaml +# yaml-language-server: $schema=https://taskfile.dev/schema.json +version: '3' +``` + +You can find more information on this in the [YAML language server project](https://github.com/redhat-developer/yaml-language-server). + +## Community Integrations + +In addition to our official integrations, there is an amazing community of developers who have created their own integrations for Task: + +- [Sublime Text Plugin](https://packagecontrol.io/packages/Taskfile) [[source](https://github.com/biozz/sublime-taskfile)] by [@biozz](https://github.com/biozz) +- [IntelliJ Plugin](https://plugins.jetbrains.com/plugin/17058-taskfile) [[source](https://github.com/lechuckroh/task-intellij-plugin)] by [@lechuckroh](https://github.com/lechuckroh) +- [mk](https://github.com/pycontribs/mk) command line tool recognizes Taskfiles natively. + +If you have made something that integrates with Task, please feel free to open a PR to add it to this list. diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/releasing.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/releasing.md index abb4e1a5..98ef9dc5 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/releasing.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/releasing.md @@ -1,6 +1,6 @@ --- slug: /releasing/ -sidebar_position: 10 +sidebar_position: 11 --- # 发布 diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/styleguide.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/styleguide.md index 85519ec1..2326da76 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/styleguide.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/styleguide.md @@ -1,6 +1,6 @@ --- slug: /styleguide/ -sidebar_position: 6 +sidebar_position: 7 --- # 风格指南 diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/taskfile_versions.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/taskfile_versions.md index f87315ca..d97a0ef3 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/taskfile_versions.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/taskfile_versions.md @@ -1,6 +1,6 @@ --- slug: /taskfile-versions/ -sidebar_position: 11 +sidebar_position: 12 --- # Taskfile 版本 diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/translate.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/translate.md index 00fe3520..e7ab51f7 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/translate.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/translate.md @@ -1,6 +1,6 @@ --- slug: /translate/ -sidebar_position: 13 +sidebar_position: 14 --- # 翻译