PDF de programación - Manual de Muse

Manual de Muse

un entorno de autor´ıa y publicaci´on
para GNU Emacs y XEmacs

Este es el manual de Emacs Muse versi´on 3.20.
La traducci´on est´a en fase beta.
Copyright c(cid:13) 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
Copyright c(cid:13) de la traducci´on, 2009, 2010 Free Software Fundation, Inc. La traducci´on est´a
realizada por el Departamento de Traducciones t´ecnicas de Urban Planet, de la empresa
Timijiraque, S.L., en su proyecto de Emacs en espa~nol http://gnu.manticore.es. La
empresa cede el copyright a la FSF.

Permission is granted to copy, distribute and/or modify this document under
the terms of the GNU Free Documentation License, Version 1.2 or any later
version published by the Free Software Foundation; with no Invariant Sections,
with the Front-Cover texts being “A GNU Manual”, and with the Back-Cover
Texts as in (a) below. A copy of the license is included in the section entitled
“GNU Free Documentation License” in this manual.
(a) The FSF’s Back-Cover Text is: “You have freedom to copy and modify
this GNU Manual, like GNU software. Copies published by the Free Software
Foundation raise funds for GNU development.”
This document is part of a collection distributed under the GNU Free Docu-
mentation License. If you want to distribute this document separately from the
collection, you can do so by adding a copy of the license to the document, as
described in section 6 of the license.
Todo el c´odigo Emacs Lisp contenido en este documento puede usarse, dis-
tribuirse y modificarse sin restricciones. — [NdT: Por indicaciones precisas de
la FSF, se deja la nota anterior en ingl´es, as´ı como el texto oficial de la Licencia.
La traducci´on se acoge tambi´en a los mismos t´erminos.]

i

´Indice General

1 Acerca de la documentaci´on . . . . . . . . . . . . . . . . . . . 1

2

¿Qu´e es Muse? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

3 C´omo obtener Muse y los cambios en el

desarrollo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
3.1 Versiones publicadas de Muse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
´Ultimos cambios en el desarrollo, no publicados . . . . . . . . . . . . . . . . . 3
3.2

4 Compilaci´on e instalaci´on de Muse . . . . . . . . . . . . 6

5 Comienzo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
5.1 C´omo cargar Muse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
5.2 C´omo editar ficheros en Muse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
5.3 Publicaci´on de un solo fichero o proyecto . . . . . . . . . . . . . . . . . . . . . . . 8
5.4 Empleo de extensiones de fichero distintas . . . . . . . . . . . . . . . . . . . . . . 8

6 Creaci´on y gesti´on de proyectos Muse . . . . . . . . 9
6.1 Ejemplo de proyecto en solitario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
6.2 Ejemplo de m´ultiples proyectos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
6.3 Publicaci´on de sub-directorios de proyectos . . . . . . . . . . . . . . . . . . . . 10
6.4 Listado de opciones disponibles para los proyectos . . . . . . . . . . . . . 10

7 Teclas usadas en el modo Muse . . . . . . . . . . . . . . 13

8 Reglas de uso del marcado. . . . . . . . . . . . . . . . . . . . 15
8.1 P´arrafos: centrado y citas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
8.2 Niveles de las cabeceras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
8.3 Directivas al comienzo de los documentos . . . . . . . . . . . . . . . . . . . . . . 16
8.4 Texto en negrita, cursivas y subrayadas . . . . . . . . . . . . . . . . . . . . . . . . 16
8.5 Notas a pie de p´agina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
8.6
Indicaci´on de estrofas po´eticas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
8.7 Listas de elementos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
8.8 Generaci´on de tablas de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
8.9 Hiperenlaces y direcciones de correo con descripciones . . . . . . . . . 20
8.10 Enlaces a URL desnudas, NombresWiki e InterWiki . . . . . . . . . . 20
8.11 Publicaci´on y visualizaci´on de im´agenes . . . . . . . . . . . . . . . . . . . . . . 21
8.12
Inserci´on de l´ıneas horizontales o anclas . . . . . . . . . . . . . . . . . . . . . . 22
8.13 Evaluaci´on de c´odigo Emacs Lisp en los documentos, para la

extensibilidad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

ii

8.14 Soporte para citar otros recursos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
8.15 L´ıneas omitidas en la salida publicada . . . . . . . . . . . . . . . . . . . . . . . . 23
8.16 Etiquetas reconocidas por Muse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

9 Publicaci´on de diversos tipos de documentos

9.1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Integraci´on de Muse con pyblosxom.cgi . . . . . . . . . . . . . . . . . . . . . . . . 28
9.1.1 Otras herramientas necesarias para el estilo Blosxom . . . . . . 28
9.1.2 Formato de las entradas Blosxom y automoci´on . . . . . . . . . . . 29
9.1.3 Estilos y opciones proporcionados para Blosxom . . . . . . . . . . 30
9.2 Publicaci´on de entradas en una compilaci´on . . . . . . . . . . . . . . . . . . . 30
9.3 Publicaci´on de documentos ConTeXt . . . . . . . . . . . . . . . . . . . . . . . . . . 31
9.4 Publicaci´on en formato DocBook XML . . . . . . . . . . . . . . . . . . . . . . . . 34
9.5 Publicaci´on en formato HTML o XHTML . . . . . . . . . . . . . . . . . . . . . 35
9.6
Integraci´on con ikiwiki . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
9.7 Mantenimiento de un diario o bit´acora (o blog) . . . . . . . . . . . . . . . . 38
9.8 Publicaci´on de documentos LaTeX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
9.9 Publicaci´on de poemas en LaTex o PDF . . . . . . . . . . . . . . . . . . . . . . . 44
9.10 Publicaci´on de entradas en formato Texinfo o PDF . . . . . . . . . . . 46
9.11 Publicaci´on de entradas en XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

10 Creaci´on de estilos de publicaci´on propios

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
10.1 Especificaci´on de funciones para marcar texto . . . . . . . . . . . . . . . . 49
10.2 Reglas de marcado para la publicaci´on . . . . . . . . . . . . . . . . . . . . . . . 49
10.3 Cadenas espec´ıficas de un estilo de publicaci´on . . . . . . . . . . . . . . . 51
10.4 Especificaciones de etiquetas para marcados especiales . . . . . . . . 56
10.5 Par´ametros empleados para la definici´on de estilos . . . . . . . . . . . . 57
10.6 Derivaci´on de estilos nuevos a partir de otro existente . . . . . . . . 58

11 Complementos miscel´aneos, por ejemplo un

modo menor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
11.1 Edici´on f´acil de listas en otros modos mayores . . . . . . . . . . . . . . . . 60

12 Obtenci´on de ayuda y reporte de fallos . . . . 62

13 Historia de este documento . . . . . . . . . . . . . . . . . 64

14 Contribuidores a esta documentaci´on . . . . . . 65

Ap´endice A Licencia de Documentaci´on Libre de
GNU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
ADDENDUM: How to use this License for your documents . . . . . . . . . 72

´Indice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Cap´ıtulo 1: Acerca de la documentaci´on

1

1 Acerca de la documentaci´on

Este documento describe Muse, que fue escrito originalmente por John Wiegley y ahora lo
mantiene Alex Ott. Est´a disponible en l´ınea en varios formatos.
• http://www.gnu.org/software/emacs-muse P´agina web oficial del paquete.
• http://gnu.manticore.es/manual-muse-emacs P´agina web dedicada completamente a
Emacs en espa~nol, responsable de la traducci´on de este manual y en donde se mantienen
las ´ultimas correcciones.

Cap´ıtulo 2: ¿Qu´e es Muse?

2

2 ¿Qu´e es Muse?

Emacs Muse (tambi´en conocido como “Muse” o “Emacs-Muse”) es un entorno de autor
y de publicaci´on para Emacs. Simplifica el proceso de escritura de documentos y de su
publicaci´on en varios formatos de salida.

Muse consiste en dos partes principales: un modo texto mejorado para la creaci´on de
documentos y la navegaci´on a trav´es de proyectos Muse, y un conjunto de estilos de publi-
caci´on para la generaci´on de diferentes tipos de salida.

Lo que hace a Muse distinto de otros sistemas de publicaci´on de texto es un entorno
modular, con un n´ucleo bastante simple, en el cual los "estilos" se derivan unos de otros.
La mayor parte de la funcionalidad general de Muse es optativa. Por ejemplo, se puede
usar el publicador sin el modo mayor, o el modo sin hacer ninguna publicaci´on; o si no se
cargan los m´odulos Texinfo o LaTeX, esos estilos no estar´an disponibles.

El c´odigo base de Muse proviene de ‘emacs-wiki.el’ versi´on 2.44. El c´odigo ha sido
reestructurado y reescrito, especialmente sus funciones de publicaci´on. El foco de esta re-
visi´on est´a en los aspectos de autor y de publicaci´on, y la "wikiner´ıa" ha sido removida como
comportamiento predeterminado (pero est´a disponible en el m´odulo optativo ‘muse-wiki’).
Las palabras TipoCamello no siguen siendo especiales por defecto.

Una de las pretensiones principales del desarrollo de Muse es hacer muy f´acil la pro-

ducci´on de documentos con muy buena vista y conformes a los est´andares.

Cap´ıtulo 3: C´omo obtener Muse y los cambios en el desarrollo

3

3 C´omo obtener Muse y los cambios en el

desarrollo