it-swarm-es.tech

¿Cómo se genera la documentación de Joomla Issue Tracker?

¿Alguien aquí puede compartir alguna luz sobre cómo se hicieron estos documentos de Joomla

http://issues.joomla.org/documentation/

Sé que los documentos se extraen de los archivos de github MD, pero si alguien pudiera explicar el proceso, ya que no encuentro exactamente cómo hacerlo.

4
Dan

La documentación se almacena en nuestro JIssues GitHub repo en formato Markdown para facilitar el procesamiento y la contribución.

Para mostrar los documentos en el sitio , usamos un script de línea de comando que escanea la carpeta, analiza el documento Markdown en HTML a través de la API de GitHub, y la representación se almacena en la base de datos.

7
Michael

Por lo tanto, el rastreador JIssues utiliza el Marco Joomla, por lo que algunas de las dependencias de github se incluyen a través de composer desde https://github.com/joomla-framework/github-api

El código específico de los archivos md aquí https://github.com/joomla/jissues/tree/master/Documentation

El código que los toma para renderizar está aquí: https://github.com/joomla/jissues/tree/master/src/App/Support (el árbol de archivos con el complemento de árbol jQuery está en el controlador Filetree.php etc.)

Y finalmente, el renderizado está en una plantilla twig que se encuentra aquí: https://github.com/joomla/jissues/blob/master/templates/support/documentation.index.twig

5
George Wilson