Pergunta

Temos um projeto C# que, por razões históricas, usa comentários no estilo doxygen e visual studio no mesmo código. Alguém tentou traduzir sistematicamente um padrão para outro, de preferência para o subconjunto XML comum?

Eu acho que não seria muito difícil escrever um script para cobrir os recursos mais comuns, mas eu não gostaria de reinventar a roda.

Foi útil?

Solução

Eu sei que já faz um tempo desde que você perguntou, mas encontrei o mesmo problema. Aqui está o meu projeto de 10 minutos de código aberto que deve tornar a conversão um pouco menos indolor. :-) As extensões são bem-vindas!

https://code.google.com/p/doxygentoxmlconverter/

Outras dicas

A resposta original a esta pergunta também incluiu apenas um link, então eu faço o mesmo:

Primeiro, o link acima é antigo, aqui está uma versão mais recente do link: Link,

Além disso, adicionei uma variante de script completamente nova da solução: Link

Como o script Python original não funcionou para mim porque, no meu caso, tínhamos notação " breve" em vez de "@brief", então eu escrevi o meu. (Eu não falo python ainda)

Um recurso importante importante é que você pode adicionar facilmente a tradução de tags ou pular alguns deles:

translate["\\fn"]     = "skip";
translate["\\def"]    = "skip";
translate["\\class"]  = "skip";
translate["\\enum"]   = "skip";
translate["\\struct"] = "skip";
translate["\\author"] = "skip";
translate["\\brief"]  = "summary";
translate["\\param"]  = "param";
translate["\\return"] = "returns";

Mais tarde, também encontrei a nova versão do script Python original, então espero que ninguém tenha que iniciá -lo do zero novamente!

Se eu tivesse encontrado "apenas o link" para o novo script anteriormente, isso poderia me proteger de alguma dor de cabeça.

Licenciado em: CC-BY-SA com atribuição
Não afiliado a StackOverflow
scroll top