sdf - Online na nuvem

PROGRAMA:

NOME

sdf - Utilitário de conversão SDF

PROPÓSITO

sdf converte SDF arquivos para outros formatos de documento.

USO

uso: sdf [+ alias] [-h [ajuda]] [-o [out_ext]]
[-l [log_ext]] [-O [out_dir]] [formato -2]
[-D variable, ..] [-n split_level]
[-f sinalizador, ..] [-I include_path, ..]
[-p [pré-filtro]] [-a parâmetros] [-P [plang]]
[-N [line_numbers]] [-g [get_report]]
[-r relatório] [-L localidade] [-k aparência]
[-s estilo] [-S page_size] [-c config]
[-u usa, ..] [-H head_level] [-K head_look]
[-d driver] [-y post_filter]
[-z post_process, ..] [-t target]
[-v [verbose]] [-T trace_levels, ..]
[-w largura] [-Y library_path, ..]
arquivo_sdf...
objetivo: converter um arquivo sdf para outro formato
versão: 2.001 (SDF 2.001)

As opções são:

Descrição da Opção
-h exibe ajuda nas opções
-o extensão de arquivo de saída
-l extensão do arquivo de log
-O saída para o diretório do arquivo de entrada (ou explícito)
-2 o formato de saída que você deseja
-D definir variáveis
-n nível de título para divisão automática em tópicos
-f define sinalizadores (isto é, variáveis ​​DOC_ *)
-Eu procuro o caminho para incluir arquivos, modelos, etc.
-p pré-filtra o arquivo de entrada de cada argumento
-a parâmetros para o pré-filtro
-P pré-filtro como linguagem de programação
-N linhas numéricas em código-fonte bem impresso
-g pré-filtro usando sdfget com o relatório especificado
-r relatório a ser executado no SDF para transformá-lo antes da formatação
-L localidade
-k olha a biblioteca
-s estilo de documento
-S tamanho da página para documentos em papel
-c biblioteca de configuração
módulos -u para usar
-H nível de cabeçalho inicial
-K aparência do título (H, A ou P)
driver de formato -d - o padrão é expandir
-y filter para pós-filtrar a saída com
-z lista de ações de pós-processamento a serem realizadas
-t formato de destino lógico
-v modo detalhado
-T níveis de rastreamento de depuração
-w largura para saídas baseadas em texto
-Y caminho de pesquisa para bibliotecas

Os aliases são:

Descrição do Alias
mc gerar um capítulo MIMS
ms gera uma especificação MIMS
mt gerar um tópico MIMS
sdf2doc_fm gera formato binário Frame via FrameMaker
sdf2dvi_sgml gera formato DVI via SGML
sdf2fvo_fm gerar formato FrameViewer via FrameMaker
sdf2hlp_mif gerar arquivos de entrada da Ajuda do Windows via MIF
sdf2html_ gerar um documento HTML
sdf2html_dir gera um diretório SDF em HTML
sdf2html_fm gera um documento HTML via FrameMaker
sdf2html_topicsgenerate tópicos HTML
sdf2htx_ gerar formato MIMS HTX
sdf2info_sgmlgerar formato de informação GNU via SGML
sdf2latex_ gerar LaTeX
formato sdf2latex_podgenerate LaTeX via POD
sdf2latex_sgmlgenerate formato LaTeX via SGML
sdf2lyx_sgml gera um arquivo LyX via SGML
sdf2man_pod gera formato de página de manual via POD
sdf2mf6_ gera formato de ajuda MIMS F6
sdf2mif_ gerar formato Frame MIF
sdf2pdf_html gerar PDF via HTML
sdf2pdf_mif gerar PostScript e PDF via FrameMaker
sdf2pod_ gerar formato POD
sdf2ps_fm gera PostScript via FrameMaker
sdf2ps_fmbookgenerate PostScript por meio de um livro FrameMaker
sdf2ps_html gerar PostScript via HTML
sdf2ps_pod gera PostScript via POD
sdf2ps_sgml gera PostScript via SGML
sdf2rtf_fm gera formato RTF via FrameMaker
sdf2rtf_mif gerar formato RTF via MIF
sdf2rtf_sgml gera formato RTF via formato SGML
sdf2sdf_expandgenerate expandido SDF
sdf2sdf_raw gerar SDF bruto
sdf2sgml_ gera formato SGML
sdf2txt_ gerar formato de texto simples
sdf2txt_fm gera formato de texto simples via FrameMaker
sdf2txt_pod gera formato de texto simples via POD

DESCRIÇÃO

A opção -h fornece ajuda. Se for especificado sem um parâmetro, uma breve descrição
de cada opção é exibida. Para exibir os atributos de uma opção, especifique a opção
letra como parâmetro.

Por padrão, a saída gerada vai para a saída padrão. Para direcionar a saída para um arquivo por entrada
arquivo, use a opção -o para especificar uma extensão para os arquivos de saída. Se a opção -o for
especificado sem um parâmetro, uma extensão de Fora é assumido.

Da mesma forma, as mensagens de erro vão para o erro padrão por padrão. Use a opção -l para criar um
arquivo de log por arquivo de entrada. Se a opção -l for especificada sem um parâmetro, uma extensão
of log é assumido.

Por padrão, a saída gerada e os arquivos de log são criados no diretório atual. Use o
-O opção para especificar um diretório de saída explícito. Se a opção -O for especificada sem
um parâmetro, o diretório do arquivo de entrada é usado.

A opção -2 é uma maneira conveniente de especificar o alias (coleção de opções) que
gera a saída que você deseja. por exemplo

sdf-2html abc

é equivalente a:

sdf + sdf2html abc

A opção -D é usada para definir variáveis. Estes são normalmente usados ​​para controlar
texto condicional e substituição de texto que muda. O formato usado é:

-Dvariable1 = value1, variable2 = value2

Um sinalizador é uma forma abreviada de especificar variáveis ​​na família DOC. ou seja, -ftoc = 3 é
equivalente a -DDOC_TOC = 3. O formato da opção -f é:

-fflag1 = valor1, sinalizador2 = valor2

Se uma variável ou sinalizador for especificado sem um valor, 1 será assumido.

Para gerar HTML tópicos, o comando é:

sdf -2tópicos abc

Por padrão, isso criará subtópicos para cada título já em um arquivo separado. Isto
também vai divisão automática títulos de nível 1 em subtópicos. A opção -n pode ser usada para controlar
quais títulos de nível são divididos em:

· 1 autosplits em títulos de nível 1 (o padrão)

· 2 autosplits em títulos de nível 2

· 3 autosplits em títulos de nível 3

· 0 desativa a divisão automática.

Os arquivos incluídos são pesquisados ​​no diretório atual e, em seguida, nos diretórios fornecidos por
a opção -I, então no diretório da biblioteca padrão.

Por padrão, o sdf está configurado para pré-filtro arquivos com certas extensões. Por exemplo:

sdf minhatabela.tbl

é equivalente a executar sdf em um arquivo que contém apenas:

! inclua "mytable.pl"; tabela

A opção -p pode ser usada para pré-filtrar explicitamente os arquivos ou para substituir o padrão
pré-filtro usado. Se um parâmetro não for fornecido, o pré-filtro será considerado mesa.

A opção -a pode ser usada para especificar parâmetros para o pré-filtro. Por exemplo:

sdf -aformat = '15,75,10, XNUMX 'minhatabela.tbl

A opção -P pré-filtra os arquivos de entrada como linguagens de programação. O parâmetro é o
linguagem a ser usada. Se nenhum for fornecido, a extensão será considerada o nome do idioma.
Por exemplo:

sdf -P meuaplicativo.c

é equivalente a executar sdf em um arquivo que contém apenas:

! incluir "myapp.c"; exemplo; ampla; lang = 'c'

A opção -N adiciona números de linha na frequência fornecida. A frequência padrão é 1. ie
Cada linha.

A opção -g pré-filtra os arquivos de entrada executando sdfget usando o relatório padrão
(default.sdg). Para alterar o relatório usado, especifique o nome do relatório como o parâmetro. Se o
o nome do relatório não inclui uma extensão, sdg é assumido.

Nota: sdfget procura relatórios no diretório atual e, em seguida, no stdlib anuário
dentro do diretório da biblioteca do SDF.

A opção -r executa o relatório SDR nomeado em cada entrada antes da formatação. Em outro
palavras, os relatórios SDR fornecem um mecanismo para:

· Analisar o SDF pouco antes de ser formatado e

· Substituir esse SDF pela saída do relatório (também SDF) para que a saída final
é um relatório bem formatado.

Por exemplo, a sdf_dir relatório gera um diretório (árvore) dos componentes (arquivos)
incluído em um documento SDF. Os relatórios são armazenados em SDR arquivos e são pesquisados ​​usando
as regras usuais.

A opção -L pode ser usada para especificar um local. O nome da localidade padrão é especificado em
sdf.ini. A nomenclatura do local segue as convenções POSIX (ou seja, idioma_país), portanto, o local
nome para inglês americano é pt_br. As informações para cada local são armazenadas no
local diretório, então você precisa olhar lá para ver quais são as localidades
acessível. (Como o local padrão pode ser definido em sdf.ini, isso não é tão feio quanto antes
sons.)

Nota: No momento, um arquivo de localidade simplesmente contém uma lista de strings específicas do idioma.
Em última análise, deve ser estendido para oferecer suporte à localização de formatos de data e hora.

A opção -k é usada para especificar um olhar. A biblioteca de aparência padrão é especificada em sdf.ini.

A opção -s pode ser usada para especificar um documento estilo. Os valores típicos são:

· documento - um documento técnico

· memorando - um memorando

· fax - um fac-símile

· minutos - atas de uma reunião.

A opção -S é usada para especificar o tamanho da página. Os valores suportados incluem:

Nome Largura Altura Comentário
global 21.0 cm 11.0 pol. caberá em A4 ou carta
A3 29.7cm 42.0cm
A4 21.0cm 29.7cm
A5 14.8cm 21.0cm
B4 25.7 cm 36.4 cm
B5 17.6 cm 25.0 cm
letra 8.5 pol 11.0 pol
legal 8.5 em 14.0 pol
tablóide 11.0 em 17.0 pol.

Tamanhos de página adicionais podem ser configurados em sdf.ini. Para especificar uma versão girada de um
tamanho de página nomeado, acrescente um R. Por exemplo, A4R implica uma largura de 29.7 cm e uma altura de
21cm. Um tamanho de página personalizado também pode ser especificado usando o formato:

{{width}}x{{height}}

onde largura e altura são os respectivos tamanhos em pontos.

A opção -c é usada para especificar uma biblioteca de configuração.

Uma lista de módulos a serem usados ​​pode ser especificada por meio da opção -u.

O nível de rumo inicial para começar pode ser especificado por meio da opção -H. Isso é útil
se você deseja visualizar como um tópico será exibido sem regenerar o completo
documento. Se um tópico começa com um título de nível 1 (por exemplo, H1) e você deseja formatá-lo como
um documento (ou seja, o texto de nível 1 torna-se o DOC_NAME para build_title), use a opção -H
com um valor de 0.

A aparência dos títulos também pode ser ajustada. Por padrão, os títulos estilo H são numerados,
Os títulos de estilo A têm letras e os títulos de P são simples. Para forçar um estilo particular
para todos os cabeçalhos, a opção -K pode ser usada. Os valores de parâmetros sensíveis são H, A e P
embora outros valores possam funcionar, dependendo de quais estilos de parágrafo são configurados em seu
site.

A opção -d é usada para especificar o driver de formato. Os valores suportados incluem:

· expandir - formatar como texto expandido (o padrão)

· mif - Formato de troca de fabricante

· vagem - Plain Old Documentation (como usado por Perl).

Drivers adicionais podem ser configurados em sdf.ini.

A opção -y pode ser usada para especificar um pós-filtro.

A opção -z pode ser usada para especificar uma lista de ações de pós-processamento que você deseja executar
em cada arquivo de saída após sua geração. As ações suportadas incluem:

· ps - gerar PostScript

· doca - gerar um arquivo Frame (binário)

· amor - gerar um arquivo Frame View-Only

· txt - gerar um arquivo de texto

· rtf - gerar um arquivo RTF

· limpar - exclui o arquivo de saída (deve ser o último).

Ações adicionais podem ser configuradas em sdf.ini. Por convenção, os arquivos gerados são
dados os mesmos nomes das palavras-chave de ação.

A opção -t é usada para especificar o formato de destino lógico. Se nenhum for especificado, o
o padrão é a primeira ação de pós-processamento, se houver. Caso contrário, o padrão é o formato
nome do motorista.

A opção -v ativa o modo detalhado. Isso é útil para depurar problemas relacionados à postagem
em processamento. Em particular, ações de pós-processamento contendo o padrão limpar e guarante que os mesmos estão
pulado no modo detalhado. Você também pode desligar as mensagens de pós-processamento usando um
valor detalhado de -1. Valores superiores a 1 ativam mensagens de rastreamento adicionais da seguinte maneira:

· 2 - mostra como nomes de arquivos e bibliotecas são resolvidos

3 - mostra os diretórios pesquisados ​​por bibliotecas

4 - mostra os diretórios pesquisados ​​por módulos

5 - mostra os diretórios pesquisados ​​para arquivos normais.

A opção -T pode ser usada para ativar o rastreamento de depuração. O parâmetro é separado por vírgulas
lista de pares nome-valor onde cada nome é um rastreamento grupo e cada valor é o nível de
rastreamento para esse grupo. Para obter a saída de rastreamento fornecida pela opção -v, pode-se usar o
usuário grupo como este:

sdf -Tuser = 2 ...

Isso é um pouco diferente da opção -v em que os arquivos intermediários não são
mantido implicitamente. Grupos de rastreamento adicionais serão adicionados ao longo do tempo (provavelmente um por
driver de saída).

A opção -w é usada para especificar a largura das saídas baseadas em texto.

As opções -z, -D, -f e -I são opções de lista. ou seja, vários valores podem ser separados por
vírgulas e / ou as opções podem ser fornecidas várias vezes.

EXEMPLOS

Converter meudoc.sdf a um documento técnico em formato MIF, a saída é meudoc.mif:

sdf -2mif meudoc.sdf

Converter meudoc.sdf para documentação online em Visualizador de quadros formato, saída é meudoc.fvo:

sdf -2fvo meudoc.sdf

Converter meudoc.sdf para a documentação online em HTML, a saída é meudoc.html:

sdf -2html meudoc.sdf

O comando a seguir criará a documentação de referência para um módulo SDF em HTML:

sdf -2html abc.sdm

LIMITAÇÕES E FUTURO INSTRUÇÕES

Muitas das ações padrão de pós-processamento (-z) só funcionam em Unix as Criador de molduras for
Windows não suporta conversão em lote.

O modo de tópicos tem várias limitações:

· Apenas documentos no diretório atual podem ser convertidos

· Todos os subtópicos também devem estar no diretório atual.

Use sdf online usando serviços onworks.net