paradox icon indicating copy to clipboard operation
paradox copied to clipboard

Where to put theme overrides when using Paradox with "tut"

Open metasim opened this issue 8 years ago • 4 comments

I'm configuring the use of Paradox with tut via sbt-site by doing the following:

sourceDirectory in Paradox := tutTargetDirectory.value,
makeSite := makeSite.dependsOn(tut).value,

I'm trying to override the contents of the source.st template in the "generic" theme.

My documentation source is in src/main/tut.

I've tried the following locations, and none seem to have an effect on the output:

  • src/main/tut/_template/source.st
  • src/main/tut/source.st
  • src/main/paradox/_template/source.st
  • src/main/paradox/source.st

I've also tried explicitly applying this setting:

sourceDirectory in Compile in paradoxTheme := sourceDirectory.value / "main" / "paradox" / "_template"

to no avail.

Any direction or example on how to work with "tut" would be great!

metasim avatar Aug 30 '17 20:08 metasim

When using Paradox with sbt-site everything is scoped using Paradox by default. So try something like this:

sourceDirectory in Paradox in paradoxTheme := sourceDirectory.value / "main" / "paradox" / "_template"

jonas avatar Aug 30 '17 22:08 jonas

@jonas That did it! Thanks so much!!

metasim avatar Aug 31 '17 01:08 metasim

Should we put this into docs? I can imagine more people wanting to use it like that

ktoso avatar Aug 31 '17 01:08 ktoso

Maybe a sub-page on integration with other plugins, to include sbt-site and sbt-tut & sbt-ghpages?

metasim avatar Aug 31 '17 02:08 metasim