Exportar a RST y MD

This topic contains 5 replies, has 2 voices, and was last updated by  Bienve 1 week, 2 days ago.

  • Author
    Posts
  • #30174

    Bienve
    Member

    Un saludo a tod@s, quería plantear algo a los desarrolladores.

    Veo muy interesantes los manuales de software opensource creados y mantenidos con reStructuredText (RST) y MarkDown (MD), y como se editan de forma colaborativa por múltiples autores, pero me parece difícil para aquellas personas que no son desarrolladores/programadores, sin embargo, cuando se utiliza un editor de texto tipo WYSIWYG los(as) usuarios(as) aumentan considerablemente, ya que la mayoría de personas saben utilizar Word, Writer y similares.

    ¿Podríais decirme si sería posible/viable implementar en eXeLearning la posibilidad de exportar a reStructuredText (RST) y MarkDown (MD)?

    El flujo de trabajo en el que estoy pensando es, editar en eXeLearning (WYSIWYG), exportar a RST o MD para utilizar los repositorios correspondientes y usar su sistema de edición colaborativa, y exportar desde estos sistemas a HTML, PDF, ePub. Por ejemplo, tener manuales como los de Blender y Godot, pero que en la primera fase de la edición pudiera hacerse con eXeLearning.

    Actualización:

    ¿Sería posible también que desde el mismo eXeLearning se trabajase con subversion y git para RST y MD?

    Gracias de antemano

    • This topic was modified 1 week, 6 days ago by  Bienve.
    • This topic was modified 1 week, 6 days ago by  Bienve.
    • This topic was modified 1 week, 6 days ago by  Bienve. Reason: actualización
  • #30179

    Ignacio Gros
    Member

    Hola Bienve:

    Es una propuesta interesante.

    > ¿Podríais decirme si sería posible/viable implementar en eXeLearning la posibilidad de exportar a reStructuredText (RST) y MarkDown (MD)?

    Posible es, pero habría que desarrollarlo (se puede partir de la exportación a fichero de texto plano, que es parecida). Hasta ahora, cuando se ha hablado de ese tipo de formatos, se han descartado, porque generalmente se usan para generar HTML, y eXe ya genera HTML. Lo volveremos a comentar en el grupo de trabajo por si se estima oportuno incluirlos más adelante, pero te adelanto que hay una lista de mejoras a realizar, y algunas de ellas son costosas.

    Si sabes de programación y te animas, tal vez podrías encargarte de las mejoras. Si estás interesado, escribe a la dirección que aparece a pie de página, por favor. También puedes crear una rama partiendo del código de eXe y avisarnos cuando tengas los cambios.

    > ¿Sería posible también que desde el mismo eXeLearning se trabajase con subversion y git para RST y MD?

    Esto no sé si lo he entendido bien. ¿Te refieres a integrar SVN y GIT en el propio eXeLearning para poder hacer commits, etc. desde la propia aplicación? Si es eso, creo que se escapa de los objetivos de eXe, porque no está concebida como una herramienta de desarrollo. En cualquier caso, la gestión de versiones sí se ha comentado alguna vez en el equipo de desarrollo, pero no con conexión a controles de versiones, sino pensando en el autoguardado y en la versión online de eXe.

    ¡Gracias por la sugerencia!

  • #30188

    Bienve
    Member

    Hola Ignacio, gracias por tu respuesta.

    No soy programador/desarrollador, aunque estoy algo familiarizado con este mundo y su tecnología.

    Considero que eXeLearning está enfocado a que lo usen docentes, que si además saben usar Moodle (u otro LMS), y usar FTP para subir archivos a un servidor, pues ya pueden colgar sus materiales didácticos, lo cual está genial.

    Sin embargo, si eXeLearning (python, Ext JS) formase parte del ecosistema de herramientas que se usan para los manuales en las comunidades y proyectos opensource, creo que el número de usuarios y desarrolladores de eXeLearning aumentaría bastante. En este sentido, pienso en comunidades como la de Blender (C, C++, python, otros), donde todas las extensiones (addons) del programa utilizan python, también el backend de su web usa python con Pillar framework (bifurcación de Flask).

    Blender tiene una cantidad enorme de usuarios del programa (profesionales y amateur) que no tienen ni idea de programación, pero que quieren contribuir a la comunidad con la documentación (manual) y las traducciones del mismo, pero al usar reStructuredText (RST), pues requiere de un conocimiento de RST y de Subversion que es el sistema de control de versiones que utilizan, y esto les genera problemas, porque en la práctica los manuales no se actualizan como deberían, ni tampoco las traducciones.

    En este sentido, eXeLearning tiene una gran oportunidad si se convierte en un editor WYSIWYG que sea capaz de exportar a reStructuredText (RST) y MarkDown, porque si lo adoptase Blender como herramienta para elaborar su manual, creo que contribuirían al desarrollo y difusión de eXeLearning, y a Blender le seguirían otras comunidades y proyectos.

    Opino que el flujo de trabajo para el manual de Blender u otros, debería ser:

    • editor WYSIWYG (eXeLearning a ser posible) > Exportar a RST (y/o MD) > commit (repositorio local git); push (repositorio remoto git), pero como autoguardado para aquellas personas que no saben utilizar git.

    Este flujo de trabajo, es válido también para elaboración colaborativa de materiales didácticos por parte de docentes, pero siempre se necesitaría alguien con conocimientos de git para gestionar respositorios, fusionar ramas, etc.

    Cuando preguntaba sobre integrar SVN y GIT en eXeLearning me refería a que al guardar como RST o MD, tuviera la opción de commit y push (creo que te refieres a esto con “autoguardado”), pero con Dulwich (pure python, GPLv2) podríais integrar los protocolos de git en eXeLearning.

    El trabajo que estáis haciendo con eXeLearning es muy bueno, pero tengo debilidad por la maquetación que hace RST con el tema sphinx_rtd_theme (python; PyPI), que funciona muy bien en dispositivos móviles, y además, tiene un buscador intregrado, que es algo que echo en falta en los materiales maquetados en eXeLearning, tal y como os dije en junio de 2016 (http://exelearning.net/forums/topic/taxonomia-y-buscador-integrado/) con motivo de la citada maquetación, y de ésta otra que me parecía muy buena: https://ioc.xtec.cat/materials/FP/Materials/ICC0_DAW/DAW_ICC0_M06/web/html/index.html

    Al ser python quizá podáis integrar el tema: sphinx rtd theme como parte de eXeLearning, que tiene licencia MIT compatible con GPLv2.

    Gracias de antemano.

     

    • This reply was modified 1 week, 2 days ago by  Bienve.
    • This reply was modified 1 week, 1 day ago by  Bienve.
  • #30190

    Ignacio Gros
    Member

    ¿”Algo” familiarizado? Gran explicación… Guardo el hilo para comentarlo en la próxima reunión del equipo de desarrollo. Todavía no hay fecha. También mandaré un correo por si alguien quiere ir opinando aquí. Te avisaré si hay novedades.

    Del buscador no me había olvidado. No recordaba que la sugerencia fuera tuya, pero no me olvido. Es sólo que hay tareas prioritarias en marcha. El recordatorio siempre viene bien…

    ¡Muchas gracias!

    • #30199

      Bienve
      Member

      Por cierto, en este link de la documentación de Sphinx, podeis encontrar “Conversores desde otros sistemas a reStructuredText/Sphinx“, y viceversa, quizá alguno de estos conversores, junto con vuestro sistema de exportación a texto plano, sean un buen punto de partida para convertir del formato nativo de eXe a RST.

      Incluso podríais hacer una “colaboración” con los desarrolladores de Pandoc, para que incluyan el formato nativo de eXe entre las muchas opciones de conversión de su aplicación (GPLv2), aunque principalmente desarrollada con Haskell (programación funcional), lo cual puede ser un inconveniente, si no se tiene conocimiento/competencia del citado paradigma.

      Un saludo

      • This reply was modified 1 week, 2 days ago by  Bienve.
      • This reply was modified 1 week, 2 days ago by  Bienve.
      • This reply was modified 1 week, 2 days ago by  Bienve.
      • This reply was modified 1 week, 2 days ago by  Bienve.
  • #30191

    Bienve
    Member

    Gracias Ignacio por tu amabilidad y tiempo, espero que mis aportaciones/sugerencias sean útiles para eXeLearning.

    Un cordial saludo.

You must be logged in to reply to this topic.