Lenguas: es - fr - en

frundis: un lenguaje de marcado semántico

1 Introducción

frundis es un lenguaje de markup con una sintaxis roff-like simplificada, originalmente diseñado para escribir novelas, pero puede servir para diversos tipos de documentos. El programa frundis exporta ficheros escritos en este lenguaje a formatos LaTeX, XHTML, EPUB, markdown y groff mom. Únicamente los exportes a los formatos LaTeX, XHTML y EPUB son considerados maduros y completos.

El lenguaje se centra en la simplicidad ofreciendo un pequeño número de macros predefinidas flexibles, e intenta producir mensajes de error decentes, a la vez que permite controlar explícitamente el resultado para un formato específico cuando es necesario.

He aquí una lista de sus características principales:

2 Documentación

frundis está documentado en sus páginas man (en inglés):

Para hacerte una idea rápida, echa un vistazo al ejemplo más abajo.

3 Instalación

Sigue las instructions del README en github. El programa se publica bajo licencia libre (tipo BSD). La última versión (0.5) se puede descargar aquí también.

La versión Perl vieja puede obtenerse todavía desde CPAN.

Patches y peticiones de pull son bienvenidos!

4 Comunidad

Puedes inscribirte a la lista de difusión de usuarios de frundis.

5 Un ejemplo: esta misma página!

He aquí el código que sirvió para generar esta página:

.\" Esta línea es un comentario
.\"
.\" Declaraciones de tags
.X mtag -f xhtml -t program-name -c span
.X mtag -f xhtml -t code -c code
.X mtag -f xhtml -t voc -c span
.X dtag -f xhtml -t frundis-code -c div
.\" Definición de una macro para no repetir varias veces
.\" lo mismo
.#de frundis
.\" Marcado de texto
.Sm -t program-name frundis \$@
.\" Luego podremos escribir .frundis en vez de la línea
.\" que precede. El \$@ son los argumentos, útil para añadir
.\" puntuación si hace falta. Fin de la definición:
.#.
.\" Título
.X set document-title "frundis: un lenguaje de marcado semántico"
.\"
.\" Índice de contenidos
.Tc
.\" Imagen con "Frundis"
.Im /images/frundis-mini.jpg
.\" Una sección
.Sh Introducción
.\" Llamada a la macro definida
.frundis
es un lenguaje de markup con una sintaxis roff-like
simplificada, originalmente diseñado para escribir
novelas, pero puede servir para diversos tipos de
documentos. El programa 
.Sm -t code frundis
exporta ficheros escritos en este lenguaje a formatos
LaTeX, XHTML, EPUB, markdown y groff mom.
.Bm
Únicamente los exportes a los formatos LaTeX, XHTML y
EPUB son considerados maduros y completos.
.Em
.P
El lenguaje se centra en la simplicidad ofreciendo un
pequeño número de macros predefinidas flexibles, e
intenta producir mensajes de error decentes, a la vez
que permite controlar explícitamente el resultado para
un formato específico cuando es necesario.
.P
He aquí una lista de sus características principales:
.\" Empezar una lista "Begin list"
.Bl
.It
Elementos típicos como los enlaces, imágenes,
referencias internas, listas (incluso poemas), tablas
sencillas, índice de contenidos, etc.
.It
EPUB con metadatos arbitrarios. Ficheros html con
índice.
.It
Definición
.Sm -t voc tags
de markup cuyo exporte puede ser configurado.
.It
Inserción de bloques LaTeX, XHTML, etc.
.It
Inclusión de ficheros. Filtros, macros y variables.
.It
Sintaxis al estilo roff: sencilla, clara y se harmoniza
bien con grep y diff.
.\" Fin de la lista "End list"
.El
.Sh Documentación
.frundis
está documentado en sus páginas man (en inglés):
.Bl -t item
.It
.Lk /frundis/frundis-1.html frundis(1)
describe el uso del programa en línea de comando.
.It
.Lk /frundis/frundis_syntax-5.html frundis(5)
describe la sintaxis del lenguaje.
.El
Para hacerte una idea rápida, echa un vistazo al
.\" enlace interno con label
.Sx label "ejemplo más abajo" .
.Sh Instalación
Sigue las instructions del README en
.Lk https://github.com/anaseto/gofrundis/ github .
El programa se publica bajo licencia libre (tipo BSD).
.If version.frundis \" fichero que define el número de versión
La última versión (\*[version]) se puede descargar
.Lk /frundis/frundis-\*[version].tar.gz aquí
también.
.P
La versión Perl vieja puede obtenerse todavía
.Lk https://cpan.metacpan.org/authors/id/A/AN/ANASETO/Text-Frundis-2.16.tar.gz "desde CPAN" .
.P
Patches y peticiones de pull son bienvenidos!
.Sh Comunidad
Puedes inscribirte a la
.Lk https://listengine.tuxfamily.org/lists.tuxfamily.org/frundis-users/ \
  "lista de difusión de usuarios de frundis" .
.Sh -id label Un ejemplo: esta misma página!
.\" incluir un fichero que define macros para bloques de
.\" código
.If ../code.frundis
He aquí el código que sirvió para generar esta página:
.Bd -t frundis-code
.\" Este mismo código es coloreado gracias a un pequeño
.\" script y luego se incluye tal cual.
.X ftag -t frundis -shell "perl html_coloration.pl"
.include-code-with-filter frundis intro-es.frundis
.Ed