Path: blob/main/documentation/content/pt-br/books/fdp-primer/doc-build/_index.po
18099 views
# 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 <[email protected]>, 2021, 2022, 2023. # "Danilo G. Baio" <[email protected]>, 2023, 2025. msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" "POT-Creation-Date: 2025-01-24 10:22-0300\n" "PO-Revision-Date: 2025-01-24 14:23+0000\n" "Last-Translator: \"Danilo G. Baio\" <[email protected]>\n" "Language-Team: Portuguese (Brazil) <https://translate-dev.freebsd.org/" "projects/documentation/booksfdp-primerdoc-build_index/pt_BR/>\n" "Language: pt_BR\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n > 1;\n" "X-Generator: Weblate 4.17\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 English and Spanish documentation with verbose and debug messages" msgstr "Compile a documentação em Inglês e Espanhol 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 DOC_LANG=\"en es\" HUGO_ARGS=\"--verbose --debug\"\n" msgstr "" "% cd ~/doc/documentation\n" "% make DOC_LANG=\"en es\" HUGO_ARGS=\"--verbose --debug\"\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 and port:" msgstr "" "Para servir o conteúdo com o servidor web interno do Hugo em um endereço IP " "e porta específicos:" #. 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 HUGO_ARGS=\"-p 8080\"\n" msgstr "% make run BIND=192.168.15.10 HUGO_ARGS=\"-p 8080\"\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: Block title #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:155 #, no-wrap msgid "Build documentation in html for offline usage" msgstr "Compile a documentação em html para uso offline" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:162 #, no-wrap msgid "" "% cd ~/doc/documentation\n" "% make html\n" msgstr "" "% cd ~/doc/documentation\n" "% make html\n" #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:165 msgid "To compress the html output, add `DOC_HTML_ARCHIVE=1`:" msgstr "Para compactar a saída em html, adicione `DOC_HTML_ARCHIVE=1`:" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:170 #, no-wrap msgid "" "% cd ~/doc/documentation\n" "% DOC_HTML_ARCHIVE=1 make html\n" msgstr "" "% cd ~/doc/documentation\n" "% DOC_HTML_ARCHIVE=1 make html\n" #. type: Title === #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:174 #, no-wrap msgid "Rendering to pdf" msgstr "Renderizando em pdf" #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:177 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:179 #, 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:186 #, 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:190 #, 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:197 #, 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:201 #, 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:208 #, 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:212 #, 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:219 #, 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:221 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:226 #, 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:228 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:231 #, 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:234 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:236 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:237 msgid "Hugo" msgstr "Hugo" #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:238 msgid "AsciiDoctor" msgstr "AsciiDoctor" #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:239 msgid "Git" msgstr "Git" #. type: Title == #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:241 #, 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:244 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:246 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:247 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:248 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:251 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:253 #, no-wrap msgid "Documentation Makefile" msgstr "Makefile da Documentação" #. type: delimited block = 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:256 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:281 #, no-wrap msgid "" "# Generate the FreeBSD documentation\n" "#\n" "# Copyright (c) 2020-2025, The FreeBSD Documentation Project\n" "# Copyright (c) 2020-2025, Sergio Carlavilla <[email protected]>\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-2025, The FreeBSD Documentation Project\n" "# Copyright (c) 2020-2025, Sergio Carlavilla <[email protected]>\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:283 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:565 #, no-wrap msgid "[email protected] <.>\n" msgstr "[email protected] <.>\n" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:288 #, 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:291 #, 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:293 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:570 #, 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:300 #, 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:310 #, 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:313 #, 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:317 #, 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:327 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:586 #, 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:334 #, 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:341 #, 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:350 #, 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:352 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:607 #, 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:357 #, 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:360 #, 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:363 #, 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:370 #, 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:375 #, 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:380 #, 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:387 #, 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:389 #, 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:392 #, 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:396 #, 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:399 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:641 #, 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:402 #, 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:405 #, 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:408 #, 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:414 #, 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:419 #, 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:424 #, 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:426 #, 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:433 #, 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:442 #, 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:447 #, 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:449 #, 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:453 #, 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:459 #, 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:464 #, 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:474 #, 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:480 #, 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:486 #, 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:499 #, 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:512 #, 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:514 #, 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:521 #, 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:530 #, 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:533 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:655 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:534 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:535 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:656 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:536 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:657 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:537 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:658 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:538 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:539 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:660 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:540 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:663 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:541 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:543 #, no-wrap msgid "Website Makefile" msgstr "Makefile do Website" #. type: Plain text #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:546 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:563 #, no-wrap msgid "" "# Generate the FreeBSD website\n" "#\n" "# Copyright (c) 2020-2025, The FreeBSD Documentation Project\n" "# Copyright (c) 2020-2025, Sergio Carlavilla <[email protected]>\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-2025, The FreeBSD Documentation Project\n" "# Copyright (c) 2020-2025, Sergio Carlavilla <[email protected]>\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:568 #, 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:576 #, 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:596 #, 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:605 #, 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:613 #, 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:617 #, 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:624 #, 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:629 #, 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:631 #, 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:634 #, 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:638 #, 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:643 #, 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:646 #, 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:649 #, 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:652 #, 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:659 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:662 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:663 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::[]"