Los pájaros de hogaño

El chino de Kurosawa (poema)

2011-11-02T16:35:00.002+01:00

El castaño de las eras (poema)

2011-11-01T18:40:00.002+01:00

La piedra del corazón (poema)

2011-10-30T15:08:00.002+01:00

El roble descuajado (poema)

2011-10-28T22:59:00.002+02:00

De la forma y sus demonios

2011-10-28T12:00:00.004+02:00

Los estetas reclaman la descomposición de la forma, o su chocante "originalidad", o su libertad inconculcable y contestaria. Pues esteta es quien goza de esas literarias o artísticas rupturas, cansado como está ya, sin saberlo, de su no vivir entregado o vendido a la contemplación de tanto arte, mucho de él, según él dice, trasnochado; todo él, en todo caso, sucedáneo de una vida (la suya) donde el existir está marcado únicamente por el deseo de distinción, en gustos refinados y minoritarios, y por la carencia total de empatía con lo que hay detrás de todo arte verdadero.

Los diletantes, por su parte, denostan los "experimentos" vanguardistas. Su buen gusto no tolera esos, según ellos, espurios esfuerzos de una inteligencia rebuscada y artificiosa por destacarse de lo natural y sano y elevado. Aunque no sea elevación lo que el diletante busque, sino el adorno y suave consuelo de la monotonía de su, más que seguramente, afortunada y acomodada supervivencia.

Ni unos ni otros se deshacen de sus prejuicios, pues son más que prejuicios, son su traición y su trampa. Ni unos ni otros comprenderían que detrás del equilibrio y quietud de la forma puede estar el deseo agónico de un corazón por hallar un último refugio a su desmembramiento y disolución (Hölderlin, Poemas de la Locura) o que por dentro de la forma derruida y la oclusión del sentido está siempre, cuando es verdadero, el martirio de un espíritu para el que la vida empieza a dejar de ser posible (Celan).

Decía Schelling que el mayor logro de la filosofía sería su desaparición. Más valdría que el arte, todo él, desapareciese de la escena pública. O que quedase sólo como lo que realmente es, cuando es lo que es, desde que perdió su puesto en el seno de una comunidad efectiva, hace tiempo inexistente e irrecobrable, es decir, como la enfermedad o el pecado privado del exiliado, del tarado, del loco.

El resto no es más que literatura. Cosas de estetas y diletantes, que, con razón (la suya siempre) arrojarán esta diatriba al fuego de su indiferencia, no sin antes haberla etiquetado como corresponde: un ejemplo intempestivo del malditismo romántico o postromántico.

Iglesia de la Magdalena (poema)

2011-10-20T17:25:00.002+02:00

El reloj del salón (poema)

2011-10-19T18:40:00.003+02:00

Plaza de la Universidad (poema)

2011-10-18T16:34:00.004+02:00

El osolito (poema)

2011-10-16T21:36:00.003+02:00

El tarado (poema)

2011-10-15T22:01:00.002+02:00

Zampa (poema)

2011-10-14T22:51:00.002+02:00

El sendero de la alambrada (poema)

2011-10-12T12:45:00.003+02:00

[retocado: 15/10/11]

El pastizal de las terneras (un poema)

2011-10-09T22:45:00.001+02:00

Tres poemas

2011-10-03T14:34:00.009+02:00

La reguera

(16 de septiembre)
[retocado: 15/10/11]

La Huerta Grande

(17 de septiembre)
[retocado: 15/10/11]

La casa materna

(3 de octubre)
[retocado: 15/10/11]

Ocho poemas

2011-07-02T23:31:00.023+02:00

Las palabras no dicen la verdad. Pero cantar es desdecirse en cada aliento. El mundo son las palabras de la infancia, que el hombre olvida. El viejo ---como cantaba Aleixandre en un poema último--- lo sabe: "sólo el niño conoce", pues está solo. Por eso únicamente el niño se despide. El hombre es ya el despedido, el que está más allá de sus adioses, después y detrás ---en el olvido--- de sus adioses. Olvidar es vivir. El canto es la memoria de ese olvido. Sobre todo cuando brota, un día cualquiera, de esa luz imposible de la infancia ---aquel día cualquiera de nuestro calendario---, antes de que el cantor lo olvide, y viva.

27 de marzo

3 de abril

4 de abril

21 de abril

15 de mayo

22 de mayo

5 de junio

26 de junio

Canto y escritura (II)

2011-01-19T13:40:00.008+01:00

En la entrada anterior a ésta presentaba ejemplos en los que la escritura trata de encontrar medios poco habituales de plasmar el canto que representa.

Me gustaría añadir un nuevo ejemplo, donde las dificultades descritas en la entrada referida se hacen más evidentes y, en algún sentido, más peliagudas:

La primera es que hay aquí una polifonía implícita (aparte de la que introducen los paréntesis), polifonía no señalada de ninguna forma especial. Pero justo en el último verso esa polifonía se hace manifiesta, en la extraña sílaba con que se inicia ("prö"). En ese momento se unen "en acorde" dos voces: la sílaba final de "era" con la sílaba final de "tiempo", donde "ra" es continuación del "e-" del final del verso anterior y "po" es la continuación anticipada (pero prefigurada en la insistente repetición de "el tiempo" a lo largo del canto) de la sílaba "tiem-" con que acaba el verso. Pero ¿cómo cantar ambas voces a la vez? He preferido aquí construir una sílaba inexistente en castellano en que ambas voces (las sílabas correspondientes a cada voz) se traban en su decir simultáneo, pues es hacia esa precisa trabadura hacia la que el canto en ese momento se siente impelido.

Podría haber elegido esta otra posibilidad, donde la palabra se ramifica, con el fin de señalar justamente que ambas ramificaciones deben pronunciarse simultáneamente:

Probablemente, si el canto contuviera un mayor número de "acordes", esta sería la mejor forma de representarlos mediante la escritura, aun siendo menos precisa que la anterior. No se trataría en tal caso de caminos posibles del canto, como puede suceder en otros autores, sino de canto simultáneo.

Una segunda dificultad tiene que ver con el carácter cíclico del poema (de ahí, entre otras cosas, el subtítulo "Letanía"). Podría haber echado mano, a pesar de mi tendencia acusada a no hacerlo nunca, de signos musicales de repetición, a saber, haber enmarcado el poema entre los signos ||: y :||, pero me ha parecido más conveniente y menos abstracto recurrir a una flecha que parta de la última sílaba del último verso y se dirija hacia el comienzo del primer verso. La flecha aquí no es más que la indicación de que el canto debe repetirse incesantemente, sin término, o hasta que la extenuación del recitador lo concluya abruptamente. Canto, pues, o letanía que no sale de sí, que se autoengendra y en sí mismo se desploma. Canto que sólo podrá enmudecer en un silencio inevitablemente prematuro.

Canto y escritura

2011-01-17T01:12:00.008+01:00

Si ya Platón reflexionaba en el Fedro sobre los peligros que para el filosofar podía conllevar la escritura, también la poesía escrita ---así lo he sentido yo siempre--- se enfrenta a amenazas semejantes, al menos para quien considera y siente, como es mi caso, que los versos que ahora leemos en un libro son únicamente canto y que sólo por razones históricas el canto ha dejado de ser directamente cantado por el cantor o intérprete (el rapsoda griego, por ejemplo) y se ha convertido en página escrita o impresa.

Sé perfectamente que esta percepción de la poesía como canto se aleja de otras posibles. No voy a especular en este sentido. Simplemente, no me interesa la poesía que no es esencialmente un canto. De ahí, mi preferencia del término "canto", que evita malentendidos, en detrimento del término "poesía".

El canto se canta. Debe cantarse el verso que se lee, debe entonarse en voz perceptible, si es que se quiere hacer justicia a su alma (el ritmo) y a su cuerpo (la palabra pronunciada). Sólo en su recitación cobra vida el poema, el verso. El lector del canto escrito es y debe ser su intérprete, de la misma forma que el cantante da vida a la partitura que canta.

Normalmente no hay dificultades especiales en este sentido para quien recita, más que las ya conocidas, que se resuelven gracias a la práctica y el conocimiento práctico de recursos poéticos comunes (sinalefa, hiato, encabalgamiento, etc.). Pero los problemas se agudizan cuando el canto se instala en regiones menos familiares, donde no hay referencias establecidas por el uso, máxime cuando el libro de poemas no recurre a esa práctica habitual en la edición de partituras de música contemporánea, la de proporcionar una serie de instrucciones previas sobre la forma de ejecutar determinados signos no convencionales.

En los casos a que me refiero se puede producir una confusión en el lector. Allí donde él ve algo que se resiste a su recitación inmediata puede entender que ya no se trata de la "partitura" de un canto, sino de alguna clase de pictograma, donde lo que cuenta es la pura forma de los signos escritos y su juego estético. Pero no siempre es así. Y cuando no es así, el poeta se enfrenta a una dificultad inesperada, la de presentar mediante una escritura extraña un canto que, en su dicción, se separa de lo familiar.

Me gustaría ilustrar con ejemplos propios este tipo de dificultad.

En la página de la figura siguiente, que pertenece al final de un poema más largo, utilizo la repetición de letras y la distancia entre versos para tratar de señalar al lector como debe cantar el poema, en concreto, la palabra "viene". Las distancias entre versos (los silencios entre versos) son mayores que los que separan los versos previos del poema; la dicción de ciertos fonemas debe alargarse mucho más de lo que normalmente les correspondería. No hay aquí ninguna forma especial de señalar mediante signos rítmicos propios de la música la duración exacta de estas "prolongaciones" de la duración (se supone, por lo demás, que el lector no tiene por qué saber música). Esto implica que se deja libertad al lector para que sea él quien busque un canto convincente y adecuado. De ahí que el número de repeticiones de letras o las distancias entre versos sea meramente aproximada.

El próximo ejemplo es más complicado. Aquí los paréntesis indican silencios. Pero en este caso la duración del silencio se establece con mayor precisión que en el caso anterior.

Un lector atento puede llegar a comprender que en realidad se trata de dos tipos de silencio. Los primeros, que aparecen al final de algunos versos, están por algo que falta, que no se da. La repetición del canto inicial se retoma de nuevo, cuatro veces, como se observará, pero no siempre desde el mismo lugar del metro heptasilábico. Esto provoca en ocasiones la imposibilidad de completar el metro. Se produce entonces un vacío, que debe entonarse como silencio, como ausencia, y que se señala mediante dichos paréntesis. Junto con estos paréntesis hay otros de longitud variable. No se trata de meros huecos, cuyo tamaño ha sido caprichosamente elegido por razones de diseño gráfico. Se trata de agujeros o enmudecimientos en el canto (el mismo y único canto repetido cuatro veces), zonas donde el silencio se apodera del canto. Y ese silencio dura y ha de durar lo mismo que el canto sumergido en él. El lector se ve obligado a "sentir" por dentro el canto de antes mientras el silencio que lo embarga dura exactamente lo que aquel canto previo.

Finalmente, tampoco es un artefacto arbitrario de la escritura situar las últimas palabras "sus arenas" fuera de la columna de heptasílabos. "sus arenas" debe salir del canto estrófico, y ello se indica extrayendo la palabra fuera de su lugar habitual, porque, en verdad, estas palabras rompen el pie yámbico en que se escancia el resto del poema. Justamente tal hecho puede igualmente indicar al lector hasta qué punto en este poema es esencial una entonación que exagere, más allá de lo que sería habitual en poesía española, precisamente ese pie, el yambo, que lo exagere (distinguiendo en la dicción la sílaba breve de la larga) hasta llegar a esas dos últimas palabras donde el canto se detiene contra su propia voluntad.

En el ejemplo que sigue las cosas parecen más comprensibles. Aquí el único recurso atípico es el uso de colores diferentes. Y lo que estos colores indican resulta, debería resultar, bastante claro: dos voces distintas. En efecto, se trata de un poema polifónico, a dos voces; más exactamente de dos cantos encajados uno en otro. Es obligación del lector interpretar estas dos voces como dos voces reales (tal vez, su propia voz y un susurro, alternativamente).

No me gustaría terminar sin un último ejemplo que, en alguna medida, contradice mi posición inicial, la de la prevalencia absoluta del canto sobre la escritura. En este ejemplo se usan dos recursos que no tienen ninguna posibilidad (o muy poca, sin duda) de encontrar dicción: una palabra tachada, y una palabra con parte de sus letras rotadas hacia atrás. Renuente, como soy, a todo artefacto que pertenezca a la mera escritura o la experimentación porque sí, me he sentido, sin embargo, obligado a pasar aquí por esta excepción, quizá en la sensación de que también el canto, como sucede en ciertos jeroglíficos antiguos, puede valerse en algunos extraños momentos de tales artefactos, para sugerir, allí donde se impone, matices puramente emocionales (una atmósfera súbita) en el interior de sí mismo.

Nihilismo y aledaños

2010-09-28T19:07:00.008+02:00

Desde hace bastante, el nihilismo, su sentido, su origen, sus consecuencias, sus fenómenos paralelos, etc. han ocupado continuamente mi pensamiento. En algún otro lugar de este blog he hecho referencias a ello

Con ocasión de esta nueva entrada (cuánto tiempo sin volver al blog y cuánto, a buen seguro, el que transcurrirá sin que regrese a él) recuerdo libros extraordinarios, como muchas de las novelas de Dostoyevski, o releo mis propias reflexiones de hace algunos años, como estos fragmentos que ahora me atrevo a dar a la luz pública: Apuntes sobre el nihilismo.

Pero los interrogantes que para mí abre el nihilismo siguen siendo tan inabordables como el propio nihilismo.

Pienso, por ejemplo, en los personajes "nihilistas" de Los demonios de Dostoyevski. ¿Cuántos nihilistas verdaderos hay ahí? ¿Cuántos son sólo aparentemente nihilistas?

Hay también ahora aspectos psicológicos que reclaman mi atención últimamente. El motivo es múltiple. Parte de ese motivo nace de un intercambio teórico sobre figuras terribles de la historia contemporánea, no hace falta citar nombres, porque hay demasiados. Digamos que alguien, imbuido en un pensamiento de raíz oriental, teoriza del modo siguiente:

El problema de los grandes genocidas conocidos de todos es el de la perversión de una idea como consecuencia de un desajuste entre su "mundo onírico o ideal" y el "mundo real", concretamente de una imposibilidad por parte del asesino de canalizar la energía de su "mundo onírico o ideal" en el mundo real.

Pero una teoría como la citada comete el craso error de identificar al genocida nihilista con el mero loco, o, incluso, con ciertos tipos, bien humanos y no nihilistas, de criminales. No hay nada en este esbozo de teoría que permita distinguir un caso del otro. Y son radicalmente distintos, aunque pueda haber puntos de interferencia. Puede haber, en efecto, criminales y locos nihilistas, como también nihilistas que no actúan criminalmente ni locamente de acuerdo con lo que la sociedad estipula como locura o crimen. ¿No es acaso la sociedad contemporánea entera ella misma nihilista en un sentido muy profundo?

Así, y en franca oposición al esbozo teórico referido, tiendo a pensar que la locura, tal como la entendemos normalmente, esto es, la patología verificable en las consultas de psiquiatras o psicólogos, bien pudiera ser una reacción psicológica de defensa contra la amenaza nihilista.

Quisiera explicar ---y explicarme--- este último punto, sin pretender llegar a nada más que a dar vueltas sobre el tema.

Si adopto metáforas arbitrarias (mi conocimiento de lo oriental es limitadísimo), por ejemplo, la metáfora del corazón (o, en general, de la entraña) como sede de la voluntad y de la energía creativa, o la metáfora del alma (o del espíritu) como sede del yo en el sentido platónico, y por tanto, su centro existencial, moral, etc., podría elaborar la siguiente hipótesis psicológica. Algo de andar por casa, naturalmente, porque carece de rigor filosófico (mejor sería hacer un poema; pero ahora no me sale ;-) )

Las enfermedades paralizantes del ánimo, como la consabida y ubicua depresión, que, desde las metáforas aludidas, sería una parada del corazón, un debilitamiento absoluto de la energía psíquica, salvaguardaría al individuo, sometido a un conflicto interior de magnitud para él inabordable, del proceso verdaderamente destructivo que supondría la conversión de su alma ---siguiendo con las metáforas--- de fuente de luz en fuente de negror. Otros desequilibrios anímicos, en los que el sujeto se escinde o se rompe, también pudieran estar "protegiendo" al sujeto del salto nihilista. Por supuesto, el suicidio, mostraría en grado máximo esa forma de protección (Evidentemente, el Kirilov de Dostoyevski no es un nihilista).

¿Salto nihilista? El salto nihilista es una expresión más para captar algo así como el verse súbitamente "endemoniado" (en el sentido de Dostoyevski). El verdadero endemoniado mantiene intactas y a su servicio todas sus facultades psíquicas. No hay ahí la parálisis del depresivo; ni hay tampoco la escisión del esquizofrénico; ni, por supuesto, la voluntad suicida (el suicida, el premeditado, ama, ante todo, su dignidad, que no puede preservar en sus circunstancias actuales y para cuya salvaguarda debe acudir a la voluntaria cesación de su existencia temporal). Pero el nihilista, el Piotr Stepanovich, por ejemplo, está lleno de juicio calculador y pletórico de fuerza creativa. Su creación no es otra que la nada; la aniquilación, porque sí (y hay que subrayarlo), del mundo, potencia aniquiladora que puede enmascararse ideológicamente como se quiera, eso no sería más que una forma más o menos consciente de conseguir prosélitos y llevar a cabo el plan. Cualquier plan es intercambiable con tal de que su efecto coincida con el origen del que nace: la inexistencia absoluta en el alma del "endemoniado" de todo valor y de todo amor. El "endemoniado": un ser sin alma, o con un alma donde el ángel (diría, tal vez, un Platón cristianizado) ha sido suplantado por un demonio.

¿Cuál es el origen del salto nihilista? Imposible saberlo. Hay, naturalmente un clima dominante, un clima nihilista circundante. ¿Se nace nihilista? No lo creo. Pero me interesa más la pregunta: ¿Puede uno llegar a perder (volvamos con la metáfora) su alma? ¿Qué sucede, por ejemplo, incluso en el más enérgico y espiritual de los hombres, cuando en ciertos momentos de extrema penuria y conflicto insoluble, los recursos psicológicos habituales (depresión, desequilibrio psíquico patológico de todo tipo) no están a la mano, no funcionan, o dejan de funcionar porque que se superan y se cura la patología inicial? ¿No puede suceder que la energía psíquica salga indemne, que el corazón continúe palpitando firme y regularmente, y el sujeto logre destruir el conflicto echando mano de lo más simple: la degradación definitiva de los elementos que lo constituyen, su nulificación, su conversión en meras nadas, nadas que ya no afectan porque se viven como nadas? El otro convertido en nada, quizá en un sentido muy levinasiano: la nada activa y plena (el demonio) en que se ha convertido el nihilista asimila al otro a su nada.

¿Quién puede tolerar el asesinato del absoluto inocente? Esta pregunta del Iván Karamazov de Dostoyevski tiene una respuesta: sólo el nihilista. No puedo dejar de recordar, a propósito de esta última consideración, la primera secuencia de "Una historia de violencia", el film de Cronenberg, otra exposición maestra de un acto nihilista.

Banalidad del mal, diría Hannah Arendt, mal que nace de la conversión de todo ser, de toda existencia, de toda fuente de luz, en pura nada, en lo arbitrariamente prescindible, porque no es nada.

El rey y el mendigo

2010-02-17T16:44:00.004+01:00

Hace unos días me referí a la última película de Tarkovski. Allí el cuadro de Leonardo, Adoración de los Reyes Magos, constituye un motivo central. La primera escena es un recorrido de abajo a arriba del cuadro, desde la mano oferente del mago hasta la copa del árbol, símbolo del Nuevo Reino, que se haya en la misma vertical que la ofrenda. En la película del director ruso esta ofrenda representa el sacrificio al que alude el nombre del film y en torno al cual gira su sentido.

Sea cual sea la interpretación que queramos dar al cuadro, resulta obvia la maestría con que Leonardo ha sabido captar la naturaleza paradójica de la ofrenda y, en particular, de la ofrenda que el siervo ---aquí un mago, un sabio, pero siervo en definitiva--- eleva a su Señor, el Niño aquí.

¿Quién da, quién recibe? El Niño en su plenitud no necesita ningún regalo. El mago, sin embargo, postrado tras el cansancio de un larguísimo viaje y lastrado por la precariedad de su existencia mortal requiere la atención de quien pueda salvarle en la esperanza.

No es diferente la situación del poeta respecto al canto. Sócrates, en el Ión, se refería a lo que posteriormente se ha llamado inspiración con la metáfora del jardín de las Musas. Allí liba el poeta y obtiene el licor sagrado.

Más cercano parece a la realidad del hecho poético imaginar al cantor como un vagabundo que merodea por los jardines inmortales y en cuyo corazón y en cuya boca liba la propia Musa. Sería la Musa quien otorga el canto, apenas sin intervención del cantor. Éste lo único que puede es estar cerca de donde la Musa quizá more.

Vagabundo, entonces, el poeta, que lo pide todo y nada por sí puede, como el mago de Oriente, cuya existencia y cuyo sentido consistiría en ofrendar su esperanza a la mano salvífica.

El poeta, pues, no da, recibe, recibe desde su penuria, desde su deseo, deseo al que no puede ni sabe sino sacrificase. Recibe el canto, que le hace siervo, cuando se le otorga; desterrado mendigo, cuando se le oculta.

La verdad de la poesía

2010-02-03T14:32:00.005+01:00

En Sacrificio, la última película de Andréi Tarkovski, su protagonista principal, Alexander, justo después de tocar al órgano un preludio de Bach y justo antes de su unión salvífica con María, esto es, entre dos vivencias de sublime sencillez, relata una experiencia traumática. Tratando de agradar a su madre, muy enferma entonces, se propuso arreglar el jardín que la anciana contemplaba a diario y otorgarle una belleza sin mácula que ---eso pensaba él--- el jardín había perdido tras años de abandono y descuido. Después de varios días de incansable trabajo miró exhausto, pero orgulloso, el resultado de su esfuerzo. Lo que vio le espantó de horror: de la belleza natural de aquel jardín no quedaba nada, sólo las huellas de su guadaña y sus tijeras, que habían arruinado para siempre el objeto del amor de su madre.

La filosofía moderna en su forma consumada, la de la fenomenología de Edmund Husserl, parte de un principio fundamental, su principio rector, su utopía, retornar a las cosas mismas (zurück zur Sachen selbst), dejar que las cosas se muestren tal cual son, sin que la intervención del pensamiento introduzca interpretaciones de la cosa no adecuadas a ella y que hagan pasar la cosa por lo que ella no es.

¿Hay verdad en la poesía? Opino que sí, y que el dicho homérico los poetas mienten demasiado habría que aplicárselo antes bien al artesano que, por imprudencia, precipitación o cualquier otro motivo bien comprensible, esclaviza al poeta que quiere ser, tratando de cuadrar el verso mediante su pericia. Todo artesano diestro sabe cómo completar el poema, cómo producirlo, incluso cuando ni tan siquiera hay poesía, cuando no hay dato, cuando la cosa poética está ausente.

Pero para que Tarkovski y Husserl hagan sentido, debemos presuponer que ciertamente hay la sencillez previa, el dato inicial. La cosa del poeta sería, desde esta perspectiva, la unidad de palabra, ritmo, imagen y emoción que abruma y embarga al poeta cuando está poseído ---por usar la idea platónica--- y que el poeta se ve impelido a explorar sin descanso. El artesano, que el poeta también es, alcanzaría el grado máximo de destreza cuando, armado de paciencia e inalienable inconformismo, fuese capaz de hacer enmudecer lo que en él hubiera de imposición, de sometimiento a una belleza cerrada y definitiva, de deseo de apaciguarse en lo no aporético.

Quizá sea cierto que el esfuerzo mayor de todo artista consista esencialmente en descartar, en decir no a lo que por cansancio, precipitación o simple afán de notoriedad se cuela a hurtadillas.

La verdad de la poesía radicaría, pues, en este deseo inexcusable de honestidad. El logro, el acierto ---de haberlo--- parece estar más allá de todo esfuerzo y de toda voluntad, tal vez como don, como regalo.

La lucidez del poeta

2010-01-28T16:55:00.003+01:00

El poeta es lúcido donde el pensamiento no suele ni puede serlo. Cuando hay poesía, y no prescindible e insípida versificación, hay también lucidez.

La lucidez del filósofo, en las pocas veces en que puede hallarse, no basta. El poeta es necesario, pues sólo él pone los cuerpos, ese alear del viento, esa mirada fugitiva e insustituible, bajo la luz de su palabra.

Palabra que acoge el tiempo, pero no el tiempo objetivo de la ciencia, ni siquiera el tiempo fenomenológico de la vida (Bergson, Husserl), sino la sustancia misma del tiempo, cada una de esas cosas insignificantes de las que científico y filósofo hacen abstracción metódicamente necesaria.

Pues la poesía es recuerdo, cercanía del corazón al latir del tiempo que vive en los seres fugitivos, arrojados a un heraclíteo fluir, donde se gasta y se juega la vida, la nuestra, la única que al cabo enciende nuestros ojos, porque la amamos, porque la perdemos.

La música contemporánea también puede ser libre

2010-01-27T10:57:00.004+01:00

No suelo aludir aquí a los sitios web de mis amigos, aunque a veces los cite o los enlace, con gran gusto por mi parte, todo hay que decirlo. Pero en este caso voy a hacer una excepción.

Y haré la excepción no porque el amigo sea aquí un íntimo de toda la vida con el que tantas cosas se han compartido y se siguen compartiendo; ni siquiera por las muchísimas veces que hemos hablado, entre copa o copa, o paseo y paseo, de la necesidad de abrir también la cultura de la música contemporánea, tan enclaustrada, por desgracia, en las inaccesibles sedes de sus habituales lugares de manifestación.

Haré la excepción precisamente porque con su gesto, con el gesto de mi amigo, esa cultura accede al lugar de todos para ser compartida, como era necesario. Y lo hace, quizá sea ello lo más significativo, de la mano del trabajo de un músico excepcional en muchos sentidos ---y creo que de esto entiendo lo suficiente como para no dejarme mover por subjetivos afectos.

Espero que todos disfruten de la generosidad de mi amigo y que otros sepan tomar el guante sin dejarse llevar por tópicos trasnochados. He ahí el enlace:

http://joseluistora.wordpress.com/

Gracias, Jose

El dandi y el inquisidor

2010-01-26T15:42:00.004+01:00

La carne está hecha de tiempo y de memoria. Por eso es ella la que, abierta en el tremor de su deseo, recibe la promesa de un futuro, el solo nuestro, donde seguir amando.

Negar la carne es matar el tiempo que ella es, y matar el amor ---el único posible para el hombre--- que en ella se asienta y se construye. Pues no hay amor de los espíritus desasidos, no puede haberlo. Y si hubiera un reencuentro más allá de este tiempo, tendría que ser también el de los cuerpos, aun en su forma descompuesta, ceniza o polvo enamorado que, en su enamoramiento, retiene la totalidad de su ayer.

Pero morir es fácil, amar es lo difícil. O, como diría el poeta, desde la sabiduría de su vejez:

Contar la vida por los besos dados
no es alegre. Pero más triste es darlos sin memoria.

Y porque es difícil el amor, la tentación es grande, la tentación de muerte, la más grande de todas: quemar la carne y su memoria en pos de una nívea pureza, donde ya nada accede más que el propio ojo paranoico, ante un espejo exento en que nada transcurre.

El inquisidor de Aleixandre es, tal vez, la figura más inquietante y extrema de sus "Diálogos del conocimiento". Acaso la más inexplicable. ¿Pero lo es realmente?

No veo a este inquisidor, que pretende salvar todo lo puro, matando la impureza de la carne, sino como un caso límite del dandi, al que ayer dediqué un comentario.

Si el dandi descubre aún dentro de sí, y por debajo de su frialdad, el lejano calor de una rosa fugitiva, el inquisidor, congelado hasta sus entrañas, se arriesga por entero a una voraz simplicidad, terapia final para una soledad sin mácula en que descansar definitivamente.

Porque es, ciertamente, la impureza que todavía en el dandi persiste, esa complejidad que un sentimiento de afecto añade, allí donde no debiera haber ya afecto alguno, lo que el inquisidor se niega violentamente a soportar. Él es, pues, el corolario del dandi, su implacable consecuencia, la del que anhela sacrificar el último residuo de su incongruencia en el altar de una pureza glacial, hialina.

El inquisidor sería, entonces, el brote paranoico del dandi, su paroxismo, el que completa el puzle de su experiencia a base de suprimir toda esa ambigüedad que un resto de amor implica, a base de concentrarse en los puros hechos, que, desprovistos de todo contenido afectivo, resultan, ahora sí, susceptibles de cuadrar en perfecta y lógica coherencia ante el espejo de un presente absoluto, donde la carne se extingue sin dejar huella, y la memoria y la nostalgia y la desesperación enmudecen para siempre:

En el espejo gélidas
miro otras luces, brillo
de ese cristal sin curso,
y sé: su frío es vida.
Sólo un reflejo o mano
mortal, que vida otorga.
Y sé. Quien calla, escucha.
¡Pero todos se abrasen!

El amador y el dandi

2010-01-25T08:44:00.015+01:00

Tradicionalmente se ha entendido que el amor tiene su doble: el odio. Pero odio y amor son diferentes. Ninguno de ellos es meramente la ausencia de su supuesto contrario. Ni siquiera se podría decir que son contrarios, acaso sólo en sus efectos.

El amor requiere, para empezar ---y hablo sólo de lo que no son formas sucedáneas de amor--- del compromiso de los amantes. Sin amante, sin los amantes, no hay amor. El amor reside en los amantes y crea un mundo únicamente en torno de ellos, aunque pueda tener efectos sobre el resto, no necesariamente benefactores, piénsese, por ejemplo, en Romeo y Julieta, o en la razón por la que Hölderlin cantara:

[Dios] nunca perdona
que perturbéis la paz de los amantes.

El odio, a diferencia del amor, es de naturaleza vírica y ajeno a la actividad de sus operadores. El odio se instala, más bien, en la pasividad del que odia, allí donde todo resto de amor y compasión han desaparecido, para arrasarlo entero y reclamar toda su energía psíquica, que, desde ese momento, se concentra en el deseo de mal o muerte del ser odiado. Es probable que la mayor parte de las personas sea ajena, por fortuna, al verdadero sentimiento de odio, que no conoce misericordia ni perdón.

El amor difícilmente es puro y simple, pues, en tanto constructor de un mundo, debe vérselas con la complejidad inherente a todo acto creativo. El odio, por su parte, es de una pureza y de una simplicidad demoledoras. Nada ambiguo hay. Todo en él es deseo de destrucción, de aniquilación.

La aniquilación que el odio exige actúa también, y muy en especial, sobre quien la ejerce. El que odia se aniquila a sí mismo, al destruir en el otro el fundamento de su humanidad, premisa de todo odio en sentido propio.

Esta divagación por las inhóspitas simas del odio era necesaria para comprender mejor un sentimiento aparentemente análogo por su carácter destructivo ---tanto para su objeto como para su sujeto---, pero mucho más afín al amor, quizá precisamente su opuesto, el que tradicionalmente debería haber sido considerado como tal. Me refiero a la frialdad afectiva extrema, a la anestesia de los afectos.

Típico de este sentimiento es su carácter totalizador: todos caen en su red. En su formas extremas de manifestación, la frialdad se desentiende de los otros de manera bien distinta a lo que sucede en el odio. Más que aniquilados, los otros aparecen borrados, como bultos que no cuentan, molestos como máximo, pero indignos, por insignificantes, de la atención que tan fijamente sigue existiendo en todo odio.

Formas de anestesia afectiva en grados más o menos altos son frecuentes en personas que han amado y que, a la vez, han sufrido más de lo que han podido soportar.

La intensidad del dolor afectivo, como también sucede en el dolor físico, no es mensurable por medios objetivos. Tiendo, sin embargo, a pensar que lo soportable o insoportable de un dolor tiene que ver no tanto con su nivel de intensidad cuanto con su cualidad.

Si bien las manifestaciones de esta frialdad extrema pueden ser escandalosas, máscaras de buena disposición y buen comportamiento son mucho más frecuentes. Así, la entrega extenuante a un trabajo solitario, que requiere rigor y grandes dosis de paciencia sostenida en el tiempo, puede ser también un síntoma de frialdad en personas no proclives por naturaleza a tales empresas. Más expresivamente, la figura del dandi, protegido por su traje y sus suaves maneras, habla bien de esa distancia ante todo lo que en su día afectara tan dolorosamente, todo lo que ahora quedaría borrado de la consideración emotiva tras la displicencia de un refinado cinismo.

El último libro de Vicente Aleixandre, cima, a mi entender, junto con "Poemas de la Consumación", de su obra poética, contiene, en el poema que lleva por título "Diálogo de los enajenados", una escalofriante exploración de esta clase de dandismo al que me estoy refiriendo. Los dos personajes del diálogo son el amador y el dandi. No podía ser menos; pues, como propongo, se trata de dos formas presentes en la vivencia amorosa: cuando se vive como posible, y cuando ya, por insoportable, deja de serlo.

Creo que todos oscilamos o podemos oscilar a lo largo de la vida entre ambas variantes. Qué preponderancia tendrá cada una de ellas, dependerá seguramente del peso que en nuestra estructura anímica tenga cada momento de nuestra historia.

También creo que esta oscilación se puede producir ---y quizá sea el caso más frecuente--- no en períodos de tiempo relativamente largos que se suceden uno a otro, sino como momentos diferenciados dentro de un mismo período de tiempo, de un hora en otra, de un día en otro...

Oigamos un fragmento significativo del monólogo del dandi:

[...] Yo me paseo con mi bastón tristísimo
por la alameda última de mi ciudad sin paz.
Bultos, más bultos. Sueño. Mi sonrisa no mata,
pero sopla en los rostros y los borra. Pasad.

El fragmento y el poema al que pertenece merecería mucha mayor atención de la que yo he podido lograr en mis comentarios anteriores. Como todo fragmento poético contiene también bastante más de lo que un comentario pueda explorar. Sorprende, por ejemplo, el lirismo melancólico de los primeros dos versos. No parece encajar enteramente con la descripción del dandismo que he propuesto, donde la frialdad debería abarcarlo todo y donde, por ello, no resultaría apropiado ningún tipo de implicación afectiva.

Quizá, y esto añade verdad a la posibilidad vital del dandismo, el dandi, el frío, el despegado de todo amor, no esté completamente desprovisto de afectos y, en particular, del sentimiento amoroso. Quizá el dandismo de carne y hueso consista primordialmente en un rechazo de todo lo que se arriesga en el trato con los otros, de una desesperanza o recelo definitivo respecto de los amores concretos, de las relaciones que se establecen entre las personas, los bultos que no cuentan.

Pero el dandi aún mantiene su amor, de una forma depuradísima dentro de sí y sólo para sí, en el olor de una flor, por ejemplo, como se expresa en otro momento del poema, pero ya no en el beso, residuo de un engaño "burgués" ---se dice también allí---, donde falta la terrible lucidez que se obtiene al comprender la falacia de todo amor humano. En este sentido, el dandismo sería una posibilidad, aún más radical y a la vez devastadora, de vivencia del amor, cuando el amor entre los hombres ya no se soporta, una más que habría que añadir a las consideradas al final de mi comentario de hace unos días a una frase de Cernuda.

No quisiera terminar sin aludir de nuevo a Hölderlin. En la casa de Tübingen donde el poeta suabo vivió "loco" durante casi cuarenta años hay un grafiti que nadie ha borrado ---al menos todavía estaba allí la última vez que la visité--- y en el que se lee: "Hölderlin no estaba loco".

¿No podría ser que Hölderlin, el amador, tuviera que acudir, más o menos conscientemente, y bajo la máscara de un fingido Scardanelli, a una suerte de dandismo extremo, que le protegiera para siempre de todo su pasado y todo su futuro?

La humildad de la palabra poética

2010-01-21T14:36:00.006+01:00

Unos de los versos más famosos de Friedrich Hölderlin dice así:

Was bleibt, stiften die Dichter

Que se traduce habitualmente como:

Lo que perdura lo fundan los poetas

Tal vez sea cierto.

Pero si la palabra es siempre la palabra del amor y vive de su misma tensión, la tensión entre deseo infinito y cumplimiento imposible, entre ella misma y su silencio; si la palabra es, pues, palabra que renuncia a la posesión y a la permanencia, la palabra es despedida y sólo su despedirse perdura.

Porque el canto es también su propio fin, y, cuando el canto termina, cumple paradójicamente su destino. Pues sólo en su acabarse completa su verdad, la verdad de estar hecho, también él, de la misma materia que el cantor. Por eso, el canto verdadero suscita la melancolía, porque en cada una de sus irrepetibles entonaciones muere, para no regresar, como todo aquello que canta, como las mismas lágrimas que dejase en nosotros, los que cantamos, los que escuchamos.

Cernunda y el amor

2010-01-21T10:42:00.006+01:00

Luis Cernuda escribía lo siguiente en su 'Historial de un libro':

Son necesarios [...] algunos años [...] para aprender, en amor, a regir la parte de egoísmo que, no del todo conscientemente, arriesgamos en él.

Esta sentencia me pareció enigmática en mi adolescencia y en mi primera juventud. Con los años ---los años de los que habla Cernuda---, creo entenderla, a pesar de las discrepancias que en cuestiones de amor pudiera tener con el poeta sevillano.

La parte de egoísmo se deja gobernar precisamente porque, pese a lo que diría Freud, no es completamente inconsciente. Parece, pues, cuestión de proponérselo en alguna medida. ¿En qué medida?

Lo agudo de la reflexión cernudiana radica en que presupone sin más algo que seguramente poca gente estaría dispuesta a aceptar, a saber, que en todo amor hay implicada, querámoslo o no, sepámoslo o no, una parte de egoísmo.

Egoísmo aquí es otro nombre para referirse a una íntima e inexcusable necesidad. Esta necesidad es el signo o síntoma de una precariedad sustantiva. Y esta precariedad, a su vez, es la otra cara del afán de plenitud en que consiste el hombre. Así pues, nuevamente, Deseo frente a Realidad.

Sin sabiduría ---en el sentido griego del término---, este deseo de plenitud se lanza ciegamente sobre el cuerpo amado, en la absurda esperanza de que este cuerpo lo colmará para siempre. Lo absurdo de esta esperanza radica en que ella, por característica esencial de la existencia "mortal" ---como dirían, de nuevo, los griegos--- no tiene cumplimiento, no puede tenerlo, pues todo cuerpo está transido de tiempo, de finitud, de contingencia.

Este amor, que no es sabio ni quiere serlo, deviene entonces, en su continuo desacierto, amor posesivo en todas sus múltiples manifestaciones, de las cuales los celos es la más conspicua, aunque no la única ---inolvidable en este sentido la película Él de Luis Buñuel.

Cuando el egoísmo se ignora ---se quiere ignorar--- lo que se arriesga, ante todo, es la humanidad del hombre, en particular, su propio deseo de plenitud, que, al verse inevitablemente defraudado, se pierde en los escombros del fracaso amoroso.

Regir el egoísmo presente en todo amor no sería, pues, sino comprender desde las entrañas esta esencia del hombre ---no valdría, por supuesto, que la comprensión fuese meramente racional.

¿Pero es posible no renunciar al amor y aceptar su limitación intrínseca? No puedo imaginar más que dos formas humanamente practicables de hacerlo, ambas obviamente dolorosas, pues que se asientan precisamente en esa tensión entre Realidad y Deseo.

La primera es la "solución" de Cernuda, y de otros, ---pienso, por ejemplo, en el "amor intransitivo" de Rilke---, solución de clara raigambre platónica: convertir al ser amado, al cuerpo amado, en "pretexto" consciente del amante, acicate de su deseo, que se proyectaría, a través y por medio del amado, en aquello inaccesible a que apunta. El deseo mismo es aquí, en cierto modo, el objeto del amor. Amor, pues, que es básicamente narcisista, y al que cabe dedicar un vida. Cernuda, como es sabido, dedicó "La Realidad y el Deseo" precisamente a su solo deseo.

Los peligros de convertir al otro en mero medio, de instrumentalizarlo, resultan evidentes en este tipo de soluciones.

La otra alternativa es, si cabe, más dolorosa para los amantes, que ahora, sin embargo, estarían en igualdad de condiciones. Consistiría en compartir la nostalgia que emana de la experiencia de un amor que se sabe finito, inexorablemente fugaz e incompleto, especialmente allí donde el amor es mayor y más profundamente parece y quiere consumarse. Vivir el amor, pues, como una despedida, que, en el más maravilloso de los casos, dura toda una vida, ese breve tránsito que es el hombre.

La poesía no sólo puede decir mucho en este asunto, sino que además está embargada por él enteramente. ¿Acaso no es la tensión extrema entre la palabra y lo indecible a que apunta la misma tensión que vibra en todo amor?

Los abundantes rizos de HAL

2009-10-02T11:59:00.009+02:00

De las cuatro partes en que se dividía nuestro problema inicial queda la última, la de concatenar los pdfs generados por cada página del libro en un único pdf allí donde la obra escaneada consta de varias páginas. Tampoco esta tarea reviste dificultad especial. La herramienta adecuada a esta fin es, como comentamos entonces, pdftk.

Un rápido vistazo por la página de manual de pdftk nos da la solución. Pongamos, por ejemplo, que queremos obtener un único pdf, con el nombre Dowland_The-Frog-Galliard.pdf a partir de estos tres:


Dowland_The-Frog-Galliard_1.pdf
Dowland_The-Frog-Galliard_2.pdf
Dowland_The-Frog-Galliard_3.pdf

La operación se realiza con la siguiente instrucción, que asume que en nuestro directorio de hojas escaneadas no hay otra cosa que pdfs ---se recordará que el guión escanear-a-pdf, diseñado en el artículo anterior, suprimía debidamente los ficheros del mismo nombre que no fueran pdfs:


pdftk Dowland_The-Frog-Galliard_* cat output Dowland_The-Frog-Galliard.pdf

Con esta expresión pedimos a pdftk que tome como entrada todos los ficheros que empiezan por Dowland_The-Frog-Galliard_ (por tanto, todas las páginas correspondientes a esta obra de Dowland), los concatene (cat) y produzca como resultado (output) el fichero Dowland_The-Frog-Galliard.pdf. (Es importante destacar que pdftk acepta varios pdfs como entrada y que podemos referirnos a un conjunto de ellos mediante el comodín '*'. Este tipo de abreviatura, que hemos visto de pasada en alguna otra ocasión, resulta de enorme utilidad cuando el objetivo es ejecutar operaciones para un conjunto de ficheros cuyos elementos no pueden especificarse completamente a priori. De hecho, la solución que veremos a continuación aprovecha plenamente esta característica de la lengua de HAL.)

El artículo y la conversación podrían terminar aquí, si no fuera porque el lector ya no es un usuario principiante de la consola y porque no debería conformarse sino con una solución general y automática para todos los casos posibles.

Una solución automática no podemos obtenerla para la primera tarea, más allá, de donde lo hemos logrado. Es decir, no es practicable producir un pdf para toda hoja del libro o, lo que es lo mismo, dejar el libro en el escáner y regresar a las tres horas para apagar el aparato con la certeza de que éste habrá digitalizado todas sus páginas. Aquí, naturalmente, hay un límite físico, pues no disponemos del hardware que sea capaz de tal hazaña. Aunque existen robots que escanean libros ---que pasan las hojas por sí solos antes de escanearlas--- su precio está muy por encima de nuestro presupuesto, y plantearse construir uno supera nuestra destreza ingenieril. No queda más remedio que realizar a mano la tarea de selección de la hoja, de su ubicación en el escáner y de su procesamiento mediante nuestro guión escanear-a-pdf. Pero el límite físico desaparece en el mismo momento en que HAL está en posesión de todos los ficheros digitales necesarios. Ahí ya no tenemos disculpa.

Imaginemos, por ejemplo, que tras una sesión de escaneo, hemos obtenido los siguientes ficheros correspondientes a las páginas de dos obras de Dowland:


Dowland_The-Frog-Galliard_1.pdf
Dowland_The-Frog-Galliard_2.pdf
Dowland_The-Frog-Galliard_3.pdf
Dowland_A-Fancy_1.pdf
Dowland_A-Fancy_2.pdf
Dowland_A-Fancy_3.pdf
Dowland_A-Fancy_4.pdf

Lo que, naturalmente, desearíamos es que HAL ejecutase, sin nuestra intervención, estas dos instrucciones:


pdftk Dowland_The-Frog-Galliard_* cat output Dowland_The-Frog-Galliard.pdf
pdftk Dowland_A-Fancy_* cat output Dowland_Fantasia.pdf

La cosa no parece difícil. Tenemos en general un enunciado con esta forma:


pdftk obra_* cat output obra.pdf

donde el texto en cursiva corresponde a una variable ---un pronombre, si se quiere aplicar la metáfora lingüística--- que estará en cada caso por el nombre de la obra correspondiente.

Podemos pergeñar, sin rebanarnos los sesos, un procedimiento para manejar esta clase de situación, lo hemos hecho en otros momentos. Podríamos seguir, por ejemplo, la siguiente estrategia:

Diseñar una instrucción que lea todos los ficheros del directorio que contiene las hojas escaneadas y extraiga el nombre de cada obra distinta.

Crear una variable, digamos, la variable OBRAS, y asignarle como valor los nombres de obras producidos en la instrucción anterior.

Recorrer cada nombre almacenado en la variable OBRAS y ejecutar para cada uno de ellos la instrucción pdftk propuesta antes.

Si aplicamos las herramientas de manipulación de ficheros y flujos de texto conocidas de anteriores conversaciones, podemos llegar a diseñar una instrucción de extracción como la que se indica en el primer paso de nuestro proceso. Podríamos, por ejemplo, construir por medio de tuberías, una instrucción, cada una de cuyas secciones realizase estas operaciones:

Listar todos los ficheros del directorio que contiene las hojas escaneadas en pdf.

Seleccionar de la lista las hojas que constituyen páginas de una misma obra, o sea, aquellas que terminen con un número (el número de página). Nótese que puede haber nombres de fichero sin número al final, que corresponderían a las obras formadas por una sola hoja o página.

Extraer de esos nombres de fichero la parte relativa al nombre de la obra, esto es, el nombre del fichero sin el número de página.

Eliminar las repeticiones en la lista obtenida en los pasos anteriores.

Una instrucción como la siguiente refleja esta serie de manipulaciones:


ls | grep -E '.*_[[:digit:]]+.pdf' | cut -d'_' -f1,2 | sort -u

Va de suyo que la instrucción funciona ---en concreto, el grep y el cut---, porque asumimos un determinado formato para el nombre de nuestros ficheros, a saber:


autor_nombre-de-obra_página.pdf

Gracias a él, el patrón de expresión regular para grep puede contar con que el número de página, de haberlo, está justo antes de la especificación de extensión y después del resto del nombre del fichero. Asimismo cut puede utilizar el carácter '_' como delimitador de campos y devolver los campos primero y segundo del nombre del fichero proporcionado como entrada ---o sea, los que contienen el nombre del autor y de la obra, sin número de página (campo tercero)---, y que identifican exhaustivamente el nombre de la obra del caso.

En general, y cuando se trata de manipular nombres de ficheros, conviene siempre establecer un formato uniforme fácilmente manipulable por las herramientas habituales con las que contamos. Esto nos librará de un montón de quebraderos de cabeza.

Asignar el resultado de esta instrucción a la variable OBRAS es trivial. De hecho, sabemos ya que tanto la instrucción anterior como la asignación se pueden realizar en un único paso, por medio de la sustitución de órdenes:


OBRAS=$(ls | grep -E '.*_[[:digit:]]+.pdf' | cut -d'_' -f1,2 | sort -u)

Lo que resta es recorrer el contenido de la variable OBRAS. Tras la operación anterior dicha variable será una lista de los nombres de obras que constan de varias páginas. Nada mejor, pues, que nuestro conocido for para aplicar sobre cada miembro de esa lista la operación de concatenación de pdfs sugerida al principio:


for obra in $OBRAS
do
  pdftk ${obra}_* cat output ${obra}.pdf
done

Es fácil tratar de sacar más partido del for y, por ejemplo, eliminar las páginas independientes, una vez producida la partitura completa, o, incluso, guardar en un fichero de registro referencia de las obras procesadas y del número de páginas de las que consta cada una de ellas. El guión completo, con estos añadidos y comentarios al código, sería el siguiente:


# Lista de las obras que contienen varias páginas. El formato de
# fichero de cada página es autor_titulo-de-la-obra_<n>, donde <n>
# es el número de página
OBRAS=$(ls | grep -E '.*_[[:digit:]].pdf' | cut -d'_' -f1,2 | sort -u)

for obra in $OBRAS
do
  # número de páginas de la obra procesada
  npags=$(ls ${obra}_* | wc -l)
  # concatena las páginas de la obra
  pdftk ${obra}_* cat output ${obra}.pdf
  # elimina las páginas sueltas
  rm ${score}_*
  # añade una línea de registro
  echo "$obra: $npags páginas" >> pdftk_log
done

Como se ve, tareas cuya automatización podría resultar intratable con herramientas gráficas superpotentes, se resuelven en pocos pasos a través de la humilde consola.

HAL también escanea (II)

2009-10-01T10:59:00.004+02:00

Provistos de las herramientas adecuadas y consultadas someramente sus respectivas páginas de manual, construir el esquema de nuestro guión para escanear cada página y obtener un pdf ajustado a nuestros intereses es trivial [En cursiva se presentan el nombre del fichero que corresponde a la página escaneada; con rojo y verde indicamos, respectivamente, los ficheros de entrada y de salida implicados en cada parte del proceso]:


scanimage > fichero
unpaper fichero fichero.pbm
convert fichero.pbm fichero.pdf

Se observará que en la primera instrucción hemos omitido la extensión del tipo de fichero (pbm) por mera cuestión de conveniencia. Como sabemos que el fichero es un pbm y, puesto que unpaper producirá también un pbm, evitamos algo más prolijo como:


scanimage > fichero-version-inicial.pbm
unpaper fichero-version-inicial.pmb fichero-version-retocada.pbm
...

Este esquema se puede enriquecer con opciones adecuadas para cada una de las instrucciones que lo componen:


scanimage --resolution 600dpi --mode Lineart --progress > fichero
unpaper --size a4 fichero fichero.pbm
convert -compress Group4 fichero.pbm fichero.pdf

Las opciones de scanimage tienen el siguiente significado:

--resolution 600dpi: Define la resolución que tendrá la imagen resultante. En nuestro caso 600 puntos por pulgada, una resolución bastante alta. Resoluciones inferiores como 300dpi suelen ser suficientes y tienen la ventaja de acelerar la duración del proceso físico del escaneo.
--mode Lineart: Determina la sensibilidad del escáner a las diferencias de matiz o color. En este caso interesa considerar sólo las diferencias entre blancos y negros (modo Lineart), la opción común en páginas de libros convencionales.
--progress: Presenta en la consola o terminal una barra visual del progreso del proceso físico del escaneo.

Por su parte, la opción de unpaper es comprensible de suyo:

--size a4: Retoca el fichero dado como primer argumento para que se adapte a las dimensiones de un tamaño a4. unpaper es un programa sofisticado con un buen número de opciones, aquí nos limitamos a un uso muy básico.

Finalmente, en cuanto a convert tenemos la siguiente opción:

-compress Group4: Determina el algoritmo de compresión que se aplicará en la conversión. Con este algoritmo conseguimos, por ejemplo, que el pdf de una página de nuestro libro ronde los 100k sin apenas pérdida de calidad. Dicho sea de paso, Imagemagick, que es la herramienta general a la que pertenece convert, es una utilidad tremendamente especializada y eficaz en el tratamiento de imágenes. [Más información en http://www.imagemagick.org].

Definida la sucesión de instrucciones que constituye el proceso completo de transformación de la página del libro en un fichero pdf, queda construir un guión que pueda aplicarse a cualquier página en general. No es algo distinto de lo que ya hemos hecho en otras ocasiones (ver, en particular, este artículo).

Por tanto, se trata de añadir lo que sea necesario para poder pedirle a HAL algo como esto:


./escanear-a-pdf Dowland_The-Frog-Galliard_1

donde Dowland_The-Forg-Galliard-1 es el nombre del fichero (sin la extensión .pdf) que alojará el pdf de la hoja del libro correspondiente a la primera página de la pieza de Dowland titulada The Frog Galliard, y donde, por descontado, escanear-a-pdf es el nombre de la instrucción o guión que vamos a diseñar.

El artículo citado antes nos da la pista necesaria para que sea cosa de niños la generalización que deseamos. Basta, como se ve, con sustituir la variable escrita anteriormente con el nombre fichero por un parámetro posicional:


scanimage --resolution 600dpi --mode Lineart --progress > "$1"
unpaper --size a4 "$1" "$1".pbm
convert -compress Group4 "$1".pbm "$1".pdf

(Las comillas que rodean al parámetro posicional ---se recordará--- sirven para evitar problemas cuando el nombre de fichero elegido contiene espacios.)

Podemos, ya que estamos, incluir al final una instrucción de limpieza que elimine los ficheros intermedios:


scanimage --resolution 600dpi --mode Lineart --progress > "$1"
unpaper --size a4 "$1" "$1".pbm
convert -compress Group4 "$1".pbm "$1".pdf
rm "$1" "$1".pbm

Con todo ello estamos en condiciones de producir los pdfs deseados de cuantas páginas del libro vayamos a escanear, por ejemplo:


./escanear-a-pdf Dowland_The-Frog-Galliard-1
./escanear-a-pdf Dowland_The-Frog-Galliard-2
./escanear-a-pdf Dowland_The-Rrog-Galliard-3
./escanear-a-pdf Dowland_Fantasía-1
...

Como decíamos, cosa de niños.

HAL también escanea

2009-09-30T16:17:00.009+02:00

No hace mucho ;-) dejamos a nuestro HAL entregado a sus tareas rutinarias ---el sueño también forma parte de ellas---, mientras nosotros nos tomábamos unas largas vacaciones. Y es que la inmersión realizada el año pasado fue tan acelerada que había que salir a flote como fuera. Mejor retomar el hilo con algo más de moderación y de iniciar nuevas conversaciones sólo cuando la ocasión lo pida o lo permita, es decir, sin horario ni planificación prefijada.

Una ocasión de este tipo le ha surgido al autor hace poco, y lo que de ella se sigue será útil para completar lo que ya vimos sobre repeticiones y bucles, aparte de para seguir demostrando con un caso real la multiplicidad de posibles aplicaciones de la lengua de HAL a nuestras tareas habituales.

Se recordará que la instrucción for nos sirvió entonces para ordenar a HAL que recorriese las líneas de un fichero y aplicase un mismo bloque de instrucciones a cada una de ellas. En la siguiente conversación veremos un uso semejante, probablemente más frecuente, de for, en el que las unidades textuales recorridas no son líneas de ficheros, sino nombres de fichero.

Aunque ésta es probablemente la forma más frecuente de realizar tareas repetitivas en la lengua de HAL, es decir, la de recorrer unidades textuales (sean, por ejemplo, las líneas de un fichero o los nombres de una serie de nombres de fichero), hay situaciones en que es más práctico, más fácil o, simplemente, más del gusto del usuario, repetir una serie de instrucciones un número determinado de veces. Y esto es justo lo que vamos a tratar de conseguir en la conversación que hoy iniciamos.

Dedicaremos este primer artículo a especificar la tarea que motivó la conversación y la forma en que puede diseñarse un procedimiento para ejecutarla. De paso, aprenderemos a escanear un documento sin salir de la consola, cosa que quizá muchos, acostumbrados a las aplicaciones gráficas, consideren poco menos que magia negra. Aunque ---todo hay que decirlo--- esta clase de sortilegios, lanzados desde la negra interfaz de la consola, es algo a lo que deberíamos ya estar acostumbrados a estas alturas de nuestras charlas.

La tarea que nos proponemos realizar es la siguiente. Contamos con un libro voluminoso que contiene la obra completa de obras para laúd solo del gran compositor renacentista John Dowland y necesitamos extraer de él unas cuantas piezas que quepan fácil y livianamente en nuestro atril. Nos interesa, en particular, generar un fichero pdf para cada una de esas piezas.

Resulta evidente que aquí nos enfrentamos a dos problemas diferentes, en primer lugar, el de escanear las correspondientes páginas del libro y, en segundo lugar, el de generar tantos pdfs como obras queremos extraer. Nótese, en especial, que puede haber obras que consten de una sola página y obras que consten de varias páginas, y que lo que pretendemos es producir un pdf por obra y no por página.

Además, y puesto que sabemos ---el autor lo sabe, el lector debe asumirlo como presupuesto--- que HAL es capaz generar eficazmente un pdf por obra si cuenta con un pdf por página, el primero de los problemas se bifurca, a su vez, en otros dos, el del escaneo propiamente dicho y el de la conversión en pdf del resultado de dicho escaneo.

Hay que añadir, además, que, a causa tanto del tamaño del libro como de sus características físicas, será necesario retocar la imagen inicialmente escaneada para que el pdf que resulte de su conversión se adecue mejor a su posterior impresión en papel A4.

Por tanto, nuestro problema completo constará, al menos, de las siguientes partes:

Escanear las páginas del libro.

Retocar el resultado como convenga.

Convertir los ficheros resultantes en pdfs.

Unir en un único pdf los ficheros de cada página, cuando la obra conste de varias.

Podemos ser todavía más precisos si tenemos en cuenta las especificidades del proceso de escaneo. En concreto, será necesario producir una imagen donde se tengan en cuenta sólo las diferencias entre blanco y negro (lo que se llama modo Lineart) y no los tonos de grises o las divergencias de colores, que en nuestro libro no existen. Esto producirá un formato de imagen pbm. Este tipo de fichero es que el que tendremos que retocar y convertir a pdf, antes de pasar a la concatenación de los diversos pdfs. Podríamos, pues, plantear un esquema de las operaciones implicadas y los datos que se procesan dentro de ellas [Por cada página se presenta la serie de procesos por la que atravesará y los formatos de ficheros resultantes]:


    /-------\ pbm /-------\ pbm /----------\ pdf   
P1->|escaneo|---->|retoque|---->|conversión|-----\
    \-------/     \-------/     \----------/     |
                                                 |
    /-------\ pbm /-------\ pbm /----------\ pdf |    /-------------\
P2->|escaneo|---->|retoque|---->|conversión|-----|--->|concatenación|->pdf
    \-------/     \-------/     \----------/     |    \-------------/
                                                 |
    /-------\ pbm /-------\ pbm /----------\ pdf | 
Pn->|escaneo|---->|retoque|---->|conversión|-----/
    \-------/     \-------/     \----------/

Una inmersión en las interioridades del sistema de paquetes de HAL y de las páginas del manual ---cosas, ambas, que ya tratamos en la primera parte de esta serie--- nos permite descubrir de qué posibles herramientas disponemos. En concreto [señaladas bajo cada caja]:


    /-------\ pbm /-------\ pbm /----------\ pdf /-------------\
Pn->|escaneo|---->|retoque|---->|conversión|---->|concatenación|->pdf
    \-------/     \-------/     \----------/     \-------------/
    scanimage      unpaper        convert            pdftk

Cada una de estas herramientas ---o, si se quiere, de estos ayudantes de HAL--- forma parte de un paquete. A saber, en sistemas basados en Debian:

scanimage: paquete sane-utils
unpaper: paquete unpaper
convert: paquete imagemagick
pdftk: paquete pdftk

En los próximos días nos las apañaremos para construir un par de guiones que generen pdfs a partir de las páginas escaneadas y que procedan, en su caso, a su posterior concatenación. Será con la venia de estos bien predispuestos ayudantes.

HAL está esperando :-)

Stroustrup y la enseñanza de la programación ...

2009-09-02T00:42:00.005+02:00

... o la ciencia de la vida.

Sí, tal rimbombante extensión del título de esta entrada ha pasado por mi cabeza, aunque la he omitido no tanto por pretenciosa, que lo es, cuanto por evitar una cabecera demasiado larga para Blogger.

¿A qué viene este embrollo? La cosa es que durante algunos días de este verano y, aprovechando, cómo no, el tan preciado descanso, me ha dado por hincar ligeramente el diente al nuevo libro del maestro Bjarne Stroustrup. Para quien no sepa quién es Stroustrup, baste decir que no sólo es el creador del lenguaje de programación C++, sino seguramente una de las personalidades más valoradas del mundillo de la informática.

Pues bien, resulta que Stroustrup ha sacado tiempo, entre sus muchas dedicaciones y responsabilidades de experto, para escribir nada menos que una introducción a la programación, un buen tocho de más de 1000 páginas titulado Programming -- Principles and Practices using C++. No he leído más que la primera parte, algo más de unas 300 páginas espléndidas en más de un sentido.

No es mi propósito hacer una reseña del libro ---por lo demás, imposible, dado que sólo he leído un fragmento---, ni siquiera una reseña de esta primera parte, que ya de por sí la merecería. Lo que, más bien, me interesa es reflexionar sobre mi experiencia al topar con sus capítulos sexto y séptimo (especialmente, el sexto).

Téngase en cuenta que mi punto de vista no es sólo el del entusiasta en estos asuntos técnicos, ni siquiera el del propenso a encontrar placer en la didáctica de la programación, sino más bien el de quien enseña algo, si bien de una índole en apariencia muy diferente. Porque, al cabo, el problema del aprendizaje va mucho más allá del objeto de la enseñanza, o sea, de la materia que se imparte, y se concentra, en particular ---si se me permite el juego de palabras, en su objetivo; y éste, cuando se entiende en su mayor generalidad, es común probablemente, a todas las formas de aprendizaje.

Pues bien, los capítulos en cuestión enseñan cosas como:

Diseño de una gramática abstracta para interpretar el input que procesará un programa de cálculo aritmético (una calculadora).

Implementación de esa misma gramática a través de funciones recursivas, mutuamente relacionadas.

Creación de tipos en C++ y manipulación del input a través de un tipo stream creado por el usuario.

etc.

Sorprende, ciertamente, que un libro de introducción ponga sobre la mesa del aprendiz una tarea de esta complejidad a unas pocas páginas de distancia de su presupuesta total ignorancia sobre la programación. Es evidente, sin duda, que Stroustrup trata a sus alumnos como adultos capaces de asumir retos difíciles desde el primer momento.

Pero lo verdaderamente sorprendente es la forma como Stroustrup plantea el ataque a este problema de programación, el diseño e implementación de una calculadora. Muchos se quedarán en la superficie y verán tan sólo un caso más ---no muy frecuente, por cierto, en textos introductorios--- de la práctica de un diseño e implementación incrementales. Pero la cosa, a mi modo de ver va más allá.

Hay algo en esas páginas que trasciende la cuestión relativa a conceptos y técnicas de programación. Dicho en pocas palabras, lo que Stroustrup una y otra vez trata de hacernos comprender es que el verdadero meollo de la programación no es otra cosa que el de pensar a fondo sobre un problema, el de acercarse, mientras hacemos el camino, a la naturaleza misma del problema inicial, cuyo sentido y complejidad se va haciendo cada vez más presente ---aunque, quizá, me atrevería a decir, nunca completa y enteramente presente---, gracias a nuestros ingenuos errores iniciales, a nuestros pasos en falso y a toda esa serie de tentativas aparentemente infructuosas y, sin embargo, imprescindibles, de las que consta todo proceso de investigación lanzado hacia lo nuevo, hacia lo desconocido.

La excelencia del maestro se mide no por la cantidad o, incluso, calidad de las cosas que enseña ---que también---, sino sobre todo porque nos hace comprender que el aprendizaje no termina nunca y que, nosotros, por muy arriba que estemos en nuestra destreza y conocimientos, somos esencialmente aprendices a la hora de enfrentarnos a nuevos retos ---los únicos que al cabo interesan---, esencialmente falibles, incorrectos, tentativos.

No es diferente lo que los grandes maestros han venido enseñando desde los albores de nuestra civilización. Piénsese, por ejemplo, en el método platónico-socrático del elenchos y la dialéctica; piénsese en el proceso de aprendizaje de cualquier artesanía compleja.

... Y piénsese ---por qué no--- en las propias cuestiones de la vida, las que nos azoran de continuo, desconcertantes, irresueltas y, a un tiempo y por ello mismo, fascinantes.

Mucho se gana ---diría, incluso, que todo se gana--- cuando se comprende que el experto no es nunca el infalible, sino el que asume con plena conciencia hasta qué punto el camino no es, ni debe ser, rectilíneo, sino más bien sinuoso, espiral incluso; y que, lejos de que ello suspenda el entusiasmo y el juicio, nos ata a la aventura del descubrimiento con la misma poderosa fuerza que el aprendiz siente en sus primeras andaduras.

Gracias, maestro Stroustrup, por recordarlo, incluso allí donde el lego quizá esperase, basado en peligrosos lugares comunes, justamente lo contrario.

Ocultamientos y desvelamientos

2009-07-01T01:47:00.002+02:00

Hoy he tenido que realizar una estúpida tarea que me ha llevado más tiempo del debido. La causa: la peligrosa simplificación de la realidad en aras de la facilidad y en perjuicio de la difícil sencillez de la verdad.

El motivo ha sido el siguiente. Una amiga me ha pedido que le eche una mano con su iPod. El problema es que era incapaz de transferir las pistas desde su ordenador (con Linux) al iPod. Un problema no infrecuente a lo que parece, basta echar a vistazo a google.

He probado con el, por otra parte, estupendo Amarok. Amarok se limitaba a informar de que la transferencia no podía realizarse porque el sistema de ficheros del iPod estaba montado en modo de solo lectura. Nada se podía escribir en él. Lo primero, y casi lo único, que se tiende a pensar en una caso como éste es que hay algún problema con los permisos. Pero no había ningún problema ahí.

Por suerte, se me ocurrió, después de otras investigaciones infructuosas, echar un vistazo a los mensajes del kernel tal como se generaban al montar el dispositivo:

dmesg | tail -f

La verdad era diáfana y simple:

hfs: Filesystem was not cleanly unmounted, running fsck.hfsplus is recommended. mounting read-only.

Mi amiga, a buen seguro, había desenchufado el iPod a lo bruto, cosa a la que seguramente ni siquiera había prestado atención. Y, claro, el sistema de ficheros estaba tan sucio que el bueno del kernel se negaba a dar permiso de escritura.

Nótese hasta qué punto el mensaje del kernel es significativo. No sólo presenta sin ambigüedad posible la razón de su comportamiento, sino que propone una solución: chequear el sistema de ficheros con la herramienta adecuada.

No necesité otra cosa que instalar esa herramienta:

aptitude install hfsprogs

y ejecutar fsck.hfsplus sobre cada una de las particiones del dispositivo en cuestión (/dev/sde). La tercera partición /dev/sde3 era la corrupta. En pocos segundos, se resolvió el problema que nos había tenido entretenidos más de la cuenta y pudimos realizar la transferencia de ficheros.

Moraleja: No hay que fiarse totalmente de las aplicaciones gráficas. En su afán de evitar mensajes crípticos, pueden ocultar datos decisivos de la realidad.

Moraleja2: Si es necesario el proceso descrito para resolver un problema tan simple y, probablemente, frecuente, ¿no es posible pensar que Linux (o, quizá, todo sistema complejo) no es todavía lo suficientemente amigable como para que lo pueda usar mi tía María?

HAL y la burocracia (XII - limpieza)

2009-06-06T11:11:00.003+02:00

Los buenos profesionales de la construcción, la fontanería o de cualquier otra actividad que interviene en la infraestructura de nuestra casa no dan por finalizado su trabajo hasta haber borrado completamente la huellas de su actividad reformadora. Hoy en día, urgidos por el afán de amasar dinero fácil o, simplemente, carentes de toda ética profesional, son habituales los chapuceros que nos acaban dejando la casa hecha un zaguán.

No vayamos a emular esta desagradable actitud y procuremos que tras la ejecución de nuestro guión todo quede limpio y bien dispuesto.

Por lo general, un guión genera dos tipos de basura: basura permanente, compuesta por ficheros temporales, ya sea creados por nosotros mismos o por las órdenes que lo componen, y basura en pantalla, esto es, mensajes de información que se producen al ejecutar dichas órdenes. Los primeros se eliminan fácilmente con la orden rm; los segundos, redirigiéndolos al agujero negro de HAL.

Estas operaciones de limpieza deben efectuarse solamente una vez que se ha comprobado fehacientemente la corrección de nuestro guión. De hecho, los ficheros temporales y los mensajes producidos en su ejecución son información valiosa para descubrir la fuente de errores potenciales. Y ---conviene recordarlo--- no es probable que un guión esté libre de fallos en su primeras redacciones.

El paso de eliminar los ficheros temporales es, a estas alturas, pan comido. Los ficheros temporales creados por nuestro guión son:

Los ficheros objetivos_tmp.tex, contenidos_tmp.tex y trabajo_tmp.tex

Los ficheros producidos por pdflatex, cuyo nombre es el mismo que el del fichero pdf resultante: $ALUMNO.pdf, pero con extensiones diferentes: $ALUMNO.tex, $ALUMNO.aux, etc.

La orden para eliminar los ficheros citados en primer lugar puede ser ésta, que borra todos los ficheros cuyo nombre termina en _tmp.tex:

rm *_tmp.tex

Para eliminar los ficheros citados en segundo lugar, podemos utilizar una orden como la siguiente:

rm $(ls ${ALUMNO}* | grep -v '\.pdf')

Esta orden envía la lista de todos los ficheros cuyo nombre comienza por $ALUMNO a grep, que devuelve todos menos el que termina con la extensión pdf ---para eso sirve la opción -v de grep---, y lo filtrado por grep se lo da como argumento a rm.

Para que los mensajes de información emitidos por las órdenes que se ejecutan dentro del guión no aparezcan en pantalla, el recurso habitual es redirigirlos a un fichero especial, llamado /dev/null, un agujero negro dentro de HAL que succiona todo lo que llega a él y lo hace desaparecer en la nada. De las órdenes incorporadas en nuestro guión, pdflatex va a producir siempre mensajes informativos, como habrá comprobado el lector que haya puesto a prueba las versiones del guión dadas hasta ahora. Si no queremos molestar al usuario con estos mensajes, podemos añadir la redirección a /dev/null a dicha orden:

pdflatex ${ALUMNO}.tex > /dev/null

La nueva versión del guión, generar_informes-5, con estas tres medidas higiénicas incluidas, queda así:


# Directorio que contiene la programación del curso
PROGRAMACION="$HOME/guiones/informe_suspensos"

# Fichero que contiene la plantilla LaTeX del informe
PLANTILLA=informe_plantilla.tex

# Fichero que contiene las notas de los alumnos
NOTAS=notas

# Sufijo de los ficheros de objetivos por cursos
OBJETIVOS=objetivos.tex

# Sufijo de los ficheros de contenidos por cursos
CONTENIDOS=minimos.tex

# La nota mínima para aprobar el curso
NOTA_MINIMA=5

# Fichero sed para limpiar etiquetas LaTeX
NOLATEX=limpiar_tex.sed

for linea in $(cat $NOTAS)
do
  if [ $(echo $linea | cut -d':' -f3) -lt $NOTA_MINIMA ]
  then
    # Nombre y curso del alumno tal como constan en el fichero $NOTAS
    ALUMNO=$(echo $linea | cut -d':' -f1)
    CURSO=$(echo $linea | cut -d':' -f2)

    # El nombre del alumno y curso con el formato que tendrán en la salida impresa
    ALUMNO_OUTPUT=$(echo $ALUMNO | sed -e 's/-/ /g')
    CURSO_OUTPUT=$(echo $CURSO | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                              -e 's/ge/EE/' \
                                              -e 's/gm/EP/')

    # Ficheros que contienen los objetivos y contenidos del curso
    # en que el alumno está matriculado
    F_OBJETIVOS=${PROGRAMACION}/${CURSO}-$OBJETIVOS
    F_CONTENIDOS=${PROGRAMACION}/${CURSO}-$CONTENIDOS

    # Los objetivos y contenidos en un formato apto para la plantilla
    # a partir de la que se genera el informe
    sed -f $NOLATEX $F_OBJETIVOS > objetivos_tmp.tex
    sed -f $NOLATEX $F_CONTENIDOS > contenidos_tmp.tex

    # Las propuestas de trabajo se deben introducir interactivamente
    echo "Introduzca propuestas de trabajo para $ALUMNO_OUTPUT [\item ... (^D para salir)]: "
    cat > trabajo_tmp.tex

    sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
        -e "s/CURSO/$CURSO_OUTPUT/" \
        -e  's/OBJETIVOS/\\input{objetivos_tmp}/' \
        -e 's/CONTENIDOS/\\input{contenidos_tmp}/' \
        -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > ${ALUMNO}.tex

    pdflatex ${ALUMNO}.tex  > /dev/null

    # Eliminación del los ficheros temporales creados
    rm *_tmp.tex
    rm $(ls ${ALUMNO}* | grep -v '\.pdf')
  fi
done

Las tres únicas diferencias dignas de mención respecto de la versión propuesta al principio de esta serie son:

El valor de la variable PROGRAMACION, un valor que lógicamente dependerá del lugar donde el usuario tenga almacenados los ficheros de objetivos y mínimos.

La instrucción lp ${ALUMNO}.pdf > /dev/null, que envía el informe del alumno directamente a la impresora, en caso de que el usuario disponga de un sistema de impresión basado en CUPS, lo normal estos días en las distribuciones GNU/Linux.

El enigmático #!/bin/sh, que nos acompaña desde el pasado de estas conversaciones, que no es estrictamente necesario en la mayoría de los casos, y cuyo sentido tocará explicar en su momento.

Si el lector ha sido capaz de alcanzar esta cota sin desfallecer, puede considerarse un usuario avanzado y, si le apetece verlo de esta otra forma, un programador en ciernes. Enhorabuena, Sancho, te subiremos la nota.

Resumen:

Cuando la corrección de un guión se ha comprobado suficientemente, es recomendable limpiar el directorio desde el que se ejecuta de todos los ficheros temporales generados y suprimir de la interfaz del usuario los mensajes informativos que las órdenes aplicadas pueden generar.

La opción -v de grep invierte el sentido de la búsqueda, esto es, devuelve las líneas de la entrada que no encajan con el patrón suministrado como primer argumento.

El fichero especial /dev/null existe para redirigir a él cualquier salida de nuestras órdenes que queremos hacer desaparecer del universo visible.

HAL y la burocracia (XI)

2009-06-05T23:50:00.002+02:00

Entre el guión original y la última versión obtenida en el proceso de reconstrucción que estamos siguiendo, hay ya muy pocas diferencias, todas ellas relativamente triviales.

En primer lugar, y con objeto de aliviar la exposición, hemos partido de un presupuesto falso, a saber, que los ficheros reales de objetivos y mínimos ---los del autor--- contenían sólo la etiqueta de LaTeX \item. La realidad es un poco más compleja. En tales ficheros aparecían, además, las etiquetas: \section, \subsection, \subsubsection, \paragraph, \begin{itemize} y \end{itemize}. Ahora bien, la plantilla a partir de la cual se generan los informes particulares de cada alumno cuenta con que los ficheros incluidos mediante \input en los entornos Objetivos y Contenidos constan de líneas precedidas por la etiqueta \item y que ninguna otra etiqueta LaTeX está presente. Esto significa que los ficheros originales curso-objetivos.tex y curso-minimos.tex deben sufrir un proceso de depuración antes de ser incluidos mediante \input. Una forma sencilla de lograrlo es utilizar una instrucción sed que elimine todas las etiquetas mencionadas, excepto \item:


sed -e '/\\.*section/d' \
    -e '/\\.itemize/d' \
    -e '/\\paragraph/d' ${CURSO}-objetivos.tex

sed -e '/\\.*section/d' \
    -e '/\\.itemize/d' \
    -e '/\\paragraph/d' ${CURSO}-minimos.tex

Puesto que el proceso de depuración debe aplicarse, como acabamos de ver, tanto al fichero de objetivos como al de mínimos, y puesto que, como aprendimos ayer, hay que rehuir de las redundancias, es oportuno utilizar aquí un fichero que contenga las expresiones sed anteriormente definidas y que se pase como argumento a sed (mediante su opción -f) en sendas órdenes de depuración.

Creamos, pues, el fichero que llamaremos limpiar_tex.sed, cuyo contenido será:


/\\.*section/d
/\\.*itemize/d
/\\paragraph/d

Y, dado que el fichero en cuestión es un dato de entrada al mismo nivel que el fichero $NOTAS o el directorio $PROGRAMACION, una variable inicial que se refiera al nuevo fichero parece lo más indicado:


# Fichero sed para limpiar etiquetas LaTeX
NOLATEX=limpiar_tex.sed

Ahora podemos pasar ese fichero como argumento de la opción -f de sed para obtener los ficheros de objetivos y mínimos que se incluirán en los ficheros .tex resultantes de las conversiones realizadas sobre la plantilla:


sed -f $NOLATEX ${CURSO}-$OBJETIVOS > objetivos_tmp.tex
sed -f $NOLATEX ${CURSO}-$CONTENIDOS > contenidos_tmp.tex

Se habrá notado que el resultado se redirige a un par de ficheros temporales, que serán, en último término, los que se incluirán en el fichero .tex de cada informe. Es evidente que es esto lo que queremos y no, por ejemplo, sobreescribir los ficheros originales de objetivos y mínimos.

Para mayor claridad y versatilidad, se pueden definir dos variables puestas al valor del nombre del fichero de objetivos y mínimos de cada caso, variables que pueden a su vez pasarse como argumentos de las órdenes sed anteriormente citadas en el lugar de los propuestos antes:


# Ficheros que contienen los objetivos y contenidos del curso
# en que el alumno está matriculado
F_OBJETIVOS=${PROGRAMACION}/${CURSO}-$OBJETIVOS
F_CONTENIDOS=${PROGRAMACION}/${CURSO}-$CONTENIDOS

# Los objetivos y contenidos en un formato apto para la plantilla
# a partir de la que se genera el informe
sed -f $NOLATEX $F_OBJETIVOS > objetivos_tmp.tex
sed -f $NOLATEX $F_CONTENIDOS > contenidos_tmp.tex

Lo que resta es, simplemente, modificar adecuadamente, las expresiones correspondientes de la última orden sed, que, claramente, acaba adquiriendo un aspecto mucho más amigable (sin las comillas dobles, sin variables y sin la triple barra invertida):


# Versión previa
sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
    -e "s/CURSO/$CURSO_OUTPUT/" \
    -e "s/OBJETIVOS/\\\input{${CURSO}-${OBJETIVOS}}/" \
    -e "s/CONTENIDOS/\\\input{${CURSO}-${CONTENIDOS}}/" \
    -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > ${ALUMNO}.tex

# Nueva versión
sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
    -e "s/CURSO/$CURSO_OUTPUT/" \
    -e 's/OBJETIVOS/\\input{objetivos_tmp}/' \
    -e 's/CONTENIDOS/\\input{contenidos_tmp}/' \
    -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > ${ALUMNO}.tex

La nueva versión del guión, generar_informes-4, con estas incorporaciones de última hora, queda como sigue:


# Directorio que contiene la programación del curso
PROGRAMACION="$HOME/guiones/informe_suspensos"

# Fichero que contiene la plantilla LaTeX del informe
PLANTILLA=informe_plantilla.tex

# Fichero que contiene las notas de los alumnos
NOTAS=notas

# Sufijo de los ficheros de objetivos por cursos
OBJETIVOS=objetivos.tex

# Sufijo de los ficheros de contenidos por cursos
CONTENIDOS=minimos.tex

# La nota mínima para aprobar el curso
NOTA_MINIMA=5

# Fichero sed para limpiar etiquetas LaTeX
NOLATEX=limpiar_tex.sed

for linea in $(cat $NOTAS)
do
  if [ $(echo $linea | cut -d':' -f3) -lt $NOTA_MINIMA ]
  then
    # Nombre y curso del alumno tal como constan en el fichero $NOTAS
    ALUMNO=$(echo $linea | cut -d':' -f1)
    CURSO=$(echo $linea | cut -d':' -f2)

    # El nombre del alumno y curso con el formato que tendrán en la salida impresa
    ALUMNO_OUTPUT=$(echo $ALUMNO | sed -e 's/-/ /g')
    CURSO_OUTPUT=$(echo $CURSO | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                              -e 's/ge/EE/' \
                                              -e 's/gm/EP/')

    # Ficheros que contienen los objetivos y contenidos del curso
    # en que el alumno está matriculado
    F_OBJETIVOS=${PROGRAMACION}/${CURSO}-$OBJETIVOS
    F_CONTENIDOS=${PROGRAMACION}/${CURSO}-$CONTENIDOS

    # Los objetivos y contenidos en un formato apto para la plantilla
    # a partir de la que se genera el informe
    sed -f $NOLATEX $F_OBJETIVOS > objetivos_tmp.tex
    sed -f $NOLATEX $F_CONTENIDOS > contenidos_tmp.tex

    # Las propuestas de trabajo se deben introducir interactivamente
    echo "Introduzca propuestas de trabajo para $ALUMNO_OUTPUT [\item ... (^D para salir)]: "
    cat > trabajo_tmp.tex

    sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
        -e "s/CURSO/$CURSO_OUTPUT/" \
        -e  's/OBJETIVOS/\\input{objetivos_tmp}/' \
        -e 's/CONTENIDOS/\\input{contenidos_tmp}/' \
        -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > ${ALUMNO}.tex

    pdflatex ${ALUMNO}.tex
  fi
done

HAL y la burocracia (X - redundancia)

2009-06-05T20:41:00.004+02:00

Si recurríamos a los bucles para evitar la repetición innecesaria del mismo código sobre los elementos de una lista de datos, carece de sentido mantener en el interior del bucle construcciones redundantes. Y nuestra última redacción posee un grado de redundancia intolerable:


...
for linea in $(cat $NOTAS)
do
  if [ $(echo $linea | cut -d':' -f3) -lt $NOTA_MINIMA ]
  then
    # El nombre del alumno y curso con el formato que tendrán en la salida impresa
    ALUMNO_OUTPUT=$(echo $linea | cut -d':' -f1 | sed -e 's/-/ /g')
    CURSO_OUTPUT=$(echo $linea | cut -d':' -f2 | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                              -e 's/ge/EE/' \
                                              -e 's/gm/EP/')

    # Las propuestas de trabajo se deben introducir interactivamente
    echo "Introduzca propuestas de trabajo para $ALUMNO_OUTPUT [\item ... (^D para salir)]: "
    cat > trabajo_tmp.tex

    sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
        -e "s/CURSO/$CURSO_OUTPUT/" \
        -e "s/OBJETIVOS/\\\input{$(echo $linea | cut -d':' -f2)-${OBJETIVOS}}/" \
        -e "s/CONTENIDOS/\\\input{$(echo $linea | cut -d':' -f2)-${CONTENIDOS}}/" \
        -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > $(echo $linea | cut -d':' -f1).tex

    pdflatex $(echo $linea | cut -d':' -f1).tex
  fi
done

Una forma de evitar estas inoperantes y fastidiosas redundancias es convertir el código que se repite en el valor de una variable. Con ello logramos una serie de beneficios claros:

El código en cuestión se ejecuta una única vez, en lugar de varias, lo que implica un uso más eficiente de los recursos.

La complejidad disminuye, porque donde había una larga tubería habrá ahora un simple nombre de variable.

El resultado es más manejable, puesto que si se decide modificar el guión, bastará hacerlo en un solo sitio y no en varios.

El resultado es más legible, pues el nombre de la variable, si está bien elegido, será mucho más fácilmente comprensible que la cadena de órdenes por la que está.

Procedamos a empaquetar el código que extrae el primer y segundo campo de cada línea del fichero $NOTAS, nombre de alumno y curso, respectivamente, en una variable adecuada:


# Nombre y curso del alumno tal como constan en el fichero $NOTAS
ALUMNO=$(echo $linea | cut -d':' -f1)
CURSO=$(echo $linea | cut -d':' -f2)

El siguiente paso es incorporar las definiciones de estas variables y modificar las líneas del guión que contenían lo que ahora es el valor de tales variables. Recordemos, por otra parte, que cuando el valor de una variable se ha de manipular dentro de una tubería por un filtro que exige como entrada una cadena de caracteres se lo pasamos como argumento a echo:


for linea in $(cat $NOTAS)
do
  if [ $(echo $linea | cut -d':' -f3) -lt $NOTA_MINIMA ]
  then
    # Nombre y curso del alumno tal como constan en el fichero $NOTAS
    ALUMNO=$(echo $linea | cut -d':' -f1)
    CURSO=$(echo $linea | cut -d':' -f2)

    # El nombre del alumno y curso con el formato que tendrán en la salida impresa
    ALUMNO_OUTPUT=$(echo $ALUMNO | sed -e 's/-/ /g')
    CURSO_OUTPUT=$(echo $CURSO | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                              -e 's/ge/EE/' \
                                              -e 's/gm/EP/')

    # Las propuestas de trabajo se deben introducir interactivamente
    echo "Introduzca propuestas de trabajo para $ALUMNO_OUTPUT [\item ... (^D para salir)]: "
    cat > trabajo_tmp.tex

    sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
        -e "s/CURSO/$CURSO_OUTPUT/" \
        -e "s/OBJETIVOS/\\\input{${CURSO}-${OBJETIVOS}}/" \
        -e "s/CONTENIDOS/\\\input{${CURSO}-${CONTENIDOS}}/" \
        -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > ${ALUMNO}.tex

    pdflatex ${ALUMNO}.tex
  fi
done

Veamos qué dice diff si guardamos esta nueva versión con el nombre generar_informes-3:

diff -Bbi -u generar_informes-2 generar_informes-3

Su respuesta es la siguiente:


--- generar_informes-2  2009-06-05 15:20:33.000000000 +0200
+++ generar_informes-3  2009-06-05 21:38:40.000000000 +0200
@@ -20,9 +20,13 @@
 do
   if [ $(echo $linea | cut -d':' -f3) -lt $NOTA_MINIMA ]
   then
+    # Nombre y curso del alumno tal como constan en el fichero $NOTAS
+    ALUMNO=$(echo $linea | cut -d':' -f1)
+    CURSO=$(echo $linea | cut -d':' -f2)
+
     # El nombre del alumno y curso con el formato que tendrán en la salida impresa
-    ALUMNO_OUTPUT=$(echo $linea | cut -d':' -f1 | sed -e 's/-/ /g')
-    CURSO_OUTPUT=$(echo $linea | cut -d':' -f2 | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
+    ALUMNO_OUTPUT=$(echo $ALUMNO | sed -e 's/-/ /g')
+    CURSO_OUTPUT=$(echo $CURSO | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                               -e 's/ge/EE/' \
                                               -e 's/gm/EP/')

@@ -32,11 +36,10 @@

     sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
         -e "s/CURSO/$CURSO_OUTPUT/" \
-        -e "s/OBJETIVOS/\\\input{$(echo $linea | cut -d':' -f2)-${OBJETIVOS}}/" \
-        -e "s/CONTENIDOS/\\\input{$(echo $linea | cut -d':' -f2)-${CONTENIDOS}}/" \
-        -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > $(echo $linea | cut -d':' -f1).tex
+        -e "s/OBJETIVOS/\\\input{${CURSO}-${OBJETIVOS}}/" \
+        -e "s/CONTENIDOS/\\\input{${CURSO}-${CONTENIDOS}}/" \
+        -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > ${ALUMNO}.tex

-    pdflatex $(echo $linea | cut -d':' -f1).tex
+    pdflatex ${ALUMNO}.tex
   fi
 done

Resumen

Por regla general, las redundancias deben ser evitadas en la escritura de guiones o programas.

HAL y la burocracia (IX - repeticiones)

2009-06-04T16:21:00.006+02:00

Quizá la ventaja más señalada de un computador respecto del humano es su capacidad de repetir una y otra vez las mismas operaciones sin acusar aburrimiento o cansancio alguno. No hace falta escarbar en las zonas profundas e invisibles de su trastienda para asistir a un aquelarre de incontables repeticiones, incluso la mayoría de las órdenes amigables que hemos aprendido no son sino procesos en los que una misma operación se repite hasta agotar todos los datos de la entrada. Un grep, por ejemplo, no es otra cosa que la repetición de la misma operación, la de buscar en una línea la presencia de un patrón textual, aplicada a todas las líneas de los ficheros que se le dan como argumentos.

Aunque nuestros guiones no han aplicado conscientemente hasta ahora esta facultad repetitiva, el guión del que nos ocupamos estos días es un buen pretexto para conocer algunas herramientas lingüísticas nuevas que permitan programar repeticiones o bucles, como se denominan técnicamente.

Veamos, para empezar, un ejemplo fácil de bucle.

Supongamos que queremos que HAL realice una copia de los ficheros que existen en nuestro subdirectorio actual (~/guiones/informe_suspensos). Nuestro objetivo, en concreto, es que para cada fichero del subdirectorio se obtenga una copia con el nombre fichero.copia. Carece de sentido hacerlo a mano:


cp 1-ge-minimos.tex 1-ge-minimos.tex.copia
cp 1-ge-objetivos.tex 1-ge-objetivos.tex.copia
...

En lugar de ello, podemos utilizar una orden de este tipo:

Para cada 'fichero' en la lista de todos los ficheros del directorio actual, haz una copia con el nombre 'fichero.copia'

O, dispuesta cada expresión en una línea independiente:


Para cada 'fichero' en la lista de todos los ficheros del directorio actual
haz
una copia con el nombre 'fichero.copia'

Podemos traducir, sin más, parte de las expresiones actuales:


Para cada 'fichero' en $(ls *)
haz
cp 'fichero' fichero.copia

La palabra entrecomillada ('fichero') tiene todo el aspecto de ser una variable temporal, pues su valor cambiará según el fichero del caso. Por tanto, podemos confiar en que la siguiente versión es adecuada:


Para fichero en $(ls *)
haz
cp $fichero $fichero.copia

Aunque adecuada, la última línea de esta traducción contiene una ambigüedad. ¿Cuál es el nombre de la variable que aparece en último lugar? Para HAL será todo lo que hay después del signo '$', o sea, fichero.copia. Sin embargo, lo que pretendemos es que la variable sea fichero y .copia un sufijo que se añadirá a cada nombre de fichero concreto. En estos casos, se utilizan llaves para delimitar con precisión absoluta el nombre de la variable: ${fichero}.copia. Mantener la ambigüedad aquí no va a tener efecto negativo, pero conviene irse acostumbrando a estas sutilezas, cuya omisión puede ser letal en otras ocasiones. El fragmento anterior queda, pues, suprimida la ambigüedad, de esta forma:


Para fichero en $(ls *)
haz
cp $fichero ${fichero}.copia

Lo nuevo es poco más que inglés de andar por casa:


for fichero in $(ls *)
do
cp $fichero ${fichero}.copia

un pequeño elemento ortográfico más, el done con que se cierra el bucle:


for fichero in $(ls *)
do
cp $fichero ${fichero}.copia
done

y el, aunque opcional, siempre recomendable, toque de estilo:


for fichero in $(ls *)
do
   cp $fichero ${fichero}.copia
done

Para el caso concreto del ejemplo, el código se puede abreviar, eliminando la sustitución de comandos y utilizando únicamente el comodín en su lugar, que en un bucle for tienen el mismo significado [Ver, además, la matización de Vicho en el primer comentario al artículo, si se quiere redondear la sintaxis definitiva]:


for fichero in *
do
   cp $fichero ${fichero}.copia
done

Volvamos a nuestro guión provistos de estos nuevos conocimientos.

Se recordará que el modelo para el caso simple contaba con que el fichero notas sólo contuviera una única línea. Vamos a eliminar esta última restricción y aceptar cualquier número posible de alumnos registrados. Digamos que nuestro fichero notas contiene las siguientes líneas:


Don-Quijote-de-la-Mancha:6-gm:10
Sancho-Panza:1-ge:3
Sansón-Carrasco:3-gm:4
Dulcinea-del-Toboso:1-gm:5

El objetivo es que para cada línea del fichero, se ejecuten las instrucciones contenidas en el modelo simple. Recordemos que la versión final de este modelo simple realizaba, por este orden, las siguientes operaciones:


# Verificar que el campo tercero ---la nota--- de la línea del
# fichero sea menor que la nota mínima.
if [ $(cut -d':' -f3 $NOTAS) -lt $NOTA_MINIMA ]
...

### ( En el caso de que se cumpla la condición )
# Convertir el campo primero ---el nombre del alumno--- de la línea
# del fichero al formato que tendrá en la salida impresa y
# guardarlo en la variable 'ALUMNO_OUTPUT'.
ALUMNO_OUTPUT=$(cut -d':' -f1 $NOTAS | sed -e 's/-/ /g')

# Convertir el campo segundo ---el código del curso--- de la línea
# del fichero al formato que tendrá en la salida impresa y
# guardarlo en la variable 'ALUMNO_OUTPUT'.
CURSO_OUTPUT=$(cut -d':' -f2 $NOTAS | sed ...)

# Abrir una sesión interactiva para crear el fichero temporal 
# 'trabajo_tmp.tex' que contenga las propuestas de actividades.
...
cat > trabajo_tmp.tex

# Realizar las sustituciones necesarias en el fichero '$PLANTILLA'
# y generar como resultado el fichero 'Sancho-Panza.tex'.
sed ... $PLANTILLA > Sancho-Panza.tex

# Procesar el fichero que resulta del paso anterior con pdflatex.
pdflatex Sancho-Panza.tex

Comencemos, pues, las modificaciones.

El primer paso es crear el bucle que permita realizar esta serie de procesos para cada línea del fichero $NOTAS:


for linea in $(cat $NOTAS)
do
  acciones
done

Se observará que para que el guión pueda leer cada línea del fichero y actuar sobre cada una de ellas, tenemos primero que darle acceso a su contenido. cat es una orden que se puede utilizar para este propósito.

El segundo paso es cambiar adecuadamente las entradas de las órdenes que, en nuestra versión previa, accedían al fichero $NOTAS. Puesto que ahora deben ejecutarse no para el fichero en cuanto unidad cerrada, sino para cada una de sus líneas, tendremos que cambiar el método de entrada del dato, ya no vale utilizar el nombre del fichero como argumento, sino que se requiere pasar cada línea a la orden correspondiente mediante una tubería. Veamos las órdenes afectadas en su versión original (en verde) y en su versión modificada (en rojo).


### 1.
# Versión previa
if [ $(cut -d':' -f3 $NOTAS) -lt $NOTA_MINIMA ]

# Nueva versión
if [ $(echo $linea | cut -d':' -f3) -lt $NOTA_MINIMA ]

### 2.
# Versión previa
ALUMNO_OUTPUT=$(cut -d':' -f1 $NOTAS | sed -e 's/-/ /g')

# Nueva versión
ALUMNO_OUTPUT=$(echo $linea | cut -d':' -f1 | sed -e 's/-/ /g')

### 3.
# Versión previa
CURSO_OUTPUT=$(cut -d':' -f2 $NOTAS | sed ...)

# Nueva versión
CURSO_OUTPUT=$(echo $linea | cut -d':' -f2 | sed ...)

Una tercera modificación obligatoria en sustituir en las órdenes correspondientes los nombres de ficheros que aludían a Sancho Panza por una expresión que devuelva el nombre del alumno según la línea del fichero que en ese momento de ejecución del bucle se esté procesando:


### 1.
# Versión previa
sed ... -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > Sancho-Panza.tex

# Nueva versión
sed ... -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > $(echo $linea | cut -d':' -f1).tex

### 2.
# Versión previa
pdflatex Sancho-Panza.tex

# Nueva versión
pdflatex $(echo $linea | cut -d':' -f1).tex

El último paso para la generalización del guión es procurar un nombre genérico para los ficheros de objetivos y contenidos mínimos, de forma que se acceda al fichero que corresponda al curso del alumno cuya línea se esté procesando en cada momento. Ya, de paso, recurriremos, para construir el nombre genérico de dichos ficheros, a las variables iniciales OBJETIVOS y CONTENIDOS, no referidas en el guión hasta ahora:


# Versión previa
sed ... -e 's/OBJETIVOS/\\input{1-ge-objetivos}/' \
        -e 's/CONTENIDOS/\\input{1-ge-minimos}/' ...

# Nueva versión
sed ... -e "s/OBJETIVOS/\\\input{$(echo $linea | cut -d':' -f2)-${OBJETIVOS}}/" \
        -e "s/CONTENIDOS/\\\input{$(echo $linea | cut -d':' -f2)-${CONTENIDOS}}/" ...

Se advertirá que esta modificación en la secuencia de reemplazo de las ordenes sed nos obliga a utilizar comillas dobles. Además, puesto que el carácter '\', al igual que '$', mantiene su significado especial cuando va seguido de '\' y dentro de comillas dobles, es necesario volver a escaparlo, lo cual produce el triple '\\\' (!)

Si unimos todas las modificaciones obtenemos esta versión inicial, realmente abigarrada, de nuestro guión generalizado para un fichero $NOTAS con un número arbitrario de líneas:


# Directorio que contiene la programación del curso
PROGRAMACION="$HOME/guiones/informe_suspensos"

# Fichero que contiene la plantilla LaTeX del informe
PLANTILLA=informe_plantilla.tex

# Fichero que contiene las notas de los alumnos
NOTAS=notas

# Sufijo de los ficheros de objetivos por cursos
OBJETIVOS=objetivos.tex

# Sufijo de los ficheros de contenidos por cursos
CONTENIDOS=minimos.tex

# La nota mínima para aprobar el curso
NOTA_MINIMA=5

for linea in $(cat $NOTAS)
do
  if [ $(echo $linea | cut -d':' -f3) -lt $NOTA_MINIMA ]
  then
    # El nombre del alumno y curso con el formato que tendrán en la salida impresa
    ALUMNO_OUTPUT=$(echo $linea | cut -d':' -f1 | sed -e 's/-/ /g')
    CURSO_OUTPUT=$(echo $linea | cut -d':' -f2 | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                              -e 's/ge/EE/' \
                                              -e 's/gm/EP/')

    # Las propuestas de trabajo se deben introducir interactivamente
    echo "Introduzca propuestas de trabajo para $ALUMNO_OUTPUT [\item ... (^D para salir)]: "
    cat > trabajo_tmp.tex

    sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
        -e "s/CURSO/$CURSO_OUTPUT/" \
        -e "s/OBJETIVOS/\\\input{$(echo $linea | cut -d':' -f2)-${OBJETIVOS}}/" \
        -e "s/CONTENIDOS/\\\input{$(echo $linea | cut -d':' -f2)-${CONTENIDOS}}/" \
        -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > $(echo $linea | cut -d':' -f1).tex

    pdflatex $(echo $linea | cut -d':' -f1).tex
  fi
done

El autor advierte que la versión no es definitiva, hay demasiadas repeticiones y demasiadas complejidades como para mantenerla así, por muy sucios y rápidos que pretendamos ser. En realidad, esta versión no es ni siquiera la primera que puede surgir en la mente de quien la crea. Como se verá, ante complejidades evidentes, la mente tiende a simplificar desde las fases iniciales.

Poner a prueba esta versión pasa, naturalmente, por disponer, en el directorio desde el se ejecuta el guión, de los ficheros de objetivos y mínimos correspondientes a los cursos en que están matriculados los alumnos suspensos. Así, para el quijotesco ejemplo de cuatro personajes que dimos hace un momento serían necesarios los citados ficheros para 1-ge, que ya habíamos redactado en anteriores sesiones, y para 3-gm, cuya redacción es tarea del lector.

Para finalizar la densa sesión de hoy puede ser interesante introducir una nueva orden de HAL que nos permita observar de un vistazo las modificaciones que vamos realizando en las distintas versiones de nuestros guiones. Una herramienta clásica de HAL para este propósito es diff. Otra, es colordiff, que, en sistemas Debian, es seguramente necesario instalar previamente. Si la primera versión completa del guión, la versión para el caso simple, la guardamos como generar_informes-1 y ésta nueva como generar_informes-2, las diferencias entre ambas versiones se puede mostrar mediante la instrucción [las opciones añadidas son las mismas que las de diff y se pueden consultar en la página de manual correspondiente]:

colordiff -u -Bbi generar_informes-1 generar_informes-2

Que produce el resultado que aparece en esta imagen:

Resumen

Los procesos repetitivos pueden requerir y muchas veces exigen el uso de construcciones especiales, denominadas bucles. Un bucle típico es el bucle for, que se atiene a la siguiente sintáxis:
```
for variable in lista
do
  acciones
done
```

La orden diff ---o su versión coloreada, colordiff--- permite contemplar las diferencias existentes entre dos ficheros.

HAL y la burocracia (VIII - decisiones)

2009-06-04T00:47:00.005+02:00

La vida es inconcebible como camino de dirección única. A cada paso se nos abre un sinfín de posibilidades, muchas veces incompatibles, ante las cuales no nos queda más remedio que elegir. Los senderos se bifurcan en el ambiguo jardín de la existencia. Pero nuestras elecciones no son, o no deberían ser, completamente caprichosas. La consideración reflexiva de las opciones presentes en las encrucijadas guían nuestra conducta. Por eso, una lengua que careciese de oraciones condicionales no sería humana o, cuando menos, no sería aplicable más que a un sector insignificante de la realidad vital.

Tampoco a la lengua de HAL le son ajenas las peripecias de la decisión, pues siempre llega el caso en que, dadas ciertas circunstancias, toca desviarse de la senda principal e iniciar una nueva. Por suerte, los "si es" y "si no es" de HAL son mucho más fáciles de aprender que las normas de la consecutio temporum, y las ambigüedades en las alternativas que presentan están terminantemente prohibidas, so pena de naufragar en resultados ininteligibles o simplemente abortados.

Consideremos un ejemplo trivial, para irnos acostumbrando a esta nueva rama de nuestro acervo lingüístico:

Si estoy en casa, di "hola"; si no, di "adiós".

Pongamos cada frase en una línea aparte para más claro entendimiento:


Si estoy en casa
di hola
si no
di adios

Las oraciones imperativas sabemos cómo expresarlas, son el meollo de todo lo que hemos pronunciado hasta ahora:


Si estoy en casa
echo "hola"
si no
echo "adiós"

También podemos construir un equivalente en lengua de HAL para la condición estipulada, la de estar en casa. Decir que estamos en casa es, visto desde la perspectiva de HAL, lo mismo que decir que nuestro directorio actual de trabajo es igual que nuestro directorio home:


Si $(pwd) = $HOME
echo "hola"
si no
echo "adiós"

Es fundamental advertir que el '=' en la frase $(pwd) = $HOME debe estar separado de los términos que compara por un espacio y que es, a pesar de su apariencia, completamente distinto del '=' de una expresión de asignación de valor a una variable (por ejemplo, ESCUDERO='Sancho Panza') donde los espacios de separación están prohibidos. La primera expresión compara dos cadenas de caracteres por su igualdad, mientras que la segunda asigna un valor a una variable.

El resto es el inglés corriente y moliente:


if $(pwd) = $HOME
echo "hola"
else
echo "adiós"

Finalmente, unas pocas normas ortográficas más: la condición va entre corchetes y a un espacio de distancia por delante y por detrás de ellos; tras el "si" (el if) ha de haber un "entonces" (un then); para terminar, la frase entera se cierra graciosamente con un if invertido (fi):


if [ $(pwd) = $HOME ]
then
echo "hola"
else
echo "adiós"
fi

Y, como convención de estilo, un bello espaciado que destaque la diferente función de cada ingrediente en la frase:


if [ $(pwd) = $HOME ]
then
   echo "hola"
else
   echo "adiós"
fi

El lector puede copiar este fragmento de código, pegarlo en su línea de órdenes y ejecutarlo. Si su directorio actual es su HOME, recibirá un caluroso saludo; en caso contrario, un fría despedida.

La facultad de construir oraciones condicionales abre un campo enorme de nuevas posibilidades para nuestros guiones y para nuestras conversaciones con HAL.

La primera aplicación es que en el guión simplificado que hemos producido estos días ya no tenemos por qué seguir suponiendo artificialmente que la nota de nuestro alumno es suspenso. Dicho de otra forma, podemos solicitar a HAL que realice las operaciones establecidas ---que en la redacción actual realiza en todo caso posible--- sólo si la calificación del alumno que consta en el fichero notas es inferior a la nota mínima necesaria para aprobar.

Construyamos, en primer lugar, la condición:

el campo tercero de la línea que consta en el fichero 'notas' ---el que almacena la calificación--- es menor que la nota mínima

En lengua de HAL:

$(cut -d':' -f3 $NOTAS) -lt $NOTA_MINIMA

El operador -lt, abreviatura de less than (menor que), se utiliza precisamente para este tipo de comparaciones aritméticas.

La frase condicional entera sería:


if [ $(cut -d':' -f3 $NOTAS) -lt $NOTA_MINIMA ]
then
    ÓRDENES
fi

Como no necesitamos realizar ninguna operación en el caso de que la nota sea superior a la mínima, no es necesario crear una cláusula else para nuestra frase.

El guión completo con la condición añadida quedaría ahora como sigue:


# Directorio que contiene la programación del curso
PROGRAMACION="$HOME/guiones/informe_suspensos"

# Fichero que contiene la plantilla LaTeX del informe
PLANTILLA=informe_plantilla.tex

# Fichero que contiene las notas de los alumnos
NOTAS=notas

# Sufijo de los ficheros de objetivos por cursos
OBJETIVOS=objetivos.tex

# Sufijo de los ficheros de contenidos por cursos
CONTENIDOS=minimos.tex

# La nota mínima para aprobar el curso
NOTA_MINIMA=5

if [ $(cut -d':' -f3 $NOTAS) -lt $NOTA_MINIMA ]
then
  # El nombre del alumno y curso con el formato que tendrán en la salida impresa
  ALUMNO_OUTPUT=$(cut -d':' -f1 $NOTAS | sed -e 's/-/ /g')
  CURSO_OUTPUT=$(cut -d':' -f2 $NOTAS | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                            -e 's/ge/EE/' \
                                            -e 's/gm/EP/')

  # Las propuestas de trabajo se deben introducir interactivamente
  echo "Introduzca propuestas de trabajo para $ALUMNO_OUTPUT [\item ... (^D para salir)]: "
  cat > trabajo_tmp.tex

  sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
      -e "s/CURSO/$CURSO_OUTPUT/" \
      -e 's/OBJETIVOS/\\input{1-ge-objetivos}/' \
      -e 's/CONTENIDOS/\\input{1-ge-minimos}/' \
      -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > Sancho-Panza.tex

  pdflatex Sancho-Panza.tex
fi

Si lo ponemos a prueba, no habrá ningún cambio en su comportamiento. El informe Sancho-Panza.pdf se generará idéntico al del día pasado. Pero si cambiamos la nota de Sancho y le damos un aprobado, el guión terminará en silencio sin haber realizado ninguna acción, aparte de la asignación temporal de los valores de las variables, cosa que carece de efectos visibles para nosotros.

Resumen

La lengua de HAL dispone de la posibilidad de construir frases condicionales mediante la sintaxis:

if [ condición ] 
then
  acciones si la condición se cumple
else 
  acciones si la condición no se cumple
fi

El operador '=' sirve para asignar valores a variables (ejemplo: VAR=val) o, inserto en expresiones condicionales, para comparar por su identidad cadenas de caracteres (ejemplo: cadena1 = cadena2).

El operador '-lt' dentro de expresiones condicionales sirve para verificar si un valor aritmético es menor que otro.

HAL y la burocracia (VII - interactividad)

2009-06-03T10:54:00.006+02:00

En un remoto pasado de nuestras conversaciones, enredados en las peculiaridades digestivas de HAL, jugábamos a procurar el alimento de órdenes como grep o cut por la vía directa de lo que llamamos entonces la cañería principal ---el standard input (STDIN), para los redichos--- conectada por defecto con nuestro terminal o consola. En aquel momento se trataba sólo de un curioso experimento preparatorio para comprender el significado y función de las imprescindibles tuberías. El pasatiempo de aquellos primeros contactos con las maravillas de la anatomía de HAL nos vendrá ahora de perlas para añadir interactividad a nuestro guión.

Volvamos a reproducir el experimento, pero ahora con otra orden capaz igualmente de alimentarse a través de la entrada estándar, la orden cat (no confundir con cut). cat es una abreviatura de concatenate y su función inicial es la de concatenar los ficheros que se le den como argumentos e imprimirlos línea a línea en pantalla. Si se le da un único fichero lo imprime tal cual. ¿Pero, qué sucede si no le damos ningún fichero como argumento? Probémoslo:

cat

Tras pulsar 'Enter', nos encontramos en una situación ya familiar, la de poder emitir líneas de texto en la entrada estándar para que cat haga lo que habitualmente hace con las entradas que se le proporcionan, devolverlas tal cual a la salida estándar, que por defecto también está conectada con nuestro terminal. El juego continúa sin fin hasta que solicitamos salir de él con Ctrl+D:


hola
hola
cat
cat
Ctrl+D

Hasta aquí nada nuevo. cat se comporta de una manera bastante estúpida ---pensaría alguno---, se limita a reproducir cada línea introducida, como si se tratase de un echo interactivo.

Parece que algo tan tonto no puede dar mucho de sí. Por el contrario, la utilidad de cat para nuestro propósito se desvela si añadimos a la orden una redirección:

cat >conversacion

Lo único que hace este añadido es redirigir la salida al fichero conversacion. Por tanto, si reproducimos la anterior sesión interactiva, donde la salida de cat ya no la veremos en pantalla ---porque se redirige a ese fichero--- estaremos copiando en él tal cual las líneas que hayamos escrito antes de pulsar Ctrl+D.

Inmediatamente se comprende la utilidad que este comportamiento de cat puede tener para nuestro guión.

Habíamos dejado pendiente la sección correspondiente a las propuestas de actividades que el alumno debe realizar para superar los objetivos y contenidos. Puesto que estas propuestas ---vamos a suponer---, no pueden, en principio, establecerse de antemano, sino que tienen que redactarse de modo expreso para cada alumno suspenso, proporcionar al guión por medio de cat un acceso a la entrada estándar, nos permitirá realizar la redacción de tales propuestas antes de que las sustituciones en la plantilla informe_plantilla.tex tengan efecto.

Esto nos lleva a modificar el guión obtenido el día pasado del modo siguiente [en rojo las nuevas líneas]:


# Directorio que contiene la programación del curso
PROGRAMACION="$HOME/guiones/informe_suspensos"

# Fichero que contiene la plantilla LaTeX del informe
PLANTILLA=informe_plantilla.tex

# Fichero que contiene las notas de los alumnos
NOTAS=notas

# Sufijo de los ficheros de objetivos por cursos
OBJETIVOS=objetivos.tex

# Sufijo de los ficheros de contenidos por cursos
CONTENIDOS=minimos.tex

# La nota mínima para aprobar el curso
NOTA_MINIMA=5

# El nombre del alumno y curso con el formato que tendrán en la salida impresa
ALUMNO_OUTPUT=$(cut -d':' -f1 $NOTAS | sed -e 's/-/ /g')
CURSO_OUTPUT=$(cut -d':' -f2 $NOTAS | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                          -e 's/ge/EE/' \
                                          -e 's/gm/EP/')

# Las propuestas de trabajo se deben introducir interactivamente
echo "Introduzca propuestas de trabajo para $ALUMNO_OUTPUT [\item ... (^D para salir)]: "
cat > trabajo_tmp.tex


sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
    -e "s/CURSO/$CURSO_OUTPUT/" \
    -e 's/OBJETIVOS/\\input{1-ge-objetivos}/' \
    -e 's/CONTENIDOS/\\input{1-ge-minimos}/' \
    -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > Sancho-Panza.tex

pdflatex Sancho-Panza.tex

La instrucción echo produce un mensaje para el usuario, mientras que la instrucción cat abre la entrada estándar para que el usuario introduzca los datos que se almacenarán en el fichero trabajo_tmp.tex. Este fichero es luego incluido en el fichero Sancho_Panza.tex por obra de la última expresión del sed final.

Se habrá advertido que el usuario debe introducir las propuestas precedidas de '\item', puesto que el entorno LaTeX del que acabarán formando parte es un entorno lista. Esta última complicación se puede evitar fácilmente de forma que al usuario le baste introducir cada propuesta como un línea única (sin el \item). En tal caso, el \item debería añadirlo el propio guión, justo después del cat, con una instrucción como ésta:

sed -i 's/^$.*$/\\item \1/' trabajo_tmp.tex

Que la versión presentada en el primer capítulo de esta serie no contenga la simplificación aludida aceleró unos segundos la redacción del guión, aunque a expensas de complicar en parte la interfaz del usuario. Es lo que tiene el modo de obrar "rápido y sucio".

Queda, finalmente, añadir la sección relativa a las propuestas en nuestra plantilla:


...
\begin{document}
\begin{datosAlumno}
Alumno: ALUMNO & CURSO
\end{datosAlumno}
\begin{Objetivos}
OBJETIVOS
\end{Objetivos}
\begin{Contenidos}
CONTENIDOS
\end{Contenidos}
\begin{Propuestas}
RECUPERACIÓN
\end{Propuestas}
\end{document}

A estas alturas, el lector no debería hallar dificultad alguna en realizar por su cuenta las modificaciones que convengan y volver a poner a prueba el guión mejorado.

Resumen

La orden cat concatena los ficheros que se le proporcionan como argumentos y los imprime en la salida estándar, por defecto, la pantalla. Si no recibe argumentos toma su entrada de la entrada estándar.

Una de las aplicaciones comunes de la orden cat es permitir la creación interactiva de un fichero.

HAL y la burocracia (VI)

2009-06-02T16:41:00.009+02:00

Antes de dar un paso más en la elaboración de nuestro guión, conviene que el lector lo ponga a prueba, si no lo ha hecho ya por cuenta propia.

Creamos, para empezar un directorio informe_suspensos bajo nuestro subdirectorio de guiones:

mkdir ~/guiones/informe_suspensos

Conviene recordar los ficheros recién creados para nuestra prueba [en caso de que el lector no los haya creado todavía, deberá hacerlo ahora con cualquier editor de texto plano]:

informe_plantilla.tex (la plantilla para generar el fichero .tex por alumno [Añado un preámbulo adecuado, modifico ligeramente la sección correspondiente a los datos del alumno y suprimo la sección correspondiente a las propuestas, que ha quedado pendiente, como se recordará]):


\usepackage[spanish]{babel}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{bera}
\usepackage[usenames,dvipsnames]{color}
\usepackage{framed}
\usepackage{enumitem}

\newenvironment{datosAlumno}%
  {\begin{framed}%
     \begin{center}%
       \begin{tabular*}{\textwidth}%
         {@{\extracolsep{\fill}}lr}}%
  {\end{tabular*}\end{center}\end{framed}}

\newenvironment{Objetivos}%
  {\begin{framed}%
     \section*{Objetivos}%
   \end{framed}%
   \begin{framed}%
     \begin{itemize}[label=\fbox{\textcolor{white}{X}}]}%
  {\end{itemize}\end{framed}}

\newenvironment{Contenidos}%
  {\begin{framed}%
     \section*{Contenidos}%
   \end{framed}%
   \begin{framed}%
     \begin{itemize}[label=\fbox{\textcolor{white}{X}}]}%
  {\end{itemize}\end{framed}}

\newenvironment{Propuestas}%
  {\begin{framed}%
     \section*{Propuestas}%
   \end{framed}%
   \begin{framed}%
     \begin{itemize}}%
  {\end{itemize}\end{framed}}

\begin{document}
\begin{datosAlumno}
Alumno: ALUMNO & CURSO
\end{datosAlumno}
\begin{Objetivos}
OBJETIVOS
\end{Objetivos}
\begin{Contenidos}
CONTENIDOS
\end{Contenidos}

1-ge-objetivos.tex (el fichero con los objetivos del curso 1-ge):


\item Reconocer la diferencia entre los refranes y el buen decir.
\item Adquirir el hábito del buen decir.
\item Refrenar el hábito malsano del refraneo sin ton ni son.

1-ge-minimos.tex: (el fichero con los contenidos mínimos del curso 1-ge):


\item El refrán y sus muchos peligros.
\item El decir del caballero versus el decir del bufón.
\item Síntomas alarmantes de la verborrea refranil.

notas: (el fichero con las notas):
```
Sancho-Panza:1-ge:3
```

generar_informes: (el guión propiamente dicho [Unimos lo que obtuvimos en el análisis de datos y en el esbozo del modelo simple, con las comillas corregidas]):


# Directorio que contiene la programación del curso
PROGRAMACION="$HOME/guiones/informe_suspensos"

# Fichero que contiene la plantilla LaTeX del informe
PLANTILLA=informe_plantilla.tex

# Fichero que contiene las notas de los alumnos
NOTAS=notas

# Sufijo de los ficheros de objetivos por cursos
OBJETIVOS=objetivos.tex

# Sufijo de los ficheros de contenidos por cursos
CONTENIDOS=minimos.tex

# La nota mínima para aprobar el curso
NOTA_MINIMA=5

# El nombre del alumno y curso con el formato que tendrán en la salida impresa
ALUMNO_OUTPUT=$(cut -d':' -f1 $NOTAS | sed -e 's/-/ /g')
CURSO_OUTPUT=$(cut -d':' -f2 $NOTAS | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                          -e 's/ge/EE/' \
                                          -e 's/gm/EP/')


sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
    -e "s/CURSO/$CURSO_OUTPUT/" \
    -e 's/OBJETIVOS/\\input{1-ge-objetivos}/' \
    -e 's/CONTENIDOS/\\input{1-ge-minimos}/' $PLANTILLA > Sancho-Panza.tex

pdflatex Sancho-Panza.tex

(Nótese que en este último fichero hemos modificado la variable PROGRAMACIÓN para que tenga en cuenta la nueva ubicación de nuestros ficheros de objetivos y mínimos, aunque no la vayamos a usar en las órdenes que hemos producido hasta ahora. También hemos añadido una línea al final, para que, al ejecutarse el guión, pdflatex procese el fichero .tex resultante de la orden sed que le precede.)

Todos estos ficheros deben estar ahora bajo el subdirectorio $HOME/guiones/informe_suspensos

Queda cambiar el modo del guión:

chmod u+x informe_suspensos

y ejecutarlo:

./informe_suspensos

El resultado, aparte de otros ficheros temporales generados por pdflatex, es el fichero Sancho-Panza.pdf, que, en un lector de pdfs como okular, se muestra con el siguiente aspecto:

HAL y la burocracia (V - las comillas)

2009-06-02T11:23:00.003+02:00

Como advertíamos ayer, por los pequeños detalles merodea el diabólico encantamiento. Para desenmascararlo, vamos a realizar unos pocos experimentos.

En primer lugar, crearemos un variable y le daremos como valor una cadena:

ESCUDERO='Sancho Panza'

Nótese que las comillas son aquí necesarias. De no haberlas puesto, el espacio, un carácter especial en la lengua de HAL (el delimitador que sirve, por ejemplo, para determinar donde termina una orden y empiezan sus argumentos) hubiese sido interpretado por HAL como un separador. Más exactamente, si hubiésemos escrito:

ESCUDERO=Sancho Panza

HAL hubiese creado la variable ESCUDERO con el valor Sancho y hubiese tratado de ejecutar la inexistente orden Panza, con el consabido resultado de command not found. Ni siquiera la variable ESCUDERO hubiese retenido su valor, Sancho, porque, como sabemos desde hace mucho, la definición de variables en la misma línea y justo delante de una orden sólo afecta a la ejecución de esa orden.

Por tanto, las comillas en la anterior definición tienen una función importantísima, permitir que el espacio se interprete literalmente y no como un signo con un valor sintáctico especial. Lo que, en ese ejemplo concreto, implica que el valor de la variable ESCUDERO será Sancho Panza (espacio incluido), como podemos comprobar con un simple:

echo $ESCUDERO

que devuelve:

Sancho Panza

¿Hubiese sido diferente utilizar dobles comillas en lugar de comillas simples?

Lo probamos:


CABALLERO="Don Quijote"
echo $CABALLERO

Que devuelve, de forma semejante:

Don Quijote

Parece, pues, que no hay ninguna diferencia entre las comillas simples y las dobles comillas, que es cosa más de gusto que de gramática. Pero eso, justamente, es lo que quieren que creamos los pérfidos encantadores. De hecho, nosotros hemos utilizado hasta ahora ambos tipos de comillas sin mayor cuestionamiento. Pero las apariencias engañan. Veámoslo:

echo 'El compañero de $CABALLERO es $ESCUDERO'

produce:

El compañero de $CABALLERO es $ESCUDERO

Es algo que deberíamos haber esperado. Las comillas preservan también aquí el significado literal del carácter '$' y evitan que se interprete como un signo sintáctico especial, a saber, el de proporcionar el valor de la variable que le sigue.

Sin embargo,

echo "El compañero de $CABALLERO es $ESCUDERO"

devuelve, sorprendentemente:

El compañero de Don Quijote es Sancho Panza

La conclusión de nuestro experimento parece obvia, las comillas simples son rejas más seguras que las dobles. En general, de las comillas simples ningún carácter se evade de ser interpretado literalmente, mientras que hay caracteres especiales que no se doblegarán a las comillas dobles y seguirán exigiendo ser interpretados como tales signos sintácticos especiales. Entre estos pocos signos que han conseguido la prevalencia de su característica identidad sintáctica está nuestro querido '$'.

Lo que tan interesante conocimiento implica para el código propuesto al final del día pasado es que pone a las claras el origen de su error. Recordemos cuál era el código:


sed -e 's/ALUMNO/$ALUMNO_OUTPUT/' \
    -e 's/CURSO/$CURSO_OUTPUT/' \
    -e 's/OBJETIVOS/\\input{1-ge-objetivos}/' \
    -e 's/CONTENIDOS/\\input{1-ge-minimos}/' $PLANTILLA > Sancho-Panza.tex

Las dos primeras expresiones de la orden sed contienen el signo especial '$'. Ahora bien, la expansión del valor de las variables ALUMNO_OUTPUT y CURSO_OUTPUT no se producirá, puesto que '$' se interpretará literalmente. Acabaremos con un fichero Sancho-Panza.tex con las líneas:


\begin{datosAlumno}
Alumno: $ALUMNO_OUTPUT
Curso: $CURSO_OUTPUT
\end{datosAlumno}

La solución, tras lo aprendido hoy, es bien simple, utilizar dobles comillas en las líneas díscolas:


sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
    -e "s/CURSO/$CURSO_OUTPUT/" \
    -e 's/OBJETIVOS/\\input{1-ge-objetivos}/' \
    -e 's/CONTENIDOS/\\input{1-ge-minimos}/' $PLANTILLA > Sancho-Panza.tex

Un lector espabilado podría imaginar una solución incluso más sencilla. Ya que las comillas esconden tantas triquiñuelas, ¿por qué no suprimirlas directamente?:


sed -e s/ALUMNO/$ALUMNO_OUTPUT/ \
    -e s/CURSO/$CURSO_OUTPUT/ \
    ...

Desgraciadamente, no funcionaría, aunque sí funcionaría la siguiente solución:


sed -e s/ALUMNO/"$ALUMNO_OUTPUT"/ \
    -e s/CURSO/"$CURSO_OUTPUT"/ \
    ...

Dejamos como ejercicio para el lector la experimentación y comprensión de las causas del fracaso y el éxito de las dos últimas propuestas.

Resumen

Las comillas simples permiten que todos los caracteres especiales de la lengua de HAL encerrados en ellas se interpreten literalmente.

Las comillas dobles hacen que casi todos los caracteres especiales de la lengua de HAL se interpreten literalmente, salvo algunos pocos (en especial, el carácter '$'), que seguirán manteniendo su peculiar función sintáctica.

HAL y la burocracia (IV)

2009-05-31T18:32:00.007+02:00

Nuestro siguiente paso es imaginar un proceso que, indefectiblemente, nos lleve desde los ficheros de entrada descritos ayer a los informes en pdf requeridos. No es nada de orden diferente a lo que hemos venido haciendo desde el principio de estas conversaciones. En realidad, se trata siempre de lo mismo: pensar en las transformaciones que deben sufrir ciertos datos de entrada para que de ello surja una determinada salida y aplicar las herramientas que HAL pone a nuestra disposición para efectuar dichas transformaciones.

Podemos, pues, como primer acercamiento, aplicar sin miedo el principio explicado hace tiempo: reducir el problema a un caso muy simple y crear un modelo de solución para ese caso.

Asumamos que, en lugar de diferentes informes para múltiples alumnos, queremos generar un único informe para un único alumno ---que sabemos suspenso de antemano. Dicho de otra forma, supongamos que nuestro fichero notas contiene esta única entrada:

Sancho-Panza:1-ge:3

Supongamos, además, que los únicos ficheros de objetivos y contenidos mínimos con los que contamos son ---¡bendita la suerte!--- los de 1-ge, es decir:


1-ge-objetivos.tex
1-ge-contenidos.tex

Supongamos, finalmente ---y para hacer más divertido el ejemplo--- que el contenido de tales ficheros es el siguiente:

Contenido de 1-ge-objetivos.tex


\item Reconocer la diferencia entre los refranes y el buen decir.
\item Adquirir el hábito del buen decir.
\item Refrenar el hábito malsano del refraneo sin ton ni son.

Contenido de 1-ge-minimos.tex


\item El refrán y sus muchos peligros.
\item El decir del caballero versus el decir del bufón.
\item Síntomas alarmantes de la verborrea refranil.

Para generar con pdflatex un pdf como el que se muestra en la imagen propuesta en el primer artículo de esta serie ---actualizado con los objetivos y contenidos que acabamos de presentar---, deberíamos disponer de un fichero .tex, con un aspecto semejante al siguiente [El preámbulo se omite, y se presupone, sin mayor explicación, que los entornos Objetivos, Contenidos y Propuestas han sido definidos en dicho preámbulo como tipos especiales de listas. (Ver este artículo para refrescar la memoria sobre los entornos y listas en LaTeX)]:


\begin{document}
\begin{datosAlumno}
Alumno: Sancho Panza
Curso: 1.º EE
\end{datosAlumno}

\begin{Objetivos}
\input{1-ge-objetivos}
\end{Objetivos}

\begin{Contenidos}
\input{1-ge-minimos}
\end{Contenidos}

\begin{Propuestas}
???
\end{Propuestas}
\end{document}

Compárese con la plantilla redactada el día pasado:


\begin{document}
\begin{datosAlumno}
Alumno: ALUMNO
Curso: CURSO
\end{datosAlumno}

\begin{Objetivos}
OBJETIVOS
\end{Objetivos}

\begin{Contenidos}
CONTENIDOS
\end{Contenidos}

\begin{Propuestas}
RECUPERACIÓN
\end{Propuestas}
\end{document}

Resulta evidente, que salvo para el caso de las propuestas de recuperación [en púrpura], que discutiremos más adelante, nuestro trabajo, esto es, el trabajo que HAL debería realizar para obtener el fichero .tex del informe de Sancho Panza, digamos, Sancho-Panza.tex, es simplemente sustituir lo que en la plantilla aparece en rojo por lo que, en el mismo color, debe aparecer en el citado informe.

Representemos en lengua de HAL las sustituciones deseadas:


sed 's/ALUMNO/Sancho Panza/' informe_plantilla.tex > Sancho-Panza.tex
sed 's/CURSO/1.º EE/' informe_plantilla.tex > Sancho-Panza.tex
sed 's/OBJETIVOS/\\input{1-ge-objetivos}/' informe_plantilla.tex > Sancho-Panza.tex
sed 's/CONTENIDOS/\\input{1-ge-minimos}/' informe_plantilla.tex > Sancho-Panza.tex

Si utilizamos la opción -e de sed podemos enviar varias órdenes, una tras otra, a sed y reducir la redundancia en las líneas anteriores. Podemos, además, referirnos al fichero que contiene la plantilla a través de la variable PLANTILLA que con ese propósito creamos el día pasado:


sed -e 's/ALUMNO/Sancho Panza/' \
    -e 's/CURSO/1.º EE/' \
    -e 's/OBJETIVOS/\\input{1-ge-objetivos}/' \
    -e 's/CONTENIDOS/\\input{1-ge-minimos}/' $PLANTILLA > Sancho-Panza.tex

Mientras que las dos últimas ordenes de sustitución de la instrucción anterior son válidas tal cual, las dos primeras exigen un tratamiento especial. Las cadenas de caracteres "Sancho Panza" y "1.º EE" no forman parte de nuestros datos de entrada. Debemos, pues, obtenerlas a partir de ellos mediante alguna clase de manipulación. El nombre y curso del alumno, como ya hemos comentado, forman parte del contenido del fichero notas, concretamente, son su primer y segundo campo, respectivamente, donde cada campo está separado por el carácter ':'. Para una operación de extracción de este tipo podemos utilizar, como sabemos, una orden como cut. Así, el campo del nombre se obtendría mediante la orden:

cut -d':' -f1 notas

O, aplicando la variable NOTAS, tal como hemos hecho con la variable PLANTILLA en la instrucción sed anterior:

cut -d':' -f1 $NOTAS

Mutatis mutandis, la siguiente orden extrae del fichero notas el campo relativo al curso:

cut -d':' -f2 $NOTAS

Ahora bien, el contenido de estos campos no es exactamente el que buscamos. El contenido es, respectivamente, Sancho-Panza y 1-ge, pero en el informe deseamos que, en lugar del guión, sea un espacio el que separe nombre y apellido del alumno y que, en lugar de 1-ge aparezca la expresión 1º. EE como identificador del curso ('EE' y 'EP' están por enseñanzas elementales y profesionales, nueva denominación oficial de lo que hace pocos años se denominaban grado elemental y medio, para inri del hacedor de guiones).

sed puede ayudarnos de nuevo a la hora de efectuar las conversiones aludidas.

's/-/ /g'

sustituiría los guiones por espacios en la línea de entrada.

Por su parte la más compleja serie de órdenes


's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/'
's/ge/EE/'
's/gm/EP/'

convertiría 1-ge en 1.º EE [La tercera sustitución, que convierte gm en EP no es necesaria en el caso simple actual, pero la incluimos ya desde ahora mismo con el fin de evitar referirnos a un proceso tan elemental de sustitución en explicaciones posteriores].

Las dos últimas órdenes de esta operación de conversión son obvias, pero la primera puede resultar algo difícil de entender a simple vista. Valga su explicación de repaso de algunas minucias de sed.

Cualquier serie de números que aparezca en la línea de entrada encajará con la expresión '[[:digit:]]*' y cualquier serie de caracteres con la expresión '.*'. Por tanto, el molde '[[:digit:]]*-.*' nos permitirá "cazar" cualquier serie de caracteres constituida por cualquier sucesión de números, seguida de guión y seguido éste último por cualesquiera otros caracteres. En consecuencia, algo como nuestra cadena "1-ge" encajará con ese molde. Puesto que, en la sustitución, queremos reutilizar, por un lado, el número inicial y, por otro, lo que sigue al guión para su posterior conversión mediante las órdenes de sed subsiguientes, guardamos lo que encaje con ambas expresiones en registros temporales, esto es, encerramos entre paréntesis convenientemente escapados los correspondientes moldes, y aplicamos, luego, en el patrón de sustitución, las construcciones especiales \1 y \2 para recuperar lo guardado en dichos registros. El resto es también trivial, el guión acaba sustituido por ".º ", donde el punto debe escaparse, al tratarse de una carácter especial de sed.

Si reunimos todas las piezas, los cut que extraen el nombre y curso del alumno, tal como aparecen en el fichero notas, y los sed que convertirían tales datos al formato que tendrán en el fichero Sancho-Panza.tex de salida, obtenemos estas dos órdenes complejas:

cut -d':' -f1 $NOTAS | sed -e 's/-/ /g'

que devolverá:

Sancho Panza

y la más engorrosa:


cut -d':' -f2 $NOTAS | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                           -e 's/ge/EE/' \
                           -e 's/gm/EP/'

que devolverá:

1.º EE

El paso final está a un tiro de piedra. El resultado de estas dos órdenes debe aparecer como segundo miembro en las instrucciones sed de sustitución propuestas al principio. Este resultado se puede obtener mediante el recurso sintáctico de la sustitución de órdenes. O sea, que nuestro esbozo:


sed -e 's/ALUMNO/Sancho Panza/' \
    -e 's/CURSO/1.º EE/' \
    -e 's/OBJETIVOS/\\input{1-ge-objetivos}/' \
    -e 's/CONTENIDOS/\\input{1-ge-minimos}/' $PLANTILLA > Sancho-Panza.tex

debe completarse como es debido de la forma siguiente:


sed -e 's/ALUMNO/$(cut -d':' -f1 $NOTAS | sed -e 's/-/ /g')/' \
    -e 's/CURSO/$(cut -d':' -f2 $NOTAS | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                             -e 's/ge/EE/' \
                                             -e 's/gm/EP/')/' \
    -e 's/OBJETIVOS/\\input{1-ge-objetivos}/' \
    -e 's/CURSO/\\input{1-ge-minimos}/' $PLANTILLA > Sancho-Panza.tex

¡Buf! algo difícil de digerir de una tacada. Conviene reducir la complejidad a la vista mediante el uso de variables cuyos valores sean las sustituciones de órdenes que acabamos de encajar con calzador:


ALUMNO_OUTPUT=$(cut -d':' -f1 $NOTAS | sed -e 's/-/ /g')
CURSO_OUTPUT=$(cut -d':' -f2 $NOTAS | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                          -e 's/ge/EE/' \
                                          -e 's/gm/EP/')

Lo que permite obtener esta expresión final algo más digerible:


sed -e 's/ALUMNO/$ALUMNO_OUTPUT/' \
    -e 's/CURSO/$CURSO_OUTPUT/' \
    -e 's/OBJETIVOS/\\input{1-ge-objetivos}/' \
    -e 's/CONTENIDOS/\\input{1-ge-minimos}/' $PLANTILLA > Sancho-Panza.tex

No estáría mal para un entremés, Sancho amigo, si no fuera porque contiene un grave error. Y es que no hay que descuidarse de los encantamientos que, agazapados en nuestros más inocuos utensilios de cocina, pueden amargar hasta la olla mejor cocinada.

HAL y la burocracia (III - los datos)

2009-05-30T21:11:00.005+02:00

Una de las primerísimas cosas que hacemos cuando escribimos un guión para HAL es el análisis de los datos que queremos procesar y de los datos resultantes. En guiones sumamente simples, como los escritos hasta ahora, este análisis se suele realizar de una manera inconsciente. Cuando el guión es algo menos simple resulta casi siempre necesario y, en general, más que recomendable, plantearse conscientemente con qué clase de cosas nos vamos a ensuciar las manos. En guiones complejos, un análisis precipitado conduce, en el mejor de los casos, a un diseño ineficaz y, en el peor, a un resultado infumable.

El guión que nos ocupa es simple y no hace falta demorarse demasiado en esta fase inicial. Por otra parte, hay que buscar un equilibrio entre lo que deseamos hacer y el tiempo que deseamos dedicar a hacerlo. Para un asunto engorroso e impremeditado, como el que seguramente supondría para cualquiera la escritura del actual guión, puede ser suficiente una solución relativamente rápida y sucia. De hecho, el guión propuesto es realmente rápido y sucio. Se puede (¿se debe?) mejorar en muchos sentidos. Pero el tiempo apremia y las ganas son pocas. No obstante, e incluso desde estas premisas, no conviene infringir de entrada absolutamente todas las normas de buen comportamiento. Al menos, veamos por el rabillo del ojo qué cosas están presentes y cuáles aparecerán en nuestra caótica mesa.

Empecemos por lo que queremos obtener. Se recordará de la anterior entrada que lo que se nos pide es un informe por alumno (por cada alumno suspenso). Un fichero pdf por alumno es lo más aconsejable en este caso para obtener una copia impresa, y si además lo generamos vía pdflatex, mejor que mejor.

¿Con qué contamos para poder generar esta serie de ficheros?

Contamos, naturalmente, con la programación de la asignatura. Por suerte, esta programación ---un escrito tan largo como aburrido, plagado de repeticiones internas---, ha sido preparado con LaTeX y está dividido en ficheros independientes que luego se componen en un fichero único. Esta técnica de escribir documentos largos, que tantos quebraderos de cabeza supone para los usuarios de procesadores de textos, es pan comido en el mundo de TeX con una instrucción LaTeX como \input{fichero} o \include{fichero}, que permite incluir el contenido de un fichero dentro de otro. Por tanto, disponemos, para empezar, de ficheros .tex adecuadamente nombrados. Así, por ejemplo, los ficheros que definen los contenidos mínimos por curso, poseen la denominación genérica: curso-nivel-mínimos.tex, donde curso está por 1, 2, 3, etc, y nivel está por ge o gm, abreviaturas de la denominación oficial, en el momento en que se redactó la programación, del grado o nivel de los cursos correspondientes ("grado elemental" y "grado medio", respectivamente).
La sintaxis interna de cada uno de estos ficheros es la que cabe esperar de un fichero LaTeX para listas, en concreto, un texto etiquetado con las siguientes etiquetas, como mínimo:


\begin{itemize}
\item Texto del primer item
...
\end{itemize}

Lo segundo con lo que contamos es con un fichero de texto plano que contiene las notas de los alumnos, el fichero notas. Dicho fichero está compuesto por líneas, cada de una de las cuales es un registro por alumno de la forma:

alumno:curso:nota

y donde, a su vez, el nombre del alumno, primer campo del fichero, responde a la convención sintáctica

Nombre-Apellido1-Apellido2

En concreto, nuestro fichero notas es el siguiente:


Don-Quijote-de-la-Mancha:6-gm:10
Sancho-Panza:1-ge:3
Sansón-Carrasco:3-gm:4
Dulcinea-del-Toboso:1-gm:5

Casi sobra insistir en la decisiva importancia que tiene seguir convenciones sintácticas uniformes en ficheros de texto procesables por HAL, como el descrito.

¿Son estos ficheros suficientes para producir la deseada salida en pdf? Evidentemente, no. Puesto que necesitamos un fichero distinto para cada alumno, debemos crear una plantilla común para todos ellos que se llene con los datos específicos de cada alumno en particular. Puesto que, además, deseamos recurrir a pdflatex para obtener el pdf de cada alumno, este plantilla tiene que ser, ella misma, un fichero .tex. Podremos, entonces, utilizar la instrucción \input para añadir los ficheros de contenidos u objetivos deseados dentro de esa plantilla y utilizar fragmentos de textos apropiados para designar los campos variables en ella. Una plantilla con estas características, que se amolda al documento de salida requerido tendría la forma siguiente:


\begin{document}
\begin{datosAlumno}
Alumno: ALUMNO
Curso: CURSO
\end{datosAlumno}

\begin{Objetivos}
OBJETIVOS
\end{Objetivos}

\begin{Contenidos}
CONTENIDOS
\end{Contenidos}

\begin{Propuestas}
RECUPERACIÓN
\end{Propuestas}
\end{document}

Se habrá observado que hemos omitido, para abreviar, el preámbulo del documento LaTeX, donde, además, se tendrían que incluir las definiciones apropiadas de los entornos datosAlumno, Objetivos, Contenidos y Propuestas, definiciones que se establecen mediante la instrucción \newenvironment, que hace las veces de \newcommand, pero en la definición de entornos personalizados, y que no vamos a comentar ahora por tratarse de cuestiones específicas de LaTeX que nos desviarían de nuestro objetivo actual.

En resumen, los datos de entrada imprescindibles de nuestro guión, lo que HAL utilizará para obtener los pdfs, son los siguientes ficheros:

Ficheros .tex de los objetivos y mínimos por cursos, ubicados en el directorio que contiene la programación (/home/luis/conservatorio/programacion-loe):
```
1-ge-objetivos.tex
2-ge-objetivos.tex
...
1-gm-objetivos.tex
2-gm-objetivos.tex
...
1-ge-minimos.tex
2-ge-minimos.tex
...
```

El fichero informe_plantilla.tex que contiene la plantilla para generar los informes por alumno y que reside en el mismo directorio que contiene el guion.

El fichero de texto notas que contiene registros por alumno con el formato alumno:curso:nota, ubicado también en el directorio donde reside el guión.

Tras el análisis de los datos de entrada, podemos proceder a indicárselos a HAL:


# Directorio que contiene la programación del curso
PROGRAMACION=/home/luis/conservatorio/programacion-loe

# Fichero que contiene la plantilla LaTeX del informe
PLANTILLA=informe_plantilla.tex

# Fichero que contiene las notas de los alumnos
NOTAS=notas

# Sufijo de los ficheros de objetivos por cursos
OBJETIVOS=objetivos.tex

# Sufijo de los ficheros de contenidos por cursos
CONTENIDOS=minimos.tex

A éstas variables podemos añadir la que corresponde a la nota mínima que debe obtener el alumno para aprobar el curso, un valor que, sin lugar a dudas, tendremos que utilizar en algún momento:


# La nota mínima para aprobar el curso
NOTA_MINIMA=5

Hemos puesto los cimientos. Se observará que estas líneas reproducen tal cual las líneas iniciales del guión completo presentado el día pasado, con la excepción de la variable NOLATEX, cuyo sentido se explicará a su debido tiempo.

Resumen:

El análisis de los datos de entrada de un guión es un requisito previo imprescindible en la elaboración de guiones o programas.

Los nombres de ficheros de entrada y de los directorios donde residen son candidatos ideales a aparecer como valores de las variables iniciales de un guión.

HAL y la burocracia (II)

2009-05-30T19:45:00.003+02:00

El porqué y el para qué del guión propuesto el día pasado es bien simple. A HAL, por descontado, no le interesa lo más mínimo, porque él opera en un nivel de abstracción de orden radicalmente distinto al nuestro, un nivel en el que es totalmente indiferente el asunto sobre el que va a girar nuestro guión del caso. Pero a nosotros, los que leemos o escribimos el guión, nos resulta indispensable, como a cualquier buen novelista, tener algo más que una noción ligera de la materia sobre la que vamos a tratar. En terminología técnica, el asunto sobre el versa en general un programa ---y un guión es un miniprograma, como ya hemos visto--- se suele denominar su dominio.

El dominio de nuestro guión, como resulta fácil de deducir por el nombre dado a algunas de sus variables, tiene que ver con la enseñanza y, en concreto, con el proceso que los pedagogos llaman evaluación. Hasta ahí todos tenemos idea de qué va: un alumno tiene una nota, resultado de su evaluación. El alumno puede aprobar o suspender. En nuestro país la nota mínima suele ser el 5, aunque sobre eso hay discusiones, a veces enconadas ---particularmente, entre alumnos o padres, de un lado, y profesores, del otro---, en las que no vamos a entrar.

Hasta aquí nada nuevo bajo el cielo, ha sido así toda la vida. Pero lo que quizá algunos lectores no sepan es que, una vez que los psicopedagogos y otros teóricos decidieron tomar cartas en el asunto educativo ---con los resultados que todos conocen y que tampoco vamos a comentar en este momento---, se ha producido una proliferación imparable de tecnicismos y de sus correspondientes encarnaciones escritas, que incluyen toda clase de informes, documentos y estadísticas con nombres de significado difuso o simplemente ininteligible y funciones imposibles de describir por una mente como la del autor. En este abigarrado universo lingüístico-burocrático se desenvuelven cotidianamente una parte de las actividades de la comunidad educativa, y cómo no, el procedimiento de evaluación, o séase, el acto de poner el aprobado o el suspenso al alumno.

Como no merece la pena extenderse en el asunto más de lo debido, basten unas mínimas aclaraciones, las suficientes para poder comprender el dominio de nuestro guión.

Las legislaciones educativas del tiempo presente establecen que el contenido de la enseñanza sea programado ---y que se redacte la correspondiente "programación"--- de acuerdo a unos apartados generales definidos por defecto, entre los cuales se encuentran los "objetivos" y los "contenidos", que vienen a ser algo así como la cuenta al detalle en forma de elementos de una lista, de lo que se va a enseñar ---como si esto fuera posible. Dentro de los contenidos, están los "mínimos", que definen, dicho en castizo, lo que el alumno debe saber si no quiere romperse los codos en verano.

Desentrañar la diferencia existente entre "objetivos" y "contenidos" rebasa la competencia lingüística y probablemente mental de la mayoría, incluido el autor, que da por inútil e improcedente el intento de acometer tal empresa.

Pues bien, resulta que de un tiempo a esta parte, cuando un alumno suspende, el profesor está obligado a confeccionar un informe en el que consten, por este orden:

Los "objetivos" que no ha superado.

Los "contenidos" (mínimos) que tampoco ha superado.

Lo que, en concreto, tiene que hacer para superar o "recuperar" dichos "objetivos"-"contenidos" ---y no cuela lo de "estudia, amigo, más te vale".

Si con este conocimiento del dominio volvemos a mirar el código de nuestro guión, veremos que las variables ya tienen todas un significado claro. Del contenido de esas variables, en otras palabras, de los datos concretos ---el papeleo existente y consiguiente--- que vamos a manejar, trataremos en la próxima conversación. Por cierto, que entre tanta pedagogía de nuevo cuño, HAL ha quedado mudo en ésta :-(

Resumen:

El conocimiento del dominio sobre el que versa un programa o un guión es un requisito fundamental, previo a cualquier intento de escritura.

HAL y la burocracia (I)

2009-05-24T23:35:00.013+02:00

Entre los muchos impedimentos que han hecho imposible al autor de estos artículos mantener el frenético ritmo de escritura de meses pasados se cuentan las obligaciones laborales, algunas de las cuales han resultado, sin embargo, menos onerosas gracias a la ayuda impagable del propio HAL.

¿Por qué no regresar, al menos provisionalmente, al recuento de estas amigables conversaciones justo para demostrar la utilidad de HAL en esos menesteres tan potencialmente aburridos como inevitables de las tareas burocráticas, ésas de las que echamos pestes, pero que, sin arreglo posible, consumen nuestro precioso tiempo creativo en lo que parece un irrefrenable y pantagruélico festín del papeleo por todos los ámbitos profesionales?

Sí, abandonamos el terreno de las aplicaciones, lo dejamos pendiente hasta mejor ver, para adentrarnos un poco más en el de la conversación compleja, esto es, la escritura de guiones, cuyo colofón aconteció en esta conversación y en las que la precedieron.

Sin mayor explicación y, sin duda, con brutalidad excesiva, veamos el guión que vamos a obtener a lo largo de los próximos días y su efecto inmediato.

Paciencia. El porqué, el para qué y el cómo se explicarán a su debido tiempo (muy pronto). Pero por un sitio hay que empezar y hacerlo de esta forma tan brusca e inopinada es un manera de comprometer al autor y de evitar que siga enmudecido por tiempo indeterminado.

El guion:


#!/bin/sh

#### Directorios y ficheros
# Directorio que contiene la programación del curso
PROGRAMACION=/home/luis/conservatorio/programacion-loe
# Fichero que contiene la plantilla LaTeX del informe
PLANTILLA=informe_plantilla.tex
# Fichero que contiene las notas de los alumnos
NOTAS=notas
# Fichero sed para limpiar etiquetas LaTeX
NOLATEX=limpiar_tex.sed

#### Datos estáticos (constantes)
# Sufijo de los ficheros de objetivos por cursos
OBJETIVOS=objetivos.tex
# Sufijo de los ficheros de contenidos por cursos
CONTENIDOS=minimos.tex
# La nota mínima para aprobar el curso
NOTA_MINIMA=5

for linea in $(cat $NOTAS)
  do
    if [ $(echo $linea | cut -d':' -f3) -lt $NOTA_MINIMA ] 
    then
      # Nombre y curso del alumno tal como constan en el fichero $NOTAS
      ALUMNO=$(echo $linea | cut -d':' -f1)
      CURSO=$(echo $linea | cut -d':' -f2)

      # Nombre y curso con el formato que tendrán en la salida impresa
      ALUMNO_OUTPUT=$(echo $ALUMNO | sed -e 's/-/ /g')
      CURSO_OUTPUT=$(echo $CURSO | sed -e 's/\([[:digit:]]*\)-\(.*\)/\1\.º \2/' \
                                       -e 's/ge/EE/' \
                                       -e 's/gm/EP/')

      # Ficheros que contienen los objetivos y contenidos del curso
      # en que el alumno está matriculado
      F_OBJETIVOS=${PROGRAMACION}/${CURSO}-$OBJETIVOS
      F_CONTENIDOS=${PROGRAMACION}/${CURSO}-$CONTENIDOS

      # Los objetivos y contenidos en un formato apto para la plantilla
      # a partir de la que se genera el informe
      sed -f $NOLATEX $F_OBJETIVOS > objetivos_tmp.tex
      sed -f $NOLATEX $F_CONTENIDOS > contenidos_tmp.tex

      # Las propuestas de trabajo se deben introducir interactivamente
      echo "Introduzca propuestas de trabajo para $ALUMNO_OUTPUT [\item ... (^D para salir)]: "
      cat > trabajo_tmp.tex

      # Construcción del fichero .tex del informe a partir de la plantilla
      sed -e "s/ALUMNO/$ALUMNO_OUTPUT/" \
          -e "s/CURSO/$CURSO_OUTPUT/" \
          -e 's/OBJETIVOS/\\input{objetivos_tmp}/' \
          -e 's/CONTENIDOS/\\input{contenidos_tmp}/' \
          -e 's/RECUPERACIÓN/\\input{trabajo_tmp}/' $PLANTILLA > ${ALUMNO}.tex

      # Generación del pdf del informe e impresión
      pdflatex ${ALUMNO}.tex > /dev/null
      # okular ${ALUMNO}.pdf 2> /dev/null &
      lp ${ALUMNO}.pdf > /dev/null
    
      # Eliminación del los ficheros temporales creados
      rm *_tmp.tex
      rm $(ls ${ALUMNO}* | grep -v '\.pdf')
    fi
  done

Un fragmento del resultado:

HAL no está mudo

2009-04-18T12:14:00.002+02:00

Sé que tengo (o tenía ;-) ) algunos buenos lectores de las 'Conversaciones con HAL'. Como habrán observado, desde hace más de dos semanas no envío nada, lo que contrasta con el ritmo casi frenético de los meses anteriores.

Bien, la verdad es que ahora dispongo de menos tiempo libre para esto. Lo cual no significa que abandone el proyecto. Seguiré en él, si nada fortuito se opone, pero, por lo pronto, a un ritmo mucho más pausado. Espero, al menos, poder escribir algo antes de que termine este mes.

HAL y crip (II)

2009-04-02T21:30:00.009+02:00

Después de la información sobre el proceso de instalación, el README de crip nos proporciona unas muy breves instrucciones de uso que se completan con un tutorial en la Web al que se remite. No dice nada de las opciones en la línea de órdenes ni de las variables del fichero de configuración.

Las opciones de la orden crip se obtienen, a falta de una página de manual, que sí incluye Debian, ejecutando:

crip --help

lo que da la siguiente lista:


Options:
  -h, --help        Print this help then exit
  -i, --info        Print crip variable information then exit
  -v, --version     Print version of crip then exit
  -e codec          Encode to vorbis or flac (default = vorbis)
  -s media          Specify the source media (default = CD)
  -g genre          Specify the music genre (default = classical)
  -q [on/off]       Classical-style questioning (default = off)
  -m [on/off]       Map European to American-only chars (default = off)
  -t [on/off]       Trim leading/trailing silence (default = off)
  -n [on/off]       Normalize the audio (default = off)
  -V volthresh      Volume threshold for normalizing (default = 1.078)
                       (only used when normalizing is enabled)
  -r [on/off]       Remove files after encoding (default = on)
  -E editor         Editor to use (default = vim)
  -u [on/off/both]  Use editor to name the files (default = on)
                       (as opposed to the command-line)
  -o " flags"       Flags to pass to oggenc (default = '-q 5')
  -f " flags"       Flags to pass to flac (default = '--best --replay-gain')
  -c " flags"       Flags to pass to cdparanoia (default = '-v -z')
  -d device         CDrom device to read from (default = /dev/cdrom)
  -w [on/off]       Skip the ripping (makes empty .wav files) (default = off)
                       (useful if you already have the .wav files to encode)
  -p [on/off]       Prompt to continue after ripping (default = off)
                       (useful pause to edit .wav files before encoding)
  -x [on/off]       Eject CD when done ripping (default = off)
  -P proxyserver    Pass an http proxy to CDDB_get if necessary

Las más interesantes para nosotros ahora son estas dos:

-e: Determina el formato del fichero de audio que vamos a generar. Recibe como argumento vorbis, que producirá un fichero OGG (opción activada por defecto) o flac, que producirá un fichero FLAC)
-m: Convierte los caracteres europeos (letras acentuadas, letras con diéresis, etc) en caracteres sin acentos, diéresis, etc.

En cuanto a las opciones de configuración, el fichero de ejemplo que viene con las fuentes y que copiamos como nuestro .criprc contiene comentarios que describen cada una de ellas con suficiente precisión.

A partir de ahora, solo queda probar el funcionamiento de crip. El tutorial al que se refiere el README no es otra cosa que un ejemplo de un caso de uso. Pero conviene referir aquí un par de ejemplos más y comprobar con explicaciones en castellano el proceder de crip.

El CD elegido contiene dos piezas del compositor contemporáneo Helmut Lachenmann, una para cuarteto de cuerda, interpretada por el Berner Streichquartett y un dúo de guitarras, interpretado por Wilhelm Bruck y Theodor Ross.

En el primer ejemplo, el formato de salida será OGG y utilizaremos la opción -m para convertir los caracteres con umlaut (el mismo signo de nuestro diéresis, que en alemán tiene otra función) en vocales sin umlaut. Ello parece, en principio, necesario, habida cuenta de que el fichero que contiene el nombre de las pistas aparecerá codificado en latin-1 por crip y no en utf-8, con el consiguiente problema que implica en casi todos los sistemas operativos modernos, que están preparados para utf-8, donde tales caracteres aparecerán deformados. Precisamente, la opción -m es la que no funciona en la versión empaquetada con Debian, pero sí en la versión actual. Recuérdese que éste fue el pretexto por el que instalamos crip desde las fuentes.

El primer paso es moverse al directorio donde queremos que se produzca la generación de los ficheros temporales y los ficheros finales de audio. Como disponemos de espacio suficiente en nuestro home, nos desplazaremos al sitio donde acabarán residiendo los ficheros resultantes del proceso:

cd ~/musica/CDs

Y ahora, tras introducir el CD en el lector de CDs, conversaremos con crip:

crip -m

Lo primero que hace crip es devolvernos un mensaje inicial y una información general sobre nuestras actuales opciones de configuración:


crip v3.9 (http://bach.dynet.com/crip)    

   Please report all bugs, feature requests, or
   general difficulties to charlton@dynet.com. 

Options currently set to:
   contact =             
   sourcemedia = CD      
   encodeto = vorbis     
   cddevice = /dev/cdrom 
   settitle = filename   
   editnames = on        
   editor = vim          
   askclassical (default) = off
   skipalbumabv set only for:  classical
   mapeurochars = on
   normalize = off
   trimsilence = off
   delfiles = on
   skiprip = off
   stopgap = off
   ejectcd = off

Ripper: cdparanoia III release 10.2 (September 11, 2008) -v -z
Encoder: oggenc from vorbis-tools 1.2.0  -q 5

Inmediatamente a continuación, y si ya hay ficheros de audio en este directorio, crip nos avisará de ello y nos exigirá que confirmemos el proceso, para evitar sobrescribir ficheros existentes:


You currently have *.wav, *.ogg, *.flac, or *.tag files in the current
working directory.  These are subject to being overwritten.

Press <enter> to proceed (or ctrl-C to abort):

Tras pulsar 'Enter', crip devuelve el resultado de buscar en FreeDB [Nótense los carácteres con umlaut que no han sido correctamente convertidos]:


DiscID:   100b1802
cddbID:   100b1802
artist:   Helmut Lachenmann
title:    Gran Torso - Salut f�r Caudwell
category: classical

total number of tracks: 2
track  1:      182 -    96276  [21:21.25]: Gran Torso (Musik f�r Streichquartett - 1971)
track  2:    96277 -   213184  [25:58.76]: Salut f�r Caudwell (Musik f�r 2 Gitarristen - 1977)

A continuación, crip solicita que introduzcamos, si queremos, los números de pista para cada grupo. Distinguir grupos de pistas hace posible etiquetar cada uno de ellos de forma distinta y aplicarles, uno a uno, ciertas operaciones de manipulación del audio. Esta función es evidentemente interesante en CDs como el nuestro, donde cada obra será ejecutada por intérpretes diferentes. Si no queremos grupos y queremos ripear todas las pistas, respondemos all. Si queremos que cada pista constituya un grupo, respondemos each, pero no podremos etiquetar ciertos campos de cada grupo de forma separada, como el de los intérpretes. En los casos no genéricos, definimos el primer grupo por el número de las pistas que lo constituirán, separados por espacios; el segundo, pulsando 'Enter' y añadiendo en él, de la misma forma, las pistas que le correspondan, etc. Para terminar la generación de grupos se escribe end. Éste es también el camino que se ha de seguir cuando se desea extraer sólo un cierto número de pistas en un solo grupo:


Enter the track numbers for each group (each group will be
replaygained/vorbisgained/normalized,  trimmed,  and tagged
as if it were one piece of music).

Delimit the track numbers on each line by a space.
Type "end" to go on to the next section.

Note that only the tracks you specify will be ripped.
Also note that if you list a track more than once, it will be
unnecessarily ripped more than once (so don't do it).
You can also enter "all" or "each" for grouping all tracks as
one group, or each track as a separate group respectively.
If input is "all" or "each" then the entire CD is ripped.

En nuestro caso, vamos a crear dos grupos, uno por cada pista [Nuestras respuestas a crip se muestran en azul en lo que sigue]:

> 1

> 2

> end

crip nos pida ahora que introduzcamos el género del CD:


Please enter the genre for this album.
Recommended genres are (from freedb.org):
    blues       (self explanatory)
    classical   (self explanatory)
    country     (self explanatory)
    folk        (self explanatory)
    jazz        (self explanatory)
    newage      (self explanatory)
    reggae      (self explanatory)
    rock        (including funk, soul, rap, pop, industrial, metal, etc.)
    soundtrack  (movies, shows)
    data        (ISO9660 and other data CDs)
    misc        (others that do not fit in the above categories)
Enter the genre for this album (single space = null): [classical]:

Pulsamos 'Enter', lo que significa que el género será 'classical'. Téngase en cuenta que se podría poner cualquier género aparte de los sugeridos, aunque no conviene en el caso de que el resultado se vaya a enviar a FreeDB.

La siguiente pregunta es relativa al compositor de la obra:


Since this is classical, there should be a composer.
If the composer is different for each group/list, just set the
value to null and add the composer tag manually with each list.
Enter composer (single space = null): [Helmut Lachenmann]:

El compositor es el mismo para los dos grupos, luego pulsamos 'Enter' y dejamos el que crip ha deducido por nosotros.

A partir de este momento podemos etiquetar por separado cada grupo:


Would you like to set the artist and miscellaneous labeling info for
the whole CD right now, or would you prefer to set it for each list?
(list/cd) [list]:

Pulsamos 'Enter', de forma que la opción list se aplique.

El título del album lo modificaremos para evitar el umlaut no reconocido:


Enter album name (single space = null): [Gran Torso - Salut f�r Caudwell ]: Gran Torso - Salut für Caudwell

Sí interesa consignar el sello discográfico:

Enter label name (single space = null): []: Aurophon

También podemos anotar el número de catálogo del disco. Nosotros lo dejaremos vacío. Esto es pulsaremos 'Enter' a esta pregunta:

Enter label catalog number (single space = null): []:

Con toda esta información básica, crip construye un fichero que contiene los títulos de las dos pistas. Nótese cómo aquí la opción -m ha hecho su efecto y las letras con umlaut han sido sustituidas por letras sin umlaut:


Track/filename labeling section...
Here are the computer-chosen filenames for the tracks that you've picked:
-------------------------------------------------------------------------------
Lachenmann_-_Gran_Torso_(Musik_fur_Streichquartett_-_1971)

Lachenmann_-_Salut_fur_Caudwell_(Musik_fur_2_Gitarristen_-_1977)

Edit the above filenames? [yes]:

Adviértase también que crip nos obliga a editar el fichero, aunque no vayamos a cambiar nada. Pulsamos 'Enter', que abrirá vim y en vim tecleamos :q para salir, y, de nuevo 'Enter' a esta nueva pregunta de confirmación:

Edit the above filenames? [no]:

La siguiente pregunta se refiere al director del primer grupo de pistas:


Enter conductor.  If there isn't one, enter null.
 (single space = null): [Helmut Lachenmann]:

Puesto que el CD es de música de cámara, no tiene director. Luego debemos pulsar espacio seguido de 'Enter'.

En la pregunta sobre los intérpretes sí tenemos que intervenir:


Since there is no conductor,  there's probably a (main) performer.
Enter this performer (single space = null): [Helmut Lachenmann]:Berner Streichquartett

También anotaremos la fecha de producción del CD:


Enter the date of recording (single space = null): [don't put one]: (P) 1991

Ahora, crip nos ofrece la posibilidad de seguir añadiendo etiquetas. Nosotros pulsaremos 'Enter' y seguiremos adelante:


Type the name of a field tag that you'd like to add to
 all these music files (or make up your own field tag name).
You can enter the fieldname then enter the data for that fieldname,
or you can enter fieldname=data all on one line.

Possible tag recommendations:
  conductor  ensemble  opus
  location  performer  copyright  license

Just press <enter> (with nothing on the line) to finish:

A continuación, crip nos vuelve a repetir las mismas preguntas sobre director e intérpretes del grupo siguiente. Pulsamos 'Enter' en la primera y cumplimentamos adecuadamente la segunda:


Enter conductor.  If there isn't one, enter null.
 (single space = null): []:
Since there is no conductor,  there's probably a (main) performer.
If this is true,  enter this performer (single space = null): [Berner Streichquartett]: W. Bruck - Th. Ross

Las preguntas subsiguientes sobre fecha de producción y creación de más etiquetas se responden como antes.

Por fin, llegamos al final:

Just press <enter> (with nothing on the line) to finish:

Tras pulsar 'Enter', crip nos da un sumario del resultado y nos pregunta si queremos reeditar lo ya anotado para alguna de las pistas, enviar la información cumplimentada a FreeDB o comenzar a ripear:


01: Lachenmann_-_Gran_Torso_(Musik_fur_Streichquartett_-_1971)
title=Gran Torso (Musik fur Streichquartett - 1971)
artist=Berner Streichquartett
composer=Helmut Lachenmann
performer=Berner Streichquartett
date=(P) 1991
album=Gran Torso - Salut für Caudwell
tracknumber=01
genre=classical


02: Lachenmann_-_Salut_fur_Caudwell_(Musik_fur_2_Gitarristen_-_1977)
title=Salut fur Caudwell (Musik fur 2 Gitarristen - 1977)
artist=W. Bruck - Th. Ross
composer=Helmut Lachenmann
performer=W. Bruck - Th. Ross
date=(P) 1991
album=Gran Torso - Salut für Caudwell
tracknumber=02
genre=classical



Look at the above tags and make sure they are all okay.
You can edit any of these tag files by entering the track number.
You can also enter "submit" to submit this data to the freedb
CDDB database or just press <enter> by itself to go directly to
the ripping process!  (or press ctrl-C to abort everything).
Enter track number, submit, or just press  to Rip! :

Aquí pulsaremos 'Enter', nos tomamos un café y esperamos a que crip realice la extracción y codificación del los ficheros de audio.

El siguiente ejemplo sobre el mismo disco no conlleva ninguna novedad, salvo por el hecho de que los ficheros resultantes se codificarán como FLAC y que nos la jugaremos con los caracteres europeos:

crip -e flac

¿Cómo evitar el problema de crip con utf-8? Existe un truco. A la hora editar el fichero de los nombres de pistas con vim, ejecutamos desde dentro de vim la orden :set fileencoding=utf-8 y luego guardamos el fichero y salimos con :wq. Sí, es un hack rápido, pero es el único medio que hemos descubierto para salvar las apariencias, preservando los carácteres europeos y sin tratar de tocar el código de crip. Este truco funciona también con la versión empaquetada en Debian. Luego, quien no quiera pasar por la instalación desde las fuentes, podrá usar crip, y sin el problema de los caracteres europeos, instalando el paquete de Debian del mismo nombre.

Tengan feliz escucha.

HAL y crip (I - Instalar las fuentes)

2009-04-01T16:26:00.008+02:00

abcde es más que suficiente para la mayoría de los usuarios y la mayoría de las funciones. No obstante, los acérrimos de la música clásica pueden preferir etiquetar sus CDs de un modo más flexible, pero de forma sencilla y sin necesidad de recurrir a herramientas externas, aunque tengan que consumir para ello algo más de tiempo en la línea de órdenes. crip quiere cubrir esa laguna. Se trata de un guión escrito en el lenguaje Perl, menos elaborado, quizá, y con menos opciones globales que abcde, pero especialmente indicado para el caso que comentamos.

Nos va a servir además para enfrentarnos por primera vez ---si bien en un ejemplo muy simple--- a la instalación de un programa desde las fuentes, es decir, para acometer la instalación del código tal cual ha sido distribuido por el programador, sin acudir al paquete que nuestra distribución ha creado para ese código. Que escojamos este procedimiento tiene, claro está, fines didácticos , pero también obedece al hecho de que la versión de crip empaquetada a día de hoy por Debian (la 3.7) contiene un error que ya ha sido resuelto en la versión original más reciente. Lo normal es que nunca acudamos a esta vía. Es más, lo normal es que cuando la instalación directa a partir del código fuente es la única vía posible ---no es el caso aquí, como veremos más tarde---, nos decidamos por otro programa alternativo. En este momento, como de lo que se trata es de aprender, seguiremos la "senda escarpada".

Lo primero que hay que hacer para instalar un programa desde la fuente es, obviamente, conseguir el código fuente y guardarlo en nuestro ordenador. La última versión de crip se puede obtener visitando la página siguiente:

http://bach.dynet.com/crip/download.html

La versión más reciente a día de hoy es la 3.9. Podemos descargarla directamente acudiendo a HAL, por ejemplo, dentro de un directorio, src (de source, fuente) que crearemos expresamente para guardar todos los archivos fuentes de los programas que instalemos a mano. Construiremos ese directorio, ingresaremos en él y descargaremos ahí el archivo que contiene el código fuente, las tres operaciones en un solo paso:

mkdir src ; cd src ; wget http://bach.dynet.com/crip/src/crip-3.9.tar.gz

Los puntos y comas (;) entre cada orden indican a HAL que las procese una tras otra. El resultado es el mismo que ejecutarlas por separado.

El fichero guardado, crip-3.9.tar.gz es un fichero comprimido. Pero no es un fichero cualquiera. Se trata de un archivo que engloba un directorio completo con sus correspondientes ficheros. Un fichero tar es uno de los más frecuentes tipos de ficheros de esta clase, comunes para archivar y distribuir fácilmente directorios completos. Para crear ficheros tar o para desarchivarlos (extraer su contenido) se utiliza la orden del mismo nombre tar. Por ejemplo, podemos pedirle a HAL que extraiga (--extract) y a la vez descomprima con gunzip (--gunzip) el fichero (--file) crip-3.9.tar.gz, y que se explaye sin miedo para informarnos de cómo transcurre la operación (--verbose):

tar --extract --gunzip --verbose --file crip-3.9.tar.gz

Pero nunca se ha visto a nadie dirigirse tan ceremoniosamente a HAL. En lugar de ello, se utilizan las respectivas opciones abreviadas:

tar -x -z -v -f crip-3.9.tar.gz

Y ni siquiera eso, porque cuando hay varias opciones abreviadas, se prefiere unirlas en un solo taco:

tar -xzvf crip-3.9.tar.gz

HAL nos informa como hemos solicitado:


crip-3.9/
crip-3.9/TODO
crip-3.9/crip
crip-3.9/LICENSE
crip-3.9/README
crip-3.9/editcomment
crip-3.9/CDDB_get.pm
crip-3.9/criprc_example
crip-3.9/editfilenames
crip-3.9/Changelog

¿Qué son todos estos ficheros contenidos en el archivo que el desarrollador de crip tiene la amabilidad de poner a nuestra disposición? El primero es, evidentemente, el propio directorio crip-3.9. ¿Y los ficheros de los que consta? Nada más fácil que preguntárselo a HAL:

file crip-3.9/*

que devuelve la información que buscamos:


crip-3.9/CDDB_get.pm:    Perl5 module source text
crip-3.9/Changelog:      UTF-8 Unicode English text
crip-3.9/crip:           a /usr/bin/perl script text executable
crip-3.9/criprc_example: ASCII English text
crip-3.9/editcomment:    a /usr/bin/perl script text executable
crip-3.9/editfilenames:  a /usr/bin/perl script text executable
crip-3.9/LICENSE:        ASCII English text
crip-3.9/README:         ASCII English text
crip-3.9/TODO:           ASCII English text

El asterisco (*) tras el nombre del directorio en la orden file es un comodín que vale por todos y cada una de los ficheros contenidos en crip-3.9. Probablemente empecemos a usarlo más veces a partir de ahora.

Bien, tenemos unos cuantos ficheros que contienen texto en ingles (en codificación ASCII o UTF-8, eso es secundario aquí) y cuatro más escritos en Perl. Estos últimos son el código fuente propiamente dicho y veremos qué hacer con ellos dentro de un momento. Los ficheros en inglés son documentos informativos sobre el programa. Aun sin leer su contenido, cualquiera que esté familiarizado con archivos de fuentes de programas sabe de qué van, porque sus nombres son convencionalmente usados por los programadores para documentar el código que distribuyen:

README: Proporciona informaciones básicas para manejar el programa. Es el fichero que hay que leer en primer lugar.
LICENSE: Describe la licencia bajo la que se distribuye el código. En este caso es GPL. Lo que significa que el código puede modificarse libremente y distribuirse si se mantiene la misma licencia.
TODO: Una lista de las tareas que el programador considera pendientes y que tal vez cumpla en futuras revisiones del código o espera que cumplan posibles colaboradores.
Changelog: Una lista de las características implementadas en cada versión del código hasta ahora realizada y de los errores (bugs) corregidos
criprc-example: Un ejemplo de fichero de configuración para el programa. Recuérdese que nos hemos encontrado ya con varios ficheros de configuración y que el nombre de muchos de ellos se construye con el sufijo rc (de resource) añadido al nombre del programa.

Leamos el fichero README ---se presupone que el lector hace ahora un less crip-3.9/README--- para conocer de qué va la historia. Vemos que contiene instrucciones de instalación y de uso.

Empecemos por la instalación. Lo primero que se nos indica es el software con el que nuestro sistema debe contar para que crip funcione. Casi todas los programas requeridos son conocidos nuestros, los artesanos del sonido que comentamos hace unos días (cdparanoia, oggenc, flac, vorbiscomment y vorbisgain), de sox, otro experto en sonido, podemos prescindir ahora. perl está instalado a buen seguro. Si instalamos abcde, se instalaron muchos de los programas anteriores. Pero no vamos a dar nada por hecho. Trataremos de ver qué paquetes de Debian contienen el software necesario e instalaremos dichos paquetes ---sí, no procederemos a instalarlos desde las fuentes, el lector puede respirar tranquilo.

Como sabemos, aptitude nos permite buscar paquetes que cumplan ciertas funciones, pero lo que ahora necesitamos es algo sustancialmente distinto, queremos conocer en qué paquete de Debian está contenido un determinado programa. Para ello existe la herramienta apt-file, incluida en el paquete del mismo nombre, que se puede instalar como cualquier otro paquete:

aptitude install apt-file

El funcionamiento básico de apt-file es muy sencillo. Los almacenes de paquetes Debian incluyen un fichero comprimido donde se describe el contenido de todos los paquetes allí almacenados. Éste es el fichero que apt-file procesará. Lo primero, por tanto, es tener en nuestro ordenador una copia actualizada suya. Para ello debemos disfrazarnos de root, es decir que previamente hay que hacer su o prefijar la orden siguiente con sudo, dependiendo de nuestro sistema:

apt-file update

Una vez descargado el fichero de contenidos de los paquetes, podemos buscar en él qué paquete o paquetes contiene cada programa u orden que crip define como requisito previo. Por ejemplo:

apt-file cdparanoia

que devuelve:


cdparanoia: /usr/bin/cdparanoia
cdparanoia: /usr/share/doc/cdparanoia/README.gz
cdparanoia: /usr/share/doc/cdparanoia/changelog.Debian.gz
cdparanoia: /usr/share/doc/cdparanoia/copyright
cdparanoia: /usr/share/man/ja/man1/cdparanoia.1.gz
cdparanoia: /usr/share/man/man1/cdparanoia.1.gz
cdparanoia-dbg: /usr/lib/debug/usr/bin/cdparanoia
cdparanoia-dbg: /usr/share/doc/cdparanoia-dbg/changelog.Debian.gz
cdparanoia-dbg: /usr/share/doc/cdparanoia-dbg/copyright
gstreamer0.10-plugins-base: /usr/lib/gstreamer-0.10/libgstcdparanoia.so
gstreamer0.10-plugins-base-dbg: /usr/lib/debug/usr/lib/gstreamer-0.10/libgstcdparanoia.so
gstreamer0.10-plugins-base-doc: /usr/share/gtk-doc/html/gst-plugins-base-plugins-0.10/gst-plugins-base-plugins-cdparanoiasrc.html
gstreamer0.10-plugins-base-doc: /usr/share/gtk-doc/html/gst-plugins-base-plugins-0.10/gst-plugins-base-plugins-plugin-cdparanoia.html
libcdparanoia-dev: /usr/share/doc/libcdparanoia-dev/changelog.Debian.gz
libcdparanoia-dev: /usr/share/doc/libcdparanoia-dev/copyright
libcdparanoia0: /usr/share/doc/libcdparanoia0/README.gz
libcdparanoia0: /usr/share/doc/libcdparanoia0/changelog.Debian.gz
libcdparanoia0: /usr/share/doc/libcdparanoia0/copyright
libcdparanoia0: /usr/share/lintian/overrides/libcdparanoia0
libk3b-dev: /usr/include/kde/k3bcdparanoialib.h
libtritonus-bin: /usr/lib/jni/libtritonuscdparanoia.so
libtritonus-bin: /usr/lib/jni/libtritonuscdparanoia.so.1
libtritonus-bin: /usr/lib/jni/libtritonuscdparanoia.so.1.0
manpages-ko: /usr/share/man/ko/man1/cdparanoia.1.gz
ripperx: /usr/lib/ripperx/ripperX_plugin-cdparanoia
soundkonverter: /usr/share/apps/soundkonverter/plugins/320.cdparanoia.soundkonverter.xml

Demasiada información. Es preciso filtrarla. Como ya indicamos hace bastante, los programas u órdenes no son sino ficheros ejecutables, lo que significa que se instalarán en un directorio de ejecutables como bin o sbin. Para los artesanos del sonido, podemos descartar la última opción (sbin), dado que, a todas luces, se trata de órdenes o programas de usuario. Y, puesto que son ficheros que no contienen programas para administrar el sistema, debemos suponer que, a buen seguro, formarán parte del directorio /usr/bin. En la descripción del contenido de los paquetes que suministra apt-file aparece, como acabamos de comprobar, el nombre del paquete como primer campo y la ruta del fichero como segundo campo, separados ambos campos por dos puntos y espacio. En consecuencia, podemos realizar una búsqueda con apt-file search y filtrar el resultado con grep:

apt-file search cdparanoia | grep -E ':[[:space:]]+/usr/bin'

La respuesta ahora es unívoca y suficiente:

cdparanoia: /usr/bin/cdparanoia

Si ejecutamos dicha búsqueda para todos las órdenes o programas que requiere crip obtendríamos la siguiente información:


cdparanoia: /usr/bin/cdparanoia
vorbis-tools: /usr/bin/oggenc
flac: /usr/bin/flac
flac: /usr/bin/metaflac
vorbis-tools: /usr/bin/vorbiscomment
vorbisgain: /usr/bin/vorbisgain

Por cierto, no es necesario ejecutar apt-file search nombre_programa para cada uno de los programas en los que estamos interesados, se puede hacer de una sola vez con una orden algo compleja, cuyo sentido no se ha explicado todavía, pero que deberemos considerar despacio en algún otro momento:


for file in cdparanoia oggenc flac vorbiscomment vorbisgain; \
do apt-file search $file | grep -E ':[[:space:]]+/usr/bin'; \
done

Podríamos incluso filtrar el resultado de esta orden para que nos devolviese únicamente el primer campo (el nombre del paquete) y suprimiese las repeticiones:


for file in cdparanoia oggenc flac vorbiscomment vorbisgain; \
do apt-file search $file | grep -E ':[[:space:]]+/usr/bin'; \
done \
| cut -d':' -f1 | uniq

Y ya que estamos, podemos enviar el resultado final como lista de argumentos para aptitude, de forma aptitude proceda automáticamente a la instalación de los paquetes correspondientes:


aptitude -s install \
$(for file in cdparanoia oggenc flac vorbiscomment vorbisgain; \
do apt-file search $file | grep -E ':[[:space:]]+/usr/bin'; \
done \
| cut -d':' -f1 | uniq)

¡Eh! ¿qué tal este inopinado reencuentro con nuestros cachivaches de fontanería?

El lector atento habrá notado en la anterior orden una opción extraña para aptitude, la opción -s. Esta opción hace que aptitude simule su comportamiento habitual, sin provocar ningún cambio en nuestro sistema de paquetes. La puede ejecutar cualquier usuario, no hace falta ser root. Es muy recomendable aplicarla antes de proceder a una instalación real, especialmente en casos como el anterior, donde los paquetes que se instalarán son la salida de una orden compleja.

Si ejecutamos como root, y sin la opción -s, la orden citada, se instalarán todos los programas que crip exige para funcionar y que no existen ya en nuestro sistema.

Preparada la infraestructura para crip, continuamos nuestra lectura de su fichero README. Ahí se nos informa del siguiente paso: copiar CDDB_get.pm a algún sitio donde nuestro intérprete del lenguaje Perl pueda encontrarlo. Se nos propone, como opción, copiarlo bajo /usr/lib/perl5/. No vamos a seguir, sin embargo, esta recomendación. La razón es que no es conveniente mezclar ficheros instalados a mano en los directorios que nuestra distribución utiliza para instalar el contenido de los paquetes. Los directorios /usr/bin, /usr/lib, etc. son directorios que debe manejar exclusivamente nuestra distribución. Todas las distribuciones de Linux ofrecen la posibilidad de directorios semejantes a los anteriores para un caso como el nuestro, es decir, para cuando instalamos software desde las fuentes. El directorio típico que existe con este fin es /usr/local. Es ahí donde debemos ubicar el software instalado a mano.

CDDB_get.pm es, como nos notificó file anteriormente, un módulo de Perl, es decir, un conjunto de funcionalidades que pueden usar distintos programas escritos en Perl. Se almacenan normalmente en el directorio /lib/perl/versión, donde versión es el número de versión de nuestra infraestructura Perl. En mi sistema es el 5.10.0. Por tanto, debemos crear como root ese subdirectorio en nuestro /usr/local y copiar allí el fichero CDDB_get.pm:

mkdir -p /usr/local/lib/perl/5.10.0/

La opción -p de mkdir permite crear no sólo el directorio 5.10.0, sino todos los directorios padre bajo /usr/local que todavía no existan. En nuestro caso, tiene el mismo efecto que estas dos órdenes:


mkdir /usr/local/lib/perl
mkdir /usr/local/lib/perl/5.10.0

Ahora copiamos, también como root el fichero CDDB_get.pm en el directorio recién creado:

cp crip-3.9/CDDB_get.pm /usr/local/lib/perl/5.10.0

Finalmente, y si seguimos las instrucciones del README, sólo falta copiar el fichero de configuración criprc_example como nuestro ~/.criprc:

cp crip-3.9/criprc_example ~/.criprc

Con esto sería suficiente para hacer funcionar crip. Sin embargo, tendríamos que llamar con su ruta completa a crip (~/tmp/crip-3.9/crip) cada vez que quisiéramos ejecutarlo. Como esto es incomodo, es mejor disponer los ficheros ejecutables de las fuentes en un ruta que esté en nuestro PATH. Qué mejor que en /usr/local/bin. Las fuentes constan de varios ejecutables, como nos informó file. Tales ficheros no son sino órdenes escritas en lenguaje Perl y son, para el caso que nos ocupa los siguientes:


crip
editcomment
editfilenames

Copiémoslos en /usr/local/bin

cd crip-3.9 ; cp crip editcomment editfilenames /usr/local/bin

Tarea finalizada. Cabe añadir que, en el caso de que se quiera en el futuro recurrir al paquete crip de Debian, habría que asegurarse de que no queda rastro de los ficheros instalados en /usr/local. Es decir, habría que disfrazarse de root y ejecutar las siguientes órdenes:


rm /usr/local/lib/perl/5.10.0/CDDB_get.pm
rm /usr/local/bin/crip
rm /usr/local/bin/editcomment
rm /usr/local/bin/editfilenames

¿Alguien se atreve a escribir el mini guión desinstalar_crip_local para realizar esta operación de desinstalación? Fácil, ¿no?

Si el lector ha llegado hasta aquí sin tropiezos se puede considerar afortunado. Acaba de ingresar en el reducido grupo de usuarios de a pie que todavía tiene el coraje de instalar un programa desde la fuente misma. En los gloriosos y aguerridos días en que las distribuciones de GNU/Linux no eran tantas ni tan bien pertrechadas, era una práctica habitual. Hoy en día sólo los usuarios avanzados y, por supuesto, los programadores, se atreven con estos retos, que, por lo que se ha visto, no son tan duros como los pintan, al menos para casos tan simples como el de crip.

Resumen

Los puntos y coma (;) como separadores de órdenes en la línea de órdenes, permiten ejecutar secuencialmente las órdenes separadas por ellos.

El asterisco (*), cuando está fuera de una expresión regular, funciona como un comodín que está por cualquier cadena de caracteres. Es frecuente su uso como abreviatura de nombres de ficheros.

Un fichero tar es un tipo de fichero que sirve para archivar varios ficheros, incluidos subdirectorios. La orden tar permite crear tales clases de ficheros o extraer el contenido de dichos ficheros.

Cuando una orden recibe varias opciones es frecuente agruparlas en un único bloque. Por ejemplo, tar -x -z -v -f fichero se abrevia habitualmente con tar -xzvf fichero

Las fuentes de un programa suelen incluir ficheros de documentación con nombres convencionales: README, que proporciona información importante que hay que leer en primer lugar; LICENSE, que indica la licencia bajo la que se distribuye; TODO, que lista las tareas pendientes; Changelog, que informa de los cambios realizados en cada versión.

Los ficheros de configuración de un programa suelen terminar con el sufijo rc añadido al nombre del programa. Por ejemplo, bashrc, vimrc, criprc.

La orden apt-file permite buscar ficheros en el contenido de los paquetes Debian.

Por defecto, la orden uniq devuelve su entrada omitiendo las líneas repetidas.

La opción -s de aptitude permite simular el comportamiento de aptitude sin producir ninguna modificación en el sistema.

/usr/local es el directorio recomendado para ubicar software instalado manualmente por el usuario.

HAL y abcde

2009-03-31T01:15:00.004+02:00

abcde no es otra cosa que un guión escrito en lengua de HAL para establecer comunicación con los expertos del estilo de los citados el día pasado, sin necesidad de que nosotros mismos tengamos que tratar personalmente con cada uno de ellos.

El uso básico de abcde es tan simple que da casi apuro referirlo:

Instalar abcde, que instalará de paso todos los expertos a los va a recurrir y que no estén ya integrados en nuestro sistema:
```
    aptitude install abcde
```
Introducir el CD de audio en el lector de CDs.

Teclear en el terminal simplemente:
```
    abcde
```

Por defecto, abcde se ejecutará en modo interactivo. Es decir, nos hará ciertas preguntas sobre el contenido del CD. Veamos cómo funciona sobre un disco del célebre saxofonista Ben Webster.

Tras introducir el CD en el lector de CDs y ejecutar abcde veremos el siguiente mensaje, en el que se muestra información sobre el número de pistas del CD que se grabarán:


Grabbing entire CD - tracks: 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18

Inmediatamente después, abcde realiza una búsqueda sobre la base de datos de FreeDB y devuelve la información allí contenida sobre nuestro CD:


Retrieving 1 CDDB match...done.                                                   
---- Ben Webster / Jazz & Blues 26 ----                                           
1: Randle's Island                                                                
2: Old Folks                                                                      
3: King's Riff                                                                    
4: You're my Thrill                                                               
5: Jive at Six                                                                    
6: Tenderly                                                                       
7: Don't get around much any more                                                 
8: Pennies from heaven                                                            
9: That's all                                                                     
10: Cotton tail                                                                   
11: Danny boy                                                                     
12: Bouce blues                                                                   
13: Hoot                                                                          
14: Pouting                                                                                   
15: The iron Man                                                                              
16: Honeysuckle rose                                                                          
17: Blue skies                                                                                
18: Kat's fur

Tras ello nos pregunta si queremos editar dicha información o nos basta con la que FreeDB proporciona:

Edit selected CDDB data? [y/n] (n):

Como no hace falta editar nada, respondemos "no", esto es, pulsamos 'Enter' o 'n' y seguimos adelante.

abcde nos pregunta a continuación si son varios los artistas (en este caso, intérpretes) de la música grabada:

Is the CD multi-artist? [y/n] (n):

El artista principal es Ben Webster y así lo dejaremos, luego seguimos adelante, pulsando 'Enter' o 'n'.

A partir de este momento comienza el proceso de extracción de las pistas por medio de cdparanoia. Para cada pista extraída abcde nos devuelve un mensaje de este tipo:


Grabbing track 01: Randle's Island...                                                         
cdparanoia III release 10.2 (September 11, 2008)                                              
                                                                                              
Ripping from sector       0 (track  1 [0:00.00])                                              
          to sector   14534 (track  1 [3:13.59])                                              
                                                                                              
outputting to /home/luis/abcde.170dd912/track01.wav                                           
                                                                                              
 (== PROGRESS == [                      | 014534 00 ] == :^D * ==)                    
                                                                                              
Done.

Aquí, simplemente, abcde nos notifica la extracción de la primera pista que se guardará temporalmente en disco en formato WAV en el directorio /home/luis/abcde.170dd912. Este directorio se crea bajo nuestro home y será eliminado al terminar el proceso. Para la operación de extracción, abcde recurre a cdparanoia. De hecho, los mensajes relativos a la extracción los produce cdparanoia. Especialmente interesante es el mensaje de progreso. A la derecha de dicho mensaje van apareciendo indicaciones semejantes a los smileys o emoticones que se usan en comunicaciones electrónicas. La lista de los smylies que utiliza cdparanoia y de sus significados se puede consultar en la sección 'Output Smilies' de la página de manual de cdparanoia. Puede ser necesario acudir a ella en el caso infrecuente de que surjan problemas en el proceso.

Simultáneamente y para cada pista, abcde codifica, por defecto en formato OGG vía oggenc, los ficheros WAV extraídos, los etiqueta y los guarda en un directorio con un nombre adecuado, en el caso presente Ben_Webster-Jazz_&_Blues_26. El nombre de los ficheros OGG coincide con el nombre de cada pista en la información obtenida por FreeDB. Por ejemplo, el primer fichero, que corresponde a la primera pista del CD de Ben Webster, quedó guardado con el nombre 01.Randles_Island.ogg.

El mensaje final es el informe que devuelve oggenc sobre el proceso de codificación, encubierto hasta ese momento por los mensajes devueltos por cdparanoia, donde consta la calidad, por defecto 3.00 ---a mayor número, mayor calidad y menor compresión---, del fichero OGG resultante y algunos datos estadísticos sobre el proceso de codificación. A ello se añade la notificación de la operación de etiquetado:


Encoding track 18 of 18: Kat's fur...
Opening with wav module: WAV file reader
Encoding "/home/luis/abcde.170dd912/track18.wav" to 
         "/home/luis/abcde.170dd912/track18.ogg"    
at quality 3,00                                     
        [ 99,8%] [ 0m00s remaining] -               

Done encoding file "/home/luis/abcde.170dd912/track18.ogg"

        File length:  2m 59,0s
        Elapsed time: 0m 09,6s
        Rate:         18,7143 
        Average bitrate: 97,3 kb/s

Tagging track 18 of 18: Kat's fur...

La ventaja de una sesión interactiva como la descrita es que podemos intervenir en la edición de las etiquetas del CD y sus pistas. Si queremos lo contrario, es decir, que abcde acepte las respuestas por defecto (los "no" anteriores) y actúe sin nuestra intervención, basta añadir la opción -N:

abcde -N

Si en lugar de un fichero OGG, deseamos un fichero FLAC como resultado del proceso, se utiliza la opción -o:

abcde -o flac

Si queremos grabar sólo algunas pistas y no todas, por ejemplo las tres primeras y la última:

abcde 1-3,18

En general, abcde, como casi toda orden de HAL, permite modificar su comportamiento por defecto o especificar más claramente nuestros intereses del momento a través de una amplia gama de opciones. Cuando estas opciones van a ser siempre las mismas, también permite definir variables de configuración a nivel de todo el sistema o para cada usuario en particular. En el primer caso el valor de las variables afectadas se especifica en el fichero de configuración /etc/abcde.conf; en el segundo, en el fichero de configuración de usuario ~/.abcde.conf. Tanto las opciones de línea de órdenes como las variables de configuración vienen suficientemente explicadas en la página de manual de abcde.

Pongamos, para terminar, un ejemplo de fichero de configuración de usuario (~/.abcde.conf), donde consten unas pocas de esas variables. El lector puede indagar y experimentar por su cuenta con otras.


# El formato de recuperación de la información de FreeDB sera UTF-8
CDDBPROTO=6

# Los números de las pistas serán 01, 02, ..., en lugar de 1, 2, ...
PADTRACKS="y"

# La calidad del fichero ogg resultante será de 4 (ver man oggenc)
OGGENCOPTS="-q 4"

# La compresión del fichero flac será la máxima posible (ver man flac)
FLACOPTS="--best"

# El resultado de la extracción se guardará en mi directorio de musica de CDs
# [Cada usuario debe poner aquí su nombre de usuario después de home]
OUTPUTDIR="/home/luis/musica/CDs/abcde"

# El CD se expulsará automáticamente cuando el proceso termine
EJECTCD="y"

HAL y mis CDs

2009-03-30T13:14:00.005+02:00

Si tuviéramos que citar los ámbitos donde el uso de los ordenadores ha transformado nuestro paisaje cotidiano, no podríamos dejar de mencionar el de las aplicaciones de audio y, en concreto, la disponibilidad en formatos de tamaño reducido de la información que anteriormente se distribuía en CDs y que ha permitido la eclosión de los reproductores portátiles de audio, ésos que el lego conoce con el equívoco nombre de "Mp3".

HAL cuenta con un vasto equipo de colaboradores dispuestos a devorar nuestros CDs y convertir la información musical allí guardada en otra más manejable y transportable, así como para reproducirla a nuestro antojo. Durante unos días vamos a dedicarnos a descubrir alguno de ellos. No vaya a ser que luego nos recriminen que HAL está bien para las cosas de la Edad de Piedra, pero no para las innovaciones que el pegadizo ritmo del presente impone. De hecho, alguno de tales colaboradores, en particular, los que bregan en la zona más profunda e ingrata de la fábrica musical, son los auténticos responsables de que nuestras aplicaciones, también las del entorno gráfico, funcionen como lo hacen.

¿Por dónde empezar? Quizá lo primero de todo es aclararse con algunos términos y algunos conceptos en boga, que están en boca de todos y que no pocas veces se utilizan sin saber lo que significan, aunque sea aproximadamente. Los procesos implicados en el procesamiento del audio digital son complejos y es absurdo tratar de comprenderlos sin poseer un bagaje técnico y científico importante. Pero sí es posible, al menos, descender hasta un nivel de abstracción suficientemente alto como para no tener que detenerse en las minucias.

Las típicas aplicaciones para guardar el contenido de un CD de audio en la zona de almacenamiento de un dispositivo como un ordenador personal o un reproductor de audio portátil se denominan aplicaciones de ripping, palabra inglesa que popularmente se ha españolizado como "ripeo". En este proceso están implicadas normalmente varias operaciones diferentes:

La extracción del contenido del CD (el "ripeo" en sentido estricto).

Este contenido, que en el CD se distribuye en bloques de datos, las conocidas "pistas" (tracks), se convierte en un formato lo más fiel posible al del propio CD, esto es, sin pérdida de datos y sin compresión. El formato habitual en la actualidad es WAV.

La codificación de la información extraída.

Puesto que WAV o similares ocupan mucho espacio, se han creado sistemas (algoritmos) para comprimir la información contenida en ellos. La reducción del tamaño puede o no implicar pérdida de datos respecto del original. Cuando no hay pérdida, la reconstrucción de la información original es exacta; cuando la hay, es sólo aproximada, lo suficientemente aproximada como para que el oyente no profesional apenas perciba diferencia. Los formatos que suponen pérdida tienen la ventaja de ocupar menos espacio y por eso se han impuesto a gran escala con la llegada de los reproductores de audio portátiles. MP3 es uno de estos formatos comprimidos con pérdida de datos, pero no es ni el único ni el mejor. En el universo de HAL se deberían usar formatos abiertos y libres de patentes, como Ogg Vorbis (OGG, para abreviar), que, además y en general, se considera, de mayor calidad que MP3. En el mundo profesional, o cuando el oyente es muy exigente y goza de espacio suficiente en disco, se suelen preferir formatos comprimidos sin pérdida de datos, como FLAC.

El etiquetado de la información extraída y codificada.

Sería muy pesado reconstruir la información del CD al transferir su contenido al ordenador, es decir, restablecer los títulos de las pistas, el intérprete, etc. Con ese fin se han desarrollado, entre otras opciones, bases de datos que contienen esa información y que son accesibles por Internet. Cuando la información no está disponible, el usuario puede rellenarla y enviarla al sitio web que aloja la base de datos para su recuperación posterior por parte de otros usuarios. Hoy en día, las bases de datos que utilizan los usuarios de GNU/Linux ---y deben utilizar, por razones de libertad de la licencia--- son FreeDB y MusicBrainz.

Dando por sentado que el lector va a codificar sus CDs con OGG o FLAC podemos referir algunos de los más conocidos colaboradores de HAL responsables en la actualidad de realizar las tareas antes descritas:

cdparanoia: Extracción de audio
oggenc: Codificación a formato OGG
flac: Codificación a formato FLAC
vorbiscomment: Etiquetado de ficheros OGG
metaflac: Etiquetado de ficheros FLAC
sox, vorbisgain: Otras herramientas para manipulación especializada de ficheros de audio.

No vamos a pararnos a dialogar con estos esforzados expertos, y no por falta de interés ---el autor se ha tenido que morder los labios para no hacerlo---, sino por falta de tiempo, del tiempo del lector que, seguramente, querrá entrar en materia cuanto antes de la mano de interfaces menos austeras o, si se quiere, de mecanismos de comunicación que nos permitan enviar una solicitud única para que los artesanos del sonido intervengan por turnos cuando corresponda. Estas interfaces son lo que popularmente se tiene en mente cuando se habla de aplicaciones de extracción o "ripeo" de CDs.

Tras esta introducción inicial podremos empezar a hablar con alguna de ellas. Comenzaremos por abcde (a better CD encoder = un mejor codificador de CDs) y seguiremos con crip. Eso será el próximo día.

HAL y las marcas (Markdown y Pandoc)

2009-03-24T17:26:00.006+01:00

No es improbable que el lector impaciente se canse de tanta marca y decida seguir trabajando con los medios que ya conoce, que no son otros que los omnipresentes procesadores de textos. Dirá que ya le costó lo suyo desenvolverse en los complejos menús del procesador como para ponerse ahora a cambiar toda su forma de escritura por unos enigmáticos "códigos" más que difíciles de teclear y peores de aprender. Insistirá en que para la Web le bastan los formularios de su plataforma de blogging, con sus perfectas barras de herramientas, tan estupendamente semejantes a las de los procesadores de texto. Concederá, finalmente, con inconfesada ironía, que el resultado con LaTeX es sorprendentemente bonito, pero total, para la cuatro cosas que va a escribir...

Estos son los argumentos habituales que esgrimen los usuarios que podríamos calificar propiamente y sin intención ofensiva alguna como usuarios "esclavos", pues es esclavo quien permanece completamente atado a la tecnología que, de un modo un otro, le es impuesta, ya porque constituye la corriente dominante, ya porque es la primera que aprendió o, tal vez con mayor probabilidad, por ambas cosas juntas. Tales argumentos no son, en el fondo, más que racionalizaciones pergeñadas con el único fin de continuar encastillado en una posición inamovible.

Ni HTML ni LaTeX son más difíciles de aprender que las innumerables opciones de menú de los procesadores de textos. En realidad, es mucho más natural plantear la tarea de escribir un documento electrónico cuando se establece de antemano una separación clara entre la estructura de su contenido y su forma de presentación.

Podríamos llegar a aceptar que la introducción de las marcas, particularmente en el caso de HTML, mucho más prolijo en esto que LaTeX, puede llegar a ser bastante pesada, si no se dispone de las herramientas que para esta tarea proporcionan editores como Vim o Emacs. Pero, como vamos a ver hoy, hasta este último baluarte de la recalcitrante defensa del procesador de textos, cae ante la presencia de los lenguajes de marcas "ligeros" como Markdown, que es el representante que hemos escogido de entre los muchos existentes.

No hay forma de sostener racionalmente la indiferencia displicente ante los lenguajes de marcas cuando nos hallamos ante caso tan natural como el siguiente:


% Un ejemplo de Markdown
% átopos
% 25 de Marzo de 2009

# Navegación gráfica
Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:

1. Ir al menú "Archivo" del navegador y guardar como texto la página web. (Lo que además implica seleccionar un nombre de fichero y un directorio).
2. Crear en _Vim_ una nueva ventana para editar en ella el documento que acabamos de guardar, mediante la orden `:new ruta_fichero`.

# Navegación desde consola
Si navegamos con _w3m_, y gracias a la interacción entre las aplicaciones de consola, bastaría ejecutar una única acción desde el propio _Vim_, que, además, podríamos abreviar para reproducirla en situaciones semejantes. Veamos cómo.

Con _w3m_ el proceso de convertir una página web en texto es absolutamente elemental: añadir la opción `-dump`. Por ejemplo:

    w3m -dump http://www.w3.org/TR/html401/struct/lists.html

nos devuelve la página dada como argumento, tal cual se presenta en el navegador, pero como puro texto.

Esto ya parece dar gato por libre. ¿Dónde están las marcas? ¿No es éste el texto tal cual lo hubiéramos escrito, de no existir el maravilloso procesador de textos? ¡Menudo avance! ¡Un regreso a las cavernas!

Fíjese bien el lector incrédulo, porque las marcas siguen estando, pero reducidas a su más mínima expresión [El signo ¶ indica un espacio]:


% Un ejemplo de Markdown
% átopos
% 25 de Marzo de 2009

# Navegación gráfica 
Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:

1.¶Ir al menú "Archivo" del navegador y guardar como texto la página web. (Lo que además implica seleccionar un nombre de fichero y un directorio).
2.¶Crear en _Vim_ una nueva ventana para editar en ella el documento que acabamos de guardar, mediante la orden `:new ruta_fichero`. 

# Navegación desde consola
Si navegamos con _w3m_, y gracias a la interacción entre las aplicaciones de consola, bastaría ejecutar una única acción desde el propio _Vim_, que, además, podríamos abreviar para reproducirla en situaciones semejantes. Veamos cómo.

Con _w3m_ el proceso de convertir una página web en texto es absolutamente elemental: añadir la opción `-dump`. Por ejemplo:

¶¶¶¶w3m -dump http://www.w3.org/TR/html401/struct/lists.html

nos devuelve la página dada como argumento, tal cual se presenta en el navegador, pero como puro texto.

Las equivalencias con nuestras marcas informales, (incluidos los añadidos de los últimos días), que frente a tal simplicidad resultan terriblemente embarazosas, son transparentes como la luz de un día radiante. Hagásmolas explícitas, por si alguien sigue todavía encerrado entre cuatro paredes:

TÍTULO, AUTOR y FECHA:: %
INICIO TÍTULO SECCIÓN:: #
FIN TÍTULO SECCIÓN: [No necesario]
INICIO SECCIÓN: [No necesario]
FIN SECCIÓN: [No necesario]
INICIO PÁRRAFO: Línea en blanco
FIN PÁRRAFO: [No necesario]
INICIO LISTA NUMERADA: [No necesario]
FIN LISTA NUMERADA: [No necesario]
INICIO ELEMENTO LISTA: 1.¶ [y 2. , etc, para los siguientes elementos]
FIN ELEMENTO LISTA: [No necesario]
INICIO NOMBRE PROGRAMA: _ [guión bajo]
FIN NOMBRE PROGRAMA: _
INICIO OPCIÓN: ` [acento grave]
FIN OPCIÓN: `
INICIO ORDEN: `
FIN ORDEN: `
INICIO BLOQUE ORDEN: ¶¶¶¶
FIN BLOQUE ORDEN: [No necesario]


Estas marcas, excepto la primera, pertenecen al lenguaje de marcas ligero conocido como Markdown. Su sintaxis completa se explica aquí. La única precaución que hay que tomar es, como cabe esperar, la de escapar las marcas de Markdown cuando se van a introducir como caracteres literales en el texto corriente. Por ejemplo, para introducir literalmente un asterisco (*) tendremos que escribir \*. Quedan excluidos los casos en que esos signos aparecen dentro de un fragmento de código (entre acentos graves) o en los bloques de código (que se identifican, como hemos visto, por su sangría de cuatro espacios). A las marcas de Markdown se pueden añadir algunas otras, por ejemplo, la barra (|) para señalar una celda de una tabla. Este conjunto de extensiones se conoce como Markdown Extra.

Bien, las marcas fáciles, facilísimas, están ahí. ¿Qué podemos hacer con ellas? Los enterados saben que son la base, por ejemplo, de muchos sistemas de wikis. Pero nosotros no tenemos un wiki, todavía. No hace falta pensar, sin embargo, en aplicaciones especializadas. Los lenguajes de marcas ligeros pueden servir para escribir nuestros documentos y para que ayudantes especiales de HAL nos los devuelvan en un formato apto para su presentación, ya sea en la web o, incluso, en bella versión imprimible.

Pandoc es uno de estos eficientes colaboradores de HAL. Se trata de un conversor universal de un lenguaje de marcas a otro. Emplea las mismas marcas de Markdown y Markdown Extra con algunas extensiones y mejoras, como la marca % para elementos del encabezado. Las variantes de Pandoc en relación con Markdown / Markdown Extra se pueden consultar aquí.

Pandoc está disponible en Debian y se puede instalar como cualquier paquete:

aptitude install pandoc

Con Pandoc la conversión de nuestro texto a HTML, LaTeX y otros muchos lenguajes de marcas es cosa de niños, basta con pedírselo a HAL. 

Supongamos que el texto anterior lo guardamos en el fichero texto_etiquetado-pandoc.mdml (la extensión mdml, que es opcional, es una abreviatura de MarkDown Markup Language). En tal caso, podríamos solicitar a HAL lo siguiente:

HAL, llama a tu ayudante en conversión de marcas para que convierta 'texto_etiquetado-pandoc.mdml' de [from] Markdown a [to] HTML.

Que se puede expresar así:

pandoc -f markdown -t html texto_etiquetado-pandoc.mdml

HAL nos devolverá el texto marcado con HTML, un HTML muy parecido al que obtuvimos hace unos días, aunque con un formato distinto, que en ningún caso afecta a la interpretación que un navegador hará de él. De hecho, la salida de pandoc se puede enviar directamente a w3m mediante una tubería:

pandoc -f markdown -t html texto_etiquetado-pandoc.mdml | w3m -T text/html

Se advertirá que en el HTML resultante no hay rastro de lo marcado con %, esto es, título, autor y fecha. Esta información se debería integrar en la cabecera de HTML (la etiqueta HEAD), pero pandoc la descarta por defecto, a menos que le indiquemos lo contrario con la opción --standalone (= autónomo), o -s, en versión abreviada. Con esta opción activada, pandoc crea un documento autónomo, un HTML completo con su declaración de documento y su oportuna cabecera. Podemos volver a ejecutar la orden, redirigir el resultado a w3m y, por medio de la  orden v de w3m, inspeccionar el HTML.

pandoc -s -f markdown -t html texto_etiquetado-pandoc.mdml | w3m -T text/html

La conversión a LaTeX sigue los mismos derroteros:

pandoc -f markdown -t latex texto_etiquetado-pandoc.mdml

Y la versión autónoma se obtiene mediante el mismo procedimiento:

pandoc -s -f markdown -t latex texto_etiquetado-pandoc.mdml

El resultado es prácticamente idéntico a uno de los nuestros. La única diferencia reseñable está en el preámbulo del documento, una diferencia que sí afectaría al resultado final del procesamiento con pdflatex. La razón es que pandoc no tiene en cuenta, porque no puede saberlo de antemano, que nuestro texto está escrito en castellano. Tenemos que decírselo explícitamente. La forma de hacerlo es bien simple. Creamos, para empezar, un fichero, llamémoslo preambulo-latex, que contenga nuestro preámbulo, por ejemplo, éste:

\documentclass[a4paper]{article}
\usepackage[spanish]{babel}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{bera}

Después, se informa a pandoc de nuestro preámbulo para que lo aplique en lugar del que él utliza por defecto. Para ello recurrimos a la opción --custom-header (= cabecera personalizada) o, su versión abreviada, -C:

pandoc -s -C preamulo_latex -f markdown -t latex texto_etiquetado-pandoc.mdml

El resultado se podría redirigir a un fichero para procesarlo más tarde con pdflatex.

Con el fin de evitarnos los pasos intermedios en la generación del PDF, Pandoc proporciona como alternativa rápida el guión markdown2pdf, que generaría un fichero con extensión pdf y el mismo nombre de nuestro fichero original:

markdown2pdf -C preambulo_latex texto_etiquetado-pandoc.mdml

Pandoc, aparte de su facultad para convertir a otros muchos formatos, permite usos más sofisticados, como, por ejemplo, introducir directamente marcas LaTeX en el documento marcado con Markdown que se mantendrán literalmente en el documento resultante, lo que facilita la construcción de documentos LaTeX más elaborados. Todo esta documentado en la página web citada y en el fichero README, que se encuentra en la documentación del paquete Debian: /usr/share/doc/pandoc/README.gz.

Con Markdown y Pandoc finalizamos, de momento, este primer contacto con los lenguajes de marcas. Mucho queda en el tintero. Es casi vergonzoso no haber presentado, en particular, el metalenguaje XML y algunos de los lenguajes de marcas construidos a partir de él. Otra vez será.


Resumen

Los lenguajes de marcas ligeros facilitan el tecleado de las marcas y pueden aprenderse en pocos minutos.

Markdown es un lenguaje ligero de marcas.

Pandoc es un sistema de conversión de lenguajes de marcas, especialmente apropiado para producir documentos LaTeX sencillos a partir de lenguajes de marcas ligeros. Ofrece una interfaz de línea de comandos a través de la orden pandoc y de algún guión, como markdown2pdf, para facilitar la generación de documentos típicos.



HAL y las marcas (LaTeX - anexo)
2009-03-23T23:21:00.004+01:00
Recurrir al paquete listing para un tarea tan elemental como la que requiere nuestro simplísimo texto de ejemplo es como hablar con HAL únicamente para preguntarle su nombre. No es de recibo dejar ese fleco abierto. Un texto más complejo permitirá apreciar por qué listing es un paquete ampliamente recomendado para la presentación de código.

Vamos a producir un documento que incluya directamente el código de una orden de las primerísimas que vimos en estas conversaciones con HAL. Se trata del código, escrito en C, de la orden hostname. El código mismo no puede distribuirse sino mediante la licencia GPL, como se especifica en su primer comentario. Aquí sólo mostramos el fichero LaTeX para producir el documento y la primera página que resulta de su procesamiento. Las marcas que no se han explicado se señalan en rojo. El lector interesado puede encontrar ayuda completa sobre estas marcas y sobre listings en /usr/share/doc/texlive-doc/latex/listings/listings.pdf, si su distribución está basada en Debian.

El breve fichero LaTeX a partir del que generaremos la versión coloreada del código es éste:

\documentclass[a4paper]{article}
\usepackage{bera}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{xcolor}
\usepackage{listings}
\lstset{%
  numbers=left,
  basicstyle=\footnotesize\ttfamily,
  commentstyle=\color{violet},
  stringstyle=\color{magenta},
  keywordstyle=\color{purple},
  identifierstyle=\color{teal},
}

\begin{document}
\lstinputlisting[language=C]{hostname.c}
\end{document}

Y ésta es una imagen con la primera página del documento generado:



¡Happy Latexing!


HAL y las marcas (LaTeX - VI)
2009-03-23T17:17:00.000+01:00
El día pasado acudimos excepcionalmente a una orden de estilo para poder integrar los resultados habituales del paquete listings en nuestro texto. Ya puestos, y como la veda se ha levantado parcialmente, vamos a tolerar otra excepción y sustituir la marca que establecimos para nombres de programas.

Es una convención frecuente presentar estos nombres con una familia de fuente diferente. Puesto que la familia por defecto en LaTeX es Serif y, puesto que la familia Typewritter (Monospace) es la elegida para el código, la opción recomendable es reservar la familia restante de la típica triada, Sans Serif, para nuestros nombres de programas.

Podríamos etiquetarlos directamente con la marca que define justo esa familia:

\textsf{nombre_programa}

Pero, dado que esta marca no dice nada sobre la función estructural del texto marcado y ante la posibilidad, además, de que cambiemos en el futuro de idea al definir las características de presentación de los nombres de programas, es mucho mejor crear una marca propia, llamémosla \Prog, que permita envolver la citada definición de fuente u otras definiciones futuras.

Para crear marcas propias, lo que en terminología de LaTeX se llamarían órdenes propias, se usa la orden de LaTeX \newcommand. Esta orden tendría, en el caso que nos ocupa el siguiente aspecto:

\newcommand{\Prog}[1]{\textsf{#1}}

La sintaxis indica que, en el lugar en el que nosotros pongamos la marca \Prog{texto}, donde texto es el argumento único (argumento 1 de \Prog), el sistema de procesamiento del documento pondrá \textsf{texto}. El texto en \textsf es el mismo texto de \Prog, que se pasa como valor al primer y único contenedor, #1, que nuestra orden \newcommand ha establecido para \textsf.

Lo único que hay que tener en cuenta a la hora de crear estas marcas propias es que el nombre de la marca elegida no exista ya entre las marcas de LaTeX o entre las de sus paquetes. Si albergamos dudas al respecto, podemos utilizar, en lugar de \newcommand, la orden \providecommand, que tendrá el mismo resultado que \newcommand cuando \Prog no sea una marca de LaTeX o sus paquetes y que no producirá efecto alguno, cuando la marca ya exista:

\providecommand{\Prog}[1]{\textsf{#1}}

Finalmente, para que las órdenes \newcommand o \providecommand sean tenidas en cuenta, se deben incluir en el preámbulo del documento después de las solicitudes de carga de paquetes.

Con este último refinamiento podríamos considerar acabado nuestro trabajo con las marcas de LaTeX, pero aún podemos introducir unas pocas mejoras más.

En primer lugar, vamos a utilizar un tipo de fuente distinta de la que por defecto utiliza LaTeX. La razón es que, aunque la fuente por defecto de LaTeX (Computer Modern) es estupenda para texto impreso, cabe la posibilidad de que nuestro documento se visualice más frecuentemente en pantalla. Una fuente más legible en pantalla puede ser beneficiosa. Seleccionaremos la fuente Bera, que viene incluida en TeX Live y que se activa mediante la carga de un paquete:

\usepackage{bera}

Y ya que asumimos que nuestro documento se verá en pantalla, podríamos también beneficiarnos del uso de colores, especialmente para resaltar los fragmentos de código.

Para disponer de soporte de colores en un documento LaTeX podemos usar el paquete xcolor.

\usepackage{xcolor}

El color para todo el código se puede establecer con la etiqueta \color{nombre_color} en la configuración inicial de listings:

\lstset{basicstyle=\color{teal}\small\ttfamily}

También añadiremos una sección previa con el título del documento, el autor y la fecha (la fecha la introduce por defecto LaTeX). Se debe solicitar explícitamente la generación del título mediante la orden \maketitle. El grupo de marcas adecuadas puede ir todo él justo después de \begin{document}, aunque hay quien prefiere situar \title y \author en el preámbulo.

\title{Un ejemplo juguete de \LaTeX}
\author{átopos}
\maketitle

(Cuando la palabra 'LaTeX' aparece precedida por la barra invertida, tal como acabamos de hacer, el tipógrafo producirá un versión embellecida de esa palabra. Es el ejemplo típico que se espeta a los usuarios de sistemas de preparación de documentos no profesionales: "¡Aficionados, a ver cómo os las apañáis para producir estos nuestros hermosos tipos!".)

Finalmente, estableceremos el tamaño de la página a A4, que es el modelo de página habitual en Europa. Basta para ello una opción en la declaración inicial de la clase de documento:

\documentclass[a4paper]{article}

Hemos terminado de etiquetar con LaTeX nuestro documento. Proponemos como ejercicio para el lector la modificación de los ficheros txt2latex.sed y generar_latex que corresponda a las transformaciones y añadidos que hemos introducido en estos dos últimos capítulos. El fichero txt2latex.tex resultante debería ser el siguiente:

 \documentclass[a4paper]{article}
\usepackage[spanish]{babel}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{bera}
\usepackage{xcolor}
\usepackage{listings}
\lstset{basicstyle=\color{teal}\small\ttfamily}

\newcommand{\Prog}[1]{\textsf{#1}}

\title{Un ejemplo juguete de \LaTeX}
\author{átopos}

\begin{document}
\maketitle

\section{Navegación gráfica}
Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:

\begin{enumerate}
\item Ir al menú <<Archivo>> del navegador y guardar como texto la página web. (Lo que además implica seleccionar un nombre de fichero y un directorio).
\item Crear en \Prog{Vim} una nueva ventana para editar en ella el documento que acabamos de guardar, mediante la orden \lstinline!:new ruta_fichero!.
\end{enumerate}

\section{Navegación desde consola}
Si navegamos con \Prog{w3m}, y gracias a la interacción entre las aplicaciones de consola, bastaría ejecutar una única acción desde el propio \Prog{Vim}, que, además, podríamos abreviar para reproducirla en situaciones semejantes. Veamos cómo.

Con \Prog{w3m} el proceso de convertir una página web en texto es absolutamente elemental: añadir la opción \lstinline!-dump!. Por ejemplo:
\begin{lstlisting}
w3m -dump http://www.w3.org/TR/html401/struct/lists.html
\end{lstlisting}
nos devuelve la página dada como argumento, tal cual se presenta en el navegador, pero como puro texto.
\end{document}

Tras procesar este fichero con pdflatex, se obtiene texto_etiquetado.pdf, que podrá verse con cualquier lector de PDFs:



Resumen

LaTeX permite crear marcas personalizadas con la orden \newcommand o con la orden \providecommand

El paquete xcolor proporciona soporte de colores en documentos LaTeX.

La creación de una sección previa con el título del documento y de su autor o fecha de escritura es trivial con LaTeX.




HAL y las marcas (LaTeX - V)
2009-03-23T00:00:00.004+01:00
Nuestro fichero marcado con LaTeX no es una traducción perfecta de nuestro fichero marcado con marcas informales. Ante el desconocimiento de marcas LaTeX apropiadas para los elementos peculiares y, en principio, exclusivos de nuestro texto original (nombre de programa, opción y orden), llegamos al compromiso provisional de suprimir tales marcas.

No hay nada en LaTeX que obligue a una concesión tan poco justa. De hecho, LaTeX proporciona dos marcas, equivalentes al <EM> y al <CODE> de HMTL, que pueden desempeñar perfectamente el mismo papel:

\emph{texto}
Marca el texto como texto enfatizado.

\verb CAR texto CAR
Marca el texto como código de computador. CAR funciona aquí como delimitador y puede ser cualquier carácter que no forme parte del texto que marca. (Los espacios no deben incluirse y se han escrito sólo para facilitar su comprensión). Así, por ejemplo, el fragmento de texto '-dump' se podría marcar de esta forma: \verb!-dump!.


Por si fuera poco, LaTeX dispone también de un entorno semejante a \verb para marcar bloques independientes de código, como el que constituye la penúltima línea de nuestro texto original. Lo que implica que deberíamos haber utilizado una marca diferente para el bloque de código que constituye esa línea. Por ejemplo:

INICIO BLOQUE ORDEN
w3m -dump http://www.w3.org/TR/html401/struct/lists.html
FIN BLOQUE ORDEN

Si, además, concebimos dicha línea como un bloque de código, resulta innecesario situarla ahora como un párrafo aparte y pensar la línea subsiguiente como otro párrafo más. En realidad, esa forma de escribir no sería estructuralmente correcta, si es que tenemos en cuenta el sentido mismo del texto. La multiplicación de párrafos es una consecuencia indeseable de no haber comprendido que la línea en cuestión debe formar parte del mismo párrafo, lo que en ningún caso significa que no pueda tener un valor estructuralmente especial dentro de él, como bloque de código lógicamente independiente. Es notable como LaTeX nos fuerza, pues, a ser más finos a la hora de estructurar nuestra escritura, gracias a la disponibilidad de marcas distintas para unidades lógicas diferentes. 

En consecuencia, la parte afectada de nuestro texto con marcas informales se puede reescribir ahora de una forma más precisa:

INICIO PÁRRAFO
Con INICIO NOMBRE PROGRAMAw3mFIN NOMBRE PROGRAMA el proceso de convertir una página web en texto es absolutamente elemental: añadir la opción INICIO OPCIÓN-dumpFIN OPCIÓN. Por ejemplo:
INICIO BLOQUE ORDEN
w3m -dump http://www.w3.org/TR/html401/struct/lists.html
FIN BLOQUE ORDEN
nos devuelve la página dada como argumento, tal cual se presenta en el navegador, pero como puro texto.
FIN PÁRRAFO

Con estas nuevas marcas de LaTeX es casi trivial modificar el fichero txt2latex.sed para que procese estas tres líneas como debe:

s/INICIO NOMBRE FICHERO/\\emph{/g
s/FIN NOMBRE FICHERO/}/g
s/INICIO ORDEN/\\verb!/g
s/FIN ORDEN/\!/g
s/INICIO BLOQUE ORDEN/\n\\begin{verbatim}\n/g
s/FIN BLOQUE ORDEN/\n\\end{verbatim}\n/g

Por otra parte, habría que suprimir, además, la línea de txt2latex.sed que añadía el carácter de escape al guión bajo, puesto que ya no es necesaria: en un fragmento de texto con las marcas LaTeX mentadas los caracteres especiales de LaTeX se interpretan literalmente sin que haya necesidad de escaparlos.

Tras ejecutar el guión generar_latex fichero_etiquetado.txt ---fichero_etiquetado.txt se ha de modificar previamente como acabamos de explicar---, el fichero resultante, fichero_etiquetado.tex tendría el siguiente aspecto:

\documentclass{article}
\usepackage[spanish]{babel}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}

\begin{document}
\section{Navegación gráfica}
Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:

\begin{enumerate}
\item Ir al menú <<Archivo>> del navegador y guardar como texto la página web. (Lo que además implica seleccionar un nombre de fichero y un directorio).
\item Crear en \emph{Vim} una nueva ventana para editar en ella el documento que acabamos de guardar, mediante la orden \verb!:new ruta_fichero!.
\end{enumerate}

\section{Navegación desde consola}
Si navegamos con \emph{w3m}, y gracias a la interacción entre las aplicaciones de consola, bastaría ejecutar una única acción desde el propio \emph{Vim}, que, además, podríamos abreviar para reproducirla en situaciones semejantes. Veamos cómo.

Con \emph{w3m} el proceso de convertir una página web en texto es absolutamente elemental: añadir la opción \verb!-dump!. Por ejemplo:
\begin{verbatim}
w3m -dump http://www.w3.org/TR/html401/struct/lists.html
\end{verbatim}
nos devuelve la página dada como argumento, tal cual se presenta en el navegador, pero como puro texto.
\end{document}

Si el LaTeX básico dispone de marcas suficientes para etiquetar todo nuestro texto original, ¿por que no las comentamos a su debido tiempo? ¿Por qué hemos diferido su explicación hasta ahora?

La razón es que no vamos a utilizar las marcas descritas, sino otras, más elaboradas, que obligan a recurrir a algún paquete que extienda las funcionalidades básicas de LaTeX. Y no las vamos a utilizar, porque, aunque son perfectamente válidas para un texto tan simple como el de nuestro ejemplo, conviene tener noticia de mecanismos más sofisticados y aptos para situaciones más complejas. De paso, veremos tomaremos contacto con el tipo de mecanismos habituales en el uso de paquetes.

Un paquete especialmente indicado para casos en los que hay que introducir código es el paquete listings, que vendrá instalado en cualquier distribución de LaTeX y, por supuesto, en TeX Live. El paquete listings suministra dos marcas parejas al \verb y al entorno verbatim comentados anteriormente. Son las siguientes:

\lstlisting CAR código CAR
Permite marcar fragmentos de código.

\begin{lstlisting}código\end{lstlisting}
Permite marcar bloques de código.


listings, como cualquier paquete, debe cargarse en el preámbulo del documento con la orden:

\usepackage{listings}

Tras ella suele aparecer una orden de configuración de las opciones del paquete. En nuestro caso, es imprescindible, al menos, una opción, la que defina la fuente básica con que se mostrará el código para que se diferencie del texto corriente. \verb y verbatim lo hacían por nosotros, establecían la fuente como perteneciente a la familia Typewriter, pero listings no lo hace por defecto, y no lo hace, porque no presupone por adelantado que nuestro documento pueda contener algo más que código. Debemos pues, excepcionalmente, tocar este aspecto del estilo. La orden que permite refinar la configuración de listings es \lstset{opciones_configuración} y la opción para modificar la familia de la fuente básica de forma que utilice la familia Typewriter es basicstyle=\ttfamily. Por otra parte, listings suele requerir de una disminución del tamaño de la fuente básica cuando las líneas de código son más largas de lo acostumbrado, como la penúltima línea de nuestro texto original. Ahí podemos utilizar la orden \small de LaTeX, que utiliza una fuente más pequeña de la habitual. En nuestro caso concreto, la opción podría aparecer también como parte de la configuración básica, es decir, dentro de \lstset, o bien como opción que matiza un entorno lstlisting en particular. Nosotros vamos a quedarnos con la primera posibilidad, aunque pueda ser discutible desde el punto de vista estético.

Por tanto, y teniendo en cuenta las anteriores explicaciones, deberíamos añadir estas dos líneas al preámbulo de nuestro documento:

\usepackage{listings}
\lstset{basicstyle=\small\ttfamily}


Finalmente sólo falta sustituir los \verb y \verbatim de antes por las marcas equivalentes de listings [Las modificaciones se muestran en azul]:

\documentclass{article}
\usepackage[spanish]{babel}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{listings}
\lstset{basicstyle=\small\ttfamily}

\begin{document}
\section{Navegación gráfica}
Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:

\begin{enumerate}
\item Ir al menú <<Archivo>> del navegador y guardar como texto la página web. (Lo que además implica seleccionar un nombre de fichero y un directorio).
\item Crear en \emph{Vim} una nueva ventana para editar en ella el documento que acabamos de guardar, mediante la orden \lstinline!:new ruta_fichero!.
\end{enumerate}

\section{Navegación desde consola}
Si navegamos con \emph{w3m}, y gracias a la interacción entre las aplicaciones de consola, bastaría ejecutar una única acción desde el propio \emph{Vim}, que, además, podríamos abreviar para reproducirla en situaciones semejantes. Veamos cómo.

Con \emph{w3m} el proceso de convertir una página web en texto es absolutamente elemental: añadir la opción \lstinline!-dump!. Por ejemplo:
\begin{lstlisting}
w3m -dump http://www.w3.org/TR/html401/struct/lists.html
\end{lstlisting}
nos devuelve la página dada como argumento, tal cual se presenta en el navegador, pero como puro texto.
\end{document}



Resumen

LaTeX suele favorecer e, incluso, forzar, al escritor a tomar conciencia plena de la estructura lógica de sus escritos.
 
El paquete listings extiende las funcionalidades básicas de LaTeX para la edición de documentos que contengan cualquier clase de código.

La mayoría de los paquetes, como listings, proporcionan marcas u órdenes especializadas que el usuario puede utilizar de acuerdo con sus fines concretos.

Las paquetes más versátiles, como listings, proporcionan al usuario la posibilidad de configurar muchos detalles que afectan al resultado final.




HAL y las marcas (LaTeX - IV)
2009-03-21T18:36:00.005+01:00
Vale. Hemos marcado nuestro texto como LaTeX prescribe. Pero ¿cómo podemos ver el resultado? 

Para un texto marcado con marcas HTML el navegador hace las veces del experto que lo procesa y del soporte para su visualización. Para un texto marcado con LaTeX, las dos acciones, la de procesar el documento y la de visualizarlo, son, sin embargo, competencia de dos agentes diferentes: el tipógrafo y el "lector" o "visualizador" del documento resultante, normalmente, en nuestros días, un fichero PDF.

El tipógrafo más recomendable en la actualidad para documentos LaTeX se llama pdfTeX, un descendiente del original TeX, que todavía se sigue usando, y mucho. LuaTeX, nieto de TeX e hijo de pdfTeX, podría consolidarse como el noble heredero de ambos en los próximos años.

pdfTeX y todo lo que se requiere para procesar un documento LaTeX viene incluido en todas las distribuciones modernas de GNU/Linux. En Debian, por ejemplo, se empaqueta dentro de los paquetes que incluyen el prefijo texlive-. TeX Live, que es la distribución más completa que existe para procesar documentos con LaTeX, es realmente grande y por eso Debian ofrece la posibilidad de instalar todo TeX Live, mediante el paquete texlive-full, o sólo una parte básica, mediante el paquete texlive y otros posibles añadidos.

Si el lector dispone de una gran cantidad de disco duro puede proceder a instalar texlive-full:

aptitude install texlive-full

En caso de que quiera ahorrar espacio, bastará con que instale, por lo pronto, tres paquetes (de los cuales sólo los dos primeros son imprescindibles):

aptitude install texlive texlive-lang-spanish texlive-doc-es

Tenemos ya a nuestros expertos ahí disponibles para todo lo que les ordenemos. No perdamos más tiempo y hagamos que pongan su imprenta en marcha sobre nuestro documento. Llamaremos a pdflatex que es el ayudante de pdfTeX encargado de procesar los documentos LaTeX:

pdflatex texto_etiquetado.tex

Si no hay ningún error sintáctico en nuestras marcas LaTeX, pdflatex terminará su trabajo rápidamente tras expulsar algunos mensajes sobre el procesamiento. El resultado quedará guardado en el fichero texto_etiquetado.pdf. Cualquier lector de PDF nos mostrará el resultado:



Pero, ¿y si hemos cometido un error sintáctico en las marcas? Lo que sucederá es que pdflatex se detendrá y nos mostrará un mensaje de error. Los mensajes de error de pdflatex pueden ser difícilmente comprensibles; lo peor, sin embargo, es que tendremos que aprender algunos atajos de teclado para salir del procesamiento detenido y, sobre todo, nos veremos obligados a volver a ejecutar pdflatex cuantas veces sea necesario hasta corregir todos los errores. Una opción para evitar, al menos, esto último, es utilizar un corrector de la sintaxis de LaTeX antes de procesar el documento con pdflatex. Podemos recurrir a lacheck, que viene incluido en TeX Live.

Imaginemos, por ejemplo, que nos comimos ---un hambre descuidada produce estos males--- la llave de cierre en la primera sección y el \end{enumerate} al final de la lista. O sea:

...
  6 \begin{document}
  7 \section{Navegación gráfica <== Falta llave de cierre
  8 Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:
  9
 10 \begin{enumerate}
 11 \item Ir al menú <<Archivo>> del navegador y guardar como texto la página web. (Lo que además implica seleccionar un nombre de fichero y un directorio).
 12 \item Crear en Vim una nueva ventana para editar en ella el documento que acabamos de guardar, mediante la orden :new ruta\_fichero.
 13 <== Falta \end{enumerate}
 14
 15 \section{Navegación desde consola}
 16 Si navegamos con w3m, y gracias a la interacción entre las aplicaciones de consola, bastaría ejecutar una única acción desde el propio Vim, que, además, podríamos abreviar para reproducirla en situaciones semejantes. Veamos cómo.
 17
 18 Con w3m el proceso de convertir una página web entexto es absolutamente elemental: añadir la opción -dump. Por ejemplo:
 19
 20 w3m -dump http://www.w3.org/TR/html401/struct/lists.html
 21
 22 nos devuelve la página dada como argumento, tal cual se presenta en el navegador, pero como puro texto.
 23
 24 \end{document}

Sobre este texto, que guardamos como el nombre texto_erroneo.tex, ejecutamos ahora lacheck:

lacheck texto_erroneo.tex

Aparecerán los siguientes mensajes:

"texto_erroneo.tex", line 24: <- unmatched "\end{document}"
"texto_erroneo.tex", line 10: -> unmatched "\begin{enumerate}"
"texto_erroneo.tex", line 25: <- unmatched "end of file texto_erroneo.tex"
"texto_erroneo.tex", line 7: -> unmatched "{"
"texto_erroneo.tex", line 25: <- unmatched "end of file texto_erroneo.tex"
"texto_erroneo.tex", line 6: -> unmatched "\begin{document}"

El analizador sintáctico, aunque emite mensajes que no son absolutamente claros, ayuda a localizar rápida y exactamente la línea o líneas que contiene los errores cometidos. Nótese que se muestran mensajes de error para las últimas líneas del fichero, la 24 y la 25, así como para la primera del fragmento, la línea 6. Estos mensajes de error son provocados por nuestros verdaderos errores, los que afectan a las líneas 7 y 13, que, como un efecto en cadena, disparan los mensajes relativos al resto de líneas. Una vez corregidas las líneas defectuosas (la 7 y la 13), el resto de mensajes de error desaparecerá.

La moraleja es que hay que ser cuidadoso a la hora de marcar textos (los buenos editores como Vim o Emacs suelen ayudar ya de entrada en esta tarea) y que conviene utilizar un analizador sintáctico como lacheck antes de procesar el documento con pdflatex.


Resumen:

pdflatex es el tipógrafo de documentos LaTeX recomendado en la actualidad. pdflatex forma parte de la máquina tipográfica pdfTeX.

pdfTeX es heredero de TeX. LuaTeX, por su parte, es heredero de pdfTeX y se perfila como su futuro sucesor.

La distribución actualmente más completa para procesar documentos LaTeX es TeX Live. TeX Live viene empaquetada por Debian en el paquete texlive (que contiene lo básico) y otros paquetes con el prefijo texlive-.

lacheck es un analizador de la sintaxis de marcas LaTeX. Es recomendable analizar la corrección de nuestra sintaxis antes de procesar nuestro documento con pdflatex.




HAL y las marcas (LaTeX - III)
2009-03-21T12:43:00.007+01:00
Como sucede con HTML, también LaTeX requiere de cierto protocolo para definir aspectos básicos del documento marcado según sus convenciones y para que el experto o expertos que procesen estas marcas sepan cómo hacerlo exactamente. Por fortuna, este formulismo inicial es bastante más fácil de entender y de explicar que el de HTML. Nos limitaremos, no obstante, a comentar los aspectos más importantes de él y a confiar en que lector sabrá encontrar información más detallada en los enlaces propuestos en los primeros párrafos de este otro artículo.

La estructura de un documento LaTeX listo para su procesamiento es básicamente la siguiente:

PREÁMBULO

\begin{document}
[Nuestro texto con las marcas LaTeX]
\end{docuemnt}

Así pues, si retomamos la metáfora aplicada en la exposición de HTML, vemos que también el gabinete de LaTeX precisa que nuestro texto marcado se envíe en un sobre document y que a ese sobre le peguemos una etiqueta que contenga descripciones precisas de lo que va en él (el PREÁMBULO). Un preámbulo típico para documentos en castellano consta de los siguientes enunciados:

\documentclass{article}
\usepackage[spanish]{babel}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}

Veamos qué significa cada uno de ellos:

\documentclass{article}
Define el tipo de documento que creamos. En nuestro caso un artículo.

\usepackage[spanish]{babel}
Define la lengua en la que está escrito nuestro documento.

\usepackage[T1]{fontenc}
Define el tipo de codificación de la fuente empleada por defecto. Es recomendable para lenguas que contienen, como la nuestra, caracteres acentuados.

\usepackage[utf8]{inputenc}
Define el tipo de codificación empleada al escribir el texto. En cualquier máquina moderna será UTF-8.


Más allá de los tecnicismos ---por los que hemos pasado rozando---, lo que salta a la vista en las tres últimas líneas del preámbulo es la marca \usepackage{...}. Se trata de un tipo de orden que le indica a los expertos que procesarán nuestro documento que use un determinado tipo de paquetes LaTeX y que active, en caso necesario, tales o cuales opciones de ese paquete, donde las opciones solicitadas se indican entre corchetes de acuerdo con la sintaxis \usepackage[opciones]{paquete}. 

¿Pero qué es un paquete de LaTeX? Un paquete no es sino una extensión para determinados propósitos de las posibilidades básicas de LaTeX. Algunas de estas extensiones actúan sobre los engranajes de las máquinas que procesarán LaTeX y sólo deberemos ser conscientes de ellos a la hora de incluirlos en el preámbulo. Otras pueden poner a disposición del usuario nuevas marcas especializadas a las que éste puede recurrir si lo desea. Así, por citar sólo un caso particular, el paquete babel permite escribir documentos en varias lenguas (las que se indican como opciones suyas) y seleccionar una u otra lengua cuando convenga mediante, por ejemplo, la orden o marca \selectlanguage{lengua}. En el caso de nuestro ejemplo sólo utilizamos una lengua, spanish, y podemos prescindir de estas sofisticaciones. Por lo demás, el recurso a paquetes es especialmente recomendable cuando nuestro texto va a contener elementos característicos propios que requerirán de un tratamiento específico. Veremos un caso de ello en un artículo posterior.

Bien. Nos queda sólo incluir el preámbulo comentado y el envoltorio document en nuestro texto marcado con LaTeX para obtener un documento LaTeX completo listo para su procesamiento. Si seguimos la misma estrategia empleada en la generación del documento HTML a partir de nuestro texto con marcas informales, bastaría con modificar ligeramente el guión generar_html de este modo:

## --* generar_latex - 21/03/09 - átopos *--
## Genera documento LaTeX canónico a partir de un documento de texto 
## marcado con mis marcas informales
SED_F=txt2latex.sed                   # Fichero sed: convierte mis marcas 
                                      #              informales en marcas LaTeX
ORIG_F=$1                             # Fichero de entrada
DEST_F=$(basename $ORIG_F .txt).tex   # Fichero LaTeX de salida

tr -d '\n'< $ORIG_F \
| sed -f $SED_F \
| awk 'BEGIN {
               print "\\documentclass{article}"; 
               print "\\usepackage[spanish]{babel}";
               print "\\usepackage[T1]{fontenc}";
               print "\\usepackage[utf8]{inputenc}\n"; 
               print "\\begin{document}";
             }
             { print $0; }
       END   { 
               print "\\end{document}";
             }' \
> $DEST_F

Las modificaciones, aparte de las que afectan a los comentarios, son las lógicas: cambia el fichero de órdenes para sed, que ahora será el txt2latex.sed que creamos el día pasado; se añade la orden tr, y se modifica el subsiguiente sed como corresponde (también lo comentamos ayer); se modifican mutatis mutandis las líneas que imprimirá awk al principio y al final (nótese que en awk, como en sed, el literal '\' debe escaparse).

El nuevo guión, que llamaremos generar_latex recibe como argumento el fichero con nuestras etiquetas informales y produce el fichero texto_etiquetado.tex. Tras cambiarlo de modo, podemos ejecutarlo:

./generar_latex texto_etiquetado.txt

El resultado, texto_etiquetado.tex, es el esperado:

\documentclass{article}
\usepackage[spanish]{babel}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}

\begin{document}
\section{Navegación gráfica}
Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:

\begin{enumerate}
\item Ir al menú <<Archivo>> del navegador y guardar como texto la página web. (Lo que además implica seleccionar un nombre de fichero y un directorio).
\item Crear en Vim una nueva ventana para editar en ella el documento que acabamos de guardar, mediante la orden :new ruta\_fichero.
\end{enumerate}

\section{Navegación desde consola}
Si navegamos con w3m, y gracias a la interacción entre las aplicaciones de consola, bastaría ejecutar una única acción desde el propio Vim, que, además, podríamos abreviar para reproducirla en situaciones semejantes. Veamos cómo.

Con w3m el proceso de convertir una página web en texto es absolutamente elemental: añadir la opción -dump. Por ejemplo:

w3m -dump http://www.w3.org/TR/html401/struct/lists.html

nos devuelve la página dada como argumento, tal cual se presenta en el navegador, pero como puro texto.

\end{document}

Si queremos ver coloreada la sintaxis de LaTeX nada mejor que echar mano del propio Vim. Se puede llamar a Vim para ver ficheros, sin intención de editarlos, con la orden view, que es un atajo de vim -R:

view texto_etiquetado.tex

La imagen siguiente muestra el resultado:




Resumen:

Un documento LaTeX consta de un preámbulo y un entorno document. El preámbulo incluye, como mínimo, la definición de la clase de documento (artículo, libro, carta, etc.) y, normalmente, también la solicitud de uso de paquetes. El entorno document engloba todo el texto marcado con marcas LaTeX.

Un paquete de LaTeX es una extensión de las posibilidades básicas de LaTeX. La inclusión de paquetes se solicita en el preámbulo del documento con la etiqueta u orden \usepackage[opciones]{paquete}, donde cada opción activa un conjunto determinado de las extensiones que el paquete proporciona. Por ejemplo, \usepackage[spanish]{babel} permite usar el paquete para el uso de múltiples lenguas babel y beneficiarse de sus extensiones para el castellano.




HAL y las marcas (LaTeX - II)
2009-03-20T20:39:00.002+01:00
Si quisiéramos acudir a un procedimiento automático para traducir nuestras marcas informales a marcas LaTeX, como hicimos para obtener nuestro documento HTML, deberíamos tener en cuenta la forma típica que adoptan los textos etiquetados con LaTeX, de lo que ayer se dio un brevísimo ejemplo, así como algunas de sus peculiaridades, tales como la manera de entrecomillar en español o la introducción literal de caracteres especiales.

¿Qué queremos decir con esto? La mejor manera de verlo es elaborar un fichero txt2latex.sed semejante al txt2html.sed de entonces. El fichero tendría por lo pronto este aspecto:

# Conversión de caracteres especiales
s/"\([[:alnum:]]\+\)"/<<\1>>/g
s/_/\\_/g

# Conversión de etiquetas
s/INICIO SECCIÓN//g
s/FIN SECCIÓN//g
s/INICIO TÍTULO SECCIÓN/\\section{/g
s/FIN TÍTULO SECCIÓN/}\n/g
s/INICIO PÁRRAFO//g
s/FIN PÁRRAFO/\n\n/g
s/INICIO LISTA NUMERADA/\\begin{enumerate}\n/g
s/FIN LISTA NUMERADA/\\end{enumerate}\n\n/g
s/INICIO ELEMENTO LISTA/\\item /g
s/FIN ELEMENTO LISTA/\n/g
s/INICIO NOMBRE PROGRAMA//g
s/FIN NOMBRE PROGRAMA//g
s/INICIO ORDEN//g
s/FIN ORDEN//g
s/INICIO OPCIÓN//g
s/FIN OPCIÓN//g

Buena parte de este fichero se entiende por sí mismo. Las etiquetas informales que no tienen traducción se sustituyen por nada, es decir, se eliminan. También hemos eliminado provisionalmente las etiquetas para nombre de programa, opción y orden, porque todavía no sabemos sus equivalencias en LaTeX. Allí donde queremos un salto de párrafo sustituimos la marca informal por la marca LaTeX equivalente más dos saltos de línea ---recuérdese que el salto de línea se expresa con '\n'. Estos dos saltos crean precisamente una línea en blanco. Nótese, en particular, que el carácter '\' de LaTeX debe escaparse con otro '\' (el carácter de escape de sed, y de casi todo en HAL), puesto que es un carácter especial de sed, justamente el que sirve para escapar un carácter cualquiera.

En cuanto a la primera sección del fichero, la relativa a la conversión de las comillas rectas por comillas angulares y la secuencia de escape para el carácter '_' explicada ayer, sólo nos puede extrañar la primera orden:

s/"\([[:alnum:]]\+\)"/<<\1>>/g

Entender lo que esta orden de sed significa implica conocer una nueva posibilidad de sed todavía no explicada: las referencias hacia atrás (backreferences). Miremos la expresión minuciosamente, porque casi todo nos debería resultar familiar.

s/RE/remplazo/g

es evidentemente una orden de sustitución de sed. Lo sustituido es todo lo que encaja con la expresión regular (RE) que hay a la izquierda. Analicemos primero esa expresión regular:

"\([[:alnum:]]\+\)"

Se trata de un molde para un texto entrecomillado ("texto"). Lo entrecomillado es un conjunto de caracteres alfanuméricos [[:alnum:]]. Este conjunto contiene uno o más miembros (el signo +), que en sed, frente a lo que ocurre con expresiones regulares extendidas, tiene que escaparse (\+). Además, este conjunto aparece agrupado (los paréntesis (...), que en sed deben también escaparse). Por tanto, la expresión regular designa todo fragmento de texto constituido por uno o más de un carácter alfanuméricos que esté entrecomillado por comillas rectas. En definitiva, esta expresión regular no contiene nada que no sepamos ya, salvo la necesidad de escapar algunos de sus caracteres.

Lo nuevo está en la expresión que se propone como remplazo:

<<\1>>

Las comillas angulares de inicio y cierre son justamente aquellas por las que queremos sustituir las comillas rectas del texto que encaje con la expresión regular. Lo que aparece entre estas comillas angulares es la enigmática expresión \1. Esta expresión simplemente recupera el contenido de lo registrado por sed cuando descubrió una agrupación en la expresión regular, es decir, todo lo que hay entre los paréntesis. (Como sólo se ha registrado una agrupación, la referencia hacia atrás es \1; si en la expresión regular apareciese una segunda agrupación, la referencia de esta segunda agrupación sería \2, etc.). Por tanto, el fragmento de texto constituido por los caracteres alfanuméricos va a aparecer intacto en el remplazo. Esta es la técnica habitual que se utiliza cuando una parte interna del texto que encaja con la expresión (en nuestro caso, lo entrecomillado) se quiere preservar y sólo otra parte (en nuestro caso, las comillas rectas) se quiere modificar.

Diseccionado el sentido de nuestro fichero txt2latex.sed, podemos utilizarlo para efectuar la sustitución de nuestras marcas informales ---que, recuérdese, aparecen en el fichero texto_etiquetado.txt--- por las de LaTeX y guardar el resultado en un fichero con la extensión .tex, que es la forma canónica de identificar ficheros LaTeX:

sed -f txt2latex.sed texto_etiquetado.txt >texto_etiquetado.tex

El resultado deja mucho que desear:

\section{
Navegación gráfica
}



Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:
...

Los espacios en blanco están por doquier y se han generado saltos de línea donde no debía haberlos.

La causa del problema está en que sed, tras realizar cada sustitución, incluye el salto de línea en las líneas modificadas. Este comportamiento es conveniente en la mayoría de los casos ---nadie esperaría que sed se comiese el salto de línea, cuando de lo que se trata es de cambiar sólo una parte de una línea. Sin embargo, este educada manera de obrar es fatal para el caso que nos ocupa. 

Hay varias formas de resolver el problema, que pasan por utilizar otro ayudante que no sea sed. Pero quizá la más sencilla para nuestro caso particular, y que no nos obliga a renunciar a sed, sea darle como entrada el mismo fichero pero transformado previamente en una única línea. Las marcas seguirán allí intactas y nada provocará saltos de línea innecesarios, más allá de los que nosotros hemos decidido producir en nuestras sustituciones, puesto que sed trabajará sobre una línea única.

Hacer que las múltiples líneas de un fichero se unan y constituyan una única línea se puede conseguir con distintas órdenes de HAL. Una de las más simples es la orden tr (de translate). Esta orden dispone de una opción adecuada a nuestros fines, la opción -d, que elimina (delete) de la entrada el carácter que demos como argumento a esa opción. Por ejemplo:

tr -d 'a'

eliminaría todas las aes de nuestra entrada.

Para convertir múltiples líneas en una única línea, el carácter que deberemos eliminar es justamente el salto de línea. Por tanto:

tr -d '\n'

es la orden apropiada para lograr nuestro propósito.

Hemos dicho que tr afecta a la "entrada" y no simplemente al "fichero" dado como argumento. ¿Por qué? La razón es que tr es una de esas pocas órdenes que no permite ficheros como argumentos. Dicho de otra forma, tr actúa sólo y directamente sobre el flujo de entrada del que se nutre. Esta característica la hace especialmente apta para integrarse en tuberías. Pero en nuestro caso, sigue siendo un fichero el que queremos darle como alimento. 

Existe una forma de dar un fichero de alimento a una orden que trabaja únicamente sobre el flujo de entrada. Es una herramienta más de fontanería, el reverso del famoso embudo (>) que aplicamos para redirigir la salida de una orden a un fichero. Existe otro embudo, <, que realiza la función contraria: redirige un fichero hacia la entrada estándar. Si en el otro lado (el izquierdo) hay una orden que puede alimentarse directamente desde la entrada estándar (cualquiera de los filtros que hemos visto en anteriores artículos: sed, grep, etc.) o que sólo se alimenta de ella, como tr, el fichero redirigido se convertirá en la entrada de la orden.

En consecuencia, para que nuestra anterior orden de supresión de saltos de línea haga su efecto sobre el fichero texto_etiquetado.txt, deberíamos decirle a HAL lo siguiente:

tr -d '\n'< texto_etiquetado.txt

Con este paso previo se puede ya construir la orden completa, puesto que el resultado de la acción de tr se puede enviar sin problemas a sed mediante una tubería y redirigir lo que produce sed al fichero texto_etiquetado.tex:

tr -d '\n'< texto_etiquetado.txt | sed -f txt2latex.sed >texto_etiquetado.tex

Lo cual produce el documento con todas las transformaciones propias de LaTeX que hemos solicitado:

\section{Navegación gráfica}
Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:

\begin{enumerate}
\item Ir al menú <<Archivo>> del navegador y guardar como texto la página web. (Lo que además implica seleccionar un nombre de fichero y un directorio).
\item Crear en Vim una nueva ventana para editar en ella el documento que acabamos de guardar, mediante la orden :new ruta\_fichero.
\end{enumerate}

\section{Navegación desde consola}
Si navegamos con w3m, y gracias a la interacción entre las aplicaciones de consola, bastaría ejecutar una única acción desde el propio Vim, que, además, podríamos abreviar para reproducirla en situaciones semejantes. Veamos cómo.

Con w3m el proceso de convertir una página web en texto es absolutamente elemental: añadir la opción -dump. Por ejemplo:

w3m -dump http://www.w3.org/TR/html401/struct/lists.html

nos devuelve la página dada como argumento, tal cual se presenta en el navegador, pero como puro texto.



Resumen:

Las expresiones regulares para sed no son idénticas a las expresiones regulares extendidas. Ello implica que muchos caracteres típicos de las EREs tengan que escaparse en sed.

sed registra las agrupaciones que en los patrones de expresiones regulares aparecen entre paréntesis \(...\) y los guarda para su uso posterior. Para recuperar lo contenido en esos registros se utilizan los signos de referencias hacia atrás (\1, \2, ..., \9), cada uno de los cuales remite a la primera, segunda, ..., novena agrupación de la expresión regular del caso.

La orden tr traduce o elimina (con la opción -d) caracteres de la entrada estándar. Por ejemplo tr -d '\n' elimina los saltos de línea del flujo de entrada.

Existen órdenes de HAL que se nutren únicamente de la entrada estándar, como tr y no pueden recibir un fichero como argumento.

El embudo < permite redirigir un fichero a la entrada estándar y, por extensión, a una orden que se alimente de la entrada estándar. Por ejemplo, tr -d '\n'< mi_fichero, hace que el fichero mi_fichero sea la entrada de la orden tr.




HAL y las marcas (LaTeX - I)
2009-03-20T00:40:00.005+01:00
En los artículos anteriores de esta sección hemos entrado en contacto con la noción de marcar un texto y hemos experimentado con el lenguaje de marcas más ampliamente usado y probablemente más conocido, HTML, uno de los pilares de la Internet actual. Es un buen punto de partida, dada su simplicidad y omnipresencia. Pero hay unos cuantos lenguajes de marcas más ahí dentro y hay expertos en las fábricas de HAL cuya pericia indiscutible ha resistido la prueba de los años.

En los próximos artículos conoceremos al que tal vez sea el más conspicuo de estos sistemas. Se trata de LaTeX, de ese mismo LaTeX que tan merecidos elogios viene recibido desde su nacimiento por parte de tipógrafos y diseñadores profesionales y del que nosotros, simples escritores legos en la materia, vamos a poder disfrutar con muy poco esfuerzo.

De la "filosofía" y el sentido de LaTeX hemos hablado ya en varias ocasiones (por ejemplo, en el primer artículo de este TeXemplar). No viene, pues, al caso repetir más de la cuenta lo dicho tantas veces. El lector podrá encontrar información básica en castellano, y enlaces seleccionados a textos introductorios públicamente accesibles, en la sección de manuales de la web de CervanTeX, el grupo de usuarios hispanohablantes de TeX.

Sigamos, pues, un procedimiento semejante al que aplicamos  con HTML. Empezaremos viendo cuáles son las marcas de LaTeX equivalentes a aquéllas informales con que etiquetamos nuestro texto:

INICIO TÍTULO SECCIÓN:
\section{

FIN TÍTULO SECCIÓN
}

INICIO SECCIÓN
[No necesario]

FIN SECCIÓN
[No necesario]

INICIO PÁRRAFO
[No necesario]

FIN PÁRRAFO
Línea en blanco

INICIO LISTA NUMERADA
\begin{enumerate}

FIN LISTA NUMERADA
\end{enumerate}

INICIO ELEMENTO LISTA
item¶ [donde '¶' es un espacio en blanco]

FIN ELEMENTO LISTA
[No necesario]

INICIO NOMBRE PROGRAMA
[Depende del paquete LaTeX usado o de la marca personal creada]

FIN NOMBRE PROGRAMA
[Depende del paquete LaTeX usado o de la marca personal creada]

INICIO OPCIÓN
[Depende del paquete LaTeX usado o de la marca personal creada]

FIN OPCIÓN
[Depende del paquete LaTeX usado o de la marca personal creada]

INICIO ORDEN
[Depende del paquete LaTeX usado o de la marca personal creada]

FIN ORDEN
[Depende del paquete LaTeX usado o de la marca personal creada]


La diferencia de las marcas de LaTeX con las de HTML es evidente. La sintaxis de LaTeX es más irregular, pero, a la vez, bastante menos prolija, lo que implica que marcar textos con LaTeX es mucho más fácil que hacerlo con HTML, una vez conocidas las marcas adecuadas.

Echemos un vistazo al primer párrafo de nuestro texto tal como quedaría tras sustituir nuestras marcas informales con las de LaTeX (se omiten las marcas correspondientes a nombres de programas, opciones y órdenes, que se explicarán más adelante):

\section{Navegación gráfica}
Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:

\begin{enumerate}
\item Ir al menú <<Archivo>> del navegador y guardar como texto la página web. (Lo que además implica seleccionar un nombre de fichero y un directorio).
\item Crear en Vim una nueva ventana para editar en ella el documento que acabamos de guardar, mediante la orden :new ruta\_fichero.
\end{enumerate}

Describir la razón de la sintaxis de LaTeX rebasa el nivel introductorio de estos artículos. La mayoría de la gente que utiliza LaTeX la aprende sin mayor cuestionamiento, y es realmente fácil de aprender, si nos atenemos a su uso básico, que es válido para el 99% de los casos habituales. Así que no comentaremos nada más que lo evidente. Y lo evidente salta a la vista. 

Todas las marcas tienen en común el ir precedidas por el carácter de barra invertida '\'. Los dos tipos de marcas más frecuentes son:

\estructura{texto marcado}
Un texto se define por la estructura lógica o textual que le conviene. Por ejemplo, \section{texto} define el texto englobado como título de una sección. (Nota: lo que hay tras el título de sección hasta una nueva \section{...}, o hasta el comienzo de una estructura de más alto nivel como \chapter{...} o hasta el final del documento, se considera parte de la sección iniciada por el título anterior. Es por esta razón por la que no es necesario indicar expresamente donde comienza o termina el contenido propiamente dicho de la sección).

\begin{entorno}texto\end{entorno}
Un texto puede considerarse un bloque relativamente independiente, textualmente hablando, de lo que le rodea. Un entorno aisla ese texto y lo identifica como perteneciente a una categoría estructural o textual especial. Por ejemplo, \begin{enumerate}texto\end{enumerate} caracteriza el texto englobado como una lista ordenada.


Por su parte la marca \item texto identifica el texto como un elemento de una lista. Se trata de un caso de marca especial para elementos de cualquier lista, donde no se consideran necesarias las llaves delimitadoras. Sería, en efecto, bastante molesto tener que escribir \item{texto} cuando el texto fuera de cierta longitud.

Una marca particularmente significativa es la que corresponde al fin de párrafo, la línea en blanco. Mientras que en HTML las líneas en blanco no existen para el navegador que interpretará el documento, en LaTeX las líneas en blanco tienen un significado fundamental, separan párrafos. Así, en nuestro ejemplo, el primer párrafo se separa del segundo, en este caso de una lista, gracias a la línea en blanco (Nótese que la lista puede constituir un párrafo por sí sola, como en nuestro caso, o formar parte de un párrafo existente. El escritor es quien decide, aunque la diferencia, en nuestro caso concreto, resultará prácticamente inapreciable). Utilizar la línea en blanco para delimitar párrafos es, contra lo que parece, una ventaja que LaTeX proporciona al escritor. Nunca el escritor tuvo que explicitar dónde había una separación de párrafos, le bastaba con introducir una línea en blanco para que todos lo entendiésemos. Disponer de una marca específica para párrafos sólo es necesario con lenguajes de marcas altamente formalizados como HTML. LaTeX, aunque menos riguroso en su forma, es más afín en esto a la práctica habitual de la escritura [Ver, además, mi primer comentario a este artículo].

El lector atento habrá observado que hemos coloreado de azul los signos '<<' y '>>' de comillas angulares y los signos '\_'. En el texto original las comillas aparecían como dobles comillas (") y el guión bajo no venía precedido por la barra. ¿Por qué hemos tenido que cambiarlos? La razón es diferente en cada caso. 

Las comillas angulares son las comillas ortotipográficamente correctas en español y LaTeX es muy pulcro con la ortotipografía. No aceptará así como así las dobles comillas. LaTeX nos obliga, pues, a escribir buen español: una ventaja añadida).

Un caso diferente es el del guión bajo. Resulta que este guión tiene un significado especial en LaTeX. Como de costumbre, cuando queremos introducir literalmente un carácter especial debemos encontrar un modo de "escaparlo". Por suerte, el carácter de escape es aquí el de siempre, la barra invertida. Lo mismo vale para estos otros caracteres especiales ('#', '$', '%', '&', '{' y '}'), que también deben escaparse, si se quieren introducir literalmente, con la barra invertida. [Los otros tres caracteres especiales, que raramente escribirá el lector no informático, ('^', '\' y '~') se escapan, respectivamente, con \textasciicircum, \textbackslash y \textasciitilde].


Resumen:

LaTeX es un lenguaje de marcas especialmente indicado cuando lo que se desea es producir un documento de calidad profesional destinado a ser impreso.

Muchas editoriales científicas, y no científicas, de prestigio utilizan LaTeX como sistema de preparación de sus ediciones.

Las marcas de LaTeX empiezan con el carácter '\'.

La sintaxis de LaTeX es más irregular que la de otros lenguajes de marcas como HTML. A cambio, suele ser más amigable y menos prolija.

La línea en blanco separa párrafos en LaTeX.

La forma correcta de entrecomillar en español son las comillas angulares. LaTeX requiere de este tipo de comillas, cuando el texto está en español.

Hay que cuidar de no introducir literalmente caracteres especiales de LaTeX sin "escaparlos".




HAL y las marcas (CSS)
2009-03-18T11:04:00.005+01:00
Si abrimos en un navegador (por ejemplo, Iceweasel) la página web creada el día pasado tras convertir nuestras marcas informales en marcas HTML, veremos el siguiente resultado:



¿Por qué precisamente esta un tanto rudimentaria página y no una de aquéllas más vistosas que visitamos cotidianamente?

La razón es que el equipo de diseño que funciona por defecto en nuestro navegador se limita a realizar su trabajo del modo más simple posible, sin filigranas ni sofisticaciones de ninguna clase. Si queremos más, tenemos que convertirnos nosotros mismos en diseñadores. No es nuestra intención ---lo hemos establecido desde el principio--- asumir más responsabilidades de las que nos competen como escritores. Sin embargo, y con un fin puramente didáctico, vamos a tratar de definir un estilo más elaborado para nuestro texto. Como se trata de una tarea que no vamos a realizar y que se presenta sólo con fines didácticos, no entraremos en detalles.

Uno de los procedimientos, el más extendido y conveniente, de definir el diseño de nuestro página es utilizar lo que se denomina una hoja de estilo (stylesheet). La definición de hojas de estilo para documentos HTML se atiene a las especificaciones del lenguaje llamado CSS (Cascading StyleSheets, hojas de estilo en cascada), establecidas también por el W3C. La idea es simple. A cada elemento del documento HTML se le asocia una descripción formal de su estilo. Dentro de la vaga noción de estilo entran cosas como la ubicación precisa del elemento en la página, las dimensiones de la "caja" que lo contiene, el tipo de fuente, el color, etc.

Podríamos, por ejemplo, pensar en los siguientes atributos de estilo para algunos de los elementos de nuestro documento web:

BODY
familia de fuente: sans-serif; relleno: 1,5 emes ---la distancia que ocupa una "m" y media--- en margen izquierdo y derecho.

H2
color: azul suave; fuente: 170% del tamaño del resto del texto y familia sans-serif.

CODE
color: granate


La traducción de estas especificaciones según las convenciones de CSS sería la siguiente:

BODY { font-family:sans-serif; padding: 0 1.5em 0 1.5em }
H2   { font:170% sans-serif; color:#005A9C }
CODE { color:maroon }

Hay varias maneras de integrar esta definición dentro de nuestro documento HTML. Una de ellas es incluirlo dentro del elemento STYLE de HTML, que recibe un atributo (el atributo type) donde se indica el tipo de estilo fijado. STYLE es una de esas informaciones globales sobre el documento que debe aparecer en la sección HEAD. De acuerdo con estas normas, nuestro estilo integrado en el documento sería:

<HEAD>
...
<STYLE type="text/css">
 BODY { font-family:sans-serif; padding: 0 1.5em 0 1.5em }
 H2   { font:170% sans-serif; color:#005A9C }
 CODE { color:maroon }
</STYLE>
</HEAD>

Iceweasel nos presentaría de la siguiente manera nuestro documento estilizado (un resultado de andar por casa, pero quizá no absolutamente insatisfactorio):



Consideremos un estilo aparentemente más trabajado como el siguiente:

BODY { background:brown }
H2   { color:yellow }
EM   { background:navy}
CODE { background:maroon }
P    { text-align:justify }

Más esfuerzo no produce mejor arte, y el resultado de tanto trabajo sería este engendro ---y por engendros parecidos está invadida la Web:



Moraleja: "zapatero a tus zapatos". Aunque la seducción de los atractivos visuales es grande, y grande la posibilidad de que cualquier advenedizo se entregue a la entretenida experiencia de estilizar sus producciones, más vale evitar la tentación y dejar que los expertos realicen su trabajo, que bastantes años les ha llevado aprenderlo. Como escritores nos seguiremos conformando con la hoja de estilo básica que por defecto proporciona el navegador o, al menos, si insistimos en practicar la definición del estilo, reservar nuestros juguetes para nosotros mismos, sin hacer que el resto del mundo sea partícipe de nuestras más que probables chapuzas.


HAL y las marcas (HTML - II)
2009-03-17T14:02:00.004+01:00
Nuestro texto, marcado como prescribe la especificación de HTML, esta casi listo para ser interpretado adecuadamente por un navegador. Sólo le faltan unos detalles más, los más engorrosos y desagradables para alguien no particularmente interesado en los entresijos de HTML. Nos conformaremos con incluirlos sin apenas comentario, dando por hecho que el lector curioso sabrá encontrar la información pertinente en la referencia que se indica al final del artículo.

Los gabinetes de especialistas a los que vamos a dirigir nuestro texto marcado suelen ser muy puntillosos en la forma de remitírselo. Tampoco es nada nuevo, estamos acostumbrados en la vida diaria a pasar por toda clase de formalismos endemoniados cuando tratamos de realizar ciertas gestiones que desde nuestro punto de vista son elementales (que si la maldita fotocopia del DNI, que si una copia compulsada de la cabecera de vaya usted a saber qué recibo, ...). Los receptores de nuestros textos marcados gustan de ese mismo rigor protocolario. Sus razones tienen, y no vamos a analizarlas. Ahora es cuestión sólo de conocer la fórmula y perder el menor tiempo posible en tratar de desentrañar su sentido.

Bien, recurramos a una metáfora que hará más entretenida esta burocrática tarea. Imaginemos que nos dirigimos a la ventanilla de la oficina de nuestro navegador web para informarnos de cómo enviarles el texto que acabamos de marcar. Los funcionarios del navegador nos notificarán que tenemos que utilizar un sobre y que no podemos emplear cualquier clase de sobre. Es necesario un sobre especial, que recibe el nombre BODY. Pero no basta, conviene incluir además, en otro sobre aparte ---y que se vea al principio---, llamado HEAD, información de orden global sobre el documento, por ejemplo, el tipo de codificación de caracteres con el que ha sido escrito. Esos dos sobres deben introducirse a su vez en otro mayor, denominado HTML, en cuya solapa se pegará una etiqueta donde conste claramente expresado el tipo de documento que remitimos. Si ahora pensamos en los sobres implicados como marcas globales de HTML, nuestro envío deberá atenerse al siguiente formato:

DECLARACIÓN DEL TIPO DE DOCUMENTO
<HTML>
<HEAD>
[Metainformación (como codificación del documento) y otras informaciones de orden global.]
</HEAD>

<BODY>
[Nuestro texto con las marcas HTML.]
</BODY>
</HTML>

Preparados los sobres e informados puntual y minuciosamente por los oficinistas del navegador, rellenamos todo lo burocráticamente necesario y metemos en el sobre BODY nuestro texto con las marcas HTML visto ayer:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
   "http://www.w3.org/TR/html4/strict.dtd">
<HTML>
<HEAD>
<META content="text/html; charset=UTF-8">
</HEAD>

<BODY>
<H2>
Navegación gráfica
</H2>

<DIV>
<P>
Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:
</P>

<OL>
<LI>
Ir al menú "Archivo" del navegador y guardar como texto la página web. (Lo que además implica seleccionar un nombre de fichero y un directorio).
</LI>

<LI>
Crear en <EM>Vim</EM> una nueva ventana para editar en ella el documento que acabamos de guardar, mediante la orden <CODE>:new ruta_fichero</CODE>.
</LI>
</OL>
</DIV>

<H2>
Navegación desde consola
</H2>

<DIV>
<P>
Si navegamos con <EM>w3m</EM>, y gracias a la interacción entre las aplicaciones de consola, bastaría ejecutar una única acción desde el propio <EM>Vim</EM>, que, además, podríamos abreviar para reproducirla en situaciones semejantes. Veamos cómo.
</P>

<P>
Con <EM>w3m</EM> el proceso de convertir una página web en texto es absolutamente elemental: añadir la opción <CODE>-dump</CODE>. Por ejemplo:
</P>

<P>
<CODE>w3m -dump http://www.w3.org/TR/html401/struct/lists.html</CODE>
</P>

<P>
nos devuelve la página dada como argumento, tal cual se presenta en el navegador, pero como puro texto.
</P>
</DIV>
</BODY>
</HTML>

Sería insoportablemente aburrido tener que repetir "el papeleo" cada vez que enviamos al navegador un documento web. Es frecuente, por ese motivo, crearse una plantilla con las partes áridas y comúnmente compartidas por todos los documentos html que vayamos a producir y concentrarse en el marcado del texto propiamente dicho. Por supuesto, otra forma, mucho más del gusto de HAL, sería crear un guión que incorporase nuestra anterior orden sed y que de paso añadiese el resto del formulismo.

Un guión posible para esta tarea ---uno más para nuestro directorio guiones--- sería éste. Lo llamaremos generar_html:

## --* generar_html - 18/03/09 - átopos *--
## Genera documento HTML canónico a partir de un documento de texto 
## marcado con mis marcas informales
SED_F=txt2html.sed                    # Fichero sed: convierte mis marcas 
                                      #              informales en marcas HTML
ORIG_F=$1                             # Fichero de entrada
DEST_F=$(basename $ORIG_F .txt).html  # Fichero HTML de salida

sed -f $SED_F $ORIG_F \
| awk 'BEGIN {
               print "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01//EN\""; 
               print "\t\"http://www.w3.org/TR/html4/strict.dtd\">";
               print "<HTML>";
               print "<HEAD>"; 
               print "<META content=\"text/html; charset=UTF-8\">";
               print "</HEAD>";
               print "\n<BODY>";
             }
             { print $0; }
       END   { print "</BODY>";
               print "</HTML>";
             }' \
> $DEST_F

El guión presupone que el fichero txt2html.sed, creado el día pasado, se encuentra en el mismo directorio donde está el guión, en nuestro caso, el directorio guiones.

Para generar el documento HTML, deberíamos cambiar el modo del guión y solicitar a HAL su ejecución con la siguiente orden:

./generar_html texto_etiquetado.txt

El resultado será el fichero texto_etiquetado.html cuyo contenido será el referido en este artículo.

La única orden de HAL que aparece en ese guión y que no hemos explicado todavía en estas conversaciones es la orden basename. El lector sabrá encontrar la información concerniente a ella recurriendo a man.

Asimismo, el lector interesado en profundizar en lo expuesto durante estos días podrá encontrar toda clase de información sobre las marcas utilizadas y el resto de marcas HTML en la referencia definitiva de la especificación actualmente más usada de HTML, que se puede encontrar aquí:

http://www.w3.org/TR/html401/

Por supuesto, se debe comprobar que el HTML funciona, abriéndolo con cualquier navegador:

w3m texto_etiquetado.html

¡Felices sueños!


HAL y las marcas (HTML - I)
2009-03-17T10:32:00.004+01:00
Una vez expuesta la manera general e informal de marcar un texto, convoquemos al primer experto, el menos sofisticado de los que vamos a ver, el propio navegador web, que es primariamente el productor de la versiones finales de los textos que visitamos en la Web.

Todo navegador web entiende, como mínimo, una serie de marcas convencionalmente estipuladas para definir la estructura de nuestro documento. El conjunto de estas convenciones y las prescripciones de su uso se denomina HTML (HyperText Markup Language, lenguaje de marcas de hipertexto). Bajo este amenazador título no hay más que la descripción precisa de las marcas (y del uso de esas marcas) que debo introducir en mi escrito para que un navegador web las presente como una página web. Esta descripción surge del común acuerdo de las partes implicadas (creadores de contenidos web, desarrolladores de navegadores, etc.) y se recogen en las especificaciones del consorcio W3C. Dicho de otra manera, saber HTML es conocer qué marcas debo poner en mi texto para que un navegador las entienda y cómo debo escribirlas.

Como HTML es un sistema de marcas genérico, dispondremos de marcas equivalentes para aquellas que son comunes a todo texto. No podremos contar, sin embargo, con marcas especialmente apropiadas para los elementos característicos y únicos de nuestro texto, ni tampoco con la posibilidad de crear dichas marcas por nosotros mismos. Por tanto, todos los elementos específicos de nuestro texto anterior (nombre de programa, orden y opción) deberán marcarse con alguna clase de marca genérica de HTML.

Veamos, primero, el nombre de los elementos HTML genéricos que constituyen nuestro texto de ejemplo. Se trata de abreviaturas de palabras inglesas que designan el significado estructural del elemento marcado:

DIV
Division = Sección, división

Hn
Header = Cabecera o título (donde n es un número que indica el nivel de título, '1' para el título del nivel más alto y '6' para el de mínimo nivel. Por ejemplo, H1 designaría el título general del texto; H2, el de las secciones principales; etc).

OL
Ordered List = Lista ordenada

LI
List Item = Elemento de lista

P
Paragraph = Párrafo


A ellos habría que añadir los siguientes elementos HTML, que utilizaremos para identificar aquéllos de nuestro texto que son característicos únicamente de él. Los nombres de programa los marcaremos como fragmentos de texto enfatizados y las opciones y las órdenes como fragmentos de código de computador:

EM
Emphasis = Énfasis

CODE
Code = Código


Las marcas HTML de comienzo y fin de elemento para los elementos citados se construyen enmarcando el nombre del elemento en paréntesis angulares, cuando la marca es la de inicio (por ejemplo, <P> sería la marca HTML para indicar el comienzo de un párrafo), y añadiendo una barra ('/') a dicha marca después del primer paréntesis, cuando la marca es la de fin (por ejemplo, </P> sería la marca HTML para señalar el fin de un párrafo).

En consecuencia, las marcas HTML que corresponderán a los elementos de nuestro texto y que equivalen a las marcas informales que aplicamos en el anterior artículo son las siguientes:

INICIO TÍTULO SECCIÓN:
<H2>

FIN TÍTULO SECCIÓN
</H2>

INICIO SECCIÓN
<DIV>

FIN SECCIÓN
</DIV>

INICIO PÁRRAFO
<P>

FIN PÁRRAFO
</P>

INICIO LISTA NUMERADA
<OL>

FIN LISTA NUMERADA
</OL>

INICIO ELEMENTO LISTA
<LI>

FIN ELEMENTO LISTA
</LI>

INICIO NOMBRE PROGRAMA
<EM>

FIN NOMBRE PROGRAMA
</EM>

INICIO OPCIÓN
<CODE>

FIN OPCIÓN
</CODE>

INICIO ORDEN
<CODE>

FIN ORDEN
</CODE>


Procedamos, pues, a sustituir nuestras marcas informales por las marcas HTML convenidas. Para ello, por supuesto, merece la pena recurrir a HAL, concretamente a sed. 

Guardemos el texto con nuestras etiquetas iniciales en el fichero texto_etiquetado.txt. [Si el lector utiliza Vim para copiar el texto desde esta web al susodicho fichero, ejecute antes de hacerlo la orden :set wrapmargin=0, ello impedirá que se creen saltos de línea donde no debe haberlos y evitará comportamientos inesperados de sed; en caso de emplear otros editores, asegúrese de que la generación de saltos de línea automáticos no está activada.]

Crearemos también un fichero, que llamaremos txt2html.sed, y escribiremos en él las siguientes órdenes de sed, que son las que realizan una a una la conversión requerida:

s/INICIO TÍTULO SECCIÓN/<H2>/g
s/FIN TÍTULO SECCIÓN/<\/H2>/g
s/INICIO SECCIÓN/<DIV>/g
s/FIN SECCIÓN/<\/DIV>/g
s/INICIO PÁRRAFO/<P>/g
s/FIN PÁRRAFO/<\/P>/g
s/INICIO LISTA NUMERADA/<OL>/g
s/FIN LISTA NUMERADA/<\/OL>/g
s/INICIO ELEMENTO LISTA/<LI>/g
s/FIN ELEMENTO LISTA/<\/LI>/g
s/INICIO NOMBRE PROGRAMA/<EM>/g
s/FIN NOMBRE PROGRAMA/<\/EM>/g
s/INICIO ORDEN/<CODE>/g
s/FIN ORDEN/<\/CODE>/g
s/INICIO OPCIÓN/<CODE>/g
s/FIN OPCIÓN/<\/CODE>/g

Ahora podemos pedir a sed que realice la sustitución de marcas y guarde el resultado en el fichero texto_etiquetado.html. (Nótese que al fichero le añadimos la extensión html puesto que el fichero resultante contendrá marcas html). 

Pero vamos a poner a trabajar a sed de una manera diferente a como lo hemos hecho habitualmente. Se recordará que la orden para sed se le daba como su primer argumento:

sed ORDEN_SED FICHERO

Cuando había varias órdenes ---no lo explicamos expresamente, pero sí lo utilizamos, por ejemplo, aquí--- se recurría la opción -e ORDEN, que se podía repetir cuantas veces quisiéramos:

sed -e ORDEN1 -e ORDEN2 ... FICHERO

Ahora bien, cuando el número de órdenes para sed es grande, como en nuestro presente caso, es preferible guardarlas en un fichero en lugar de escribirlas directamente en la línea de órdenes y utilizar la opción -f para que sed lea sus órdenes de ese fichero:

sed -f FICHERO_ORDENES FICHERO

Por tanto, la orden que en esta ocasión enviaremos a HAL para que sed nos libere del pesadísimo trabajo de realizar a mano la conversión es la siguiente:

sed -f txt2html.sed texto_etiquetado.txt >texto_etiquetado.html

Y el resultado será éste:

<H2>
Navegación gráfica
</H2>

<DIV>
<P>
Si hubiésemos estado visitando la página con un buen navegador gráfico que disponga de la opción de guardar las páginas web como texto, tendríamos que realizar al menos dos acciones, ambas independientes:
</P>

<OL>
<LI>
Ir al menú "Archivo" del navegador y guardar como texto la página web. (Lo que además implica seleccionar un nombre de fichero y un directorio).
</LI>

<LI>
Crear en <EM>Vim</EM> una nueva ventana para editar en ella el documento que acabamos de guardar, mediante la orden <CODE>:new ruta_fichero</CODE>.
</LI>
</OL>
</DIV>

<H2>
Navegación desde consola
</H2>

<DIV>
<P>
Si navegamos con <EM>w3m</EM>, y gracias a la interacción entre las aplicaciones de consola, bastaría ejecutar una única acción desde el propio <EM>Vim</EM>, que, además, podríamos abreviar para reproducirla en situaciones semejantes. Veamos cómo.
</P>

<P>
Con <EM>w3m</EM> el proceso de convertir una página web en texto es absolutamente elemental: añadir la opción <CODE>-dump</CODE>. Por ejemplo:
</P>

<P>
<CODE>w3m -dump http://www.w3.org/TR/html401/struct/lists.html</CODE>
</P>

<P>
nos devuelve la página dada como argumento, tal cual se presenta en el navegador, pero como puro texto.
</P>
</DIV>



Resumen

HTML es un lenguaje de marcas. El navegador web procesa un texto marcado con marcas HTML para su visualización adecuada como página web.

HTML utiliza nombres especiales para designar los elementos estructurales y genéricos de todo texto (sección, título, párrafo, lista, etc.). Por ejemplo, DIV es la forma de llamar en HTML a una sección: P, a un párrafo, etc.

Las marcas HTML se construyen a partir del nombre del elemento que se ha de marcar, englobándolo en paréntesis angulares y distinguiendo la marca de inicio de la marca de cierre. Por ejemplo, <P> es la marca de inicio de un párrafo y </P> es la de cierre.

La opción -f de la orden sed permite agrupar varias órdenes de sed en un mismo fichero y pasárselas a sed sin que sea necesario escribirlas directamente en la línea de órdenes. Por ejemplo, sed -f mis_ordenes mi_fichero ejecutará las órdenes de sed que constan en el fichero mis_ordenes para procesar el fichero mi_fichero.