gropdf - Online na nuvem

PROGRAMA:

NOME

gropdf - driver PDF para groff

SINOPSE

gropdf [-delvs] [-F dir] [-p Tamanho do papel] [-y fundição] [-u [arquivo cmap]] [arquivos ...]

É possível ter um espaço em branco entre uma opção de linha de comando e seu parâmetro.

DESCRIÇÃO

gropdf traduz a saída do GNU troff para PDF. Normalmente gropdf deve ser invocado por
usando o comando groff com um -Tpdf opção. Se nenhum arquivo for fornecido, gropdf lê o
entrada padrão. Um nome de arquivo de - também causa gropdf para ler a entrada padrão. PDF
a saída é gravada na saída padrão. Quando gropdf é administrado por Groff opções podem ser
passado para gropdf utilização Groff's -P opção.

Veja a seção FONT INSTALAÇÃO abaixo para um guia de como instalar fontes para gropdf.

OPÇÕES

-d Inclua informações de depuração como comentários no PDF. Também produz um
PDF não compactado.

-e Força todas as fontes a serem incorporadas ao PDF.

-Fdir Anexar diretório dir/ devnome para o caminho de pesquisa para fonte e descrição do dispositivo
arquivos; nome é o nome do dispositivo, geralmente pdf.

-l Imprima o documento no formato paisagem.

-pTamanho do papel
Defina a dimensão física do meio de saída. Isso substitui o Tamanho do papel,
comprimento do papel e largura do papel comandos no DESC Arquivo; aceita o mesmo
argumentos como o Tamanho do papel comando. Ver groff_font (5) para obter detalhes.

-v Imprima o número da versão.

-yfundição
Defina a fundição a ser usada para selecionar fontes com o mesmo nome.

-e Forças gropdf para incorporar TODAS as fontes (até mesmo as 14 fontes básicas de PDF).

-s Anexe uma linha de comentário ao final do PDF mostrando estatísticas, ou seja, o número de páginas em
documento. Ghostscript's ps2pdf reclama sobre esta linha se estiver incluída, mas
funciona de qualquer maneira.

-u
-unome do arquivo cmap
Gropdf normalmente inclui um ToUnicode CMap com qualquer fonte criada usando texto.enc as
o arquivo de codificação, isso torna mais fácil procurar por palavras que contenham
ligaduras. Você pode incluir seu próprio CMap especificando um nome do arquivo cmap ou não tem
CMap em tudo, omitindo o argumento.

USO

A entrada para gropdf deve estar no formato de saída de troff(1). Isso é descrito em
groff_out(5).

Além disso, o dispositivo e os arquivos de descrição de fonte para o dispositivo usado devem atender a certos
requisitos: A resolução deve ser um múltiplo inteiro de 72 vezes o escala de tamanho. O
pdf dispositivo usa uma resolução de 72000 e uma escala de tamanho de 1000.

O arquivo de descrição do dispositivo deve conter um tamanho de papel válido; Vejo groff_font(5) para mais
informações. gropdf usa as mesmas fontes postscript da Adobe Tipo 1 que o agarrar dispositivo
motorista. Embora o padrão PDF permita o uso de outros tipos de fontes (como TrueType), este
a implementação aceita apenas a fonte postscript Tipo 1. Menos fontes Tipo 1 são suportadas
nativamente em documentos PDF do que as 35 fontes padrão suportadas por agarrar e todo o postscript
impressoras, mas todas as fontes estão disponíveis, uma vez que as que não são suportadas nativamente são
incorporado automaticamente no PDF.

gropdf suporta o conceito de fundições, ou seja, diferentes versões do mesmo
Fonte. Durante a instalação de um Fundição controles de arquivo onde as fontes são encontradas e compiladas Groff fontes
dos arquivos que ele descobre em seu sistema.

Cada arquivo de descrição de fonte deve conter um comando

nome interno psnome

que diz que o nome PostScript da fonte é psnome. Linhas começando com # e
linhas em branco são ignoradas. O código para cada caractere dado no arquivo de fonte deve
correspondem ao código na codificação padrão da fonte. Este código pode ser usado com
que o \N sequência de escape em troff para selecionar o personagem, mesmo que o personagem não
tem um nome groff. Cada caractere no arquivo de fonte deve existir na fonte PostScript,
e as larguras fornecidas no arquivo de fonte devem corresponder às larguras usadas na fonte PostScript.

Observe que gropdf atualmente só é capaz de exibir os primeiros 256 glifos em qualquer fonte. Esse
restrição será levantada em uma versão posterior.

gropdf pode incluir automaticamente as fontes para download necessárias para imprimir o documento.
As fontes podem estar no formato PFA ou PFB.

Quaisquer fontes para download que devem, quando necessário, ser incluídas por gropdf deve ser listado
no arquivo /usr/share/groff/1.22.3/font/devpdf/download; isto deve consistir em linhas de
a forma

fundição fonte nome do arquivo

onde fundição é o nome da fundição ou espaço em branco para a fundição padrão. fonte é o
Nome PostScript da fonte e nome do arquivo é o nome do arquivo que contém a fonte;
linhas começando com # e as linhas em branco são ignoradas; os campos devem ser separados por tabulações
(os espaços são não permitido); nome do arquivo é pesquisado usando o mesmo mecanismo que é usado
para arquivos métricos de fonte groff. o download o próprio arquivo também é pesquisado usando este
mecanismo; atualmente, apenas o primeiro arquivo encontrado no caminho da fonte é usado. Nomes de fundição
são geralmente um único caractere (como 'U' para o URW Foundry) ou em branco para o padrão
fundição. Este padrão usa as mesmas fontes que ghostscript usa quando incorpora fontes em um
Ficheiro PDF.

Na configuração padrão, existem estilos chamados R, I, B e BI montado nas posições da fonte 1
a 4. As fontes são agrupadas em famílias A, BM, C, H, HN, N, P e T tendo membros em
cada um desses estilos:

AR Livro-Avant-Garde
AI Avant-Garde-BookOblique
AB Avant Garde-Demi
ABI AvantGarde-Demi Oblique
BMR Bookman-Light
IMC Bookman-Light Itálico
BMB Bookman-Demi
BMBI Bookman-DemiItálico
CR Correio
CI Courier Oblique
CB Courier-Negrito
CBI Courier-Bold Oblique
HR Helvetica
HI Helvética-Obliqua
HB Helvética-Negrito
HBI Helvetica-BoldOblique
HNR Helvetica-Estreito
HNI Helvetica-Narrow-Obliqua
CNB Helvetica-Narrow-Bold
HNBI Helvetica-Narrow-BoldOblique
NR Novo SéculoSchlbk-Roman
NI NewCenturySchlbk-Itálico
NB NewCenturySchlbk-Bold
NBI NewCenturySchlbk-BoldItalic
PR Palatino-romano
PI Palatino-Itálico
PB Palatino-Negrito
PBI Palatino-NegritoItálico
TR Tempos romanos
TI Times-Itálico
TB Times-Negrito
TCE Times-BoldItálico

Também existe a seguinte fonte que não é membro de uma família:

ZCMI ZapfChancery-MediumItálico

Existem também algumas fontes especiais chamadas S para a fonte PS Symbol. O grego minúsculo
os caracteres são inclinados automaticamente (para corresponder à fonte SymbolSlanted (SS) disponível para
postscript). Zapf Dingbats está disponível como ZD, o glifo "mão apontando para a esquerda" (\ [lh]) é
disponível uma vez que foi definido usando a extensão \ X'pdf: xrev 'que inverte o
direção das letras dentro das palavras.

A cor padrão para \m e \M é preto; para cores definidas no espaço de cores 'rgb'
setrgbcolor é usado para 'cmy' e 'cmyk' definircmykcolor, e para 'cinza' cinza. Observe que
definircmykcolor é um comando PostScript LanguageLevel 2 e, portanto, não está disponível em alguns
impressoras.

gropdf entende alguns dos comandos X produzidos usando o \X sequências de escape suportadas
by apalpadelas. Especificamente, o seguinte é compatível.

\ X'ps: invis '
Suprima a saída.

\ X'ps: Endinvis '
Pare de suprimir a saída.

\ X'ps: exec gsave ponto atual 2 cópia traduzir n rodar neg troca neg troca traduzir'
onde n é o ângulo de rotação. Isso é para apoiar o alinhar comando em gpic.

\ X'ps: exec Grestore '
Novamente usado por gpic para restaurar após a rotação.

\ X'ps: exec n setlinejoin '
onde n pode ser um dos seguintes valores.

0 = junção de esquadria
1 = Rodada de junção
2 = junção chanfrada

\ X'ps: exec n setlinecap '
onde n pode ser um dos seguintes valores.

0 = Bumbum
1 = tampa redonda, e
2 = Projetando tampa quadrada

\ X'ps: ... pdfmark '
Todos os marca pdf macros instaladas usando -m marca pdf or -m mspdf (veja a documentação
em 'pdfmark.pdf'). Um subconjunto dessas macros é instalado automaticamente quando você
usar -Tpdf então você não deve precisar usar '-m pdfmark' para usar a maior parte do PDF
funcionalidade.

Todos os outros ps: as tags são silenciosamente ignoradas.

completa \X especial usado pelo driver DVI também é reconhecido:

\ X'papersize =Tamanho do papel'
onde o Tamanho do papel parâmetro é o mesmo que o Tamanho do papel comando. Ver
groff_font(5) para obter detalhes. Isso significa que você pode alterar o tamanho da página à vontade
dentro do arquivo PDF sendo criado por gropdf. Se você quiser mudar o papel
tamanho, isso deve ser feito antes de você começar a criar a página.

Além disso, gropdf suporta seu próprio pacote de pdf: Tag. As seguintes tags são
suportado:

\ X'pdf: pdfpic lima alinhamento largura altura comprimento da linha'
Coloque uma imagem do especificado largura contendo o desenho PDF do arquivo lima of
desejado largura e altura (E se altura está faltando ou é zero, então é escalado
proporcionalmente). Se alinhamento is -L o desenho é alinhado à esquerda. Se for -C or
-R a comprimento da linha maior do que a largura do desenho também é necessária. Se
largura é especificado como zero, então a largura é dimensionada em proporção à altura.

\ X'pdf: xrev '
Isso alterna uma bandeira que inverte a direção da impressão carta by carta,
ou seja, cada letra separada é invertida, não a palavra inteira. Isso é útil para
invertendo a direção dos glifos na fonte Dingbats. Para voltar ao normal
imprimir repita o comando novamente.

\ X'pdf: marcar início / ANN definição'
As macros que suportam Marcadores de PDF usam esta chamada internamente para iniciar o
definição do ponto de acesso do favorito (o usuário terá chamado '.pdfhref L' com o texto
que se tornará a região do 'ponto quente'). Normalmente, isso nunca é usado, exceto de
dentro das macros pdfmark.

\ X'pdf: markend '
As macros que suportam Marcadores de PDF usam essa chamada internamente para interromper o
definição do ponto de acesso do favorito (o usuário terá chamado '.pdfhref L' com o texto
que se tornará a região do 'ponto quente'). Normalmente, isso nunca é usado, exceto de
dentro das macros pdfmark.

\ X'pdf: Marcaruspend '
\ X'pdf: markrestart '
Se você estiver usando armadilhas de página para produzir títulos, rodapés, etc., você precisa usar
estes no caso de um 'ponto quente' cruzar o limite da página, caso contrário, qualquer saída de texto por
a macro de título ou rodapé será marcada como parte do 'ponto de acesso'. Parar
isso acontecendo, basta colocar '.pdfmarksuspend' e '.pdfmarkrestart' no início e
fim da macro de trap de página, respectivamente. (Estas são apenas macros de conveniência que
emita o código \ X. Essas macros devem ser usadas apenas em interceptações de página.)

Importador gráficos
gropdf suporta apenas a importação de outros arquivos PDF como gráficos. Mas esse arquivo PDF pode conter
qualquer um dos formatos gráficos suportados pelo padrão PDF (como JPEG, PNG, GIF, etc.).
Portanto, qualquer aplicativo que produza PDF pode ser usado como um arquivo incorporado em gropdf. O PDF
arquivo que você deseja inserir deve ser uma única página e o desenho deve apenas caber dentro do
tamanho da mídia do arquivo PDF. Então, em inkscape(1) ou gimp(1) (por exemplo) certifique-se de que
o tamanho da tela se ajusta à imagem.

O analisador de PDF usado em gropdf não foi rigorosamente testado com todos os possíveis
aplicativos que produzem PDFs. Se você encontrar uma única página PDF que não consegue importar
corretamente, vale a pena percorrê-lo através do pdftk(1) programa emitindo o comando:

pdftk arquivo antigo.pdf saída novoarquivo.pdf

Você pode achar que novoarquivo.pdf agora será carregado com sucesso.

TrueType e de outros fonte formatos
gropdf não oferece suporte a nenhuma outra fonte, exceto Adobe Type 1 (PFA ou PFB).

FONT INSTALAÇÃO

Esta seção fornece um resumo das explicações acima; pode servir como um passo a passo
guia de instalação de fontes para gropdf.

· Converta sua fonte para algo que groff entenda. Este é um PostScript Tipo 1
fonte em PFA ou PFB, junto com um arquivo AFM.

A primeira linha em um arquivo PFA / PFB contém isto:

%! PS-AdobeFont-1.0:

Um arquivo PFB tem isso também na primeira linha, mas a string é precedida por alguns
bytes binários.

· Converta o arquivo AFM em um arquivo de descrição de fonte groff com o afmtodit(1) programa.
Um exemplo de chamada é

afmtodit Foo-Bar-Bold.afm map / textmap FBB

que converte o arquivo métrico 'Foo-Bar-Bold.afm' para a fonte groff 'FBB'. Se você
tem uma família de fontes que vem com as faces normal, negrito, itálico e negrito itálico, é
recomendado usar as letras R, B, I e BI, respectivamente, como pós-correções no
nomes de fontes groff para fazer a solicitação '.fam' de groff funcionar. Um exemplo é o integrado de groff
Fonte Times-Roman: o nome da família da fonte é T, e os nomes das fontes groff são TR, TB, TI,
e TCE.

· Instale os arquivos de descrição de fontes groff e as fontes em um subdiretório 'devpdf'
do caminho da fonte que o groff encontra. Veja o MEIO AMBIENTE seção no troff(1) homem
página que lista o valor real do caminho da fonte. Observe que groff não usa o
Arquivos AFM (mas é uma boa ideia armazená-los de qualquer maneira).

· Registre todas as fontes que devem ser baixadas para a impressora no 'devpdf / download'
Arquivo. Apenas a primeira ocorrência deste arquivo no caminho da fonte é lida. Isso significa
que você deve copiar o arquivo padrão de 'download' para o primeiro diretório em sua fonte
caminho e adicione suas fontes lá. Para continuar o exemplo acima, assumimos que o PS
o nome da fonte para Foo-Bar-Bold.pfa é 'XY-Foo-Bar-Bold' (o nome da fonte PS é armazenado no
nome interno campo no arquivo 'FBB') e pertence à fundição 'Fcq], portanto, o seguinte
linha deve ser adicionada a 'download':

F XY-Foo-Bar-Negrito Foo-Bar-Bold.pfa

Use um caractere de tabulação para separar os campos, e o campo 'fundição' deve ser nulo para
a fundição padrão.

MEIO AMBIENTE

GROFF_FONT_PATH
Uma lista de diretórios nos quais pesquisar o devnome diretório além de
os padrão. Se, no arquivo de 'download', o arquivo de fonte foi especificado
com um caminho completo, nenhum diretório é pesquisado. Ver troff(1) e groff_font(5) para
mais detalhes.

FONTE_DATA_ÉPOCA
Um carimbo de data / hora (expresso em segundos desde a época Unix) para usar como a criação
carimbo de data / hora no lugar da hora atual.

Use gropdf online usando serviços onworks.net