Paradox
The sbt-site plugin has direct support for building Paradox projects.
To enable the “sbt site Paradox” plugin in your sbt project, add the following to your project/plugins.sbt
file:
addSbtPlugin("com.github.sbt" % "sbt-site-paradox" % "1.5.0")
And enable the ParadoxSitePlugin
plugin in your build.sbt
file:
sourceenablePlugins(SitePreviewPlugin, ParadoxSitePlugin)
This assumes you have a Paradox project under the src/main/paradox
directory. To change this, set the sourceDirectory
key in the paradox
task scope:
paradox / sourceDirectory := sourceDirectory.value / "doc"
If you are configuring Paradox from scratch remember to also configure a theme:
sourceparadoxTheme := Some(builtinParadoxTheme("generic"))
Note that all of the Paradox settings mentioned in the Paradox documentation are reused by sbt-site. For example to configure an @extref
link prefix use:
sourceparadoxProperties ++= Map(
"extref.rfc.base_url" -> "https://tools.ietf.org/html/rfc%s"
)
1.5.0