ti-enxame.com

Como é gerada a documentação do Joomla Issue Tracker?

Alguém aqui pode compartilhar alguma luz sobre como esses documentos do Joomla foram criados

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

Eu sei que os documentos são extraídos dos arquivos MD do github, mas se alguém puder explicar o processo, já que não estou encontrando exatamente como.

4
Dan

A documentação é armazenada em nosso repositório JIssues GitHub no formato Markdown para facilitar o processamento e a contribuição.

Para exibir os documentos no site , usamos um script de linha de comando que verifica a pasta, analisa o documento Markdown em HTML via a API do GitHub e a renderização é armazenada no banco de dados.

7
Michael

Portanto, o rastreador JIssues usa o Joomla Framework - portanto, algumas das dependências do github são agrupadas em via composer from https://github.com/joomla-framework/github-api

O código específico dos arquivos md aqui https://github.com/joomla/jissues/tree/master/Documentation

O código que os agarra para renderização está aqui: https://github.com/joomla/jissues/tree/master/src/App/Support (a árvore de arquivos com o plug-in da árvore jQuery está no diretório controlador Filetree.php etc.)

E, finalmente, a renderização está em um modelo twig encontrado aqui: https://github.com/joomla/jissues/blob/master/templates/support/documentation.index.twig

5
George Wilson