Wie verwende ich Dub, um DDocs aus meinen Quelldateien zu erstellen? Es scheint keinen Standard-Befehl in Dub zu geben, um dies zu tun, und ich würde wirklich gerne in der Lage sein, diesen Prozess zu automatisieren.Verwenden von Dub zum Erstellen von Dokumentation
8
A
Antwort
5
Das Erstellen von Dokumenten über dub
wird tatsächlich über einen Buildtyp angegeben.
Versuchen Sie dub build --build=docs
oder dub build --build=ddox
.
Der erste erstellt "einfache" ddocs, letzterer verwendet dub, um ddox zu holen, um Ihre Dokumente zu formatieren.
Dies ist tatsächlich in der Hilfe gezeigt, es ist nur gut versteckt. Werfen Sie einen Blick auf den Build-Abschnitt von dub build -h
(Sie können dub <command> -h
verwenden, um detaillierte Hilfe zu einem bestimmten Befehl zu erhalten).
Da mein Compiler ist GDC, wie sich herausstellt, funktioniert dies nicht ohne einige zusätzliche Änderungen an "dub.json". Insbesondere haben Sie Folgendes hinzufügen: "buildTypes": { "docs": { "Buildoptions": [ "syntaxOnly"], "dflags": [ "c", "-fdoc", " -fdoc-dir =./docs "] } } –
Interessant - Sie können das upstream zum Überspielen melden, da ich denke, es sollte die richtigen Flags für Sie generieren. – rcorre
Ich werde das tun. –