SlideShare una empresa de Scribd logo
ReStructuredText:
Realizando documentos de
forma rápida y sencilla
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

                                                   Éstas marcas tratan de ser en lo posible
Introducción                                       mínimas y discretas.
Muchas veces nos encontramos en la tarea
                                                   ReStructuredText     es     aplicable     a
de realizar frecuentemente documentos, ya
                                                   documentos de cualquier tamaño, desde los
sea cursos, tutoriales, traducciones, etc; y por
                                                   más        pequeños    (fragmentos      de
temas de rapidez, sencillez y control de
                                                   documentación     de  programas),     hasta
versionamiento del documento preferimos
                                                   documentos muy extensos (manuales,
hacer uso de un editor de textos plano en
                                                   cursos,....).
lugar de hacer uso de un procesador de
texto.
                                                   Objetivos de un RST
En todo el tiempo que llevo en el área de la
investigación y el software libre he aprendido            Desarrollo rápido.
                                                      ✔
lo importante que es contar con herramientas
                                                          Desarrollo estructurado.
que nos ayuden a reutilizar el material que           ✔
tenemos, concretamente en la tarea de                     Reutilización de código.
                                                      ✔
realizar documentación, preferimos contar
                                                          Disminuir el esfuerzo.
con formatos y herramientas que permitan              ✔
exportar nuestros documentos a otros                      Aprovechar las herramientas de
                                                      ✔
equivalentes, dependiendo de cómo sean                    conversión que existen, no debemos
accedidos o publicados a posteori.                        reinventar la rueda.
Una de las varias alternativas para realizar
este tipo de documentos son los
                                                   Características de los RST
ReStructuredText, cuya construcción y
estructura es totalmente sencilla, fácil de               Facilidad
                                                      ✔
comprender y realizar.
                                                          Sencillez
                                                      ✔

                                                          Exportable           a     documentos
                                                      ✔
Que son los archivos rst                                  equivalentes.
Los archivos .rst son archivos de texto plano,            Independiente de la plataforma.
                                                      ✔
que usan simples e intuitivas construcciones
para indicar la estructura de un documento.
                                                   Qué precisamos
Éstas construcciones son igualmente fáciles
de leer dentro de formas nativas (texto plano)
                                                   En realidad para la construcción del archivo
y procesadas.
                                                   rst sólo nos hace falta contar con un editor de
El marcado sencillo que usa sirve para             texto plano, para nuestro caso podríamos
indicar construcciones especiales como:            hacer uso del famoso Vim o de Gedit.
títulos, subtítulos, párrafos, listas, énfasis.
En el caso que queramos exportar a                 partes (títulos, subtítulos, párrafos, listas,
documentos equivalentes como HTML, Latex,          bloques, tablas,énfasis,.... ).
XML; debemos tener instalado Docutils que
está hecho en Python.
                                                   Nuestro primer documento
                                                   rst
Estructura de un documento
                                                   Para una mejor comprensión del potencial de
Hoy en día, en           la tarea de realizar
                                                   ReStructuredText en el desarrollo de
documentación, se         mantiene una forma
                                                   documentación, realizaremos una documento
similar de estructurar   los documentos, dónde
                                                   tomando en cuenta las construcciones de
se consideran casi         siempre las mismas
                                                   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
-dos  segunda opción
-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 (quot;|quot;).
|     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



Sustitución de referencias y
definiciones
----------------------------------------
-

Esto es muy útil cuando tenemos una
directiva como |imagen2| y podemos
reutilizarla varias veces: |imagen2|, |
imagen2|

.. |imagen2| image:: imagenes/esfera.gif
En caso de poseer un documento amplio
con varias secciones y subsecciones,
podemos listar la tabla de contenidos,
para esto usamos la directiva:

.. contents::
Exportando a otros formatos
Hasta este momento nuestro documento, aunque posea la estructura deseada, surge la
necesidad de exportarla para poderla publicar o visualizar en otros entornos: HTML mediante un
browser, PDF o postscript por medio de Latex, XML, una presentación, etc.
Para esta tarea precisamos contar con algunas aplicaciones inmersas dentro del Docutilis, que
son descritas a continuación.




           Resultado de rst2html                            Resultado de rst2s5




           Resultado de rst2xml
                                                           Resultado de rst2latex
Conclusión
En conclusión podemos decir que construir un archivo .rst es de los más sencillo divertido y nos
da la posibilidad de poder exportarlos a una variedad de formatos, dependiendo cual el destino
o la forma de publicarlos.


Referencias
[1]    http://docutils.sourceforge.net/rst.html
[2]    http://docutils.sourceforge.net/docs/ref/rst/introduction.html
[3]    http://skawina.eu.org/mikolaj/vst.html


Autor




Esteban Saavedra López
Líder de la Comunidad ATIX (Oruro – Bolivia)
Activista de Software Libre en Bolivia
jesaavedra@opentelematics.org
http://jesaavedra.opentelematics.org

Más contenido relacionado

Destacado

Asignacion Wb 2.0, Dario
Asignacion Wb 2.0, DarioAsignacion Wb 2.0, Dario
Asignacion Wb 2.0, Dario
Darío R. Rocha Jiménez
 
Gabarito UFPE - 2º dia (14/01/13)
Gabarito UFPE - 2º dia (14/01/13)Gabarito UFPE - 2º dia (14/01/13)
Gabarito UFPE - 2º dia (14/01/13)
Portal NE10
 
Märchen
MärchenMärchen
Märchen
Rocio Ramos
 
Las Cortes de Cádiz 2009-10
Las Cortes de Cádiz 2009-10Las Cortes de Cádiz 2009-10
Las Cortes de Cádiz 2009-10
smerino
 
Zukunftsstudie_Kurzfassung
Zukunftsstudie_KurzfassungZukunftsstudie_Kurzfassung
Zukunftsstudie_Kurzfassung
emotion banking
 
Web 2.0 Werkzeuge und Methoden politischer Bildung
Web 2.0 Werkzeuge und Methoden politischer BildungWeb 2.0 Werkzeuge und Methoden politischer Bildung
Web 2.0 Werkzeuge und Methoden politischer Bildung
davidroethler
 
Themenabend üBergang 45 22.01.09
Themenabend üBergang 45 22.01.09Themenabend üBergang 45 22.01.09
Themenabend üBergang 45 22.01.09
HeFre
 
Parecer da Alepe
Parecer da AlepeParecer da Alepe
Parecer da Alepe
Portal NE10
 
12 Things to Inspire You this Summer
12 Things to Inspire You this Summer12 Things to Inspire You this Summer
12 Things to Inspire You this Summer
Ania Jednacz
 
emotion banking Newsletter 1/2013
emotion banking Newsletter 1/2013emotion banking Newsletter 1/2013
emotion banking Newsletter 1/2013
emotion banking
 
MOOCs - einige Aspekte
MOOCs - einige AspekteMOOCs - einige Aspekte
MOOCs - einige Aspekte
davidroethler
 
Konzept debis Lernwelt 1999/2000
Konzept debis Lernwelt 1999/2000Konzept debis Lernwelt 1999/2000
Konzept debis Lernwelt 1999/2000
Matthias Rückel
 
Ruido ies punta_larga_
Ruido ies punta_larga_Ruido ies punta_larga_
Ruido ies punta_larga_
David Crego Chaves
 
Samsung YP-S3 Vorschau
Samsung YP-S3 VorschauSamsung YP-S3 Vorschau
Samsung YP-S3 Vorschau
marco678
 
Confesión de fe de grandes cientificos
Confesión de fe de grandes cientificosConfesión de fe de grandes cientificos
Confesión de fe de grandes cientificos
Moris Polanco
 
Europäische Länder
Europäische LänderEuropäische Länder
Europäische Länder
Rocio Ramos
 
Videobasiertes E Learning Prof. Dr. A. Back Nov2009
Videobasiertes E Learning Prof. Dr. A. Back Nov2009Videobasiertes E Learning Prof. Dr. A. Back Nov2009
Videobasiertes E Learning Prof. Dr. A. Back Nov2009
University St. Gallen
 
Celulas
CelulasCelulas
Connotea und LibraryThing
Connotea und LibraryThingConnotea und LibraryThing
Connotea und LibraryThing
Nowakman
 

Destacado (20)

Asignacion Wb 2.0, Dario
Asignacion Wb 2.0, DarioAsignacion Wb 2.0, Dario
Asignacion Wb 2.0, Dario
 
Gabarito UFPE - 2º dia (14/01/13)
Gabarito UFPE - 2º dia (14/01/13)Gabarito UFPE - 2º dia (14/01/13)
Gabarito UFPE - 2º dia (14/01/13)
 
Märchen
MärchenMärchen
Märchen
 
Las Cortes de Cádiz 2009-10
Las Cortes de Cádiz 2009-10Las Cortes de Cádiz 2009-10
Las Cortes de Cádiz 2009-10
 
Zukunftsstudie_Kurzfassung
Zukunftsstudie_KurzfassungZukunftsstudie_Kurzfassung
Zukunftsstudie_Kurzfassung
 
Web 2.0 Werkzeuge und Methoden politischer Bildung
Web 2.0 Werkzeuge und Methoden politischer BildungWeb 2.0 Werkzeuge und Methoden politischer Bildung
Web 2.0 Werkzeuge und Methoden politischer Bildung
 
Themenabend üBergang 45 22.01.09
Themenabend üBergang 45 22.01.09Themenabend üBergang 45 22.01.09
Themenabend üBergang 45 22.01.09
 
Parecer da Alepe
Parecer da AlepeParecer da Alepe
Parecer da Alepe
 
12 Things to Inspire You this Summer
12 Things to Inspire You this Summer12 Things to Inspire You this Summer
12 Things to Inspire You this Summer
 
DéPart Qm2
DéPart Qm2DéPart Qm2
DéPart Qm2
 
emotion banking Newsletter 1/2013
emotion banking Newsletter 1/2013emotion banking Newsletter 1/2013
emotion banking Newsletter 1/2013
 
MOOCs - einige Aspekte
MOOCs - einige AspekteMOOCs - einige Aspekte
MOOCs - einige Aspekte
 
Konzept debis Lernwelt 1999/2000
Konzept debis Lernwelt 1999/2000Konzept debis Lernwelt 1999/2000
Konzept debis Lernwelt 1999/2000
 
Ruido ies punta_larga_
Ruido ies punta_larga_Ruido ies punta_larga_
Ruido ies punta_larga_
 
Samsung YP-S3 Vorschau
Samsung YP-S3 VorschauSamsung YP-S3 Vorschau
Samsung YP-S3 Vorschau
 
Confesión de fe de grandes cientificos
Confesión de fe de grandes cientificosConfesión de fe de grandes cientificos
Confesión de fe de grandes cientificos
 
Europäische Länder
Europäische LänderEuropäische Länder
Europäische Länder
 
Videobasiertes E Learning Prof. Dr. A. Back Nov2009
Videobasiertes E Learning Prof. Dr. A. Back Nov2009Videobasiertes E Learning Prof. Dr. A. Back Nov2009
Videobasiertes E Learning Prof. Dr. A. Back Nov2009
 
Celulas
CelulasCelulas
Celulas
 
Connotea und LibraryThing
Connotea und LibraryThingConnotea und LibraryThing
Connotea und LibraryThing
 

Similar a ReStructuredText: Realizando documentos de forma rápida y sencilla

ATIX03
ATIX03ATIX03
Arquitectura de los computadores
Arquitectura de los computadoresArquitectura de los computadores
Arquitectura de los computadores
maryuri yineth pinto gamboa
 
LaTeX
LaTeXLaTeX
Introducción a R Studio para estudiantes.pptx
Introducción a R Studio para estudiantes.pptxIntroducción a R Studio para estudiantes.pptx
Introducción a R Studio para estudiantes.pptx
TaniaEspinoza34
 
ADA 1
ADA 1ADA 1
Software de Procesadores de texto
Software de Procesadores de textoSoftware de Procesadores de texto
Software de Procesadores de texto
Brenda Alexandra Garcia
 
Software para la edición de texto
Software para la edición de textoSoftware para la edición de texto
Software para la edición de texto
Jessire Toro
 
Documentos LaTeX en Ubuntu y Windows
Documentos LaTeX en Ubuntu y WindowsDocumentos LaTeX en Ubuntu y Windows
Documentos LaTeX en Ubuntu y Windows
jlrvpuma
 
Atix03
Atix03Atix03
Atix03
atixlibre
 
Ada 1
Ada 1Ada 1
Procesadores de palabras textos)
Procesadores de palabras textos)Procesadores de palabras textos)
Procesadores de palabras textos)
santos_Jonathan
 
Tipos de procesadores de palabras
Tipos de procesadores de palabrasTipos de procesadores de palabras
Tipos de procesadores de palabras
San Luis Obispo Chamber of Commerce
 
precentacion4
precentacion4precentacion4
precentacion4
Danny Salazar Noboa
 
diapositiva3
diapositiva3diapositiva3
diapositiva3
Danny Salazar Noboa
 
TIPOS DE PROCESADORES DE PALABRAS
TIPOS DE PROCESADORES DE PALABRAS TIPOS DE PROCESADORES DE PALABRAS
TIPOS DE PROCESADORES DE PALABRAS
Jhonathan Guz
 
Procesadores de texto
Procesadores de textoProcesadores de texto
Procesadores de texto
scr110896
 
TAREA 3: EDITORES DE TEXTO
TAREA 3: EDITORES DE TEXTOTAREA 3: EDITORES DE TEXTO
TAREA 3: EDITORES DE TEXTO
instructorabelquis
 
N4 lección13
N4 lección13N4 lección13
N4 lección13
Johanes Ramirez
 
Lenguajes de programación
Lenguajes de programaciónLenguajes de programación
Lenguajes de programación
KenixGalvezGG
 
Procesadores de texto
Procesadores de textoProcesadores de texto
Procesadores de texto
Jhonathan Guz
 

Similar a ReStructuredText: Realizando documentos de forma rápida y sencilla (20)

ATIX03
ATIX03ATIX03
ATIX03
 
Arquitectura de los computadores
Arquitectura de los computadoresArquitectura de los computadores
Arquitectura de los computadores
 
LaTeX
LaTeXLaTeX
LaTeX
 
Introducción a R Studio para estudiantes.pptx
Introducción a R Studio para estudiantes.pptxIntroducción a R Studio para estudiantes.pptx
Introducción a R Studio para estudiantes.pptx
 
ADA 1
ADA 1ADA 1
ADA 1
 
Software de Procesadores de texto
Software de Procesadores de textoSoftware de Procesadores de texto
Software de Procesadores de texto
 
Software para la edición de texto
Software para la edición de textoSoftware para la edición de texto
Software para la edición de texto
 
Documentos LaTeX en Ubuntu y Windows
Documentos LaTeX en Ubuntu y WindowsDocumentos LaTeX en Ubuntu y Windows
Documentos LaTeX en Ubuntu y Windows
 
Atix03
Atix03Atix03
Atix03
 
Ada 1
Ada 1Ada 1
Ada 1
 
Procesadores de palabras textos)
Procesadores de palabras textos)Procesadores de palabras textos)
Procesadores de palabras textos)
 
Tipos de procesadores de palabras
Tipos de procesadores de palabrasTipos de procesadores de palabras
Tipos de procesadores de palabras
 
precentacion4
precentacion4precentacion4
precentacion4
 
diapositiva3
diapositiva3diapositiva3
diapositiva3
 
TIPOS DE PROCESADORES DE PALABRAS
TIPOS DE PROCESADORES DE PALABRAS TIPOS DE PROCESADORES DE PALABRAS
TIPOS DE PROCESADORES DE PALABRAS
 
Procesadores de texto
Procesadores de textoProcesadores de texto
Procesadores de texto
 
TAREA 3: EDITORES DE TEXTO
TAREA 3: EDITORES DE TEXTOTAREA 3: EDITORES DE TEXTO
TAREA 3: EDITORES DE TEXTO
 
N4 lección13
N4 lección13N4 lección13
N4 lección13
 
Lenguajes de programación
Lenguajes de programaciónLenguajes de programación
Lenguajes de programación
 
Procesadores de texto
Procesadores de textoProcesadores de texto
Procesadores de texto
 

Más de Esteban Saavedra

Atix30
Atix30Atix30
Atix29
Atix29Atix29
Atix28
Atix28Atix28
Atix27
Atix27Atix27
Atix26
Atix26Atix26
Atix25
Atix25Atix25
Rabbitmq
RabbitmqRabbitmq
Ansible
AnsibleAnsible
Perl
PerlPerl
Atix24
Atix24Atix24
Atix23
Atix23Atix23
Lineas Base Migracion a Software Libre
Lineas Base Migracion a Software LibreLineas Base Migracion a Software Libre
Lineas Base Migracion a Software Libre
Esteban Saavedra
 
Seguridad Sistemas de Gobierno
Seguridad Sistemas de GobiernoSeguridad Sistemas de Gobierno
Seguridad Sistemas de Gobierno
Esteban Saavedra
 
Tunneling: Esquivando Restricciones de Proxies y Firewalls
Tunneling: Esquivando Restricciones de Proxies y FirewallsTunneling: Esquivando Restricciones de Proxies y Firewalls
Tunneling: Esquivando Restricciones de Proxies y Firewalls
Esteban Saavedra
 
Bi Un Modelo Eficiente para Gerenciar Empresas
Bi Un Modelo Eficiente para Gerenciar EmpresasBi Un Modelo Eficiente para Gerenciar Empresas
Bi Un Modelo Eficiente para Gerenciar Empresas
Esteban Saavedra
 
Clouds privadas
Clouds privadasClouds privadas
Clouds privadas
Esteban Saavedra
 
Introduccion Computacion Ubicua
Introduccion Computacion UbicuaIntroduccion Computacion Ubicua
Introduccion Computacion Ubicua
Esteban Saavedra
 
Frameworks de Desarrollo Web Grails
Frameworks de Desarrollo Web GrailsFrameworks de Desarrollo Web Grails
Frameworks de Desarrollo Web Grails
Esteban Saavedra
 
Avances Tecnologicos
Avances TecnologicosAvances Tecnologicos
Avances Tecnologicos
Esteban Saavedra
 
Dni Electronico Bolivia
Dni Electronico BoliviaDni Electronico Bolivia
Dni Electronico Bolivia
Esteban Saavedra
 

Más de Esteban Saavedra (20)

Atix30
Atix30Atix30
Atix30
 
Atix29
Atix29Atix29
Atix29
 
Atix28
Atix28Atix28
Atix28
 
Atix27
Atix27Atix27
Atix27
 
Atix26
Atix26Atix26
Atix26
 
Atix25
Atix25Atix25
Atix25
 
Rabbitmq
RabbitmqRabbitmq
Rabbitmq
 
Ansible
AnsibleAnsible
Ansible
 
Perl
PerlPerl
Perl
 
Atix24
Atix24Atix24
Atix24
 
Atix23
Atix23Atix23
Atix23
 
Lineas Base Migracion a Software Libre
Lineas Base Migracion a Software LibreLineas Base Migracion a Software Libre
Lineas Base Migracion a Software Libre
 
Seguridad Sistemas de Gobierno
Seguridad Sistemas de GobiernoSeguridad Sistemas de Gobierno
Seguridad Sistemas de Gobierno
 
Tunneling: Esquivando Restricciones de Proxies y Firewalls
Tunneling: Esquivando Restricciones de Proxies y FirewallsTunneling: Esquivando Restricciones de Proxies y Firewalls
Tunneling: Esquivando Restricciones de Proxies y Firewalls
 
Bi Un Modelo Eficiente para Gerenciar Empresas
Bi Un Modelo Eficiente para Gerenciar EmpresasBi Un Modelo Eficiente para Gerenciar Empresas
Bi Un Modelo Eficiente para Gerenciar Empresas
 
Clouds privadas
Clouds privadasClouds privadas
Clouds privadas
 
Introduccion Computacion Ubicua
Introduccion Computacion UbicuaIntroduccion Computacion Ubicua
Introduccion Computacion Ubicua
 
Frameworks de Desarrollo Web Grails
Frameworks de Desarrollo Web GrailsFrameworks de Desarrollo Web Grails
Frameworks de Desarrollo Web Grails
 
Avances Tecnologicos
Avances TecnologicosAvances Tecnologicos
Avances Tecnologicos
 
Dni Electronico Bolivia
Dni Electronico BoliviaDni Electronico Bolivia
Dni Electronico Bolivia
 

Último

BIOSENSORES BASADOS EN NANOTECNOLOGÍA.pdf
BIOSENSORES BASADOS EN NANOTECNOLOGÍA.pdfBIOSENSORES BASADOS EN NANOTECNOLOGÍA.pdf
BIOSENSORES BASADOS EN NANOTECNOLOGÍA.pdf
sunwndniel
 
Informe_mc_bombas_Warman_001-WEIR vulco.pdf
Informe_mc_bombas_Warman_001-WEIR vulco.pdfInforme_mc_bombas_Warman_001-WEIR vulco.pdf
Informe_mc_bombas_Warman_001-WEIR vulco.pdf
Rubén Cortes Zavala
 
Evolución, características, aplicación, ventajas y desventajas de las TIC
Evolución, características, aplicación, ventajas y desventajas de las TICEvolución, características, aplicación, ventajas y desventajas de las TIC
Evolución, características, aplicación, ventajas y desventajas de las TIC
Henry W. Zavala
 
Generaciones de Computadoras .
Generaciones de Computadoras                 .Generaciones de Computadoras                 .
Generaciones de Computadoras .
gregory760891
 
Reconocimiento del Secuenciador de nanoporos (Nanopore sequencing) MinIon Mk1...
Reconocimiento del Secuenciador de nanoporos (Nanopore sequencing) MinIon Mk1...Reconocimiento del Secuenciador de nanoporos (Nanopore sequencing) MinIon Mk1...
Reconocimiento del Secuenciador de nanoporos (Nanopore sequencing) MinIon Mk1...
sunwndniel
 
Transporte a través del tiempo en el perú.pdf
Transporte a través del tiempo en el perú.pdfTransporte a través del tiempo en el perú.pdf
Transporte a través del tiempo en el perú.pdf
milagrosAlbanPacherr
 
bomba-koomey -Todo sobre sus istema y conexiones
bomba-koomey -Todo sobre sus istema y conexionesbomba-koomey -Todo sobre sus istema y conexiones
bomba-koomey -Todo sobre sus istema y conexiones
JessAdrinGonzlezCade
 
"El uso de las TIC en la vida cotidiana". SantanaMartinez_Alejandra
"El uso de las TIC en la vida cotidiana". SantanaMartinez_Alejandra"El uso de las TIC en la vida cotidiana". SantanaMartinez_Alejandra
"El uso de las TIC en la vida cotidiana". SantanaMartinez_Alejandra
241578066
 
Diapositiva sobre Tecnologia de la Información y Telecomunicaciones.pptx
Diapositiva sobre Tecnologia de la Información y Telecomunicaciones.pptxDiapositiva sobre Tecnologia de la Información y Telecomunicaciones.pptx
Diapositiva sobre Tecnologia de la Información y Telecomunicaciones.pptx
GnesisOrtegaDeLen
 
_Manejo de Riesgos en el Laboratorio.pdf
_Manejo de Riesgos en el Laboratorio.pdf_Manejo de Riesgos en el Laboratorio.pdf
_Manejo de Riesgos en el Laboratorio.pdf
correodetareas
 
El uso de las TIC en la vida cotidiana.pptx
El uso de las TIC en la vida cotidiana.pptxEl uso de las TIC en la vida cotidiana.pptx
El uso de las TIC en la vida cotidiana.pptx
Katia Reyes
 
Informe de electroforesis del ADN MEDIANTE EL MinION Mk1C.pdf
Informe de electroforesis del ADN MEDIANTE EL MinION Mk1C.pdfInforme de electroforesis del ADN MEDIANTE EL MinION Mk1C.pdf
Informe de electroforesis del ADN MEDIANTE EL MinION Mk1C.pdf
KEVINYOICIAQUINOSORI
 
Catalogo-Voxtech- accesorios radios RF.pdf
Catalogo-Voxtech- accesorios radios RF.pdfCatalogo-Voxtech- accesorios radios RF.pdf
Catalogo-Voxtech- accesorios radios RF.pdf
walter729637
 
Conceptos y definiciones de Antenas y propagación
Conceptos y definiciones de Antenas y propagaciónConceptos y definiciones de Antenas y propagación
Conceptos y definiciones de Antenas y propagación
edgarcalle8
 
SEGUNDA GENERACIÓN xxxxxxxxxxxxxxxx.docx
SEGUNDA GENERACIÓN xxxxxxxxxxxxxxxx.docxSEGUNDA GENERACIÓN xxxxxxxxxxxxxxxx.docx
SEGUNDA GENERACIÓN xxxxxxxxxxxxxxxx.docx
Eddy Nathaly Jaimes Villamizar
 
2 FIBRA OPTICA COMO MEDIO DE RED DE ACCESO.pptx
2 FIBRA OPTICA COMO MEDIO DE RED DE ACCESO.pptx2 FIBRA OPTICA COMO MEDIO DE RED DE ACCESO.pptx
2 FIBRA OPTICA COMO MEDIO DE RED DE ACCESO.pptx
bellomiguelangel68
 
TESisssssssss de yhnnjuuhjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjj...
TESisssssssss de yhnnjuuhjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjj...TESisssssssss de yhnnjuuhjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjj...
TESisssssssss de yhnnjuuhjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjj...
MenaOlortinYherlyEli
 
11. Legislación Aplicada a la Informática.pdf
11. Legislación Aplicada a la Informática.pdf11. Legislación Aplicada a la Informática.pdf
11. Legislación Aplicada a la Informática.pdf
PanchoChangue
 
aplicaciones de sistema de informacion geografico
aplicaciones de sistema de informacion geograficoaplicaciones de sistema de informacion geografico
aplicaciones de sistema de informacion geografico
cyberquiximies
 
DN Consultores | Una mirada al mercado de fibra en Perú
DN Consultores | Una mirada al mercado de fibra en PerúDN Consultores | Una mirada al mercado de fibra en Perú
DN Consultores | Una mirada al mercado de fibra en Perú
estudios22
 

Último (20)

BIOSENSORES BASADOS EN NANOTECNOLOGÍA.pdf
BIOSENSORES BASADOS EN NANOTECNOLOGÍA.pdfBIOSENSORES BASADOS EN NANOTECNOLOGÍA.pdf
BIOSENSORES BASADOS EN NANOTECNOLOGÍA.pdf
 
Informe_mc_bombas_Warman_001-WEIR vulco.pdf
Informe_mc_bombas_Warman_001-WEIR vulco.pdfInforme_mc_bombas_Warman_001-WEIR vulco.pdf
Informe_mc_bombas_Warman_001-WEIR vulco.pdf
 
Evolución, características, aplicación, ventajas y desventajas de las TIC
Evolución, características, aplicación, ventajas y desventajas de las TICEvolución, características, aplicación, ventajas y desventajas de las TIC
Evolución, características, aplicación, ventajas y desventajas de las TIC
 
Generaciones de Computadoras .
Generaciones de Computadoras                 .Generaciones de Computadoras                 .
Generaciones de Computadoras .
 
Reconocimiento del Secuenciador de nanoporos (Nanopore sequencing) MinIon Mk1...
Reconocimiento del Secuenciador de nanoporos (Nanopore sequencing) MinIon Mk1...Reconocimiento del Secuenciador de nanoporos (Nanopore sequencing) MinIon Mk1...
Reconocimiento del Secuenciador de nanoporos (Nanopore sequencing) MinIon Mk1...
 
Transporte a través del tiempo en el perú.pdf
Transporte a través del tiempo en el perú.pdfTransporte a través del tiempo en el perú.pdf
Transporte a través del tiempo en el perú.pdf
 
bomba-koomey -Todo sobre sus istema y conexiones
bomba-koomey -Todo sobre sus istema y conexionesbomba-koomey -Todo sobre sus istema y conexiones
bomba-koomey -Todo sobre sus istema y conexiones
 
"El uso de las TIC en la vida cotidiana". SantanaMartinez_Alejandra
"El uso de las TIC en la vida cotidiana". SantanaMartinez_Alejandra"El uso de las TIC en la vida cotidiana". SantanaMartinez_Alejandra
"El uso de las TIC en la vida cotidiana". SantanaMartinez_Alejandra
 
Diapositiva sobre Tecnologia de la Información y Telecomunicaciones.pptx
Diapositiva sobre Tecnologia de la Información y Telecomunicaciones.pptxDiapositiva sobre Tecnologia de la Información y Telecomunicaciones.pptx
Diapositiva sobre Tecnologia de la Información y Telecomunicaciones.pptx
 
_Manejo de Riesgos en el Laboratorio.pdf
_Manejo de Riesgos en el Laboratorio.pdf_Manejo de Riesgos en el Laboratorio.pdf
_Manejo de Riesgos en el Laboratorio.pdf
 
El uso de las TIC en la vida cotidiana.pptx
El uso de las TIC en la vida cotidiana.pptxEl uso de las TIC en la vida cotidiana.pptx
El uso de las TIC en la vida cotidiana.pptx
 
Informe de electroforesis del ADN MEDIANTE EL MinION Mk1C.pdf
Informe de electroforesis del ADN MEDIANTE EL MinION Mk1C.pdfInforme de electroforesis del ADN MEDIANTE EL MinION Mk1C.pdf
Informe de electroforesis del ADN MEDIANTE EL MinION Mk1C.pdf
 
Catalogo-Voxtech- accesorios radios RF.pdf
Catalogo-Voxtech- accesorios radios RF.pdfCatalogo-Voxtech- accesorios radios RF.pdf
Catalogo-Voxtech- accesorios radios RF.pdf
 
Conceptos y definiciones de Antenas y propagación
Conceptos y definiciones de Antenas y propagaciónConceptos y definiciones de Antenas y propagación
Conceptos y definiciones de Antenas y propagación
 
SEGUNDA GENERACIÓN xxxxxxxxxxxxxxxx.docx
SEGUNDA GENERACIÓN xxxxxxxxxxxxxxxx.docxSEGUNDA GENERACIÓN xxxxxxxxxxxxxxxx.docx
SEGUNDA GENERACIÓN xxxxxxxxxxxxxxxx.docx
 
2 FIBRA OPTICA COMO MEDIO DE RED DE ACCESO.pptx
2 FIBRA OPTICA COMO MEDIO DE RED DE ACCESO.pptx2 FIBRA OPTICA COMO MEDIO DE RED DE ACCESO.pptx
2 FIBRA OPTICA COMO MEDIO DE RED DE ACCESO.pptx
 
TESisssssssss de yhnnjuuhjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjj...
TESisssssssss de yhnnjuuhjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjj...TESisssssssss de yhnnjuuhjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjj...
TESisssssssss de yhnnjuuhjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjj...
 
11. Legislación Aplicada a la Informática.pdf
11. Legislación Aplicada a la Informática.pdf11. Legislación Aplicada a la Informática.pdf
11. Legislación Aplicada a la Informática.pdf
 
aplicaciones de sistema de informacion geografico
aplicaciones de sistema de informacion geograficoaplicaciones de sistema de informacion geografico
aplicaciones de sistema de informacion geografico
 
DN Consultores | Una mirada al mercado de fibra en Perú
DN Consultores | Una mirada al mercado de fibra en PerúDN Consultores | Una mirada al mercado de fibra en Perú
DN Consultores | Una mirada al mercado de fibra en Perú
 

ReStructuredText: Realizando documentos de forma rápida y sencilla

  • 1. ReStructuredText: Realizando documentos de forma rápida y sencilla 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 Éstas marcas tratan de ser en lo posible Introducción mínimas y discretas. Muchas veces nos encontramos en la tarea ReStructuredText es aplicable a de realizar frecuentemente documentos, ya documentos de cualquier tamaño, desde los sea cursos, tutoriales, traducciones, etc; y por más pequeños (fragmentos de temas de rapidez, sencillez y control de documentación de programas), hasta versionamiento del documento preferimos documentos muy extensos (manuales, hacer uso de un editor de textos plano en cursos,....). lugar de hacer uso de un procesador de texto. Objetivos de un RST En todo el tiempo que llevo en el área de la investigación y el software libre he aprendido Desarrollo rápido. ✔ lo importante que es contar con herramientas Desarrollo estructurado. que nos ayuden a reutilizar el material que ✔ tenemos, concretamente en la tarea de Reutilización de código. ✔ realizar documentación, preferimos contar Disminuir el esfuerzo. con formatos y herramientas que permitan ✔ exportar nuestros documentos a otros Aprovechar las herramientas de ✔ equivalentes, dependiendo de cómo sean conversión que existen, no debemos accedidos o publicados a posteori. reinventar la rueda. Una de las varias alternativas para realizar este tipo de documentos son los Características de los RST ReStructuredText, cuya construcción y estructura es totalmente sencilla, fácil de Facilidad ✔ comprender y realizar. Sencillez ✔ Exportable a documentos ✔ Que son los archivos rst equivalentes. Los archivos .rst son archivos de texto plano, Independiente de la plataforma. ✔ que usan simples e intuitivas construcciones para indicar la estructura de un documento. Qué precisamos Éstas construcciones son igualmente fáciles de leer dentro de formas nativas (texto plano) En realidad para la construcción del archivo y procesadas. rst sólo nos hace falta contar con un editor de El marcado sencillo que usa sirve para texto plano, para nuestro caso podríamos indicar construcciones especiales como: hacer uso del famoso Vim o de Gedit. títulos, subtítulos, párrafos, listas, énfasis.
  • 2. En el caso que queramos exportar a partes (títulos, subtítulos, párrafos, listas, documentos equivalentes como HTML, Latex, bloques, tablas,énfasis,.... ). XML; debemos tener instalado Docutils que está hecho en Python. Nuestro primer documento rst Estructura de un documento Para una mejor comprensión del potencial de Hoy en día, en la tarea de realizar ReStructuredText en el desarrollo de documentación, se mantiene una forma documentación, realizaremos una documento similar de estructurar los documentos, dónde tomando en cuenta las construcciones de se consideran casi siempre las mismas 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.
  • 3. 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.
  • 4. Lista de opciones ----------------- -uno primera opción -dos segunda opción -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 (quot;|quot;). | 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 ===== ===== ======
  • 5. 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
  • 6. 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 Sustitución de referencias y definiciones ---------------------------------------- - Esto es muy útil cuando tenemos una directiva como |imagen2| y podemos reutilizarla varias veces: |imagen2|, | imagen2| .. |imagen2| image:: imagenes/esfera.gif En caso de poseer un documento amplio con varias secciones y subsecciones, podemos listar la tabla de contenidos, para esto usamos la directiva: .. contents::
  • 7. Exportando a otros formatos Hasta este momento nuestro documento, aunque posea la estructura deseada, surge la necesidad de exportarla para poderla publicar o visualizar en otros entornos: HTML mediante un browser, PDF o postscript por medio de Latex, XML, una presentación, etc. Para esta tarea precisamos contar con algunas aplicaciones inmersas dentro del Docutilis, que son descritas a continuación. Resultado de rst2html Resultado de rst2s5 Resultado de rst2xml Resultado de rst2latex
  • 8. Conclusión En conclusión podemos decir que construir un archivo .rst es de los más sencillo divertido y nos da la posibilidad de poder exportarlos a una variedad de formatos, dependiendo cual el destino o la forma de publicarlos. Referencias [1] http://docutils.sourceforge.net/rst.html [2] http://docutils.sourceforge.net/docs/ref/rst/introduction.html [3] http://skawina.eu.org/mikolaj/vst.html Autor Esteban Saavedra López Líder de la Comunidad ATIX (Oruro – Bolivia) Activista de Software Libre en Bolivia jesaavedra@opentelematics.org http://jesaavedra.opentelematics.org