Ubuntu Manpage: groff_me - pacote de macros “me” para formatação de documentos com GNU roff

Provided by: manpages-pt-br_4.15.0-9_all

NOME

       groff_me - pacote de macros “me” para formatação de documentos com GNU roff

SINOPSE

       groff -me [opção ...] [arquivo-entrada ...]

       groff -m me [opção ...] [arquivo-entrada ...]

DESCRIÇÃO

O pacote me de definições de macro para a linguagem roff fornece uma facilidade
conveniente para preparar artigos técnicos em vários formatos. Esta página do manual
descreve a versão GNU das macros me, que fazem parte do sistema de formatação de
documentos groff. Esta versão pode ser usada com ambos GNU troff e Unix troff.

Muitas solicitações do roff não são seguras em conjunto com este pacote; no entanto, as
seguintes solicitações podem ser usadas com impunidade após a primeira .pp:

.bp inicia nova página
.br quebra a linha de saída aqui
.sp n insere n linhas de espaçamento
.ls n (espaçamento de linha) n=1 um espaço, n=2 espaços duplos
.na sem alinhamento da margem direita
.ce n centraliza as próximas n linhas
.ul n sublinha as próximas n linhas

Nota: Em contraste com seu comportamento com outros pacotes de macro e roff “bruto”, ao
usar o pacote me, a solicitação .sp não vai colocar espaço no topo de uma página.

A saída dos preprocessadores pic, eqn, refer e tbl é aceitável como entrada.

Referência de macros
Os argumentos numéricos para macros são indicados com letras minúsculas e argumentos de
string com maiúsculas. Um argumento opcional de macro como x aparecem entre colchetes,
[x]. Observe que os argumentos para macros geralmente devem ser colocados entre aspas se
contiverem espaços em branco. Uma exceção é o argumento para macros de cabeçalho e
rodapé, que requerem alguma explicação. Eles assumem a forma “c esquerda c meio c direita
c”, com espaços adicionados aqui para maior clareza. As strings esquerda, meio e direita
correspondem ao seu posicionamento de página e podem conter espaços em branco
desprotegidos, mas não devem conter o caractere (sem espaço) c, que os delimita. Para
resumir, a tabela apresenta os argumentos de cabeçalho e rodapé como clcmcrc. Escolhas
populares para c são o apóstrofo ASCII “'” e aspas duplas ASCII “"”.

Esta lista está incompleta; algumas solicitações são muito complexas para resumir em uma
tabela e algumas que estão listadas abaixo aceitam argumentos adicionais não mostrados.
Consulte o Manual de referência do -me para obter detalhes interessantes.

Solicitação Valor Causa Explicação
Valor Quebra
───────────────────────────────────────────────────────────────────────────────────────────
.(c - sim Inicia um bloco centralizado.
.(d - não Inicia um texto atrasado.
.(f - não Inicia uma nota de rodapé.
.(l - sim Inicia uma lista.
.(q - sim Inicia aspas principais.
.(x [X] - não Inicia um item no índice (chamado X).
.(z - não Inicia uma fixação flutuante.
.)c - sim Termina um bloco centralizado.
.)d - sim Termina um texto atrasado.
.)f - sim Termina uma nota de rodapé.
.)l - sim Termina uma lista.
.)q - sim Termina aspas principais.

.)x - sim Termina um item de índice.
.)z - sim Termina uma fixação flutuante.
.++ M [clcmcrc] - não Define a seção do artigo como M, que deve ser um entre
C (capítulo), A (apêndice), P (preliminar, isto é,
parte pré-textual e sumário), AB (abstrato), B
(bibliografia), RC (capítulos renumerados da página um
de cada capítulo), or RA (apêndice renumerado da página
um) (e define cabeçalho da página para clcmcrc).
.+c [T] - sim Inicia um capítulo (ou apêndice etc. como definido por
.++) (com título T).
.1c 1 sim Formato de uma coluna em uma nova página.
.2c 1 sim Formato de duas colunas.
.EN - sim Espaço após equação produzido por eqn ou neqn.
.EQ [M [T]] - sim Inicia a equação exibida (com recuo M, que deve ser um
entre C (centralizado, padrão), I (recuado), ou L
(justificado à esquerda) (e título T na margem
direita)).
.GE - sim Termina a imagem gremlin.
.GS - sim Inicia a imagem gremlin.
.PE - sim Termina a imagem pic.
.PS - sim Inicia a imagem pic.
.TE - sim Termina a tabela tbl.
.TH - sim Termina o cabeçalho da tabela tbl.
.TS [H] - sim Inicia a tabela tbl; se H estiver definido, a tabela
repete o cabeçalho em cada página.
.b [X [Y]] - não Imprime X em negrito (anexando Y na fonte anterior); se
houver nenhum argumento, troca para negrito.
.ba n 0 sim Aumento do recuo base (para texto comum, como
parágrafos) por n.
.bc - sim Inicia uma nova coluna.
.bi [X [Y]] - não Imprime X em itálico e negrito (anexando Y na fonte
anterior); se houver nenhum argumento, troca para
itálico e negrito.
.bu - sim Inicia um parágrafo com marcador.
.bx [X [Y]] - não Imprime X em uma caixa (com Y anexado). Renderiza
confiavelmente apenas no modo sem preenchimento.
.ef clcmcrc """" não Define o rodapé de página com numeração par.
.eh clcmcrc """" não Define o cabeçalho de página com numeração par.
.fo clcmcrc """" não Define o rodapé da página.
.hx - não Suprime cabeçalhos e rodapés na próxima página.
.he clcmcrc """" não Define cabeçalho de página.
.hl - sim Desenha uma linha horizontal.
.i [X [Y]] - não Imprime X em itálico (anexando Y na fonte anterior); se
houver nenhum argumento, troca para itálico.
.ip [X [n]] n=5n sim Inicia um parágrafo recuado (com marcação X (e recuo
n)).
.lp - sim Inicia um parágrafo com a primeira linha alinhada à
esquerda.
.np 1 sim Inicia um parágrafo numerado.
.of clcmcrc """" não Define o rodapé de página com numeração ímpar.
.oh clcmcrc """" não Define o cabeçalho de página com numeração ímpar.
.pd - sim Imprime um texto adiado.
.pp - sim Inicia um parágrafo com a primeira linha com recuo.
.r [X [Y]] - não Imprime X em fonte romana (anexando Y na fonte
anterior); se houver nenhum argumento, troca para
romano.
.re 0.5i não Redefine as tabulações para os valores padrão.
.sh [n [T]] n=1 sim Inicia uma seção numerada; imprime o número da seção
(define para n (e título T)) em negrito.
.sk - não Deixa a próxima página em branco. Apenas uma página é
lembrada adiante.
.sm X [Y] - não Imprime X em um tamanho menor de ponto (anexando Y ao
tamanho anterior).
.sz n 10p não Aumenta o tamanho de ponto em n pontos.
.tp - sim Inicia uma página de título

.u X [Y] - não Sublinha X (anexando Y sem sublinhado). Renderiza de
forma confiável apenas no modo sem preenchimento.
.uh [T] - sim Inicia uma seção não numerada (e imprime o título T em
negrito).
.xp [X] - não Imprime o índice (chamado X).

ARQUIVOS

       /usr/share/groff/1.22.4/tmac/me.tmac (um arquivo wrapper para e.tmac)
       /usr/share/groff/1.22.4/tmac/e.tmac

NOTAS

       Os primeiros pacotes de macro roff se limitavam a um espaço de nomes de uma única letra
       (mm, ms, mv, mn etc.).  O “e” em “me” significa “Eric P. Allman”, quem escreveu o pacote
       de macros e os artigos técnicos originais documentando-o enquanto era um graduando na
       Universidade da Califórnia.

VEJA TAMBÉM

       groff(1), troff(1)

       Dois manuais estão disponíveis em formato original e renderizado.  Em seu sistema, eles
       podem estar compactados e/ou disponíveis em formatos adicionais.

       /usr/share/doc/groff-base/meintro.me
       /usr/share/doc/groff-base/meintro.ps
              é Escrevendo artigos com Groff usando -me, por Eric P. Allman e James Clark.

       /usr/share/doc/groff-base/meref.me
       /usr/share/doc/groff-base/meref.ps
              é o Manual de referência do -me, por Eric P. Allman e James Clark.

       Para preprocessadores suportados por me, veja eqn(1), grn(1), pic(1), refer(1) e tbl(1).

TRADUÇÃO

       A tradução para português brasileiro desta página man foi criada por Rafael Fontenelle
       <rafaelff@gnome.org>

       Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ ou posterior para as condições de direitos
       autorais.  Nenhuma responsabilidade é aceita.

       Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a
       lista de discussão de tradutores ⟨debian-l10n-portuguese@lists.debian.org⟩.