A introdução da renderização troff/groff (man pages) seria aceita?
Atualmente, o GitHub apenas exibe arquivos groff no formato fonte, mas com uma ferramenta como man2html
ou mesmo apenas groff -mandoc -Thtml
ele poderia facilmente suportar exibi-los em algum formulário HTML básico.
Exemplo de arquivo groff:
https://github.com/woodruffw/screenfetch-c/blob/master/man/screenfetch-c.1
Renderizado com groff -mandoc -Thtml screenfetch-c.1
:
https://gist.github.com/woodruffw/1cb8a95766f9fee4fbd4
Se este é o tipo de coisa que a marcação deve suportar, eu ficaria feliz em adicioná-lo. Se depender de um utilitário externo como man2html
ou groff
não for aceitável, deve ser possível integrar a fonte de man2html
(que é apenas um script perl) neste repo ou traduzi-lo para ruby.
Estou interessado neste também. @woodruffw você fez algum progresso na implementação?
Eu vejo o nº 11 e o nº 342 como relacionados.
@hunterboerner Adicionar isso seria bem simples (apenas outra regra para markup
para verificar'), mas parece que não há interesse dos mantenedores/proprietários em adicionar novos formatos.
Alguma atualização para esse problema? Eu ainda adoraria ver esse apoio.
Infelizmente, é improvável que adicionemos suporte a novos formatos no futuro, pois cada formato requer manutenção contínua e trabalho de segurança de nossa parte. Ainda estamos procurando renderizar corretamente o blob de sandbox no futuro e, se/quando isso acontecer, será muito mais fácil adicionar formatos, mas no momento não podemos assumir o trabalho extra.
Há uma solicitação de pull aberta https://github.com/github/markup/pull/1196 para suporte à página de manual.
Comentários muito úteis
Há uma solicitação de pull aberta https://github.com/github/markup/pull/1196 para suporte à página de manual.