Skip to content
/ Laika Public
forked from typelevel/Laika

Text Markup Transformer for sbt and Scala applications

License

Notifications You must be signed in to change notification settings

kokorins/Laika

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Laika

Customizable and extensible toolkit for transforming lightweight text markup and template based site generation.

Supporting Markdown and reStructuredText as input and HTML as output, through its integrated sbt plugin or embedded in Scala applications, without the need to install external tools.

Open Source under the Apache 2.0 License.

Getting Started

The main artifact is published to Maven Central for Scala 2.10.x.

The sbt plugin is published to the sbt plugin repository for sbt 0.13.x.

Using the sbt Plugin

Add the plugin to project/plugins.sbt:

addSbtPlugin("org.planet42" % "laika-sbt" % "0.5.0")

Import its default settings in your project's build.sbt:

LaikaPlugin.defaults

Add Markdown, reStructuredText or HTML template files to src/docs in your project and run the laika:site task from within sbt to generate the site in target/docs/site.

Using Laika Embedded

Adding the Laika dependency to your sbt build:

libraryDependencies += "org.planet42" %% "laika-core" % "0.5.0"

Example for transforming from file to file:

Transform from Markdown to HTML fromFile "hello.md" toFile "hello.html"

Example for transforming an entire directory of markup files:

Transform from ReStructuredText to HTML fromDirectory "source" toDirectory "target"

Other Resources

For further information:

  • Read the Manual.

  • Try out Laika with the Web Tool.

  • Browse the API.

  • Follow on Twitter for release announcements.

  • Create Issues here on GitHub for bug reports or enhancement requests.

  • Ask questions on Stackoverflow, tagging with Laika and Scala.

About

Text Markup Transformer for sbt and Scala applications

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Scala 76.9%
  • HTML 23.0%
  • CSS 0.1%