Doxygen: Formatierung der mainpage

[.:Sebastian:.]

Moin

Also zunächst mal ist dein hmtl gelinde gesagt etwas ... äh strange.
Zu jedem öffnenden <p> gehört normaler weise auch ein schließendes </p>.
P steht für paragraph und wird in html dazu genutzt eine Absatz Text zu definieren.

<p>Dieser Text ist mein erster Absatz. Blabla Lalala</p>
<p>Die ist mein zweiter Absatz.</p>

Du willst aber Zeilenumbrüche, wenn ich dich richtig verstehe.
Die macht man in html mit <br/>. Sieht aber in dem Kommentaren potthässlich aus.
Deshalb hat Doxygen dafür das \n eingeführt.

Wenn du wirklich eine Tabelle willst und nicht mit der Listen Darstellung leben kannst,
wirst du halt mit @htmlonly arbeiten müssen.
Tabs kann hmtl nämlich nicht. (text-indent mit css ist das höchste der Gefühle)

Allerdings würde ich mich da einschränken, damit das ganze halbwegs manierlich aussieht.

<table border="0" cellpadding="0"; cellspacing="2">
 <tr>
  <td><b>Ports:</b></td>
  <td>PA1</td>
  <td>LED rot</td>
 </tr>
 <tr>
  <td></td>
  <td>PA2</td>
  <td>LED grün</td>
 </tr>
 <tr>
  <td></td>
  <td>PA3</td>
  <td>LED gelb<p>alternativ Schalter A</td>
 </tr>
</table>

Ich bin mir da nicht mehr ganz sicher aber ich glaube du musst die " nicht escapen.
Was noch dazu kommt : http://www.stack.nl/~dimitri/doxygen/htmlcmds.html
Da steht Note that although these HTML tags are translated to the proper commands for output formats other than HTML, all attributes of a HTML tag are passed on to the HTML output only.
Sprich wenn du mal ein PDF oder ähnliches erzeugst sieht deine Tabelle sowieso ganz anders aus.
Von daher wäre in meinen Augen die Lösung als liste zu bevorzugen.

Wenn es aber unbedingt Tabellen sein müssen, würde ich das nicht in den Sourcecode packen.
(Ist bei der Mainpage sowieso die Frage in wie weit die in den Sourcecode rein sollte.)
Mach die Tabelle als externe html Datei und benutze /htmlinclude (http://www.stack.nl/~dimitri/doxygen...cmdhtmlinclude)
Und wenn du die Info trotzdem zusätzlich noch im Source haben willst, schreibs rein benutze Tabs und lass es Doxygen ignorieren.
Siehe Doxygen FAQ Punkt 4.
Dann musst da aber zwei Dateien pflegen.

Du siehst einen Tod wirst du so oder so sterben, Doxygen ist halt nicht OpenOffice und was noch dazu kommt nicht nur speziell zum erstellen von HTML-Seiten gedacht.

Gruß und gute Nacht (ich hau mich jetzt auch mal hin)
Sebastian

[Bot-Builder]

Moin!

... drücke das was du schreiben möchtest, auf anderem Wege aus.

Okay, aber was gibt es denn noch für andere Wege?

Also zunächst mal ist dein hmtl gelinde gesagt etwas ... äh strange.
Zu jedem öffnenden <p> gehört normaler weise auch ein schließendes </p>.

...
Die macht man in html mit <br/>. Sieht aber in dem Kommentaren potthässlich aus.
Deshalb hat Doxygen dafür das \n eingeführt.

Das sind meine ersten Gehversuche mit html. Und das kann man leider sehen. Habe Deine Hinweise mit <p>, </p> schon umgesetzt. Das mit <br\> bzw. \n habe ich ganz zu Anfang meiner Versuche mal probiert, hat da aber nicht funktioniert und dann habe ich es nicht weiter verfolgt. Das ist aber wohl was schief gelaufen, jetzt gehts.

Von daher wäre in meinen Augen die Lösung als liste zu bevorzugen.

Wenn es aber unbedingt Tabellen sein müssen, würde ich das nicht in den Sourcecode packen.
(Ist bei der Mainpage sowieso die Frage in wie weit die in den Sourcecode rein sollte.)
Mach die Tabelle als externe html Datei und benutze /htmlinclude

Ich werde es dann wohl so machen, wie Du vorgeschlagen hast. Bei schnellen Lösungen mit Listen. Und wenn es optisch schön sein soll, mit ausgelagerter reinen html mainpage.

Danke für Deine Tips.

Und Grüsse in den Kristallpalast auf Arkon I.

Bot-Builder