python-docs-pt-br/distutils/sourcedist.po at 2.7 · python/python-docs-pt-br

579 lines (486 loc) · 19.4 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 1990-2020, Python Software Foundation
# This file is distributed under the same license as the Python package.
# Translators:
"Project-Id-Version: Python 2.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-02-09 18:46+0900\n"
"PO-Revision-Date: 2020-02-29 09:24+0000\n"
"Last-Translator: Marco Rougeth <marco@rougeth.com>\n"
"Language-Team: Portuguese (Brazil) (http://www.transifex.com/python-doc/python-27/language/pt_BR/)\n"
"Language: pt_BR\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
#: ../../distutils/sourcedist.rst:5
msgid "Creating a Source Distribution"
msgstr "Criando uma Distribuição Fonte"
#: ../../distutils/sourcedist.rst:7
"As shown in section :ref:`distutils-simple-example`, you use the "
":command:`sdist` command to create a source distribution.  In the simplest "
"Conforme mostrado na seção :ref:`distutils-simple-example`, você usa o "
"comando :command:`sdist` para criar uma distribuição fonte. No caso mais "
"simples, ::"
#: ../../distutils/sourcedist.rst:12
"(assuming you haven't specified any :command:`sdist` options in the setup "
"script or config file), :command:`sdist` creates the archive of the default "
"format for the current platform.  The default format is a gzip'ed tar file "
"(:file:`.tar.gz`) on Unix, and ZIP file on Windows."
#: ../../distutils/sourcedist.rst:17
"You can specify as many formats as you like using the :option:`!--formats` "
"option, for example::"
#: ../../distutils/sourcedist.rst:22
"to create a gzipped tarball and a zip file.  The available formats are:"
#: ../../distutils/sourcedist.rst:25
msgid "Format"
msgstr "Formatação"
#: ../../distutils/sourcedist.rst:25 ../../distutils/sourcedist.rst:252
msgid "Description"
msgstr "Descrição"
#: ../../distutils/sourcedist.rst:25
msgid "Notes"
msgstr "Notas"
#: ../../distutils/sourcedist.rst:27
msgid "``zip``"
msgstr "``zip``"
#: ../../distutils/sourcedist.rst:27
msgid "zip file (:file:`.zip`)"
#: ../../distutils/sourcedist.rst:27
msgid "(1),(3)"
#: ../../distutils/sourcedist.rst:29
msgid "``gztar``"
msgstr "``gztar``"
#: ../../distutils/sourcedist.rst:29
msgid "gzip'ed tar file (:file:`.tar.gz`)"
#: ../../distutils/sourcedist.rst:29
msgid "\\(2)"
msgstr "\\(2)"
#: ../../distutils/sourcedist.rst:32
msgid "``bztar``"
msgstr "``bztar``"
#: ../../distutils/sourcedist.rst:32
msgid "bzip2'ed tar file (:file:`.tar.bz2`)"
#: ../../distutils/sourcedist.rst:35
msgid "``ztar``"
msgstr "``ztar``"
#: ../../distutils/sourcedist.rst:35
msgid "compressed tar file (:file:`.tar.Z`)"
#: ../../distutils/sourcedist.rst:35
msgid "\\(4)"
msgstr "\\(4)"
#: ../../distutils/sourcedist.rst:38
msgid "``tar``"
msgstr "``tar``"
#: ../../distutils/sourcedist.rst:38
msgid "tar file (:file:`.tar`)"
#: ../../distutils/sourcedist.rst:41
msgid "Notes:"
msgstr "Notas:"
#: ../../distutils/sourcedist.rst:44
msgid "default on Windows"
#: ../../distutils/sourcedist.rst:47
msgid "default on Unix"
#: ../../distutils/sourcedist.rst:50
"requires either external :program:`zip` utility or :mod:`zipfile` module "
"(part of the standard Python library since Python 1.6)"
#: ../../distutils/sourcedist.rst:54
msgid "requires the :program:`compress` program."
#: ../../distutils/sourcedist.rst:56
"When using any ``tar`` format (``gztar``, ``bztar``, ``ztar`` or ``tar``) "
"under Unix, you can specify the ``owner`` and ``group`` names that will be "
"set for each member of the archive."
#: ../../distutils/sourcedist.rst:60
"For example, if you want all files of the archive to be owned by root::"
#: ../../distutils/sourcedist.rst:68
msgid "Specifying the files to distribute"
#: ../../distutils/sourcedist.rst:70
"If you don't supply an explicit list of files (or instructions on how to "
"generate one), the :command:`sdist` command puts a minimal default set into "
"the source distribution:"
"Se você não fornecer uma lista explícita de arquivos (ou instruções sobre "
"como gerá-la), o comando :command:`sdist` coloca um conjunto padrão mínimo "
"na distribuição fonte:"
#: ../../distutils/sourcedist.rst:74
"all Python source files implied by the ``py_modules`` and ``packages`` "
"todos os arquivos fonte Python implícitos nas opções ``py_modules`` e "
"``packages``"
#: ../../distutils/sourcedist.rst:77
"all C source files mentioned in the ``ext_modules`` or ``libraries`` options"
"todos os arquivos fonte C mencionados nas opções ``ext_modules`` ou "
"``libraries``"
#: ../../distutils/sourcedist.rst:83
"scripts identified by the ``scripts`` option See :ref:`distutils-installing-"
"scripts`."
#: ../../distutils/sourcedist.rst:86
"anything that looks like a test script: :file:`test/test\\*.py` (currently, "
"the Distutils don't do anything with test scripts except include them in "
"source distributions, but in the future there will be a standard for testing"
" Python module distributions)"
"qualquer coisa que se pareça com um script de teste: :file:`test/test\\*.py`"
" (atualmente, os Distutils não fazem nada com scripts de teste, exceto "
"incluí-los em distribuições fonte, mas no futuro haverá um padrão para teste"
" de distribuições de módulo Python)"
#: ../../distutils/sourcedist.rst:91
":file:`README.txt` (or :file:`README`), :file:`setup.py` (or whatever  you "
"called your setup script), and :file:`setup.cfg`"
#: ../../distutils/sourcedist.rst:94
"all files that matches the ``package_data`` metadata. See :ref:`distutils-"
"installing-package-data`."
#: ../../distutils/sourcedist.rst:97
"all files that matches the ``data_files`` metadata. See :ref:`distutils-"
"additional-files`."
#: ../../distutils/sourcedist.rst:100
"Sometimes this is enough, but usually you will want to specify additional "
"files to distribute.  The typical way to do this is to write a *manifest "
"template*, called :file:`MANIFEST.in` by default.  The manifest template is "
"just a list of instructions for how to generate your manifest file, "
":file:`MANIFEST`, which is the exact list of files to include in your source"
" distribution.  The :command:`sdist` command processes this template and "
"generates a manifest based on its instructions and what it finds in the "
"filesystem."
"Às vezes, isso é suficiente, mas normalmente você deseja especificar "
"arquivos adicionais para distribuir. A maneira típica de fazer isso é "
"escrever um *modelo de manifesto*, chamado :file:`MANIFEST.in` por padrão. O"
" modelo de manifesto é apenas uma lista de instruções sobre como gerar seu "
"arquivo de manifesto, :file:`MANIFEST`, que é a lista exata de arquivos a "
"serem incluídos em sua distribuição fonte. O comando :command:`sdist` "
"processa este modelo e gera um manifesto baseado em suas instruções e no que"
" ele encontra no sistema de arquivos."
#: ../../distutils/sourcedist.rst:108
"If you prefer to roll your own manifest file, the format is simple: one "
"filename per line, regular files (or symlinks to them) only.  If you do "
"supply your own :file:`MANIFEST`, you must specify everything: the default "
"set of files described above does not apply in this case."
#: ../../distutils/sourcedist.rst:113
"An existing generated :file:`MANIFEST` will be regenerated without "
":command:`sdist` comparing its modification time to the one of "
":file:`MANIFEST.in` or :file:`setup.py`."
#: ../../distutils/sourcedist.rst:118
":file:`MANIFEST` files start with a comment indicating they are generated. "
"Files without this comment are not overwritten or removed."
#: ../../distutils/sourcedist.rst:122
":command:`sdist` will read a :file:`MANIFEST` file if no :file:`MANIFEST.in`"
" exists, like it did before 2.7."
#: ../../distutils/sourcedist.rst:126
msgid "See :ref:`manifest_template` section for a syntax reference."
#: ../../distutils/sourcedist.rst:132
msgid "Manifest-related options"
#: ../../distutils/sourcedist.rst:134
"The normal course of operations for the :command:`sdist` command is as "
#: ../../distutils/sourcedist.rst:136
"if the manifest file (:file:`MANIFEST` by default) exists and the first line"
" does not have a comment indicating it is generated from "
":file:`MANIFEST.in`, then it is used as is, unaltered"
#: ../../distutils/sourcedist.rst:140
"if the manifest file doesn't exist or has been previously automatically "
"generated, read :file:`MANIFEST.in` and create the manifest"
#: ../../distutils/sourcedist.rst:143
"if neither :file:`MANIFEST` nor :file:`MANIFEST.in` exist, create a manifest"
" with just the default file set"
#: ../../distutils/sourcedist.rst:146
"use the list of files now in :file:`MANIFEST` (either just generated or read"
" in) to create the source distribution archive(s)"
#: ../../distutils/sourcedist.rst:149
"There are a couple of options that modify this behaviour.  First, use the "
":option:`!--no-defaults` and :option:`!--no-prune` to disable the standard "
"\"include\" and \"exclude\" sets."
#: ../../distutils/sourcedist.rst:153
"Second, you might just want to (re)generate the manifest, but not create a "
"source distribution::"
#: ../../distutils/sourcedist.rst:158
msgid ":option:`!-o` is a shortcut for :option:`!--manifest-only`."
#: ../../distutils/sourcedist.rst:163
msgid "The MANIFEST.in template"
#: ../../distutils/sourcedist.rst:165
"A :file:`MANIFEST.in` file can be added in a project to define the list of "
"files to include in the distribution built by the :command:`sdist` command."
#: ../../distutils/sourcedist.rst:168
"When :command:`sdist` is run, it will look for the :file:`MANIFEST.in` file "
"and interpret it to generate the :file:`MANIFEST` file that contains the "
"list of files that will be included in the package."
#: ../../distutils/sourcedist.rst:172
"This mechanism can be used when the default list of files is not enough. "
"(See :ref:`manifest`)."
#: ../../distutils/sourcedist.rst:176
msgid "Principle"
#: ../../distutils/sourcedist.rst:178
"The manifest template has one command per line, where each command specifies"
" a set of files to include or exclude from the source distribution.  For an "
"example, let's look at the Distutils' own manifest template::"
#: ../../distutils/sourcedist.rst:186
"The meanings should be fairly clear: include all files in the distribution "
"root matching :file:`\\*.txt`, all files anywhere under the :file:`examples`"
" directory matching :file:`\\*.txt` or :file:`\\*.py`, and exclude all "
"directories matching :file:`examples/sample?/build`.  All of this is done "
"*after* the standard include set, so you can exclude files from the standard"
" set with explicit instructions in the manifest template.  (Or, you can use "
"the :option:`!--no-defaults` option to disable the standard set entirely.)"
#: ../../distutils/sourcedist.rst:194
"The order of commands in the manifest template matters: initially, we have "
"the list of default files as described above, and each command in the "
"template adds to or removes from that list of files.  Once we have fully "
"processed the manifest template, we remove files that should not be included"
" in the source distribution:"
"A ordem dos comandos no modelo de manifesto é importante: inicialmente, "
"temos a lista de arquivos padrão conforme descrito acima, e cada comando no "
"modelo adiciona ou remove dessa lista de arquivos. Depois de processarmos "
"totalmente o modelo de manifesto, removemos os arquivos que não devem ser "
"incluídos na distribuição fonte:"
#: ../../distutils/sourcedist.rst:200
msgid "all files in the Distutils \"build\" tree (default :file:`build/`)"
#: ../../distutils/sourcedist.rst:202
"all files in directories named :file:`RCS`, :file:`CVS`, :file:`.svn`, "
":file:`.hg`, :file:`.git`, :file:`.bzr` or :file:`_darcs`"
#: ../../distutils/sourcedist.rst:205
"Now we have our complete list of files, which is written to the manifest for"
" future reference, and then used to build the source distribution "
"archive(s)."
"Agora temos nossa lista completa de arquivos, que é gravada no manifesto "
"para referência futura e usada para construir o(s) arquivo(s) de "
"distribuição fonte."
#: ../../distutils/sourcedist.rst:208
"You can disable the default set of included files with the :option:`!--no-"
"defaults` option, and you can disable the standard exclude set with "
":option:`!--no-prune`."
#: ../../distutils/sourcedist.rst:212
"Following the Distutils' own manifest template, let's trace how the "
":command:`sdist` command builds the list of files to include in the "
"Distutils source distribution:"
"Seguindo o modelo de manifesto do próprio Distutils, vamos rastrear como o "
"comando :command:`sdist` constrói a lista de arquivos a serem incluídos na "
"distribuição fonte Distutils:"
#: ../../distutils/sourcedist.rst:216
"include all Python source files in the :file:`distutils` and "
":file:`distutils/command` subdirectories (because packages corresponding to "
"those two directories were mentioned in the ``packages`` option in the setup"
" script---see section :ref:`setup-script`)"
"inclua todos os arquivos fonte Python nos subdiretórios :file:`distutils` e "
":file:`distutils/command` (porque os pacotes correspondentes a esses dois "
"diretórios foram mencionados na opção ``packages`` no script de configuração"
" -- consulte a seção :ref:`setup-script`)"
#: ../../distutils/sourcedist.rst:221
"include :file:`README.txt`, :file:`setup.py`, and :file:`setup.cfg` "
"(standard files)"
#: ../../distutils/sourcedist.rst:224
msgid "include :file:`test/test\\*.py` (standard files)"
#: ../../distutils/sourcedist.rst:226
"include :file:`\\*.txt` in the distribution root (this will find "
":file:`README.txt` a second time, but such redundancies are weeded out "
#: ../../distutils/sourcedist.rst:229
"include anything matching :file:`\\*.txt` or :file:`\\*.py` in the sub-tree "
"under :file:`examples`,"
#: ../../distutils/sourcedist.rst:232
"exclude all files in the sub-trees starting at directories matching "
":file:`examples/sample?/build`\\ ---this may exclude files included by the "
"previous two steps, so it's important that the ``prune`` command in the "
"manifest template comes after the ``recursive-include`` command"
#: ../../distutils/sourcedist.rst:237
"exclude the entire :file:`build` tree, and any :file:`RCS`, :file:`CVS`, "
":file:`.svn`, :file:`.hg`, :file:`.git`, :file:`.bzr` and :file:`_darcs` "
"directories"
#: ../../distutils/sourcedist.rst:241
"Just like in the setup script, file and directory names in the manifest "
"template should always be slash-separated; the Distutils will take care of "
"converting them to the standard representation on your platform. That way, "
"the manifest template is portable across operating systems."
#: ../../distutils/sourcedist.rst:247
msgid "Commands"
#: ../../distutils/sourcedist.rst:249
msgid "The manifest template commands are:"
msgstr "Os comandos do modelo de manifesto são:"
#: ../../distutils/sourcedist.rst:252
msgid "Command"
msgstr "Comando"
#: ../../distutils/sourcedist.rst:254
msgid ":command:`include pat1 pat2 ...`"
msgstr ":command:`include pat1 pat2 ...`"
#: ../../distutils/sourcedist.rst:254
msgid "include all files matching any of the listed patterns"
"inclui todos os arquivos que correspondem a qualquer um dos padrões listados"
#: ../../distutils/sourcedist.rst:257
msgid ":command:`exclude pat1 pat2 ...`"
msgstr ":command:`exclude pat1 pat2 ...`"
#: ../../distutils/sourcedist.rst:257
msgid "exclude all files matching any of the listed patterns"
"exclui todos os arquivos que correspondem a qualquer um dos padrões listados"
#: ../../distutils/sourcedist.rst:260
msgid ":command:`recursive-include dir pat1 pat2 ...`"
msgstr ":command:`recursive-include dir pat1 pat2 ...`"
#: ../../distutils/sourcedist.rst:260
msgid "include all files under *dir* matching any of the listed patterns"
"inclui todos os arquivos em *dir* que correspondam a qualquer um dos padrões"
" listados"
#: ../../distutils/sourcedist.rst:263
msgid ":command:`recursive-exclude dir pat1 pat2 ...`"
msgstr ":command:`recursive-exclude dir pat1 pat2 ...`"
#: ../../distutils/sourcedist.rst:263
msgid "exclude all files under *dir* matching any of the listed patterns"
"exclui todos os arquivos em *dir* que correspondam a qualquer um dos padrões"
" listados"
#: ../../distutils/sourcedist.rst:266
msgid ":command:`global-include pat1 pat2 ...`"
msgstr ":command:`global-include pat1 pat2 ...`"
#: ../../distutils/sourcedist.rst:266
"include all files anywhere in the source tree matching --- & any of the "
"listed patterns"
"inclui todos os arquivos em qualquer lugar na árvore de fontes "
"correspondente --- e qualquer um dos padrões listados"
#: ../../distutils/sourcedist.rst:269
msgid ":command:`global-exclude pat1 pat2 ...`"
msgstr ":command:`global-exclude pat1 pat2 ...`"
#: ../../distutils/sourcedist.rst:269
"exclude all files anywhere in the source tree matching --- & any of the "
"listed patterns"
"exclui todos os arquivos em qualquer lugar na árvore de fontes "
"correspondente --- e qualquer um dos padrões listados"
#: ../../distutils/sourcedist.rst:272
msgid ":command:`prune dir`"
msgstr ":command:`prune dir`"
#: ../../distutils/sourcedist.rst:272
msgid "exclude all files under *dir*"
msgstr "exclui todos os arquivos em *dir*"
#: ../../distutils/sourcedist.rst:274
msgid ":command:`graft dir`"
msgstr ":command:`graft dir`"
#: ../../distutils/sourcedist.rst:274
msgid "include all files under *dir*"
msgstr "inclui todos os arquivos em *dir*"
#: ../../distutils/sourcedist.rst:277
"The patterns here are Unix-style \"glob\" patterns: ``*`` matches any "
"sequence of regular filename characters, ``?`` matches any single regular "
"filename character, and ``[range]`` matches any of the characters in *range*"
" (e.g., ``a-z``, ``a-zA-Z``, ``a-f0-9_.``).  The definition of \"regular "
"filename character\" is platform-specific: on Unix it is anything except "
"slash; on Windows anything except backslash or colon."
"Os padrões aqui são padrões \"glob\" no estilo Unix: ``*`` corresponde a "
"qualquer sequência de caracteres regulares de nome de arquivo, ``?`` "
"corresponde a qualquer caractere comum de nome de arquivo regular e "
"``[intervalo]`` corresponde a qualquer um dos caracteres em *intervalo* (por"
" exemplo, ``az``, ``a-zA-Z``, ``a-f0-9_.``). A definição de \"caractere de "
"nome de arquivo comum\" é específica da plataforma: no Unix, é qualquer "
"coisa, exceto barra; no Windows qualquer coisa, exceto contrabarra ou dois "
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

sourcedist.po

Latest commit

History

sourcedist.po

File metadata and controls
