Czy można wygenerować zestaw stron wiki z pliku komentarza XML wygenerowanego przez Visual Studio?Czy można wikifikowac komentarze Visual Studio XML?
Mówię o czymś takim jak Sandcastle, ale w przypadku formatu wiki zamiast kompilowanego CHM.
Edytuj: Używam MediaWiki, które może importować/eksportować artykuły w formacie XML. Mam więc nadzieję, że można napisać transformację konwertującą komentarze XML do MediaWiki XML.
polecam nieco inne rozwiązanie:
<see href="..."> połączyć stron Wiki z XML komentarzeTo nie jest dokładnie to, czego chciał, ale mam nadzieję, że to będzie pomocne.
Dzięki. To nie jest kompletne rozwiązanie, którego szukałem, ale jest o wiele bardziej użyteczne niż bezsensowna odpowiedź doxygen. – Dmitry
Jeśli powyższe elementy nie są wystarczające, czy starał się po prostu zbudować własną transformację XSLT na wybrany przez siebie język wiki?
Możesz napisać prostą aplikację w .NET (lub wybrać platformę z wyboru), aby przekształcić format dokumentu doc do formatu XML wiki. Nadal musisz ręcznie aktualizować wiki z plikami wyjściowymi.
Tak, to powinno działać. Wymaga to jednak czasu i zasobów ludzkich, których nie posiadam. – Dmitry
Jak w przypadku jednorazowej migracji z wbudowanego XML do MediaWiki XML? Ponieważ nie widzę, w jaki sposób zamierzasz zachować synchronizację, jeśli zamierzasz zachować wbudowane komentarze XML i zezwolić użytkownikom na edycję MediaWiki. –
Strony Wiki z dokumentacją techniczną nie powinny być edytowane przez użytkowników z wyjątkiem klas podstawowych opracowanych wiele lat temu i nie będą już zmieniane. Istnieją ogólne artykuły opisujące klasy i ich wykorzystanie, po prostu chcę dodać link do szczegółowego opisu programowania. – Dmitry
Co zyskujesz, mając go na wiki? Główną zaletą wiki jest to, że można ją łatwo edytować. Jednak nie zamierzasz edytować strony ręcznie. To naprawdę brzmi jak najlepsze podejście to po prostu nie używać wiki i bezpośrednio umieszczać pliki na serwerze w folderze w pobliżu wiki. – Yuliy