mana/README.md

66 lines
3.5 KiB
Markdown
Raw Normal View History

# Mana v1.3.0
2015-03-23 14:16:34 +00:00
## The Magic: the Gathering mana symbol font!
Mana is a complete set of Magic: the Gathering mana, tap, and card type symbols as a pictographic font. You can use this font anywhere you want to display mana and tap symbols—in your MtG app or website, documents, card images, anything!
## Installing
The easiest way to get Mana into your project is to use either the Bower or NPM packages, depending on your package manager:
```shell
$> bower install mana
```
```shell
$> npm install mana-font
```
We've registered `mana` with [Bower](https://bower.io/#getting-started) and 'mana-font' with [NPM](https://docs.npmjs.com/getting-started/what-is-npm). Just install using the above commands in your project and you can edit anything as needed.
You can also download the [zip file](https://github.com/andrewgioia/Mana/archive/master.zip) here at Github and use the font files and CSS files in your project as needed.
2015-03-23 14:16:34 +00:00
## Usage
Each mana symbol has its own font character. Display them in a manner similar to [Keyrune](http://andrewgioia.github.io/Keyrune) using the `<i class="ms ms-g"></i>` element and class syntax. Class name codes are based on textual mana symbol codes (like g for Green or 3 for, well, {3}).
To use Mana, move the web font files to your `/fonts` directory and include the mana.css stylesheet in your `<head>`:
```html
<link href="css/mana.css" rel="stylesheet" type="text/css" />
```
## Editing the Source
Feel free to edit the source files and compile Mana to fit your needs. Currently LESS is supported, with Sass coming soon.
## Using Mana on the Desktop
If you'd like to use Mana as a desktop font (e.g., in a Word document) there are a few steps and things to know. First, to get it loaded on your system just download the [latest zip file](https://github.com/andrewgioia/Mana/archive/master.zip), extract it, and navigate to `Mana-master\fonts`. In there, install the `mana.ttf` font (typically by double clicking it).
Mana uses [private use characters](https://en.wikipedia.org/wiki/Private_Use_Areas) for the font glyphs so you unfortunately can't normally "type" anything in Word to see the symbols. To do so, open up the [Mana Cheatsheet](http://andrewgioia.github.io/Mana/cheatsheet.html) and copy the symbol you want, then paste it into Word (or whatever software you're using).
2015-03-23 14:16:34 +00:00
## License
All mana, tap, and card type symbol images are copyright Wizards of the Coast ([http://magicthegathering.com](http://magicthegathering.com))
The Mana font is licensed under the the SIL OFL 1.1 ([http://scripts.sil.org/OFL](http://scripts.sil.org/OFL))
Mana CSS, LESS, and Sass files are licensed under the MIT License ([http://opensource.org/licenses/mit-license.html](http://opensource.org/licenses/mit-license.html))
Attribution is **greatly appreciated** but not required!
## Changelog
* v0.1 - initial font creation and CSS/LESS files added
2015-04-13 16:20:06 +00:00
* v0.2 - Flashback symbol added
* v0.3 - phyrexian mana classes use MTGJson standard; project-specific LESS prefix added (@JayGray)
2015-09-03 17:31:34 +00:00
* v0.4 - adding classes for 16, 17, 18, 19, and 20 symbols
2015-12-14 14:49:43 +00:00
* v0.5 - adding the new colorless wastes symbol
2016-05-31 14:53:22 +00:00
* v0.6 - adding double-faced card symbols (day, night)
2016-09-01 13:42:51 +00:00
* v1.0 - new documentation page at http://andrewgioia.github.io/Mana/
* v1.0.1 - added classes for -12 and -14 loyalty (sorry Jace and Karn!)
2016-09-23 18:22:13 +00:00
* v1.1.0 - added the new Energy symbol
* v1.2.0 - added DFC symbols for the Origins planeswalkers (ignite and spark) and the Eldritch Moon meld cards (emrakul and moon)
* v1.3.0 - added Guild and Clan symbols