diff --git a/documentation/content/pt-br/books/fdp-primer/book.adoc b/documentation/content/pt-br/books/fdp-primer/book.adoc index 4607d58591..c19ac3a030 100644 --- a/documentation/content/pt-br/books/fdp-primer/book.adoc +++ b/documentation/content/pt-br/books/fdp-primer/book.adoc @@ -1,98 +1,100 @@ --- add_split_page_link: 'true' authors: - author: 'The FreeBSD Documentation Project' copyright: '1998-2021 DocEng' description: 'Tudo que você precisa saber para começar a contribuir para o Projeto de Documentação do FreeBSD' tags: ["FDP", "documentation", "FreeBSD", "Index"] title: 'Primer do Projeto de Documentação do FreeBSD para Novos Colaboradores' trademarks: ["general"] --- = Primer do Projeto de Documentação do FreeBSD para Novos Colaboradores :doctype: book :toc: macro :toclevels: 2 :icons: font :sectnums: :sectnumlevels: 6 :partnums: :source-highlighter: rouge :experimental: :book: true :pdf: false :images-path: books/fdp-primer/ ifdef::env-beastie[] ifdef::backend-html5[] include::shared/authors.adoc[] include::shared/mirrors.adoc[] include::shared/releases.adoc[] include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists.adoc[] include::shared/{{% lang %}}/urls.adoc[] :chapters-path: content/{{% lang %}}/books/fdp-primer/ endif::[] ifdef::backend-pdf,backend-epub3[] :chapters-path: include::../../../../../shared/asciidoctor.adoc[] endif::[] endif::[] ifndef::env-beastie[] :chapters-path: include::../../../../../shared/asciidoctor.adoc[] endif::[] [.abstract-title] Resumo Obrigado por fazer parte do Projeto de Documentação do FreeBSD. A sua contribuição é extremamente valiosa. Esta cartilha cobre os detalhes necessários para começar a contribuir com o Projeto de Documentação do FreeBSD, incluindo ferramentas, software e a filosofia por trás do Projeto de Documentação. Este documento é um trabalho em andamento. Correções e adições são sempre bem vindas. ''' toc::[] :sectnums!: include::{chapters-path}preface/_index.adoc[leveloffset=+1] :sectnums: include::{chapters-path}overview/_index.adoc[leveloffset=+1] include::{chapters-path}tools/_index.adoc[leveloffset=+1] include::{chapters-path}working-copy/_index.adoc[leveloffset=+1] include::{chapters-path}structure/_index.adoc[leveloffset=+1] include::{chapters-path}doc-build/_index.adoc[leveloffset=+1] include::{chapters-path}asciidoctor-primer/_index.adoc[leveloffset=+1] include::{chapters-path}rosetta/_index.adoc[leveloffset=+1] include::{chapters-path}translations/_index.adoc[leveloffset=+1] include::{chapters-path}po-translations/_index.adoc[leveloffset=+1] include::{chapters-path}manual-pages/_index.adoc[leveloffset=+1] include::{chapters-path}writing-style/_index.adoc[leveloffset=+1] include::{chapters-path}editor-config/_index.adoc[leveloffset=+1] +include::{chapters-path}trademarks/_index.adoc[leveloffset=+1] + include::{chapters-path}see-also/_index.adoc[leveloffset=+1] :sectnums!: include::{chapters-path}examples/_index.adoc[leveloffset=+1] :sectnums: diff --git a/documentation/content/pt-br/books/fdp-primer/doc-build/_index.po b/documentation/content/pt-br/books/fdp-primer/doc-build/_index.po index d865cf3ca8..f36303377c 100644 --- a/documentation/content/pt-br/books/fdp-primer/doc-build/_index.po +++ b/documentation/content/pt-br/books/fdp-primer/doc-build/_index.po @@ -1,1754 +1,1753 @@ # SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. # Danilo G. Baio , 2021, 2022. msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2022-02-01 10:28-0300\n" +"POT-Creation-Date: 2022-07-07 23:22-0300\n" "PO-Revision-Date: 2022-02-06 18:52+0000\n" "Last-Translator: Danilo G. Baio \n" "Language-Team: Portuguese (Brazil) \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" "X-Generator: Weblate 4.10.1\n" #. type: YAML Front Matter: description #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:1 #, no-wrap msgid "Describes the FreeBSD Documentation Build Process" msgstr "Descreve o Processo de Compilação da Documentação do FreeBSD" #. type: YAML Front Matter: title #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:1 #, no-wrap msgid "Chapter 5. The FreeBSD Documentation Build Process" msgstr "Capítulo 5. Processo de Compilação da Documentação do FreeBSD" #. type: Title = #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:13 #, no-wrap msgid "The FreeBSD Documentation Build Process" msgstr "Processo de Compilação da Documentação do FreeBSD" #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:51 msgid "" "This chapter covers organization of the documentation build process and how " "man:make[1] is used to control it." msgstr "" "Este capítulo cobre a organização do processo de compilação da documentação " "e como o man:make[1] é usado para controlá-lo." #. type: Title == #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:53 #, no-wrap msgid "Rendering AsciiDoc into Output" msgstr "Renderizando AsciiDoc" #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:56 msgid "" "Different types of output can be produced from a single AsciiDoc source file." msgstr "" "Diferentes tipos de formato podem ser gerados a partir de um único arquivo " "AsciiDoc." #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:60 #, no-wrap msgid "Formats" msgstr "Formatos" #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:61 #, no-wrap msgid "File Type" msgstr "Tipo de Arquivo" #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:63 #, no-wrap msgid "Description" msgstr "Descrição" #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:64 #, no-wrap msgid "`html`" msgstr "`html`" #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:65 #, no-wrap msgid "HTML" msgstr "HTML" #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:67 #, no-wrap msgid "An `article` or `book` chapter." msgstr "Um capítulo de `artigo` ou `livro`." #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:68 #, no-wrap msgid "`pdf`" msgstr "`pdf`" #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:69 #, no-wrap msgid "PDF" msgstr "PDF" #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:71 #, no-wrap msgid "Portable Document Format." msgstr "Portable Document Format." #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:72 #, no-wrap msgid "`epub`" msgstr "`epub`" #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:73 #, no-wrap msgid "EPUB" msgstr "EPUB" #. type: Table #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:75 #, no-wrap msgid "" "Electronic Publication.\n" "ePub file format." msgstr "" "Electronic Publication.\n" "ePub file format." #. type: Title === #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:78 #, no-wrap msgid "Rendering to html" msgstr "Renderizando em html" #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:81 msgid "" "To render the documentation and the website to `html` use one of the " "following examples." msgstr "" "Para renderizar a documentação e o site em `html`, use um dos seguintes " "exemplos." #. type: Block title #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:83 #, no-wrap msgid "Build the documentation" msgstr "Compile a documentação" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:90 #, no-wrap msgid "" "% cd ~/doc/documentation\n" "% make\n" msgstr "" "% cd ~/doc/documentation\n" "% make\n" #. type: Block title #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:94 #, no-wrap msgid "Build the website" msgstr "Compile o website" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:101 #, no-wrap msgid "" "% cd ~/doc/website\n" "% make\n" msgstr "" "% cd ~/doc/website\n" "% make\n" #. type: Block title #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:105 #, no-wrap msgid "Build the entire documentation project" msgstr "Compile todo o projeto de documentação" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:112 #, no-wrap msgid "" "% cd ~/doc\n" "% make -j2\n" msgstr "" "% cd ~/doc\n" "% make -j2\n" #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:116 msgid "Advanced build examples are given below:" msgstr "Exemplos avançados de compilação são apresentados abaixo:" #. type: Block title #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:118 #, no-wrap msgid "Build the documentation with verbose and debug messages" msgstr "Compile a documentação com mensagens de debug e no modo verboso" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:125 #, no-wrap msgid "" "% cd ~/doc/documentation\n" "% make HUGO_ARGS=\"--verbose --debug --path-warnings\"\n" msgstr "" "% cd ~/doc/documentation\n" "% make HUGO_ARGS=\"--verbose --debug --path-warnings\"\n" #. type: Block title #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:129 #, no-wrap msgid "Build and serve the content with Hugo’s internal webserver" msgstr "Compile e sirva o conteúdo com o servidor web interno do Hugo" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:136 #, no-wrap msgid "" "% cd ~/doc/documentation\n" "% make run\n" msgstr "" "% cd ~/doc/documentation\n" "% make run\n" #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:138 msgid "This webserver runs on `localhost`, port `1313` by default." msgstr "Este servidor web roda em `localhost`, porta`1313` por padrão." #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:140 msgid "" "To serve the content with Hugo’s internal webserver binding a specific IP " "address:" msgstr "" "Para servir o conteúdo com o servidor web interno do Hugo em um endereço IP " "específico:" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:144 #, no-wrap msgid "% make run BIND=192.168.15.10\n" msgstr "% make run BIND=192.168.15.10\n" #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:147 msgid "A `hostname` can also be set as base url to Hugo’s internal webserver:" msgstr "" "Um `hostname` também pode ser definido como url base para o servidor web " "interno do Hugo:" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:151 #, no-wrap msgid "% make run BIND=192.168.15.10 HOSTNAME=example.com\n" msgstr "% make run BIND=192.168.15.10 HOSTNAME=example.com\n" #. type: Title === #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:155 #, no-wrap msgid "Rendering to pdf" msgstr "Renderizando em pdf" #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:158 msgid "" "To render the documentation to `pdf`, use one of the following examples." msgstr "Para gerar a documentação em `pdf`, use um dos seguintes exemplos." #. type: Block title #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:160 #, no-wrap msgid "Build all documents in pdf" msgstr "Compilar todos os documentos em pdf" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:167 #, no-wrap msgid "" "% cd ~/doc/documentation\n" "% make pdf\n" msgstr "" "% cd ~/doc/documentation\n" "% make pdf\n" #. type: Block title #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:171 #, no-wrap msgid "Build all articles in pdf" msgstr "Compilar todos os artigos em pdf" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:178 #, no-wrap msgid "" "% cd ~/doc/documentation\n" "% make pdf-articles\n" msgstr "" "% cd ~/doc/documentation\n" "% make pdf-articles\n" #. type: Block title #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:182 #, no-wrap msgid "Build all books in pdf" msgstr "Compilar todos os livros em pdf" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:189 #, no-wrap msgid "" "% cd ~/doc/documentation\n" "% make pdf-books\n" msgstr "" "% cd ~/doc/documentation\n" "% make pdf-books\n" #. type: Block title #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:193 #, no-wrap msgid "Build documents in pdf for specific languages" msgstr "Compilar todos os documentos em pdf de um idioma em específico" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:200 #, no-wrap msgid "" "% cd ~/doc/documentation\n" "% make DOC_LANG=\"en\" pdf\n" msgstr "" "% cd ~/doc/documentation\n" "% make DOC_LANG=\"en\" pdf\n" #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:202 msgid "This will build all English documents in pdf." msgstr "Este comando irá compilar todos os documentos em pdf do idioma Inglês." #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:207 #, no-wrap msgid "" "% cd ~/doc/documentation\n" "% make DOC_LANG=\"en fr\" pdf-books\n" msgstr "" "% cd ~/doc/documentation\n" "% make DOC_LANG=\"en fr\" pdf-books\n" #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:209 msgid "This will build all English and French books in pdf." msgstr "" "Este comando irá compilar todos os livros em pdf dos idiomas Inglês e " "Francês." #. type: Title == #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:212 #, no-wrap msgid "The FreeBSD Documentation Build Toolset" msgstr "O Conjunto de Ferramentas de Compilação da Documentação do FreeBSD" #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:215 msgid "These are the tools used to build and install the FDP documentation." msgstr "" "Essas são as ferramentas usadas para compilar e instalar a documentação FDP." #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:217 msgid "The primary build tool is man:make[1], specifically Berkeley Make." msgstr "" "A principal ferramenta de compilação é o man:make[1], especificamente o " "Berkeley Make." #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:218 msgid "Hugo" msgstr "Hugo" #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:219 msgid "AsciiDoctor" msgstr "AsciiDoctor" #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:220 msgid "Git" msgstr "Git" #. type: Title == #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:222 #, no-wrap msgid "Understanding the Makefile in the Documentation Tree" msgstr "Compreendendo o Makefile na Árvore de Documentação" #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:225 msgid "" "There are three [.filename]#Makefile# files for building some or all of the " "documentation project." msgstr "" "Existem três arquivos [.filename]#Makefile# para compilar em parte ou todo o " "projeto de documentação." #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:227 msgid "" "The [.filename]#Makefile# in the [.filename]#documentation# directory will " "build only the documentation." msgstr "" "O [.filename]#Makefile# no diretório [.filename]#documentation# irá compilar " "apenas a documentação." #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:228 msgid "" "The [.filename]#Makefile# in the [.filename]#website# directory will build " "only the website." msgstr "" "O [.filename]#Makefile# no diretório [.filename]#website# irá compilar " "apenas a website." #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:229 msgid "" "The [.filename]#Makefile# at the top of the tree will build both the " "documentation and the website." msgstr "O [.filename]#Makefile# na raíz irá compilar a documentação e o site." #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:232 msgid "" "The [.filename]#Makefile# appearing in subdirectories also support `make " "run` to serve built content with Hugo's internal webserver. This webserver " "runs on port 1313 by default." msgstr "" "O [.filename]#Makefile# dos subdiretórios também suportam `make run` para " "servir o conteúdo compilado com o servidor web interno do Hugo. Este " "servidor web roda na porta 1313 por padrão." #. type: Title === #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:234 #, no-wrap msgid "Documentation Makefile" msgstr "Makefile da Documentação" #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:237 msgid "This [.filename]#Makefile# takes the following form:" msgstr "Este [.filename]#Makefile# suporta o seguinte:" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:262 #, no-wrap msgid "" "# Generate the FreeBSD documentation\n" "#\n" "# Copyright (c) 2020-2021, The FreeBSD Documentation Project\n" "# Copyright (c) 2020-2021, Sergio Carlavilla \n" "#\n" "# Targets intended for use on the command line\n" "#\n" "# all (default)\t-\tgenerate the books TOC and compile all the documentation\n" "# clean\t\t- \tremoves generated files\n" "# run\t\t-\tserves the built documentation site for local browsing\n" "# pdf\t\t-\tbuild PDF versions of the articles and books.\n" "# html\t\t-\tbuild HTML versions of the articles and books for\n" "#\t\t\toffline use.\n" "#\t\t\tIf variable DOC_HTML_ARCHIVE is set, all documents will be\n" "#\t\t\tarchived/compressed, and only these files will be kept in the public\n" "#\t\t\tdirectory.\n" "# epub\t\t-\tbuild EPUB versions of the articles and books (Experimental).\n" "#\n" "# The run target uses hugo's built-in webserver to make the documentation site\n" "# available for local browsing. The documentation should have been built prior\n" "# to attempting to use the `run` target. By default, hugo will start its\n" "# webserver on port 1313.\n" msgstr "" "# Generate the FreeBSD documentation\n" "#\n" "# Copyright (c) 2020-2021, The FreeBSD Documentation Project\n" "# Copyright (c) 2020-2021, Sergio Carlavilla \n" "#\n" "# Targets intended for use on the command line\n" "#\n" "# all (default)\t-\tgenerate the books TOC and compile all the documentation\n" "# clean\t\t- \tremoves generated files\n" "# run\t\t-\tserves the built documentation site for local browsing\n" "# pdf\t\t-\tbuild PDF versions of the articles and books.\n" "# html\t\t-\tbuild HTML versions of the articles and books for\n" "#\t\t\toffline use.\n" "#\t\t\tIf variable DOC_HTML_ARCHIVE is set, all documents will be\n" "#\t\t\tarchived/compressed, and only these files will be kept in the public\n" "#\t\t\tdirectory.\n" "# epub\t\t-\tbuild EPUB versions of the articles and books (Experimental).\n" "#\n" "# The run target uses hugo's built-in webserver to make the documentation site\n" "# available for local browsing. The documentation should have been built prior\n" "# to attempting to use the `run` target. By default, hugo will start its\n" "# webserver on port 1313.\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:264 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:546 #, no-wrap msgid "MAINTAINER=carlavilla@FreeBSD.org <.>\n" msgstr "MAINTAINER=carlavilla@FreeBSD.org <.>\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:269 #, no-wrap msgid "" "# List of languages without book translations\n" "ARTICLEONLY_LANGS=\tbn-bd da ko tr\n" "# List of languages without article translations\n" "BOOKONLY_LANGS=\t\tmn\n" msgstr "" "# List of languages without book translations\n" "ARTICLEONLY_LANGS=\tbn-bd da ko tr\n" "# List of languages without article translations\n" "BOOKONLY_LANGS=\t\tmn\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:272 #, no-wrap msgid "" "# List of all languages we have content for\n" "ALL_LANGUAGES=\tbn-bd da de el en es fr hu it ja ko mn nl pl pt-br ru tr zh-cn zh-tw <.>\n" msgstr "" "# List of all languages we have content for\n" "ALL_LANGUAGES=\tbn-bd da de el en es fr hu it ja ko mn nl pl pt-br ru tr zh-cn zh-tw <.>\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:274 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:551 #, no-wrap msgid "LOCALBASE?=\t/usr/local\n" msgstr "LOCALBASE?=\t/usr/local\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:281 #, no-wrap msgid "" "RUBY_CMD =\t${LOCALBASE}/bin/ruby <.>\n" "HUGO_CMD =\t${LOCALBASE}/bin/hugo <.>\n" "HUGO_ARGS?=\t--verbose --minify\n" "HUGO_OFFLINE_ARGS?= \t--environment offline --verbose --minify\n" "ASCIIDOCTOR_CMD=\t${LOCALBASE}/bin/asciidoctor\n" "ASCIIDOCTORPDF_CMD=\t${LOCALBASE}/bin/asciidoctor-pdf\n" msgstr "" "RUBY_CMD =\t${LOCALBASE}/bin/ruby <.>\n" "HUGO_CMD =\t${LOCALBASE}/bin/hugo <.>\n" "HUGO_ARGS?=\t--verbose --minify\n" "HUGO_OFFLINE_ARGS?= \t--environment offline --verbose --minify\n" "ASCIIDOCTOR_CMD=\t${LOCALBASE}/bin/asciidoctor\n" "ASCIIDOCTORPDF_CMD=\t${LOCALBASE}/bin/asciidoctor-pdf\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:291 #, no-wrap msgid "" ".if defined(DOC_LANG) && !empty(DOC_LANG)\n" "LANGUAGES=\t${DOC_LANG:S/,/ /g}\n" ".if ${LANGUAGES:Men} == \"\" && ${.TARGETS:Mpdf*} == \"\" && ${.TARGETS:Mhtml*} == \"\"\n" ".warning \"Warning: cannot skip 'en'; adding it back\"\n" "LANGUAGES+=\ten\n" ".endif\n" ".else\n" "LANGUAGES=\t${ALL_LANGUAGES}\n" ".endif\n" msgstr "" ".if defined(DOC_LANG) && !empty(DOC_LANG)\n" "LANGUAGES=\t${DOC_LANG:S/,/ /g}\n" ".if ${LANGUAGES:Men} == \"\" && ${.TARGETS:Mpdf*} == \"\" && ${.TARGETS:Mhtml*} == \"\"\n" ".warning \"Warning: cannot skip 'en'; adding it back\"\n" "LANGUAGES+=\ten\n" ".endif\n" ".else\n" "LANGUAGES=\t${ALL_LANGUAGES}\n" ".endif\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:294 #, no-wrap msgid "" "RUBYLIB =\t../shared/lib\n" ".export\tRUBYLIB\n" msgstr "" "RUBYLIB =\t../shared/lib\n" ".export\tRUBYLIB\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:298 #, no-wrap msgid "" "RUN_DEPENDS=\t${HUGO_CMD} \\\n" "\t\t${LOCALBASE}/bin/asciidoctor \\\n" "\t\t${LOCALBASE}/bin/rougify\n" msgstr "" "RUN_DEPENDS=\t${HUGO_CMD} \\\n" "\t\t${LOCALBASE}/bin/asciidoctor \\\n" "\t\t${LOCALBASE}/bin/rougify\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:308 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:567 #, no-wrap msgid "" ".ifndef HOSTNAME\n" ". ifdef BIND\n" ".HOST=$(BIND)\n" ". else\n" ".HOST=localhost\n" ". endif\n" ".else\n" ".HOST=$(HOSTNAME)\n" ".endif\n" msgstr "" ".ifndef HOSTNAME\n" ". ifdef BIND\n" ".HOST=$(BIND)\n" ". else\n" ".HOST=localhost\n" ". endif\n" ".else\n" ".HOST=$(HOSTNAME)\n" ".endif\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:315 #, no-wrap msgid "" "# Strip the languages with only articles from the list of languages we\n" "# will use to build books.\n" "BOOK_LANGS= ${LANGUAGES}\n" ".for a in ${ARTICLEONLY_LANGS}\n" "BOOK_LANGS:=\t${BOOK_LANGS:N${a}}\n" ".endfor\n" msgstr "" "# Strip the languages with only articles from the list of languages we\n" "# will use to build books.\n" "BOOK_LANGS= ${LANGUAGES}\n" ".for a in ${ARTICLEONLY_LANGS}\n" "BOOK_LANGS:=\t${BOOK_LANGS:N${a}}\n" ".endfor\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:322 #, no-wrap msgid "" "# Strip the languages with only books from the list of languages we\n" "# will use to build articles.\n" "ARTICLE_LANGS= ${LANGUAGES}\n" ".for a in ${BOOKONLY_LANGS}\n" "ARTICLE_LANGS:=\t${ARTICLE_LANGS:N${a}}\n" ".endfor\n" msgstr "" "# Strip the languages with only books from the list of languages we\n" "# will use to build articles.\n" "ARTICLE_LANGS= ${LANGUAGES}\n" ".for a in ${BOOKONLY_LANGS}\n" "ARTICLE_LANGS:=\t${ARTICLE_LANGS:N${a}}\n" ".endfor\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:331 #, no-wrap msgid "" "# Take the list of all languages, and take out the ones we have been\n" "# asked for. We'll feed this to hugo.\n" "SKIP_LANGS=\n" ".for a in ${ALL_LANGUAGES}\n" ".if ${LANGUAGES:M${a}} == \"\"\n" "SKIP_LANGS+= ${a}\n" ".endif\n" ".endfor\n" msgstr "" "# Take the list of all languages, and take out the ones we have been\n" "# asked for. We'll feed this to hugo.\n" "SKIP_LANGS=\n" ".for a in ${ALL_LANGUAGES}\n" ".if ${LANGUAGES:M${a}} == \"\"\n" "SKIP_LANGS+= ${a}\n" ".endif\n" ".endfor\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:333 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:588 #, no-wrap msgid ".ORDER: all run <.>\n" msgstr ".ORDER: all run <.>\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:338 #, no-wrap msgid "" ".ORDER: requirements <.>\n" ".ORDER: starting-message\n" ".ORDER: starting-message build\n" ".ORDER: build\n" msgstr "" ".ORDER: requirements <.>\n" ".ORDER: starting-message\n" ".ORDER: starting-message build\n" ".ORDER: build\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:341 #, no-wrap msgid "" "all: requirements starting-message generate-pgpkeys-txt build\n" "run: requirements starting-message generate-pgpkeys-txt run-local\n" msgstr "" "all: requirements starting-message generate-pgpkeys-txt build\n" "run: requirements starting-message generate-pgpkeys-txt run-local\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:344 #, no-wrap msgid "" "# clean does not call pdf-clean as that is a subset of hugo-clean\n" "clean: hugo-clean pgp-clean\n" msgstr "" "# clean does not call pdf-clean as that is a subset of hugo-clean\n" "clean: hugo-clean pgp-clean\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:351 #, no-wrap msgid "" "requirements:\n" ".for dep in ${RUN_DEPENDS}\n" ".if !exists(${dep})\n" "\t@(echo ${dep} not found, please run 'pkg install docproj'; exit 1)\n" ".endif\n" ".endfor\n" msgstr "" "requirements:\n" ".for dep in ${RUN_DEPENDS}\n" ".if !exists(${dep})\n" "\t@(echo ${dep} not found, please run 'pkg install docproj'; exit 1)\n" ".endif\n" ".endfor\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:356 #, no-wrap msgid "" "requirements-pdf:\n" ".if !exists(${LOCALBASE}/bin/asciidoctor-pdf)\n" "\t@(echo ${LOCALBASE}/bin/asciidoctor-pdf not found, please run 'pkg install rubygem-asciidoctor-pdf'; exit 1)\n" ".endif\n" msgstr "" "requirements-pdf:\n" ".if !exists(${LOCALBASE}/bin/asciidoctor-pdf)\n" "\t@(echo ${LOCALBASE}/bin/asciidoctor-pdf not found, please run 'pkg install rubygem-asciidoctor-pdf'; exit 1)\n" ".endif\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:361 #, no-wrap msgid "" "requirements-epub:\n" ".if !exists(${LOCALBASE}/bin/asciidoctor-epub3)\n" "\t@(echo ${LOCALBASE}/bin/asciidoctor-epub3 not found, please run 'pkg install rubygem-asciidoctor-epub3'; exit 1)\n" ".endif\n" msgstr "" "requirements-epub:\n" ".if !exists(${LOCALBASE}/bin/asciidoctor-epub3)\n" "\t@(echo ${LOCALBASE}/bin/asciidoctor-epub3 not found, please run 'pkg install rubygem-asciidoctor-epub3'; exit 1)\n" ".endif\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:368 #, no-wrap msgid "" "starting-message: .PHONY <.>\n" "\t@echo ---------------------------------------------------------------\n" "\t@echo Building the documentation\n" "\t@echo included languages: ${LANGUAGES}\n" "\t@echo excluded languages: ${SKIP_LANGS}\n" "\t@echo ---------------------------------------------------------------\n" msgstr "" "starting-message: .PHONY <.>\n" "\t@echo ---------------------------------------------------------------\n" "\t@echo Building the documentation\n" "\t@echo included languages: ${LANGUAGES}\n" "\t@echo excluded languages: ${SKIP_LANGS}\n" "\t@echo ---------------------------------------------------------------\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:370 #, no-wrap msgid "generate-pgpkeys-txt: static/pgpkeys/pgpkeys.txt\n" msgstr "generate-pgpkeys-txt: static/pgpkeys/pgpkeys.txt\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:373 #, no-wrap msgid "" "static/pgpkeys/pgpkeys.txt: static/pgpkeys/*key\n" "\t${RUBY_CMD} ./tools/global-pgpkeys-creator.rb\n" msgstr "" "static/pgpkeys/pgpkeys.txt: static/pgpkeys/*key\n" "\t${RUBY_CMD} ./tools/global-pgpkeys-creator.rb\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:377 #, no-wrap msgid "" "run-local: .PHONY <.>\n" "\tHUGO_DISABLELANGUAGES=\"${SKIP_LANGS}\" ${HUGO_CMD} server \\\n" "\t\t${HUGO_ARGS} -D $(BIND:D--bind=$(BIND)) --baseURL=\"http://$(.HOST):1313\"\n" msgstr "" "run-local: .PHONY <.>\n" "\tHUGO_DISABLELANGUAGES=\"${SKIP_LANGS}\" ${HUGO_CMD} server \\\n" "\t\t${HUGO_ARGS} -D $(BIND:D--bind=$(BIND)) --baseURL=\"http://$(.HOST):1313\"\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:380 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:622 #, no-wrap msgid "" "build: .PHONY <.>\n" "\tHUGO_DISABLELANGUAGES=\"${SKIP_LANGS}\" ${HUGO_CMD} ${HUGO_ARGS}\n" msgstr "" "build: .PHONY <.>\n" "\tHUGO_DISABLELANGUAGES=\"${SKIP_LANGS}\" ${HUGO_CMD} ${HUGO_ARGS}\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:383 #, no-wrap msgid "" "build-offline: .PHONY\n" "\tHUGO_DISABLELANGUAGES=\"${SKIP_LANGS}\" ${HUGO_CMD} ${HUGO_OFFLINE_ARGS}\n" msgstr "" "build-offline: .PHONY\n" "\tHUGO_DISABLELANGUAGES=\"${SKIP_LANGS}\" ${HUGO_CMD} ${HUGO_OFFLINE_ARGS}\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:386 #, no-wrap msgid "" "pgp-clean: .PHONY\n" "\trm -f static/pgpkeys/pgpkeys.txt\n" msgstr "" "pgp-clean: .PHONY\n" "\trm -f static/pgpkeys/pgpkeys.txt\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:389 #, no-wrap msgid "" "hugo-clean: .PHONY\n" "\trm -rf resources public\n" msgstr "" "hugo-clean: .PHONY\n" "\trm -rf resources public\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:395 #, no-wrap msgid "" "#\n" "# PDF targets\n" "# Use DOC_LANG to choose the language, e.g., make DOC_LANG=\"en fr\" pdf-books\n" "#\n" "pdf: pdf-articles pdf-books\n" msgstr "" "#\n" "# PDF targets\n" "# Use DOC_LANG to choose the language, e.g., make DOC_LANG=\"en fr\" pdf-books\n" "#\n" "pdf: pdf-articles pdf-books\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:400 #, no-wrap msgid "" "pdf-books: requirements-pdf\n" ".for _lang in ${BOOK_LANGS}\n" "\t./tools/asciidoctor.sh books ${_lang} pdf\n" ".endfor\n" msgstr "" "pdf-books: requirements-pdf\n" ".for _lang in ${BOOK_LANGS}\n" "\t./tools/asciidoctor.sh books ${_lang} pdf\n" ".endfor\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:405 #, no-wrap msgid "" "pdf-articles: requirements-pdf\n" ".for _lang in ${ARTICLE_LANGS}\n" "\t./tools/asciidoctor.sh articles ${_lang} pdf\n" ".endfor\n" msgstr "" "pdf-articles: requirements-pdf\n" ".for _lang in ${ARTICLE_LANGS}\n" "\t./tools/asciidoctor.sh articles ${_lang} pdf\n" ".endfor\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:407 #, no-wrap msgid "pdf-clean: pdf-articles-clean pdf-books-clean\n" msgstr "pdf-clean: pdf-articles-clean pdf-books-clean\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:414 #, no-wrap msgid "" "pdf-books-clean:\n" ".for _lang in ${BOOK_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/books\n" "\t-rmdir ${.CURDIR}/public/${_lang}\n" ".endfor\n" "\t-rmdir ${.CURDIR}/public/\n" msgstr "" "pdf-books-clean:\n" ".for _lang in ${BOOK_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/books\n" "\t-rmdir ${.CURDIR}/public/${_lang}\n" ".endfor\n" "\t-rmdir ${.CURDIR}/public/\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:423 #, no-wrap msgid "" "pdf-articles-clean:\n" ".for _lang in ${ARTICLE_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/articles\n" ".if !exists(${.CURDIR}/public/${_lang}/books)\n" "\trm -fr ${.CURDIR}/public/${_lang}\n" ".endif\n" ".endfor\n" "\t-rmdir ${.CURDIR}/public\n" msgstr "" "pdf-articles-clean:\n" ".for _lang in ${ARTICLE_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/articles\n" ".if !exists(${.CURDIR}/public/${_lang}/books)\n" "\trm -fr ${.CURDIR}/public/${_lang}\n" ".endif\n" ".endfor\n" "\t-rmdir ${.CURDIR}/public\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:428 #, no-wrap msgid "" "#\n" "# HTML targets\n" "#\n" "html: build-offline html-clean-global html-clean-articles html-clean-books html-archive html-archive-clean-files\n" msgstr "" "#\n" "# HTML targets\n" "#\n" "html: build-offline html-clean-global html-clean-articles html-clean-books html-archive html-archive-clean-files\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:430 #, no-wrap msgid "html-clean: hugo-clean\n" msgstr "html-clean: hugo-clean\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:434 #, no-wrap msgid "" "html-clean-global:\n" "\trm -fr ${.CURDIR}/public/index.html\n" "\trm -rf pgpkeys js\n" msgstr "" "html-clean-global:\n" "\trm -fr ${.CURDIR}/public/index.html\n" "\trm -rf pgpkeys js\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:440 #, no-wrap msgid "" "html-clean-articles:\n" ".for _lang in ${ARTICLE_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/index.html\n" "\trm -fr ${.CURDIR}/public/${_lang}/articles/index.html\n" ".endfor\n" msgstr "" "html-clean-articles:\n" ".for _lang in ${ARTICLE_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/index.html\n" "\trm -fr ${.CURDIR}/public/${_lang}/articles/index.html\n" ".endfor\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:445 #, no-wrap msgid "" "html-clean-books:\n" ".for _lang in ${BOOK_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/books/index.html\n" ".endfor\n" msgstr "" "html-clean-books:\n" ".for _lang in ${BOOK_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/books/index.html\n" ".endfor\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:455 #, no-wrap msgid "" "html-archive:\n" ".if defined(DOC_HTML_ARCHIVE)\n" ".for _lang in ${ARTICLE_LANGS}\n" "\t./tools/asciidoctor.sh articles ${_lang} archive\n" ".endfor\n" ".for _lang in ${BOOK_LANGS}\n" "\t./tools/asciidoctor.sh books ${_lang} archive\n" ".endfor\n" ".endif\n" msgstr "" "html-archive:\n" ".if defined(DOC_HTML_ARCHIVE)\n" ".for _lang in ${ARTICLE_LANGS}\n" "\t./tools/asciidoctor.sh articles ${_lang} archive\n" ".endfor\n" ".for _lang in ${BOOK_LANGS}\n" "\t./tools/asciidoctor.sh books ${_lang} archive\n" ".endfor\n" ".endif\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:461 #, no-wrap msgid "" "html-archive-clean-files:\n" ".if defined(DOC_HTML_ARCHIVE)\n" "\tfind ${.CURDIR}/public/ ! -name '*.pdf' ! -name '*.tar.gz' -type f -delete\n" "\tfind ${.CURDIR}/public/ -type d -empty -delete\n" ".endif\n" msgstr "" "html-archive-clean-files:\n" ".if defined(DOC_HTML_ARCHIVE)\n" "\tfind ${.CURDIR}/public/ ! -name '*.pdf' ! -name '*.tar.gz' -type f -delete\n" "\tfind ${.CURDIR}/public/ -type d -empty -delete\n" ".endif\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:467 #, no-wrap msgid "" "#\n" "# EPUB targets\n" "# Use DOC_LANG to choose the language, e.g., make DOC_LANG=\"en fr\" epub-books\n" "#\n" "epub: epub-articles epub-books\n" msgstr "" "#\n" "# EPUB targets\n" "# Use DOC_LANG to choose the language, e.g., make DOC_LANG=\"en fr\" epub-books\n" "#\n" "epub: epub-articles epub-books\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:480 #, no-wrap msgid "" "epub-books: requirements-epub\n" "\t@echo ---------------------------------------------------------------\n" "\t@echo !!! EPUB output is experimental !!!\n" "\t@echo\n" "\t@echo Asciidoctor EPUB3 is currently alpha software. Use accordingly. Although the\n" "\t@echo bulk of AsciiDoc content is converted, there’s still work needed to fill in\n" "\t@echo gaps where conversion is incomplete or unstyled.\n" "\t@echo https://docs.asciidoctor.org/epub3-converter/latest/#project-status\n" "\t@echo ---------------------------------------------------------------\n" ".for _lang in ${BOOK_LANGS}\n" "\t./tools/asciidoctor.sh books ${_lang} epub\n" ".endfor\n" msgstr "" "epub-books: requirements-epub\n" "\t@echo ---------------------------------------------------------------\n" "\t@echo !!! EPUB output is experimental !!!\n" "\t@echo\n" "\t@echo Asciidoctor EPUB3 is currently alpha software. Use accordingly. Although the\n" "\t@echo bulk of AsciiDoc content is converted, there’s still work needed to fill in\n" "\t@echo gaps where conversion is incomplete or unstyled.\n" "\t@echo https://docs.asciidoctor.org/epub3-converter/latest/#project-status\n" "\t@echo ---------------------------------------------------------------\n" ".for _lang in ${BOOK_LANGS}\n" "\t./tools/asciidoctor.sh books ${_lang} epub\n" ".endfor\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:493 #, no-wrap msgid "" "epub-articles: requirements-epub\n" "\t@echo ---------------------------------------------------------------\n" "\t@echo !!! EPUB output is experimental !!!\n" "\t@echo\n" "\t@echo Asciidoctor EPUB3 is currently alpha software. Use accordingly. Although the\n" "\t@echo bulk of AsciiDoc content is converted, there’s still work needed to fill in\n" "\t@echo gaps where conversion is incomplete or unstyled.\n" "\t@echo https://docs.asciidoctor.org/epub3-converter/latest/#project-status\n" "\t@echo ---------------------------------------------------------------\n" ".for _lang in ${ARTICLE_LANGS}\n" "\t./tools/asciidoctor.sh articles ${_lang} epub\n" ".endfor\n" msgstr "" "epub-articles: requirements-epub\n" "\t@echo ---------------------------------------------------------------\n" "\t@echo !!! EPUB output is experimental !!!\n" "\t@echo\n" "\t@echo Asciidoctor EPUB3 is currently alpha software. Use accordingly. Although the\n" "\t@echo bulk of AsciiDoc content is converted, there’s still work needed to fill in\n" "\t@echo gaps where conversion is incomplete or unstyled.\n" "\t@echo https://docs.asciidoctor.org/epub3-converter/latest/#project-status\n" "\t@echo ---------------------------------------------------------------\n" ".for _lang in ${ARTICLE_LANGS}\n" "\t./tools/asciidoctor.sh articles ${_lang} epub\n" ".endfor\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:495 #, no-wrap msgid "epub-clean: epub-articles-clean epub-books-clean\n" msgstr "epub-clean: epub-articles-clean epub-books-clean\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:502 #, no-wrap msgid "" "epub-books-clean:\n" ".for _lang in ${BOOK_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/books\n" "\t-rmdir ${.CURDIR}/public/${_lang}\n" ".endfor\n" "\t-rmdir ${.CURDIR}/public/\n" msgstr "" "epub-books-clean:\n" ".for _lang in ${BOOK_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/books\n" "\t-rmdir ${.CURDIR}/public/${_lang}\n" ".endfor\n" "\t-rmdir ${.CURDIR}/public/\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:511 #, no-wrap msgid "" "epub-articles-clean:\n" ".for _lang in ${ARTICLE_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/articles\n" ".if !exists(${.CURDIR}/public/${_lang}/books)\n" "\trm -fr ${.CURDIR}/public/${_lang}\n" ".endif\n" ".endfor\n" "\t-rmdir ${.CURDIR}/public\n" msgstr "" "epub-articles-clean:\n" ".for _lang in ${ARTICLE_LANGS}\n" "\trm -fr ${.CURDIR}/public/${_lang}/articles\n" ".if !exists(${.CURDIR}/public/${_lang}/books)\n" "\trm -fr ${.CURDIR}/public/${_lang}\n" ".endif\n" ".endfor\n" "\t-rmdir ${.CURDIR}/public\n" #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:514 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:636 msgid "The `MAINTAINER` flag specifies who is the maintainer of this Makefile." msgstr "A flag `MAINTAINER` especifica quem é o mantenedor deste Makefile." #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:515 msgid "" "`ALL_LANGUAGES` flag specifies in which languages the table of contents has " "to be generated." msgstr "" "A flag `ALL_LANGUAGES` especifica em quais idiomas o índice deve ser gerado." #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:516 -msgid "`RUBY_CMD` flag specifies the location of the Python binary." +#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:637 +msgid "`RUBY_CMD` flag specifies the location of the Ruby binary." msgstr "A flag `RUBY_CMD` especifica a localização do binário Ruby." #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:517 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:638 msgid "`HUGO_CMD` flag specifies the location of the Hugo binary." msgstr "A flag `HUGO_CMD` especifica a localização do binário Hugo." #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:518 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:639 msgid "" "`.ORDER` directives are used to ensure multiple make jobs may run without " "problem." msgstr "" "As diretivas `.ORDER` são usadas para garantir que vários makes possam ser " "executados sem problemas." #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:519 msgid "" "`all` target builds the documentation and puts the result in *~/doc/" "documentation/public*." msgstr "" "O target `all` gera os índices dos livros (\"TOCs\"), compila a documentação " "e coloca o resultado em *~/doc/documentation/public*." #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:520 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:641 msgid "" "`starting-message` shows a message in the CLI to show the user that the " "process is running." msgstr "" "`starting-message` mostra uma mensagem no console para mostrar ao usuário " "que o processo está em execução." #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:521 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:644 msgid "" "`run-local` runs hugo webserver on port 1313, or a random free port if that " "is already in use." msgstr "" "`run-local` executa o servidor web hugo na porta 1313, ou uma porta livre " "aleatória se esta já estiver em uso." #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:522 msgid "" "`build` builds the documentation and puts the result in the *~/doc/" "documentation/public*." msgstr "" "`build` compila a documentação e coloca o resultado em *~/doc/documentation/" "public*." #. type: Title === #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:524 #, no-wrap msgid "Website Makefile" msgstr "Makefile do Website" #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:527 msgid "This [.filename]#Makefile# takes the form of:" msgstr "Este é o [.filename]#Makefile#:" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:544 #, no-wrap msgid "" "# Generate the FreeBSD website\n" "#\n" "# Copyright (c) 2020-2021, The FreeBSD Documentation Project\n" "# Copyright (c) 2020-2021, Sergio Carlavilla \n" "#\n" "# Targets intended for use on the command line\n" "#\n" "# all (default)\t-\tgenerate the releases.toml and compile all the website\n" "# run\t-\t\t\tserves the built website for local browsing\n" "#\n" "# The run target uses hugo's built-in webserver to make the built website\n" "# available for local browsing. The website should have been built prior\n" "# to attempting to use the `run` target. By default, hugo will start its\n" "# webserver on port 1313.\n" msgstr "" "# Generate the FreeBSD website\n" "#\n" "# Copyright (c) 2020-2021, The FreeBSD Documentation Project\n" "# Copyright (c) 2020-2021, Sergio Carlavilla \n" "#\n" "# Targets intended for use on the command line\n" "#\n" "# all (default)\t-\tgenerate the releases.toml and compile all the website\n" "# run\t-\t\t\tserves the built website for local browsing\n" "#\n" "# The run target uses hugo's built-in webserver to make the built website\n" "# available for local browsing. The website should have been built prior\n" "# to attempting to use the `run` target. By default, hugo will start its\n" "# webserver on port 1313.\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:549 #, no-wrap msgid "" "# List of all languages we have content for\n" "ALL_LANGUAGES=\tde el en es fr hu it ja nl ru tr zh-cn zh-tw\n" msgstr "" "# List of all languages we have content for\n" "ALL_LANGUAGES=\tde el en es fr hu it ja nl ru tr zh-cn zh-tw\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:557 #, no-wrap msgid "" "RUBY_CMD =\t${LOCALBASE}/bin/ruby <.>\n" "HUGO_CMD =\t${LOCALBASE}/bin/hugo <.>\n" "HUGO_ARGS?=\t--verbose\n" "RUBYLIB =\t../shared/lib\n" ".export\tRUBYLIB\n" msgstr "" "RUBY_CMD =\t${LOCALBASE}/bin/ruby <.>\n" "HUGO_CMD =\t${LOCALBASE}/bin/hugo <.>\n" "HUGO_ARGS?=\t--verbose\n" "RUBYLIB =\t../shared/lib\n" ".export\tRUBYLIB\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:577 #, no-wrap msgid "" ".if defined(DOC_LANG) && !empty(DOC_LANG)\n" "LANGUAGES= ${DOC_LANG:S/,/ /g}\n" ".if ${LANGUAGES:Men} == \"\"\n" ".warning \"Warning: cannot skip 'en'; adding it back\"\n" "LANGUAGES+=\ten\n" ".endif\n" ".else\n" "LANGUAGES=\t${ALL_LANGUAGES}\n" ".endif\n" msgstr "" ".if defined(DOC_LANG) && !empty(DOC_LANG)\n" "LANGUAGES= ${DOC_LANG:S/,/ /g}\n" ".if ${LANGUAGES:Men} == \"\"\n" ".warning \"Warning: cannot skip 'en'; adding it back\"\n" "LANGUAGES+=\ten\n" ".endif\n" ".else\n" "LANGUAGES=\t${ALL_LANGUAGES}\n" ".endif\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:586 #, no-wrap msgid "" "# Take the list of all languages, and take out the ones we have been\n" "# asked for via DOC_LANG. We'll feed this to hugo.\n" "SKIP_LANGS=\n" ".for a in ${ALL_LANGUAGES}\n" ".if ${LANGUAGES:M${a}} == \"\"\n" "SKIP_LANGS+=\t${a}\n" ".endif\n" ".endfor\n" msgstr "" "# Take the list of all languages, and take out the ones we have been\n" "# asked for via DOC_LANG. We'll feed this to hugo.\n" "SKIP_LANGS=\n" ".for a in ${ALL_LANGUAGES}\n" ".if ${LANGUAGES:M${a}} == \"\"\n" "SKIP_LANGS+=\t${a}\n" ".endif\n" ".endfor\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:594 #, no-wrap msgid "" ".ORDER: starting-message generate-releases\n" ".ORDER: starting-message build\n" ".ORDER: generate-releases build\n" ".ORDER: build post-build\n" ".ORDER: post-build end-message\n" msgstr "" ".ORDER: starting-message generate-releases\n" ".ORDER: starting-message build\n" ".ORDER: generate-releases build\n" ".ORDER: build post-build\n" ".ORDER: post-build end-message\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:598 #, no-wrap msgid "" "all: starting-message generate-releases build post-build end-message <.>\n" "run: starting-message generate-releases run-local\n" "clean: hugo-clean releases-clean\n" msgstr "" "all: starting-message generate-releases build post-build end-message <.>\n" "run: starting-message generate-releases run-local\n" "clean: hugo-clean releases-clean\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:605 #, no-wrap msgid "" "starting-message: .PHONY <.>\n" "\t@echo \"---------------------------------------------------------------\"\n" "\t@echo \"Building the website started on $$(date)\"\n" "\t@echo \" included languages: ${LANGUAGES}\"\n" "\t@echo \" excluded languages: ${SKIP_LANGS}\"\n" "\t@echo \"---------------------------------------------------------------\"\n" msgstr "" "starting-message: .PHONY <.>\n" "\t@echo \"---------------------------------------------------------------\"\n" "\t@echo \"Building the website started on $$(date)\"\n" "\t@echo \" included languages: ${LANGUAGES}\"\n" "\t@echo \" excluded languages: ${SKIP_LANGS}\"\n" "\t@echo \"---------------------------------------------------------------\"\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:610 #, no-wrap msgid "" "end-message: .PHONY\n" "\t@echo \"---------------------------------------------------------------\"\n" "\t@echo \"Building the website completed on $$(date)\"\n" "\t@echo \"---------------------------------------------------------------\"\n" msgstr "" "starting-message: .PHONY <.>\n" "\t@echo ---------------------------------------------------------------\n" "\t@echo Building the website\n" "\t@echo ---------------------------------------------------------------\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:612 #, no-wrap msgid "generate-releases: data/releases.toml <.>\n" msgstr "generate-releases: data/releases.toml <.>\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:615 #, no-wrap msgid "" "data/releases.toml:\n" "\t${RUBY_CMD} ./tools/releases-toml.rb\n" msgstr "" "data/releases.toml:\n" "\t${RUBY_CMD} ./tools/releases-toml.rb\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:619 #, no-wrap msgid "" "run-local: .PHONY <.>\n" "\tHUGO_DISABLELANGUAGES=\"${SKIP_LANGS}\" ${HUGO_CMD} server \\\n" "\t ${HUGO_ARGS} -D $(BIND:D--bind=$(BIND)) --baseURL=\"http://$(.HOST):1313\"\n" msgstr "" "run-local: .PHONY <.>\n" "\tHUGO_DISABLELANGUAGES=\"${SKIP_LANGS}\" ${HUGO_CMD} server \\\n" "\t ${HUGO_ARGS} -D $(BIND:D--bind=$(BIND)) --baseURL=\"http://$(.HOST):1313\"\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:624 #, no-wrap msgid "post-build: cgi-permissions\n" msgstr "post-build: cgi-permissions\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:627 #, no-wrap msgid "" "cgi-permissions:\n" "\t@chmod 555 ./public/cgi/*.cgi\n" msgstr "" "cgi-permissions:\n" "\t@chmod 555 ./public/cgi/*.cgi\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:630 #, no-wrap msgid "" "hugo-clean:\n" "\trm -fr public resources\n" msgstr "" "hugo-clean:\n" "\trm -fr public resources\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:633 #, no-wrap msgid "" "releases-clean:\n" "\trm -f data/releases.toml\n" msgstr "" "releases-clean:\n" "\trm -f data/releases.toml\n" -#. type: Plain text -#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:637 -msgid "`RUBY_CMD` flag specifies the location of the Ruby binary." -msgstr "A flag `RUBY_CMD` especifica a localização do binário Ruby." - #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:640 msgid "" "`all` target builds the website and puts the result in *~/doc/website/" "public*." msgstr "" "O target `all` compila o website e coloca o resultado em *~/doc/website/" "public*." #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:643 msgid "" "`generate-releases` calls the script used to convert from AsciiDoc variables " "to TOML variables. With this conversion, the releases variables can be used " "in AsciiDoc and in the Hugo custom templates." msgstr "" "`generate-releases` chama o script usado para converter as variáveis " "AsciiDoc em variáveis TOML. Com esta conversão, as variáveis de releases " "podem ser utilizadas no AsciiDoc e nos templates personalizados do Hugo." #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:644 msgid "" "`build` builds the website and puts the result in the *~/doc/website/public*." msgstr "" "`build` compila o website e coloca o resultado em *~/doc/website/public*." +#~ msgid "`RUBY_CMD` flag specifies the location of the Python binary." +#~ msgstr "A flag `RUBY_CMD` especifica a localização do binário Ruby." + #, no-wrap #~ msgid "" #~ "| Formats\n" #~ "| File Type\n" #~ "| Description\n" #~ "\n" #~ "|`html`\n" #~ "|HTML\n" #~ "|An `article` or `book` chapter.\n" #~ "\n" #~ "|`pdf`\n" #~ "|PDF\n" #~ "|Portable Document Format.\n" #~ "\n" #~ "|`epub`\n" #~ "|EPUB\n" #~ "|Electronic Publication.\n" #~ "ePub file format.\n" #~ msgstr "" #~ "| Formatos\n" #~ "| Tipo de Arquivo\n" #~ "| Descrição\n" #~ "\n" #~ "|`html`\n" #~ "|HTML\n" #~ "|Um capítulo de `artigo` or `livro`.\n" #~ "\n" #~ "|`pdf`\n" #~ "|PDF\n" #~ "|Portable Document Format.\n" #~ "\n" #~ "|`epub`\n" #~ "|EPUB\n" #~ "|Electronic Publication.\n" #~ "ePub file format.\n" #~ msgid "" #~ "include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" #~ "{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists." #~ "adoc[] include::shared/{{% lang %}}/urls.adoc[]" #~ msgstr "" #~ "include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" #~ "{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists." #~ "adoc[] include::shared/{{% lang %}}/urls.adoc[]" #~ msgid "" #~ "To generate a document in `pdf` format use this command. In this example " #~ "the English Handbook will be used. In order to export the document " #~ "correctly all the extensions should be passed using the `-r` argument." #~ msgstr "" #~ "Para gerar um documento no formato `pdf` use este comando. Neste exemplo, " #~ "o Handbook em Inglês será usado. Para exportar o documento corretamente, " #~ "todas as extensões devem ser passadas usando o argumento `-r`." #, no-wrap #~ msgid "" #~ "% cd ~/doc/documentation\n" #~ "% asciidoctor-pdf \\\n" #~ " -r ./shared/lib/man-macro.rb \\\n" #~ " -r ./shared/lib/git-macro.rb \\\n" #~ " -r ./shared/lib/packages-macro.rb \\\n" #~ " -r ./shared/lib/inter-document-references-macro.rb \\\n" #~ " -r ./shared/lib/sectnumoffset-treeprocessor.rb \\\n" #~ " --doctype=book \\\n" #~ " -a skip-front-matter \\\n" #~ " -a pdf-theme=./themes/default-pdf-theme.yml \\\n" #~ " -o /tmp/handbook.pdf \\\n" #~ " content/en/books/handbook/book.adoc\n" #~ msgstr "" #~ "% cd ~/doc/documentation\n" #~ "% asciidoctor-pdf \\\n" #~ " -r ./shared/lib/man-macro.rb \\\n" #~ " -r ./shared/lib/git-macro.rb \\\n" #~ " -r ./shared/lib/packages-macro.rb \\\n" #~ " -r ./shared/lib/inter-document-references-macro.rb \\\n" #~ " -r ./shared/lib/sectnumoffset-treeprocessor.rb \\\n" #~ " --doctype=book \\\n" #~ " -a skip-front-matter \\\n" #~ " -a pdf-theme=./themes/default-pdf-theme.yml \\\n" #~ " -o /tmp/handbook.pdf \\\n" #~ " content/en/books/handbook/book.adoc\n" #~ msgid "" #~ "<.> The `MAINTAINER` flag specifies who is the maintainer of this " #~ "Makefile. <.> `ALL_LANGUAGES` flag specifies in which languages the " #~ "table of contents has to be generated. <.> `RUBY_CMD` flag specifies the " #~ "location of the Python binary. <.> `HUGO_CMD` flag specifies the " #~ "location of the Hugo binary. <.> `.ORDER` directives are used to ensure " #~ "multiple make jobs may run without problem. <.> `all` target builds the " #~ "documentation and puts the result in *~/doc/documentation/public*. <.> " #~ "`starting-message` shows a message in the CLI to show the user that the " #~ "process is running. <.> `run-local` runs hugo webserver on port 1313, or " #~ "a random free port if that is already in use. <.> `build` builds the " #~ "documentation and puts the result in the *~/doc/documentation/public*." #~ msgstr "" #~ "<.> A flag `MAINTAINER` especifica quem é o mantenedor deste Makefile.\n" #~ "<.> A flag `ALL_LANGUAGES` especifica em quais idiomas o índice deve ser " #~ "gerado.\n" #~ "<.> A flag `RUBY_CMD` especifica a localização do binário Ruby.\n" #~ "<.> A flag `HUGO_CMD` especifica a localização do binário Hugo.\n" #~ "<.> As diretivas `.ORDER` são usadas para garantir que vários makes " #~ "possam ser executados sem problemas.\n" #~ "<.> O target `all` gera os índices dos livros (\"TOCs\"), compila a " #~ "documentação e coloca o resultado em *~/doc/documentation/public*.\n" #~ "<.> `starting-message` mostra uma mensagem no console para mostrar ao " #~ "usuário que o processo está em execução.\n" #~ "<.> `run-local` executa o servidor web hugo na porta 1313, ou uma porta " #~ "livre aleatória se esta já estiver em uso.\n" #~ "<.> `build` compila a documentação e coloca o resultado em *~/doc/" #~ "documentation/public*." #~ msgid "" #~ "<.> The `MAINTAINER` flag specifies who is the maintainer of this " #~ "Makefile. <.> `RUBY_CMD` flag specifies the location of the Ruby " #~ "binary. <.> `HUGO_CMD` flag specifies the location of the Hugo binary. " #~ "<.> `.ORDER` directives are used to ensure multiple make jobs may run " #~ "without problem. <.> `all` target builds the website and puts the result " #~ "in *~/doc/website/public*. <.> `starting-message` shows a message in the " #~ "CLI to show the user that the process is running. <.> `generate-" #~ "releases` calls the script used to convert from AsciiDoc variables to " #~ "TOML variables. With this conversion, the releases variables can be used " #~ "in AsciiDoc and in the Hugo custom templates. <.> `run-local` runs hugo " #~ "webserver on port 1313, or a random free port if that is already in use. " #~ "<.> `build` builds the website and puts the result in the *~/doc/website/" #~ "public*." #~ msgstr "" #~ "<.> A flag `MAINTAINER` especifica quem é o mantenedor deste Makefile.\n" #~ "<.> A flag `RUBY_CMD` especifica a localização do binário Ruby.\n" #~ "<.> A flag `HUGO_CMD` especifica a localização do binário Hugo.\n" #~ "<.> As diretivas `.ORDER` são usadas para garantir que vários makes " #~ "possam ser executados sem problemas.\n" #~ "<.> O target `all` gera os índices dos livros (\"TOCs\"), compila a " #~ "documentação e coloca o resultado em *~/doc/website/public*.\n" #~ "<.> `starting-message` mostra uma mensagem no console para mostrar ao " #~ "usuário que o processo está em execução.\n" #~ "<.> `generate-releases` chama o script usado para converter as variáveis " #~ "AsciiDoc em variáveis TOML.\n" #~ "Com esta conversão, as variáveis de releases podem ser utilizadas no " #~ "AsciiDoc e nos templates personalizados do Hugo.\n" #~ "<.> `run-local` executa o servidor web hugo na porta 1313, ou uma porta " #~ "livre aleatória se esta já estiver em uso.\n" #~ "<.> `build` compila o website e coloca o resultado em *~/doc/website/" #~ "public*." #~ msgid "" #~ "Python is used to generate the Table of Contents and other related Tables." #~ msgstr "Python é usado para gerar o Índice e outras Tabelas relacionadas." #, no-wrap #~ msgid "" #~ "PYTHON_CMD =\t/usr/local/bin/python3 <.>\n" #~ "HUGO_CMD =\t/usr/local/bin/hugo <.>\n" #~ "LANGUAGES =\ten,es,pt_BR,de,ja,zh_CN,zh_TW,ru,el,hu,it,mn,nl,pl,fr <.>\n" #~ "RUBYLIB =\t../shared/lib\n" #~ ".export\tRUBYLIB\n" #~ msgstr "" #~ "PYTHON_CMD =\t/usr/local/bin/python3 <.>\n" #~ "HUGO_CMD =\t/usr/local/bin/hugo <.>\n" #~ "LANGUAGES =\ten,es,pt_BR,de,ja,zh_CN,zh_TW,ru,el,hu,it,mn,nl,pl,fr <.>\n" #~ "RUBYLIB =\t../shared/lib\n" #~ ".export\tRUBYLIB\n" #, no-wrap #~ msgid "" #~ ".ORDER: starting-message generate-books-toc\n" #~ ".ORDER: starting-message build\n" #~ ".ORDER: generate-books-toc build\n" #~ msgstr "" #~ ".ORDER: starting-message generate-books-toc\n" #~ ".ORDER: starting-message build\n" #~ ".ORDER: generate-books-toc build\n" #, no-wrap #~ msgid "all: starting-message generate-books-toc build <.>\n" #~ msgstr "all: starting-message generate-books-toc build <.>\n" #, no-wrap #~ msgid "" #~ "generate-books-toc: .PHONY <.>\n" #~ "\t${PYTHON_CMD} ./tools/books-toc-parts-creator.py -l ${LANGUAGES}\n" #~ "\t${PYTHON_CMD} ./tools/books-toc-creator.py -l ${LANGUAGES}\n" #~ "\t${PYTHON_CMD} ./tools/books-toc-figures-creator.py -l ${LANGUAGES}\n" #~ "\t${PYTHON_CMD} ./tools/books-toc-tables-creator.py -l ${LANGUAGES}\n" #~ "\t${PYTHON_CMD} ./tools/books-toc-examples-creator.py -l ${LANGUAGES}\n" #~ msgstr "" #~ "generate-books-toc: .PHONY <.>\n" #~ "\t${PYTHON_CMD} ./tools/books-toc-parts-creator.py -l ${LANGUAGES}\n" #~ "\t${PYTHON_CMD} ./tools/books-toc-creator.py -l ${LANGUAGES}\n" #~ "\t${PYTHON_CMD} ./tools/books-toc-figures-creator.py -l ${LANGUAGES}\n" #~ "\t${PYTHON_CMD} ./tools/books-toc-tables-creator.py -l ${LANGUAGES}\n" #~ "\t${PYTHON_CMD} ./tools/books-toc-examples-creator.py -l ${LANGUAGES}\n" #, no-wrap #~ msgid "" #~ "build: .PHONY <.>\n" #~ "\t${HUGO_CMD} --minify\n" #~ msgstr "" #~ "build: .PHONY <.>\n" #~ "\t${HUGO_CMD} --minify\n" #, no-wrap #~ msgid "all: starting-message generate-releases run <.>\n" #~ msgstr "all: starting-message generate-releases run <.>\n" #, no-wrap #~ msgid "" #~ "generate-releases: .PHONY <.>\n" #~ "\t${PYTHON_CMD} ./tools/releases-toml.py -p ./shared/releases.adoc\n" #~ msgstr "" #~ "generate-releases: .PHONY <.>\n" #~ "\t${PYTHON_CMD} ./tools/releases-toml.py -p ./shared/releases.adoc\n" #, no-wrap #~ msgid "" #~ "build: .PHONY <.>\n" #~ "\t${HUGO_CMD}\n" #~ msgstr "" #~ "build: .PHONY <.>\n" #~ "\t${HUGO_CMD}\n" #~ msgid "toc::[]" #~ msgstr "toc::[]" diff --git a/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc b/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc index 661deb9151..9bcd4620a7 100644 --- a/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc +++ b/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc @@ -1,242 +1,289 @@ --- description: 'Configuração usada nos editores de textos do Projeto de Documentação do FreeBSD' -next: books/fdp-primer/see-also +next: books/fdp-primer/trademarks path: /books/fdp-primer/ prev: books/fdp-primer/writing-style showBookMenu: 'true' tags: ["editor", "configuration", "vim", "emacs", "FreeBSD"] title: 'Capítulo 12. Configuração do Editor' weight: 13 --- [[editor-config]] = Configuração do Editor :doctype: book :toc: macro :toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :sectnumoffset: 12 :partnums: :source-highlighter: rouge :experimental: :images-path: books/fdp-primer/ ifdef::env-beastie[] ifdef::backend-html5[] :imagesdir: ../../../../images/{images-path} endif::[] ifndef::book[] include::shared/authors.adoc[] include::shared/mirrors.adoc[] include::shared/releases.adoc[] include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists.adoc[] include::shared/{{% lang %}}/urls.adoc[] toc::[] endif::[] ifdef::backend-pdf,backend-epub3[] include::../../../../../shared/asciidoctor.adoc[] endif::[] endif::[] ifndef::env-beastie[] toc::[] include::../../../../../shared/asciidoctor.adoc[] endif::[] Ajustar a configuração do editor de texto pode tornar o trabalho nos arquivos da documentação mais rápido e fácil, além de ajudar os documentos a ficarem em conformidade com as diretrizes do projeto. [[editor-config-vim]] == Vim -Instale-o a partir de package:editors/vim[], package:editors/vim-console[], ou package:editors/vim-tiny[] e siga as instruções de configuração em <>. +Instale o package:editors/vim[], ou package:editors/vim-console[], em seguida siga as instruções em <>. Usuários mais avançados podem usar um linter mais adequado como o link:https://github.com/dense-analysis/ale[Ale] que também pode atuar como um link:https://langserver.org/[Protocolo de Servidor de Idiomas] do Vim. [[editor-config-vim-use]] === Uso -Pressione kbd:[P] tpara reformatar parágrafos ou texto selecionado no modo Visual. Pressione kbd:[T] para substituir grupos de oito espaços por um tab. +Os escritores de páginas de manuais podem usar os seguintes atalhos de teclado para reformatar: +* Pressione kbd:[P] para reformatar parágrafos ou texto selecionado no modo Visual. +* Pressione kbd:[T] para substituir grupos de oito espaços por um tab. [[editor-config-vim-config]] === Configuração Edite o [.filename]#~/.vimrc#, adicionando estas linhas ao final do arquivo: [.programlisting] .... if has("autocmd") - au BufNewFile,BufRead *.sgml,*.ent,*.xsl,*.xml call Set_SGML() - au BufNewFile,BufRead *.[1-9] call ShowSpecial() + au BufNewFile,BufRead *.adoc call Set_ADOC() + au BufNewFile,BufRead *.[1-9] call Set_MAN() endif " has(autocmd) function Set_Highlights() - "match ExtraWhitespace /^\s* \s*\|\s\+$/ - highlight default link OverLength ErrorMsg - match OverLength /\%71v.\+/ - return 0 -endfunction " Set_Highlights() + "match ExtraWhitespace /^\s* \s*\|\s\+$/ + return 0 +endfunction " Set_Highlights_Adoc() + +function Set_Highlights_MAN() + highlight default link OverLength ErrorMsg + match OverLength /\%71v.\+/ + return 0 +endfunction " Set_Highlights_MAN() function ShowSpecial() - setlocal list listchars=tab:>>,trail:*,eol:$ - hi def link nontext ErrorMsg - return 0 + setlocal list listchars=tab:>>,trail:*,eol:$ + hi def link nontext ErrorMsg + return 0 endfunction " ShowSpecial() -function Set_SGML() - setlocal number - syn match sgmlSpecial "&[^;]*;" - setlocal syntax=sgml - setlocal filetype=xml - setlocal shiftwidth=2 - setlocal textwidth=70 - setlocal tabstop=8 - setlocal softtabstop=2 - setlocal formatprg="fmt -p" - setlocal autoindent - setlocal smartindent - " Rewrap paragraphs - noremap P gqj - " Replace spaces with tabs - noremap T :s/ /\t/ - call ShowSpecial() - call Set_Highlights() - return 0 -endfunction " Set_SGML() +function Set_COMMON() + setlocal number + setlocal shiftwidth=2 + setlocal tabstop=8 + setlocal softtabstop=2 + setlocal formatprg="fmt -p" + setlocal autoindent + setlocal smartindent + call ShowSpecial() + call Set_Highlights() + return 0 +endfunction " Set_COMMON() + +function Set_ADOC() + setlocal syntax=asciidoc + setlocal filetype=asciidoc + call Set_COMMON() + return 0 +endfunction " Set_ADOC() + +function Set_MAN() + setlocal syntax=man + setlocal filetype=man + setlocal textwidth=70 + " Rewrap paragraphs + noremap P gqj + " Replace spaces with tabs + noremap T :s/ /\t/ + call Set_COMMON() + call Set_Highlights_MAN() + return 0 +endfunction " Set_Man() .... [[editor-config-emacs]] == Emacs Instale-o a partir de package:editors/emacs[] ou package:editors/emacs-devel[]. [[editor-config-emacs-validation]] === Validação O modo nxml do Emacs usa esquemas NG relax compacto para validar o XML. Um esquema NG relax compacto para a extensão do FreeBSD para DocBook 5.0 está incluído no repositório de documentação. Para configurar o modo nxml para validar usando este esquema, crie [.filename]#~/.emacs.d/schema/schemas.xml# e adicione estas linhas ao arquivo: .... locatingRules xmlns="http://thaiopensource.com/ns/locating-rules/1.0" documentElement localName="section" typeId="DocBook" documentElement localName="chapter" typeId="DocBook" documentElement localName="article" typeId="DocBook" documentElement localName="book" typeId="DocBook" typeId id="DocBook" uri="/usr/local/share/xml/docbook/5.0/rng/docbook.rnc" locatingRules .... [[editor-config-emacs-igor]] === Revisão Automatizada com Flycheck e Igor O pacote Flycheck está disponível no Emacs Lisp Package Archive da Milkypostman (MELPA). Se a MELPA ainda não estiver nos repositórios de pacotes do Emacs, ele pode ser adicionado executando .... (add-to-list 'package-archives '("melpa" . "http://stable.melpa.org/packages/") t) .... Adicione a linha ao arquivo de inicialização do Emacs (qualquer um deles, [.filename]#~/.emacs#, [.filename]#~/.emacs.el#, ou [.filename]#~.emacs.d/init.el#) para tornar esta alteração permanente. Para instalar o Flycheck, execute .... (package-install 'flycheck) .... Crie um verificador Flycheck para package:textproc/igor[] executando .... (flycheck-define-checker igor "FreeBSD Documentation Project sanity checker. See URLs https://www.freebsd.org/docproj/ and http://www.freshports.org/textproc/igor/." :command ("igor" "-X" source-inplace) :error-parser flycheck-parse-checkstyle :modes (nxml-mode) :standard-input t) (add-to-list 'flycheck-checkers 'igor 'append) .... Novamente, adicione essas linhas ao arquivo de inicialização do Emacs para tornar as mudanças permanentes. [[editor-config-emacs-specifc]] === Configurações Específicas da Documentação do FreeBSD Para aplicar configurações específicas para o projeto de documentação do FreeBSD, crie o arquivo [.filename]#.dir-locals.el# no diretório raiz do repositório de documentação e adicione estas linhas ao arquivo: .... ;;; Directory Local Variables ;;; For more information see (info "(emacs) Directory Variables") ((nxml-mode (eval . (turn-on-auto-fill)) (fill-column . 70) (eval . (require 'flycheck)) (eval . (flycheck-mode 1)) (flycheck-checker . igor) (eval . (add-to-list 'rng-schema-locating-files "~/.emacs.d/schema/schemas.xml")))) .... [[editor-config-nano]] == nano Instale o aplicativo partir de package:editors/nano[] ou package:editors/nano-devel[]. [[editor-config-nano-config]] === Configuração -Copie o arquivo com a amostra da regra para realce da sintaxe XML para o diretório inicial do usuário: - -[source, shell] -.... -% cp /usr/local/share/nano/xml.nanorc ~/.nanorc -.... - -Use um editor para substituir as linhas do [.filename]#~/.nanorc# referentes ao bloco `syntax "xml"` por estas regras: +Atualmente não há arquivo de highlight de sintaxe adoc/asciidoc com distribuição nano. Então vamos criar um do zero e usar um editor para criar um novo arquivo ou adicionar linhas no [.filename]#~/.nanorc# com este conteúdo: .... -syntax "xml" "\.([jrs]html?|xml|xslt?)$" +syntax "asciidoc" "\.(adoc|asc|asciidoc)$" +# main header +color red "^====+$" +# h1 +color red "^==[[:space:]].*$" +color red "^----+$" +# h2 +color magenta "^===[[:space:]].*$" +color magenta "^~~~~+$" +# h4 +color green "^====[[:space:]].*$" +color green "^\^\^\^\^+$" +# h5 +color brightblue "^=====[[:space:]].*$" +color brightblue "^\+\+\+\++$" +# attributes +color brightgreen ":.*:" +color brightred "\{[a-z0-9]*\}" +color red "\\\{[a-z0-9]*\}" +color red "\+\+\+\{[a-z0-9]*\}\+\+\+" +# Paragraph Title +color yellow "^\..*$" +# source +color magenta "^\[(source,.+|NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]" +# Other markup +color yellow ".*[[:space:]]\+$" +color yellow "_[^_]+_" +color yellow "\*[^\*]+\*" +color yellow "\+[^\+]+\+" +color yellow "`[^`]+`" +color yellow "\^[^\^]+\^" +color yellow "~[^~]+~" +color yellow "'[^']+'" +color cyan "`{1,2}[^']+'{1,2}" +# bullets +color brightmagenta "^[[:space:]]*[\*\.-]{1,5}[[:space:]]" +# anchors +color brightwhite "\[\[.*\]\]" +color brightwhite "<<.*>>" # trailing whitespace color ,blue "[[:space:]]+$" # multiples of eight spaces at the start a line # (after zero or more tabs) should be a tab color ,blue "^([TAB]*[ ]{8})+" # tabs after spaces color ,yellow "( )+TAB" # highlight indents that have an odd number of spaces color ,red "^(([ ]{2})+|(TAB+))*[ ]{1}[^ ]{1}" -# lines longer than 70 characters -color ,yellow "^(.{71})|(TAB.{63})|(TAB{2}.{55})|(TAB{3}.{47}).+$" .... Processe o arquivo para criar guias incorporadas: [source, shell] .... % perl -i'' -pe 's/TAB/\t/g' ~/.nanorc .... [[editor-config-nano-use]] === Uso Especifique opções úteis adicionais ao executar o editor: [source, shell] .... -% nano -AKipwz -r 70 -T8 _index.adoc +% nano -AKipwz -T8 _index.adoc .... Usuários do man:csh[1] podem definir um alias em [.filename]#~/.cshrc# para automatizar estas opções: .... alias nano "nano -AKipwz -r 70 -T8" .... Depois que o alias é definido, as opções serão adicionadas automaticamente: [source, shell] .... % nano _index.adoc .... diff --git a/documentation/content/pt-br/books/fdp-primer/editor-config/_index.po b/documentation/content/pt-br/books/fdp-primer/editor-config/_index.po index 2078fe2d79..91d546f2c4 100644 --- a/documentation/content/pt-br/books/fdp-primer/editor-config/_index.po +++ b/documentation/content/pt-br/books/fdp-primer/editor-config/_index.po @@ -1,503 +1,680 @@ # SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. -# Danilo G. Baio , 2021. +# Danilo G. Baio , 2021, 2022. msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2022-02-01 09:20-0300\n" -"PO-Revision-Date: 2021-11-05 11:08+0000\n" +"POT-Creation-Date: 2022-07-07 23:22-0300\n" +"PO-Revision-Date: 2022-08-07 18:44+0000\n" "Last-Translator: Danilo G. Baio \n" "Language-Team: Portuguese (Brazil) \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" -"X-Generator: Weblate 4.8.1\n" +"X-Generator: Weblate 4.10.1\n" #. type: YAML Front Matter: description #: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:1 #, no-wrap msgid "Configuration used in the texts editors in the FreeBSD Documentation Project" msgstr "Configuração usada nos editores de textos do Projeto de Documentação do FreeBSD" #. type: YAML Front Matter: title #: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:1 #, no-wrap msgid "Chapter 12. Editor Configuration" msgstr "Capítulo 12. Configuração do Editor" #. type: Title = #: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:13 #, no-wrap msgid "Editor Configuration" msgstr "Configuração do Editor" #. type: Plain text #: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:51 msgid "" "Adjusting your text editor configuration can make working on document files " "quicker and easier, and help documents conform to FDP guidelines." msgstr "" "Ajustar a configuração do editor de texto pode tornar o trabalho nos " "arquivos da documentação mais rápido e fácil, além de ajudar os documentos a " "ficarem em conformidade com as diretrizes do projeto." #. type: Title == #: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:53 #, no-wrap msgid "Vim" msgstr "Vim" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:56 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:57 msgid "" -"Install from package:editors/vim[], package:editors/vim-console[], or " -"package:editors/vim-tiny[] then follow the configuration instructions in " -"<>." +"Install from package:editors/vim[], or package:editors/vim-console[], then " +"follow the configuration instructions in <>. More " +"advanced users can use a proper linter like link:https://github.com/dense-" +"analysis/ale[Ale] which can also act as a Vim link:https://langserver.org/" +"[Language Server Protocol] client." msgstr "" -"Instale-o a partir de package:editors/vim[], package:editors/vim-console[], " -"ou package:editors/vim-tiny[] e siga as instruções de configuração em " -"<>." +"Instale o package:editors/vim[], ou package:editors/vim-console[], em " +"seguida siga as instruções em <>. Usuários mais " +"avançados podem usar um linter mais adequado como o link:https://github.com/" +"dense-analysis/ale[Ale] que também pode atuar como um link:https://langserver" +".org/[Protocolo de Servidor de Idiomas] do Vim." #. type: Title === -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:58 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:226 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:59 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:273 #, no-wrap msgid "Use" msgstr "Uso" #. type: Plain text #: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:62 msgid "" +"Manual page writers can use the following keyboard shortcuts to reformat:" +msgstr "" +"Os escritores de páginas de manuais podem usar os seguintes atalhos de " +"teclado para reformatar:" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:63 +msgid "" "Press kbd:[P] to reformat paragraphs or text that has been selected in " -"Visual mode. Press kbd:[T] to replace groups of eight spaces with a tab." +"Visual mode." msgstr "" -"Pressione kbd:[P] tpara reformatar parágrafos ou texto selecionado no modo " -"Visual. Pressione kbd:[T] para substituir grupos de oito espaços por um tab." +"Pressione kbd:[P] para reformatar parágrafos ou texto selecionado no modo " +"Visual." -#. type: Title === +#. type: Plain text #: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:64 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:192 +msgid "Press kbd:[T] to replace groups of eight spaces with a tab." +msgstr "Pressione kbd:[T] para substituir grupos de oito espaços por um tab." + +#. type: Title === +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:66 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:210 #, no-wrap msgid "Configuration" msgstr "Configuração" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:67 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:69 msgid "Edit [.filename]#~/.vimrc#, adding these lines to the end of the file:" msgstr "" "Edite o [.filename]#~/.vimrc#, adicionando estas linhas ao final do arquivo:" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:74 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:76 #, no-wrap msgid "" "if has(\"autocmd\")\n" -" au BufNewFile,BufRead *.sgml,*.ent,*.xsl,*.xml call Set_SGML()\n" -" au BufNewFile,BufRead *.[1-9] call ShowSpecial()\n" +" au BufNewFile,BufRead *.adoc call Set_ADOC()\n" +" au BufNewFile,BufRead *.[1-9] call Set_MAN()\n" "endif \" has(autocmd)\n" msgstr "" "if has(\"autocmd\")\n" -" au BufNewFile,BufRead *.sgml,*.ent,*.xsl,*.xml call Set_SGML()\n" -" au BufNewFile,BufRead *.[1-9] call ShowSpecial()\n" +" au BufNewFile,BufRead *.adoc call Set_ADOC()\n" +" au BufNewFile,BufRead *.[1-9] call Set_MAN()\n" "endif \" has(autocmd)\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:81 #, no-wrap msgid "" "function Set_Highlights()\n" -" \"match ExtraWhitespace /^\\s* \\s*\\|\\s\\+$/\n" -" highlight default link OverLength ErrorMsg\n" -" match OverLength /\\%71v.\\+/\n" -" return 0\n" -"endfunction \" Set_Highlights()\n" +" \"match ExtraWhitespace /^\\s* \\s*\\|\\s\\+$/\n" +" return 0\n" +"endfunction \" Set_Highlights_Adoc()\n" msgstr "" "function Set_Highlights()\n" -" \"match ExtraWhitespace /^\\s* \\s*\\|\\s\\+$/\n" -" highlight default link OverLength ErrorMsg\n" -" match OverLength /\\%71v.\\+/\n" -" return 0\n" -"endfunction \" Set_Highlights()\n" +" \"match ExtraWhitespace /^\\s* \\s*\\|\\s\\+$/\n" +" return 0\n" +"endfunction \" Set_Highlights_Adoc()\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:87 #, no-wrap msgid "" +"function Set_Highlights_MAN()\n" +" highlight default link OverLength ErrorMsg\n" +" match OverLength /\\%71v.\\+/\n" +" return 0\n" +"endfunction \" Set_Highlights_MAN()\n" +msgstr "" +"function Set_Highlights_MAN()\n" +" highlight default link OverLength ErrorMsg\n" +" match OverLength /\\%71v.\\+/\n" +" return 0\n" +"endfunction \" Set_Highlights_MAN()\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:93 +#, no-wrap +msgid "" "function ShowSpecial()\n" -" setlocal list listchars=tab:>>,trail:*,eol:$\n" -" hi def link nontext ErrorMsg\n" -" return 0\n" +" setlocal list listchars=tab:>>,trail:*,eol:$\n" +" hi def link nontext ErrorMsg\n" +" return 0\n" "endfunction \" ShowSpecial()\n" msgstr "" "function ShowSpecial()\n" -" setlocal list listchars=tab:>>,trail:*,eol:$\n" -" hi def link nontext ErrorMsg\n" -" return 0\n" +" setlocal list listchars=tab:>>,trail:*,eol:$\n" +" hi def link nontext ErrorMsg\n" +" return 0\n" "endfunction \" ShowSpecial()\n" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:108 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:106 #, no-wrap msgid "" -"function Set_SGML()\n" -" setlocal number\n" -" syn match sgmlSpecial \"&[^;]*;\"\n" -" setlocal syntax=sgml\n" -" setlocal filetype=xml\n" -" setlocal shiftwidth=2\n" -" setlocal textwidth=70\n" -" setlocal tabstop=8\n" -" setlocal softtabstop=2\n" -" setlocal formatprg=\"fmt -p\"\n" -" setlocal autoindent\n" -" setlocal smartindent\n" -" \" Rewrap paragraphs\n" -" noremap P gqj\n" -" \" Replace spaces with tabs\n" -" noremap T :s/ /\\t/\n" -" call ShowSpecial()\n" -" call Set_Highlights()\n" -" return 0\n" -"endfunction \" Set_SGML()\n" +"function Set_COMMON()\n" +" setlocal number\n" +" setlocal shiftwidth=2\n" +" setlocal tabstop=8\n" +" setlocal softtabstop=2\n" +" setlocal formatprg=\"fmt -p\"\n" +" setlocal autoindent\n" +" setlocal smartindent\n" +" call ShowSpecial()\n" +" call Set_Highlights()\n" +" return 0\n" +"endfunction \" Set_COMMON()\n" msgstr "" -"function Set_SGML()\n" -" setlocal number\n" -" syn match sgmlSpecial \"&[^;]*;\"\n" -" setlocal syntax=sgml\n" -" setlocal filetype=xml\n" -" setlocal shiftwidth=2\n" -" setlocal textwidth=70\n" -" setlocal tabstop=8\n" -" setlocal softtabstop=2\n" -" setlocal formatprg=\"fmt -p\"\n" -" setlocal autoindent\n" -" setlocal smartindent\n" -" \" Rewrap paragraphs\n" -" noremap P gqj\n" -" \" Replace spaces with tabs\n" -" noremap T :s/ /\\t/\n" -" call ShowSpecial()\n" -" call Set_Highlights()\n" -" return 0\n" -"endfunction \" Set_SGML()\n" +"function Set_COMMON()\n" +" setlocal number\n" +" setlocal shiftwidth=2\n" +" setlocal tabstop=8\n" +" setlocal softtabstop=2\n" +" setlocal formatprg=\"fmt -p\"\n" +" setlocal autoindent\n" +" setlocal smartindent\n" +" call ShowSpecial()\n" +" call Set_Highlights()\n" +" return 0\n" +"endfunction \" Set_COMMON()\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:113 +#, no-wrap +msgid "" +"function Set_ADOC()\n" +" setlocal syntax=asciidoc\n" +" setlocal filetype=asciidoc\n" +" call Set_COMMON()\n" +" return 0\n" +"endfunction \" Set_ADOC()\n" +msgstr "" +"function Set_ADOC()\n" +" setlocal syntax=asciidoc\n" +" setlocal filetype=asciidoc\n" +" call Set_COMMON()\n" +" return 0\n" +"endfunction \" Set_ADOC()\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:126 +#, no-wrap +msgid "" +"function Set_MAN()\n" +" setlocal syntax=man\n" +" setlocal filetype=man\n" +" setlocal textwidth=70\n" +" \" Rewrap paragraphs\n" +" noremap P gqj\n" +" \" Replace spaces with tabs\n" +" noremap T :s/ /\\t/\n" +" call Set_COMMON()\n" +" call Set_Highlights_MAN()\n" +" return 0\n" +"endfunction \" Set_Man()\n" +msgstr "" +"function Set_MAN()\n" +" setlocal syntax=man\n" +" setlocal filetype=man\n" +" setlocal textwidth=70\n" +" \" Rewrap paragraphs\n" +" noremap P gqj\n" +" \" Replace spaces with tabs\n" +" noremap T :s/ /\\t/\n" +" call Set_COMMON()\n" +" call Set_Highlights_MAN()\n" +" return 0\n" +"endfunction \" Set_Man()\n" #. type: Title == -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:111 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:129 #, no-wrap msgid "Emacs" msgstr "Emacs" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:114 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:132 msgid "Install from package:editors/emacs[] or package:editors/emacs-devel[]." msgstr "" "Instale-o a partir de package:editors/emacs[] ou package:editors/emacs-" "devel[]." #. type: Title === -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:116 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:134 #, no-wrap msgid "Validation" msgstr "Validação" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:121 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:139 msgid "" "Emacs's nxml-mode uses compact relax NG schemas for validating XML. A " "compact relax NG schema for FreeBSD's extension to DocBook 5.0 is included " "in the documentation repository. To configure nxml-mode to validate using " "this schema, create [.filename]#~/.emacs.d/schema/schemas.xml# and add these " "lines to the file:" msgstr "" "O modo nxml do Emacs usa esquemas NG relax compacto para validar o XML. Um " "esquema NG relax compacto para a extensão do FreeBSD para DocBook 5.0 está " "incluído no repositório de documentação. Para configurar o modo nxml para " "validar usando este esquema, crie [.filename]#~/.emacs.d/schema/schemas.xml# " "e adicione estas linhas ao arquivo:" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:130 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:148 #, no-wrap msgid "" "locatingRules xmlns=\"http://thaiopensource.com/ns/locating-rules/1.0\"\n" " documentElement localName=\"section\" typeId=\"DocBook\"\n" " documentElement localName=\"chapter\" typeId=\"DocBook\"\n" " documentElement localName=\"article\" typeId=\"DocBook\"\n" " documentElement localName=\"book\" typeId=\"DocBook\"\n" " typeId id=\"DocBook\" uri=\"/usr/local/share/xml/docbook/5.0/rng/docbook.rnc\"\n" "locatingRules\n" msgstr "" "locatingRules xmlns=\"http://thaiopensource.com/ns/locating-rules/1.0\"\n" " documentElement localName=\"section\" typeId=\"DocBook\"\n" " documentElement localName=\"chapter\" typeId=\"DocBook\"\n" " documentElement localName=\"article\" typeId=\"DocBook\"\n" " documentElement localName=\"book\" typeId=\"DocBook\"\n" " typeId id=\"DocBook\" uri=\"/usr/local/share/xml/docbook/5.0/rng/docbook.rnc\"\n" "locatingRules\n" #. type: Title === -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:133 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:151 #, no-wrap msgid "Automated Proofreading with Flycheck and Igor" msgstr "Revisão Automatizada com Flycheck e Igor" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:137 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:155 msgid "" "The Flycheck package is available from Milkypostman's Emacs Lisp Package " "Archive (MELPA). If MELPA is not already in Emacs's packages-archives, it " "can be added by evaluating" msgstr "" "O pacote Flycheck está disponível no Emacs Lisp Package Archive da " "Milkypostman (MELPA). Se a MELPA ainda não estiver nos repositórios de " "pacotes do Emacs, ele pode ser adicionado executando" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:140 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:158 #, no-wrap msgid "(add-to-list 'package-archives '(\"melpa\" . \"http://stable.melpa.org/packages/\") t)\n" msgstr "(add-to-list 'package-archives '(\"melpa\" . \"http://stable.melpa.org/packages/\") t)\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:143 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:161 msgid "" "Add the line to Emacs's initialization file (one of [.filename]#~/.emacs#, [." "filename]#~/.emacs.el#, or [.filename]#~.emacs.d/init.el#) to make this " "change permanent." msgstr "" "Adicione a linha ao arquivo de inicialização do Emacs (qualquer um deles, [." "filename]#~/.emacs#, [.filename]#~/.emacs.el#, ou [.filename]#~.emacs.d/init." "el#) para tornar esta alteração permanente." #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:145 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:163 msgid "To install Flycheck, evaluate" msgstr "Para instalar o Flycheck, execute" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:148 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:166 #, no-wrap msgid "(package-install 'flycheck)\n" msgstr "(package-install 'flycheck)\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:151 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:169 msgid "Create a Flycheck checker for package:textproc/igor[] by evaluating" msgstr "Crie um verificador Flycheck para package:textproc/igor[] executando" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:155 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:173 #, no-wrap msgid "" "(flycheck-define-checker igor\n" " \"FreeBSD Documentation Project sanity checker.\n" msgstr "" "(flycheck-define-checker igor\n" " \"FreeBSD Documentation Project sanity checker.\n" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:162 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:180 #, no-wrap msgid "" "See URLs https://www.freebsd.org/docproj/ and\n" "http://www.freshports.org/textproc/igor/.\"\n" " :command (\"igor\" \"-X\" source-inplace)\n" " :error-parser flycheck-parse-checkstyle\n" " :modes (nxml-mode)\n" " :standard-input t)\n" msgstr "" "See URLs https://www.freebsd.org/docproj/ and\n" "http://www.freshports.org/textproc/igor/.\"\n" " :command (\"igor\" \"-X\" source-inplace)\n" " :error-parser flycheck-parse-checkstyle\n" " :modes (nxml-mode)\n" " :standard-input t)\n" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:164 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:182 #, no-wrap msgid " (add-to-list 'flycheck-checkers 'igor 'append)\n" msgstr " (add-to-list 'flycheck-checkers 'igor 'append)\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:167 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:185 msgid "" "Again, add these lines to Emacs's initialization file to make the changes " "permanent." msgstr "" "Novamente, adicione essas linhas ao arquivo de inicialização do Emacs para " "tornar as mudanças permanentes." #. type: Title === -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:169 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:187 #, no-wrap msgid "FreeBSD Documentation Specific Settings" msgstr "Configurações Específicas da Documentação do FreeBSD" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:172 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:190 msgid "" "To apply settings specific to the FreeBSD documentation project, create [." "filename]#.dir-locals.el# in the root directory of the documentation " "repository and add these lines to the file:" msgstr "" "Para aplicar configurações específicas para o projeto de documentação do " "FreeBSD, crie o arquivo [.filename]#.dir-locals.el# no diretório raiz do " "repositório de documentação e adicione estas linhas ao arquivo:" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:176 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:194 #, no-wrap msgid "" ";;; Directory Local Variables\n" ";;; For more information see (info \"(emacs) Directory Variables\")\n" msgstr "" ";;; Directory Local Variables\n" ";;; For more information see (info \"(emacs) Directory Variables\")\n" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:184 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:202 #, no-wrap msgid "" "((nxml-mode\n" " (eval . (turn-on-auto-fill))\n" " (fill-column . 70)\n" " (eval . (require 'flycheck))\n" " (eval . (flycheck-mode 1))\n" " (flycheck-checker . igor)\n" " (eval . (add-to-list 'rng-schema-locating-files \"~/.emacs.d/schema/schemas.xml\"))))\n" msgstr "" "((nxml-mode\n" " (eval . (turn-on-auto-fill))\n" " (fill-column . 70)\n" " (eval . (require 'flycheck))\n" " (eval . (flycheck-mode 1))\n" " (flycheck-checker . igor)\n" " (eval . (add-to-list 'rng-schema-locating-files \"~/.emacs.d/schema/schemas.xml\"))))\n" #. type: Title == -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:187 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:205 #, no-wrap msgid "nano" msgstr "nano" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:190 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:208 msgid "Install from package:editors/nano[] or package:editors/nano-devel[]." msgstr "" "Instale o aplicativo partir de package:editors/nano[] ou package:editors/" "nano-devel[]." #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:195 -msgid "Copy the sample XML syntax highlight file to the user's home directory:" -msgstr "" -"Copie o arquivo com a amostra da regra para realce da sintaxe XML para o " -"diretório inicial do usuário:" - -#. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:199 -#, no-wrap -msgid "% cp /usr/local/share/nano/xml.nanorc ~/.nanorc\n" -msgstr "% cp /usr/local/share/nano/xml.nanorc ~/.nanorc\n" - -#. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:202 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:213 msgid "" -"Use an editor to replace the lines in the [.filename]#~/.nanorc# `syntax " -"\"xml\"` block with these rules:" +"Currently there is no adoc/asciidoc syntax highlight file with nano " +"distribution. So let's create one from scratch and use an editor to create " +"new file or add lines in the [.filename]#~/.nanorc# with these contents:" msgstr "" -"Use um editor para substituir as linhas do [.filename]#~/.nanorc# referentes " -"ao bloco `syntax \"xml\"` por estas regras:" +"Atualmente não há arquivo de highlight de sintaxe adoc/asciidoc com " +"distribuição nano. Então vamos criar um do zero e usar um editor para criar " +"um novo arquivo ou adicionar linhas no [.filename]#~/.nanorc# com este " +"conteúdo:" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:216 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:263 #, no-wrap msgid "" -"syntax \"xml\" \"\\.([jrs]html?|xml|xslt?)$\"\n" +"syntax \"asciidoc\" \"\\.(adoc|asc|asciidoc)$\"\n" +"# main header\n" +"color red \"^====+$\"\n" +"# h1\n" +"color red \"^==[[:space:]].*$\"\n" +"color red \"^----+$\"\n" +"# h2\n" +"color magenta \"^===[[:space:]].*$\"\n" +"color magenta \"^~~~~+$\"\n" +"# h4\n" +"color green \"^====[[:space:]].*$\"\n" +"color green \"^\\^\\^\\^\\^+$\"\n" +"# h5\n" +"color brightblue \"^=====[[:space:]].*$\"\n" +"color brightblue \"^\\+\\+\\+\\++$\"\n" +"# attributes\n" +"color brightgreen \":.*:\"\n" +"color brightred \"\\{[a-z0-9]*\\}\"\n" +"color red \"\\\\\\{[a-z0-9]*\\}\"\n" +"color red \"\\+\\+\\+\\{[a-z0-9]*\\}\\+\\+\\+\"\n" +"# Paragraph Title\n" +"color yellow \"^\\..*$\"\n" +"# source\n" +"color magenta \"^\\[(source,.+|NOTE|TIP|IMPORTANT|WARNING|CAUTION)\\]\"\n" +"# Other markup\n" +"color yellow \".*[[:space:]]\\+$\"\n" +"color yellow \"_[^_]+_\"\n" +"color yellow \"\\*[^\\*]+\\*\"\n" +"color yellow \"\\+[^\\+]+\\+\"\n" +"color yellow \"`[^`]+`\"\n" +"color yellow \"\\^[^\\^]+\\^\"\n" +"color yellow \"~[^~]+~\"\n" +"color yellow \"'[^']+'\"\n" +"color cyan \"`{1,2}[^']+'{1,2}\"\n" +"# bullets\n" +"color brightmagenta \"^[[:space:]]*[\\*\\.-]{1,5}[[:space:]]\"\n" +"# anchors\n" +"color brightwhite \"\\[\\[.*\\]\\]\"\n" +"color brightwhite \"<<.*>>\"\n" "# trailing whitespace\n" "color ,blue \"[[:space:]]+$\"\n" "# multiples of eight spaces at the start a line\n" "# (after zero or more tabs) should be a tab\n" "color ,blue \"^([TAB]*[ ]{8})+\"\n" "# tabs after spaces\n" "color ,yellow \"( )+TAB\"\n" "# highlight indents that have an odd number of spaces\n" "color ,red \"^(([ ]{2})+|(TAB+))*[ ]{1}[^ ]{1}\"\n" -"# lines longer than 70 characters\n" -"color ,yellow \"^(.{71})|(TAB.{63})|(TAB{2}.{55})|(TAB{3}.{47}).+$\"\n" msgstr "" -"syntax \"xml\" \"\\.([jrs]html?|xml|xslt?)$\"\n" +"syntax \"asciidoc\" \"\\.(adoc|asc|asciidoc)$\"\n" +"# main header\n" +"color red \"^====+$\"\n" +"# h1\n" +"color red \"^==[[:space:]].*$\"\n" +"color red \"^----+$\"\n" +"# h2\n" +"color magenta \"^===[[:space:]].*$\"\n" +"color magenta \"^~~~~+$\"\n" +"# h4\n" +"color green \"^====[[:space:]].*$\"\n" +"color green \"^\\^\\^\\^\\^+$\"\n" +"# h5\n" +"color brightblue \"^=====[[:space:]].*$\"\n" +"color brightblue \"^\\+\\+\\+\\++$\"\n" +"# attributes\n" +"color brightgreen \":.*:\"\n" +"color brightred \"\\{[a-z0-9]*\\}\"\n" +"color red \"\\\\\\{[a-z0-9]*\\}\"\n" +"color red \"\\+\\+\\+\\{[a-z0-9]*\\}\\+\\+\\+\"\n" +"# Paragraph Title\n" +"color yellow \"^\\..*$\"\n" +"# source\n" +"color magenta \"^\\[(source,.+|NOTE|TIP|IMPORTANT|WARNING|CAUTION)\\]\"\n" +"# Other markup\n" +"color yellow \".*[[:space:]]\\+$\"\n" +"color yellow \"_[^_]+_\"\n" +"color yellow \"\\*[^\\*]+\\*\"\n" +"color yellow \"\\+[^\\+]+\\+\"\n" +"color yellow \"`[^`]+`\"\n" +"color yellow \"\\^[^\\^]+\\^\"\n" +"color yellow \"~[^~]+~\"\n" +"color yellow \"'[^']+'\"\n" +"color cyan \"`{1,2}[^']+'{1,2}\"\n" +"# bullets\n" +"color brightmagenta \"^[[:space:]]*[\\*\\.-]{1,5}[[:space:]]\"\n" +"# anchors\n" +"color brightwhite \"\\[\\[.*\\]\\]\"\n" +"color brightwhite \"<<.*>>\"\n" "# trailing whitespace\n" "color ,blue \"[[:space:]]+$\"\n" "# multiples of eight spaces at the start a line\n" "# (after zero or more tabs) should be a tab\n" "color ,blue \"^([TAB]*[ ]{8})+\"\n" "# tabs after spaces\n" "color ,yellow \"( )+TAB\"\n" "# highlight indents that have an odd number of spaces\n" "color ,red \"^(([ ]{2})+|(TAB+))*[ ]{1}[^ ]{1}\"\n" -"# lines longer than 70 characters\n" -"color ,yellow \"^(.{71})|(TAB.{63})|(TAB{2}.{55})|(TAB{3}.{47}).+$\"\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:219 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:266 msgid "Process the file to create embedded tabs:" msgstr "Processe o arquivo para criar guias incorporadas:" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:223 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:270 #, no-wrap msgid "% perl -i'' -pe 's/TAB/\\t/g' ~/.nanorc\n" msgstr "% perl -i'' -pe 's/TAB/\\t/g' ~/.nanorc\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:229 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:276 msgid "Specify additional helpful options when running the editor:" msgstr "Especifique opções úteis adicionais ao executar o editor:" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:233 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:280 #, no-wrap -msgid "% nano -AKipwz -r 70 -T8 _index.adoc\n" -msgstr "% nano -AKipwz -r 70 -T8 _index.adoc\n" +msgid "% nano -AKipwz -T8 _index.adoc\n" +msgstr "% nano -AKipwz -T8 _index.adoc\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:236 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:283 msgid "" "Users of man:csh[1] can define an alias in [.filename]#~/.cshrc# to automate " "these options:" msgstr "" "Usuários do man:csh[1] podem definir um alias em [.filename]#~/.cshrc# para " "automatizar estas opções:" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:239 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:286 #, no-wrap msgid "alias nano \"nano -AKipwz -r 70 -T8\"\n" msgstr "alias nano \"nano -AKipwz -r 70 -T8\"\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:242 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:289 msgid "After the alias is defined, the options will be added automatically:" msgstr "" "Depois que o alias é definido, as opções serão adicionadas automaticamente:" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:246 +#: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:293 #, no-wrap msgid "% nano _index.adoc\n" msgstr "% nano _index.adoc\n" +#~ msgid "" +#~ "Install from package:editors/vim[], package:editors/vim-console[], or " +#~ "package:editors/vim-tiny[] then follow the configuration instructions in " +#~ "<>." +#~ msgstr "" +#~ "Instale-o a partir de package:editors/vim[], package:editors/vim-" +#~ "console[], ou package:editors/vim-tiny[] e siga as instruções de " +#~ "configuração em <>." + +#~ msgid "" +#~ "Copy the sample XML syntax highlight file to the user's home directory:" +#~ msgstr "" +#~ "Copie o arquivo com a amostra da regra para realce da sintaxe XML para o " +#~ "diretório inicial do usuário:" + +#, no-wrap +#~ msgid "% cp /usr/local/share/nano/xml.nanorc ~/.nanorc\n" +#~ msgstr "% cp /usr/local/share/nano/xml.nanorc ~/.nanorc\n" + +#~ msgid "" +#~ "Use an editor to replace the lines in the [.filename]#~/.nanorc# `syntax " +#~ "\"xml\"` block with these rules:" +#~ msgstr "" +#~ "Use um editor para substituir as linhas do [.filename]#~/.nanorc# " +#~ "referentes ao bloco `syntax \"xml\"` por estas regras:" + +#, no-wrap +#~ msgid "" +#~ "syntax \"xml\" \"\\.([jrs]html?|xml|xslt?)$\"\n" +#~ "# trailing whitespace\n" +#~ "color ,blue \"[[:space:]]+$\"\n" +#~ "# multiples of eight spaces at the start a line\n" +#~ "# (after zero or more tabs) should be a tab\n" +#~ "color ,blue \"^([TAB]*[ ]{8})+\"\n" +#~ "# tabs after spaces\n" +#~ "color ,yellow \"( )+TAB\"\n" +#~ "# highlight indents that have an odd number of spaces\n" +#~ "color ,red \"^(([ ]{2})+|(TAB+))*[ ]{1}[^ ]{1}\"\n" +#~ "# lines longer than 70 characters\n" +#~ "color ,yellow \"^(.{71})|(TAB.{63})|(TAB{2}.{55})|(TAB{3}.{47}).+$\"\n" +#~ msgstr "" +#~ "syntax \"xml\" \"\\.([jrs]html?|xml|xslt?)$\"\n" +#~ "# trailing whitespace\n" +#~ "color ,blue \"[[:space:]]+$\"\n" +#~ "# multiples of eight spaces at the start a line\n" +#~ "# (after zero or more tabs) should be a tab\n" +#~ "color ,blue \"^([TAB]*[ ]{8})+\"\n" +#~ "# tabs after spaces\n" +#~ "color ,yellow \"( )+TAB\"\n" +#~ "# highlight indents that have an odd number of spaces\n" +#~ "color ,red \"^(([ ]{2})+|(TAB+))*[ ]{1}[^ ]{1}\"\n" +#~ "# lines longer than 70 characters\n" +#~ "color ,yellow \"^(.{71})|(TAB.{63})|(TAB{2}.{55})|(TAB{3}.{47}).+$\"\n" + #~ msgid "" #~ "include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" #~ "{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists." #~ "adoc[] include::shared/{{% lang %}}/urls.adoc[]" #~ msgstr "" #~ "include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" #~ "{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists." #~ "adoc[] include::shared/{{% lang %}}/urls.adoc[]" diff --git a/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc b/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc index ace8fbb15f..28540158ca 100644 --- a/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc +++ b/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc @@ -1,127 +1,315 @@ --- description: 'Visão geral sobre o Processo de Documentação do FreeBSD' next: books/fdp-primer/tools path: /books/fdp-primer/ prev: books/fdp-primer/preface showBookMenu: 'true' tags: ["overview", "FreeBSD Documentation Project", "quick start"] title: 'Capítulo 1. Visão Geral' weight: 2 --- [[overview]] = Visão geral :doctype: book :toc: macro :toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :sectnumoffset: 1 :partnums: :source-highlighter: rouge :experimental: :images-path: books/fdp-primer/ ifdef::env-beastie[] ifdef::backend-html5[] :imagesdir: ../../../../images/{images-path} endif::[] ifndef::book[] include::shared/authors.adoc[] include::shared/mirrors.adoc[] include::shared/releases.adoc[] include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists.adoc[] include::shared/{{% lang %}}/urls.adoc[] toc::[] endif::[] ifdef::backend-pdf,backend-epub3[] include::../../../../../shared/asciidoctor.adoc[] endif::[] endif::[] ifndef::env-beastie[] toc::[] include::../../../../../shared/asciidoctor.adoc[] endif::[] Seja bem vindo ao Projeto de Documentação do FreeBSD.(FDP). Documentação de boa qualidade é muito importante para o sucesso do FreeBSD, e nós valorizamos muito suas contribuições. Este documento descreve como o FDP é organizado, como escrever e como submeter documentos, e como utilizar de forma efetiva as ferramentas que estão disponíveis. Todos são bem vindos para se juntar ao FDP. A vontade de contribuir é o único requisito de adesão. Este primer mostra como: +* Compreender o papel da documentação e seu lugar no ecossistema. * Identificar quais partes do FreeBSD são mantidas pelo FDP. * Instalar as ferramentas e arquivos de documentação necessários. * Realizar alterações na documentação. * Enviar de volta alterações para revisão e inclusão na documentação do FreeBSD. +[[overview-documentation-ecosystem]] +== Documentação no Ecossistema FreeBSD + +Todos os documentos são para o benefício de seus leitores, não de seus escritores ou zeladores. Eles devem se adaptar ao leitor e não esperar que o leitor se adapte a eles. + +Nunca culpe o leitor por: + +* ser incapaz de fazer uso de um documento facilmente ou de tudo +* achar o documento confuso +* não entender o documento ou como utilizá-lo +* não encontrar uma resposta explícita ou preencher lacunas com sucesso (ou conectando pontos) para raciocinar em direção a uma + +Em vez disso, reconheça que o documento é: + +* inacessível +* confuso +* difícil de entender ou utilizar +* incompleto + +Em seguida, faça o documento: + +* mais acessível +* menos confuso +* mais claro +* mais completo + +Use os seguintes métodos: + +* aplique as link:https://webaim.org/intro/#principles[melhores práticas de acessibilidade] para corrigir o problema relatado e quaisquer outros semelhantes que você encontrar +* refazer ou esclarecer a estrutura ou linguagem confusa +* adicionar exemplos relevantes para a parte que é difícil de entender ou aplicar +* preencha as lacunas ou adicione os degraus que faltam + [[overview-quick-start]] == Introdução Algumas etapas preparatórias devem ser seguidas antes de editar a documentação do FreeBSD. Primeiro, se registre na {freebsd-doc}. Alguns membros do time também interagem no IRC, canal `#bsddocs` na rede http://www.efnet.org/[EFnet]. Estas pessoas podem ajudar com questões e problemas envolvendo documentação. +[[freebsd-installation-process]] +=== Processo de instalação do FreeBSD + [.procedure] ==== . Instale esses pacotes. O _meta-port_ `docproj` instala todos os aplicativos necessários para editar e compilar a documentação do FreeBSD. + [source, shell] .... # pkg install docproj .... + . Obtenha uma cópia local da árvore de documentação do FreeBSD em [.filename]#~/doc# (ver crossref:working-copy[working-copy,A Área de Trabalho]). + [source, shell] .... % git clone https://git.FreeBSD.org/doc.git ~/doc .... + . Edite os arquivos de documentação que precisam de alterações. Se um arquivo precisar de grandes mudanças, consulte a lista de discussão para obter informações. + Revise a saída e edite o arquivo para corrigir os problemas informados e, em seguida, execute novamente o comando para verificar os problemas restantes. Repita até que todos os erros sejam resolvidos. + . *_Sempre_* realize testes de compilação antes de submeter algo. Execute `make` no diretório de nível superior da documentação e assim será gerado a documentação no formato HTML. + [source, shell] .... % make .... + -. Quando as alterações estiverem completas e testadas, gere um "arquivo diff": +. Adicione todos os arquivos com `git add .`, então revise o diff com `git diff`. Por exemplo: ++ +[source, shell] +.... +% git add . +% git diff --staged +.... ++ +Certifique-se de que todos os arquivos necessários estejam incluídos, então confirme a mudança em seu branch local e gere um patch com `git format-patch` ++ +[source, shell] +.... +% git commit +% git format-patch origin/main +.... ++ +Patch gerado com `git format-patch` incluirá a identidade do autor e endereços de e-mail, tornando mais fácil para os desenvolvedores aplicarem (com `git am`) e dar os devidos créditos. ++ +[IMPORTANT] +====== +Para tornar mais fácil para os committers aplicarem o patch em sua cópia de trabalho da árvore de documentação, por favor, gere o [.filename]#.diff# da base de sua árvore de documentação. +====== ++ +No exemplo acima, foram feitas alterações na parte [.filename]#bsdinstall# do Handbook. ++ +. Submeta o patch or arquivo diff pela web para o sistema de https://bugs.FreeBSD.org/bugzilla/enter_bug.cgi?product=Documentation[Relatórios de Problema]. Se estiver usando o formulário web, insira um Sumário com _[patch] descrição curta do problema_. Selecione o Componente `Documentation`. No campo de Descrição, insira uma breve descrição das alterações e quaisquer detalhes importantes sobre elas. Use o botão btn:[Add an attachment] para anexar o patch ou arquivo diff. Finalmente, pressione o botão btn:[Submit Bug] para enviar seu diff para o sistema de relatório de problemas. +==== + +[[gnu-linux-installation-process]] +=== Processo de instalação GNU/Linux + +[.procedure] +==== +[TIP] +====== +Hugo versão 0.90 ou superior deve ser utilizado +====== + +. Instale esses pacotes em sistemas baseados em apt como Debian ou Ubuntu. Em outras distribuições GNU/Linux os nomes dos pacotes podem mudar. Consulte o gerenciador de pacotes da sua distribuição em caso de dúvida. ++ +[source, shell] +.... +# apt install hugo ruby-asciidoctor ruby-asciidoctor-pdf ruby-rouge git bmake +.... ++ +. Obtenha uma cópia local da árvore de documentação do FreeBSD em [.filename]#~/doc# (ver crossref:working-copy[working-copy,A Área de Trabalho]). ++ +[source, shell] +.... +% git clone https://git.FreeBSD.org/doc.git ~/doc +.... ++ +. Edite os arquivos de documentação que precisam de alterações. Se um arquivo precisar de grandes mudanças, consulte a lista de discussão para obter informações. ++ +Revise a saída e edite os arquivos para corrigir os problemas informados e, em seguida, execute novamente o comando para verificar os problemas restantes. Repita até que todos os erros sejam resolvidos. ++ +. Sempre realize testes de compilação antes de submeter algo. Execute `bmake` no diretório de nível superior da documentação e assim será gerado a documentação no formato HTML. + [source, shell] .... -% cd ~/doc -% git diff > bsdinstall.diff.txt +% bmake run LOCALBASE=/usr .... + -Dê ao arquivo diff um nome. No exemplo acima, foram feitas alterações na parte [.filename]#bsdinstall# do Handbook. -. Submeta o arquivo diff file pela web para o sistema de https://bugs.FreeBSD.org/bugzilla/enter_bug.cgi?product=Documentation[Relatórios de Problema]. Se estiver usando o formulário web, insira um Sumário com _[patch] descrição curta do problema_. Selecione o Componente `Documentation`. No campo de Descrição, insira uma breve descrição das alterações e quaisquer detalhes importantes sobre elas. Use o botão btn:[Add an attachment] para anexar o arquivo diff. Finalmente, pressione o botão btn:[Submit Bug] para enviar seu diff para o sistema de relatório de problemas. +. Adicione todos os arquivos com `git add .`, então revise o diff com `git diff`. Por exemplo: ++ +[source, shell] +.... +% git add . +% git diff --staged +.... ++ +Certifique-se de que todos os arquivos necessários estejam incluídos, então confirme a mudança em seu branch local e gere um patch com `git format-patch` ++ +[source, shell] +.... +% git commit +% git format-patch origin/main +.... ++ +Patch gerado com `git format-patch` incluirá a identidade do autor e endereços de e-mail, tornando mais fácil para os desenvolvedores aplicarem (com `git am`) e dar os devidos créditos. ++ +[IMPORTANT] +====== +Para tornar mais fácil para os committers aplicarem o patch em sua cópia de trabalho da árvore de documentação, por favor, gere o [.filename]#.diff# da base de sua árvore de documentação. +====== ++ +. Submeta o patch ou arquivo diff file pela web para o sistema de https://bugs.FreeBSD.org/bugzilla/enter_bug.cgi?product=Documentation[Relatórios de Problema]. Se estiver usando o formulário web, insira um Sumário com uma _breve descrição do problema_. Selecione o Componente `Documentation`. No campo de Descrição, insira uma breve descrição das alterações e quaisquer detalhes importantes sobre elas e adicione _patch_ no campo _Keywords_. Use o botão btn:[Add an attachment] para anexar o patch ou arquivo diff. Finalmente, pressione o botão btn:[Submit Bug] para enviar seu diff para o sistema de relatório de problemas. +==== + +[[mac-os-installation-process]] +=== Processo de instalação do macOS(R) + +[.procedure] +==== +[TIP] +====== +Hugo versão 0.90 ou superior deve ser utilizado +====== + +. Instale esses pacotes usando o link:https://brew.sh/[Homebrew] e o link:https://rubygems.org/[RubyGem]. ++ +[source, shell] +.... +$ brew install hugo ruby git bmake asciidoctor +.... ++ +. Adicione o Ruby ao Path. ++ +[source, shell] +.... +$ echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc +.... ++ +. Instale o pacote rouge usando RubyGem. ++ +[source, shell] +.... +$ sudo gem install rouge +.... ++ +. Obtenha uma cópia local da árvore de documentação do FreeBSD em [.filename]#~/doc# (ver crossref:working-copy[working-copy,A Área de Trabalho]). ++ +[source, shell] +.... +$ git clone https://git.FreeBSD.org/doc.git ~/doc +.... ++ +. Edite os arquivos de documentação que precisam de alterações. Se um arquivo precisar de grandes mudanças, consulte a lista de discussão para obter informações. ++ +Revise a saída e edite os arquivos para corrigir os problemas informados e, em seguida, execute novamente o comando para verificar os problemas restantes. Repita até que todos os erros sejam resolvidos. ++ +. Sempre realize testes de compilação antes de submeter algo. Execute `bmake` no diretório de nível superior da documentação e assim será gerado a documentação no formato HTML. ++ +[source, shell] +.... +$ bmake run LOCALBASE=/usr +.... +. Adicione todos os arquivos com `git add .`, então revise o diff com `git diff`. Por exemplo: ++ +[source, shell] +.... +% git add . +% git diff --staged +.... ++ +Certifique-se de que todos os arquivos necessários estejam incluídos, então confirme a mudança em seu branch local e gere um patch com `git format-patch` ++ +[source, shell] +.... +% git commit +% git format-patch origin/main +.... ++ +Patch gerado com `git format-patch` incluirá a identidade do autor e endereços de e-mail, tornando mais fácil para os desenvolvedores aplicarem (com `git am`) e dar os devidos créditos. ++ +[IMPORTANT] +====== +Para tornar mais fácil para os committers aplicarem o patch em sua cópia de trabalho da árvore de documentação, por favor, gere o [.filename]#.diff# da base de sua árvore de documentação. +====== ++ +. Submeta o patch ou arquivo diff file pela web para o sistema de https://bugs.FreeBSD.org/bugzilla/enter_bug.cgi?product=Documentation[Relatórios de Problema]. Se estiver usando o formulário web, insira um Sumário com uma _breve descrição do problema_. Selecione o Componente `Documentation`. No campo de Descrição, insira uma breve descrição das alterações e quaisquer detalhes importantes sobre elas e adicione _patch_ no campo _Keywords_. Use o botão btn:[Add an attachment] para anexar o patch ou arquivo diff. Finalmente, pressione o botão btn:[Submit Bug] para enviar seu diff para o sistema de relatório de problemas. ==== [[overview-doc]] == Conjunto de Documentação do FreeBSD O FDP é responsável por quatro categorias de documentação do FreeBSD. * _Handbook_: O Handbook almeja ser um compreensivo recurso de referência online para os usuários do FreeBSD. * _FAQ_: O FAQ utiliza um formato curto de pergunta e resposta para abordar dúvidas que são frequentemente realizadas nas listas de discussão e fóruns dedicados ao FreeBSD. Este formato não permite respostas longas e detalhadas. * _Páginas de Manual_: As páginas de manual do sistema de língua inglesa geralmente não são escritas pelo FDP, pois fazem parte do sistema base. Contudo, o FDP pode reformular partes das páginas de manual existentes para torná-las mais claras ou para corrigir imprecisões. * _Web site_: Esta é a presença principal do FreeBSD na web, visite https://www.freebsd.org/[https://www.FreeBSD.org/] e muitos mirrors ao redor do mundo. O site é tipicamente o primeiro contato de um usuário novo com o FreeBSD. As equipes de tradução são responsáveis por traduzir o manual e o site para diferentes idiomas. As páginas do manual não são traduzidas no momento. Código fonte do site do FreeBSD, Handbook, e FAQ estão disponíveis no repositório de documentação em `https://cgit.freebsd.org/doc/`. Código fonte das páginas de manual estão disponíveis em um repositório diferente localizado em `https://cgit.freebsd.org/src/`. As mensagens de commit de documentação podem ser visualizadas com `git log`. As mensagens de commit também são arquivadas em link:{dev-commits-doc-all}. Endereço web para ambos os repositórios disponíveis em https://cgit.freebsd.org/doc/[] e https://cgit.freebsd.org/src/[]. Muitas pessoas tem escrito tutoriais e artigos how-to sobre FreeBSD. Alguns são armazenados como parte dos arquivos FDP. Em outros casos, o autor decidiu manter a documentação separada. O FDP esforça-se para fornecer links para o máximo possível dessas documentações externas. diff --git a/documentation/content/pt-br/books/fdp-primer/overview/_index.po b/documentation/content/pt-br/books/fdp-primer/overview/_index.po index db23a0aa2b..3e964bfc62 100644 --- a/documentation/content/pt-br/books/fdp-primer/overview/_index.po +++ b/documentation/content/pt-br/books/fdp-primer/overview/_index.po @@ -1,349 +1,701 @@ # SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. # Danilo G. Baio , 2021, 2022. msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2022-02-01 09:20-0300\n" -"PO-Revision-Date: 2022-01-20 21:56+0000\n" +"POT-Creation-Date: 2022-07-07 23:22-0300\n" +"PO-Revision-Date: 2022-08-07 18:44+0000\n" "Last-Translator: Danilo G. Baio \n" "Language-Team: Portuguese (Brazil) \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" "X-Generator: Weblate 4.10.1\n" #. type: YAML Front Matter: description #: documentation/content/en/books/fdp-primer/overview/_index.adoc:1 #, no-wrap msgid "Overview about the FreeBSD Documentation Process" msgstr "Visão geral sobre o Processo de Documentação do FreeBSD" #. type: YAML Front Matter: title #: documentation/content/en/books/fdp-primer/overview/_index.adoc:1 #, no-wrap msgid "Chapter 1. Overview" msgstr "Capítulo 1. Visão Geral" #. type: Title = #: documentation/content/en/books/fdp-primer/overview/_index.adoc:13 #, no-wrap msgid "Overview" msgstr "Visão geral" #. type: Plain text #: documentation/content/en/books/fdp-primer/overview/_index.adoc:52 msgid "" "Welcome to the FreeBSD Documentation Project (FDP). Quality documentation " "is crucial to the success of FreeBSD, and we value your contributions very " "highly." msgstr "" "Seja bem vindo ao Projeto de Documentação do FreeBSD.(FDP). Documentação de " "boa qualidade é muito importante para o sucesso do FreeBSD, e nós " "valorizamos muito suas contribuições." #. type: Plain text #: documentation/content/en/books/fdp-primer/overview/_index.adoc:54 msgid "" "This document describes how the FDP is organized, how to write and submit " "documentation, and how to effectively use the available tools." msgstr "" "Este documento descreve como o FDP é organizado, como escrever e como " "submeter documentos, e como utilizar de forma efetiva as ferramentas que " "estão disponíveis." #. type: Plain text #: documentation/content/en/books/fdp-primer/overview/_index.adoc:57 msgid "" "Everyone is welcome to contribute to the FDP. Willingness to contribute is " "the only membership requirement." msgstr "" "Todos são bem vindos para se juntar ao FDP. A vontade de contribuir é o " "único requisito de adesão." #. type: Plain text #: documentation/content/en/books/fdp-primer/overview/_index.adoc:59 msgid "This primer shows how to:" msgstr "Este primer mostra como:" #. type: Plain text #: documentation/content/en/books/fdp-primer/overview/_index.adoc:61 +msgid "Understand the role of documentation and its place in the ecosystem." +msgstr "Compreender o papel da documentação e seu lugar no ecossistema." + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:62 msgid "Identify which parts of FreeBSD are maintained by the FDP." msgstr "Identificar quais partes do FreeBSD são mantidas pelo FDP." #. type: Plain text -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:62 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:63 msgid "Install the required documentation tools and files." msgstr "Instalar as ferramentas e arquivos de documentação necessários." #. type: Plain text -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:63 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:64 msgid "Make changes to the documentation." msgstr "Realizar alterações na documentação." #. type: Plain text -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:64 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:65 msgid "" "Submit changes back for review and inclusion in the FreeBSD documentation." msgstr "" "Enviar de volta alterações para revisão e inclusão na documentação do " "FreeBSD." #. type: Title == -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:66 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:67 +#, no-wrap +msgid "Documentation in the FreeBSD Ecosystem" +msgstr "Documentação no Ecossistema FreeBSD" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:71 +msgid "" +"All documents are for the benefit of their readers, not their writers or " +"caretakers. They should adapt to the reader and not expect the reader to " +"adapt to them." +msgstr "" +"Todos os documentos são para o benefício de seus leitores, não de seus " +"escritores ou zeladores. Eles devem se adaptar ao leitor e não esperar que o " +"leitor se adapte a eles." + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:73 +msgid "Never blame the reader for:" +msgstr "Nunca culpe o leitor por:" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:75 +msgid "being unable to make use of a document easily or at all" +msgstr "ser incapaz de fazer uso de um documento facilmente ou de tudo" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:76 +msgid "finding a document confusing" +msgstr "achar o documento confuso" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:77 +msgid "not understanding a document or how to apply it" +msgstr "não entender o documento ou como utilizá-lo" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:78 +msgid "" +"not finding an explicit answer or successfully bridging gaps (or connecting " +"dots) to reason their way to one" +msgstr "" +"não encontrar uma resposta explícita ou preencher lacunas com sucesso (ou " +"conectando pontos) para raciocinar em direção a uma" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:80 +msgid "Instead, acknowledge that the document is:" +msgstr "Em vez disso, reconheça que o documento é:" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:82 +msgid "inaccessible" +msgstr "inacessível" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:83 +msgid "confusing" +msgstr "confuso" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:84 +msgid "hard to understand or apply" +msgstr "difícil de entender ou utilizar" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:85 +msgid "incomplete" +msgstr "incompleto" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:87 +msgid "Then, make the document:" +msgstr "Em seguida, faça o documento:" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:89 +msgid "more accessible" +msgstr "mais acessível" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:90 +msgid "less confusing" +msgstr "menos confuso" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:91 +msgid "clearer" +msgstr "mais claro" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:92 +msgid "more complete" +msgstr "mais completo" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:94 +msgid "Use the following methods:" +msgstr "Use os seguintes métodos:" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:96 +msgid "" +"apply link:https://webaim.org/intro/#principles[accessibility best " +"practices] to correct the problem reported and any similar ones you find" +msgstr "" +"aplique as link:https://webaim.org/intro/#principles[melhores práticas de " +"acessibilidade] para corrigir o problema relatado e quaisquer outros " +"semelhantes que você encontrar" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:97 +msgid "rework or clarify the confusing structure or language" +msgstr "refazer ou esclarecer a estrutura ou linguagem confusa" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:98 +msgid "add relevant examples to the part that is hard to understand or apply" +msgstr "" +"adicionar exemplos relevantes para a parte que é difícil de entender ou " +"aplicar" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:99 +msgid "fill in the gaps or add the missing stepping stones" +msgstr "preencha as lacunas ou adicione os degraus que faltam" + +#. type: Title == +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:101 #, no-wrap msgid "Quick Start" msgstr "Introdução" #. type: Plain text -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:72 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:107 msgid "" "Some preparatory steps must be taken before editing the FreeBSD " "documentation. First, subscribe to the {freebsd-doc}. Some team members " "also interact on the `#bsddocs` IRC channel on http://www.efnet.org/" "[EFnet]. These people can help with questions or problems involving the " "documentation." msgstr "" "Algumas etapas preparatórias devem ser seguidas antes de editar a " "documentação do FreeBSD. Primeiro, se registre na {freebsd-doc}. Alguns " "membros do time também interagem no IRC, canal `#bsddocs` na rede http://www." "efnet.org/[EFnet]. Estas pessoas podem ajudar com questões e problemas " "envolvendo documentação." +#. type: Title === +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:109 +#, no-wrap +msgid "FreeBSD installation process" +msgstr "Processo de instalação do FreeBSD" + #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:76 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:114 msgid "" "Install these packages. The `docproj` _meta-port_ installs all the " "applications required to do useful work with the FreeBSD documentation." msgstr "" "Instale esses pacotes. O _meta-port_ `docproj` instala todos os aplicativos " "necessários para editar e compilar a documentação do FreeBSD." #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:80 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:118 #, no-wrap msgid "# pkg install docproj\n" msgstr "# pkg install docproj\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:83 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:121 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:189 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:272 msgid "" "Install a local working copy of the documentation from the FreeBSD " "repository in [.filename]#~/doc# (see crossref:working-copy[working-copy,The " "Working Copy])." msgstr "" "Obtenha uma cópia local da árvore de documentação do FreeBSD em [." "filename]#~/doc# (ver crossref:working-copy[working-copy,A Área de " "Trabalho])." #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:87 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:125 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:193 #, no-wrap msgid "% git clone https://git.FreeBSD.org/doc.git ~/doc\n" msgstr "% git clone https://git.FreeBSD.org/doc.git ~/doc\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:90 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:128 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:196 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:279 msgid "" "Edit the documentation files that require changes. If a file needs major " "changes, consult the mailing list for input." msgstr "" "Edite os arquivos de documentação que precisam de alterações. Se um arquivo " "precisar de grandes mudanças, consulte a lista de discussão para obter " "informações." #. type: Plain text -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:93 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:131 msgid "" "Review the output and edit the file to fix any problems shown, then rerun " "the command to find any remaining problems. Repeat until all of the errors " "are resolved." msgstr "" "Revise a saída e edite o arquivo para corrigir os problemas informados e, em " "seguida, execute novamente o comando para verificar os problemas restantes. " "Repita até que todos os erros sejam resolvidos." #. type: Plain text -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:95 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:133 #, no-wrap msgid "*_Always_* build and test the changes before submitting them. Running `make` in the top-level directory of the documentation will generate that documentation in HTML format.\n" msgstr "*_Sempre_* realize testes de compilação antes de submeter algo. Execute `make` no diretório de nível superior da documentação e assim será gerado a documentação no formato HTML.\n" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:99 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:137 #, no-wrap msgid "% make\n" msgstr "% make\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:102 -msgid "When changes are complete and tested, generate a \"diff file\":" +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:140 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:208 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:290 +msgid "" +"Add all the files with `git add .`, then review the diff with `git diff`. " +"For example:" msgstr "" -"Quando as alterações estiverem completas e testadas, gere um \"arquivo diff" -"\":" +"Adicione todos os arquivos com `git add .`, então revise o diff com `git " +"diff`. Por exemplo:" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:107 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:145 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:213 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:295 +#, no-wrap +msgid "" +"% git add .\n" +"% git diff --staged\n" +msgstr "" +"% git add .\n" +"% git diff --staged\n" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:148 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:216 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:298 +msgid "" +"Make sure that all required files are included, then commit the change to " +"your local branch and generate a patch with `git format-patch`" +msgstr "" +"Certifique-se de que todos os arquivos necessários estejam incluídos, então " +"confirme a mudança em seu branch local e gere um patch com `git format-patch`" + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:153 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:221 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:303 #, no-wrap msgid "" -"% cd ~/doc\n" -"% git diff > bsdinstall.diff.txt\n" +"% git commit\n" +"% git format-patch origin/main\n" +msgstr "" +"% git commit\n" +"% git format-patch origin/main\n" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:157 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:225 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:307 +msgid "" +"Patch generated with `git format-patch` will include author identity and " +"email addresses, making it easier for developers to apply (with `git am`) " +"and give proper credit." +msgstr "" +"Patch gerado com `git format-patch` incluirá a identidade do autor e " +"endereços de e-mail, tornando mais fácil para os desenvolvedores aplicarem (" +"com `git am`) e dar os devidos créditos." + +#. type: delimited block = 6 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:162 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:230 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:312 +msgid "" +"To make it easier for committers to apply the patch on their working copy of " +"the documentation tree, please generate the [.filename]#.diff# from the base " +"of your documentation tree." +msgstr "" +"Para tornar mais fácil para os committers aplicarem o patch em sua cópia de " +"trabalho da árvore de documentação, por favor, gere o [.filename]#.diff# da " +"base de sua árvore de documentação." + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:165 +msgid "" +"In the example above, changes have been made to the *bsdinstall* portion of " +"the Handbook." +msgstr "" +"No exemplo acima, foram feitas alterações na parte [.filename]#bsdinstall# " +"do Handbook." + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:167 +msgid "" +"Submit the patch or diff file using the web-based https://bugs.FreeBSD.org/" +"bugzilla/enter_bug.cgi?product=Documentation[Problem Report] system. If " +"using the web form, enter a Summary of _[patch] short description of " +"problem_. Select the Component `Documentation`. In the Description field, " +"enter a short description of the changes and any important details about " +"them. Use the btn:[Add an attachment] button to attach the patch or diff " +"file. Finally, use the btn:[Submit Bug] button to submit your diff to the " +"problem report system." +msgstr "" +"Submeta o patch or arquivo diff pela web para o sistema de https://bugs." +"FreeBSD.org/bugzilla/enter_bug.cgi?product=Documentation[Relatórios de " +"Problema]. Se estiver usando o formulário web, insira um Sumário com _[patch]" +" descrição curta do problema_. Selecione o Componente `Documentation`. No " +"campo de Descrição, insira uma breve descrição das alterações e quaisquer " +"detalhes importantes sobre elas. Use o botão btn:[Add an attachment] para " +"anexar o patch ou arquivo diff. Finalmente, pressione o botão btn:[Submit " +"Bug] para enviar seu diff para o sistema de relatório de problemas." + +#. type: Title === +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:170 +#, no-wrap +msgid "GNU/Linux installation process" +msgstr "Processo de instalação GNU/Linux" + +#. type: delimited block = 6 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:177 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:248 +msgid "Hugo version 0.90 or higher must be used" +msgstr "Hugo versão 0.90 ou superior deve ser utilizado" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:182 +msgid "" +"Install these packages in apt-based systems like Debian or Ubuntu. On other " +"GNU/Linux distributions the package names may change. Consult your " +"distribution's package manager if in doubt." +msgstr "" +"Instale esses pacotes em sistemas baseados em apt como Debian ou Ubuntu. Em " +"outras distribuições GNU/Linux os nomes dos pacotes podem mudar. Consulte o " +"gerenciador de pacotes da sua distribuição em caso de dúvida." + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:186 +#, no-wrap +msgid "# apt install hugo ruby-asciidoctor ruby-asciidoctor-pdf ruby-rouge git bmake\n" +msgstr "" +"# apt install hugo ruby-asciidoctor ruby-asciidoctor-pdf ruby-rouge git " +"bmake\n" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:199 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:282 +msgid "" +"Review the output and edit the files to fix any problems shown, then rerun " +"the command to find any remaining problems. Repeat until all of the errors " +"are resolved." +msgstr "" +"Revise a saída e edite os arquivos para corrigir os problemas informados e, " +"em seguida, execute novamente o comando para verificar os problemas " +"restantes. Repita até que todos os erros sejam resolvidos." + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:201 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:284 +msgid "" +"Always build and test the changes before submitting them. Running `bmake` in " +"the top-level directory of the documentation will generate that " +"documentation in HTML format." msgstr "" -"% cd ~/doc\n" -"% git diff > bsdinstall.diff.txt\n" +"Sempre realize testes de compilação antes de submeter algo. Execute `bmake` " +"no diretório de nível superior da documentação e assim será gerado a " +"documentação no formato HTML." + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:205 +#, no-wrap +msgid "% bmake run LOCALBASE=/usr\n" +msgstr "% bmake run LOCALBASE=/usr\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:111 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:238 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:320 msgid "" -"Give the diff file a descriptive name. In the example above, changes have " -"been made to the [.filename]#bsdinstall# portion of the Handbook." +"Submit the patch or diff file using the web-based https://bugs.FreeBSD.org/" +"bugzilla/enter_bug.cgi?product=Documentation[Problem Report] system. If " +"using the web form, enter a Summary of _short description of problem_. " +"Select the Component `Documentation`. In the Description field, enter a " +"short description of the problem in the _Summary_ field and add _patch_ to " +"the _Keywords_ field. Use the btn:[Add an attachment] button to attach the " +"patch or diff file. Finally, use the btn:[Submit Bug] button to submit your " +"diff to the problem report system." msgstr "" -"Dê ao arquivo diff um nome. No exemplo acima, foram feitas alterações na " -"parte [.filename]#bsdinstall# do Handbook." +"Submeta o patch ou arquivo diff file pela web para o sistema de https://bugs." +"FreeBSD.org/bugzilla/enter_bug.cgi?product=Documentation[Relatórios de " +"Problema]. Se estiver usando o formulário web, insira um Sumário com uma " +"_breve descrição do problema_. Selecione o Componente `Documentation`. No " +"campo de Descrição, insira uma breve descrição das alterações e quaisquer " +"detalhes importantes sobre elas e adicione _patch_ no campo _Keywords_. Use " +"o botão btn:[Add an attachment] para anexar o patch ou arquivo diff. " +"Finalmente, pressione o botão btn:[Submit Bug] para enviar seu diff para o " +"sistema de relatório de problemas." + +#. type: Title === +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:241 +#, no-wrap +msgid "macOS(R) installation process" +msgstr "Processo de instalação do macOS(R)" #. type: Plain text -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:112 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:251 msgid "" -"Submit the diff file using the web-based https://bugs.FreeBSD.org/bugzilla/" -"enter_bug.cgi?product=Documentation[Problem Report] system. If using the web " -"form, enter a Summary of _[patch] short description of problem_. Select the " -"Component `Documentation`. In the Description field, enter a short " -"description of the changes and any important details about them. Use the btn:" -"[Add an attachment] button to attach the diff file. Finally, use the btn:" -"[Submit Bug] button to submit your diff to the problem report system." +"Install these packages using link:https://brew.sh/[Homebrew] and link:" +"https://rubygems.org/[RubyGem]." msgstr "" -"Submeta o arquivo diff file pela web para o sistema de https://bugs.FreeBSD." -"org/bugzilla/enter_bug.cgi?product=Documentation[Relatórios de Problema]. Se " -"estiver usando o formulário web, insira um Sumário com _[patch] descrição " -"curta do problema_. Selecione o Componente `Documentation`. No campo de " -"Descrição, insira uma breve descrição das alterações e quaisquer detalhes " -"importantes sobre elas. Use o botão btn:[Add an attachment] para anexar o " -"arquivo diff. Finalmente, pressione o botão btn:[Submit Bug] para enviar seu " -"diff para o sistema de relatório de problemas." +"Instale esses pacotes usando o link:https://brew.sh/[Homebrew] e o " +"link:https://rubygems.org/[RubyGem]." + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:255 +#, no-wrap +msgid "$ brew install hugo ruby git bmake asciidoctor\n" +msgstr "$ brew install hugo ruby git bmake asciidoctor\n" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:258 +msgid "Add Ruby to the Path." +msgstr "Adicione o Ruby ao Path." + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:262 +#, no-wrap +msgid "$ echo 'export PATH=\"/usr/local/opt/ruby/bin:$PATH\"' >> ~/.zshrc\n" +msgstr "$ echo 'export PATH=\"/usr/local/opt/ruby/bin:$PATH\"' >> ~/.zshrc\n" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:265 +msgid "Install the rouge package using RubyGem." +msgstr "Instale o pacote rouge usando RubyGem." + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:269 +#, no-wrap +msgid "$ sudo gem install rouge\n" +msgstr "$ sudo gem install rouge\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:276 +#, no-wrap +msgid "$ git clone https://git.FreeBSD.org/doc.git ~/doc\n" +msgstr "$ git clone https://git.FreeBSD.org/doc.git ~/doc\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:288 +#, no-wrap +msgid "$ bmake run LOCALBASE=/usr\n" +msgstr "$ bmake run LOCALBASE=/usr\n" #. type: Title == -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:115 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:323 #, no-wrap msgid "The FreeBSD Documentation Set" msgstr "Conjunto de Documentação do FreeBSD" #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:118 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:326 msgid "The FDP is responsible for four categories of FreeBSD documentation." msgstr "O FDP é responsável por quatro categorias de documentação do FreeBSD." #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:120 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:328 msgid "" "_Handbook_: The Handbook is the comprehensive online resource and reference " "for FreeBSD users." msgstr "" "_Handbook_: O Handbook almeja ser um compreensivo recurso de referência " "online para os usuários do FreeBSD." #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:121 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:329 msgid "" "_FAQ_: The FAQ uses a short question and answer format to address questions " "that are frequently asked on the various mailing lists and forums devoted to " "FreeBSD. This format does not permit long and comprehensive answers." msgstr "" "_FAQ_: O FAQ utiliza um formato curto de pergunta e resposta para abordar " "dúvidas que são frequentemente realizadas nas listas de discussão e fóruns " "dedicados ao FreeBSD. Este formato não permite respostas longas e detalhadas." #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:122 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:330 msgid "" "_Manual pages_: The English language system manual pages are usually not " "written by the FDP, as they are part of the base system. However, the FDP " "can reword parts of existing manual pages to make them clearer or to correct " "inaccuracies." msgstr "" "_Páginas de Manual_: As páginas de manual do sistema de língua inglesa " "geralmente não são escritas pelo FDP, pois fazem parte do sistema base. " "Contudo, o FDP pode reformular partes das páginas de manual existentes para " "torná-las mais claras ou para corrigir imprecisões." #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:123 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:331 msgid "" "_Web site_: This is the main FreeBSD presence on the web, visible at https://" "www.freebsd.org/[https://www.FreeBSD.org/] and many mirrors around the " "world. The web site is typically a new user's first exposure to FreeBSD." msgstr "" "_Web site_: Esta é a presença principal do FreeBSD na web, visite https://" "www.freebsd.org/[https://www.FreeBSD.org/] e muitos mirrors ao redor do " "mundo. O site é tipicamente o primeiro contato de um usuário novo com o " "FreeBSD." #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:126 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:334 msgid "" "Translation teams are responsible for translating the Handbook and web site " "into different languages. Manual pages are not translated at present." msgstr "" "As equipes de tradução são responsáveis por traduzir o manual e o site para " "diferentes idiomas. As páginas do manual não são traduzidas no momento." #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:128 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:336 msgid "" "Documentation source for the FreeBSD web site, Handbook, and FAQ is " "available in the documentation repository at `https://cgit.freebsd.org/doc/`." msgstr "" "Código fonte do site do FreeBSD, Handbook, e FAQ estão disponíveis no " "repositório de documentação em `https://cgit.freebsd.org/doc/`." #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:130 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:338 msgid "" "Source for manual pages is available in a separate source repository located " "at `https://cgit.freebsd.org/src/`." msgstr "" "Código fonte das páginas de manual estão disponíveis em um repositório " "diferente localizado em `https://cgit.freebsd.org/src/`." #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:133 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:341 msgid "" "Documentation commit messages are visible with `git log`. Commit messages " -"are also archived at link:{git-doc-all}." +"are also archived at link:{dev-commits-doc-all}." msgstr "" "As mensagens de commit de documentação podem ser visualizadas com `git log`. " -"As mensagens de commit também são arquivadas em link:{git-doc-all}." +"As mensagens de commit também são arquivadas em link:{dev-commits-doc-all}." #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:135 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:343 msgid "" "Web frontends to both of these repositories are available at https://cgit." "freebsd.org/doc/[] and https://cgit.freebsd.org/src/[]." msgstr "" "Endereço web para ambos os repositórios disponíveis em https://cgit.freebsd." "org/doc/[] e https://cgit.freebsd.org/src/[]." #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/overview/_index.adoc:139 +#: documentation/content/en/books/fdp-primer/overview/_index.adoc:347 msgid "" "Many people have written tutorials or how-to articles about FreeBSD. Some " "are stored as part of the FDP files. In other cases, the author has decided " "to keep the documentation separate. The FDP endeavors to provide links to " "as much of this external documentation as possible." msgstr "" "Muitas pessoas tem escrito tutoriais e artigos how-to sobre FreeBSD. Alguns " "são armazenados como parte dos arquivos FDP. Em outros casos, o autor " "decidiu manter a documentação separada. O FDP esforça-se para fornecer links " "para o máximo possível dessas documentações externas." +#~ msgid "When changes are complete and tested, generate a \"diff file\":" +#~ msgstr "" +#~ "Quando as alterações estiverem completas e testadas, gere um \"arquivo " +#~ "diff\":" + +#, no-wrap +#~ msgid "" +#~ "% cd ~/doc\n" +#~ "% git diff > bsdinstall.diff.txt\n" +#~ msgstr "" +#~ "% cd ~/doc\n" +#~ "% git diff > bsdinstall.diff.txt\n" + #~ msgid "" #~ "include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" #~ "{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists." #~ "adoc[] include::shared/{{% lang %}}/urls.adoc[]" #~ msgstr "" #~ "include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" #~ "{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists." #~ "adoc[] include::shared/{{% lang %}}/urls.adoc[]" diff --git a/documentation/content/pt-br/books/fdp-primer/see-also/_index.adoc b/documentation/content/pt-br/books/fdp-primer/see-also/_index.adoc index 4b820410e9..35674384e6 100644 --- a/documentation/content/pt-br/books/fdp-primer/see-also/_index.adoc +++ b/documentation/content/pt-br/books/fdp-primer/see-also/_index.adoc @@ -1,76 +1,76 @@ --- description: 'Mais informações sobre o Projeto de Documentação do FreeBSD' next: books/fdp-primer/examples path: /books/fdp-primer/ -prev: books/fdp-primer/editor-config/ +prev: books/fdp-primer/trademarks/ showBookMenu: 'true' tags: ["additional information", "AsciiDoctor", "HTML"] -title: 'Capítulo 13. Veja também' -weight: 14 +title: 'Capítulo 14. Veja também' +weight: 15 --- [[see-also]] = Veja também :doctype: book :toc: macro :toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 -:sectnumoffset: 13 +:sectnumoffset: 14 :partnums: :source-highlighter: rouge :experimental: :images-path: books/fdp-primer/ ifdef::env-beastie[] ifdef::backend-html5[] :imagesdir: ../../../../images/{images-path} endif::[] ifndef::book[] include::shared/authors.adoc[] include::shared/mirrors.adoc[] include::shared/releases.adoc[] include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists.adoc[] include::shared/{{% lang %}}/urls.adoc[] toc::[] endif::[] ifdef::backend-pdf,backend-epub3[] include::../../../../../shared/asciidoctor.adoc[] endif::[] endif::[] ifndef::env-beastie[] toc::[] include::../../../../../shared/asciidoctor.adoc[] endif::[] Este documento não é deliberadamente uma discussão exaustiva de AsciiDoc e o Projeto de Documentação do FreeBSD. Para mais informações sobre estes, você é encorajado a consultar os seguintes sites. [[see-also-fdp]] == O projeto de documentação do FreeBSD * link:https://www.FreeBSD.org/docproj/[As Páginas Web do Projeto de Documentação do FreeBSD] * extref:{handbook}[O Handbook do FreeBSD] [[see-also-hugo]] == Hugo * link:https://gohugo.io/[Hugo] * link:https://gohugo.io/documentation/[Documentação Hugo] [[see-also-asciidoc]] == AsciiDoctor * link:https://asciidoctor.org/[AsciiDoctor] * link:https://docs.asciidoctor.org/[Portal de Documentação do AsciiDoctor] [[see-also-html]] == HTML * link:http://www.w3.org/[O Consórcio World Wide Web] * link:https://dev.w3.org/html5/spec-LC/[A especificação HTML 5] * link:https://www.w3.org/Style/CSS/specs.en.html[A especificação CSS] * link:https://sass-lang.com/[Sass] diff --git a/documentation/content/pt-br/books/fdp-primer/see-also/_index.po b/documentation/content/pt-br/books/fdp-primer/see-also/_index.po index b05d97daa8..5f941132ab 100644 --- a/documentation/content/pt-br/books/fdp-primer/see-also/_index.po +++ b/documentation/content/pt-br/books/fdp-primer/see-also/_index.po @@ -1,135 +1,135 @@ # SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. # Danilo G. Baio , 2021, 2022. msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2022-02-01 09:20-0300\n" -"PO-Revision-Date: 2022-01-20 21:56+0000\n" +"POT-Creation-Date: 2022-08-07 10:35-0300\n" +"PO-Revision-Date: 2022-08-07 18:44+0000\n" "Last-Translator: Danilo G. Baio \n" "Language-Team: Portuguese (Brazil) \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" "X-Generator: Weblate 4.10.1\n" #. type: YAML Front Matter: description #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:1 #, no-wrap msgid "More information about the FreeBSD Documentation Project" msgstr "Mais informações sobre o Projeto de Documentação do FreeBSD" #. type: YAML Front Matter: title #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:1 #, no-wrap -msgid "Chapter 13. See Also" -msgstr "Capítulo 13. Veja também" +msgid "Chapter 14. See Also" +msgstr "Capítulo 14. Veja também" #. type: Title = #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:13 #, no-wrap msgid "See Also" msgstr "Veja também" #. type: Plain text #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:52 msgid "" "This document is deliberately not an exhaustive discussion of AsciiDoc and " "the FreeBSD Documentation Project. For more information about these, you " "are encouraged to see the following web sites." msgstr "" "Este documento não é deliberadamente uma discussão exaustiva de AsciiDoc e o " "Projeto de Documentação do FreeBSD. Para mais informações sobre estes, você " "é encorajado a consultar os seguintes sites." #. type: Title == #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:54 #, no-wrap msgid "The FreeBSD Documentation Project" msgstr "O projeto de documentação do FreeBSD" #. type: Plain text #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:57 msgid "" "link:https://www.FreeBSD.org/docproj/[The FreeBSD Documentation Project web " "pages]" msgstr "" "link:https://www.FreeBSD.org/docproj/[As Páginas Web do Projeto de " "Documentação do FreeBSD]" #. type: Plain text #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:58 msgid "extref:{handbook}[The FreeBSD Handbook]" msgstr "extref:{handbook}[O Handbook do FreeBSD]" #. type: Title == #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:60 #, no-wrap msgid "Hugo" msgstr "Hugo" #. type: Plain text #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:63 msgid "link:https://gohugo.io/[Hugo]" msgstr "link:https://gohugo.io/[Hugo]" #. type: Plain text #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:64 msgid "link:https://gohugo.io/documentation/[Hugo documentation]" msgstr "link:https://gohugo.io/documentation/[Documentação Hugo]" #. type: Title == #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:66 #, no-wrap msgid "AsciiDoctor" msgstr "AsciiDoctor" #. type: Plain text #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:69 msgid "link:https://asciidoctor.org/[AsciiDoctor]" msgstr "link:https://asciidoctor.org/[AsciiDoctor]" #. type: Plain text #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:70 msgid "link:https://docs.asciidoctor.org/[AsciiDoctor Documentation Portal]" msgstr "" "link:https://docs.asciidoctor.org/[Portal de Documentação do AsciiDoctor]" #. type: Title == #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:72 #, no-wrap msgid "HTML" msgstr "HTML" #. type: Plain text #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:75 msgid "link:http://www.w3.org/[The World Wide Web Consortium]" msgstr "link:http://www.w3.org/[O Consórcio World Wide Web]" #. type: Plain text #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:76 msgid "link:https://dev.w3.org/html5/spec-LC/[The HTML 5 specification]" msgstr "link:https://dev.w3.org/html5/spec-LC/[A especificação HTML 5]" #. type: Plain text #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:77 msgid "link:https://www.w3.org/Style/CSS/specs.en.html[CSS specification]" msgstr "link:https://www.w3.org/Style/CSS/specs.en.html[A especificação CSS]" #. type: Plain text #: documentation/content/en/books/fdp-primer/see-also/_index.adoc:77 msgid "link:https://sass-lang.com/[Sass]" msgstr "link:https://sass-lang.com/[Sass]" #~ msgid "" #~ "include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" #~ "{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists." #~ "adoc[] include::shared/{{% lang %}}/urls.adoc[]" #~ msgstr "" #~ "include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" #~ "{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists." #~ "adoc[] include::shared/{{% lang %}}/urls.adoc[]" diff --git a/documentation/content/pt-br/books/fdp-primer/trademarks/_index.adoc b/documentation/content/pt-br/books/fdp-primer/trademarks/_index.adoc new file mode 100644 index 0000000000..3a3552866b --- /dev/null +++ b/documentation/content/pt-br/books/fdp-primer/trademarks/_index.adoc @@ -0,0 +1,94 @@ +--- +description: 'Diretrizes para marcas registradas no Projeto de Documentação do FreeBSD' +next: books/fdp-primer/see-also +path: /books/fdp-primer/ +prev: books/fdp-primer/editor-config/ +showBookMenu: 'true' +tags: ["trademarks", "AsciiDoctor", "HTML"] +title: 'Chapter 13. Marcas Registradas' +weight: 14 +--- + +[[trademarks]] += Marcas Registradas +:doctype: book +:toc: macro +:toclevels: 1 +:icons: font +:sectnums: +:sectnumlevels: 6 +:sectnumoffset: 13 +:partnums: +:source-highlighter: rouge +:experimental: +:images-path: books/fdp-primer/ + +ifdef::env-beastie[] +ifdef::backend-html5[] +:imagesdir: ../../../../images/{images-path} +endif::[] +ifndef::book[] +include::shared/authors.adoc[] +include::shared/mirrors.adoc[] +include::shared/releases.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +toc::[] +endif::[] +ifdef::backend-pdf,backend-epub3[] +include::../../../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +toc::[] +include::../../../../../shared/asciidoctor.adoc[] +endif::[] + +Para todos os documentos do Projeto de Documentação do FreeBSD, é necessário citar marcas registradas, e isso é dever de todo escritor e colaborador. + +[[trademark-symbols]] +== Símbolos de Marca Registrada + +Adicione um símbolo de marca registrada (TM), (R) ou outros símbolos na primeira ocorrência do nome da empresa ou do software e sempre ao usar logotipos. Além disso, escreva o nome da empresa ou do software seguindo suas diretrizes de marca registrada. + +Em caso de dúvida, pesquise a empresa na Internet ou no website do software, além do link:https://www.uspto.gov/trademarks[site da United States Patent and Trademark Office]. + +[[trademark-citing]] +== Citação de Marca Registrada + +É costume citar marcas registradas em documentação técnica, e o Projeto de Documentação do FreeBSD fornece um template para isso, o que também evita a duplicação de marcas registradas nos documentos. + +Primeiro, verifique o https://cgit.freebsd.org/doc/tree/documentation/themes/beastie/i18n/en.toml#n197[template] do projeto pela marca registrada e adicione-a à tag de marcas registradas na Seção `Front Matter` do documento, que fica no início de cada documento. + +O seguinte é um exemplo de `Front Matter` do artigo extref:{contributing}[Contribuindo com o FreeBSD]: + +.... +--- +title: Contributing to FreeBSD +authors: + - author: Jordan Hubbard + - author: Sam Lawrance + - author: Mark Linimon +description: How to contribute to the FreeBSD Project +trademarks: ["freebsd", "ieee", "general"] +weight: 15 +tags: ["Contributing", "FreeBSD", "Non-Programmer Tasks", "Programmer Tasks"] +--- +.... + +As tags de marca registrada `freebsd`, `ieee` e `general` serão renderizadas automaticamente ao compilar o documento, ficando desta forma: + +.... +FreeBSD is a registered trademark of the FreeBSD Foundation. + +IEEE, POSIX, and 802 are registered trademarks of Institute of Electrical and Electronics Engineers, Inc. in the United States. + +Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this document, and the FreeBSD Project was aware of the trademark claim, the designations have been followed by the “™” or the “®” symbol. +.... + +Caso a marca não esteja presente no template do projeto, ela deve ser submetida. Qualquer desenvolvedor ou colaborador pode atualizar as marcas registradas. + +As tags de marca registrada `freebsd` e `general` geralmente estão presentes em todos os documentos. diff --git a/documentation/content/pt-br/books/fdp-primer/trademarks/_index.po b/documentation/content/pt-br/books/fdp-primer/trademarks/_index.po new file mode 100644 index 0000000000..9c310f1cd7 --- /dev/null +++ b/documentation/content/pt-br/books/fdp-primer/trademarks/_index.po @@ -0,0 +1,208 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR The FreeBSD Project +# This file is distributed under the same license as the FreeBSD Documentation package. +# FIRST AUTHOR , YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: FreeBSD Documentation VERSION\n" +"POT-Creation-Date: 2022-08-07 10:35-0300\n" +"PO-Revision-Date: 2022-08-07 19:04+0000\n" +"Last-Translator: Danilo G. Baio \n" +"Language-Team: Portuguese (Brazil) \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" +"X-Generator: Weblate 4.10.1\n" + +#. type: YAML Front Matter: description +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:1 +#, no-wrap +msgid "Guidelines for trademarks in the FreeBSD Documentation Project" +msgstr "" +"Diretrizes para marcas registradas no Projeto de Documentação do FreeBSD" + +#. type: YAML Front Matter: title +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:1 +#, no-wrap +msgid "Chapter 13. Trademarks" +msgstr "Chapter 13. Marcas Registradas" + +#. type: Title = +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:13 +#, no-wrap +msgid "Trademarks" +msgstr "Marcas Registradas" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:51 +msgid "" +"For all documents on the FreeBSD Documentation Project, it is necessary to " +"cite registered trademarks, and that is a duty of every writer and " +"contributor." +msgstr "" +"Para todos os documentos do Projeto de Documentação do FreeBSD, é necessário " +"citar marcas registradas, e isso é dever de todo escritor e colaborador." + +#. type: Title == +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:53 +#, no-wrap +msgid "Trademark Symbols" +msgstr "Símbolos de Marca Registrada" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:57 +msgid "" +"Add a registered trademark symbol (TM), (R), or other symbols in the first " +"occurrence of the company or software name, and always when using logos. " +"Also, write the company or software name following its trademark guidelines." +msgstr "" +"Adicione um símbolo de marca registrada (TM), (R) ou outros símbolos na " +"primeira ocorrência do nome da empresa ou do software e sempre ao usar " +"logotipos. Além disso, escreva o nome da empresa ou do software seguindo " +"suas diretrizes de marca registrada." + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:59 +msgid "" +"When in doubt, research the company on the Internet or the software's " +"website in addition to the link:https://www.uspto.gov/trademarks[United " +"States Patent and Trademark Office site]." +msgstr "" +"Em caso de dúvida, pesquise a empresa na Internet ou no website do software, " +"além do link:https://www.uspto.gov/trademarks[site da United States Patent " +"and Trademark Office]." + +#. type: Title == +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:61 +#, no-wrap +msgid "Trademark Citing" +msgstr "Citação de Marca Registrada" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:64 +msgid "" +"It is customary to cite trademarks in technical documentation, and the " +"FreeBSD Documentation Project provides a template for it, which also avoids " +"duplicating trademarks in the documents." +msgstr "" +"É costume citar marcas registradas em documentação técnica, e o Projeto de " +"Documentação do FreeBSD fornece um template para isso, o que também evita a " +"duplicação de marcas registradas nos documentos." + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:66 +msgid "" +"First, check the project's " +"link:https://cgit.freebsd.org/doc/tree/documentation/themes/beastie/i18n/en.toml#n197[template] " +"for the trademark and then add it to the trademarks tag on the `Front " +"Matter` section of the document, placed at the beginning of each document." +msgstr "" +"Primeiro, verifique o https://cgit.freebsd.org/doc/tree/documentation/themes/" +"beastie/i18n/en.toml#n197[template] do projeto pela marca registrada e " +"adicione-a à tag de marcas registradas na Seção `Front Matter` do documento, " +"que fica no início de cada documento." + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:68 +msgid "" +"The following is an example of the `Front Matter` of the " +"extref:{contributing}[Contributing to FreeBSD] article:" +msgstr "" +"O seguinte é um exemplo de `Front Matter` do artigo extref:{contributing}[" +"Contribuindo com o FreeBSD]:" + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:70 +#, no-wrap +msgid "---\n" +msgstr "---\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:80 +#, no-wrap +msgid "" +"title: Contributing to FreeBSD\n" +"authors:\n" +" - author: Jordan Hubbard\n" +" - author: Sam Lawrance\n" +" - author: Mark Linimon\n" +"description: How to contribute to the FreeBSD Project\n" +"trademarks: [\"freebsd\", \"ieee\", \"general\"]\n" +"weight: 15\n" +"tags: [\"Contributing\", \"FreeBSD\", \"Non-Programmer Tasks\", \"Programmer " +"Tasks\"]\n" +"---\n" +msgstr "" +"title: Contributing to FreeBSD\n" +"authors:\n" +" - author: Jordan Hubbard\n" +" - author: Sam Lawrance\n" +" - author: Mark Linimon\n" +"description: How to contribute to the FreeBSD Project\n" +"trademarks: [\"freebsd\", \"ieee\", \"general\"]\n" +"weight: 15\n" +"tags: [\"Contributing\", \"FreeBSD\", \"Non-Programmer Tasks\", \"Programmer " +"Tasks\"]\n" +"---\n" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:84 +msgid "" +"The trademark tags `freebsd`, `ieee`, and `general` will be automatically " +"rendered when building the document like this:" +msgstr "" +"As tags de marca registrada `freebsd`, `ieee` e `general` serão renderizadas " +"automaticamente ao compilar o documento, ficando desta forma:" + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:87 +#, no-wrap +msgid "FreeBSD is a registered trademark of the FreeBSD Foundation.\n" +msgstr "FreeBSD is a registered trademark of the FreeBSD Foundation.\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:89 +#, no-wrap +msgid "" +"IEEE, POSIX, and 802 are registered trademarks of Institute of Electrical " +"and Electronics Engineers, Inc. in the United States.\n" +msgstr "" +"IEEE, POSIX, and 802 are registered trademarks of Institute of Electrical " +"and Electronics Engineers, Inc. in the United States.\n" + +#. type: delimited block . 4 +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:91 +#, no-wrap +msgid "" +"Many of the designations used by manufacturers and sellers to distinguish " +"their products are claimed as trademarks. Where those designations appear in " +"this document, and the FreeBSD Project was aware of the trademark claim, the " +"designations have been followed by the “™” or the “®” symbol.\n" +msgstr "" +"Many of the designations used by manufacturers and sellers to distinguish " +"their products are claimed as trademarks. Where those designations appear in " +"this document, and the FreeBSD Project was aware of the trademark claim, the " +"designations have been followed by the “™” or the “®” symbol.\n" + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:95 +msgid "" +"If a trademark is not present in the project's template, it must be " +"submitted. Any developer or contributor can update the trademarks." +msgstr "" +"Caso a marca não esteja presente no template do projeto, ela deve ser " +"submetida. Qualquer desenvolvedor ou colaborador pode atualizar as marcas " +"registradas." + +#. type: Plain text +#: documentation/content/en/books/fdp-primer/trademarks/_index.adoc:96 +msgid "" +"The `freebsd` and `general` trademark tags are usually present in all " +"documents." +msgstr "" +"As tags de marca registrada `freebsd` e `general` geralmente estão presentes " +"em todos os documentos." diff --git a/documentation/content/pt-br/books/fdp-primer/writing-style/_index.po b/documentation/content/pt-br/books/fdp-primer/writing-style/_index.po index 02b9ae8377..651b767592 100644 --- a/documentation/content/pt-br/books/fdp-primer/writing-style/_index.po +++ b/documentation/content/pt-br/books/fdp-primer/writing-style/_index.po @@ -1,753 +1,753 @@ # SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. # Danilo G. Baio , 2021, 2022. msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" "POT-Creation-Date: 2022-02-01 10:28-0300\n" -"PO-Revision-Date: 2022-02-06 18:42+0000\n" +"PO-Revision-Date: 2022-08-07 18:44+0000\n" "Last-Translator: Danilo G. Baio \n" "Language-Team: Portuguese (Brazil) \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" "X-Generator: Weblate 4.10.1\n" #. type: YAML Front Matter: description #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:1 #, no-wrap msgid "Writing Style and some conventions used in the FreeBSD Documentation Project" msgstr "Estilo de Escrita e algumas convenções usadas no Projeto de Documentação do FreeBSD" #. type: YAML Front Matter: title #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:1 #, no-wrap msgid "Chapter 11. Writing Style" msgstr "Capítulo 11. Estilo de Escrita" #. type: Title = #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:13 #, no-wrap msgid "Writing Style" msgstr "Estilo de escrita" #. type: Title == #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:51 #, no-wrap msgid "Tips" msgstr "Dicas" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:56 msgid "" "Technical documentation can be improved by consistent use of several " "principles. Most of these can be classified into three goals: _be clear_, " "_be complete_, and _be concise_. These goals can conflict with each other. " "Good writing consists of a balance between them." msgstr "" "A documentação técnica pode ser melhorada pelo uso consistente de vários " "princípios. A maioria destes pode ser classificada em três objetivos: _ser " "claro_, _ser completo_ e _ser conciso_. Essas metas podem entrar em conflito " "umas com as outras. Uma boa escrita consiste em um equilíbrio entre eles." #. type: Title === #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:58 #, no-wrap msgid "Be Clear" msgstr "Seja claro" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:63 msgid "" "Clarity is extremely important. The reader may be a novice, or reading the " "document in a second language. Strive for simple, uncomplicated text that " "clearly explains the concepts." msgstr "" "A clareza é extremamente importante. O leitor pode ser um novato ou ler o " "documento em um segundo idioma. Esforce-se por um texto simples e " "descomplicado que explique claramente os conceitos." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:67 msgid "" "Avoid flowery or embellished speech, jokes, or colloquial expressions. " "Write as simply and clearly as possible. Simple text is easier to " "understand and translate." msgstr "" "Evite discurso florido ou embelezado, piadas ou expressões coloquiais. " "Escreva da maneira mais simples e clara possível. Um texto simples é mais " "fácil de se entender e de se traduzir." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:72 msgid "" "Keep explanations as short, simple, and clear as possible. Avoid empty " "phrases like \"in order to\", which usually just means \"to\". Avoid " "potentially patronizing words like \"basically\". Avoid Latin terms like " "\"i.e.,\" or \"cf.\", which may be unknown outside of academic or scientific " "groups." msgstr "" "Mantenha as explicações o mais curtas, simples e claras possíveis. Evite " "frases vazias como \"a fim de\" as quais normalmente significam apenas um " "\"para\". Evite palavras potencialmente paternalistas tais como \"basicamente" "\". Evite termos latinos como \"i.e.\" ou \"cf.\", os quais podem ser " "desconhecidos fora de grupos acadêmicos ou científicos." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:76 msgid "" "Write in a formal style. Avoid addressing the reader as \"you\". For " "example, say \"copy the file to [.filename]#/tmp#\" rather than \"you can " "copy the file to [.filename]#/tmp#\"." msgstr "" "Escreva em um estilo formal. Evite dirigir-se ao leitor como \"você\". Por " "exemplo, digamos \"copie o arquivo para /tmp\" em vez de \"você pode copiar " "o arquivo para /tmp\"." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:84 msgid "" "Give clear, correct, _tested_ examples. A trivial example is better than no " "example. A good example is better yet. Do not give bad examples, " "identifiable by apologies or sentences like \"but really it should never be " "done that way\". Bad examples are worse than no examples. Give good " "examples, because _even when warned not to use the example as shown_, the " "reader will usually just use the example as shown." msgstr "" "Dê exemplos claros, corretos, e _testados_. Um exemplo trivial é melhor do " "que nenhum exemplo. Um bom exemplo é ainda melhor. Não dê exemplos ruins, " "identificáveis por desculpas ou frases como \"mas realmente isso nunca deve " "ser feito dessa forma\". Exemplos ruins são piores que nenhum exemplo. Dê " "bons exemplos, porque _mesmo quando avisado para não usar o exemplo como " "mostrado_ , o leitor normalmente só usa o exemplo como mostrado." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:87 msgid "" "Avoid _weasel words_ like \"should\", \"might\", \"try\", or \"could\". " "These words imply that the speaker is unsure of the facts, and create doubt " "in the reader." msgstr "" "Evite palavras vazias como \"deveria\", \"poderia\", \"tentaria\", ou \"podia" "\". Estas palavras implicam que o autor não tem certeza dos fatos e cria " "dúvidas no leitor." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:89 msgid "" "Similarly, give instructions as imperative commands: not \"you should do this" "\", but merely \"do this\"." msgstr "" "Da mesma forma, dê instruções como comandos imperativos: não utilize \"você " "deve fazer isso\", mas apenas \"faça isso\"." #. type: Title === #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:91 #, no-wrap msgid "Be Complete" msgstr "Seja completo" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:97 msgid "" "Do not make assumptions about the reader's abilities or skill level. Tell " "them what they need to know. Give links to other documents to provide " "background information without having to recreate it. Put yourself in the " "reader's place, anticipate the questions they will ask, and answer them." msgstr "" "Não faça suposições sobre as habilidades do leitor. Diga-lhes o que precisam " "saber. Dê links para outros documentos para fornecer informações básicas sem " "precisar recriá-las. Coloque-se no lugar do leitor, antecipe as perguntas " "que eles farão e responda-os." #. type: Title === #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:99 #, no-wrap msgid "Be Concise" msgstr "Seja conciso" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:107 msgid "" "While features should be documented completely, sometimes there is so much " "information that the reader cannot easily find the specific detail needed. " "The balance between being complete and being concise is a challenge. One " "approach is to have an introduction, then a \"quick start\" section that " "describes the most common situation, followed by an in-depth reference " "section." msgstr "" "Embora as funcionalidades devam ser documentadas completamente, às vezes " "existe tanta informação que o leitor não consegue encontrar facilmente os " "detalhes específicos de que necessita. O equilíbrio entre ser completo e ser " "conciso é um desafio. Uma abordagem é ter uma introdução e, em seguida, uma " "seção de \"início rápido\" que descreve a situação mais comum, seguida por " "uma seção de referência aprofundada." #. type: Title == #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:109 #, no-wrap msgid "Guidelines" msgstr "Diretrizes" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:113 msgid "" "To promote consistency between the myriad authors of the FreeBSD " "documentation, some guidelines have been drawn up for authors to follow." msgstr "" "Para promover a consistência entre os inúmeros autores da documentação do " "FreeBSD, algumas diretrizes foram elaboradas para os autores seguirem." #. type: Labeled list #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:114 #, no-wrap msgid "Use American English Spelling" msgstr "Use a Ortografia do Inglês Americano" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:118 msgid "" "There are several variants of English, with different spellings for the same " "word. Where spellings differ, use the American English variant. \"color\", " "not \"colour\", \"rationalize\", not \"rationalise\", and so on." msgstr "" "Existem várias variantes do Inglês, com grafias diferentes para a mesma " "palavra. Onde as grafias diferem, use a variante do Inglês Americano. \"color" "\", não \"colour\", \"rationalize\", não \"rationalise\", e assim por diante." #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:124 msgid "" "The use of British English may be accepted in the case of a contributed " "article, however the spelling must be consistent within the whole document. " "The other documents such as books, web site, manual pages, etc. will have to " "use American English." msgstr "" "O uso do Inglês Britânico pode ser aceito no caso de um artigo contribuído, " "no entanto, a ortografia deve ser consistente em todo o documento. Os outros " "documentos, como livros, site, páginas de manual, etc., terão que usar o " "Inglês Americano." #. type: Labeled list #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:126 #, no-wrap msgid "Do not use contractions" msgstr "Não use contrações" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:130 msgid "" "Do not use contractions. Always spell the phrase out in full. \"Don't use " "contractions\" is wrong." msgstr "" "Não use contrações. Sempre soletre a frase na íntegra. \"Do not\" é a forma " "correta, \"Don't\" é a errada." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:132 msgid "" "Avoiding contractions makes for a more formal tone, is more precise, and is " "slightly easier for translators." msgstr "" "Evitar contrações contribui para um tom mais formal, é mais preciso e é um " "pouco mais fácil para os tradutores." #. type: Labeled list #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:133 #, no-wrap msgid "Use the serial comma" msgstr "Use a vírgula serial" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:136 msgid "" "In a list of items within a paragraph, separate each item from the others " "with a comma. Separate the last item from the others with a comma and the " "word \"and\"." msgstr "" "Em uma lista de itens dentro de um parágrafo, separe cada item dos outros " "com uma vírgula. Separe o último item dos outros com uma vírgula e a letra " "\"e\"." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:138 msgid "For example:" msgstr "Por exemplo:" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:140 msgid "This is a list of one, two and three items." msgstr "Esta é uma lista de um, dois e três itens." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:142 msgid "" "Is this a list of three items, \"one\", \"two\", and \"three\", or a list of " "two items, \"one\" and \"two and three\"?" msgstr "" "Esta é uma lista de três itens, \"um\", \"dois\", e \"três\", ou uma lista " "de dois itens, \"um\" e \"dois\" e \"três\"?" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:144 msgid "It is better to be explicit and include a serial comma:" msgstr "É melhor ser explícito e incluir uma vírgula serial:" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:146 msgid "This is a list of one, two, and three items." msgstr "Esta é uma lista de um, dois, e três itens." #. type: Labeled list #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:146 #, no-wrap msgid "Avoid redundant phrases" msgstr "Evite frases redundantes" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:149 msgid "" "Do not use redundant phrases. In particular, \"the command\", \"the file\", " "and \"man command\" are often redundant." msgstr "" "Não use frases redundantes. Em particular, \"the command\", \"the file\", e " "\"man command\" são frequentemente redundantes." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:151 msgid "For example, commands:" msgstr "Por exemplo, comandos:" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:153 msgid "Wrong: Use the `git` command to update sources." msgstr "Errado: Use o comando `git` para atualizar o código fonte." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:155 msgid "Right: Use `git` to update sources." msgstr "Correto: Use o `git` para atualizar o código fonte." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:157 msgid "Filenames:" msgstr "Nomes de arquivo:" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:159 msgid "Wrong: ... in the filename [.filename]#/etc/rc.local#..." msgstr "Errado: ... no nome do arquivo [.filename]#/etc/rc.local#..." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:161 msgid "Right: ... in [.filename]#/etc/rc.local#..." msgstr "Correto: ... no [.filename]#/etc/rc.local#..." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:163 msgid "" "Manual page references (the second example uses `citerefentry` with the man:" "csh[1] entity):." msgstr "" "Referências de páginas de manual (o segundo exemplo usa `citerefentry` com a " "entidade man:csh[1]):." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:165 msgid "Wrong: See `man csh` for more information." msgstr "Errado: veja `man csh` para mais informações." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:167 msgid "Right: See man:csh[1]." msgstr "Certo: Veja man:csh[1]." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:169 msgid "" "For more information about writing style, see http://www.bartleby.com/141/" "[Elements of Style], by William Strunk." msgstr "" "Para mais informações sobre o estilo de escrita, consulte http://www." "bartleby.com/141/[Elements of Style], de William Strunk." #. type: Title == #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:171 #, no-wrap msgid "Style Guide" msgstr "Guia de estilo" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:174 msgid "" "To keep the source for the documentation consistent when many different " "people are editing it, please follow these style conventions." msgstr "" "Para manter o código fonte da documentação consistente quando muitas pessoas " "diferentes a estiverem editando, siga estas convenções de estilo." #. type: Title == #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:176 #, no-wrap msgid "One sentence per line" msgstr "Uma frase por linha" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:181 msgid "" "Use Semantic Line Breaks in the documentation, a technique called \"one " "sentence per line\". The idea of this technique is to help the users to " "write and read documentation. To get more information about this technique " "read the link:https://sembr.org/[Semantic Line Breaks] page." msgstr "" "Use quebras de linha semântica na documentação, uma técnica chamada \"uma " "frase por linha\". A ideia dessa técnica é ajudar os usuários a escrever e " "ler a documentação. Para obter mais informações sobre essa técnica, leia a " "página link:https://sembr.org/[Semantic Line Breaks]." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:183 msgid "This is an example which don't use \"one sentence per line\"." msgstr "Este é um exemplo que não usa \"uma frase por linha\"." #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:186 #, no-wrap msgid "All human beings are born free and equal in dignity and rights. They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.\n" msgstr "All human beings are born free and equal in dignity and rights. They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.\n" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:189 msgid "And this is an example which uses the technique." msgstr "E este é um exemplo que usa a técnica." #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:193 #, no-wrap msgid "" "All human beings are born free and equal in dignity and rights.\n" "They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.\n" msgstr "" "All human beings are born free and equal in dignity and rights.\n" "They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.\n" #. type: Title === #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:196 #, no-wrap msgid "Acronyms" msgstr "Siglas" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:201 msgid "" "Acronyms should be defined the first time they appear in a document, as in: " "\"Network Time Protocol (NTP)\". After the acronym has been defined, use " "the acronym alone unless it makes more sense contextually to use the whole " "term. Acronyms are usually defined only once per chapter or per document." msgstr "" "As siglas devem ser definidas na primeira vez que aparecerem em um " "documento, como em: \"Network Time Protocol (NTP)\". Depois que o acrônimo " "tiver sido definido, use apenas a sigla, a menos que faça mais sentido " "contextualmente usar todo o termo. Siglas geralmente são definidos apenas " "uma vez por capítulo ou por documento." #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:203 msgid "All acronyms should be enclosed using the ` character." msgstr "Todas as siglas devem ser incluídas com o caractere `." #. type: Title == #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:205 #, no-wrap msgid "Special Character List" msgstr "Lista de Caracteres Especiais" #. type: Plain text #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:209 msgid "" "This list of special characters shows the correct syntax and the output when " "used in FreeBSD documentation. If a character is not on this list, ask " "about it on the {freebsd-doc}." msgstr "" "Esta lista de caracteres especiais mostra a sintaxe correta e a saída quando " "usada na documentação do FreeBSD. Se um caractere não está nesta lista, " "pergunte sobre ele na {freebsd-doc}." #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:214 #, no-wrap msgid "Name" msgstr "Nome" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:215 #, no-wrap msgid "Syntax" msgstr "Sintaxe" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:218 #, no-wrap msgid "Rendered" msgstr "Renderizado" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:219 -#, fuzzy, no-wrap +#, no-wrap msgid "Copyright" msgstr "Copyright" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:220 #, no-wrap msgid "+(C)+" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:222 #, no-wrap msgid "(C)" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:223 #, no-wrap msgid "Registered" msgstr "Registrado" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:224 #, no-wrap msgid "+(R)+" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:226 #, no-wrap msgid "(R)" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:227 #, no-wrap msgid "Trademark" msgstr "Marca Comercial" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:228 #, no-wrap msgid "+(TM)+" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:230 #, no-wrap msgid "(TM)" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:231 #, no-wrap msgid "Em dash" msgstr "Travessão" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:232 #, no-wrap msgid "+--+" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:234 #, no-wrap msgid "--" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:235 #, no-wrap msgid "Ellipses" msgstr "Elipses" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:236 #, no-wrap msgid "+...+" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:238 #, no-wrap msgid "..." msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:239 #, no-wrap msgid "Single right arrow" msgstr "Seta simples para a direita" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:240 #, no-wrap msgid "+->+" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:242 #, no-wrap msgid "->" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:243 #, no-wrap msgid "Double right arrow" msgstr "Seta dupla para a direita" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:244 #, no-wrap msgid "+=>+" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:246 #, no-wrap msgid "=>" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:247 #, no-wrap msgid "Single left arrow" msgstr "Seta simples para a esquerda" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:248 #, no-wrap msgid "+<-+" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:250 #, no-wrap msgid "<-" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:251 #, no-wrap msgid "Double left arrow" msgstr "Seta dupla para a esquerda" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:252 #, no-wrap msgid "+<=+" msgstr "" #. type: Table #: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:254 #, no-wrap msgid "<=" msgstr "" #, no-wrap #~ msgid "" #~ "| Name\n" #~ "| Syntax\n" #~ "| Rendered\n" #~ "\n" #~ "\n" #~ "| Copyright\n" #~ "| +(C)+\n" #~ "| (C)\n" #~ "\n" #~ "| Registered\n" #~ "| +(R)+\n" #~ "| (R)\n" #~ "\n" #~ "| Trademark\n" #~ "| +(TM)+\n" #~ "| (TM)\n" #~ "\n" #~ "| Em dash\n" #~ "| +--+\n" #~ "| --\n" #~ "\n" #~ "| Ellipses\n" #~ "| +...+\n" #~ "| ...\n" #~ "\n" #~ "| Single right arrow\n" #~ "| +->+\n" #~ "| ->\n" #~ "\n" #~ "| Double right arrow\n" #~ "| +=>+\n" #~ "| =>\n" #~ "\n" #~ "| Single left arrow\n" #~ "| +<-+\n" #~ "| <-\n" #~ "\n" #~ "| Double left arrow\n" #~ "| +<=+\n" #~ "| <=\n" #~ "\n" #~ msgstr "" #~ "| Nome\n" #~ "| Sintaxe\n" #~ "| Renderizado\n" #~ "\n" #~ "\n" #~ "| Copyright\n" #~ "| +(C)+\n" #~ "| (C)\n" #~ "\n" #~ "| Registrado\n" #~ "| +(R)+\n" #~ "| (R)\n" #~ "\n" #~ "| Marca Comercial\n" #~ "| +(TM)+\n" #~ "| (TM)\n" #~ "\n" #~ "| Travessão\n" #~ "| +--+\n" #~ "| --\n" #~ "\n" #~ "| Elipses\n" #~ "| +...+\n" #~ "| ...\n" #~ "\n" #~ "| Seta simples para a direita\n" #~ "| +->+\n" #~ "| ->\n" #~ "\n" #~ "| Seta dupla para a direita\n" #~ "| +=>+\n" #~ "| =>\n" #~ "\n" #~ "| Seta simples para a esquerda\n" #~ "| +<-+\n" #~ "| <-\n" #~ "\n" #~ "| Seta dupla para a esquerda\n" #~ "| +<=+\n" #~ "| <=\n" #~ "\n" #~ msgid "" #~ "include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" #~ "{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists." #~ "adoc[] include::shared/{{% lang %}}/urls.adoc[]" #~ msgstr "" #~ "include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" #~ "{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists." #~ "adoc[] include::shared/{{% lang %}}/urls.adoc[]"