Getting Started

This guide helps you to quickly setup an sbt project to use paradox and write your first documentation pages.


Create project/paradox.sbt:

addSbtPlugin("com.lightbend.paradox" % "sbt-paradox" % "0.0.0+2-d69e594c-SNAPSHOT")

Inside build.sbt, add ParadoxPlugin to a subproject:

lazy val root = (project in file(".")).
    name := "Hello Project",
    paradoxTheme := Some(builtinParadoxTheme("generic"))

Writing documentation

Create your first documentation page in src/main/paradox/ which is the entry page of your documentation site.

# My Documentation

This is my first documentation page!

Generating documentation

Call paradox in sbt which will generate the site in target/paradox/site/main.


You may want to use ~ show paradox in sbt, which shows the absolute path where Paradox generated your documentation and which will automatically regenerate documentation when you change a documentation file.

Open target/paradox/site/main/index.html and admire the results!

First Generated Docs Page

The source code for this page can be found here.