PDF de programación - 3 Afronta el desafío - Revista del Software Libre ATIX

Dirección y Coordinación General
Esteban Saavedra López ([email protected])

Diseño y Maquetación 
Jenny Saavedra López ([email protected])
Esteban Saavedra López ([email protected])

Colaboración
Williams Chorolque Choque ([email protected])

Herramientas

La edición de esta revista fue realizada de forma integra haciendo uso de Software
Libre



El ser humano desde el momento en que nace, por instinto va afrontando una serie
de retos o desafíos, desde conocer su entorno, percibir los sentimientos que
expresan las personas que los rodean, e identificar características que le interesan
dentro su contexto. Todo ésto hace que el hombre vaya fortaleciendo su
conocimiento y madurando su carácter; dos aspectos que lo llevarán en un futuro a
valerse por si mismo y a buscar sentido a su existir.

Es bien sabido que a lo largo de nuestras vidas, hemos de afrontar una serie de
desafíos, pero también es sabido que muchos se atreverán a ésto y mucho no, ya
sea por miedo al fracaso o por falta de preparación.

Afronta el desafío, un título que encierra un gran significado, por las características
que abarca éste término; mismo que pretendemos que apliquen todas las personas
en su continuo vivir, porque afrontar es saber cuan bien o mal estamos preparados,
o cuan lejos deseamos llegar en nuestras vidas. Vamos Afronta el desafío, no te
quedes con la duda o vivas preguntándote como habría sido....

En éste tercer número ponderamos aspectos como la entrevista a Alberto
Barrionuevo presidente de la Foundation for a Free Information Infrastructure ,
a quién ofrecemos nuestra gratitud por concedernos una entrevista; en la que
detalla varias características de como ésta fundación tiene el desafío de promover el
uso de los estándares abiertos en el intercambio de información; un segundo
aspecto va referido a la cobertura del lanzamiento de la distribución Boliviana
BoliviaOS, un desafío hecho realidad.

Afronta el desafío y vive con Libertad.

Bienvenidos a nuestro tercer número

Esteban Saavedra López
Director y Coordinador General

ReStructuredText:
Realizando documentos de
forma rápida y sencilla



pequeños



Éstas marcas tratan de ser en lo posible
mínimas y discretas.
ReStructuredText
es aplicable a
documentos de cualquier tamaño, desde los
de
más
(fragmentos
documentación de programas),
hasta
documentos muy extensos (manuales,
cursos,....).

ReStructuredText es un lenguaje de marcas ligero creado para escribir textos de
manera cómoda y rápida. Tiene la principal ventaja de que éste texto puede usarse
para generar documentos equivalentes en HTML, LaTeX, docbook, XML, etc
Introducción
Muchas veces nos encontramos en la tarea
de realizar frecuentemente documentos, ya
sea cursos, tutoriales, traducciones, etc; y por
temas de rapidez, sencillez y control de
versionamiento del documento preferimos
hacer uso de un editor de textos plano en
lugar de hacer uso de un procesador de
texto.
En todo el tiempo que llevo en el área de la
investigación y el software libre he aprendido
lo importante que es contar con herramientas
que nos ayuden a reutilizar el material que
tenemos, concretamente en la tarea de
realizar documentación, preferimos contar
con formatos y herramientas que permitan
exportar nuestros documentos a otros
equivalentes, dependiendo de cómo sean
accedidos o publicados a posteori.
Una de las varias alternativas para realizar
este
los
ReStructuredText, cuya construcción y
estructura es totalmente sencilla, fácil de
comprender y realizar.

✔ Desarrollo rápido.
✔ Desarrollo estructurado.
✔ Reutilización de código.
✔ Disminuir el esfuerzo.
✔ Aprovechar las herramientas de
conversión que existen, no debemos
reinventar la rueda.

Características de los RST

Objetivos de un RST

tipo de documentos son



✔ Facilidad
✔ Sencillez
✔ Exportable

Que son los archivos rst
Los archivos .rst son archivos de texto plano,
que usan simples e intuitivas construcciones
para indicar la estructura de un documento.
Éstas construcciones son igualmente fáciles
de leer dentro de formas nativas (texto plano)
y procesadas.
El marcado sencillo que usa sirve para
indicar construcciones especiales como:
títulos, subtítulos, párrafos, listas, énfasis.



a



documentos

equivalentes.
Independiente de la plataforma.

✔

Qué precisamos
En realidad para la construcción del archivo
rst sólo nos hace falta contar con un editor de
texto plano, para nuestro caso podríamos
hacer uso del famoso Vim o de Gedit.

En el caso que queramos exportar a
documentos equivalentes como HTML, Latex,
XML; debemos tener instalado Docutils que
está hecho en Python.

Estructura de un documento
Hoy en día, en la tarea de realizar
documentación, se mantiene una forma
similar de estructurar los documentos, dónde
se consideran casi siempre las mismas

partes (títulos, subtítulos, párrafos, listas,
bloques, tablas,énfasis,.... ).

Nuestro primer documento
rst
Para una mejor comprensión del potencial de
ReStructuredText en el desarrollo de
documentación, realizaremos una documento
tomando en cuenta las construcciones de
más frecuente uso.

Texto que incluye construcciones rst

Resultado obtenido, después de una
exportación a HTML

Secciones de Título
===================
Título2
-------
Título3
.......
Título4
~~~~~~~
Título5
*******
Título6
+++++++
Título7
^^^^^^^
Párrafos
========
Un párrafo es un bloque de texto,
generalmente alineado a la izquierda.
Los párrafos son separados por líneas en
blanco.

Listas
======
Listas no numeradas
-------------------
Las listas no numeradas son bloques de
texto que empiezan con
'-', '*', '+' seguidos de un espacio.
Para denotar dependencia entre éstas
listas, podemos
hacer uso de un sangrado, por ejemplo:
* Primer Item
* Segundo Item
* Primer elemento segundo item
* Segundo elemento segundo item
* Tercer Item
Listas numeradas
----------------
Estas son análogas a las anteriores, con
la diferencia
que estas pueden incluir cierta
numeración entre bloques de texto.
1. Argentina
a) Buenos Aires
b) Mar del Plata
2. Bolivia
i) La Paz
ii) Oruro
iii) Potosi
3. Chile
I. Santiago
II. Concepción
III. Viña del mar
Los estilos de numeración pueden ser:
'A', 'B', 'I)', 'II)', '(i)', '(ii)',
'a.','b.', '1.', '2.', ...
Listas definidas
----------------
Lista
Una lista definida está asociada a un
término o definición
Definición de Término
Un término es una línea, y su
definición está constituido
por uno o más párrafos, correctamente
identados para resaltar el término.

Lista de opciones
-----------------
-uno
primera opción
segunda opción
-dos
-tres tercera opción,
ésta tiene 2 líneas
y podría tener más

Lista de campos
---------------
Esta nos permite definir campos para
describir las características
de un usuario, programa, etc.
:Autor:
Esteban Saavedra López
:Versión:
1.0
:Fecha:
17/09/2000
Bloques alineados
=================
| Generalmente utilizados para describir
direcciones,
| versos, etc.
|
| Cada línea comienza
con una barra vertical ("|").
| Las líneas mantienen la identación
realizada.
| las líneas continuas son ajustadas.

Manejo de tablas
================
Las tablas son necesarias al momento de
desear tabular descripciones,
resultados y cualquier otro elemento.
Tablas simples
--------------
===== ===== ======
Entradas Salidas
------------ ------
A B A or B
===== ===== ======
False False False
True False True
False True True
True True True
===== ===== ======

Combinación de celdas
---------------------
+------------+-------------+---------------+
| Nombres | Departamento| Funciones |
+============+=============+===============+
| Jeanneth | Asesoría | Asesor |
+------------+-------------+---------------+
| Coordinación revista |
+------------+-------------+---------------+
| Esteban | Dirección | - Revisión |
+------------+ Coordinación| - Maquetación |
| Jenny | | - Publicación |
+------------+-------------+---------------+
Marcas explícitas
=================
Énfasis
-------
Para dar *énfasis* a un cierto texto
sólo basta con encerrarlo entre '*',
claro que también podemos hacer más
**fuerte** éste énfasis, para esto
hacemos uso de '**'.

Notas de pie de página
----------------------
Una nota de pie permite hacer
referencias [1]_ al texto tratado.
En el caso que no recordemos cual el
valor correspondiente de la
nota de pie de página, podemos hacer uso
de [#]_ en cualquier caso [#]_
.. [1] Esta es la descripción de la nota
de pie de página.
.. [#] Este es el primero
.. [#] Este es el segundo

Citas
-----
generalmente para hacer referencias a
citas de alguna literatura como ésta
[ATIX2008]_
.. [ATIX2008] Esta es una cita que hace
referencia a la Revista ATIX

Hiperlinks
----------
Permite hacer referencias a direcciones
web, por ejemplo si deseamos referenciar
a la página de al revista ATIX_
.. _ATIX: http://atix.opentelematics.org
Una segunda forma de realizar éstas
referencias es así
http://www.google.com/
Una tercera forma es hacer referencias
anidadas como por ejemplo: la Revista
ATIX_ es la `Revista de Software Libre
en Bolivia`__.
__ ATIX_
Directivas
----------
Son mecanismos que permiten aumentar
nuevos constructores con nuevas sintasix
.. image:: imagenes/esfera.gif

Sustitu