From bce71f01b39b6d4a29ccbce67becb57c97e17bc2 Mon Sep 17 00:00:00 2001 From: Weblate Date: Nov 06 2023 06:47:48 +0000 Subject: Added translation using Weblate (Spanish) Co-authored-by: Weblate --- diff --git a/po/es/master/pages/contributing-docs/tools-vale-linter.po b/po/es/master/pages/contributing-docs/tools-vale-linter.po new file mode 100644 index 0000000..ec3d009 --- /dev/null +++ b/po/es/master/pages/contributing-docs/tools-vale-linter.po @@ -0,0 +1,478 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR , YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2022-12-29 22:00+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"Language: es\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: Title = +#: ./pages/contributing-docs/tools-vale-linter.adoc:1 +#, no-wrap +msgid "Check Your Documentation Using Vale " +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:4 +msgid "" +"Fedora Documentation Team " +"v0.0.1, 2022-12-17" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:6 +#, no-wrap +msgid "" +"Before creating a merge request for any documentation or documentation " +"updates, you will need to run https://vale.sh[Vale] on your text. \n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:8 +msgid "" +"Vale is a command line tool that checks your text for adherence to a defined " +"style guide. Fedora documentation uses the " +"https://stylepedia.net/style/5.1/[Red Hat] style guide." +msgstr "" + +#. type: Title == +#: ./pages/contributing-docs/tools-vale-linter.adoc:9 +#, no-wrap +msgid "Install Vale on your computer " +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:12 +msgid "" +"You can install Vale on your computer, or use a containerized version with " +"Podman." +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:14 +msgid "" +"To install Vale on your computer use one of the available installers for " +"https://vale.sh/docs/vale-cli/installation/[Windows, macOS, and Linux]." +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:16 +msgid "" +"If you are using Fedora, you can install from the `mczernek/vale` Copr " +"repository. Be aware that Copr is not officially supported by Fedora " +"infrastructure. Use packages at your own risk." +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:19 +#, no-wrap +msgid "$ sudo dnf copr enable mczernek/vale && sudo dnf install vale\n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:22 +msgid "" +"You can use the containerized version of Vale if you don't want to install " +"it locally." +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:25 +#, no-wrap +msgid "" +"podman run --rm -v ${PWD}:/docs -w /docs jdkato/vale:latest " +"\n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:28 +msgid "" +"If you installed Vale locally, verify that Vale is available by using the " +"`vale -v` command:" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:32 +#, no-wrap +msgid "" +"$ vale -v\n" +"vale version 2.21.2 (your version may be different depending on when you " +"installed Vale) \n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:35 +msgid "" +"The Red Hat style guide and the required Vale configuration files are " +"already installed and available in the repository you forked from the main " +"https://gitlab.com/fedora/docs[Fedora Docs] page in GitLab." +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:37 +msgid "" +"You can verify this by checking for a `.vale.ini` file in the file list of " +"your fork in your GitLab account. You do not need to download or install any " +"additional style files." +msgstr "" + +#. type: Title == +#: ./pages/contributing-docs/tools-vale-linter.adoc:38 +#, no-wrap +msgid "Use Vale to check files or directories" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:41 +msgid "To use Vale, do the following:" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:43 +msgid "" +"Create or edit a file in your local Fedora Docs repository. See " +"xref:contributing-docs/tools-local-authoring-env.adoc[How to create and use " +"a local Fedora authoring environment] for instructions on how to fork, " +"clone, and manage Git repositories on your computer." +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:44 +msgid "" +"Run the Vale linter on the file. You can run Vale on a single file, several " +"files, and directories." +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:45 +msgid "Make updates to the file to fix any errors, warnings, or suggestions." +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:46 +msgid "Rerun the Vale linter to verify the file passes." +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:48 +msgid "" +"When your file passes, you can commit your work and push to your fork on " +"GitLab, and open a merge request." +msgstr "" + +#. type: Title === +#: ./pages/contributing-docs/tools-vale-linter.adoc:49 +#, no-wrap +msgid "Vale commands and output" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:52 +#, no-wrap +msgid "To run Vale on a single file: \n" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:55 +#, no-wrap +msgid "$ vale filename\n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:58 +msgid "To run Vale on several files:" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:61 +#, no-wrap +msgid "$ vale filename 1 filename 2\n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:64 +msgid "To run Vale on all the files in a directory:" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:67 +#, no-wrap +msgid "$ vale directoryname/\n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:70 +msgid "" +"Vale will return a list of results showing the location in the file, the " +"level of severity, a hint about how to correct the result, and what style " +"reference flagged the result. For example:" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:81 +#, no-wrap +msgid "" +"11:1 suggestion Define acronyms and RedHat.Definitions \n" +" abbreviations (such as 'TOC') \n" +" on first occurrence if they're \n" +" likely to be unfamiliar. \n" +"15:54 error Use 'for example' rather than RedHat.TermsErrors \n" +" 'e.g.'. \n" +"15:59 warning Use correct American English RedHat.Spelling \n" +" spelling. Did you really mean \n" +" 'Quickdocs'?\n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:84 +msgid "If a file returns a long list of results, use:" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:87 +#, no-wrap +msgid "$ vale --no-wrap filename\n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:90 +msgid "" +"This will print each result on one line. This is also useful when checking " +"many files or all the files in a directory." +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:92 +#, no-wrap +msgid "" +"Vale has three levels of results that it will list at the bottom of the " +"output: error, warning, and suggestion. \n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:94 +msgid "`✖ 1 error, 3 warnings and 4 suggestions in 1 file.`" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:96 +#, no-wrap +msgid "" +"**error**: This is a blocker, and you must fix any errors found in the " +"file.\n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:97 +#, no-wrap +msgid "" +"**warning**: This is a not a blocker, but is something that you need to fix " +"to conform to the Red Hat style guide. \n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:98 +#, no-wrap +msgid "" +"**suggestion**: This is not a blocker, but is something you must review and " +"try to fix to conform to the Red Hat style guide.\n" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:100 +msgid "" +"If you want to only look for a specific result, use the `--minAlertLevel " +"level` flag. This is useful if you have a long list of results and want to " +"work on one specific result level at a time." +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:102 +msgid "`--minAlertLevel suggestion` (shows suggestion, warning, and error)" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:104 +msgid "`--minAlertLevel warning` (shows warning and error)" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:106 +msgid "`--minAlertLevel error` (shows only error)" +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:108 +msgid "For example, to only shows results flagged with error in the file, use:" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:111 +#, no-wrap +msgid "$ vale --no-wrap --minAlertLevel error filename\n" +msgstr "" + +#. type: Title == +#: ./pages/contributing-docs/tools-vale-linter.adoc:113 +#, no-wrap +msgid "How to interpret Vale results " +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:116 +msgid "" +"Vale shows the results by line number and position (sometimes called a " +"column). It also shows the style guideline that flagged the content." +msgstr "" + +#. type: Plain text +#: ./pages/contributing-docs/tools-vale-linter.adoc:118 +msgid "For example, this error is on line 15, starting at position 54" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:121 +#, no-wrap +msgid "" +"15:54 error Use 'for example' rather than 'e.g.'. " +"RedHat.TermsErrors\n" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:127 +#, no-wrap +msgid "" +"15 ** Editor in chief for specific documentation areas, e.g. Quickdocs\n" +" ^ position 54\n" +"---- \n" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:129 +#, no-wrap +msgid "" +"Verify that your text editor shows line numbers and position. Most text " +"editors will have a way to enable this view. \n" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:131 +#, no-wrap +msgid "" +"Vale will usually tell you exactly what you need to do to fix the line, " +"which in this case is to use 'for example' instead of 'e.g.'\n" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:133 +#, no-wrap +msgid "" +"Rerun Vale to verify that the error is now resolved. Continue running Vale " +"to clear all errors, warnings, and suggestions. \n" +msgstr "" + +#. type: Title === +#: ./pages/contributing-docs/tools-vale-linter.adoc:134 +#, no-wrap +msgid "How to find guidance for correcting Vale results " +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:137 +msgid "" +"Every result returned by Vale shows the Red Hat style reference that flagged " +"the word or phrase. This is at the end of the each result, in the format of " +"`RedHat.style_name`." +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:139 +msgid "" +"These files are in a `.vale` directory at the top level of your local " +"repository, in a `styles/RedHat` subdirectory." +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:141 +msgid "" +"All the style files point back to the reference guide maintained by Red Hat " +"on the " +"https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/reference-guide/[Vale " +"for writers at Red Hat page]." +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:143 +msgid "" +"You can usually find guidance there on what to change to resolve any error " +"or warning level results." +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:145 +msgid "" +"If you want to see the contents of a specific style file, you can examine " +"the " +"https://github.com/redhat-documentation/vale-at-red-hat/tree/main/.vale/styles/RedHat[vale-at-red-hat] " +"page on GitHub." +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:147 +msgid "" +"If you still have questions or need help deciding what changes to make, post " +"a question in the Fedora Documentation room on " +"https://chat.fedoraproject.org/#/room/#docs:fedoraproject.org[Fedora Chat]." +msgstr "" + +#. type: Title == +#: ./pages/contributing-docs/tools-vale-linter.adoc:148 +#, no-wrap +msgid "More information" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:151 +msgid "Vale documentation: https://vale.sh/docs/" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:153 +#, no-wrap +msgid "Red Hat Technical Writing Style Guide: https://stylepedia.net/ \n" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:155 +#, no-wrap +msgid "" +"Guidelines for Red Hat Documentation: " +"https://redhat-documentation.github.io/ \n" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:157 +#, no-wrap +msgid "" +"Fedora Docs Style Guide: " +"https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/style-guide/ " +"\n" +msgstr "" + +#. type: delimited block - +#: ./pages/contributing-docs/tools-vale-linter.adoc:158 +#, no-wrap +msgid "" +"This guide shows how to use Vale from the command line, but " +"https://docs.gitlab.com/ee/development/documentation/testing.html#configure-editors[plugins " +"or packages] are available for several common text editors. \n" +msgstr ""