First commit!

Author: xsynaptic

.gitattributes

@@ -0,0 +1,46 @@
+# .gitattributes adapted from https://github.com/Danimoth/gitattributes
+
+# Auto detect text files and perform LF normalization via http://davidlaing.com/2012/09/19/customise-your-gitattributes-to-become-a-git-ninja/
+* text=auto
+
+# These files are text and should be normalized (Convert crlf => lf)
+*.php text
+*.css text
+*.js text
+*.htm text
+*.html text
+*.xml text
+*.txt text
+*.ini text
+*.inc text
+.htaccess text
+
+# Documents
+*.doc  diff=astextplain
+*.DOC  diff=astextplain
+*.docx diff=astextplain
+*.DOCX diff=astextplain
+*.dot  diff=astextplain
+*.DOT  diff=astextplain
+*.pdf  diff=astextplain
+*.PDF  diff=astextplain
+*.rtf  diff=astextplain
+*.RTF  diff=astextplain
+
+# These files are binary and should be left untouched
+# (binary is a macro for -text -diff)
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.mov binary
+*.mp4 binary
+*.mp3 binary
+*.flv binary
+*.fla binary
+*.swf binary
+*.gz binary
+*.zip binary
+*.7z binary
+*.ttf binary

.gitignore

@@ -0,0 +1,21 @@
+## General
+.cvs
+.htaccess
+.svn
+*.bak
+*.log
+*.swp
+
+## Windows
+Desktop.ini
+Thumbs.db
+
+## Mac
+.DS_Store
+
+## Development
+.sass-cache
+bower_components
+node_modules
+
+## Project specific

_font_stacker.scss

@@ -0,0 +1,74 @@
+// ==== FONT STACKER ==== //
+
+// Read more about this Sass micro-library: https://github.com/synapticism/sass-font-stacker
+
+// Set a default font stack; if you see monospaced type something probably went wrong ;)
+$k-font-stack-default: courier;
+
+// Font stack definitions
+$k-font-stacks: (
+
+  // Serif stacks
+  cambria:        (Cambria, Constantia, "URW Palladio L", "Palatino Linotype", Palatino, Georgia, "Book Antiqua", "Times New Roman", serif),
+  georgia:        (Georgia, "Palatino Linotype", Palatino, "URW Palladio L", "Book Antiqua", "Times New Roman", serif),
+  times:          ("Times New Roman", Times, Georgia, "DejaVu Serif", serif),
+
+  // Sans-serif stacks
+  arial:          (Arial, Helvetica, "Nimbus Sans L", sans-serif),
+  calibri:        (Calibri, "DejaVu Sans Condensed", Tahoma, "Lucida Sans", "Lucida Grande", "Bitstream Vera Sans", "Liberation Sans", Verdana, sans-serif),
+  corbel:         (Corbel, "Helvetica Neue", Helvetica, Arial, "Nimbus Sans L", "Liberation Sans", sans-serif),
+  helvetica:      (Helvetica, Arial, "Nimbus Sans L", sans-serif),
+  helvetica-n:    ("Helvetica Neue", Helvetica, Arial, "Nimbus Sans L", "Liberation Sans", Corbel, sans-serif), // Targets OS X
+  helvetica-nl:   ("HelveticaNeue-Light", "Helvetica-Neue-Light", "Helvetica Neue Light", "Helvetica Neue", Helvetica, Arial, "Nimbus Sans L", "Liberation Sans", Corbel, sans-serif), // Targets OS X
+  tahoma:         (Tahoma, "DejaVu Sans", "Lucida Sans", "Lucida Grande", "Bitstream Vera Sans", "Liberation Sans", Verdana, sans-serif),
+  verdana:        (Verdana, Tahoma, "DejaVu Sans", sans-serif),
+
+  // Monospace stacks
+  andale:         ("Andale Mono WT", "Andale Mono", "Lucida Console", "Lucida Sans Typewriter", "DejaVu Sans Mono", "Bitstream Vera Sans Mono", "Liberation Mono", "Nimbus Mono L", Monaco, "Courier New", Courier, monospace),
+  consolas:       (Consolas, "Bitstream Vera Sans Mono", "Andale Mono", Monaco, "DejaVu Sans Mono", "Lucida Console", monospace),
+  courier:        ("Courier 10 Pitch", "Courier New", Courier, "Lucida Sans Typewriter", "Lucida Typewriter", monospace),
+
+  // Chinese stacks (experimental)
+  zh-sans:        ("Heiti TC", "Heiti SC", "微軟正黑體", "Microsoft JhengHei", "Microsoft YaHei New", "Microsoft Yahei", "微软雅黑", "宋体", SimSun, STXihei, "华文细黑"),
+  zh-serif:       ("LiSong Pro", "新細明體", PMingLiU, STSong, STKaiti),
+
+  // Fundamentals
+  monospace:      (monospace),
+  sans-serif:     (sans-serif),
+  serif:          (serif)
+);
+
+// Font stacker function; accepts an arbitrary list font names (including none at all) ending in the name of a valid font stack from the list above
+@function k-font-stack($fonts...) {
+
+  // Assume the target stack is the last value in the arglist; break it off into a string
+  $stack: nth($fonts, -1);
+
+  // Remove the last value from the arglist to avoid duplication or create an empty list as needed
+  @if length($fonts) > 1 {
+    $fonts: set-nth($fonts, -1, null);
+  } @else {
+    $fonts: ();
+  }
+
+  // Check to see if the stack exists and return the combined list; fallback to the default if nothing else
+  @if map-has-key($k-font-stacks, $stack) {
+    @return join($fonts, map-get($k-font-stacks, $stack));
+  } @else {
+    @warn "Font stack not found: '#{$stack}'.";
+    @if map-has-key($k-font-stacks, $k-font-stack-default) {
+      @return join($fonts, map-get($k-font-stacks, $stack));
+    }
+  }
+
+  // Font stack could not be found and default could not be loaded (since we're still here); issue another warning
+  @warn "Font stacks could not be loaded.";
+
+  // Don't just sit there, do something!
+  @return monospace;
+}
+
+// A simple wrapper to output the complete font family declaration
+@mixin k-font-family($fonts...) {
+  font-family: font-stack($fonts...);
+}

bower.json

@@ -0,0 +1,26 @@
+{
+  "name": "sass-font-stacker",
+  "homepage": "https://github.com/synapticism/sass-font-stacker",
+  "authors": [
+    {
+      "name": "Alexander Synaptic",
+      "email": "alexander@synapticism.com",
+      "homepage": "http://synapticism.com"
+    }
+  ],
+  "main": "_font-stacker.scss",
+  "keywords": [
+    "sass",
+    "scss",
+    "font",
+    "fonts",
+    "typography"
+  ],
+  "license": "MIT/GPLv3",
+  "ignore": [
+    "node_modules",
+    "bower_components",
+    "test",
+    "tests"
+  ]
+}

readme.md

@@ -0,0 +1,61 @@
+# SASS FONT STACKER
+
+This Sass micro-library provides a simple way to work with a pre-defined set of font stacks, web-safe and otherwise. A single function and mixin provide a bit of syntactic sugar to make it easier to prepend any of the existing fonts stacks with an arbitrary number of fonts.
+
+What this library won't do is output an `@import` declaration for web fonts. For that you'll want to turn to something like [Sass Web Fonts](https://github.com/penman/Sass-Web-Fonts) but be warned: [imports are an anti-pattern](http://www.stevesouders.com/blog/2009/04/09/dont-use-import/), good for the developer and bad for performance.
+
+
+
+## Usage
+
+```scss
+body {
+  @include k-font-family("PT Serif", "PT Serif Pro", georgia);
+}
+```
+
+This will render:
+
+```css
+body {
+  font-family: "PT Serif", "PT Serif Pro", Georgia, "Palatino Linotype", Palatino, "URW Palladio L", "Book Antiqua", "Times New Roman", serif;
+}
+```
+
+You can also get a little closer to the base metal:
+
+```scss
+body {
+  font-family: k-font-stack(georgia);
+}
+```
+
+Which will output:
+
+```css
+body {
+  font-family: Georgia, "Palatino Linotype", Palatino, "URW Palladio L", "Book Antiqua", "Times New Roman", serif;
+}
+```
+
+Note that the only *required* argument is the *last* argument which should be one of the pre-defined font stacks.
+
+
+
+## Font stacks
+
+The font stacks themselves result from a combination of research, experience, and idle whim. I don't pretend to be an expert in these matters, nor can I cite my sources any longer (I've been working with most of these stacks long enough that the original blogs I adapted them from no longer exist). Luckily you aren't locked into what I've thrown together!
+
+Want to define your own font stacks on a per-project basis? Add to the `$k-font-stacks` global:
+
+```scss
+$k-font-stacks: map-merge($k-font-stacks, (
+  helvetica-only: (Helvetica, sans-serif)
+));
+```
+
+
+
+## License
+
+MIT/GPLv3.

sache.json

@@ -0,0 +1,7 @@
+{
+  "name": "sass-font-stacker",
+  "description": "A tiny library of font stacks, web-safe and otherwise",
+  "tags": ["font", "fonts", "type", "typography"],
+  "website": "https://www.github.com/synapticism/sass-font-stacker",
+  "docs": "https://www.github.com/synapticism/sass-font-stacker"
+}