Re: Dub documentation with an initial ddoc file

[Anton Fediushin via Digitalmars-d-learn]

On Sunday, 3 September 2017 at 23:14:15 UTC, Conor O'Brien wrote:
I've been trying to figure out how to generate documentation 
for my project using dub. I have found this link[1] which told 
me how I could use dub to generate docs:

    dub build --build=docs <project-name>

However, I wish to have a set of macros that are present on 
every documentation file, that would define how the resultant 
HTML document is rendered. I tried:

    dub build --build=docs <project-name> html.ddoc

But I got the following error:

    Expected one or zero arguments.
    Run "dub build -h" for more information about the "build" 
command.

How might I include `html.ddoc` with every file that has 
documentation?

Add this to your dub.json:

"configurations": [
  {
    "name": "docs",
    "buildOptions": ["syntaxOnly"],
    "dflags": ["-Dddocs"],
    "sourceFiles": ["html.ddoc"]
  }
]

Or if you use dub.sdl:

configuration "docs" {
  buildOptions "syntaxOnly"
  dflags "-Dddocs"
  sourceFiles "html.ddoc"
}

This adds a new configuration named "docs", which can be used 
like this:

$ dub -c docs