Browse code

El EPUB para los manuales es el 3.0.1; inicio de redacción del segundo manual

NikaZhenya authored on 28/10/2018 18:00:44
Showing 16 changed files
... ...
@@ -36,15 +36,11 @@ def build dir
36 36
     archivo.close
37 37
 
38 38
     # Crea los archivos
39
-    system("pc-automata -f ../archivos-madre/md/#{dir}.md #{File.file?('../archivos-madre/md/notas.md') ? '-n ../archivos-madre/md/notas.md' : ''} -c ../archivos-madre/img/portada.png -i ../archivos-madre/img/ --section --no-ace --no-analytics --overwrite")
39
+    system("pc-automata -f ../archivos-madre/md/#{dir}.md #{File.file?('../archivos-madre/md/notas.md') ? '-n ../archivos-madre/md/notas.md' : ''} -c ../archivos-madre/img/portada.png -i ../archivos-madre/img/ --section --no-ace --no-analytics --no-legacy --overwrite")
40 40
 
41 41
     # Cambio los nombres
42 42
     Dir.glob('*.{epub,mobi}') do |file|
43
-        if File.extname(file) == '.epub' && File.basename(file) =~ /3.0.0/ || File.extname(file) == '.mobi'
44
-            FileUtils.mv(file, '../' + dir + File.extname(file))
45
-        else
46
-            FileUtils.rm(file)
47
-        end
43
+      FileUtils.mv(file, '../' + dir + File.extname(file))
48 44
     end
49 45
 
50 46
     # Va a la carpeta de MD para crear los HTML
51 47
Binary files a/src/manuals/01_10-comandos/01_10-comandos.epub and b/src/manuals/01_10-comandos/01_10-comandos.epub differ
52 48
Binary files a/src/manuals/01_10-comandos/01_10-comandos.mobi and b/src/manuals/01_10-comandos/01_10-comandos.mobi differ
53 49
new file mode 100644
54 50
Binary files /dev/null and b/src/manuals/busy_02_como-curar/02_como-curar.epub differ
55 51
new file mode 100644
56 52
Binary files /dev/null and b/src/manuals/busy_02_como-curar/02_como-curar.mobi differ
57 53
new file mode 100644
... ...
@@ -0,0 +1,196 @@
0
+<!DOCTYPE html>
1
+<html lang="es">
2
+    <head>
3
+        <meta charset="UTF-8" />
4
+        <title>¿Cómo curar un texto?</title>
5
+    </head>
6
+    <body>
7
+        <style>html,body,div,span,applet,object,iframe,h1,h2,h3,h4,h5,h6,p,blockquote,pre,a,abbr,acronym,address,big,cite,code,del,dfn,em,img,ins,kbd,q,s,samp,small,strike,strong,sub,sup,tt,var,b,u,i,center,dl,dt,dd,ol,ul,li,fieldset,form,label,legend,table,caption,tbody,tfoot,thead,tr,th,td,article,aside,canvas,details,embed,figure,figcaption,footer,header,hgroup,menu,nav,output,ruby,section,summary,time,mark,audio,video{margin:0;padding:0;border:0;font-size:100%;font:inherit;vertical-align:baseline;}article,aside,details,figcaption,figure,footer,header,hgroup,menu,nav,section{display:block;}body{line-height:1.5;}ol,ul{list-style:none;}blockquote,q{quotes:none;}blockquote:before,blockquote:after,q:before,q:after{content:'';content:none;}table{border-collapse:collapse;border-spacing:0;}@font-face{font-family:"Bitter Regular";src:url(../ttf/bitter-regular.ttf);}@font-face{font-family:"Bitter Italic";src:url(../ttf/bitter-italic.ttf);}@font-face{font-family:"Bitter Bold";src:url(../ttf/bitter-bold.ttf);}@font-face{font-family:"Bitter BoldItalic";src:url(../ttf/bitter-bolditalic.ttf);}@media screen and (min-width:769px){body{margin:5em;}.no-margin,.sin-margen{margin:-5em;}}@media screen and (max-width:768px){body{margin:4em;}.no-margin,.sin-margen{margin:-4em;}}@media screen and (max-width:640px){body{margin:3em;}.no-margin,.sin-margen{margin:-3em;}}@media screen and (max-width:480px){body{margin:2em;}.no-margin,.sin-margen{margin:-2em;}}@media screen and (max-width:320px){body{margin:1em;}.no-margin,.sin-margen{margin:-1em;}}@media amzn-mobi,amzn-kf8{body{margin:0;}.no-margin,.sin-margen{margin:0;}}section+section{margin-top:10em;}h1,h2,h3,h4,h5,h6{font-family:"Bitter Regular",Georgia,"Palatino Linotype","Book Antiqua",Palatino,serif;margin-bottom:1em;text-align:left;font-size:1em;-moz-hyphens:none !important;-webkit-hyphens:none !important;-o-hyphens:none !important;-ms-hyphens:none !important;hyphens:none !important;}h2,h3,h4,h5,h6{margin-top:2em;}h4,h5,h6{text-align:right;}h1{margin-bottom:6em;}h3,h5{font-family:"Bitter Italic",Georgia,"Palatino Linotype","Book Antiqua",Palatino,serif;font-style:italic;}h6{font-family:"Bitter Bold",Georgia,"Palatino Linotype","Book Antiqua",Palatino,serif;font-weight:bold;}h1.title,h1.titulo{margin-top:4em;margin-bottom:0;font-size:2em;}h2.subtitle,h2.subtitulo{margin-top:.5em;margin-bottom:3em;font-size:1.25em;}p,blockquote,li,figcaption,details,aside{font-family:"Bitter Regular",Georgia,"Palatino Linotype","Book Antiqua",Palatino,serif;font-size:1em;text-align:justify;line-height:1.5em;-moz-hyphens:auto;-webkit-hyphens:auto;-o-hyphens:auto;-ms-hyphens:auto;hyphens:auto;}p+p{text-indent:1.5em;}blockquote{font-size:.9em;margin:1em 1.5em;}blockquote+blockquote{text-indent:1.5em;margin-top:-1em;}blockquote,blockquote>*{line-height:1.65;}.justified,.justificado{text-align:justify !important;}.right,.derecha{text-indent:0;text-align:right !important;}.left,.izquierda{text-align:left !important;}.centered,.centrado{text-indent:0;text-align:center !important;}.hanging,.frances{margin-left:1.5em;text-indent:-1.5em;text-align:left !important;}*+.hanging,*+.frances{margin-top:1em;}.hanging+.hanging,.frances+.frances{margin-top:0;text-indent:-1.5em;}.indent,.sangria{text-indent:1.5em;}.no-indent,.sin-sangria{text-indent:0;}.no-hyphens,.sin-separacion{-moz-hyphens:none !important;-webkit-hyphens:none !important;-o-hyphens:none !important;-ms-hyphens:none !important;hyphens:none !important;}.invisible{visibility:hidden;}.hidden,.oculto{display:none;}.block,.bloque{display:block;}i,em{font-family:"Bitter Italic",Georgia,"Palatino Linotype","Book Antiqua",Palatino,serif;font-style:italic;}b,strong{font-family:"Bitter Bold",Georgia,"Palatino Linotype","Book Antiqua",Palatino,serif;font-weight:bold;}i>b,b>i,em>strong,strong>em,i>strong,strong>i,em>b,b>em{font-family:"Bitter BoldItalic",Georgia,"Palatino Linotype","Book Antiqua",Palatino,serif;}.initial,.capitular{float:left;font-size:3em;margin-top:.15em;padding-right:.1em;}.uppercase,.versal{text-transform:uppercase;}.normal,.redonda{font-variant:none;}.smallcap-light,.versalita-ligera{font-variant:small-caps;-moz-hyphens:auto;-webkit-hyphens:auto;-o-hyphens:auto;-ms-hyphens:auto;hyphens:auto;}.smallcap,.versalita{text-transform:lowercase;font-variant:small-caps;-moz-hyphens:auto;-webkit-hyphens:auto;-o-hyphens:auto;-ms-hyphens:auto;hyphens:auto;}.underline,.subrayado{text-decoration:underline black;}.auto-width,.anchura-auto{display:block;width:auto;margin-left:auto;margin-right:auto;}@media not amzn-mobi,not amzn-kf8{.auto-width,.anchura-auto{max-width:100%;}}a,a:link,a:visited{text-decoration:none;}ol,ul{margin:1em 1em 1em 2.5em;padding:0;}ol{list-style-type:decimal;}ul{list-style-type:disc;}ol ol,ol ul,ul ol,ul ul{margin:0 1em;}ol p,ul p{margin-left:.5em;}ul.dash,ul.en-dash,ul.em-dash{list-style-type:none;}ul.dash>li:before,ul.en-dash>li:before,ul.em-dash>li:before{display:block;width:1.5em;text-align:right;padding:0 .5em 0 0;margin:0 0 -1.25em -2em;}ul.dash>li:before{content:"-";}ul.en-dash>li:before{content:"–";}ul.em-dash>li:before{content:"—";}li.no-count{list-style-type:none;}li.no-count:before{content:none !important;}.li-manual{list-style-type:none;}.li-manual>li>p:first-child>span:first-of-type:not(.versalita){display:block;margin-left:-1.5em;margin-bottom:-1.25em;}li>.li-manual{margin:0 0 0 1.5em;}img{color:#0000EE;width:100%;}figure{margin:2em auto;}figcaption{font-family:"Bitter Regular",Georgia,"Palatino Linotype","Book Antiqua",Palatino,serif;margin-top:.5em;font-size:.9em;}figure+figure{margin-top:0;}p+img{margin-left:-1.5em;margin-top:2em;margin-bottom:2em;}.caption,.leyenda{font-size:.9em;margin-top:-1.5em;margin-bottom:2em;}.caption+img,.leyenda+img{margin-top:0;}img+.caption,img+.leyenda{margin-top:.5em;}.caption+p,.leyenda+p{text-indent:0;}p>img{display:inline;height:1.5em;width:auto;}sup,sub{font-size:.75em;vertical-align:super;}sub{vertical-align:sub;}code{font-family:"Courier New",Courier,monospace;background-color:#fff;padding:.125em .5em;border:1px solid #ddd;border-radius:.25em;-moz-hyphens:none;-webkit-hyphens:none;-o-hyphens:none;-ms-hyphens:none;hyphens:none;}pre{width:90%;font-family:"Courier New",Courier,monospace;background-color:#fff;margin:2em auto;padding:.5em;line-height:1.5;border-radius:.25em;box-shadow:.1em .1em .5em rgba(0,0,0,.45);white-space:unset;}pre *{color:#555;}pre code{display:block;margin:0;padding:0;background-color:inherit;border:none;border-radius:0;}pre code:before{width:1.5em;display:inline-block;padding:0 .5em;margin-right:.5em;color:#888;}@media not amzn-mobi,not amzn-kf8{pre{counter-reset:line;overflow:scroll;}pre code:before{counter-increment:line;content:counter(line);}pre code{white-space:pre;}}@media amzn-mobi,amzn-kf8{pre code:before{content:"•";}}section.gloss,body.gloss,section.glosa,body.glosa{margin-right:7em;}span.gloss,span.glosa{width:6em;margin-right:-8em;float:right;text-indent:0;text-align:left;font-size:.75em;}.poetry,.poesia{margin:1em 1.5em;text-indent:0;-moz-hyphens:none;-webkit-hyphens:none;-o-hyphens:none;-ms-hyphens:none;hyphens:none;}.mono,section.script *,section.guion *{font-family:"Courier New",Courier,monospace;}section.script *,section.guion *{font-size:1em;font-style:normal;font-weight:normal;font-variant:normal;margin:0;padding:0;text-indent:0;text-align:left;-moz-hyphens:none !important;-webkit-hyphens:none !important;-o-hyphens:none !important;-ms-hyphens:none !important;hyphens:none !important;}section.script ol,section.guion ol,section.script ul,section.guion ul{margin:1em 2em;}section.script h2,section.guion h2,section.script h3,section.guion h3,section.script blockquote,section.guion blockquote{width:60%;margin-left:3em;}section.script h1,section.guion h1{text-transform:uppercase;margin-bottom:1em;}section.script h2,section.guion h2{margin-top:1em;padding-left:6em;text-transform:uppercase;}section.script h3,section.guion h3{padding-left:3em;}section.script>p,section.guion>p{margin-top:1em;}section.script blockquote+blockquote>p,section.guion blockquote+blockquote>p{text-indent:1.5em;}.title,.titulo{margin-top:3em;margin-left:0;font-size:2em;}.subtitle,.subtitulo{margin-top:-1.25em;margin-bottom:3em;margin-left:0;}.author,.autor{width:250px;}.contributor+p,.contribuidor+p{text-indent:0;}h1+.contributor,h1+.contribuidor{margin-top:-6em !important;margin-bottom:6em;}.copyright,.legal *{text-indent:0;}.epigraph,.epigrafe{font-size:.9em;text-align:right;line-height:1.65em;margin-left:40%;}body>.epigraph:first-child,body>.epigrafe:first-child{margin-top:3em;}.epigraph+p,.epigrafe+p{margin-top:2em;text-indent:0;}.epigraph+.epigraph,.epigrafe+.epigrafe{margin-top:.5em;}.vertical-space1,.espacio-arriba1{margin-top:1em !important;}.vertical-space2,.espacio-arriba2{margin-top:2em !important;}.vertical-space3,.espacio-arriba3{margin-top:3em !important;}.space,.espacio{white-space:pre-wrap;}.n-note-sup{font-style:normal;font-weight:normal;}.n-note-hr{margin-top:2em;width:25%;margin-left:0;border:1px solid blue;background-color:blue;}.n-note-a{display:block;margin-left:-3em;margin-bottom:-1.375em;}.n-note-sup:before,.n-note-a:before{content:"[";color:#0000EE;}.n-note-sup:after,.n-note-a:after{content:"]";color:#0000EE;}.n-note-p,.n-note-p2{margin-left:3em;font-size:.9em;text-indent:0;}*+.n-note-p{margin-top:1em;text-indent:0;}.n-note-p2{margin-top:0;text-indent:1.5em;}.i-item-section p{margin-top:.5em !important;}.i-item-div>h2:first-child,.i-item-div-single>h2:first-child{margin-top:0;}@media screen and (min-width:768px){@media not amzn-mobi,not-amzn-kf8{.i-item-div{column-count:2;column-gap:2em;column-rule:solid 1px lightgray;}}}.i-item-a:before{content:"[";color:#0000EE;}.i-item-a:after{content:"]";color:#0000EE;}@media print{section{page-break-before:always;}section:first-of-type{page-break-before:avoid;}section>h1:first-child{padding-top:5em !important;}}</style>
8
+        <section><h1 class="titulo">¿Cómo curar un texto?</h1></section>
9
+        <section epub:type="introduction" role="doc-introduction">
10
+            <h1 id="introduccion">Introducción</h1>
11
+            <p>¿Cuántas veces se han tenido que hacer modificaciones a un documento que toman varios minutos o horas? ¡Qué coraje, decenas o centenas de cambios similares! ¿No hay una manera más sencilla de curar el texto?</p>
12
+            <p>Con probabilidad ya buscaste una respuesta en internet o una aplicación en alguna tienda. Encontraste confusión en lugar de claridad. El programa que te prometió ahorrar tiempo al final te da dolores de cabeza…</p>
13
+            <p>El formato es el cuello de botella en la edición. Una y otra vez tenemos que limpiar o reacomodar líneas de texto. Una y otra vez desperdiciamos tiempo y recursos en ese monótono trabajo.</p>
14
+            <p>¿Qué tal si te digo que desde los sesenta ya existe una solución? Pocas personas que editan libros la conocen porque su surgimiento fue en las ciencias de la computación. Primero como concepto, en 1951, y una década después como diversos lenguajes formales.</p>
15
+            <p>RegEx, un acrónimo en inglés de <i>regular expressions</i>, es un lenguaje que nos permitirá curar nuestros documentos de una manera muy eficaz y eficiente. Pero antes de continuar, veamos unas consideraciones…</p>
16
+        </section>
17
+        <section epub:type="frontmatter" role="doc-frontmatter">
18
+            <h1 id="que-es-y-que-no-es-este-manual">Qué es y qué no es este manual</h1>
19
+            <p>En este manual no encontrarás:</p>
20
+            <ul>
21
+                <li>
22
+                    <p>Todo lo que es posible hacer con RegEx. Esta es una introducción a RegEx <i>en la edición</i>, así que no se verá toda la sintaxis de este lenguaje. Si quieres ampliar tu bagaje, en internet existen muy buenos recursos, como <a href="https://www.regular-expressions.info/tutorial.html">Regular-Expressions.info</a>.</p>
23
+                </li>
24
+                <li>
25
+                    <p>Un manual profundo. Se mostrarán usos precisos de cierta sintaxis de RegEx que son comunes en el quehacer editorial. Si quieres profundizar, es bueno que experimentes de manera constante. <a href="http://regexr.com/">RegExr</a> es un gran sitio para practicar.</p>
26
+                </li>
27
+                <li>
28
+                    <p>Explicaciones teóricas sobre la sintaxis de RegEx. Nos interesa que puedas usar RegEx lo más rápido posible en tus proyectos. Para teorizar quizá te sea de buena ayuda comenzar con <a href="http://gen.lib.rus.ec/book/index.php?md5=5E348267F30310306B861A9A76470B53"><i>Mastering Regular Expressions</i></a>.</p>
29
+                </li>
30
+            </ul>
31
+            <p>En este manual sí encontrarás:</p>
32
+            <ul>
33
+                <li>
34
+                    <p>Una aplicación concreta. Estaremos trabajando con una obra, no con ejercicios aislados. Verás las posibilidades de la aplicación de RegEx en un ecosistema profesional de edición. Para esto, Flacso México nos ha permitido hacer uso del libro <a href="http://www.flacso.edu.mx/search/busqueda/Videovigilancia%20en%20méxico"><i>Videovigilancia en México</i></a>.</p>
35
+                </li>
36
+                <li>
37
+                    <p>Fórmulas precisas. A lo largo del manual te encontrarás con fórmulas que podrás aplicar en tus publicaciones. En algunos casos tendrás que hacer modificaciones. Pero en general te darás cuenta que es tan fácil como copiar y pegar.</p>
38
+                </li>
39
+                <li>
40
+                    <p>Otra manera de ver al texto. Poco a poco en este manual se te mostrará que la suciedad de los documentos no yace en el diseño o el contenido, sino en las estructuras subyacentes. El diseño se te develerá como un síntoma de un problema más profundo. ¿Quieres mejorar tus habilidades editoriales? Tendrás que hacer un giro copernicano en la manera en como has entendido al texto. Este manual te ayudará en esta tarea.</p>
41
+                </li>
42
+                <li>
43
+                    <p>Dos maneras de usarlo. Aunque es recomendable hacer todos los ejercicios, puede darse el caso que solo te interese ver de manera somera las posibilidades de RegEx para la edición. Para este caso tendrás acceso a los ejemplos por medio de enlaces. Consulta el segundo subapartado del tercer capítulo para más información.</p>
44
+                </li>
45
+            </ul>
46
+        </section>
47
+        <section epub:type="chapter" role="doc-chapter">
48
+            <h1 id="rege-que-pa-que">1. Rege… ¿qué?, ¿pa qué?</h1>
49
+            <p>Como personas que editamos no es raro tener que modificar el documento que estamos trabajando. Algunos cambios son singulares. Pero de vez en cuando existe la necesidad de hacer muchos cambios. Unos podemos hacerlos con un simple <code>reemplazar todo</code>, p. ej. de «guión» a «guion».</p>
50
+            <p>Sin embargo, hay veces que no podemos llevar a cabo cambios literales como el del ejemplo pasado. Supongamos que tenemos una publicación donde los encabezados están numerados:</p>
51
+            <pre class="">
52
+                <code class="code-line-1">Capítulo 1. Un título A</code><code class="code-line-2">…</code><code class="code-line-3">Capítulo 2. Un título B</code><code class="code-line-4">…</code><code class="code-line-5">Capítulo 3. Un título C</code><code class="code-line-6">…</code>
53
+            </pre>
54
+            <p>Y se nos pide eliminar el prefijo «Capítulo » para tener este resultado:</p>
55
+            <pre class="">
56
+                <code class="code-line-1">1. Un título A</code><code class="code-line-2">…</code><code class="code-line-3">2. Un título B</code><code class="code-line-4">…</code><code class="code-line-5">3. Un título C</code><code class="code-line-6">…</code>
57
+            </pre>
58
+            <p>La solución sencilla implica hacer un <code>reemplazar todo</code> donde «Capítulo » sea sustituido por nada. ¿Qué pasa si adentro del texto hay una mención como «y en el capítulo 1…»? De manera desafortunada provocaremos un cambio a «y en el 1…». Podemos ser más exigentes y pedirle al programa que solo haga el cambio si la «C» está en versal. Sin embargo, ya tendremos un dejo de sospecha, ¿tienes seguridad de que <i>únicamente</i> cambió el texto en el encabezado?</p>
59
+            <p>O siguiendo el ejemplo. Supongamos que se nos asigna la tarea de eliminar todo el prefijo, incluido el número, el punto y el espacio antes del nombre del capítulo para conseguir este resultado:</p>
60
+            <pre class="">
61
+                <code class="code-line-1">Un título A</code><code class="code-line-2">…</code><code class="code-line-3">Un título B</code><code class="code-line-4">…</code><code class="code-line-5">Un título C</code><code class="code-line-6">…</code>
62
+            </pre>
63
+            <p>La primera solución que podemos llegar es reemplazar de manera manual a «Capítulo 1. », «Capítulo 2. » y «Capítulo 3. ». La tarea no nos demora mucho si nuestra obra tiene pocos encabezados. Pero ¿qué pasa si no es así? Los dos volúmenes del <i>Don Quijote</i> comprenden un total de 126 capítulos, ¿cuánto tardarías en hacer el cambio de esta manera?</p>
64
+            <p>La segunda aproximación es hacer varios <code>reemplazar todo</code> donde solo aumentemos un dígito de manera manual. Es decir, abres la ventana de <code>reemplazar</code> y primero pides cambiar «Capítulo 1. » por nada y copias esta línea de texto. A continuación vuelves a abrir esta ventana, pegas «Capítulo 1. » y lo modificas por «Capítulo 2. » para hacer la nueva sustitución.</p>
65
+            <p>Con este mecanismo te ahorrarás más tiempo porque <i>no tienes que ver el contenido, mucho menos encontrarlo</i>. El programa lo hará por ti, tú solo te concentras en abrir la ventana de reemplazar, pegar el prefijo copiado con antelación, modificarlo y hacer el cambio. Así tres veces para este ejemplo o 126 veces con el <i>Don Quijote</i>…</p>
66
+            <p>No obstante, entre más complejo sea el documento, menos seguridad sentirás de que <i>únicamente</i> sustituiste el prefijo en los encabezados.</p>
67
+            <p><i>En la búsqueda de sustituir de manera correcta tu documento, has empezado un proceso de abstracción</i>. Sabes que la «forma» a eliminar se expresa como «Capítulo <i>n</i>. » donde <i>n</i> es cualquier dígito. Mejor cambiemos el término de «forma» por «fórmula». Con esta fórmula tenemos una combinación de caracteres con lo que podemos hacer cualquier cosa, sea eliminarlo o modificarlo.</p>
68
+            <p>Esta fórmula podemos expresarla como <code>^\s*Capítulo\s+\d+\.\s+</code> y con ello eliminar todo el prefijo incluso con estas consideraciones:</p>
69
+            <ul>
70
+                <li>
71
+                    <p>Puede haber espacios al inicio de «Capítulo».</p>
72
+                </li>
73
+                <li>
74
+                    <p>No importa el tipo de espacios, inclusive pueden ser saltos de línea.</p>
75
+                </li>
76
+                <li>
77
+                    <p>No importa que sean tres o cientos de encabezados.</p>
78
+                </li>
79
+            </ul>
80
+            <p>¿No me crees? Mira el primer ejemplo de este manual en <a href="https://regexr.com/422v0">RegExr</a>.</p>
81
+            <figure>
82
+                <img src="../img/img01.png" alt="Coincidencias y reemplazos de la fórmula ^\s*Capítulo\s+\d+\.\s+ en RegExr."/>
83
+                <figcaption>
84
+                    Coincidencias y reemplazos de la fórmula <code>^\s*Capítulo\s+\d+\.\s+</code> en RegExr.
85
+                </figcaption>
86
+            </figure>
87
+            <p>¡Qué carajos significa <code>^\s*Capítulo\s+\d+\.\s+</code>! Ahorita no es importante, solo que <i>es una fórmula de RegEx</i>. Es muy compleja porque está diseñada para considerar un formato demasiado caótico. <i>Esta sería más sencilla si el texto estuviera menos sucio</i>.</p>
88
+            <p>Si te das cuenta, solo estamos formalizando y racionalizando una abstracción que ya habías realizado de modo intuitivo. RegEx es un lenguaje formal que permite concretar las abstracciones que haces sobre el texto. Al abstraer el texto <i>de esta manera</i> lo estás atomizando para contemplarlo como una cadena de caracteres, cada uno con propiedades específicas.</p>
89
+            <p>Por ejemplo, <code>A,a,á,1, ,-</code> son todos caracteres, pero distintos. Los primeros tres son letras, de hecho <i>la misma letra</i>, pero en versal, minúscula o acentuada. El <code>1</code> es un dígito, específicamente el número uno. Aunque no sea visible, el quinto elemento es un espacio. Por último, <code>-</code> no es una letra ni un dígito, sino un caracter especial para representar al guion.</p>
90
+            <p>¿Te das cuenta que no estás viendo estos caracteres como diseño ni como contenido? No te estás fijando en la «forma» de las <code>A,a,á</code>, sino viendo un cambio semántico <i>representado</i> como usualmente escribimos esa letra en versal, minúscula o acentuada. Tampoco estás contemplando su significado como para pensar si está escrita correctamente, como cuando analizamos el texto como contenido. No te importa qué es <code>a</code>, si es la primera letra del abecedario, si proviene de la letra griega <i>α</i> o si es una preposición, etc. Solo nos interesa que es una letra «a» minúscula.</p>
91
+            <p>En realidad <i>ya no estas viendo al texto como diseño o contenido, sino como estructura</i>. La ventaja que tenemos es que nos permite hacer abstracciones y representarlas con fórmulas. La desventaja es que no es la manera usual en como tratamos el texto en la edición, por lo que en un pincipio nos costará trabajo entender esta perspectiva.</p>
92
+            <p>Por ello, RegEx es un lenguaje formal muy potente que podrá ayudarnos a mejorar la calidad de nuestra edición en distintos aspectos:</p>
93
+            <ol>
94
+                <li>
95
+                    <p>Podremos <i>simplificar</i> estructuras para obtener el mismo resultado visible; esto nos ahorra peso en los archivos pero, principalmente, nos dará mayor control. Siempre recuerda: <i>las estructuras simples son más fáciles de manejar</i>.</p>
96
+                </li>
97
+                <li>
98
+                    <p>Podremos <i>modificar</i> estructuras para cambiar la manera en como presentamos nuestro documento; es más rápido que un <code>reemplazar todo</code> literal, además que nos da más certidumbre. Ten en mente: <i>con fórmulas no tenemos ya que cotejar el documento; si hay un fallo, este será uniforme por lo que su solución será sencilla</i>.</p>
99
+                </li>
100
+                <li>
101
+                    <p>Podremos <i>detectar</i> deficiencias estructurales que afectan de manera directa al contenido y diseño de nuestra publicación; evitaremos de una vez por todas la falta de uniformidad en el contenido. Nunca olvides: <i>la calidad editorial también reside en la uniformidad de la obra</i>.</p>
102
+                </li>
103
+            </ol>
104
+            <p>Entonces, ¿qué es RegEx y para qué lo necesitamos en la edición? Sin titubear puedo decirte que <i>RegEx es un lenguaje que nos permitirá hacer mejores libros</i>.</p>
105
+        </section>
106
+        <section epub:type="chapter" role="doc-chapter">
107
+            <h1 id="primero-lo-primero-configuracion-del-entorno-de-trabajo">2. Primero lo primero: configuración del entorno de trabajo</h1>
108
+            <p>Tu <i>software</i> de maquetación o procesador favorito ya cuentan con un intérprete de RegEx. Basta con activar la casilla de <code>expresiones regulares</code> cuando abras la ventana de <code>reemplazar</code> o de <code>buscar</code>.</p>
109
+            <p>Sin embargo, según el <i>software</i> algunas funcionalidades van a estar implementadas o no. También puede llegar a variar la sintaxis. Para evitar dificultades entre lo que aquí ves y en tu editor aplicas, instalaremos Gedit.</p>
110
+            <blockquote>
111
+                <p><b>Atención</b>: si tu intención es terminar este manual lo más pronto posible, es mejor que te dirijas a la siguiente sección. El manual se puede usar de dos maneras, en la vía rápida no necesitas Gedit.</p>
112
+            </blockquote>
113
+            <p>Gedit es un editor de texto muy sencillo con un intérprete de RegEx lo demasiado potente para lo que haremos. Este programa fue creado para el entorno de escritorio <a href="https://es.wikipedia.org/wiki/GNOME"><span class="smallcap">GNOME</span></a> presente en algunas distribuciones de Linux. Pero también existe una versión de fácil instalación para usuarios de Windows o macOs.</p>
114
+            <figure>
115
+                <img src="../img/img02.png" alt="Entorno gráfico por defecto de Gedit, así de simple."/>
116
+                <figcaption>
117
+                    Entorno gráfico por defecto de Gedit, así de simple.
118
+                </figcaption>
119
+            </figure>
120
+            <p>Dependiendo de la arquitectura de tu Windows puedes descargar Gedit para <a href="http://ftp.gnome.org/pub/GNOME/binaries/win32/gedit/2.30/gedit-setup-2.30.1-1.exe">32 bits</a> o <a href="http://ftp.gnome.org/pub/GNOME/binaries/win64/gedit/gedit-x86_64-3.20.1.msi">64 bits</a>. Se trata de un archivo ejecutable que con clics lo instalas. ¿No conoces la arquitectura? Haz clic en el botón <code>Inicio</code>. A continuación con clic derecho sobre <code>Equipo</code> seleccionas la opción <code>Propiedades</code>. En la pestaña de <code>Sistema</code> tiene que indicarte la arquitectura como <code>tipo de sistema</code>.</p>
121
+            <figure>
122
+                <img src="../img/img03.png" alt="Ejemplo de visualización del tipo de sistema de Windows."/>
123
+                <figcaption>
124
+                    Ejemplo de visualización del <code>tipo de sistema</code> de Windows.
125
+                </figcaption>
126
+            </figure>
127
+            <p>Si tu computadora tiene macOS, <a href="http://ftp.gnome.org/pub/GNOME/binaries/mac/gedit/3.2/gedit-3.2.6-3.dmg">aquí</a> puedes descargar el ejecutable. También basta con hacer un par de clics. Si estás teniendo problemas para instalarlo, puedes probar con cualquiera de los <code>dmg</code> disponibles en el <a href="http://ftp.gnome.org/pub/GNOME/binaries/mac/gedit/3.2/">repositorio de <span class="smallcap">GNOME</span></a>. ¿Nada de esto funciona? Quizá lo mejor es que primero instalar el gestor de paquetes <a href="https://brew.sh/"><code>brew</code></a> y al terminar ejecutar en la terminal: <code>brew install gedit</code>.</p>
128
+            <p>¿Usas Linux? Si usas <span class="smallcap">GNOME</span> tendrías que tenerlo instalado. Si no es así, usa tu gestor de paquetes para instalar <code>gedit</code>. Si estás en otro entorno de escritorio, puedes probar con instalarlo o con seguridad ya tendrás un substituto…</p>
129
+            <p>Por defecto Gedit puede lucir muy feo para ti. Lo primero que podemos hacer es disminuir la anchura del tabulador para no ver tantos espacios en blanco cuando empecemos a trabajar. Para eso en la parte inferior vamos a hacer clic sobre <code>Anchura del tabulador</code> y vamos a seleccionar <code>2</code>, así como activar <code>Usar espacios</code>.</p>
130
+            <figure>
131
+                <img src="../img/img04.png" alt="Configuración de la anchura del tabulador de Gedit."/>
132
+                <figcaption>
133
+                    Configuración de la anchura del tabulador de Gedit.
134
+                </figcaption>
135
+            </figure>
136
+            <p>A continuación, al lado derecho de <code>Anchura del tabulador</code> vamos a configurar las líneas y columnas. Activaremos <code>Mostrar números de línea</code>, <code>Mostrar el margen derecho</code> y <code>Resaltar la línea actual</code>, así como desactivaremos <code>Ajuste de texto</code>. Son muy importantes las primera y última opciones porque así podrás localizar sin complicaciones el texto que estaremos mostrando en este manual.</p>
137
+            <figure>
138
+                <img src="../img/img05.png" alt="Configuración de las líneas y columnas de Gedit."/>
139
+                <figcaption>
140
+                    Configuración de las líneas y columnas de Gedit.
141
+                </figcaption>
142
+            </figure>
143
+            <p>Con eso es suficiente. Si deseas cambiar el esquema de color, fuente o tamaños, <a href="https://help.gnome.org/users/gedit/stable/index.html.en#configure-gedit">aquí</a> puedes consultarlo. En mi caso prefiero temas oscuros, por lo que mi configuración se ve así:</p>
144
+            <figure>
145
+                <img src="../img/img06.png" alt="Vista de Gedit con esquema de color distinto."/>
146
+                <figcaption>
147
+                    Vista de Gedit con esquema de color distinto.
148
+                </figcaption>
149
+            </figure>
150
+            <p>Con esto ¡ya casi estamos listos para empezar!</p>
151
+        </section>
152
+        <section epub:type="chapter" role="doc-chapter">
153
+            <h1 id="como-vamos-a-trabajar">3. ¿Cómo vamos a trabajar?</h1>
154
+            <p>Este manual se puede usar de dos maneras:</p>
155
+            <ol>
156
+                <li>
157
+                    <p>Haciendo ejercicios completos desde archivos de trabajo y con Gedit.</p>
158
+                </li>
159
+                <li>
160
+                    <p>Usando <a href="http://regexr.com/">RegExr</a> como entorno de trabajo y para ver los ejemplos de código.</p>
161
+                </li>
162
+            </ol>
163
+            <h2 id="ejercicio-completo">Ejercicio completo</h2>
164
+            <p>El primer modo es el más recomendado si quieres tener una experiencia lo más cercana posible a lo que usualmente nos enfrentamos en la <a href="https://marianaeguaras.com/edicion-digital-como-edicion-desde-cero">edición «desde cero»</a>. <a href="http://ted.cliteratu.re/src/manuals/src/02_intro-regex.zip">Aquí</a> puedes descargar los archivos en <span class="smallcap">ZIP</span>. Al descomprimirlo tendremos una carpeta con lo siguiente:</p>
165
+            <pre class="">
166
+                <code class="code-line-1">02_intro-regex</code><code class="code-line-2">├── css</code><code class="code-line-3">│   ├── idGeneratedStyles.css</code><code class="code-line-4">│   └── styles.css</code><code class="code-line-5">└── html</code><code class="code-line-6"> └── contenido.html</code>
167
+            </pre>
168
+            <p>El archivo que más usaremos en Gedit es el <code>contenido.html</code>. Trabajaremos con un archivo <span class="smallcap">HTML</span> que fue <a href="https://helpx.adobe.com/indesign/using/export-content-html-cc.html">exportado desde InDesign</a>. Esto se debe a que, según la metodología de la <a href="https://ed.cliteratu.re/">edición ramificada</a>, estamos buscando trabajar con <a href="https://es.wikipedia.org/wiki/Formato_abierto">formatos abiertos</a> que nos permitan crear varios tipos de soportes finales. Los archivos <span class="smallcap">INDD</span> ni son abiertos ni pueden producir salidas sin errores más allá del <span class="smallcap">PDF</span>.</p>
169
+            <p>La carpeta también contiene dos <a href="https://es.wikipedia.org/wiki/Hoja_de_estilos_en_cascada">hojas de estilo <span class="smallcap">CSS</span></a>. El archivo <code>idGeneratedStyles.css</code> es la hoja generada automáticamente por InDesign. Nos servirá principalmente para saber cómo ha nombrado varios estilos en línea como son las itálicas, negritas o versalitas. El archivo <code>styles.css</code> es la actual hoja de estilos por defecto de <a href="https://pecas.cliteratu.re/">Pecas</a> que nos dará un apoyo visual de las estructuras que estemos modificando. Se recomienda abrirlos con Gedit cuando se indique el caso.</p>
170
+            <p>¿Ya abriste el archivo <span class="smallcap">HTML</span>? De seguro ya viste algo muy extraño: ¡el texto está ofuscado! Esto se debe a que por cuestiones de derechos de autor (!) no podemos usar todo el contenido de <i>Videovigilancia en México</i>… Aunque nos gustaría poderte ofrecer todo el texto, es cierto que tampoco lo necesitamos. Recuerda: <i>trabajaremos con estructuras, no con diseño o contenido</i>. Más información al respecto la puedes leer en la siguiente subsección.</p>
171
+            <h2 id="una-prueba-de-regex">Una prueba de RegEx</h2>
172
+            <p>Si tu interés es más bien ver de manera somera lo que puede hacer RegEx para la edición y quizá una que otra vez jugar con las fórmulas, cada ejemplo estará disponible en <a href="http://regexr.com">RegExr</a>. Aquí estaremos colocando el ejemplo concreto, así como su enlace para que puedas ver y jugar en RegExr.</p>
173
+            <p>Una gran diferencia entre esta modalidad y la completa es que aquí sí están disponibles los fragmentos sin ofuscar de <i>Videovigilancia en México</i>. Esto no genera conflicto porque la posición de líneas y columnas es exactamente la misma.</p>
174
+            <p>Por ejemplo, aquí pondremos el contenido original de la línea 10 del archivo <span class="smallcap">HTML</span>:</p>
175
+            <pre class="">
176
+                <code class="code-line-1"> &lt;p class="portadilla"&gt;Videovigilancia en México&lt;/p&gt;</code>
177
+            </pre>
178
+            <p>Que en el archivo <code>contenido.html</code> se verá así:</p>
179
+            <pre class="">
180
+                <code class="code-line-1"> &lt;p class="portadilla"&gt;Kenaayuqeregwee an Sulice&lt;/p&gt;</code>
181
+            </pre>
182
+            <p>Si te fijas, tienen la misma estructura y cantidad de caracteres. Incluso respeta diferencias entre mayúsculas, minúsculas, dígitos o caracteres especiales. La divergencia es que las letras fueron cambiadas de manera aleatoria —no hay criptografía, ni siquiera sencilla, por lo que el texto no puede ser sometido a ingeniería inversa—.</p>
183
+            <p>No obstante, esto no es ningún problema, porque trataremos con estructuras y ambos textos tienen que funcionar de la misma manera. Mira el <a href="https://regexr.com/42304">ejemplo 2</a> para corroborarlo. Tampoco interesa ahorita qué carajos hace la fórmula de ese ejemplo. Sin importar que esté el texto ofuscado, cumple con el propósito.</p>
184
+            <blockquote>
185
+                <p><b>Aclaración</b>: RegEx es el lenguaje que estaremos usando. Mientras que RegExr es una plataforma diseñada para ver ejemplos con RegEx. Una y otra son independientes aunque se relacionan en su pasión de creación de fórmulas para el procesamiento de información.</p>
186
+            </blockquote>
187
+            <p>¿Listo para empezar? ¡Conectémonos a la Matrix!</p>
188
+        </section>
189
+        <section epub:type="chapter" role="doc-chapter">
190
+            <h1 id="titulo">Título</h1>
191
+        </section>
192
+        <section>            <script type="text/javascript" src="/hashover/comments.php"></script>
193
+        </section>
194
+    </body>
195
+</html>
0 196
new file mode 100644
1 197
Binary files /dev/null and b/src/manuals/busy_02_como-curar/archivos-madre/img/img01.png differ
2 198
new file mode 100644
3 199
Binary files /dev/null and b/src/manuals/busy_02_como-curar/archivos-madre/img/img02.png differ
4 200
new file mode 100644
5 201
Binary files /dev/null and b/src/manuals/busy_02_como-curar/archivos-madre/img/img03.png differ
6 202
new file mode 100644
7 203
Binary files /dev/null and b/src/manuals/busy_02_como-curar/archivos-madre/img/img04.png differ
8 204
new file mode 100644
9 205
Binary files /dev/null and b/src/manuals/busy_02_como-curar/archivos-madre/img/img05.png differ
10 206
new file mode 100644
11 207
Binary files /dev/null and b/src/manuals/busy_02_como-curar/archivos-madre/img/img06.png differ
12 208
new file mode 100644
13 209
Binary files /dev/null and b/src/manuals/busy_02_como-curar/archivos-madre/img/portada.png differ
14 210
new file mode 100644
... ...
@@ -0,0 +1,400 @@
0
+<section epub:type="introduction" role="doc-introduction">
1
+
2
+# Introducción
3
+
4
+¿Cuántas veces se han tenido que hacer modificaciones a un documento que
5
+toman varios minutos o horas? ¡Qué coraje, decenas o centenas de
6
+cambios similares! ¿No hay una manera más sencilla de curar el texto?
7
+
8
+Con probabilidad ya buscaste una respuesta en internet o una aplicación
9
+en alguna tienda. Encontraste confusión en lugar de claridad. El programa 
10
+que te prometió ahorrar tiempo al final te da dolores de cabeza…
11
+
12
+El formato es el cuello de botella en la edición. Una y otra vez tenemos
13
+que limpiar o reacomodar líneas de texto. Una y otra vez desperdiciamos 
14
+tiempo y recursos en ese monótono trabajo.
15
+
16
+¿Qué tal si te digo que desde los sesenta ya existe una solución?
17
+Pocas personas que editan libros la conocen porque su surgimiento fue
18
+en las ciencias de la computación. Primero como concepto, en 1951, y 
19
+una década después como diversos lenguajes formales.
20
+
21
+RegEx, un acrónimo en inglés de _regular expressions_, es un lenguaje que
22
+nos permitirá curar nuestros documentos de una manera muy eficaz y 
23
+eficiente. Pero antes de continuar, veamos unas consideraciones…
24
+
25
+</section>
26
+<section epub:type="frontmatter" role="doc-frontmatter">
27
+
28
+# Qué es y qué no es este manual
29
+
30
+En este manual no encontrarás:
31
+
32
+* Todo lo que es posible hacer con RegEx. Esta es una introducción a
33
+  RegEx _en la edición_, así que no se verá toda la sintaxis de este 
34
+  lenguaje. Si quieres ampliar tu bagaje, en internet existen muy buenos 
35
+  recursos, como [Regular-Expressions.info](https://www.regular-expressions.info/tutorial.html).
36
+* Un manual profundo. Se mostrarán usos precisos de cierta sintaxis de
37
+  RegEx que son comunes en el quehacer editorial. Si quieres profundizar,
38
+  es bueno que experimentes de manera constante. [RegExr](http://regexr.com/)
39
+  es un gran sitio para practicar.
40
+* Explicaciones teóricas sobre la sintaxis de RegEx. Nos interesa que 
41
+  puedas usar RegEx lo más rápido posible en tus proyectos. Para teorizar
42
+  quizá te sea de buena ayuda comenzar con [_Mastering Regular Expressions_](http://gen.lib.rus.ec/book/index.php?md5=5E348267F30310306B861A9A76470B53).
43
+
44
+En este manual sí encontrarás:
45
+
46
+* Una aplicación concreta. Estaremos trabajando con una obra, no con
47
+  ejercicios aislados. Verás las posibilidades de la aplicación de RegEx
48
+  en un ecosistema profesional de edición. Para esto, Flacso México nos
49
+  ha permitido hacer uso del libro [_Videovigilancia en México_](http://www.flacso.edu.mx/search/busqueda/Videovigilancia%20en%20méxico).
50
+* Fórmulas precisas. A lo largo del manual te encontrarás con fórmulas que
51
+  podrás aplicar en tus publicaciones. En algunos casos tendrás que hacer 
52
+  modificaciones. Pero en general te darás cuenta que es tan fácil como 
53
+  copiar y pegar.
54
+* Otra manera de ver al texto. Poco a poco en este manual se te mostrará
55
+  que la suciedad de los documentos no yace en el diseño o el contenido, 
56
+  sino en las estructuras subyacentes. El diseño se te develerá como un 
57
+  síntoma de un problema más profundo. ¿Quieres mejorar tus habilidades
58
+  editoriales? Tendrás que hacer un giro copernicano en la manera en como
59
+  has entendido al texto. Este manual te ayudará en esta tarea.
60
+* Dos maneras de usarlo. Aunque es recomendable hacer todos los ejercicios,
61
+  puede darse el caso que solo te interese ver de manera somera las
62
+  posibilidades de RegEx para la edición. Para este caso tendrás acceso
63
+  a los ejemplos por medio de enlaces. Consulta el segundo subapartado del
64
+  tercer capítulo para más información.
65
+
66
+</section>
67
+<section epub:type="chapter" role="doc-chapter">
68
+
69
+# 1. Rege… ¿qué?, ¿pa qué?
70
+
71
+Como personas que editamos no es raro tener que modificar el documento que 
72
+estamos trabajando. Algunos cambios son singulares. Pero de vez en 
73
+cuando existe la necesidad de hacer muchos cambios. Unos
74
+podemos hacerlos con un simple `reemplazar todo`, p. ej. de «guión» a 
75
+«guion».
76
+
77
+Sin embargo, hay veces que no podemos llevar a cabo cambios literales como
78
+el del ejemplo pasado. Supongamos que tenemos una publicación donde los
79
+encabezados están numerados:
80
+
81
+```
82
+Capítulo 1. Un título A
83
+…
84
+Capítulo 2. Un título B
85
+…
86
+Capítulo 3. Un título C
87
+…
88
+```
89
+
90
+Y se nos pide eliminar el prefijo «Capítulo » para tener este resultado:
91
+
92
+```
93
+1. Un título A
94
+…
95
+2. Un título B
96
+…
97
+3. Un título C
98
+…
99
+```
100
+
101
+La solución sencilla implica hacer un `reemplazar todo` donde «Capítulo »
102
+sea sustituido por nada. ¿Qué pasa si adentro del texto hay una mención
103
+como «y en el capítulo 1…»? De manera desafortunada provocaremos un cambio
104
+a «y en el 1…». Podemos ser más exigentes y pedirle al programa que solo
105
+haga el cambio si la «C» está en versal. Sin embargo, ya tendremos un dejo 
106
+de sospecha, ¿tienes seguridad de que _únicamente_ cambió el texto 
107
+en el encabezado?
108
+
109
+O siguiendo el ejemplo. Supongamos que se nos asigna la tarea de eliminar
110
+todo el prefijo, incluido el número, el punto y el espacio antes del nombre
111
+del capítulo para conseguir este resultado:
112
+
113
+```
114
+Un título A
115
+…
116
+Un título B
117
+…
118
+Un título C
119
+…
120
+```
121
+
122
+
123
+La primera solución que podemos llegar es reemplazar de manera manual a
124
+«Capítulo 1. », «Capítulo 2. » y «Capítulo 3. ». La tarea no nos demora 
125
+mucho si nuestra obra tiene pocos encabezados. Pero ¿qué pasa si no es así? 
126
+Los dos volúmenes del _Don Quijote_ comprenden un total de 126 capítulos,
127
+¿cuánto tardarías en hacer el cambio de esta manera?
128
+
129
+La segunda aproximación es hacer varios `reemplazar todo` donde solo 
130
+aumentemos un dígito de manera manual. Es decir, abres la ventana de 
131
+`reemplazar` y primero pides cambiar «Capítulo 1. » por nada y copias esta
132
+línea de texto. A continuación vuelves a abrir esta ventana, pegas 
133
+«Capítulo 1. » y lo modificas por «Capítulo 2. » para hacer la nueva 
134
+sustitución.
135
+
136
+Con este mecanismo te ahorrarás más tiempo porque _no tienes que ver
137
+el contenido, mucho menos encontrarlo_. El programa lo hará por ti, tú solo
138
+te concentras en abrir la ventana de reemplazar, pegar el prefijo copiado
139
+con antelación, modificarlo y hacer el cambio. Así tres veces para este
140
+ejemplo o 126 veces con el _Don Quijote_… 
141
+
142
+No obstante, entre más complejo sea el documento, menos seguridad sentirás
143
+de que _únicamente_ sustituiste el prefijo en los encabezados.
144
+
145
+_En la búsqueda de sustituir de manera correcta tu documento, has empezado
146
+un proceso de abstracción_. Sabes que la «forma» a eliminar se expresa como
147
+«Capítulo _n_. » donde _n_ es cualquier dígito. Mejor cambiemos el término
148
+de «forma» por «fórmula». Con esta fórmula tenemos una combinación de
149
+caracteres con lo que podemos hacer cualquier cosa, sea eliminarlo o
150
+modificarlo. 
151
+
152
+Esta fórmula podemos expresarla como `^\\s*Capítulo\\s+\\d+\\.\\s+` y con 
153
+ello eliminar todo el prefijo incluso con estas consideraciones:
154
+
155
+* Puede haber espacios al inicio de «Capítulo».
156
+* No importa el tipo de espacios, inclusive pueden ser saltos de línea.
157
+* No importa que sean tres o cientos de encabezados.
158
+
159
+¿No me crees? Mira el primer ejemplo de este manual en [RegExr](https://regexr.com/422v0).
160
+
161
+![Coincidencias y reemplazos de la fórmula `^\\s*Capítulo\\s+\\d+\\.\\s+` en RegExr.](../img/img01.png)
162
+
163
+¡Qué carajos significa `^\\s*Capítulo\\s+\\d+\\.\\s+`! Ahorita no es importante,
164
+solo que _es una fórmula de RegEx_. Es muy compleja porque está diseñada 
165
+para considerar un formato demasiado caótico. _Esta sería más sencilla si 
166
+el texto estuviera menos sucio_.
167
+
168
+Si te das cuenta, solo estamos formalizando y racionalizando una 
169
+abstracción que ya habías realizado de modo intuitivo. RegEx es un lenguaje
170
+formal que permite concretar las abstracciones que haces sobre el texto. 
171
+Al abstraer el texto _de esta manera_ lo estás atomizando para contemplarlo 
172
+como una cadena de caracteres, cada uno con propiedades específicas.
173
+
174
+Por ejemplo, `A,a,á,1, ,-` son todos caracteres, pero distintos. Los 
175
+primeros tres son letras, de hecho _la misma letra_, pero en versal,
176
+minúscula o acentuada. El `1` es un dígito, específicamente el número uno.
177
+Aunque no sea visible, el quinto elemento es un espacio. Por último, `-` 
178
+no es una letra ni un dígito, sino un caracter especial para representar 
179
+al guion.
180
+
181
+¿Te das cuenta que no estás viendo estos caracteres como diseño ni como
182
+contenido? No te estás fijando en la «forma» de las `A,a,á`, sino viendo
183
+un cambio semántico _representado_ como usualmente escribimos esa letra
184
+en versal, minúscula o acentuada. Tampoco estás contemplando su 
185
+significado como para pensar si está escrita correctamente, como cuando 
186
+analizamos el texto como contenido. No te importa qué es `a`, si es la
187
+primera letra del abecedario, si proviene de la letra griega _α_ o si
188
+es una preposición, etc. Solo nos interesa que es una letra «a» minúscula.
189
+
190
+En realidad _ya no estas viendo al texto como diseño o contenido, sino 
191
+como estructura_. La ventaja que tenemos es que nos permite hacer 
192
+abstracciones y representarlas con fórmulas. La desventaja es que no
193
+es la manera usual en como tratamos el texto en la edición, por lo que
194
+en un pincipio nos costará trabajo entender esta perspectiva.
195
+
196
+Por ello, RegEx es un lenguaje formal muy potente que podrá ayudarnos a 
197
+mejorar la calidad de nuestra edición en distintos aspectos:
198
+
199
+1. Podremos _simplificar_ estructuras para obtener el mismo resultado
200
+   visible; esto nos ahorra peso en los archivos pero, principalmente, nos
201
+   dará mayor control. Siempre recuerda: _las estructuras simples son más
202
+   fáciles de manejar_.
203
+2. Podremos _modificar_ estructuras para cambiar la manera en como 
204
+   presentamos nuestro documento; es más rápido que un `reemplazar todo`
205
+   literal, además que nos da más certidumbre. Ten en mente: _con fórmulas
206
+   no tenemos ya que cotejar el documento; si hay un fallo, este será
207
+   uniforme por lo que su solución será sencilla_.
208
+3. Podremos _detectar_ deficiencias estructurales que afectan de manera
209
+   directa al contenido y diseño de nuestra publicación; evitaremos de una
210
+   vez por todas la falta de uniformidad en el contenido. Nunca olvides:
211
+   _la calidad editorial también reside en la uniformidad de la obra_.
212
+
213
+Entonces, ¿qué es RegEx y para qué lo necesitamos en la edición? Sin 
214
+titubear puedo decirte que _RegEx es un lenguaje que nos permitirá hacer 
215
+mejores libros_.
216
+
217
+</section>
218
+
219
+<section epub:type="chapter" role="doc-chapter">
220
+
221
+# 2. Primero lo primero: configuración del entorno de trabajo
222
+
223
+Tu _software_ de maquetación o procesador favorito ya cuentan con un
224
+intérprete de RegEx. Basta con activar la casilla de `expresiones 
225
+regulares` cuando abras la ventana de `reemplazar` o de `buscar`.
226
+
227
+Sin embargo, según el _software_ algunas funcionalidades van a estar
228
+implementadas o no. También puede llegar a variar la sintaxis. Para evitar
229
+dificultades entre lo que aquí ves y en tu editor aplicas, instalaremos
230
+Gedit.
231
+
232
+> __Atención__: si tu intención es terminar este manual lo más pronto 
233
+> posible, es mejor que te dirijas a la siguiente sección. El manual se 
234
+> puede usar de dos maneras, en la vía rápida no necesitas Gedit.
235
+
236
+Gedit es un editor de texto muy sencillo con un intérprete de RegEx lo
237
+demasiado potente para lo que haremos. Este programa fue creado para el 
238
+entorno de escritorio [+++GNOME+++](https://es.wikipedia.org/wiki/GNOME)
239
+presente en algunas distribuciones de Linux. Pero también existe una 
240
+versión de fácil instalación para usuarios de Windows o macOs.
241
+
242
+![Entorno gráfico por defecto de Gedit, así de simple.](../img/img02.png)
243
+
244
+Dependiendo de la arquitectura de tu Windows puedes descargar Gedit para
245
+[32 bits](http://ftp.gnome.org/pub/GNOME/binaries/win32/gedit/2.30/gedit-setup-2.30.1-1.exe)
246
+o [64 bits](http://ftp.gnome.org/pub/GNOME/binaries/win64/gedit/gedit-x86_64-3.20.1.msi).
247
+Se trata de un archivo ejecutable que con clics lo instalas. ¿No conoces 
248
+la arquitectura? Haz clic en el botón `Inicio`. A continuación con clic 
249
+derecho sobre `Equipo` seleccionas la opción `Propiedades`. En la pestaña 
250
+de `Sistema` tiene que indicarte la arquitectura como `tipo de sistema`.
251
+
252
+![Ejemplo de visualización del `tipo de sistema` de Windows.](../img/img03.png)
253
+
254
+Si tu computadora tiene macOS, [aquí](http://ftp.gnome.org/pub/GNOME/binaries/mac/gedit/3.2/gedit-3.2.6-3.dmg)
255
+puedes descargar el ejecutable. También basta con hacer un par de clics.
256
+Si estás teniendo problemas para instalarlo, puedes probar con cualquiera
257
+de los `dmg` disponibles en el [repositorio de +++GNOME+++](http://ftp.gnome.org/pub/GNOME/binaries/mac/gedit/3.2/).
258
+¿Nada de esto funciona? Quizá lo mejor es que primero instalar el gestor
259
+de paquetes [`brew`](https://brew.sh/) y al terminar ejecutar en la 
260
+terminal: `brew install gedit`.
261
+
262
+¿Usas Linux? Si usas +++GNOME+++ tendrías que tenerlo instalado. Si no es
263
+así, usa tu gestor de paquetes para instalar `gedit`. Si estás en otro
264
+entorno de escritorio, puedes probar con instalarlo o con seguridad ya
265
+tendrás un substituto…
266
+
267
+Por defecto Gedit puede lucir muy feo para ti. Lo primero que podemos 
268
+hacer es disminuir la anchura del tabulador para no ver tantos espacios
269
+en blanco cuando empecemos a trabajar. Para eso en la parte inferior
270
+vamos a hacer clic sobre `Anchura del tabulador` y vamos a seleccionar
271
+`2`, así como activar `Usar espacios`.
272
+
273
+![Configuración de la anchura del tabulador de Gedit.](../img/img04.png)
274
+
275
+A continuación, al lado derecho de `Anchura del tabulador` vamos a 
276
+configurar las líneas y columnas. Activaremos `Mostrar números de línea`,
277
+`Mostrar el margen derecho` y `Resaltar la línea actual`, así como 
278
+desactivaremos `Ajuste de texto`. Son muy importantes las primera y 
279
+última opciones porque así podrás localizar sin complicaciones el texto
280
+que estaremos mostrando en este manual.
281
+
282
+![Configuración de las líneas y columnas de Gedit.](../img/img05.png)
283
+
284
+Con eso es suficiente. Si deseas cambiar el esquema de color, fuente o
285
+tamaños, [aquí](https://help.gnome.org/users/gedit/stable/index.html.en#configure-gedit)
286
+puedes consultarlo. En mi caso prefiero temas oscuros, por lo que mi
287
+configuración se ve así:
288
+
289
+![Vista de Gedit con esquema de color distinto.](../img/img06.png)
290
+
291
+Con esto ¡ya casi estamos listos para empezar!
292
+
293
+</section>
294
+
295
+<section epub:type="chapter" role="doc-chapter">
296
+
297
+# 3. ¿Cómo vamos a trabajar?
298
+
299
+Este manual se puede usar de dos maneras:
300
+
301
+1. Haciendo ejercicios completos desde archivos de trabajo y con Gedit.
302
+2. Usando [RegExr](http://regexr.com/) como entorno de trabajo y para
303
+   ver los ejemplos de código.
304
+
305
+## Ejercicio completo
306
+
307
+El primer modo es el más recomendado si quieres tener una experiencia lo
308
+más cercana posible a lo que usualmente nos enfrentamos en la [edición 
309
+«desde cero»](https://marianaeguaras.com/edicion-digital-como-edicion-desde-cero).
310
+[Aquí](http://ted.cliteratu.re/src/manuals/src/02_intro-regex.zip)
311
+puedes descargar los archivos en +++ZIP+++. Al descomprimirlo tendremos
312
+una carpeta con lo siguiente:
313
+
314
+```
315
+02_intro-regex
316
+├── css
317
+│   ├── idGeneratedStyles.css
318
+│   └── styles.css
319
+└── html
320
+    └── contenido.html
321
+```
322
+
323
+El archivo que más usaremos en Gedit es el `contenido.html`. Trabajaremos 
324
+con un archivo +++HTML+++ que fue [exportado desde InDesign](https://helpx.adobe.com/indesign/using/export-content-html-cc.html).
325
+Esto se debe a que, según la metodología de la [edición ramificada](https://ed.cliteratu.re/),
326
+estamos buscando trabajar con [formatos abiertos](https://es.wikipedia.org/wiki/Formato_abierto) 
327
+que nos permitan crear varios tipos de soportes finales. Los archivos 
328
+del +++PDF+++.
329
+
330
+La carpeta también contiene dos [hojas de estilo +++CSS+++](https://es.wikipedia.org/wiki/Hoja_de_estilos_en_cascada). 
331
+El archivo `idGeneratedStyles.css` es la hoja generada automáticamente por
332
+InDesign. Nos servirá principalmente para saber cómo ha nombrado varios
333
+estilos en línea como son las itálicas, negritas o versalitas. El archivo
334
+`styles.css` es la actual hoja de estilos por defecto de [Pecas](https://pecas.cliteratu.re/)
335
+que nos dará un apoyo visual de las estructuras que estemos modificando.
336
+Se recomienda abrirlos con Gedit cuando se indique el caso.
337
+
338
+¿Ya abriste el archivo +++HTML+++? De seguro ya viste algo muy extraño:
339
+¡el texto está ofuscado! Esto se debe a que por cuestiones de derechos de
340
+autor (!) no podemos usar todo el contenido de _Videovigilancia en México_…
341
+Aunque nos gustaría poderte ofrecer todo el texto, es cierto que tampoco
342
+lo necesitamos. Recuerda: _trabajaremos con estructuras, no con diseño o
343
+contenido_. Más información al respecto la puedes leer en la siguiente
344
+subsección.
345
+
346
+## Una prueba de RegEx
347
+
348
+Si tu interés es más bien ver de manera somera lo que puede hacer RegEx 
349
+para la edición y quizá una que otra vez jugar con las fórmulas, cada 
350
+ejemplo estará disponible en [RegExr](http://regexr.com). Aquí estaremos
351
+colocando el ejemplo concreto, así como su enlace para que puedas ver y
352
+jugar en RegExr.
353
+
354
+Una gran diferencia entre esta modalidad y la completa es que aquí sí están
355
+disponibles los fragmentos sin ofuscar de _Videovigilancia en México_. Esto
356
+no genera conflicto porque la posición de líneas y columnas es exactamente
357
+la misma.
358
+
359
+Por ejemplo, aquí pondremos el contenido original de la línea 10 del
360
+archivo +++HTML+++:
361
+
362
+```
363
+      <p class="portadilla">Videovigilancia en México</p>
364
+```
365
+
366
+Que en el archivo `contenido.html` se verá así:
367
+
368
+```
369
+      <p class="portadilla">Kenaayuqeregwee an Sulice</p>
370
+```
371
+
372
+Si te fijas, tienen la misma estructura y cantidad de caracteres. Incluso 
373
+respeta diferencias entre mayúsculas, minúsculas, dígitos o caracteres 
374
+especiales. La divergencia es que las letras fueron cambiadas de manera 
375
+aleatoria —no hay criptografía, ni siquiera sencilla, por lo que el texto 
376
+no puede ser sometido a ingeniería inversa—.
377
+
378
+No obstante, esto no es ningún problema, porque trataremos con estructuras
379
+y ambos textos tienen que funcionar de la misma manera. Mira el [ejemplo 2](https://regexr.com/42304)
380
+para corroborarlo. Tampoco interesa ahorita qué carajos hace la fórmula de
381
+ese ejemplo. Sin importar que esté el texto ofuscado, cumple con el 
382
+propósito.
383
+
384
+> __Aclaración__: RegEx es el lenguaje que estaremos usando. Mientras que 
385
+> RegExr es una plataforma diseñada para ver ejemplos con RegEx. Una y otra 
386
+> son independientes aunque se relacionan en su pasión de creación de 
387
+> fórmulas para el procesamiento de información.
388
+
389
+¿Listo para empezar? ¡Conectémonos a la Matrix!
390
+
391
+</section>
392
+
393
+<section epub:type="chapter" role="doc-chapter">
394
+
395
+# Título 
396
+
397
+</section>
398
+
0 399
new file mode 100644
1 400
new file mode 100644
... ...
@@ -0,0 +1,2 @@
0
+¿Cómo curar un texto?
1
+Manual básico para el uso de RegEx en la limpieza de formato.