gcss

README

GCSS - Pure Go CSS Preprocessor


Overview

GCSS is a pure Go CSS preprocessor. This is inspired by Sass and Stylus.

Syntax

Variables

$base-font: Helvetica, sans-serif
$main-color: blue

body
  font: 100% $base-font
  color: $main-color

Nesting

nav
  ul
    margin: 0
    padding: 0

a
  color: blue
  &:hover
    color: red

Mixins

$border-radius($radius)
  -webkit-border-radius: $radius
  -moz-border-radius: $radius
  -ms-border-radius: $radius
  border-radius: $radius

.box
  $border-radius(10px)

Installation

$ go get -u github.com/yosssi/gcss/...

Compile from the Command-Line

$ gcss /path/to/gcss/file

or

$ cat /path/to/gcss/file | gcss > /path/to/css/file

Compile from Go programs

You can compile a GCSS file from Go programs by invoking the gcss.CompileFile function.

cssPath, err := gcss.CompileFile("path_to_gcss_file")

if err != nil {
	http.Error(w, err.Error(), http.StatusInternalServerError)
	return
}

http.ServeFile(w, r, cssPath)

You can invoke the gcss.Compile function instead of the gcss.CompileFile function. The gcss.Compile function takes io.Writer and io.Reader as a parameter, compiles the GCSS data which is read from the io.Reader and writes the result CSS data to the io.Writer. Please see the GoDoc for the details.

f, err := os.Open("path_to_gcss_file")

if err != nil {
	panic(err)
}

defer func() {
	if err := f.Close(); err != nil {
		panic(err)
	}
}()

n, err := gcss.Compile(os.Stdout, f)

Documentation

• GoDoc

Syntax Highlightings

• vim-gcss - Vim syntax highlighting for GCSS

Documentation

Overview

Package gcss provides the CSS preprocessor.

Index

• Constants
• func Compile(dst io.Writer, src io.Reader) (int, error)
• func CompileFile(path string) (string, error)
• func Path(path string) string

Constants

const Version = "GCSS 0.1.0"

Version is the version of GCSS.

Functions

func Compile

func Compile(dst io.Writer, src io.Reader) (int, error)

Compile compiles GCSS data which is read from src and Writes the result CSS data to the dst.

func CompileFile

func CompileFile(path string) (string, error)

CompileFile parses the GCSS file specified by the path parameter, generates a CSS file and returns the path of the generated CSS file and an error when it occurs.

func Path

func Path(path string) string

Path converts path's extenstion into a GCSS file extension.