stx2any - Online en la nube

PROGRAMA:

NOMBRE

stx2any - convertidor de texto estructurado a múltiples formatos

SINOPSIS

stx2any [-T formato ] [ stx y las m4 opciones ] [ presentar presentar ...]

DESCRIPCIÓN

stx2any convierte archivos en formato de texto estructurado (Stx) a otros formatos. Formatos
actualmente implementados son HTML, man, raw text, PostScript, LaTeX, XHTML y DocBook XML.

El formato de origen, texto estructurado, es una especie de formato de texto sin formato con marcado estándar
para representar encabezados, listas, énfasis, etc. El marcado es más rápido de escribir y
más fácil de recordar que los lenguajes de marcado convencionales basados ​​en etiquetas, y es maravillosamente
legible también en forma de fuente. El marcado Stx se explica mejor en STX cosa hecha rápidamente guía, cual
está disponible en el directorio de ejemplos.

La mayor parte de la conversión ocurre en m4, y puedes definir tus propias macros y otras cosas
para dar estructura a sus documentos. stx2any proporciona un extensible similar a LaTeX
sistema ambiental y un sistema de desvío para reorganizar la entrada. (Tårta på tårta, ya que
decir en sueco.)

Debido a que stx2any no realiza ningún tipo de citación en la entrada, el marcado que no es
disponible se puede escribir directamente en el idioma de destino (perdiendo la convertibilidad a
múltiples idiomas). De esta manera, si solo está interesado en un formato de salida (p. Ej.
LaTeX), puede usar Stx como formato de abreviatura para las construcciones más comunes.

Algunos formatos no están disponibles como abreviaturas, sino llamando a macros m4. Necesitas
macros relativamente raramente: por ejemplo, flota (material que puede "flotar" en el
documento) son creados por macros.

OPCIONES

stx2any acepta todas las opciones de línea de comando de m4, pasándolas directamente. De estos, el
El argumento -D es lo suficientemente importante como para mencionarlo aquí por separado.

-DNAME = VALUE
Defina la macro NAME para que tenga la expansión VALUE. Esto te permite pasar
información en el documento desde la línea de comando.

-T formato
Establece el formato de salida. El formato predeterminado es html. formato debe ser uno de:

html produce una salida HTML básica (lenguaje de marcado de hipertexto).

man produce salida macro man. Esta salida se puede utilizar como página de manual directamente
(aunque vea las PÁGINAS DEL HOMBRE DE ESCRITURA a continuación), o se puede enviar a troff / groff para
formato a, por ejemplo, postscript.

latex produce salida de lenguaje de preparación de documentos LaTeX. Puedes correr látex en
el resultado para producir, por ejemplo, pdf de alta calidad.

text produce una salida de texto sin procesar mediante el posprocesamiento de la salida HTML con w3m. los
la salida resultante es muy básica, como eliminar la mayor parte del marcado Stx; si tu
Si desea una salida más formateada, considere canalizar la salida man a nroff -man.

ps produce una salida PostScript simple posprocesando la salida man con groff.
Si desea hacer publicaciones reales, considere el formato LaTeX en su lugar.

xhtml produce salida XHTML postprocesando la salida HTML con W3C tidy. Por el
camino, comprobar http://hixie.ch/advocacy/xhtml para discutir sobre HTML y
XHTML.

docbook-xml
produce una salida XML DocBook rudimentaria. Consulte ERRORES a continuación para obtener más información.
sobre esto.

--enlace-abreviaturas
Utilice la sintaxis de abreviaturas de enlaces. Tenga en cuenta que debido a que la abreviatura del enlace
el procesamiento ocurre en dos fases, no funciona totalmente cuando llega la entrada
desde la entrada estándar (por ejemplo, si usa stx2any como parte central de un
tubería).

--cita
Solicite la cita de caracteres (que no sean guiones bajos y signos de dólar) que son
de alguna manera mágico en el formato de salida solicitado. Esto lo hará bastante
Es difícil poner marcas en el formato de salida directamente en su documento, pero
aumenta en gran medida la posibilidad de que su documento sea correcto (es decir, no
no tienen errores de sintaxis) en el formato de salida.

--citarme más fuerte
Solicite la cita de guiones bajos y signos de dólar. Esto podría hacer que algo de LaTeX
Los documentos funcionan, pero pueden romper algunos documentos en los que se utilizan guiones bajos en
nombres macro o signos de dólar en definiciones macro.

--numbering {en | apagado }
Solicite la numeración de los títulos de las secciones. El valor predeterminado varía según el formato de salida:
La numeración de secciones está desactivada de forma predeterminada para HTML, DocBook XML y man, activada para LaTeX.

--table-of-contents {en | apagado }
Solicite producir una tabla de contenido a partir de los títulos. El valor predeterminado es
producir un TOC cuando la numeración está activada. No implementado para DocBook XML.

--make-title {en | apagado }
Solicite una "página de título". El valor predeterminado es "activado". Esta configuración no tiene ningún
efecto en algunos formatos. En HTML, produce un gran encabezado al principio de
el documento. En LaTeX, produce el maketitle canónico.

--sin plantilla
No genere una plantilla de documento en absoluto, solo el texto de entrada formateado. usted
Probablemente necesite esto si su documento se incluirá como parte de un mayor
documento. Sin embargo, si ese documento más grande está escrito totalmente en Stx,
sea ​​más limpio para dar todos los archivos fuente directamente como argumentos a stx2any en lugar de
que combinar los resultados después.

- referencias cruzadas simétricas
En formatos de documentos que admiten enlaces (HTML, DocBook), produce enlaces inversos
desde etiquetas a referencias, así como enlaces de referencias a etiquetas.

--látex-params params
Configure los parámetros de la clase de documento para documentos LaTeX. El defecto se ve afectado
por tamaño de papel del sistema; por ejemplo, en un sistema europeo es típicamente
a4paper, notitlepage. (Consulte "MEDIO AMBIENTE" a continuación).

--html-parámetros params
Configure los parámetros de la etiqueta del cuerpo para documentos HTML. El valor predeterminado es sin parámetros.

--sufijo de imagen sufijo
Las imágenes en línea se referirán a archivos con sufijo sufijo. El valor predeterminado es png para
HTML y DocBook, eps para LaTeX y man.

--no-emdash-separado
En la salida, no separe los guiones largos del texto adyacente con espacios. Este es
de acuerdo con la tipografía inglesa tradicional (si la comprendo correctamente), pero
no es estándar en muchos otros idiomas, incluido el finlandés, mi lengua materna.

--más seguro
Deshabilite algunas funciones inseguras de m4 y verifique algunos argumentos de línea de comando que
se pasan al shell para los caracteres problemáticos. Esto podría ser deseable si
ha recibido el documento de otro lugar y desea asegurarse de que no
hacer algo malicioso cuando se convierte. Actualmente esto niega la ejecución de shell
escapa.

Tenga en cuenta que claramente ninguna implementación de m4 ha sido diseñada con seguridad en
mente. Como consecuencia, esta opción no puede prevenir todos los
cosa. Las cosas que no se han impedido de las que tengo conocimiento incluyen contenidos de
archivos arbitrarios en la salida y la escritura de bucles ocupados (de modo que la conversión
utilizará todo el tiempo de procesador que pueda obtener, hasta que finalice).

--preprocesador nombre de la secuencia de comandos
Ejecute el script sed nombre de la secuencia de comandos para todas las entradas. Esto le permite agregar personalizados
marcas de abreviatura. Es casi lo mismo que preprocesar la entrada con sed,
luego lo conecta a stx2any, pero interactúa mejor con --link-abbrevs (vea su
explicación para más detalles).

--versión, -V
Simplemente muestre la información de la versión y salga.

--ayuda, -?
Simplemente muestre un breve mensaje de ayuda y salga.

ESCRITURA HOMBRE PÁGINAS

Básicamente, las páginas man son simplemente archivos en formato de macro man. Sin embargo, hay algunos
programas (en primer lugar mandb) que requieren partes de las páginas de manual para estar en un específico
formato, y las páginas de manual generalmente deben adherirse a la forma y sección estándar (ver man
(1) y lexgrog (1) para más detalles).

Al escribir una página de manual, el título (w_title) de la página debe ser el
programa / archivo / formato / nombre de la utilidad, y debe definir la sección (w_section). Para hacer
la página adecuada para el análisis de mandb, debe iniciar la página con una o más llamadas a
w_man_desc. Esto creará una sección de "NOMBRE" adecuada para usted. (Aunque podrías escribir
uno solo.)

La diagnostica

stx2any puede dar cualquier mensaje de error que pueda dar m4, por ejemplo, en una entrada mal formateada (una macro
llamada sin paréntesis de cierre, etc.). Además, tiene el siguiente error propio
mensajes:

formato de salida desconocido: "X"
Solicitaste un formato de salida no compatible X con la opción -T.

macro desconocida "X" llamada
stx2any encontró una macro que comienza con w_, pero no conoce una definición para ella.
Esto es una advertencia, no un error: la macro infractora y sus argumentos son
despojado de la salida.

entorno "X" cerrado por "Y" en la capa N
Los entornos en stx2any deben estar correctamente anidados. stx2any encontró w_end (Y)
cuando esperaba w_end (X). A menudo, esto es un signo de un w_end olvidado (X).

If N (la capa) es diferente a 0, entonces el problema probablemente esté en su
definiciones de entorno, no en el punto que stx2any estaba procesando cuando
encontró el error.

entorno desconocido "X"
Hubo un intento de comenzar un entorno cuyo nombre es desconocido para stx2any,
es decir, no se ha definido tal entorno.

desvío "X" cerrado por "Y"

desvío desconocido "X"
Igual que el anterior, pero para desvíos (w_begdiv y w_enddiv).

intentar utilizar "X" en un entorno seguro
Solicitó un procesamiento seguro con --more-secure y el documento contenía una
Macro "inseguro". Este es un mensaje de advertencia, no un error: la macro causante
se deja en el texto literalmente.

enlace cruzado desconocido a "X"
Había un enlace cruzado para documentar X, pero stx2any no conoce tal
documento. Probablemente no recopiló los datos de / X / con collect_stx_titles o usted
escribió mal la referencia del documento. Esto es una advertencia, no un error: el
La referencia se deja en la salida textualmente, sin ningún tipo de vínculo.

El valor de retorno de stx2any es cero en caso de éxito, uno si hubo algún problema.

MEDIO AMBIENTE

PAPELCONF

TAMAÑO DE PAPEL
utilizado para determinar el tamaño de papel predeterminado para documentos LaTeX.

Use stx2any en línea usando los servicios de onworks.net