diff --git a/docs/i18n/fr-FR/code.json b/docs/i18n/fr-FR/code.json index be706914..83261d27 100644 --- a/docs/i18n/fr-FR/code.json +++ b/docs/i18n/fr-FR/code.json @@ -1,22 +1,22 @@ { "theme.ErrorPageContent.title": { - "message": "This page crashed.", + "message": "Cette page a rencontré un problème.", "description": "The title of the fallback page when the page crashed" }, "theme.ErrorPageContent.tryAgain": { - "message": "Try again", + "message": "Veuillez réessayer", "description": "The label of the button to try again when the page crashed" }, "theme.NotFound.title": { - "message": "Page Not Found", + "message": "Page non trouvée", "description": "The title of the 404 page" }, "theme.NotFound.p1": { - "message": "We could not find what you were looking for.", + "message": "Nous n'avons pas trouvé ce que vous recherchiez.", "description": "The first paragraph of the 404 page" }, "theme.NotFound.p2": { - "message": "Please contact the owner of the site that linked you to the original URL and let them know their link is broken.", + "message": "Veuillez contacter le propriétaire du site qui vous a lié à l'URL d'origine et lui faire savoir que son lien est rompu.", "description": "The 2nd paragraph of the 404 page" }, "theme.admonition.note": { @@ -24,7 +24,7 @@ "description": "The default label used for the Note admonition (:::note)" }, "theme.admonition.tip": { - "message": "tip", + "message": "conseils", "description": "The default label used for the Tip admonition (:::tip)" }, "theme.admonition.danger": { @@ -36,138 +36,138 @@ "description": "The default label used for the Info admonition (:::info)" }, "theme.admonition.caution": { - "message": "caution", + "message": "attention", "description": "The default label used for the Caution admonition (:::caution)" }, "theme.BackToTopButton.buttonAriaLabel": { - "message": "Scroll back to top", + "message": "Retour en haut de la page", "description": "The ARIA label for the back to top button" }, "theme.blog.archive.title": { - "message": "Archive", + "message": "Archiver", "description": "The page & hero title of the blog archive page" }, "theme.blog.archive.description": { - "message": "Archive", + "message": "Archiver", "description": "The page & hero description of the blog archive page" }, "theme.blog.paginator.navAriaLabel": { - "message": "Blog list page navigation", + "message": "Navigation dans la page de la liste des blogs", "description": "The ARIA label for the blog pagination" }, "theme.blog.paginator.newerEntries": { - "message": "Newer Entries", + "message": "Nouvelles entrées", "description": "The label used to navigate to the newer blog posts page (previous page)" }, "theme.blog.paginator.olderEntries": { - "message": "Older Entries", + "message": "Anciennes Entrées", "description": "The label used to navigate to the older blog posts page (next page)" }, "theme.blog.post.paginator.navAriaLabel": { - "message": "Blog post page navigation", + "message": "Navigation dans la page d'article du blog", "description": "The ARIA label for the blog posts pagination" }, "theme.blog.post.paginator.newerPost": { - "message": "Newer Post", + "message": "Article récent", "description": "The blog post button label to navigate to the newer/previous post" }, "theme.blog.post.paginator.olderPost": { - "message": "Older Post", + "message": "Article plus ancien", "description": "The blog post button label to navigate to the older/next post" }, "theme.blog.post.plurals": { - "message": "One post|{count} posts", + "message": "Un article|{count} articles", "description": "Pluralized label for \"{count} posts\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" }, "theme.blog.tagTitle": { - "message": "{nPosts} tagged with \"{tagName}\"", + "message": "{nPosts} tagués avec « {tagName} »", "description": "The title of the page for a blog tag" }, "theme.tags.tagsPageLink": { - "message": "View All Tags", + "message": "Voir tous les tags", "description": "The label of the link targeting the tag list page" }, "theme.colorToggle.ariaLabel": { - "message": "Switch between dark and light mode (currently {mode})", + "message": "Basculer entre le mode sombre et le mode clair (actuellement {mode})", "description": "The ARIA label for the navbar color mode toggle" }, "theme.colorToggle.ariaLabel.mode.dark": { - "message": "dark mode", + "message": "mode sombre", "description": "The name for the dark color mode" }, "theme.colorToggle.ariaLabel.mode.light": { - "message": "light mode", + "message": "mode clair", "description": "The name for the light color mode" }, "theme.docs.breadcrumbs.home": { - "message": "Home page", + "message": "Page d’accueil", "description": "The ARIA label for the home page in the breadcrumbs" }, "theme.docs.breadcrumbs.navAriaLabel": { - "message": "Breadcrumbs", + "message": "Fil d'Ariane", "description": "The ARIA label for the breadcrumbs" }, "theme.docs.DocCard.categoryDescription": { - "message": "{count} items", + "message": "{count} éléments", "description": "The default description for a category card in the generated index about how many items this category includes" }, "theme.docs.paginator.navAriaLabel": { - "message": "Docs pages navigation", + "message": "Navigation dans les pages", "description": "The ARIA label for the docs pagination" }, "theme.docs.paginator.previous": { - "message": "Previous", + "message": "Précédent", "description": "The label used to navigate to the previous doc" }, "theme.docs.paginator.next": { - "message": "Next", + "message": "Suivant", "description": "The label used to navigate to the next doc" }, "theme.docs.tagDocListPageTitle.nDocsTagged": { - "message": "One doc tagged|{count} docs tagged", + "message": "Un document tagué|{count} documents tagués", "description": "Pluralized label for \"{count} docs tagged\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" }, "theme.docs.tagDocListPageTitle": { - "message": "{nDocsTagged} with \"{tagName}\"", + "message": "{nDocsTagged} avec \"{tagName}\"", "description": "The title of the page for a docs tag" }, "theme.docs.versionBadge.label": { - "message": "Version: {versionLabel}" + "message": "Version : {versionLabel}" }, "theme.docs.versions.unreleasedVersionLabel": { - "message": "This is unreleased documentation for {siteTitle} {versionLabel} version.", + "message": "Ceci est une documentation non publiée pour la version {versionLabel} de {siteTitle}.", "description": "The label used to tell the user that he's browsing an unreleased doc version" }, "theme.docs.versions.unmaintainedVersionLabel": { - "message": "This is documentation for {siteTitle} {versionLabel}, which is no longer actively maintained.", + "message": "Ceci est la documentation de {siteTitle} {versionLabel}, qui n'est plus activement maintenue.", "description": "The label used to tell the user that he's browsing an unmaintained doc version" }, "theme.docs.versions.latestVersionSuggestionLabel": { - "message": "For up-to-date documentation, see the {latestVersionLink} ({versionLabel}).", + "message": "Pour une documentation à jour, consultez la {latestVersionLink} ({versionLabel}).", "description": "The label used to tell the user to check the latest version" }, "theme.docs.versions.latestVersionLinkLabel": { - "message": "latest version", + "message": "dernière version", "description": "The label used for the latest version suggestion link label" }, "theme.common.editThisPage": { - "message": "Edit this page", + "message": "Éditer cette page", "description": "The link label to edit the current page" }, "theme.common.headingLinkTitle": { - "message": "Direct link to heading", + "message": "Lien direct vers l'entête", "description": "Title for link to heading" }, "theme.lastUpdated.atDate": { - "message": " on {date}", + "message": " le {date}", "description": "The words used to describe on which date a page has been last updated" }, "theme.lastUpdated.byUser": { - "message": " by {user}", + "message": " par {user}", "description": "The words used to describe by who the page has been last updated" }, "theme.lastUpdated.lastUpdatedAtBy": { - "message": "Last updated{atDate}{byUser}", + "message": "Dernière mise à jour{atDate}{byUser}", "description": "The sentence used to display when a page has been last updated, and by who" }, "theme.navbar.mobileVersionsDropdown.label": { @@ -179,214 +179,214 @@ "description": "The label alongside a tag list" }, "theme.AnnouncementBar.closeButtonAriaLabel": { - "message": "Close", + "message": "Fermer", "description": "The ARIA label for close button of announcement bar" }, "theme.blog.sidebar.navAriaLabel": { - "message": "Blog recent posts navigation", + "message": "Navigation dans les articles récents du blog", "description": "The ARIA label for recent posts in the blog sidebar" }, "theme.CodeBlock.copied": { - "message": "Copied", + "message": "Copié", "description": "The copied button label on code blocks" }, "theme.CodeBlock.copyButtonAriaLabel": { - "message": "Copy code to clipboard", + "message": "Copier le code dans le presse-papiers", "description": "The ARIA label for copy code blocks button" }, "theme.CodeBlock.copy": { - "message": "Copy", + "message": "Copier", "description": "The copy button label on code blocks" }, "theme.CodeBlock.wordWrapToggle": { - "message": "Toggle word wrap", + "message": "Basculer le retour à la ligne automatique", "description": "The title attribute for toggle word wrapping button of code block lines" }, "theme.DocSidebarItem.toggleCollapsedCategoryAriaLabel": { - "message": "Toggle the collapsible sidebar category '{label}'", + "message": "Plier/Déplier la catégorie '{label}' de la barre latérale", "description": "The ARIA label to toggle the collapsible sidebar category" }, "theme.navbar.mobileLanguageDropdown.label": { - "message": "Languages", + "message": "Langues", "description": "The label for the mobile language switcher dropdown" }, "theme.TOCCollapsible.toggleButtonLabel": { - "message": "On this page", + "message": "Sur cette page", "description": "The label used by the button on the collapsible TOC component" }, "theme.blog.post.readMore": { - "message": "Read More", + "message": "En Savoir Plus", "description": "The label used in blog post item excerpts to link to full blog posts" }, "theme.blog.post.readMoreLabel": { - "message": "Read more about {title}", + "message": "En savoir plus sur {title}", "description": "The ARIA label for the link to full blog posts from excerpts" }, "theme.blog.post.readingTime.plurals": { - "message": "One min read|{readingTime} min read", + "message": "Une minute de lecture|{readingTime} minutes de lecture", "description": "Pluralized label for \"{readingTime} min read\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" }, "theme.docs.sidebar.collapseButtonTitle": { - "message": "Collapse sidebar", + "message": "Réduire la barre latérale", "description": "The title attribute for collapse button of doc sidebar" }, "theme.docs.sidebar.collapseButtonAriaLabel": { - "message": "Collapse sidebar", + "message": "Réduire la barre latérale", "description": "The title attribute for collapse button of doc sidebar" }, "theme.docs.sidebar.closeSidebarButtonAriaLabel": { - "message": "Close navigation bar", + "message": "Fermer la barre de navigation", "description": "The ARIA label for close button of mobile sidebar" }, "theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": { - "message": "← Back to main menu", + "message": "Retour au menu principal", "description": "The label of the back button to return to main menu, inside the mobile navbar sidebar secondary menu (notably used to display the docs sidebar)" }, "theme.docs.sidebar.toggleSidebarButtonAriaLabel": { - "message": "Toggle navigation bar", + "message": "Afficher/Masquer la barre de navigation", "description": "The ARIA label for hamburger menu button of mobile navigation" }, "theme.docs.sidebar.expandButtonTitle": { - "message": "Expand sidebar", + "message": "Déplier le menu latéral", "description": "The ARIA label and title attribute for expand button of doc sidebar" }, "theme.docs.sidebar.expandButtonAriaLabel": { - "message": "Expand sidebar", + "message": "Déplier le menu latéral", "description": "The ARIA label and title attribute for expand button of doc sidebar" }, "theme.SearchBar.seeAll": { - "message": "See all {count} results" + "message": "Voir les {count} résultats" }, "theme.SearchPage.documentsFound.plurals": { - "message": "One document found|{count} documents found", + "message": "Un document trouvé |{count} documents trouvés", "description": "Pluralized label for \"{count} documents found\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" }, "theme.SearchPage.existingResultsTitle": { - "message": "Search results for \"{query}\"", + "message": "Résultats de la recherche pour \"{query}\"", "description": "The search page title for non-empty query" }, "theme.SearchPage.emptyResultsTitle": { - "message": "Search the documentation", + "message": "Rechercher dans la documentation", "description": "The search page title for empty query" }, "theme.SearchPage.inputPlaceholder": { - "message": "Type your search here", + "message": "Saisissez votre recherche ici", "description": "The placeholder for search page input" }, "theme.SearchPage.inputLabel": { - "message": "Search", + "message": "Rechercher", "description": "The ARIA label for search page input" }, "theme.SearchPage.algoliaLabel": { - "message": "Search by Algolia", + "message": "Recherche par Algolia", "description": "The ARIA label for Algolia mention" }, "theme.SearchPage.noResultsText": { - "message": "No results were found", + "message": "Aucun résultat trouvé", "description": "The paragraph for empty search result" }, "theme.SearchPage.fetchingNewResults": { - "message": "Fetching new results...", + "message": "Recherche de nouveaux résultats...", "description": "The paragraph for fetching new search results" }, "theme.SearchBar.label": { - "message": "Search", + "message": "Rechercher", "description": "The ARIA label and placeholder for search button" }, "theme.SearchModal.searchBox.resetButtonTitle": { - "message": "Clear the query", + "message": "Effacer la recherche", "description": "The label and ARIA label for search box reset button" }, "theme.SearchModal.searchBox.cancelButtonText": { - "message": "Cancel", + "message": "Annuler", "description": "The label and ARIA label for search box cancel button" }, "theme.SearchModal.startScreen.recentSearchesTitle": { - "message": "Recent", + "message": "Récent", "description": "The title for recent searches" }, "theme.SearchModal.startScreen.noRecentSearchesText": { - "message": "No recent searches", + "message": "Pas de recherches récentes", "description": "The text when no recent searches" }, "theme.SearchModal.startScreen.saveRecentSearchButtonTitle": { - "message": "Save this search", + "message": "Enregistrer cette recherche", "description": "The label for save recent search button" }, "theme.SearchModal.startScreen.removeRecentSearchButtonTitle": { - "message": "Remove this search from history", + "message": "Supprimer cette recherche de l'historique", "description": "The label for remove recent search button" }, "theme.SearchModal.startScreen.favoriteSearchesTitle": { - "message": "Favorite", + "message": "Favoris", "description": "The title for favorite searches" }, "theme.SearchModal.startScreen.removeFavoriteSearchButtonTitle": { - "message": "Remove this search from favorites", + "message": "Supprimer cette recherche des favoris", "description": "The label for remove favorite search button" }, "theme.SearchModal.errorScreen.titleText": { - "message": "Unable to fetch results", + "message": "Impossible de récupérer les résultats", "description": "The title for error screen of search modal" }, "theme.SearchModal.errorScreen.helpText": { - "message": "You might want to check your network connection.", + "message": "Vous devriez vérifier votre connexion réseau.", "description": "The help text for error screen of search modal" }, "theme.SearchModal.footer.selectText": { - "message": "to select", + "message": "sélectionner", "description": "The explanatory text of the action for the enter key" }, "theme.SearchModal.footer.selectKeyAriaLabel": { - "message": "Enter key", + "message": "Touche Entrée", "description": "The ARIA label for the Enter key button that makes the selection" }, "theme.SearchModal.footer.navigateText": { - "message": "to navigate", + "message": "naviguer", "description": "The explanatory text of the action for the Arrow up and Arrow down key" }, "theme.SearchModal.footer.navigateUpKeyAriaLabel": { - "message": "Arrow up", + "message": "Flèche du haut", "description": "The ARIA label for the Arrow up key button that makes the navigation" }, "theme.SearchModal.footer.navigateDownKeyAriaLabel": { - "message": "Arrow down", + "message": "Flèche du bas", "description": "The ARIA label for the Arrow down key button that makes the navigation" }, "theme.SearchModal.footer.closeText": { - "message": "to close", + "message": "fermer", "description": "The explanatory text of the action for Escape key" }, "theme.SearchModal.footer.closeKeyAriaLabel": { - "message": "Escape key", + "message": "Touche Echap", "description": "The ARIA label for the Escape key button that close the modal" }, "theme.SearchModal.footer.searchByText": { - "message": "Search by", + "message": "Rechercher par", "description": "The text explain that the search is making by Algolia" }, "theme.SearchModal.noResultsScreen.noResultsText": { - "message": "No results for", + "message": "Aucun résultat pour", "description": "The text explains that there are no results for the following search" }, "theme.SearchModal.noResultsScreen.suggestedQueryText": { - "message": "Try searching for", + "message": "Essayez de rechercher", "description": "The text for the suggested query when no results are found for the following search" }, "theme.SearchModal.noResultsScreen.reportMissingResultsText": { - "message": "Believe this query should return results?", + "message": "Pensez-vous que cette requête aurait dû retourner des résultats ?", "description": "The text for the question where the user thinks there are missing results" }, "theme.SearchModal.noResultsScreen.reportMissingResultsLinkText": { - "message": "Let us know.", + "message": "Faites-le nous savoir.", "description": "The text for the link to report missing results" }, "theme.SearchModal.placeholder": { - "message": "Search docs", + "message": "Rechercher dans la documentation", "description": "The placeholder of the input of the DocSearch pop-up modal" }, "theme.common.skipToMainContent": { - "message": "Skip to main content", + "message": "Accéder directement au contenu principal", "description": "The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation" }, "theme.tags.tagsPageTitle": { diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-blog/authors.yml b/docs/i18n/fr-FR/docusaurus-plugin-content-blog/authors.yml index e9cfd581..450a93a8 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-blog/authors.yml +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-blog/authors.yml @@ -1,5 +1,5 @@ andreynering: name: Andrey Nering - title: Maintainer of Task + title: Mainteneur de Task url: https://github.com/andreynering image_url: https://github.com/andreynering.png diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current.json b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current.json index f2135103..dc4d77cd 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current.json +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current.json @@ -1,10 +1,10 @@ { "version.label": { - "message": "Next", + "message": "Suivant", "description": "The label for version current" }, "sidebar.tutorialSidebar.link.Chinese | 中国人": { - "message": "Chinese | 中国人", + "message": "Chinois | 中国人", "description": "The label for link Chinese | 中国人 in sidebar tutorialSidebar, linking to https://task-zh.readthedocs.io/zh_CN/latest/" } } diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/community.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/community.md index 5153a123..79a1bc75 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/community.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/community.md @@ -3,30 +3,30 @@ slug: /community/ sidebar_position: 9 --- -# Community +# Communauté -Some of the work to improve the Task ecosystem is done by the community, be it installation methods or integrations with code editor. I (the author) am thankful for everyone that helps me to improve the overall experience. +Certains travaux d'amélioration de l'écosystème Task sont réalisés par la communauté, que ce soit des méthodes d'installation ou des intégrations avec l'éditeur de code. Moi (l'auteur) suis reconnaissant envers tout le monde qui m'aide à améliorer l'expérience globale. -## Translations +## Traductions -[@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). +[@DeronW](https://github.com/DeronW) maintient la [traduction Chinoise](https://task-zh.readthedocs.io/zh_CN/latest/) du site [sur ce dépôt](https://github.com/DeronW/task). -## Integrations +## Intégrations -Many of our integrations are contributed and maintained by the community. You can view the full list of community integrations [here](/integrations#community-integrations). +Un grand nombre de nos intégrations sont apportées et maintenues par la communauté. Vous pouvez voir la liste complète des intégrations de la communauté [ici](/integrations#community-integrations). -## Installation methods +## Méthodes d'installation -Some installation methods are maintained by third party: +Certaines méthodes d'installation sont maintenues par un tiers : -- [GitHub Actions](https://github.com/arduino/setup-task) by [@arduino](https://github.com/arduino) -- [AUR](https://aur.archlinux.org/packages/go-task-bin) by [@carlsmedstad](https://github.com/carlsmedstad) +- [Actions GitHub](https://github.com/arduino/setup-task) par [@arduino](https://github.com/arduino) +- [AUR](https://aur.archlinux.org/packages/go-task-bin) par [@carlsmedstad](https://github.com/carlsmedstad) - [Scoop](https://github.com/ScoopInstaller/Main/blob/master/bucket/task.json) - [Fedora](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/) - [NixOS](https://github.com/NixOS/nixpkgs/blob/master/pkgs/development/tools/go-task/default.nix) -## More +## Plus d’infos -Also, thanks for all the [code contributors](https://github.com/go-task/task/graphs/contributors), [financial contributors](https://opencollective.com/task), all those who [reported bugs](https://github.com/go-task/task/issues?q=is%3Aissue) and [answered questions](https://github.com/go-task/task/discussions). +Aussi, merci à tous les [contributeurs](https://github.com/go-task/task/graphs/contributors), [contributeurs financiers](https://opencollective.com/task), tous ceux qui [ont signalé des bugs](https://github.com/go-task/task/issues?q=is%3Aissue) et [ont répondu aux questions](https://github.com/go-task/task/discussions). -If you know something that is missing in this document, please submit a pull request. +Si vous voyez quelque chose qui manque dans ce document, veuillez soumettre une pull request. diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/donate.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/donate.md index 6b520d7f..c76f0858 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/donate.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/donate.md @@ -3,40 +3,40 @@ slug: /donate/ sidebar_position: 13 --- -# Donate +# Faire un don -If you find this project useful, you can consider donating by using one of the channels listed below. +Si vous trouvez ce projet utile, vous pouvez envisager de faire un don en utilisant l'un des canaux listés ci-dessous. -This is just a way of saying "thank you", it won't give you any benefits like higher priority on issues or something similar. +C'est juste une façon de nous dire "merci", il ne vous donnera pas d'avantages comme une priorité élevée sur des problèmes ou des choses similaires. -Companies who donate at least $50/month will be featured as a "Gold Sponsor" in the website homepage and on the GitHub repository README. Make contact with [@andreynering][] with the logo you want to be shown. Suspect businesses (gambling, casinos, etc) won't be allowed, though. +Les entreprises qui font un don d'au moins 50$/mois seront présentées comme un "Sponsor Or" sur la page d'accueil du site and sur le README du dépôt GitHub. Prenez contact avec [@andreynering][] avec le logo que vous voulez afficher. Cependant, les entreprises suspectes (jeux, casinos, etc) ne seront pas autorisées. -## GitHub Sponsors +## Sponsors GitHub -The preferred way to donate to the maintainers is via GitHub Sponsors. Just use the following links to do your donation: +La façon préférée de faire un don aux mainteneurs du projet est d'utiliser les sponsors GitHub. Utilisez simplement le lien suivant pour faire votre don : - [@andreynering](https://github.com/sponsors/andreynering) - [@pd93](https://github.com/sponsors/pd93) ## Open Collective -If you prefer [Open Collective](https://opencollective.com/task) you can donate by using these links: +Si vous préférez [Open Collective](https://opencollective.com/task) vous pouvez faire un don en utilisant ces liens : -- [$2 per month](https://opencollective.com/task/contribute/backer-4034/checkout) -- [$5 per month](https://opencollective.com/task/contribute/supporter-8404/checkout) -- [$20 per month](https://opencollective.com/task/contribute/sponsor-4035/checkout) -- [$50 per month](https://opencollective.com/task/contribute/sponsor-28775/checkout) -- [Custom value - One-time donation option supported](https://opencollective.com/task/donate) +- [2$ par mois](https://opencollective.com/task/contribute/backer-4034/checkout) +- [5$ par mois](https://opencollective.com/task/contribute/supporter-8404/checkout) +- [20$ par mois](https://opencollective.com/task/contribute/sponsor-4035/checkout) +- [50$ par mois](https://opencollective.com/task/contribute/sponsor-28775/checkout) +- [Valeur personnalisée - option de don unique prise en charge](https://opencollective.com/task/donate) ## PayPal -You can donate to [@andreynering][] via PayPal as well: +Vous pouvez aussi faire un don à [@andreynering][] via PayPal : -- [Any value - One-time donation](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=GSVDU63RKG45A¤cy_code=USD&source=url) +- [N'importe quelle valeur - Don unique](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=GSVDU63RKG45A¤cy_code=USD&source=url) -## PIX (Brazil only) +## PIX (Brésil uniquement) -And if you're Brazilian, you can also donate to [@andreynering][] via PIX by [using this QR Code](/img/pix.png). +Et si vous êtes Brésilien, vous pouvez également faire un don à [@andreynering][] via PIX en [utilisant ce QR Code](/img/pix.png). diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/faq.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/faq.md index 27abfdd4..eba60cbc 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/faq.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/faq.md @@ -5,7 +5,7 @@ sidebar_position: 6 # FAQ -This page contains a list of frequently asked questions about Task. +Cette page contient une liste de question fréquemment posée à propos de Task. - [Why won't my task update my shell environment?](#why-wont-my-task-update-my-shell-environment) - ['x' builtin command doesn't work on Windows](#x-builtin-command-doesnt-work-on-windows) diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/intro.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/intro.md index 4491233c..5e1e7659 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/intro.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/intro.md @@ -1,7 +1,7 @@ --- slug: / sidebar_position: 1 -title: Home +title: Accueil --- # Task @@ -10,11 +10,11 @@ title: Home -Task is a task runner / build tool that aims to be simpler and easier to use than, for example, [GNU Make][make]. +Task est un exécuteur de tâches / de build qui vise à être plus simple et facile à utiliser que, par exemple, [GNU Make][make]. -Since it's written in [Go][go], Task is just a single binary and has no other dependencies, which means you don't need to mess with any complicated install setups just to use a build tool. +Comme il est écrit en [Go][go], Task n'est qu'un binaire unique et n'a aucune dépendance. Cela signifie que vous n'avez pas besoin d'une installation compliquée simplement pour utiliser un outil de build. -Once [installed](installation.md), you just need to describe your build tasks using a simple [YAML][yaml] schema in a file called `Taskfile.yml`: +Une fois [installé](installation.md), il vous suffit de décrire vos tâches de build en utilisant un simple schéma [YAML][yaml] dans un fichier appelé `Taskfile.yml`: ```yaml title="Taskfile.yml" version: '3' @@ -26,18 +26,18 @@ tasks: silent: true ``` -And call it by running `task hello` from your terminal. +Et appelez-le en exécutant `task hello` depuis votre terminal. -The above example is just the start, you can take a look at the [usage](/usage) guide to check the full schema documentation and Task features. +L'exemple ci-dessus n'est que le début, vous pouvez jeter un coup d'œil au [guide d'utilisation](/usage) pour vérifier la documentation complète du schéma et les fonctionnalités de Task. -## Features +## Fonctionnalités -- [Easy installation](installation.md): just download a single binary, add to `$PATH` and you're done! Or you can also install using [Homebrew][homebrew], [Snapcraft][snapcraft], or [Scoop][scoop] if you want. -- Available on CIs: by adding [this simple command](installation.md#install-script) to install on your CI script and you're ready to use Task as part of your CI pipeline; -- Truly cross-platform: while most build tools only work well on Linux or macOS, Task also supports Windows thanks to [this shell interpreter for Go][sh]. -- Great for code generation: you can easily [prevent a task from running](/usage#prevent-unnecessary-work) if a given set of files haven't changed since last run (based either on its timestamp or content). +- [Installation facile](installation.md): il suffit de télécharger un seul binaire, ajoutez le à `$PATH` et vous avez terminé ! Ou vous pouvez également installer en utilisant [Homebrew][homebrew], [Snapcraft][snapcraft] ou [Scoop][scoop] si vous le souhaitez. +- Disponible sur les CIs: en ajoutant [cette commande simple](installation.md#install-script) à installer sur votre script CI, vous êtes prêt à utiliser Task dans le cadre de votre pipeline CI ; +- Multi-plateforme : alors que la plupart des outils de compilation ne fonctionnent bien que sous Linux ou macOS, Task prend également en charge Windows grâce à [cet interpréteur shell pour Go][sh]. +- Idéal pour la génération de code : vous pouvez facilement [empêcher une tâche de s'exécuter](/usage#prevent-unnecessary-work) si un ensemble donné de fichiers n'ont pas changé depuis le dernier lancement (basé soit sur son horodatage soit son contenu). -## Gold Sponsors +## Sponsors Or
diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/styleguide.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/styleguide.md index adbf5eb1..0b25331d 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/styleguide.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/styleguide.md @@ -3,13 +3,13 @@ slug: /styleguide/ sidebar_position: 7 --- -# Styleguide +# Guide de style -This is the official Task styleguide for `Taskfile.yml` files. This guide contains some basic instructions to keep your Taskfile clean and familiar to other users. +Ceci est le guide officiel du style Task pour les fichiers `Taskfile.yml`. Ce guide contient quelques instructions de base pour garder votre Taskfile propre et familier à autres utilisateurs. -This contains general guidelines, but they don't necessarily need to be strictly followed. Feel free to disagree and proceed differently at some point if you need or want to. Also, feel free to open issues or pull requests with improvements to this guide. +Il contient des directives générales, mais elles ne doivent pas nécessairement être strictement respectées. N'hésitez pas à procéder différemment si vous en avez le besoin ou que vous le souhaitez. Aussi, n'hésitez pas à [ouvrir une issue](https://github. com/go-task/task/issues/new/choose) ou [faire une pull request](https://github. com/go-task/task/compare) pour améliorer ce guide. -## Use `Taskfile.yml` and not `taskfile.yml` +## Utiliser `Taskfile.yml` et non `taskfile.yml` ```yaml # bad @@ -20,9 +20,9 @@ taskfile.yml Taskfile.yml ``` -This is important especially for Linux users. Windows and macOS have case insensitive filesystems, so `taskfile.yml` will end up working, even that not officially supported. On Linux, only `Taskfile.yml` will work, though. +C'est important, surtout pour les utilisateurs Linux. Windows et MacOS ont un système de fichiers insensibles à la casse, donc `taskfile.yml` fonctionnera, même si ce n'est pas officiellement supporté. Sur Linux, uniquement `Taskfile.yml` fonctionnera. -## Use the correct order of keywords +## Utiliser les mots-clés dans l'ordre correct - `version:` - `includes:` @@ -31,9 +31,9 @@ This is important especially for Linux users. Windows and macOS have case insens - `env:`, `dotenv:` - `tasks:` -## Use 2 spaces for indentation +## Utiliser 2 espaces pour l'indentation -This is the most common convention for YAML files, and Task follows it. +C'est la convention la plus courante pour les fichiers YAML et Task suit cette convention. ```yaml # bad @@ -50,7 +50,7 @@ tasks: - echo 'foo' ``` -## Separate with spaces the mains sections +## Séparer les sections principales avec un retour à la ligne ```yaml # bad @@ -84,7 +84,7 @@ tasks: # ... ``` -## Add spaces between tasks +## Ajouter des retours à la ligne entre les tâches ```yaml # bad @@ -119,7 +119,7 @@ tasks: - echo 'baz' ``` -## Use upper-case variable names +## Utiliser des noms de variables en majuscule ```yaml # bad @@ -146,7 +146,7 @@ tasks: - go build -o {{.BINARY_NAME}} . ``` -## Don't wrap vars in spaces when templating +## Ne pas mettre d'espaces autour des variables lors de l'utilisation ```yaml # bad @@ -167,9 +167,9 @@ tasks: - echo '{{.MESSAGE}}' ``` -This convention is also used by most people for any Go templating. +Cette convention est aussi utilisée par la plupart des gens pour n'importe quel modèle Go. -## Separate task name words with a dash +## Séparer les mots du nom de la tâche par un tiret ```yaml # bad @@ -190,7 +190,7 @@ tasks: - echo 'Do something' ``` -## Use colon for task namespacing +## Utiliser les deux-points pour nommer les namespaces de tâche ```yaml # good @@ -206,4 +206,4 @@ tasks: - docker-compose ... ``` -This is also done automatically when using included Taskfiles. +C'est aussi fait automatiquement quand vous incluez des Taskfiles. diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/translate.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/translate.md index 56c2fbea..c6588539 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/translate.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/translate.md @@ -3,13 +3,13 @@ slug: /translate/ sidebar_position: 14 --- -# Translate +# Traduction -Want to help us translate this documentation? In this document we explain how. +Vous voulez nous aider à traduire cette documentation ? Nous expliquons ci-dessous comment faire. -Do NOT edit translated markdown files directly on the GitHub repository! We use [Crowdin][crowdin] to allow contributors on work on translations. The repository is periodically updated with progress from Crowdin. +Ne PAS éditer directement sur le dépôt GitHub les fichiers markdown traduits ! Nous utilisons [Crowdin][crowdin] pour permettre aux contributeurs de travailler sur les traductions. Le dépôt est périodiquement mis à jour avec la progression des traductions sur Crowdin. -If you want to have access to the Crowdin project to be able to suggest translations, please ask for access on the [#translations channel on our Discord server][discord]. If a given language is not being shown to Crowdin yet, just ask and we can configure it. +Si vous voulez avoir accès au projet Crowdin pour pouvoir suggérer des traductions, veuillez demander l'accès sur le [canal #traductions sur notre serveur Discord ][discord]. Si une langue n'est pas encore affichée sur Crowdin, il suffit de demander et nous pouvons la configurer. diff --git a/docs/i18n/fr-FR/docusaurus-theme-classic/footer.json b/docs/i18n/fr-FR/docusaurus-theme-classic/footer.json index 2a81edee..548761f3 100644 --- a/docs/i18n/fr-FR/docusaurus-theme-classic/footer.json +++ b/docs/i18n/fr-FR/docusaurus-theme-classic/footer.json @@ -4,11 +4,11 @@ "description": "The title of the footer links column with title=Pages in the footer" }, "link.title.Community": { - "message": "Community", + "message": "Communauté", "description": "The title of the footer links column with title=Community in the footer" }, "link.title.Translations": { - "message": "Translations", + "message": "Traductions", "description": "The title of the footer links column with title=Translations in the footer" }, "link.item.label.Installation": { @@ -16,11 +16,11 @@ "description": "The label of footer link with label=Installation linking to /installation/" }, "link.item.label.Usage": { - "message": "Usage", + "message": "Utilisation", "description": "The label of footer link with label=Usage linking to /usage/" }, "link.item.label.Donate": { - "message": "Donate", + "message": "Faire un don", "description": "The label of footer link with label=Donate linking to /donate/" }, "link.item.label.GitHub": { @@ -44,7 +44,7 @@ "description": "The label of footer link with label=OpenCollective linking to https://opencollective.com/task" }, "link.item.label.Chinese | 中国人": { - "message": "Chinese | 中国人", + "message": "Chinois | 中国人", "description": "The label of footer link with label=Chinese | 中国人 linking to https://task-zh.readthedocs.io/zh_CN/latest/" } } diff --git a/docs/i18n/fr-FR/docusaurus-theme-classic/navbar.json b/docs/i18n/fr-FR/docusaurus-theme-classic/navbar.json index 4bab333c..b72cefb5 100644 --- a/docs/i18n/fr-FR/docusaurus-theme-classic/navbar.json +++ b/docs/i18n/fr-FR/docusaurus-theme-classic/navbar.json @@ -8,7 +8,7 @@ "description": "Navbar item with label Installation" }, "item.label.Usage": { - "message": "Usage", + "message": "Utilisation", "description": "Navbar item with label Usage" }, "item.label.API": { @@ -16,7 +16,7 @@ "description": "Navbar item with label API" }, "item.label.Donate": { - "message": "Donate", + "message": "Faire un don", "description": "Navbar item with label Donate" }, "item.label.GitHub": { diff --git a/docs/i18n/ru-RU/code.json b/docs/i18n/ru-RU/code.json index be706914..2e4e2f74 100644 --- a/docs/i18n/ru-RU/code.json +++ b/docs/i18n/ru-RU/code.json @@ -1,396 +1,396 @@ { "theme.ErrorPageContent.title": { - "message": "This page crashed.", + "message": "На странице произошёл сбой.", "description": "The title of the fallback page when the page crashed" }, "theme.ErrorPageContent.tryAgain": { - "message": "Try again", + "message": "Попробуйте ещё раз", "description": "The label of the button to try again when the page crashed" }, "theme.NotFound.title": { - "message": "Page Not Found", + "message": "Страница не найдена", "description": "The title of the 404 page" }, "theme.NotFound.p1": { - "message": "We could not find what you were looking for.", + "message": "К сожалению, мы не смогли найти запрашиваемую вами страницу.", "description": "The first paragraph of the 404 page" }, "theme.NotFound.p2": { - "message": "Please contact the owner of the site that linked you to the original URL and let them know their link is broken.", + "message": "Пожалуйста, обратитесь к владельцу сайта, с которого вы перешли на эту ссылку, чтобы сообщить ему, что ссылка не работает.", "description": "The 2nd paragraph of the 404 page" }, "theme.admonition.note": { - "message": "note", + "message": "примечание", "description": "The default label used for the Note admonition (:::note)" }, "theme.admonition.tip": { - "message": "tip", + "message": "подсказка", "description": "The default label used for the Tip admonition (:::tip)" }, "theme.admonition.danger": { - "message": "danger", + "message": "осторожно", "description": "The default label used for the Danger admonition (:::danger)" }, "theme.admonition.info": { - "message": "info", + "message": "к сведению", "description": "The default label used for the Info admonition (:::info)" }, "theme.admonition.caution": { - "message": "caution", + "message": "предупреждение", "description": "The default label used for the Caution admonition (:::caution)" }, "theme.BackToTopButton.buttonAriaLabel": { - "message": "Scroll back to top", + "message": "Прокрутка к началу", "description": "The ARIA label for the back to top button" }, "theme.blog.archive.title": { - "message": "Archive", + "message": "Архив", "description": "The page & hero title of the blog archive page" }, "theme.blog.archive.description": { - "message": "Archive", + "message": "Архив", "description": "The page & hero description of the blog archive page" }, "theme.blog.paginator.navAriaLabel": { - "message": "Blog list page navigation", + "message": "Навигация по странице списка блогов", "description": "The ARIA label for the blog pagination" }, "theme.blog.paginator.newerEntries": { - "message": "Newer Entries", + "message": "Следующие записи", "description": "The label used to navigate to the newer blog posts page (previous page)" }, "theme.blog.paginator.olderEntries": { - "message": "Older Entries", + "message": "Предыдущие записи", "description": "The label used to navigate to the older blog posts page (next page)" }, "theme.blog.post.paginator.navAriaLabel": { - "message": "Blog post page navigation", + "message": "Навигация по странице поста блога", "description": "The ARIA label for the blog posts pagination" }, "theme.blog.post.paginator.newerPost": { - "message": "Newer Post", + "message": "Следующий пост", "description": "The blog post button label to navigate to the newer/previous post" }, "theme.blog.post.paginator.olderPost": { - "message": "Older Post", + "message": "Предыдущий пост", "description": "The blog post button label to navigate to the older/next post" }, "theme.blog.post.plurals": { - "message": "One post|{count} posts", + "message": "{count} запись|{count} записи|{count} записей", "description": "Pluralized label for \"{count} posts\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" }, "theme.blog.tagTitle": { - "message": "{nPosts} tagged with \"{tagName}\"", + "message": "{nPosts} с тегом \"{tagName}\"", "description": "The title of the page for a blog tag" }, "theme.tags.tagsPageLink": { - "message": "View All Tags", + "message": "Посмотреть все теги", "description": "The label of the link targeting the tag list page" }, "theme.colorToggle.ariaLabel": { - "message": "Switch between dark and light mode (currently {mode})", + "message": "Переключение между темным и светлым режимом (сейчас используется {mode})", "description": "The ARIA label for the navbar color mode toggle" }, "theme.colorToggle.ariaLabel.mode.dark": { - "message": "dark mode", + "message": "Тёмный режим", "description": "The name for the dark color mode" }, "theme.colorToggle.ariaLabel.mode.light": { - "message": "light mode", + "message": "Светлый режим", "description": "The name for the light color mode" }, "theme.docs.breadcrumbs.home": { - "message": "Home page", + "message": "Главная страница", "description": "The ARIA label for the home page in the breadcrumbs" }, "theme.docs.breadcrumbs.navAriaLabel": { - "message": "Breadcrumbs", + "message": "Навигационная цепочка текущей страницы", "description": "The ARIA label for the breadcrumbs" }, "theme.docs.DocCard.categoryDescription": { - "message": "{count} items", + "message": "{count} элемент|{count} элемента|{count} элементов", "description": "The default description for a category card in the generated index about how many items this category includes" }, "theme.docs.paginator.navAriaLabel": { - "message": "Docs pages navigation", + "message": "Навигация по странице документации", "description": "The ARIA label for the docs pagination" }, "theme.docs.paginator.previous": { - "message": "Previous", + "message": "Предыдущая страница", "description": "The label used to navigate to the previous doc" }, "theme.docs.paginator.next": { - "message": "Next", + "message": "Следующая страница", "description": "The label used to navigate to the next doc" }, "theme.docs.tagDocListPageTitle.nDocsTagged": { - "message": "One doc tagged|{count} docs tagged", + "message": "Одна страница|{count} страницы|{count} страниц", "description": "Pluralized label for \"{count} docs tagged\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" }, "theme.docs.tagDocListPageTitle": { - "message": "{nDocsTagged} with \"{tagName}\"", + "message": "{nDocsTagged} с тегом \"{tagName}\"", "description": "The title of the page for a docs tag" }, "theme.docs.versionBadge.label": { - "message": "Version: {versionLabel}" + "message": "Версия: {versionLabel}" }, "theme.docs.versions.unreleasedVersionLabel": { - "message": "This is unreleased documentation for {siteTitle} {versionLabel} version.", + "message": "Это документация для будущей версии {siteTitle} {versionLabel}.", "description": "The label used to tell the user that he's browsing an unreleased doc version" }, "theme.docs.versions.unmaintainedVersionLabel": { - "message": "This is documentation for {siteTitle} {versionLabel}, which is no longer actively maintained.", + "message": "Это документация {siteTitle} для версии {versionLabel}, которая уже не поддерживается.", "description": "The label used to tell the user that he's browsing an unmaintained doc version" }, "theme.docs.versions.latestVersionSuggestionLabel": { - "message": "For up-to-date documentation, see the {latestVersionLink} ({versionLabel}).", + "message": "Актуальная документация находится на странице {latestVersionLink} ({versionLabel}).", "description": "The label used to tell the user to check the latest version" }, "theme.docs.versions.latestVersionLinkLabel": { - "message": "latest version", + "message": "последней версии", "description": "The label used for the latest version suggestion link label" }, "theme.common.editThisPage": { - "message": "Edit this page", + "message": "Отредактировать эту страницу", "description": "The link label to edit the current page" }, "theme.common.headingLinkTitle": { - "message": "Direct link to heading", + "message": "Прямая ссылка на {heading}", "description": "Title for link to heading" }, "theme.lastUpdated.atDate": { - "message": " on {date}", + "message": " {date}", "description": "The words used to describe on which date a page has been last updated" }, "theme.lastUpdated.byUser": { - "message": " by {user}", + "message": " от {user}", "description": "The words used to describe by who the page has been last updated" }, "theme.lastUpdated.lastUpdatedAtBy": { - "message": "Last updated{atDate}{byUser}", + "message": "Последнее обновление{atDate}{byUser}", "description": "The sentence used to display when a page has been last updated, and by who" }, "theme.navbar.mobileVersionsDropdown.label": { - "message": "Versions", + "message": "Версии", "description": "The label for the navbar versions dropdown on mobile view" }, "theme.tags.tagsListLabel": { - "message": "Tags:", + "message": "Теги:", "description": "The label alongside a tag list" }, "theme.AnnouncementBar.closeButtonAriaLabel": { - "message": "Close", + "message": "Закрыть", "description": "The ARIA label for close button of announcement bar" }, "theme.blog.sidebar.navAriaLabel": { - "message": "Blog recent posts navigation", + "message": "Навигация по последним постам в блоге", "description": "The ARIA label for recent posts in the blog sidebar" }, "theme.CodeBlock.copied": { - "message": "Copied", + "message": "Скопировано", "description": "The copied button label on code blocks" }, "theme.CodeBlock.copyButtonAriaLabel": { - "message": "Copy code to clipboard", + "message": "Скопировать в буфер обмена", "description": "The ARIA label for copy code blocks button" }, "theme.CodeBlock.copy": { - "message": "Copy", + "message": "Скопировать", "description": "The copy button label on code blocks" }, "theme.CodeBlock.wordWrapToggle": { - "message": "Toggle word wrap", + "message": "Переключить перенос по строкам", "description": "The title attribute for toggle word wrapping button of code block lines" }, "theme.DocSidebarItem.toggleCollapsedCategoryAriaLabel": { - "message": "Toggle the collapsible sidebar category '{label}'", + "message": "Свернуть/развернуть категорию '{label}'", "description": "The ARIA label to toggle the collapsible sidebar category" }, "theme.navbar.mobileLanguageDropdown.label": { - "message": "Languages", + "message": "Языки", "description": "The label for the mobile language switcher dropdown" }, "theme.TOCCollapsible.toggleButtonLabel": { - "message": "On this page", + "message": "Содержание этой страницы", "description": "The label used by the button on the collapsible TOC component" }, "theme.blog.post.readMore": { - "message": "Read More", + "message": "Читать дальше", "description": "The label used in blog post item excerpts to link to full blog posts" }, "theme.blog.post.readMoreLabel": { - "message": "Read more about {title}", + "message": "Подробнее о {title}", "description": "The ARIA label for the link to full blog posts from excerpts" }, "theme.blog.post.readingTime.plurals": { - "message": "One min read|{readingTime} min read", + "message": "{readingTime} мин. чтения", "description": "Pluralized label for \"{readingTime} min read\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" }, "theme.docs.sidebar.collapseButtonTitle": { - "message": "Collapse sidebar", + "message": "Свернуть сайдбар", "description": "The title attribute for collapse button of doc sidebar" }, "theme.docs.sidebar.collapseButtonAriaLabel": { - "message": "Collapse sidebar", + "message": "Свернуть сайдбар", "description": "The title attribute for collapse button of doc sidebar" }, "theme.docs.sidebar.closeSidebarButtonAriaLabel": { - "message": "Close navigation bar", + "message": "Закрыть панель навигации", "description": "The ARIA label for close button of mobile sidebar" }, "theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": { - "message": "← Back to main menu", + "message": "← Перейти к главному меню", "description": "The label of the back button to return to main menu, inside the mobile navbar sidebar secondary menu (notably used to display the docs sidebar)" }, "theme.docs.sidebar.toggleSidebarButtonAriaLabel": { - "message": "Toggle navigation bar", + "message": "Переключить навигационную панель", "description": "The ARIA label for hamburger menu button of mobile navigation" }, "theme.docs.sidebar.expandButtonTitle": { - "message": "Expand sidebar", + "message": "Развернуть сайдбар", "description": "The ARIA label and title attribute for expand button of doc sidebar" }, "theme.docs.sidebar.expandButtonAriaLabel": { - "message": "Expand sidebar", + "message": "Развернуть сайдбар", "description": "The ARIA label and title attribute for expand button of doc sidebar" }, "theme.SearchBar.seeAll": { - "message": "See all {count} results" + "message": "Посмотреть все результаты ({count})" }, "theme.SearchPage.documentsFound.plurals": { - "message": "One document found|{count} documents found", + "message": "{count} документ|{count} документа|{count} документов", "description": "Pluralized label for \"{count} documents found\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" }, "theme.SearchPage.existingResultsTitle": { - "message": "Search results for \"{query}\"", + "message": "Результаты поиска по запросу \"{query}\"", "description": "The search page title for non-empty query" }, "theme.SearchPage.emptyResultsTitle": { - "message": "Search the documentation", + "message": "Поиск по сайту", "description": "The search page title for empty query" }, "theme.SearchPage.inputPlaceholder": { - "message": "Type your search here", + "message": "Введите фразу для поиска", "description": "The placeholder for search page input" }, "theme.SearchPage.inputLabel": { - "message": "Search", + "message": "Поиск", "description": "The ARIA label for search page input" }, "theme.SearchPage.algoliaLabel": { - "message": "Search by Algolia", + "message": "Поиск от Algolia", "description": "The ARIA label for Algolia mention" }, "theme.SearchPage.noResultsText": { - "message": "No results were found", + "message": "По запросу ничего не найдено", "description": "The paragraph for empty search result" }, "theme.SearchPage.fetchingNewResults": { - "message": "Fetching new results...", + "message": "Загрузка новых результатов поиска...", "description": "The paragraph for fetching new search results" }, "theme.SearchBar.label": { - "message": "Search", + "message": "Поиск", "description": "The ARIA label and placeholder for search button" }, "theme.SearchModal.searchBox.resetButtonTitle": { - "message": "Clear the query", + "message": "Очистить", "description": "The label and ARIA label for search box reset button" }, "theme.SearchModal.searchBox.cancelButtonText": { - "message": "Cancel", + "message": "Отменить", "description": "The label and ARIA label for search box cancel button" }, "theme.SearchModal.startScreen.recentSearchesTitle": { - "message": "Recent", + "message": "Недавнее", "description": "The title for recent searches" }, "theme.SearchModal.startScreen.noRecentSearchesText": { - "message": "No recent searches", + "message": "Нет истории поиска", "description": "The text when no recent searches" }, "theme.SearchModal.startScreen.saveRecentSearchButtonTitle": { - "message": "Save this search", + "message": "Сохранить поисковый запрос", "description": "The label for save recent search button" }, "theme.SearchModal.startScreen.removeRecentSearchButtonTitle": { - "message": "Remove this search from history", + "message": "Удалить запись из историю", "description": "The label for remove recent search button" }, "theme.SearchModal.startScreen.favoriteSearchesTitle": { - "message": "Favorite", + "message": "Избранное", "description": "The title for favorite searches" }, "theme.SearchModal.startScreen.removeFavoriteSearchButtonTitle": { - "message": "Remove this search from favorites", + "message": "Удалить запись из избранное", "description": "The label for remove favorite search button" }, "theme.SearchModal.errorScreen.titleText": { - "message": "Unable to fetch results", + "message": "Невозможно загрузить результаты поиска", "description": "The title for error screen of search modal" }, "theme.SearchModal.errorScreen.helpText": { - "message": "You might want to check your network connection.", + "message": "Проверьте подключение к интернету.", "description": "The help text for error screen of search modal" }, "theme.SearchModal.footer.selectText": { - "message": "to select", + "message": "выбрать", "description": "The explanatory text of the action for the enter key" }, "theme.SearchModal.footer.selectKeyAriaLabel": { - "message": "Enter key", + "message": "Клавиша Enter", "description": "The ARIA label for the Enter key button that makes the selection" }, "theme.SearchModal.footer.navigateText": { - "message": "to navigate", + "message": "навигация", "description": "The explanatory text of the action for the Arrow up and Arrow down key" }, "theme.SearchModal.footer.navigateUpKeyAriaLabel": { - "message": "Arrow up", + "message": "Клавиша стрелка вверх", "description": "The ARIA label for the Arrow up key button that makes the navigation" }, "theme.SearchModal.footer.navigateDownKeyAriaLabel": { - "message": "Arrow down", + "message": "Клавиша стрелка вниз", "description": "The ARIA label for the Arrow down key button that makes the navigation" }, "theme.SearchModal.footer.closeText": { - "message": "to close", + "message": "закрыть", "description": "The explanatory text of the action for Escape key" }, "theme.SearchModal.footer.closeKeyAriaLabel": { - "message": "Escape key", + "message": "Клавиша Escape", "description": "The ARIA label for the Escape key button that close the modal" }, "theme.SearchModal.footer.searchByText": { - "message": "Search by", + "message": "Поиск от", "description": "The text explain that the search is making by Algolia" }, "theme.SearchModal.noResultsScreen.noResultsText": { - "message": "No results for", + "message": "Нет результатов по запросу", "description": "The text explains that there are no results for the following search" }, "theme.SearchModal.noResultsScreen.suggestedQueryText": { - "message": "Try searching for", + "message": "Попробуйте", "description": "The text for the suggested query when no results are found for the following search" }, "theme.SearchModal.noResultsScreen.reportMissingResultsText": { - "message": "Believe this query should return results?", + "message": "Нет подходящего результата поиска?", "description": "The text for the question where the user thinks there are missing results" }, "theme.SearchModal.noResultsScreen.reportMissingResultsLinkText": { - "message": "Let us know.", + "message": "Сообщите нам.", "description": "The text for the link to report missing results" }, "theme.SearchModal.placeholder": { - "message": "Search docs", + "message": "Поиск", "description": "The placeholder of the input of the DocSearch pop-up modal" }, "theme.common.skipToMainContent": { - "message": "Skip to main content", + "message": "Перейти к основному содержимому", "description": "The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation" }, "theme.tags.tagsPageTitle": { - "message": "Tags", + "message": "Теги", "description": "The title of the tag list page" } } diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/api_reference.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/api_reference.md index 5ea4d37d..76eeae3e 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/api_reference.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/api_reference.md @@ -5,7 +5,7 @@ toc_min_heading_level: 2 toc_max_heading_level: 5 --- -# API Reference +# Справочник API ## CLI @@ -21,34 +21,34 @@ If `--` is given, all remaning arguments will be assigned to a special `CLI_ARGS ::: -| Short | Flag | Type | Default | Description | -| ----- | --------------------------- | -------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-c` | `--color` | `bool` | `true` | Colored output. Enabled by default. Set flag to `false` or use `NO_COLOR=1` to disable. | -| `-C` | `--concurrency` | `int` | `0` | Limit number tasks to run concurrently. Zero means unlimited. | -| `-d` | `--dir` | `string` | Working directory | Sets directory of execution. | -| `-n` | `--dry` | `bool` | `false` | Compiles and prints tasks in the order that they would be run, without executing them. | -| `-x` | `--exit-code` | `bool` | `false` | Pass-through the exit code of the task command. | -| `-f` | `--force` | `bool` | `false` | Forces execution even when the task is up-to-date. | -| `-g` | `--global` | `bool` | `false` | Runs global Taskfile, from `$HOME/Taskfile.{yml,yaml}`. | -| `-h` | `--help` | `bool` | `false` | Shows Task usage. | -| `-i` | `--init` | `bool` | `false` | Creates a new Taskfile.yml in the current folder. | -| `-I` | `--interval` | `string` | `5s` | Sets a different watch interval when using `--watch`, the default being 5 seconds. This string should be a valid [Go Duration](https://pkg.go.dev/time#ParseDuration). | -| `-l` | `--list` | `bool` | `false` | Lists tasks with description of current Taskfile. | -| `-a` | `--list-all` | `bool` | `false` | Lists tasks with or without a description. | -| | `--sort` | `string` | `default` | Changes the order of the tasks when listed. | -| | `--json` | `bool` | `false` | See [JSON Output](#json-output) | -| `-o` | `--output` | `string` | Default set in the Taskfile or `intervealed` | Sets output style: [`interleaved`/`group`/`prefixed`]. | -| | `--output-group-begin` | `string` | | Message template to print before a task's grouped output. | -| | `--output-group-end` | `string` | | Message template to print after a task's grouped output. | -| | `--output-group-error-only` | `bool` | `false` | Swallow command output on zero exit code. | -| `-p` | `--parallel` | `bool` | `false` | Executes tasks provided on command line in parallel. | -| `-s` | `--silent` | `bool` | `false` | Disables echoing. | -| | `--status` | `bool` | `false` | Exits with non-zero exit code if any of the given tasks is not up-to-date. | -| | `--summary` | `bool` | `false` | Show summary about a task. | -| `-t` | `--taskfile` | `string` | `Taskfile.yml` or `Taskfile.yaml` | | -| `-v` | `--verbose` | `bool` | `false` | Enables verbose mode. | -| | `--version` | `bool` | `false` | Show Task version. | -| `-w` | `--watch` | `bool` | `false` | Enables watch of the given task. | +| Сокращение | Флаг | Тип | По умолчанию | Описание | +| ---------- | --------------------------- | -------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `-c` | `--color` | `bool` | `true` | Colored output. Enabled by default. Set flag to `false` or use `NO_COLOR=1` to disable. | +| `-C` | `--concurrency` | `int` | `0` | Limit number tasks to run concurrently. Zero means unlimited. | +| `-d` | `--dir` | `string` | Working directory | Sets directory of execution. | +| `-n` | `--dry` | `bool` | `false` | Compiles and prints tasks in the order that they would be run, without executing them. | +| `-x` | `--exit-code` | `bool` | `false` | Pass-through the exit code of the task command. | +| `-f` | `--force` | `bool` | `false` | Forces execution even when the task is up-to-date. | +| `-g` | `--global` | `bool` | `false` | Runs global Taskfile, from `$HOME/Taskfile.{yml,yaml}`. | +| `-h` | `--help` | `bool` | `false` | Shows Task usage. | +| `-i` | `--init` | `bool` | `false` | Creates a new Taskfile.yml in the current folder. | +| `-I` | `--interval` | `string` | `5s` | Sets a different watch interval when using `--watch`, the default being 5 seconds. This string should be a valid [Go Duration](https://pkg.go.dev/time#ParseDuration). | +| `-l` | `--list` | `bool` | `false` | Lists tasks with description of current Taskfile. | +| `-a` | `--list-all` | `bool` | `false` | Lists tasks with or without a description. | +| | `--sort` | `string` | `default` | Changes the order of the tasks when listed. | +| | `--json` | `bool` | `false` | See [JSON Output](#json-output) | +| `-o` | `--output` | `string` | Default set in the Taskfile or `intervealed` | Sets output style: [`interleaved`/`group`/`prefixed`]. | +| | `--output-group-begin` | `string` | | Message template to print before a task's grouped output. | +| | `--output-group-end` | `string` | | Message template to print after a task's grouped output. | +| | `--output-group-error-only` | `bool` | `false` | Swallow command output on zero exit code. | +| `-p` | `--parallel` | `bool` | `false` | Executes tasks provided on command line in parallel. | +| `-s` | `--silent` | `bool` | `false` | Disables echoing. | +| | `--status` | `bool` | `false` | Exits with non-zero exit code if any of the given tasks is not up-to-date. | +| | `--summary` | `bool` | `false` | Show summary about a task. | +| `-t` | `--taskfile` | `string` | `Taskfile.yml` or `Taskfile.yaml` | | +| `-v` | `--verbose` | `bool` | `false` | Enables verbose mode. | +| | `--version` | `bool` | `false` | Show Task version. | +| `-w` | `--watch` | `bool` | `false` | Enables watch of the given task. | ## Exit Codes @@ -60,7 +60,7 @@ Task will sometimes exit with specific exit codes. These codes are split into th A full list of the exit codes and their descriptions can be found below: -| Code | Description | +| Code | Описание | | ---- | ------------------------------------------------------------ | | 0 | Success | | 1 | An unknown error occurred | @@ -103,11 +103,11 @@ When using the `--json` flag in combination with either the `--list` or `--list- } ``` -## Special Variables +## Специальные переменные There are some special variables that is available on the templating system: -| Var | Description | +| Переменные | Описание | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CLI_ARGS` | Contain all extra arguments passed after `--` when calling Task through the CLI. | | `TASK` | The name of the current task. | @@ -136,7 +136,7 @@ Some environment variables can be overriden to adjust Task behavior. ## Taskfile Schema -| Attribute | Type | Default | Description | +| Атрибут | Тип | По умолчанию | Описание | | ---------- | ---------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `version` | `string` | | Version of the Taskfile. The current version is `3`. | | `output` | `string` | `interleaved` | Output mode. Available options: `interleaved`, `group` and `prefixed`. | @@ -154,7 +154,7 @@ Some environment variables can be overriden to adjust Task behavior. ### Include -| Attribute | Type | Default | Description | +| Атрибут | Тип | По умолчанию | Описание | | ---------- | --------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `taskfile` | `string` | | The path for the Taskfile or directory to be included. If a directory, Task will look for files named `Taskfile.yml` or `Taskfile.yaml` inside that directory. If a relative path, resolved relative to the directory containing the including Taskfile. | | `dir` | `string` | The parent Taskfile directory | The working directory of the included tasks when run. | @@ -176,10 +176,10 @@ includes: ### Variable -| Attribute | Type | Default | Description | -| --------- | -------- | ------- | ------------------------------------------------------------------------ | -| _itself_ | `string` | | A static value that will be set to the variable. | -| `sh` | `string` | | A shell command. The output (`STDOUT`) will be assigned to the variable. | +| Атрибут | Тип | По умолчанию | Описание | +| -------- | -------- | ------------ | ------------------------------------------------------------------------ | +| _itself_ | `string` | | A static value that will be set to the variable. | +| `sh` | `string` | | A shell command. The output (`STDOUT`) will be assigned to the variable. | :::info @@ -196,7 +196,7 @@ vars: ### Task -| Attribute | Type | Default | Description | +| Атрибут | Тип | По умолчанию | Описание | | --------------- | ---------------------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `cmds` | [`[]Command`](#command) | | A list of shell commands to be executed. | | `deps` | [`[]Dependency`](#dependency) | | A list of dependencies of this task. Tasks defined here will run in parallel before this task. | @@ -243,7 +243,7 @@ tasks: #### Command -| Attribute | Type | Default | Description | +| Атрибут | Тип | По умолчанию | Описание | | -------------- | ---------------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `cmd` | `string` | | The shell command to be executed. | | `silent` | `bool` | `false` | Skips some output for this command. Note that STDOUT and STDERR of the commands will still be redirected. | @@ -271,10 +271,10 @@ tasks: #### Dependency -| Attribute | Type | Default | Description | -| --------- | ---------------------------------- | ------- | -------------------------------------------------------- | -| `task` | `string` | | The task to be execute as a dependency. | -| `vars` | [`map[string]Variable`](#variable) | | Optional additional variables to be passed to this task. | +| Атрибут | Тип | По умолчанию | Описание | +| ------- | ---------------------------------- | ------------ | -------------------------------------------------------- | +| `task` | `string` | | The task to be execute as a dependency. | +| `vars` | [`map[string]Variable`](#variable) | | Optional additional variables to be passed to this task. | :::tip @@ -290,10 +290,10 @@ tasks: #### Precondition -| Attribute | Type | Default | Description | -| --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------ | -| `sh` | `string` | | Command to be executed. If a non-zero exit code is returned, the task errors without executing its commands. | -| `msg` | `string` | | Optional message to print if the precondition isn't met. | +| Атрибут | Тип | По умолчанию | Description | +| ------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------ | +| `sh` | `string` | | Command to be executed. If a non-zero exit code is returned, the task errors without executing its commands. | +| `msg` | `string` | | Optional message to print if the precondition isn't met. | :::tip 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 5153a123..f892cc0b 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 @@ -3,11 +3,11 @@ slug: /community/ sidebar_position: 9 --- -# Community +# Сообщество Some of the work to improve the Task ecosystem is done by the community, be it installation methods or integrations with code editor. I (the author) am thankful for everyone that helps me to improve the overall experience. -## Translations +## Переводчики [@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). 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 22a1441b..96fae2d3 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 @@ -3,79 +3,79 @@ slug: /contributing/ sidebar_position: 10 --- -# Contributing +# Помощь проекту -Contributions to Task are very welcome, but we ask that you read this document before submitting a PR. +Любой вклад в Task очень приветствуется, но мы просим вас прочитать этот документ, прежде чем отправлять pull request(PR). :::note -This document applies to the core [Task][task] repository _and_ [Task for Visual Studio Code][vscode-task]. +Этот документ относится к основному репозиторию [Task][task] _и_ [ Task for Visual Studio Code][vscode-task] ::: -## Before you start +## Введение -- **Check existing work** - Is there an existing PR? Are there issues discussing the feature/change you want to make? Please make sure you consider/address these discussions in your work. -- **Backwards compatibility** - Will your change break existing Taskfiles? It is much more likely that your change will merged if it backwards compatible. Is there an approach you can take that maintains this compatibility? If not, consider opening an issue first so that API changes can be discussed before you invest your time into a PR. +- **Текущее состояние разработки** - Проверьте уже открытые PR. Есть ли открытые "issues", обсуждающие особенности/изменения, которые вы хотите выполнить? Пожалуйста, убедитесь, что вы учитываете результаты этих обсуждений в своей работе. +- **Обратная совместимость** - Повлияют ли ваши изменения на уже существующие TaskFile'ы? Скорее всего, ваше изменение будет применено, если оно обладает обратной совместимостью. Существует ли подход, который вы можете использовать для поддержания обратной совместимости? Если нет, откройте проблему(Вот тут ["Issues"](https://github.com/go-task/task/issues)), чтобы изменения API могли быть обсуждены до того, как вы потратите своё время на PR. -## 1. Setup +## 1. Настройка -- **Go** - Task is written in [Go][go]. We always support the latest two major Go versions, so make sure your version is recent enough. -- **Node.js** - [Node.js][nodejs] is used to host Task's documentation server and is required if you want to run this server locally. It is also required if you want to contribute to the Visual Studio Code extension. -- **Yarn** - [Yarn][yarn] is the Node.js package manager used by Task. +- **Go** - Task написан на [Go][go]. Мы всегда поддерживаем две последних основных версий Go, поэтому убедитесь, что у вас установлена актуальная версия. +- **Node.js** - [Node.js][nodejs] используется для хостинга сервера документации Task и требуется для локального запуска этого сервера. Node.js также необходим для того, чтобы внести свой вклад в расширение Visual Studio Code. +- **Yarn** - [Yarn][yarn] является менеджером пакетов Node.js, используемым в Task. -## 2. Making changes +## 2. Внести изменения -- **Code style** - Try to maintain the existing code style where possible. Go code should be formatted by [`gofumpt`][gofumpt] and linted using [`golangci-lint`][golangci-lint]. Any Markdown or TypeScript files should be formatted and linted by [Prettier][prettier]. This style is enforced by our CI to ensure that we have a consistent style across the project. You can use the `task lint` command to lint the code locally and the `task lint:fix` command to automatically fix any issues that are found. -- **Documentation** - Ensure that you add/update any relevant documentation. See the [updating documentation](#updating-documentation) section below. -- **Tests** - Ensure that you add/update any relevant tests and that all tests are passing before submitting the PR. See the [writing tests](#writing-tests) section below. +- **Code style** - Настоятельно рекомендуем поддерживать существующий стиль кода по мере возможности. Код должен быть отформатирован [`gofumpt`][gofumpt] и проверен [`golangci-lint`][golangci-lint] линтером. Любые файлы Markdown или TypeScript должны быть отформатированы с помощью [Prettier][prettier]. Стиль кода внедряется нашим CI для обеспечения того, чтобы у всех был одинаковый стиль кода в рамках проекта. Вы можете использовать команду `task lint` для локальной проверки линтером и `task lint:fix` для автоматического исправления любых обнаруженных проблем. +- **Документация** - Убедитесь, что вы добавляете/обновляете любую соответствующую документацию. Секцию [обновления документации](#updating-documentation) можно увидеть ниже. +- **Тесты** - Убедитесь, что вы добавляете/обновляете любые релевантные тесты и что все тесты проходят перед отправкой PR. Секцию [написание тестов](#writing-tests) можно увидеть ниже. -### Running your changes +### Запуск ваших изменений -To run Task with working changes, you can use `go run ./cmd/task`. To run a development build of task against a test Taskfile in `testdata`, you can use `go run ./cmd/task --dir ./testdata/ `. +Чтобы запустить Task с рабочими изменениями, используйте `go run ./cmd/task`. Для запуска тестовой сборки задачи с Taskfile в `testdata`, вы можете использовать `go run ./cmd/task --dir ./testdata/ `. -To run Task for Visual Studio Code, you can open the project in VSCode and hit F5 (or whatever you debug keybind is set to). This will open a new VSCode window with the extension running. Debugging this way is recommended as it will allow you to set breakpoints and step through the code. Otherwise, you can run `task package` which will generate a `.vsix` file that can be used to manually install the extension. +Для запуска Task для Visual Studio кода, вы можете открыть проект в VSCode и нажать F5 (или любую другую клавишу, к которой вы привязали функцию отладки). Это откроет новое окно VSCode с запущенным расширением. Мы рекомендуем использовать функцию отладки, так как это позволит вам задать точки останова. Также вы можете запустить пакет задач `task package` для генерации `.vsix` файла, который может быть использован для ручной установки расширения. -### Updating documentation +### Обновление документации -Task uses [Docusaurus][docusaurus] to host a documentation server. The code for this is located in the core Task repository. This can be setup and run locally by using `task docs` (requires `nodejs` & `yarn`). All content is written in Markdown and is located in the `docs/docs` directory. All Markdown documents should have an 80 character line wrap limit (enforced by Prettier). +Task использует [Docusaurus][docusaurus] для размещения сервера документации. Код для неё находится в основном Task репозитории. Документация может быть настроена и запущена локально с помощью `task docs` (требуется установка `nodejs` & `yarn`). Все содержимое написано в Markdown и находится в директории `docs/docs`. Все документы Markdown должны иметь максимальную длину строки 80 символов (этого требует Prettier). -When making a change, consider whether a change to the [Usage Guide](./usage.md) is necessary. This document contains descriptions and examples of how to use Task features. If you're adding a new feature, try to find an appropriate place to add a new section. If you're updating an existing feature, ensure that the documentation and any examples are up-to-date. Ensure that any examples follow the [Taskfile Styleguide](./styleguide.md). +При внесении изменений подумайте, является ли необходимым изменение [Руководства по использованию](./usage.md). Этот документ содержит описания и примеры использования Task функций. Если вы добавляете новую функцию, попробуйте найти подходящее место для добавления новой секции. Если вы обновляете существующую функцию, убедитесь, что документация и любые примеры актуальны. Убедитесь, что любые примеры следуют [Taskfile Styleguide](./styleguide.md). -If you added a new field, command or flag, ensure that you add it to the [API Reference](./api_reference.md). New fields also need to be added to the [JSON Schema][json-schema]. The descriptions for fields in the API reference and the schema should match. +Если вы добавили новое поле, команду или флаг, убедитесь, что вы добавляете его в [Справочник API](./api_reference.md). Новые поля также необходимо добавить в [JSON][json-schema] схему. Описания полей в справочнике API и JSON схеме должны совпадать. -### Writing tests +### Написание тестов -A lot of Task's tests are held in the `task_test.go` file in the project root and this is where you'll most likely want to add new ones too. Most of these tests also have a subdirectory in the `testdata` directory where any Taskfiles/data required to run the tests are stored. +Тесты расположены в файле `task_test.go` в корневом каталоге, рекомендуем добавлять новые тесты именно в него. Большинство этих тестов также имеют поддиректорию в `testdata`, где хранятся любые Taskfiles/данные, необходимые для запуска тестов. -When making a changes, consider whether new tests are required. These tests should ensure that the functionality you are adding will continue to work in the future. Existing tests may also need updating if you have changed Task's behavior. +При внесении изменений подумайте о необходимости новых тестов. Эти тесты должны гарантировать, что функционал, который вы добавили, продолжит работу в будущем. Существующие тесты также могут потребовать обновления, если вы изменили поведение Task. -You may also consider adding unit tests for any new functions you have added. The unit tests should follow the Go convention of being location in a file named `*_test.go` in the same package as the code being tested. +Вы также можете добавить модульный тест для любых новых функций, которые добавляете. Модульные тесты должны следовать Go соглашению о местоположении в файле `*_test.o` в том же пакете, что и тестируемый код. -## 3. Committing your code +## 3. Внесение кода -Try to write meaningful commit messages and avoid having too many commits on the PR. Most PRs should likely have a single commit (although for bigger PRs it may be reasonable to split it in a few). Git squash and rebase is your friend! +Попробуйте написать содержательное сообщение к коммиту и не иметь слишком много коммитов в PR. Большинство PR, желательно, должны иметь один коммит (хотя для больших PR может быть разумным разделить его несколько коммитов). Используйте git squash и rebase! -If you're not sure how to format your commit message, check out [Conventional Commits][conventional-commits]. This style is not enforced, but it is a good way to make your commit messages more readable and consistent. +Если вы не уверены, как отформатировать ваше сообщение, проверьте [Соглашение о коммитах][conventional-commits]. Этот стиль не используется в проекте, но это хороший способ сделать ваше сообщение для коммита более читаемым и последовательным. -## 4. Submitting a PR +## 4. Отправка PR -- **Describe your changes** - Ensure that you provide a comprehensive description of your changes. -- **Issue/PR links** - Link any previous work such as related issues or PRs. Please describe how your changes differ to/extend this work. -- **Examples** - Add any examples or screenshots that you think are useful to demonstrate the effect of your changes. -- **Draft PRs** - If your changes are incomplete, but you would like to discuss them, open the PR as a draft and add a comment to start a discussion. Using comments rather than the PR description allows the description to be updated later while preserving any discussions. +- **Опишите ваши изменения** - Убедитесь, что вы предоставили подробное описание ваших изменений. +- **Issue/PR ссылки** - Укажите ссылки на предыдущую работу, которая связанна с вашим PR. Пожалуйста, опишите, как ваши изменения изменяют или расширяют эту работу. +- **Примеры** - Добавьте любые примеры или скриншоты, которые демонстрируют ваши изменения. +- **Черновик PRs** - Если ваши изменения не закончены, но вы хотели бы обсудить их, открыть PR как черновик и добавьте комментарии, чтобы начать обсуждение. Использование комментариев, а не PR описания позволяет обновить описание позже при сохранении любых обсуждений. -## FAQ +## Ответы на вопросы -> I want to contribute, where do I start? +> Я хочу внести свой вклад, с чего начать? -Take a look at the list of [open issues for Task][task-open-issues] or [Task for Visual Studio Code][vscode-task-open-issues]. We have a [good first issue][good-first-issue] label for simpler issues that are ideal for first time contributions. +Ознакомьтесь со списком [open issues for Task][task-open-issues] или [Task for Visual Studio Code][vscode-task-open-issues]. У нас есть лейбл [good first issue][good-first-issue] для простейших проблем, который идеально подходит для контрибьюторов, который первых вносят свой вклад. -All kinds of contributions are welcome, whether its a typo fix or a shiny new feature. You can also contribute by upvoting/commenting on issues, helping to answer questions or contributing to other [community projects](./community.md). +Приветствуются всевозможные вклады, будь то маленький фикс или новая функция. Вы также можете внести свой вклад, комментируя вопросы, помогая ответить на вопросы или внести вклад в другие [проекты сообщества](./community.md). -> I'm stuck, where can I get help? +> Где можно получить помощь? -If you have questions, feel free to ask them in the `#help` forum channel on our [Discord server][discord-server] or open a [Discussion][discussion] on GitHub. +Если у вас есть вопросы, не стесняйтесь спросить их в канале `#help` на нашем [Discord сервере][discord-server] или откройте [Discussion][discussion] на GitHub. --- 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 6b520d7f..baae1225 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 @@ -3,40 +3,40 @@ slug: /donate/ sidebar_position: 13 --- -# Donate +# Поддержать -If you find this project useful, you can consider donating by using one of the channels listed below. +Если вам нравится этот проект, вы можете подумать о том, чтобы пожертвовать, используя один из способов, перечисленных ниже. -This is just a way of saying "thank you", it won't give you any benefits like higher priority on issues or something similar. +Это просто способ сказать "спасибо", это не дает вам никаких преимуществ, таких как высший приоритет при рассмотрении проблем или что-то подобное. -Companies who donate at least $50/month will be featured as a "Gold Sponsor" in the website homepage and on the GitHub repository README. Make contact with [@andreynering][] with the logo you want to be shown. Suspect businesses (gambling, casinos, etc) won't be allowed, though. +Компании, которые пожертвуют не менее $50 в месяц, будут представлены как "Золотые спонсоры" на главной странице сайта и в README репозитория на GitHub. Свяжитесь с [@andreynering][] и предоставьте ему нужный логотип. Подозрительные бизнесы (связанные с азартными играми, казино и т.д.) не будут допущены к спонсорству. ## GitHub Sponsors -The preferred way to donate to the maintainers is via GitHub Sponsors. Just use the following links to do your donation: +Предпочтительный способ пожертвования для сопровождающих — через GitHub Sponsors. Просто используйте следующие ссылки, чтобы сделать пожертвование: - [@andreynering](https://github.com/sponsors/andreynering) - [@pd93](https://github.com/sponsors/pd93) ## Open Collective -If you prefer [Open Collective](https://opencollective.com/task) you can donate by using these links: +Если вы предпочитаете [Open Collective](https://opencollective.com/task), вы можете пожертвовать используя следующие ссылки: -- [$2 per month](https://opencollective.com/task/contribute/backer-4034/checkout) -- [$5 per month](https://opencollective.com/task/contribute/supporter-8404/checkout) -- [$20 per month](https://opencollective.com/task/contribute/sponsor-4035/checkout) -- [$50 per month](https://opencollective.com/task/contribute/sponsor-28775/checkout) -- [Custom value - One-time donation option supported](https://opencollective.com/task/donate) +- [$2 в месяц](https://opencollective.com/task/contribute/backer-4034/checkout) +- [$5 в месяц](https://opencollective.com/task/contribute/supporter-8404/checkout) +- [$20 в месяц](https://opencollective.com/task/contribute/sponsor-4035/checkout) +- [$50 в месяц](https://opencollective.com/task/contribute/sponsor-28775/checkout) +- [Любая сумма - Разовое пожертвование](https://opencollective.com/task/donate) ## PayPal -You can donate to [@andreynering][] via PayPal as well: +Вы можете сделать пожертвование [@andreynering][] через PayPal: -- [Any value - One-time donation](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=GSVDU63RKG45A¤cy_code=USD&source=url) +- [Любая сумма - Разовое пожертвование](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=GSVDU63RKG45A¤cy_code=USD&source=url) -## PIX (Brazil only) +## PIX (только для Бразилии) -And if you're Brazilian, you can also donate to [@andreynering][] via PIX by [using this QR Code](/img/pix.png). +Если вы из Бразилии, вы можете также пожертвовать [@andreynering][] через PIX [с помощью этого QR-кода](/img/pix.png). diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/installation.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/installation.md index 5e7e85ae..82237c7a 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/installation.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/installation.md @@ -3,23 +3,23 @@ slug: /installation/ sidebar_position: 2 --- -# Installation +# Установка -Task offers many installation methods. Check out the available methods below. +Task имеет множество способов установки. Просмотрите доступные методы ниже. -## Package Managers +## Менеджеры пакетов ### Homebrew -If you're on macOS or Linux and have [Homebrew][homebrew] installed, getting Task is as simple as running: +Если вы используете macOS или Linux и установили [Homebrew][homebrew], то для установки достаточно выполнить: ```bash brew install go-task/tap/go-task ``` -The above Formula is [maintained by ourselves](https://github.com/go-task/homebrew-tap/blob/master/Formula/go-task.rb). +Данная Formula [поддерживается нами](https://github.com/go-task/homebrew-tap/blob/master/Formula/go-task.rb). -Recently, Task was also made available [on the official Homebrew repository](https://formulae.brew.sh/formula/go-task), so you also have that option if you prefer: +Недавно Task стал доступен [в официальном репозитории Homebrew](https://formulae.brew.sh/formula/go-task), поэтому вы можете использовать: ```bash brew install go-task @@ -27,7 +27,7 @@ brew install go-task ### Snap -Task is available in [Snapcraft][snapcraft], but keep in mind that your Linux distribution should allow classic confinement for Snaps to Task work right: +Task доступен в [Snapcraft][snapcraft], но имейте в виду, что ваш Linux дистрибутив должен иметь классическое ограничение для Snaps, чтобы Task работал правильно: ```bash sudo snap install task --classic @@ -35,63 +35,63 @@ sudo snap install task --classic ### Chocolatey -If you're on Windows and have [Chocolatey][choco] installed, getting Task is as simple as running: +Если вы используете Windows и у вас установлен [Chocolatey][choco], установка Task сводится к запуску: ```bash choco install go-task ``` -This installation method is community owned. +Этот метод установки находится под управлением сообщества. ### Scoop -If you're on Windows and have [Scoop][scoop] installed, getting Task is as simple as running: +Если вы используете Windows и у вас установлен [Scoop][scoop], установка Task сводится к запуску: ```cmd scoop install task ``` -This installation method is community owned. After a new release of Task, it may take some time until it's available on Scoop. +Этот метод установки находится под управлением сообщества. После нового релиза Task может потребоваться некоторое время, пока он станет доступен в Scoop. ### AUR -If you're on Arch Linux you can install Task from [AUR](https://aur.archlinux.org/packages/go-task-bin) using your favorite package manager such as `yay`, `pacaur` or `yaourt`: +Если вы используете Arch Linux, вы можете установить Task из [AUR](https://aur.archlinux.org/packages/go-task-bin) с помощью вашего любимого менеджера пакетов, такого как `yay`, `pacaur` или `yaourt`: ```cmd yay -S go-task-bin ``` -Alternatively, there's [this package](https://aur.archlinux.org/packages/go-task) which installs from the source code instead of downloading the binary from the [releases page](https://github.com/go-task/task/releases): +В качестве альтернативы, можно использовать [пакет](https://aur.archlinux.org/packages/go-task), который устанавливается из исходного кода, а не загружает бинарный файл со [страницы релизов](https://github.com/go-task/task/releases): ```cmd yay -S go-task ``` -This installation method is community owned. +Этот метод установки находится под управлением сообщества. ### Fedora -If you're on Fedora Linux you can install Task from the official [Fedora](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/) repository using `dnf`: +Если вы используете Fedora Linux, вы можете установить Task из официального репозитория [Fedora](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/), используя `dnf`: ```cmd sudo dnf install go-task ``` -This installation method is community owned. After a new release of Task, it may take some time until it's available in [Fedora](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/). +Этот метод установки находится под управлением сообщества. После нового релиза Task может потребоваться некоторое время, пока он станет доступен в [Fedora](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/). ### Nix -If you're on NixOS or have Nix installed you can install Task from [nixpkgs](https://github.com/NixOS/nixpkgs): +Если вы используете NixOS или у вас установлен Nix, вы можете установить Task из [nixpkgs](https://github.com/NixOS/nixpkgs): ```cmd nix-env -iA nixpkgs.go-task ``` -This installation method is community owned. After a new release of Task, it may take some time until it's available in [nixpkgs](https://github.com/NixOS/nixpkgs). +Этот метод установки находится под управлением сообщества. После нового релиза Task может потребоваться некоторое время, пока он станет доступен в [nixpkgs](https://github.com/NixOS/nixpkgs). ### npm -You can also use Node and npm to install Task by installing [this package](https://www.npmjs.com/package/@go-task/cli). +Для установки Task вы также можете использовать Node и npm, установив [этот пакет](https://www.npmjs.com/package/@go-task/cli). ```bash npm install -g @go-task/cli @@ -99,33 +99,33 @@ npm install -g @go-task/cli ### Winget -If you are using Windows and installed the [winget](https://github.com/microsoft/winget-cli) package management tool, you can install Task from [winget-pkgs](https://github.com/microsoft/winget-pkgs). +Если вы используете Windows и установили менеджер пакетов [winget](https://github.com/microsoft/winget-cli), вы можете установить Task из [winget-pkgs](https://github.com/microsoft/winget-pkgs). ```bash winget install Task.Task ``` -## Get The Binary +## Установка бинарных файлов -### Binary +### Бинарные -You can download the binary from the [releases page on GitHub][releases] and add to your `$PATH`. +Вы можете установить бинарные файлы со [страницы релизов на GitHub][releases] и добавить их в ваш `$PATH`. -DEB and RPM packages are also available. +Также доступны DEB и RPM пакеты. -The `task_checksums.txt` file contains the SHA-256 checksum for each file. +Файл `task_checksums.txt` содержит контрольные суммы SHA-256 для каждого файла. -### Install Script +### Скрипт для установки -We also have an [install script][installscript] which is very useful in scenarios like CI. Many thanks to [GoDownloader][godownloader] for enabling the easy generation of this script. +У нас также есть [скрипт для установки][installscript], который очень полезен в некоторых случаях, таких как CI. Благодарим [GoDownloader][godownloader] за то, что он облегчает генерацию этого скрипта. -By default, it installs on the `./bin` directory relative to the working directory: +По умолчанию он устанавливается в каталог `./bin` относительно рабочего каталога: ```bash sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d ``` -It is possible to override the installation directory with the `-b` parameter. On Linux, common choices are `~/.local/bin` and `~/bin` to install for the current user or `/usr/local/bin` to install for all users: +Вы можете переопределить каталог установки с помощью параметра `-b`. В Linux распространенными вариантами являются `~/.local/bin` и `~/bin`, чтобы установить для текущего пользователя, или `/usr/local/bin`, чтобы установить для всех пользователей: ```bash sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin @@ -133,13 +133,13 @@ sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin :::caution -On macOS and Windows, `~/.local/bin` and `~/bin` are not added to `$PATH` by default. +В macOS и Windows, `~/.local/bin` и `~/bin` по умолчанию не добавляются в `$PATH`. ::: ### GitHub Actions -If you want to install Task in GitHub Actions you can try using [this action](https://github.com/arduino/setup-task) by the Arduino team: +Если вы хотите установить Task в GitHub Actions, вы можете попробовать использовать [это действие](https://github.com/arduino/setup-task) от команды Arduino: ```yaml - name: Install Task @@ -149,21 +149,21 @@ If you want to install Task in GitHub Actions you can try using [this action](ht repo-token: ${{ secrets.GITHUB_TOKEN }} ``` -This installation method is community owned. +Этот метод установки находится под управлением сообщества. -## Build From Source +## Сборка из исходного кода ### Go Modules -Ensure that you have a supported version of [Go][go] properly installed and setup. You can find the minimum required version of Go in the [go.mod](https://github.com/go-task/task/blob/main/go.mod#L3) file. +Убедитесь, что у вас правильно установлена и настроена поддерживаемая версия [Go][go]. Вы можете найти минимальную требуемую версию Go в [go.mod](https://github.com/go-task/task/blob/main/go.mod#L3) файле. -You can then install the latest release globally by running: +Затем вы можете установить последнюю версию глобально, запустив: ```bash go install github.com/go-task/task/v3/cmd/task@latest ``` -Or you can install into another directory: +Или вы можете установить в другую директорию: ```bash env GOBIN=/bin go install github.com/go-task/task/v3/cmd/task@latest @@ -171,27 +171,27 @@ env GOBIN=/bin go install github.com/go-task/task/v3/cmd/task@latest :::tip -For CI environments we recommend using the [install script](#install-script) instead, which is faster and more stable, since it'll just download the latest released binary. +Для окружения CI мы рекомендуем вместо этого использовать [скрипт установки](#install-script), который быстрее и стабильнее, так как он просто загрузит последний выпущенный бинарный файл. ::: -## Setup completions +## Завершение установки -Download the autocompletion file corresponding to your shell. +Загрузите файл автодополнения, соответствующий вашей оболочке. -[All completions are available on the Task repository](https://github.com/go-task/task/tree/main/completion). +[Все дополнения доступны в репозитории Task](https://github.com/go-task/task/tree/main/completion). ### Bash -First, ensure that you installed bash-completion using your package manager. +Сначала убедитесь, что вы установили bash-completion с помощью вашего менеджера пакетов. -Make the completion file executable: +Сделайте файл автодополнения исполняемым: ``` chmod +x path/to/task.bash ``` -After, add this to your `~/.bash_profile`: +Затем, добавьте это в свой `~/.bash_profile`: ```shell source path/to/task.bash @@ -199,24 +199,24 @@ source path/to/task.bash ### ZSH -Put the `_task` file somewhere in your `$FPATH`: +Поместите файл `_task` куда-нибудь в ваш `$FPATH`: ```shell mv path/to/_task /usr/local/share/zsh/site-functions/_task ``` -Ensure that the following is present in your `~/.zshrc`: +Убедитесь, что в `~/.zshrc` присутствует следующее: ```shell autoload -U compinit compinit -i ``` -ZSH version 5.7 or later is recommended. +Рекомендуется использовать ZSH версии 5.7 или выше. ### Fish -Move the `task.fish` completion script: +Переместите скрипт автодополнения `task.fish`: ```shell mv path/to/task.fish ~/.config/fish/completions/task.fish @@ -224,14 +224,14 @@ mv path/to/task.fish ~/.config/fish/completions/task.fish ### PowerShell -Open your profile script with: +Откройте сценарии вашего профиля с помощью: ``` mkdir -Path (Split-Path -Parent $profile) -ErrorAction SilentlyContinue notepad $profile ``` -Add the line and save the file: +Добавьте строку и сохраните файл: ```shell Invoke-Expression -Command path/to/task.ps1 diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/intro.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/intro.md index 4491233c..0cd9810e 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/intro.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/intro.md @@ -10,11 +10,11 @@ title: Home
-Task is a task runner / build tool that aims to be simpler and easier to use than, for example, [GNU Make][make]. +Task - это инструмент для запуска / сборки, который стремится быть простым и удобным в использовании, чем, например, [GNU Make][make]. -Since it's written in [Go][go], Task is just a single binary and has no other dependencies, which means you don't need to mess with any complicated install setups just to use a build tool. +Так как Task написан на [Go][go], он представляет собой единственный исполняемый файл и не имеет других зависимостей, что означает, что вам не нужно заниматься сложной настройкой установки просто для использования инструмента сборки. -Once [installed](installation.md), you just need to describe your build tasks using a simple [YAML][yaml] schema in a file called `Taskfile.yml`: +После [установки](installation.md) вам просто нужно описать вашу задачу сборки, используя простую схему [YAML][yaml] в файле с именем `Taskfile.yml`: ```yaml title="Taskfile.yml" version: '3' @@ -26,18 +26,18 @@ tasks: silent: true ``` -And call it by running `task hello` from your terminal. +И вызвать ее, запустив `task hello` в вашем терминале. -The above example is just the start, you can take a look at the [usage](/usage) guide to check the full schema documentation and Task features. +Приведенный выше пример - это только начало, вы можете посмотреть на [руководство](/usage) по использованию, чтобы посмотреть полную документацию схемы и функций Task. -## Features +## Особенности -- [Easy installation](installation.md): just download a single binary, add to `$PATH` and you're done! Or you can also install using [Homebrew][homebrew], [Snapcraft][snapcraft], or [Scoop][scoop] if you want. -- Available on CIs: by adding [this simple command](installation.md#install-script) to install on your CI script and you're ready to use Task as part of your CI pipeline; -- Truly cross-platform: while most build tools only work well on Linux or macOS, Task also supports Windows thanks to [this shell interpreter for Go][sh]. -- Great for code generation: you can easily [prevent a task from running](/usage#prevent-unnecessary-work) if a given set of files haven't changed since last run (based either on its timestamp or content). +- [Простая установка](installation.md): просто загрузите единственный исполняемый файл, добавьте его в `$PATH` и вы готовы! Или вы можете установить с помощью [Homebrew][homebrew], [Snapcraft][snapcraft] или [Scoop][scoop], если хотите. +- Доступен на CI-серверах: просто добавьте [эту простую команду](installation.md#install-script) для установки в CI-скрипт и готово! Теперь можно использовать Task в качестве части вашего CI-пайплайна. +- Полностью кроссплатформенный: в то время как большинство инструментов сборки хорошо работают только в Linux или macOS, Task также поддерживает Windows, благодаря [интерпретатору командной оболочки для Go][sh]. +- Отлично подходит для кодогенерации: вы можете легко [предотвратить запуск задачи](/usage#prevent-unnecessary-work), если необходимый набор файлов не изменился с прошлого запуска (основываясь на времени изменения или содержимом). -## Gold Sponsors +## Золотые спонсоры
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 adbf5eb1..bdf66c80 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 @@ -3,13 +3,13 @@ slug: /styleguide/ sidebar_position: 7 --- -# Styleguide +# Стайлгайд -This is the official Task styleguide for `Taskfile.yml` files. This guide contains some basic instructions to keep your Taskfile clean and familiar to other users. +Это официальный стайлгайд Task для `Taskfile.yml` файлов. Это руководство содержит некоторые базовые инструкции для того, чтобы ваш Taskfile был чистым и понятен другим пользователям. -This contains general guidelines, but they don't necessarily need to be strictly followed. Feel free to disagree and proceed differently at some point if you need or want to. Also, feel free to open issues or pull requests with improvements to this guide. +Этот стайлгайд содержит общие рекомендации по написанию кода, но не обязательно требует их строгого соблюдения. Можете не соглашаться с правилами и использовать другой подход, если вам это нужно или хотите это сделать. Кроме того, не стесняйтесь создавать Issue или PR с улучшениями этого гида. -## Use `Taskfile.yml` and not `taskfile.yml` +## Используйте `Taskfile.yml` вместо `taskfile.yml` ```yaml # bad @@ -20,20 +20,20 @@ taskfile.yml Taskfile.yml ``` -This is important especially for Linux users. Windows and macOS have case insensitive filesystems, so `taskfile.yml` will end up working, even that not officially supported. On Linux, only `Taskfile.yml` will work, though. +Это особенно важно для пользователей Linux. У Windows и macOS нечувствительные файловые системы, поэтому `taskfile.yml` в конечном итоге будет работать, даже если официально не поддерживается. В Linux только будет работать `Taskfile.yml`. -## Use the correct order of keywords +## Используйте правильный порядок ключевых слов - `version:` - `includes:` -- Configuration ones, like `output:`, `silent:`, `method:` and `run:` +- Конфигурационные параметры, такие как `output:`, `silent:`, `method:` и `run:` - `vars:` - `env:`, `dotenv:` - `tasks:` -## Use 2 spaces for indentation +## Используйте 2 пробела для отступа -This is the most common convention for YAML files, and Task follows it. +Это наиболее распространенное соглашение для YAML-файлов, и Task следует ему. ```yaml # bad @@ -50,7 +50,7 @@ tasks: - echo 'foo' ``` -## Separate with spaces the mains sections +## Разделяйте основные секции пробелами ```yaml # bad @@ -84,7 +84,7 @@ tasks: # ... ``` -## Add spaces between tasks +## Добавляйте пробелы между задачами ```yaml # bad @@ -119,7 +119,7 @@ tasks: - echo 'baz' ``` -## Use upper-case variable names +## Используйте имена переменных в верхнем регистре ```yaml # bad @@ -146,7 +146,7 @@ tasks: - go build -o {{.BINARY_NAME}} . ``` -## Don't wrap vars in spaces when templating +## Не заключайте переменные в пробелы при использовании их в шаблонах ```yaml # bad @@ -167,9 +167,9 @@ tasks: - echo '{{.MESSAGE}}' ``` -This convention is also used by most people for any Go templating. +Большинство людей использует это соглашение и для любых шаблонов в Go. -## Separate task name words with a dash +## Разделяйте слова в названии задач дефисом ```yaml # bad @@ -190,7 +190,7 @@ tasks: - echo 'Do something' ``` -## Use colon for task namespacing +## Используйте двоеточие для неймспейсов в названиях задач ```yaml # good @@ -206,4 +206,4 @@ tasks: - docker-compose ... ``` -This is also done automatically when using included Taskfiles. +Это также происходит автоматически при использовании включенных Taskfiles. 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 b4996d42..b04024ca 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 @@ -3,21 +3,21 @@ slug: /taskfile-versions/ sidebar_position: 12 --- -# Taskfile Versions +# Версии Taskfile -The Taskfile syntax and features changed with time. This document explains what changed on each version and how to upgrade your Taskfile. +Синтаксис Taskfile и функции со временем изменяются. Этот документ объясняет, что изменилось в каждой версии и как обновить свой Taskfile. -## What the Taskfile version mean +## Что обозначает версия Taskfile -The Taskfile version follows the Task version. E.g. the change to Taskfile version `2` means that Task `v2.0.0` should be release to support it. +Версия Taskfile соответствует версии Task. Например: изменение на Taskfile версии `2` означает, что Task `v2.0.0` должна быть выпущена для ее поддержки. -The `version:` key on Taskfile accepts a semver string, so either `2`, `2.0` or `2.0.0` is accepted. If you choose to use `2.0` Task will not enable future `2.1` features, but if you choose to use `2`, then any `2.x.x` features will be available, but not `3.0.0+`. +`version:` ключ Taskfile принимает [semVer](https://semver.org/lang/ru/) строку. Пример: `2`, `2.0` или `2.0.0`. Если вы решите использовать Task версии `2.0`, то у вас не будет доступа к функциям версии `2.1`, но если вы решите использовать версию `2`, то любые функции версий `2.x.x` будут доступны, но не `3.0.0+`. -## Version 1 +## Версия 1 -> NOTE: Taskfiles in version 1 are not supported on Task >= v3.0.0 anymore. +> ПРИМЕЧАНИЕ: Taskfiles версии 1 больше не поддерживаются в версии Task >= v3.0.0. -In the first version of the `Taskfile`, the `version:` key was not available, because the tasks was in the root of the YAML document. Like this: +В первой версии `Taskfile` поле `version:` не доступно, потому что задачи были в корне документа YAML. Пример: ```yaml echo: @@ -25,16 +25,16 @@ echo: - echo "Hello, World!" ``` -The variable priority order was also different: +Порядок приоритетов переменных также отличается: -1. Call variables -2. Environment -3. Task variables -4. `Taskvars.yml` variables +1. Вызов переменных +2. Переменные среды +3. Переменные Task +4. Переменные `Taskvars.yml` -## Version 2.0 +## Версия 2.0 -At version 2, we introduced the `version:` key, to allow us to evolve Task with new features without breaking existing Taskfiles. The new syntax is as follows: +В версии 2 был добавлен ключ `version: `. Он позволяет выпускать обновления сохраняя обратную совместимость. Пример использования: ```yaml version: '2' @@ -45,7 +45,7 @@ tasks: - echo "Hello, World!" ``` -Version 2 allows you to write global variables directly in the Taskfile, if you don't want to create a `Taskvars.yml`: +Версия 2 позволяет создавать глобальные переменные непосредственно в Taskfile, если вы не хотите создавать `Taskvars.yml`: ```yaml version: '2' @@ -59,15 +59,15 @@ tasks: - echo "{{.GREETING}}" ``` -The variable priority order changed to the following: +Порядок приоритетов переменных также отличается: -1. Task variables +1. Переменные Task 2. Call variables -3. Taskfile variables -4. Taskvars file variables -5. Environment variables +3. Переменные Taskfile +4. Переменные `Taskvars.yml` +5. Переменные окружения -A new global option was added to configure the number of variables expansions (which default to 2): +Добавлена новая глобальная опция для настройки количества расширений переменных (по умолчанию 2): ```yaml version: '2' @@ -87,9 +87,9 @@ tasks: - echo "{{.FOOBARBAZ}}" ``` -## Version 2.1 +## Версия 2.1 -Version 2.1 includes a global `output` option, to allow having more control over how commands output are printed to the console (see [documentation][output] for more info): +В версии 2.1 появилась глобальная опция `output`, которая позволяет иметь больше контроля над тем, как вывод команд печатается на консоли (см. [документацию][output]): ```yaml version: '2' @@ -103,7 +103,7 @@ tasks: prefix: server ``` -From this version it's also possible to ignore errors of a command or task (check documentation [here][ignore_errors]): +Начиная с этой версии можно игнорировать ошибки команды или задачи (смотрите документацию [здесь][ignore_errors]): ```yaml version: '2' @@ -122,9 +122,9 @@ tasks: ignore_error: true ``` -## Version 2.2 +## Версия 2.2 -Version 2.2 comes with a global `includes` options to include other Taskfiles: +В Версии 2.2 появилась новая глобальная опция `includes`, которая позволяет импортировать другие Taskfile'ы: ```yaml version: '2' @@ -134,9 +134,9 @@ includes: docker: ./DockerTasks.yml ``` -## Version 2.6 +## Версия 2.6 -Version 2.6 comes with `preconditions` stanza in tasks. +Версия 2.6 поставляется с `preconditions` опцией в задачах. ```yaml version: '2' @@ -149,20 +149,20 @@ tasks: - aws s3 cp .env s3://myenvironment ``` -Please check the [documentation][includes] +Пожалуйста, проверьте [документацию][includes] -## Version 3 +## Версия 3 -These are some major changes done on `v3`: +Основные изменения, сделанные в `v3`: -- Task's output will now be colored -- Added support for `.env` like files -- Added `label:` setting to task so one can override how the task name appear in the logs -- A global `method:` was added to allow setting the default method, and Task's default changed to `checksum` -- Two magic variables were added when using `status:`: `CHECKSUM` and `TIMESTAMP` which contains, respectively, the md5 checksum and greatest modification timestamp of the files listed on `sources:` -- Also, the `TASK` variable is always available with the current task name -- CLI variables are always treated as global variables -- Added `dir:` option to `includes` to allow choosing on which directory an included Taskfile will run: +- Output задачи теперь цветной +- Добавлена поддержка `.env` файлов +- Добавлен параметр `label:`. Появилась возможность переопределить имя задачи в логах +- Глобальный параметр `method:` был добавлен для установки метода по умолчанию, а задача по умолчанию изменена на `checksum` +- Добавлены 2 магические переменные, используемые в функции `status:` - `CHECKSUM` и `TIMESTAMP`, которые содержат, контрольную сумму md5 и наибольшую отметку времени изменения файлов, перечисленных в `sources:` +- Кроме того, переменная `TASK` всегда доступна по имени текущей задачи +- Переменные CLI всегда считаются глобальными переменными +- Добавлена опция `dir:` в `includes` для того, чтобы выбрать, в каком каталоге Taskfile будет запущен: ```yaml includes: @@ -171,7 +171,7 @@ includes: dir: ./docs ``` -- Implemented short task syntax. All below syntaxes are equivalent: +- Реализован короткий синтаксис задачи. Все синтаксисы ниже эквивалентны: ```yaml version: '3' @@ -197,11 +197,11 @@ tasks: print: echo "Hello, World!" ``` -- There was a major refactor on how variables are handled. They're now easier to understand. The `expansions:` setting was removed as it became unncessary. This is the order in which Task will process variables, each level can see the variables set by the previous one and override those. - - Environment variables - - Global + CLI variables +- Был произведён большой рефакторинг обработки переменных. Теперь всё стало более прозрачно. Параметр `expansions:` был удален. Это порядок, в котором Task будет обрабатывать переменные, каждый уровень может видеть переменные, объявленные на предыдущем и переопределять их. + - Переменные окружения + - Глобальные + CLI переменные - Call variables - - Task variables + - Переменные Task [output]: usage.md#output-syntax [ignore_errors]: usage.md#ignore-errors 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 56c2fbea..b645275e 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 @@ -3,13 +3,13 @@ slug: /translate/ sidebar_position: 14 --- -# Translate +# Перевод -Want to help us translate this documentation? In this document we explain how. +Хотите помочь нам перевести эту документацию? В этом документе мы объясним каким образом. -Do NOT edit translated markdown files directly on the GitHub repository! We use [Crowdin][crowdin] to allow contributors on work on translations. The repository is periodically updated with progress from Crowdin. +НЕ редактируйте переведенные файлы markdown прямо в репозитории GitHub! Мы используем [Crowdin][crowdin], чтобы позволить участникам работать над переводами. Репозиторий периодически обновляется с прогрессом из Crowdin. -If you want to have access to the Crowdin project to be able to suggest translations, please ask for access on the [#translations channel on our Discord server][discord]. If a given language is not being shown to Crowdin yet, just ask and we can configure it. +Если вы хотите получить доступ к проекту Crowdin, чтобы предложить перевод, пожалуйста, попросите доступ к каналу [#translations на нашем Discord сервере][discord]. Если данный язык еще не отображается в Crowdin, просто спросите и мы сможем его настроить. diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/usage.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/usage.md index 86ee736b..86e00d07 100644 --- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/usage.md +++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/usage.md @@ -3,11 +3,11 @@ slug: /usage/ sidebar_position: 3 --- -# Usage +# Использование -## Getting started +## Начало работы -Create a file called `Taskfile.yml` in the root of your project. The `cmds` attribute should contain the commands of a task. The example below allows compiling a Go app and uses [esbuild](https://esbuild.github.io/) to concat and minify multiple CSS files into a single one. +Создайте файл с именем `Taskfile.yml` в корне вашего проекта. Атрибут `cmds` должен содержать команды задачи. Пример ниже позволяет скомпилировать приложение Go и использовать [esbuild](https://esbuild.github.io/) чтобы собрать и минимизировать несколько CSS файлов в один. ```yaml version: '3' @@ -22,32 +22,32 @@ tasks: - esbuild --bundle --minify css/index.css > public/bundle.css ``` -Running the tasks is as simple as running: +Запуск задач настолько прост, что достаточно выполнить команду: ```bash task assets build ``` -Task uses [mvdan.cc/sh](https://mvdan.cc/sh/), a native Go sh interpreter. So you can write sh/bash commands, and it will work even on Windows, where `sh` or `bash` are usually not available. Just remember any executable called must be available by the OS or in PATH. +Task использует [mvdan.cc/sh](https://mvdan.cc/sh/) - нативный интерпретатор sh на Go. Таким образом, вы можете писать команды sh / bash, и они будут работать даже в Windows, где обычно не доступны `sh` или `bash`. Просто помните, что любой исполняемый файл, который вызывается, должен быть доступен ОС или находиться в переменной PATH. -If you omit a task name, "default" will be assumed. +Если вы опустите имя задачи, то будет использоваться имя "default". -## Supported file names +## Поддерживаемые названия файлов -Task will look for the following file names, in order of priority: +Task будет искать следующие файлы, в порядке приоритета: - Taskfile.yml - Taskfile.yaml - Taskfile.dist.yml - Taskfile.dist.yaml -The intention of having the `.dist` variants is to allow projects to have one committed version (`.dist`) while still allowing individual users to override the Taskfile by adding an additional `Taskfile.yml` (which would be on `.gitignore`). +Идея создания вариантов `.dist` заключается в том, чтобы позволить проектам иметь одну фиксированную версию (`.dist`), при этом позволяя отдельным пользователям переопределить Taskfile, добавив дополнительный `Taskfile.yml` (который будет находится в `.gitignore`). -### Running a Taskfile from a subdirectory +### Запуск Taskfile из поддиректории -If a Taskfile cannot be found in the current working directory, it will walk up the file tree until it finds one (similar to how `git` works). When running Task from a subdirectory like this, it will behave as if you ran it from the directory containing the Taskfile. +Если Taskfile не найден в текущем рабочем каталоге, он будет искать его вверх по дереву файлов, пока не найдет его (похоже на то, как работает `git`). При запуске Task из подкаталога, он будет работать так, как будто вы запустили его из каталога, содержащего Taskfile. -You can use this functionality along with the special `{{.USER_WORKING_DIR}}` variable to create some very useful reusable tasks. For example, if you have a monorepo with directories for each microservice, you can `cd` into a microservice directory and run a task command to bring it up without having to create multiple tasks or Taskfiles with identical content. For example: +Вы можете использовать эту функцию вместе со специальной переменной `{{.USER_WORKING_DIR}}`, чтобы создавать переиспользуемые задачи. Например, если у вас есть монорепозиторий с каталогами для каждого микросервиса, вы можете `cd` в директорию микросервиса и запустить команду задачи, без создания нескольких задач или Taskfile с идентичным содержимым. Например: ```yaml version: '3' @@ -61,19 +61,19 @@ tasks: - docker-compose up -d ``` -In this example, we can run `cd ` and `task up` and as long as the `` directory contains a `docker-compose.yml`, the Docker composition will be brought up. +В этом примере мы можем выполнить `cd ` и `task up`, и при условии, что каталог `` содержит файл `docker-compose.yml`, Docker composition будет запущен. -### Running a global Taskfile +### Запуск глобального Taskfile -If you call Task with the `--global` (alias `-g`) flag, it will look for your home directory instead of your working directory. In short, Task will look for a Taskfile on either `$HOME/Taskfile.yml` or `$HOME/Taskfile.yaml` paths. +Если вы вызовите Task с помощью флага `--global` (псевдоним `-g`), будет искать ваш домашний каталог вместо рабочего каталога. Проще говоря, Task будет искать в `$HOME/Taskfile.yml` или `$HOME/Taskfile.yaml`. -This is useful to have automation that you can run from anywhere in your system! +Это полезно, чтобы иметь автоматизацию, которую можно запустить из любого места вашей системы! :::info -When running your global Taskfile with `-g`, tasks will run on `$HOME` by default, and not on your working directory! +Когда вы запускаете ваш глобальный Taskfile с помощью `-g`, task будут выполняться по умолчанию в директории `$HOME`, а не в вашей рабочей директории! -As mentioned in the previous section, the `{{.USER_WORKING_DIR}}` special variable can be very handy here to run stuff on the directory you're calling `task -g` from. +Как упоминалось в предыдущем разделе, специальная переменная `{{.USER_WORKING_DIR}}` может быть очень полезной для запуска команд в директории, из которой вы вызываете `task -g`. ```yaml version: '3' @@ -91,11 +91,11 @@ tasks: ::: -## Environment variables +## Переменные среды ### Task -You can use `env` to set custom environment variables for a specific task: +Вы можете использовать `env` для создания своих переменных среды для конкретной task: ```yaml version: '3' @@ -108,7 +108,7 @@ tasks: GREETING: Hey, there! ``` -Additionally, you can set global environment variables that will be available to all tasks: +Также, вы можете создавать глобальные переменные окружения, которые будут доступны всем task: ```yaml version: '3' @@ -124,13 +124,13 @@ tasks: :::info -`env` supports expansion and retrieving output from a shell command just like variables, as you can see in the [Variables](#variables) section. +`env` поддерживает дополнение и извлечение вывода из команды shell или переменной, вы можете посмотреть в разделе [Переменные](#variables). ::: -### .env files +### .env файлы -You can also ask Task to include `.env` like files by using the `dotenv:` setting: +Вы также можете попросить Task включать файлы, подобные `.env` используя настройку `dotenv:`: ```bash title=".env" KEYNAME=VALUE @@ -154,7 +154,7 @@ tasks: - echo "Using $KEYNAME and endpoint $ENDPOINT" ``` -Dotenv files can also be specified at the task level: +Dotenv файлы также могут быть указаны на уровне task: ```yaml version: '3' @@ -169,7 +169,7 @@ tasks: - echo "Using $KEYNAME and endpoint $ENDPOINT" ``` -Environment variables specified explicitly at the task-level will override variables defined in dotfiles: +Переменные окружения, определенные на уровне task, заменят переменные объявленные в dotenv файлах: ```yaml version: '3' @@ -188,13 +188,13 @@ tasks: :::info -Please note that you are not currently able to use the `dotenv` key inside included Taskfiles. +Обратите внимание, в данный момент вы не можете использовать ключ `dotenv` во вложенных Taskfile. ::: -## Including other Taskfiles +## Включение других Taskfile -If you want to share tasks between different projects (Taskfiles), you can use the importing mechanism to include other Taskfiles using the `includes` keyword: +Если вы хотите использовать task в других проектах (Taskfile), вы можете использовать механизм импорта для включения других Taskfile используя ключевое слово `includes`: ```yaml version: '3' @@ -204,9 +204,9 @@ includes: docker: ./DockerTasks.yml ``` -The tasks described in the given Taskfiles will be available with the informed namespace. So, you'd call `task docs:serve` to run the `serve` task from `documentation/Taskfile.yml` or `task docker:build` to run the `build` task from the `DockerTasks.yml` file. +Task, описанные в указанных Taskfile, будут доступны с указанным пространством имен. Таким образом, вы можете запустить `serve` task из файла `documentation/Taskfile.yml` с помощью команды `task docs:serve`, или запустить `build` task из файла `DockerTasks.yml` с помощью команды `task docker:build`. -Relative paths are resolved relative to the directory containing the including Taskfile. +Относительные пути разрешаются относительно каталога, содержащего включающий Taskfile. ### OS-specific Taskfiles @@ -480,9 +480,9 @@ tasks: - cmd: echo 'Running on all platforms' ``` -## Calling another task +## Вызов другой task -When a task has many dependencies, they are executed concurrently. This will often result in a faster build pipeline. However, in some situations, you may need to call other tasks serially. In this case, use the following syntax: +Когда task имеет много зависимостей, они выполняются параллельно. Это частно приводит к более быстрому построению пайплайна. Однако, в некоторых ситуациях вам может понадобиться вызвать другие task последовательно. В этом случае используйте следующий синтаксис: ```yaml version: '3' @@ -503,7 +503,7 @@ tasks: - echo "Another task" ``` -Overriding variables in the called task is as simple as informing `vars` attribute: +Переопределение переменных в вызываемой task делается через указание атрибута `vars`: ```yaml version: '3' @@ -521,7 +521,7 @@ tasks: vars: { RECIPIENT: 'Cruel World' } ``` -The above syntax is also supported in `deps`. +Указанный выше синтаксис также поддерживается в `deps`. :::tip