Come utilizzare Dub per creare DDoc dai miei file sorgente? Sembra che non ci sia alcun comando predefinito in dub per fare questo, e mi piacerebbe davvero essere in grado di automatizzare questo processo.Utilizzo di dub per compilare la documentazione
La creazione di documenti tramite dub viene effettivamente specificata tramite un tipo di build.
Prova dub build --build=docs o dub build --build=ddox.
Il precedente crea ddoc "semplici", quest'ultimo usa il doppino per recuperare ddox per formattare i documenti.
Questo è effettivamente mostrato nell'aiuto, è appena ben nascosto. Dai un'occhiata alla sezione 'build' di dub build -h (puoi usare dub <command> -h per ottenere informazioni dettagliate su un comando specifico).
Come il mio compilatore è GDC, come risulta, questo non funziona senza alcune modifiche aggiuntive a '' dub.json''. In particolare, si deve aggiungere il seguente: "buildTypes": { "Docs": { "buildOptions": [ ""] syntaxonly, "dflags": [ "-c", "-fdoc", " -fdoc-dir =./docs "] } } –
Interessante - si consiglia di segnalare che upstream per dub, poiché penso che dovrebbe generare le bandiere appropriate per voi. – rcorre
Lo farò. –