sbt-microsites is an SBT plugin that facilitates the creation of fancy microsites for your projects, with minimal tweaks.

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 able 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 sbt-microsites plugin.

addSbtPlugin("com.47deg"  % "sbt-microsites" % "0.7.27")

Finally, to enable the plugin, add this to your build.sbt file:

enablePlugins(MicrositesPlugin)

We recommend taking a look at the Getting Started section at the documentation since there are some prerequisites that are needed to build your microsite.

# Documentation

Microsites comes with a range of options to customize and configure your project's site. Please visit the documentation section for more information.

If you already have some pre-existing documentation for your project, sbt-microsites also provides a Javascript plugin called Kazari (disabled by default) that decorates your code snippets with functionality that allows users to edit them live and run them in a remote Scala evaluator; making the learning process a whole lot easier.

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
	ZIO	A general-purpose effect monad, for asynchronicity and concurrency
	fs2	Functional Streams for Scala (FS2), based on cats and cats-effect
	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
	Atto	Everyday parsers.
	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

sbt-microsites is designed and developed by 47 Degrees

Copyright (C) 2016-2018 47 Degrees. http://47deg.com