Chcę utworzyć dokumentację dla mojego interfejsu API, która wygląda i działa tak, jak zestaw dokumentów Apple Core Library. Na przykład spójrz na stronę NSString.Jak utworzyć zestawy dokumentacji Xcode, które wyglądają i działają tak, jak te w Bibliotece głównej Apple
Próbowałem Doxygen i próbowałem headerdoc2html. Ani bardzo blisko tego, co chcę.
Pliki generowane przez headerdoc nie mają większości struktury wyższego poziomu, jaką robią pliki Apple, a projekt graficzny jest inny. W dół na bardziej szczegółowym poziomie, np. Patrząc na określoną metodę, rzeczy są bliższe, ale nie mają całej szczegółowej struktury.
Pliki generowane przez Doxygen mają zupełnie inną strukturę wysokiego poziomu, nie wspominając już o zupełnie innym projekcie graficznym.
Co jeszcze powinienem wypróbować? Czy są jakieś parametry któregoś z tych narzędzi, które dadzą mi coś bliżej?
Dzięki, Pat
Pytanie brzmiało, jak tworzyć zestawienia Xcode, które wyglądają jak te, które Apple dostarcza dla swoich interfejsów API. Jeśli Doxygen może to zrobić, nie mam pojęcia, jak jeszcze. –
oh, cóż w takim razie nie możesz po prostu użyć niestandardowego CSS, który wygląda jak Apple? –
Albo nie rozumiem wszystkich możliwości CSS, albo różnice są znacznie większe niż obsługa CSS. Na przykład wszystkie rzeczy w kolumnie po lewej stronie mają zupełnie inną strukturę, a nie tylko inny wygląd. Do moich własnych eksperymentów przyjrzałem się kilku przykładom użycia doxygen. Wszystko, co widziałem, pokazuje, że doxygen output ma bardzo charakterystyczną strukturę, format i wygląd, który bardzo różni się od dostarczanego przez Apple. –