Jump to content
  • Revista PROGRAMAR: Já está disponível a edição #60 da revista programar. Faz já o download aqui!

Sign in to follow this  
msr

Themes para Javadoc

Recommended Posts

Knitter

Nunca ouvi falar de tal coisa, alterações ao aspecto no caso de Javadoc é o que menos importa, o que interessa é o conteúdo :D

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.

Share this post


Link to post
Share on other sites
msr

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 :D

Acabei por encontrar qualquer coisa aqui:

http://blog.applegrew.com/2008/05/get-my-javadoc-stylesheet-red-n-black-theme/

Share this post


Link to post
Share on other sites
Knitter

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.

Share this post


Link to post
Share on other sites
M6

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."

 

Share this post


Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now
Sign in to follow this  

×

Important Information

By using this site you accept our Terms of Use and Privacy Policy. We have placed cookies on your device to help make this website better. You can adjust your cookie settings, otherwise we'll assume you're okay to continue.