msr 0 Denunciar mensagem Publicado 2 de Março de 2010 Olá, Alguem conhece themes para aplicar na Javadoc? Ou como fazer um? O original é horrível. COMPONENT ORGANIZER easily organize your electronic parts and application notes Partilhar esta mensagem Ligação para a mensagem Partilhar noutros sites
Knitter 102 Denunciar mensagem Publicado 2 de Março de 2010 Nunca ouvi falar de tal coisa, alterações ao aspecto no caso de Javadoc é o que menos importa, o que interessa é o conteúdo Não sei sequer se são aplicados algumas formatações, creio que não têm nenhum CSS. Terás de criar estilos para os elementos de HTML e terás de modificar os ficheiros que são gerados pelas ferramentas de criação de javadoc. www.sergiolopes.eu Partilhar esta mensagem Ligação para a mensagem Partilhar noutros sites
msr 0 Denunciar mensagem Publicado 3 de Março de 2010 Bem, eu discordo... Preferes uma documentação com bom aspecto ou com mau aspecto? Não achas que a apresentação da documentação, recorrendo a cores que te identifiquem certos campos mais claramente e um estilo "limpo" te ajudam a consultar a documentação mais facilmente? Preferes um site plain text ou um que recorra a CSS? Ou mesmo um livro, preferes um que simplesmente despeje texto ou outro que tenha uma formatação mais cuidada? Isto é um pequeno desabafo, não é para levar a peito Acabei por encontrar qualquer coisa aqui: http://blog.applegrew.com/2008/05/get-my-javadoc-stylesheet-red-n-black-theme/ COMPONENT ORGANIZER easily organize your electronic parts and application notes Partilhar esta mensagem Ligação para a mensagem Partilhar noutros sites
Knitter 102 Denunciar mensagem Publicado 4 de Março de 2010 Não estamos a falar de um site nem de um livro, mas sim de documentação técnica, nesse sentido, prefiro simples e directa e correctamente apresentada, mas correctamente apresentada não quer dizer que queira estilos ou cores ou seja o que for, apenas que deve ser escrita com cuidado e não há estilo nenhum que corrija a escrita de quem fez a documentação. Se as tags Javadoc forem bem usadas e o texto bem escrito, o resultado é uma documentação fácil de ler, com os campos bem identificados, com os estilos base de HTML bem aplicados. Não digo que ter uma documentação bem transformada para ser apresentada num site não seja bom ou não tenha as suas vantagens mas pessoalmente não lhe dou valor nenhum. Qual é a diferença entre ter o texto a azul ou a negrito? Eu até posso ser daltónico. Texto, preto e branco, é simples e funcional, e isso é o que considero importante. Claro que é aquilo que eu gosto, se pretendes aplicar estilos à documentação estás no teu direito, mas como disse, nunca ouvi falar de tal coisa, e desconhecia completamente a necessidade. www.sergiolopes.eu Partilhar esta mensagem Ligação para a mensagem Partilhar noutros sites
M6 129 Denunciar mensagem Publicado 4 de Março de 2010 Experimenta o Doxygen: http://www.stack.nl/~dimitri/doxygen/ Creio que há opção de especificar um CSS. 10 REM Generation 48K! 20 INPUT "URL:", A$ 30 IF A$(1 TO 4) = "HTTP" THEN PRINT "400 Bad Request": GOTO 50 40 PRINT "404 Not Found" 50 PRINT "./M6 @ Portugal a Programar." Partilhar esta mensagem Ligação para a mensagem Partilhar noutros sites