ayuda para idiomas en markdown

app/views/application/markdown.haml

@@ -54,6 +54,19 @@
             %ol
               - 3.times do
                 %li= t('help.markdown.ol')
+        %tr
+          %td{colspan: 2}= t('help.markdown.dir')
+        %tr
+          %td
+            %code= "[#{t('help.markdown.ltr')}]{dir=ltr lang=es}"
+          %td
+            %span{dir: 'ltr', lang: 'es'}= t('help.markdown.ltr')
+        %tr
+          %td
+            %code= "[#{t('help.markdown.rtl')}]{dir=rtl lang=es}"
+          %td
+            %span{dir: 'rtl', lang: 'es'}= t('help.markdown.rtl')
+
         %tr
           %td
             %code= "![#{t('help.markdown.img.text')}](#{t('help.markdown.img.url')})"

config/locales/en.yml

@@ -75,7 +75,15 @@ en:
       img:
         text: 'Kéfir island'
         url: 'https://kefir.red/images/isla.png'
-    distraction_free_html: 'You can a distraction free writing session
+      ltr: 'Introduction'
+      rtl: 'مقدمة'
+      dir: "These are tricky.  If you want to use an expression in a
+      language using another direction, like using an Arabic expression
+      on an English text, or viceversa, you have to inform both
+      direction and language so the markdown processor understands it
+      has to change it internally.  Otherwise you may see out of order
+      words, specially in the PDF results."
+    distraction_free_html: 'You can have a distraction free writing session
     by clicking the <span class="fa fa-expand"></span> button'
     preview_html: 'Click the <span class="fa fa-search"></span> preview
     button to see the results.'

config/locales/es.yml

@@ -78,6 +78,14 @@ es:
       img:
         text: 'La isla de Kéfir'
         url: 'https://kefir.red/images/isla.png'
+      ltr: 'Introducción'
+      rtl: 'مقدمة'
+      dir: 'Esta sintaxis puede ser complicada.  Si quieres mezclar
+      expresiones en idiomas que usan otra dirección, como usar una
+      expresión en árabe en medio de un texto en castellano, o
+      viceversa, tienes que especificar la dirección y el idioma de esta
+      manera.  De otra forma verás palabras fuera de orden,
+      especialmente en la versión en PDF.'
     distraction_free_html: 'Puedes escribir sin distracciones presionando el botón <span class="fa fa-expand"></span>'
     preview_html: 'Utiliza el botón de <span class="fa fa-search"></span> previsualización para ver el texto generado'
     autocomplete_html: 'Algunos de estos campos se autocompletan.  Si ya