sbt-microsites is an SBT plugin that facilitates the creation of fancy microsites for your projects, with minimal tweaks.
What is a microsite?
A microsite is an instance of Jekyll, ready to publish a static web page for your new library. Some of the benefits of having these auto-generated web pages are:
- You can write documentation easily in markdown format.
- Templates, layouts, styles, and other resources will be available through the plugin at compile time.
- You don't have to deal with the styling.
To begin, add the following lines to the
project/plugins.sbt file within your project or sbt module where you want to use the
addSbtPlugin("com.47deg" % "sbt-microsites" % "0.9.7")
Finally, to enable the plugin, add this to your
We recommend taking a look at the
Getting Started section in the documentation since there are some prerequisites that are needed to build your microsite.
Microsites comes with a range of options to customize and configure your project's site. Please visit the documentation section for more information.
sbt-microsites in the wild
Many Scala projects, libraries, and applications use sbt-microsites to display documentation and project notes. If you wish to add your library here, please consider a PR to include it in the list below.
|Cats||A library of typeclasses for functional programming, such as functors, monads, and arrows.|
|Scalaz||A library of typeclasses for functional programming, such as functors, monads, and arrows.|
|Cats-Effect||Extension of Cats for general effect types, with asynchronicity and concurrency|
|fs2||Functional Streams for Scala (FS2), based on
|pureconfig||A library for loading configuration files|
|ciris||A configuration as code library for compile-time safe configurations|
|Tuco||Tuco is a reasonable telnet server for Scala|
|Typelevel Scala||Our fork of the Scala compiler|
|Monocle||Optics library for Scala|
|ScalaCache||A facade for popular cache implementations, such as Caffeine, Redis, or Memcached|
|scalacheck-toolbox||Generating sensible data with ScalaCheck|
|Algebird||Algebraic typeclasses and data structures for big data|
|Scalding||Scala API for Hadoop and Cascading|
|Finch||A combinator API over the Finagle HTTP services|
|fetch||Simple & Efficient data access for Scala and Scala.js|
|github4s||A GitHub API wrapper written in Scala|
|hammock||A purely functional HTTP client for Scala|
|cron4s||A CRON expression parser and AST for Scala|
|freestyle||A cohesive & pragmatic framework of FP centric Scala libraries|
|libra||A dimensional analysis library based on dependent types|
|Airframe||A dependency injection library for Scala and Scala.js|
|Scanamo||Simpler DynamoDB access for Scala|
|Mocked Streams||Scala DSL for Unit-Testing Kafka Streams Topologies|
sbt-microsites is designed and developed by 47 Degrees
Copyright (C) 2016-2019 47 Degrees. http://47deg.com