The translation is temporarily closed for contributions due to maintenance, please come back later.
Zen

Translation

type: delimited block -
antora generate site.yml
25/250 · 25

This translation is currently locked.

English Portuguese (Brazil) Actions
Building a local preview
Construindo uma pré-visualização local
Because the documentation site is using a markup language instead of a WYSIWYG editor, the sources do not look exactly like the rendered page will. Therefore it is necessary to check that your changes look the way you want them to before you push and make a pull request. This involves building a local preview.
Como o site de documentação está usando uma linguagem de marcação em vez de um editor WYSIWYG, os fontes não se parecem exatamente com a página renderizada. Portanto, é necessário verificar se suas alterações têm a aparência que você deseja antes de enviar e fazer um pull request. Isso envolve a construção de uma pré-visualização local.
There are two shell scripts available in each existing repository (including the template repository used to create new content): `build.sh` and `preview.sh`.
Existem dois scripts de shell disponíveis em cada repositório existente (incluindo o repositório de modelo usado para criar novo conteúdo): `build.sh` e `preview.sh`.
To preview, run the `build.sh` script; this is the one that actually builds a local version of the site (or, more precisely, the subset of the full site that resides in your current repository). Then, run `preview.sh`, which starts a webserver and serves the site at link:http://localhost:8080/[]. Opening this URL in any web browser will show you the preview, which will be available until you kill the process (kbd:[Ctrl+C] in the terminal).
Para pré-visualizar, execute o script `build.sh`; este é o que realmente constrói uma versão local do site (ou, mais precisamente, o subconjunto do site completo que reside em seu repositório atual). Em seguida, execute `preview.sh`, que inicia um servidor web e serve o site no link:http://localhost:8080/[]. Abrir esta URL em qualquer navegador da web mostrará a pré-visualização, que estará disponível até você encerrar o processo (kbd:[Ctrl+C] no terminal).
To run the scripts you'll need to install [application]`Podman` if using a Linux OS such as Fedora or [application]`Docker CE` if using macOS.
Para executar os scripts, você precisará instalar [application]`Podman` se estiver usando um sistema operacional Linux, tal como o Fedora, ou [application]`Docker CE` se estiver usando o macOS.
Previewing multiple repositories
Pré-visualizando vários repositórios
If your work spans content in multiple repositories, e.g. because you xref:asciidoc-fedora:markup.adoc#external-antora-link[link to another repository], you can extend the preview by adding more repositories to `site.yml` as follows:
Se o seu trabalho abrange conteúdo em vários repositórios, por exemplo, porque você xref:asciidoc-fedora:markup.adoc#external-antora-link[faz link para outro repositório], você pode estender a visualização adicionando mais repositórios a `site.yml` da seguinte maneira:
content:
sources:
- url: .
branches: HEAD
- url: https://pagure.io/fedora-docs/another-repository.git
branches: main
content:
sources:
- url: .
branches: HEAD
- url: https://pagure.io/fedora-docs/outro-repositório.git
branches: main
Correct entries to use can be found from https://pagure.io/fedora-docs/docs-fp-o/blob/prod/f/site.yml[docs-fp-o site.yml].
As entradas corretas para uso podem ser encontradas no https://pagure.io/fedora-docs/docs-fp-o/blob/prod/f/site.yml[site.yml do docs-fp-o].
Using the regular Antora scripts
Usando os scripts normais do Antora
If you want to use the regular Antora build and preview workflow - follow the instructions on https://docs.antora.org/[Antora Documentation page].
Se você deseja usar o fluxo de trabalho regular de construção e pré-visualização do Antora, siga as instruções na https://docs.antora.org/[Página de documentação do Antora].
Once you have ``Antora CLI`` and ``Antora Site Generator`` you can build and preview the pages without the container scripts.
Assim que você tiver ``Antora CLI`` e ``Antora Site Generator``, você pode construir e pré-visualizar as páginas sem os scripts de contêiner.
To build the pages in the project directory run:
Para construir as páginas no diretório do projeto, execute:
antora generate site.yml
antora generate site.yml
This will create a new directory ``public`` which contains all the necessary files. Navigate there and run a server command. You might already have a Python simple server, in which case run:
Isso criará um novo diretório ``public`` que contém todos os arquivos necessários. Navegue até lá e execute um comando do servidor. Talvez você já tenha um servidor Python simples, nesse caso execute:
python3 -m http.server
python3 -m http.server
or if you only have Python 2 on your machine:
ou se você só tiver Python 2 em sua máquina:
python -m SimpleHTTPServer
python -m SimpleHTTPServer
It opens a local preview at port 8000.
Isso abre uma pré-visualização local na porta 8000.
If you have cargo (Rust package manager), you could also install and use ``miniserve`` or any other simple server of your choice for that matter.
Se você tem cargo (o gerenciador de pacotes Rust), você também pode instalar e usar ``miniserve`` ou qualquer outro servidor simples de sua escolha para esse assunto.

Loading…

User avatar rffontenelle

Translation added

  1. fedora-docs-l10n/fedora-docs-contributing
  2. master/pages/local-preview
  3. Portuguese (Brazil)
antora generate site.yml
antora generate site.yml
3 years ago
Browse all string changes
User avatar rffontenelle

Source string comment

Command line, do not translate.

3 years ago

Things to check

Unchanged translation

Source and translation are identical

Reset

Glossary

English Portuguese (Brazil)
No related strings found in the glossary.

String information

Source string description
type: delimited block -
Flags
no-wrap
Source string location
pages/local-preview.adoc:42
String age
3 years ago
Last updated
10 months ago
Source string age
4 years ago
Translation file
po/pt_BR/master/pages/local-preview.po, string 14