J'utilise Doxygen pour générer une documentation HTML à partir de mon code. Cependant, je trouve que la feuille de style par défaut n'offre pas un très bon choix de polices et de mise en page. Je sais que je peux écrire mon propre fichier CSS pour obtenir exactement le résultat que je souhaite, mais avant de passer mon temps à le faire, je me demande s'il existe déjà des feuilles de style personnalisées décentes.
Réponses
Trop de publicités?
J'ai apporté quelques modifications de base au CSS de Doxygen pour le nettoyer un peu. Je l'ai téléchargé sur bitbucket.org/rc1/doxygen-style/
Quinn Taylor
Points
29688
Je ne sais pas si vous avez trouvé une réponse à cette question qui n'est plus d'actualité, mais je tenais à signaler que la version 1.5.7 de Doxygen (publiée environ une semaine avant la rédaction de cette question) inclut certaines modifications CSS que j'ai soumises, de sorte qu'elle devrait être un peu plus propre. (Cela n'a pas nécessité que beaucoup d'ajustements - il semblait déjà être dans une forme assez décente). Si vous utilisez (utilisiez ?) une ancienne version de Doxygen, la version mise à jour de doxygen.css devrait encore fonctionner correctement avec la plupart des anciennes versions, puisque je ne pense pas que la structure de la sortie HTML ait changé de manière appréciable dans un passé récent.
Harold Bamford
Points
728
Je n'ai pas de gros problème avec les styles par défaut, SAUF que la taille de la police de base est fixée à 12 pt (une modification récente). Cela signifie qu'elle ne sera jamais de la bonne taille et qu'elle ne peut pas être ajustée dynamiquement.
Voici quelques modifications triviales que j'ai apportées à la version par défaut sur ma machine. J'ai surtout changé les tailles de police codées en dur en tailles nommées ou relatives, afin que Ctrl-Mousewheel puisse facilement ajuster la taille. De même, j'ai également changé (non montré ici) d'autres tailles de (par exemple) 11pt à 92% (basé sur la valeur originale de 12pt).
J'ai également ajouté code , tt et pre car ils me semblaient un peu étranges.
Il est clair que le CSS de personne ne sera totalement acceptable pour quelqu'un d'autre. Le mieux que l'on puisse espérer est une certaine uniformité, une facilité d'utilisation et le moins d'effusion de sang possible...
body, table, div, p, dl {
font-family: Lucida Grande, Verdana, Geneva, Arial, sans-serif;
font-size: medium;
}
/* Ensure that <CODE> and <TT> text is as big as the <BODY> text and use a nicer font */
code, tt {
font-family: Consolas, Courier, monospace;
font-size: medium;
}
/* Need this as <PRE> makes the text look smaller due to different font */
pre {
font-size: 105%;
}
alexdantas
Points
159
Je crée également une feuille de style Doxygen personnalisée. J'ai l'intention de commenter beaucoup afin de faciliter la modélisation.
Vous pouvez consulter mon code sur GitHub ici .
Lou Franco
Points
48823
