Skip to content

Commit

Permalink
Markdown conversion for pt-BR - Cleanup - Mozilla section (#8469)
Browse files Browse the repository at this point in the history
Fix md conversion report
  • Loading branch information
SphinxKnight authored Sep 14, 2022
1 parent 40e5860 commit d5ac94e
Show file tree
Hide file tree
Showing 14 changed files with 45 additions and 109 deletions.
44 changes: 14 additions & 30 deletions files/pt-br/mozilla/add-ons/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -20,75 +20,59 @@

<p>O <a href="/pt-BR/docs/Mozilla/Add-ons/Gerenciador_de_Add-on" title="Addons/Add-on Manager">Gerenciador de complementos</a> dá acesso aos complementos a fim de determinar o que está disponível, instalar, remover, desativar e atualizar.</p>

<hr>
<h2 id="Extensões_2"><a name="Extensões">Extensões</a></h2>

<p>Extensões adicionam novas funcionalidades para aplicativos da Mozilla como Firefox e Thunderbird. Eles podem adicionar novos recursos ao navegador, como um jeito diferente de gerenciar as abas, e eles podem modificar o conteúdo da web para aperfeiçoar a usabilidade ou segurança sites específicos.</p>

<p>Há três tipos de técnicas diferentes que você pode utilizar para construir uma extensão: Add-on baseado em extensões SDK, extensões <em>restartless</em> inicializadas manualmente e extensões overlay.</p>

<ul class="card-grid">
<ul>
<li>Desenvolva extensões que não requer a reinicialização do navegador utilizando um conjunto JavaScript APIs de alto nível.</li>
<li><a href="https://developer.mozilla.org/en-US/Add-ons/Bootstrapped_extensions">Extensões <em>Restartless</em></a><br>
<li><a href="/en-US/Add-ons/Bootstrapped_extensions">Extensões <em>Restartless</em></a><br>
Desenvolva extensões que não requer a reinicialização do navegador.</li>
<li><a href="https://developer.mozilla.org/en-US/Add-ons/Overlay_Extensions"><span>Extensões Overlay</span></a><br>
Extensões que requerem a reinicialização do navegador para instalar, geralmente usando <a href="https://developer.mozilla.org/pt-BR/docs/Mozilla/Tech/XUL/Overlays">overlays XUL</a>.</li>
<li><a href="/en-US/Add-ons/Overlay_Extensions">Extensões Overlay</a><br>
Extensões que requerem a reinicialização do navegador para instalar, geralmente usando <a href="/pt-BR/docs/Mozilla/Tech/XUL/Overlays">overlays XUL</a>.</li>
</ul>

<p>Se você puder, é aconselhável utilizar o Add-on SDK, que usa o mecanismo de extensão restartless mas simplifica determinadas tarefas e limpa depois de si mesmo. Se o Add-on SDK não é suficiente para as suas necessidades, implemente uma extensão restartless manual no lugar.</p>

<p>Para obter mais informações sobre como escolher qual a técnica de usar, leia esta <a href="https://developer.mozilla.org/en-US/Add-ons/Comparing_Extension_Toolchains">comparação</a>.</p>
<p>Para obter mais informações sobre como escolher qual a técnica de usar, leia esta <a href="/en-US/Add-ons/Comparing_Extension_Toolchains">comparação</a>.</p>

<div class="column-container">
<div class="column-half">
<h3 id="Práticas_Recomendadas">Práticas Recomendadas</h3>

<p>Não importa como você desenvolve uma extensão, existem algumas orientações que você pode seguir para ajudar a garantir que sua extensão fornece uma experiência tão boa para o usuário o quão possível.</p>

<dl>
<dt><a href="https://developer.mozilla.org/en-US/Add-ons/Performance_best_practices_in_extensions">Desempenho</a></dt>
<dt><a href="/en-US/Add-ons/Performance_best_practices_in_extensions">Desempenho</a></dt>
<dd>Assegurando que sua extensão é rápida, responsiva e eficiente para a memória.</dd>
<dt><a href="https://developer.mozilla.org/en-US/Add-ons/Security_best_practices_in_extensions">Segurança</a></dt>
<dt><a href="/en-US/Add-ons/Security_best_practices_in_extensions">Segurança</a></dt>
<dd>Assegurando que sua extensão não exponha o usuário para websites maliciosos.</dd>
<dt><a href="https://developer.mozilla.org/en-US/Add-ons/Extension_etiquette">Etiqueta</a></dt>
<dt><a href="/en-US/Add-ons/Extension_etiquette">Etiqueta</a></dt>
<dd>Assegurando que sua extensão funcione bem com outras extensões.</dd>
</dl>
</div>

<div class="column-half">
<h3 id="Aplicativo_específico">Aplicativo específico</h3>

<p>A maioria das documentações assume que você está desenvolvendo para o Firefox Desktop. Se você está desenvolvendo para algum outro aplicativo baseado no Gecko, há diferenças importantes que você precisa saber sobre.</p>

<dl>
<dt><a href="https://developer.mozilla.org/en-US/Add-ons/Thunderbird">Thunderbird</a></dt>
<dt><a href="/en-US/Add-ons/Thunderbird">Thunderbird</a></dt>
<dd>Desenvolvendo extensões para o Thunderbird mail client.</dd>
<dt><a href="https://developer.mozilla.org/en-US/Add-ons/Firefox_for_Android">Firefox para Android</a></dt>
<dt><a href="/en-US/Add-ons/Firefox_for_Android">Firefox para Android</a></dt>
<dd>Desenvolvendo extensões para Firefox para Android.</dd>
<dt><a href="https://developer.mozilla.org/en-US/Add-ons/SeaMonkey_2">SeaMonkey</a></dt>
<dd>Desenvolvendo extensões para <a href="http://www.seamonkey-project.org/">SeaMonkey</a> <span class="short_text" id="result_box" lang="pt"><span class="hps">suíte de</span> <span class="hps">software.</span></span></dd>
<dt><a href="/en-US/Add-ons/SeaMonkey_2">SeaMonkey</a></dt>
<dd>Desenvolvendo extensões para <a href="http://www.seamonkey-project.org/">SeaMonkey</a> suíte de software.</dd>
</dl>
</div>
</div>

<hr>
<h2 id="Temas"><a name="Themes">Temas</a></h2>

<p>Os temas são add-ons que personalizam a IU do aplicativo. Existem dois tipos de temas: temas leves e temas completos.</p>

<div class="column-container">
<div class="column-half">
<p><a href="https://addons.mozilla.org/en-US/developers/docs/themes">Temas Leves</a> são muito mais simples de implementar do que temas completos, mas fornece a personalização muito limitada.</p>
</div>

<div class="column-half">
<p><span id="result_box" lang="pt">Com <a href="https://developer.mozilla.org/en-US/docs/Themes">Temas Completos</a> você pode fazer modificações mais profundas na IU. A documentação para temas completos é fora da data, mas está ligada a aqui como uma possível base para a documentação atualizada.</span></p>
</div>
</div>
<p>Com <a href="/en-US/docs/Themes">Temas Completos</a> você pode fazer modificações mais profundas na IU. A documentação para temas completos é fora da data, mas está ligada a aqui como uma possível base para a documentação atualizada.</p>

<hr>
<h2 id="Outros_tipos_de_complementos">Outros tipos de complementos</h2>

<p><span id="result_box" lang="pt"><a href="/pt-BR/docs/Mozilla/Add-ons/Creating_OpenSearch_plugins_for_Firefox">Plugins de Search Engine</a> são um tipo simples e muito específico de add-on: eles adicionam novos mecanismos de busca para barra de pesquisa do navegador.<br>
<br>
<a href="https://developer.mozilla.org/en-US/docs/Plugins">Plugins</a> ajuda a aplicação a entender o conteúdo web que não é suportado nativamente. Plugins NPAPI são uma tecnologia antiga e os novos sites não devem usá-las. Em geral, os plugins não estão disponíveis na maioria dos sistemas móveis modernos, e os sites devem evitar usar plugins.</span></p>
<a href="/en-US/docs/Plugins">Plugins</a> ajuda a aplicação a entender o conteúdo web que não é suportado nativamente. Plugins NPAPI são uma tecnologia antiga e os novos sites não devem usá-las. Em geral, os plugins não estão disponíveis na maioria dos sistemas móveis modernos, e os sites devem evitar usar plugins.</span></p>
Original file line number Diff line number Diff line change
Expand Up @@ -72,12 +72,6 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

<p>{{Compat("webextensions.api.bookmarks")}}</p>

<div class="hidden note">
<p>A sessão "Chrome incompatibilities" está incluso no <a href="https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities">https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities</a> usando a macro <a href="/en-US/docs/Template:WebExtChromeCompat">WebExtChromeCompat</a>.</p>

<p>Se precisar atualizar este conteúdo, edite <a href="https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities">https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities</a>, então recarregue a página para ver suas alterações.</p>
</div>

<p>{{WebExtExamples("h2")}}</p>

<div class="note"><strong>Agradecimentos</strong>
Expand All @@ -88,7 +82,7 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
</div>

<div class="hidden">
<pre>// Copyright 2015 The Chromium Authors. All rights reserved.
// Copyright 2015 The Chromium Authors. All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
Expand All @@ -115,5 +109,4 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
</pre>
</div>
Original file line number Diff line number Diff line change
Expand Up @@ -81,12 +81,6 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

<p>{{Compat("webextensions.api.browserAction")}}</p>

<div class="hidden note">
<p>A sessão "Chrome incompatibilities" está inclusa em <a href="https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities"> https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities</a> usando a macro <a href="/en-US/docs/Template:WebExtChromeCompat">WebExtChromeCompat</a>.</p>

<p>Se precisar atualizar este conteúdo edite <a href="https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities">https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities</a>, então recarregue esta página para visualizar suas alterações.</p>
</div>

<p>{{WebExtExamples("h2")}}</p>

<div class="note"><strong>Agradecimentos</strong>
Expand All @@ -97,7 +91,7 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
</div>

<div class="hidden">
<pre>// Copyright 2015 The Chromium Authors. All rights reserved.
// Copyright 2015 The Chromium Authors. All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
Expand All @@ -124,5 +118,4 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
</pre>
</div>
Original file line number Diff line number Diff line change
Expand Up @@ -71,12 +71,6 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

<p>{{Compat("webextensions.api.browsingData", 2)}}</p>

<div class="note hidden">
<p>A sessão "incompatibilidades do Chrome" está inclusa pela <a href="https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities"> https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities</a> usando o <a href="/en-US/docs/Template:WebExtChromeCompat">WebExtChromeCompat</a> macro.</p>

<p>Se precisar atualizar este conteúdo, edite <a href="https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities">https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities</a>, então recarregue esta página para visualizar suas alterações.</p>
</div>

<p>{{WebExtExamples("h2")}}</p>

<div class="note"><strong>Agradecimentos</strong>
Expand All @@ -87,7 +81,7 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
</div>

<div class="hidden">
<pre>// Copyright 2015 The Chromium Authors. All rights reserved.
// Copyright 2015 The Chromium Authors. All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
Expand All @@ -114,5 +108,4 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
</pre>
</div>
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
</div>

<div class="hidden">
<pre>// Copyright 2015 The Chromium Authors. All rights reserved.
// Copyright 2015 The Chromium Authors. All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
Expand All @@ -79,5 +79,4 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
</pre>
</div>
Original file line number Diff line number Diff line change
Expand Up @@ -112,13 +112,6 @@ <h2 id="Manipulador_de_eventos">Manipulador de eventos</h2>
<dd>Disparado quando um cookie é criado ou removido.</dd>
</dl>

<dl>
<dd>
<ul>
</ul>
</dd>
</dl>

<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

<p>{{Compat("webextensions.api.cookies")}}</p>
Expand All @@ -131,7 +124,7 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
</div>

<div class="hidden">
<pre>// Copyright 2015 The Chromium Authors. All rights reserved.
// Copyright 2015 The Chromium Authors. All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
Expand All @@ -158,5 +151,4 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
</pre>
</div>
Original file line number Diff line number Diff line change
Expand Up @@ -174,7 +174,7 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
</div>

<div class="hidden">
<pre>// Copyright 2015 The Chromium Authors. All rights reserved.
// Copyright 2015 The Chromium Authors. All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
Expand All @@ -201,5 +201,4 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
</pre>
</div>
Original file line number Diff line number Diff line change
Expand Up @@ -192,7 +192,7 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
</div>

<div class="hidden">
<pre class="notranslate">// Copyright 2015 The Chromium Authors. All rights reserved.
// Copyright 2015 The Chromium Authors. All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
Expand All @@ -219,5 +219,4 @@ <h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
</pre>
</div>
18 changes: 3 additions & 15 deletions files/pt-br/mozilla/add-ons/webextensions/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,6 @@

<p>Se você tem dúvidas ou sugestões, ou precisa de ajuda para migrar um complemento legado para usar APIs WebExtensions, pode entrar em contato conosco pela <a class="external external-icon" href="https://mail.mozilla.org/listinfo/dev-addons">newsletter de desenvolvimento de complementos </a>ou <a href="irc://irc.mozilla.org/webextensions">#webextensions</a> no <a class="external-icon external" href="https://wiki.mozilla.org/IRC">IRC</a>.</p>

<div class="row topicpage-table">
<div class="section">
<h3 id="Começando">Começando</h3>

<ul>
Expand Down Expand Up @@ -104,9 +102,8 @@ <h3 id="Fluxo_de_trabalho_do_Firefox">Fluxo de trabalho do Firefox</h3>
<li><a href="/docs/Mozilla/Add-ons/WebExtensions/Retiring_your_extension">Descontinuando sua extensão</a></li>
<li><a href="/Add-ons/WebExtensions/Tips">Dicas e truques</a></li>
</ul>
</div>

<div class="section">

<h3 id="Referências">Referências</h3>

<h4 id="APIs_JavaScript">APIs JavaScript</h4>
Expand All @@ -116,7 +113,7 @@ <h4 id="APIs_JavaScript">APIs JavaScript</h4>
<li><a href="/Add-ons/WebExtensions/Browser_support_for_JavaScript_APIs">Tabelas de compatibilidade de navegadores com APIs JavaScript</a></li>
</ul>

<div class="twocolumns">{{ ListSubpages ("/en-US/Add-ons/WebExtensions/API") }}</div>
<div>{{ ListSubpages ("/en-US/Add-ons/WebExtensions/API") }}</div>

<h4 id="Chaves_do_Manifest">Chaves do Manifest</h4>

Expand All @@ -125,14 +122,5 @@ <h4 id="Chaves_do_Manifest">Chaves do Manifest</h4>
<li><a href="/docs/Mozilla/Add-ons/WebExtensions/Browser_compatibility_for_manifest.json">Compatibilidade de navegadores com manifest.json</a></li>
</ul>

<div class="twocolumns">{{ ListSubpages ("/Add-ons/WebExtensions/manifest.json") }}</div>
</div>
</div>

<div class="SnapLinksContainer" style="margin-left: 0px; margin-top: 0px; display: none;">
<div class="SL_SelectionRect">
<div class="SL_SelectionLabel"></div>
</div>
</div>

<div>{{ ListSubpages ("/Add-ons/WebExtensions/manifest.json") }}</div>
<div>{{AddonSidebar}}</div>
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
<tr>
<th scope="row">Exemplo</th>
<td>
<pre class="brush: json no-line-numbers">
<pre class="brush: json">
"web_accessible_resources": [
"images/my-image.png"
]</pre>
Expand All @@ -46,19 +46,19 @@ <h3 id="Using_web_accessible_resources">Using web_accessible_resources</h3>

<p>For example, suppose your extension includes an image file at images/my-image.png, like this:</p>

<pre class="no-line-numbers">my-extension-files/
<pre>my-extension-files/
manifest.json
my-background-script.js
images/
my-image.png</pre>

<p>To enable a web page to use an <code><a href="/en-US/docs/Web/HTML/Element/img">&lt;img&gt;</a></code> element whose <code>src</code> attribute points to this image, you would specify <code>web_accessible_resources</code> like this:</p>

<pre class="brush: json no-line-numbers">"web_accessible_resources": ["images/my-image.png"]</pre>
<pre class="brush: json">"web_accessible_resources": ["images/my-image.png"]</pre>

<p>The file is then available using a URL like:</p>

<pre class="no-line-numbers">moz-extension://&lt;extension-UUID&gt;/images/my-image.png"</pre>
<pre>moz-extension://&lt;extension-UUID&gt;/images/my-image.png"</pre>

<p><code>&lt;extension-UUID&gt;</code> is <strong>not</strong> your extension's ID. This ID is randomly generated for every browser instance. This prevents websites from fingerprinting a browser by examining the extensions it has installed.</p>

Expand All @@ -68,7 +68,7 @@ <h3 id="Using_web_accessible_resources">Using web_accessible_resources</h3>

<p>The recommended approach to obtaining the URL of the resource is to use <code><a href="/en-US/Add-ons/WebExtensions/API/runtime/getURL">runtime.getURL</a></code> passing the path relative to manifest.json, for example:</p>

<pre class="brush: js no-line-numbers">browser.runtime.getURL("images/my-image.png");
<pre class="brush: js">browser.runtime.getURL("images/my-image.png");
// something like:
// moz-extension://944cfddf-7a95-3c47-bd9a-663b3ce8d699/images/my-image.png</pre>

Expand All @@ -78,15 +78,15 @@ <h3 id="Wildcards">Wildcards</h3>

<p><code>web_accessible_resources</code> entries can contain wildcards. For example, the following entry would also work to include the resource at "images/my-image.png":</p>

<pre class="brush: json no-line-numbers"> "web_accessible_resources": ["images/*.png"]</pre>
<pre class="brush: json"> "web_accessible_resources": ["images/*.png"]</pre>

<h3 id="Security">Security</h3>

<p>Note that if you make a page web-accessible, any website may link or redirect to that page. The page should then treat any input (POST data, for examples) as if it came from an untrusted source, just as a normal web page should.</p>

<h2 id="Example">Example</h2>

<pre class="brush: json no-line-numbers">"web_accessible_resources": ["images/my-image.png"]</pre>
<pre class="brush: json">"web_accessible_resources": ["images/my-image.png"]</pre>

<p>Make the file at "images/my-image.png" web accessible.</p>

Expand Down
Loading

0 comments on commit d5ac94e

Please sign in to comment.