diff options
Diffstat (limited to 'doc.ptbr')
| -rw-r--r-- | doc.ptbr/source/index.rst | 55 |
1 files changed, 30 insertions, 25 deletions
diff --git a/doc.ptbr/source/index.rst b/doc.ptbr/source/index.rst index f596d44..9997481 100644 --- a/doc.ptbr/source/index.rst +++ b/doc.ptbr/source/index.rst @@ -286,7 +286,8 @@ anterior a 3.2.2, é `essencial` que você instale o lxml ou o html5lib. O parse HTML nativo do Python não é muito bom para versões mais antigas. Note que se um documento é inválido, diferentes parsers irão gerar -diferentes árvores BeautifulSoup para isso. Veja :ref:`Diferenças entre os interpretadores (parsers)` +diferentes árvores BeautifulSoup para isso. Veja +:ref:`Diferenças entre os interpretadores (parsers) <differences-between-parsers>` para detalhes. @@ -311,7 +312,7 @@ são convertidas para caracteres Unicode:: O Beautiful Soup então interpreta o documento usando o melhor parser disponível. Ele irá utilizar um parser HTML ao menos que você indique a ele que utilize um -parser XML.(Veja `Interpretando XML`_.) +parser XML. (Veja `Analisando um XML`_.) Tipos de objetos ================ @@ -1116,8 +1117,8 @@ mas nenhuma das strings:: .. _a function: -Uma function -^^^^^^^^^^^^ +Uma função +^^^^^^^^^^ Se nenhuma das opções anteriores funcionar para você, defina uma função que pegará um elemento como seu único argumento. A função @@ -1221,8 +1222,8 @@ Este é o uso mais simples:: # [<title>The Dormouse's story</title>] Lembre-se de `Tipos de filtros`_ que o valor para ``name`` pode ser `uma -string`_, `uma expressão regular`_, `uma lista`_, `uma função`_, ou `o valor -True`_. +string`_, `uma expressão regular`_, `uma lista`_, `uma função`_, ou +:ref:`o valor True <the value True>`. .. _kwargs: @@ -1243,8 +1244,9 @@ em cada tag que possua o atributo ``href``:: soup.find_all(href=re.compile("elsie")) # [<a class="sister" href="http://example.com/elsie" id="link1">Elsie</a>] -Você pode filtrar um atributo baseado em `uma string`_, `uma regular -expression`_, `uma lista`_, `uma função`_, ou `no valor True`_. +Você pode filtrar um atributo baseado em `uma string`_, +`uma expressão regular`_, `uma lista`_, `uma função`_, ou +:ref:`o valor True <the value True>`. Este código encontra todas as tags em que o atributo ``id`` possuem um valor, independente de qual valor seja:: @@ -1360,8 +1362,8 @@ O argumento ``string`` Com ``string`` você pode buscar por strings ao invés de tags. Assim como ``name`` e os argumentos palavras-chave, você pode passar `uma string`_, `uma -expressão regular`_, `uma lista`_, `uma função`_, ou `o valor True`_. -Aqui estão alguns exemplos:: +expressão regular`_, `uma lista`_, `uma função`_, ou +:ref:`o valor True <the value True>`. Aqui estão alguns exemplos:: soup.find_all(string="Elsie") # [u'Elsie'] @@ -1588,7 +1590,8 @@ Signature: find_previous_sibling(:ref:`name <name>`, :ref:`attrs <attrs>`, :ref: Estes métodos utilizam :ref:`.previous_siblings <sibling-generators>` para iterar sobre os filhos de um elemento que o precede na árvore. O método ``find_previous_siblings()`` -retorna todos os filhos que atendem o requisito e ``find_previous_sibling()``retorna apenas o primeiro:: +retorna todos os filhos que atendem o requisito e +``find_previous_sibling()`` retorna apenas o primeiro:: last_link = soup.find("a", id="link3") last_link @@ -1680,7 +1683,7 @@ sobre o conteúdo de uma única tag. A `documentação <https://facelessuser.github.io/soupsieve/>`_ SoupSieve lista todos os seletores suportados atualmente, mas aqui estão alguns dos -básicos:: +básicos: Você pode encontrar tags:: @@ -1822,7 +1825,7 @@ pode também modificar a árvore e escrever suas modificações como um novo documento HTML ou XML. Alterando nomes de tags e atributos ---------------------------------- +----------------------------------- Cobri este assunto anteriormente em `Atributos`_, mas vale a pena repetir. Você pode renomear uma tag, alterar o valor de algum de seus atributos, adicionar novos @@ -2183,7 +2186,7 @@ dentro dele:: # u'<a href="http://example.com/">I linked to <i>example.com</i></a>' A função ``str()`` retorna uma string codificada em UTF-8. Veja -`Encodings`_ para outras opções. +`Codificação (Encoding)`_ para outras opções. Você também pode chamar ``encode()`` para ter uma bytestring, e ``decode()`` para ter Unicode. @@ -2320,7 +2323,7 @@ implementação também filtra o atributido chamado "m" quando ele aparece:: print(attr_soup.p.encode(formatter=UnsortedAttributes())) # <p z="1" a="3"></p> -Um último conselho: se você criar um objeto ``CDATA'', o texto dentro deste objeto +Um último conselho: se você criar um objeto ``CDATA``, o texto dentro deste objeto sempre estará presente `exatamente como aparenta, com nenhuma formatação`. O Beautiful Soup irá chamar sua função de substituição da entidade, apenas no caso de você ter escrito uma função personalizada que conta todas as strings @@ -2387,17 +2390,20 @@ com as seguintes características: * O tipo de marcação que você quer analisar. Atualmente são suportados "html", "xml", and "html5". * O nome do parser que você quer utilizar. Atualmente são suportadas -as opções "lxml", "html5lib", e "html.parser" (parser nativo do Python). + as opções "lxml", "html5lib", e "html.parser" (parser nativo do Python). -A seção `Instalando um interpretador (parser)`_ compara os parsers suportados. +A seção `Instalando um interpretador (parser)` compara os parsers suportados. Se você não tem um parser apropriado instalado, o Beautiful Soup irá ignorar sua solicitação e escolher um diferente. Atualmente, o único parser XML suportado é o lxml. Se você não possui o lxml instalado, pedir um parser XML não trará um e pedir por "lxml" não funcionará também. + +.. _differences-between-parsers: + Diferenças entre os interpretadores (parsers) ------------------------------------------- +--------------------------------------------- O Beautiful Soup apresenta a mesma interface para diferentes parsers, mas cada um é diferente. Diferentes parsers irão criar diferentes análises da árvore @@ -2743,7 +2749,7 @@ Esta característica é nova no 4.8.1 e os analisadores baseados no lxml não a suportam. Comparando objetos por igualdade -============================== +================================ O Beautiful Soup diz que dois objetos ``NavigableString`` ou ``Tag`` são iguais quando eles apresentam as mesma marcação HTML ou XML. No exemplo @@ -2833,7 +2839,7 @@ A classe ``SoupStrainer`` recebe os mesmos argumentos que qualquer método em `B only_short_strings = SoupStrainer(string=is_short_string) Irei trazer de volta o documento "three sisters" mais uma vez e veremos -como o documento se parece quando é analisado com estes três objetos ``SoupStrainer` +como o documento se parece quando é analisado com estes três objetos ``SoupStrainer`` diferentes:: html_doc = """ @@ -2928,10 +2934,9 @@ porque o Beautiful Soup é maravilhosamente um software bem escrito. É porque o Beautiful Soup não inclui nenhum código de análise. Ao invés disso, ele depende de analisadores externos. Se um analisador não funciona com certo documento, a melhor solução é tentar um analisador diferente. Veja -`Instalando um analisador`_ para detalhes e uma comparação entre eles. +:ref:`Instalando um interpretador <parser-installation>` para detalhes e uma comparação entre eles. Os erros de interpretação mais comuns são ``HTMLParser.HTMLParseError: - malformed start tag`` e ``HTMLParser.HTMLParseError: bad end tag``. Existem dois parsers gerados para o parser built in do Python e a solução é :ref:`install lxml ou html5lib. <parser-installation>` @@ -2985,7 +2990,7 @@ Outros problemas com analisadores possuem bibliotecas de analisadores difererentes. Por exemplo, você pode ter desenvolvido um script em um computador que possui lxml instalado, e então estar tentando rodá-lo no seu computador que possui apenas html5lib - instalado. Veja :ref:`Diferenças entre os interpretadores (parsers)` para entender porque isso importa, + instalado. Veja :ref:`Diferenças entre os interpretadores (parsers) <differences-between-parsers>` para entender porque isso importa, e corrija o problema mencionando uma biblioteca específica no construtor ``BeautifulSoup``. * Por tags `HTML e atributos serem case-insensitive @@ -3050,7 +3055,7 @@ utilizando o lxml do que usando o html.parser ou html5lib. Você pode acelerar a detecção da codificação significativamente instalando a biblioteca `cchardet <http://pypi.python.org/pypi/cchardet/>`_ . -`Analisando apenas parte do documento`_ não irá lhe poupar muito tempo de +`Analisando apenas parte de um documento`_ não irá lhe poupar muito tempo de análise, mas irá poupar muita memória e fará a `busca` no documento muito mais rápida. @@ -3113,7 +3118,7 @@ Você precisa de um interpretador (parser) O Beautiful Soup 3 utilizava o ``SGMLParser`` do Python, um módulo que foi depreciado e removido no Python 3.0. O Beautiful Soup 4 utiliza o ``html.parser`` por padrão, mas você pode adicionar o lxml ou html5lib -e utilizá-los como alternativa. Veja `Instalando um interpretador (parser)`_ para +e utilizá-los como alternativa. Veja :ref:`Instalando um interpretador <parser-installation>` para comparação. Como o ``html.parser`` não é o mesmo analisador que ``SGMLParser``, é possível |