Jak używać programu dub do tworzenia plików DDocs z plików źródłowych? Wygląda na to, że nie ma domyślnego polecenia w dubie, i chciałbym móc zautomatyzować ten proces.Używanie programu dub do tworzenia dokumentacji
Dokumenty budowlane przez dub są rzeczywiście określone za pomocą typu kompilacji.
Wypróbuj dub build --build=docs lub dub build --build=ddox.
Ten pierwszy tworzy "zwykły" ddocs, drugi używa dub do pobrania ddox w celu sformatowania dokumentów.
Zostało to pokazane w pomocy, jest po prostu dobrze ukryte. Zajrzyj do sekcji "kompilacja" pod numerem dub build -h (możesz użyć dub <command> -h, aby uzyskać szczegółową pomoc dotyczącą określonego polecenia).
Ponieważ moim kompilatorem jest GDC, jak się okazuje, nie działa to bez dodatkowych zmian w '' dub.json''. W szczególności, należy dodać następujące: "buildTypes": { "Docs": { "buildOptions": [ "syntaxOnly"] "dflags": [ "-c", "-fdoc", " -fdoc-dir =./docs "] } } –
Interesujące - możesz chcieć zgłosić to do dubu, ponieważ myślę, że powinno wygenerować odpowiednie flagi dla ciebie. – rcorre
Zrobię to. –