Chciałbym dołączyć do dokumentacji trochę surowego kodu HTML. Używam Doxygen do generowania tej dokumentacji, więc jest ona zawarta w skrypcie PHP.

Problem polega na tym, że jeśli to zrobię:

\\\ \htmlonly
<table>
.... etc

\\\ \endhtmlonly

PHP analizuje surowy kod HTML i dlatego generuje błędy.

Ale jeśli dodam '///' na początku każdej linii występującej na wygenerowanej stronie.

Jakie jest rozwiązanie tego problemu? Czy jest możliwe, aby Doxygen wygenerował tabelę przy użyciu różnych tagów?

0
Ed Heal 21 październik 2012, 11:16

2 odpowiedzi

Najlepsza odpowiedź

Nie jestem pewien kontekstu twojego przykładowego kodu, ponieważ nie znam PHP, ale ogólnie komentarze doxygen wyglądają tak:

/// \htmlonly
/// <table>
/// .... etc
/// \endhtmlonly

Zwróć uwagę, że wszystkie linie komentarzy (doxygen analizuje komentarze, a nie kod źródłowy w celu wygenerowania dokumentacji) zaczynają się od ///, nawet kod HTML. /// zostanie usunięty z kodu HTML przed dołączeniem do dokumentacji. Wypróbuj powyższe i sprawdź, czy to rozwiąże Twój problem. Jeśli nie, czy możesz podać więcej kontekstu, tj. minimalny przykład pracy.

1
Chris 22 październik 2012, 15:22

Czy używasz include()? Przetwarza kod HTML, ale nie jest to potrzebne. Zamiast tego użyj fpassthru.

-1
Martin Ueding 20 czerwiec 2013, 12:14