You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by ga...@apache.org on 2014/06/11 14:56:48 UTC
[32/39] couchdb commit: updated refs/heads/Update-Sidebar-Ui to
2cf2eab
Updated readme.md with instructions on how to get setup with this custom Fontcustom branch.
Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/c2371f64
Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/c2371f64
Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/c2371f64
Branch: refs/heads/Update-Sidebar-Ui
Commit: c2371f646e91fd85274833103ce3858ad9facbeb
Parents: fa94593
Author: sean barclay <fu...@hotmail.com>
Authored: Tue Jun 10 14:08:50 2014 -0700
Committer: sean barclay <fu...@hotmail.com>
Committed: Tue Jun 10 14:08:50 2014 -0700
----------------------------------------------------------------------
src/fauxton/assets/fonts/README.md | 112 +++-----------------------------
1 file changed, 9 insertions(+), 103 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/couchdb/blob/c2371f64/src/fauxton/assets/fonts/README.md
----------------------------------------------------------------------
diff --git a/src/fauxton/assets/fonts/README.md b/src/fauxton/assets/fonts/README.md
index 75f1acc..ebca9e1 100644
--- a/src/fauxton/assets/fonts/README.md
+++ b/src/fauxton/assets/fonts/README.md
@@ -1,19 +1,6 @@
*WARNING: this is a temporary solution for adding icons to the Icon Font. This will become a grunt task eventually.*
-
-[](http://badge.fury.io/rb/fontcustom)
-[](https://travis-ci.org/FontCustom/fontcustom)
-[](https://codeclimate.com/github/FontCustom/fontcustom)
-
-## Font Custom
-
-**Icon fonts from the command line.**
-
-Generate cross-browser icon fonts and supporting files (@font-face CSS, etc.) from a collection of SVGs.
-
-[Changelog](https://github.com/FontCustom/fontcustom/blob/master/CHANGELOG.md)<br>
-[Bugs/Support](https://github.com/FontCustom/fontcustom/issues)<br>
-[Contribute!](https://github.com/FontCustom/fontcustom/blob/master/CONTRIBUTING.md)
+This is a temp solution till Fontcustom fixes this [BUG](https://github.com/FontCustom/fontcustom/issues/172)<br>
### Installation
@@ -22,99 +9,18 @@ Requires **Ruby 1.9.2+**, **FontForge** with Python scripting.
```sh
# On Mac
brew install fontforge eot-utils
-gem install fontcustom
-
-# On Linux
-sudo apt-get install fontforge
-wget http://people.mozilla.com/~jkew/woff/woff-code-latest.zip
-unzip woff-code-latest.zip -d sfnt2woff && cd sfnt2woff && make && sudo mv sfnt2woff /usr/local/bin/
-gem install fontcustom
+cd [LOCAL_COUCHDB_REPO]/src/fauxton/assets/fonts
+bundle
```
-### Quick Start
-
-```sh
-fontcustom compile path/to/vectors # Compiles icons into `fontcustom/`
-fontcustom watch path/to/vectors # Compiles when vectors are changed/added/removed
-fontcustom compile # Uses configuration file at `fontcustom.yml`
- # or `config/fontcustom.yml`
-fontcustom config # Generate a blank a configuration file
-fontcustom help # See all options
-```
-
-### Configuration
-
-To preserve options between compiles, create a configuration file with
-`fontcustom config`. This should live in the directory where you run
-all `fontcustom` commands. Each of the following has its own command
-line flag (`--css-selector`, etc.). Defaults values are shown.
-
-**Basics**
-
-```yml
-project_root: (pwd) # Context for all relative paths
-input: (project_root) # Where vectors and templates are located
-output: (project_root)/(font name) # Where generated files will be saved
-config: (pwd)/fontcustom.yml # Optional path to a configuration file
-debug: false # Output raw messages from fontforge
-quiet: false # Silence all messages except errors
-
-# For more control over file locations, set
-# input and output as hashes instead of strings
-input:
- vectors: path/to/vectors # required
- templates: path/to/templates
-
-output:
- fonts: app/assets/fonts # required
- css: app/assets/stylesheets
- preview: app/views/styleguide
-```
-
-**Fonts**
-
-```yml
-font_name: fontcustom # Also sets the default output directory and
- # the name of generated stock templates
-no_hash: false # Don't add asset-busting hashes to font files
-autowidth: false # Automatically size glyphs based on the width of
- # their individual vectors
-```
-
-**Templates**
-
-```yml
-templates: [ css, preview ] # List of templates to generate alongside fonts
- # Possible values: preview, css, scss, scss-rails
-css_selector: .icon-{{glyph}} # CSS selector format (`{{glyph}}` is replaced)
-preprocessor_path: "" # Font path used in CSS proprocessor templates
- # Set to "" or false to use the bare font name
-
-# Custom templates should live in the `input`
-# or `input[:templates]` directory and be added
-# to `templates` as their basename:
-templates: [ preview, VectorIcons.less ]
-```
-
-Custom templates have access to `@options`, `@manifest`, and the following ERB helpers:
-
-* `font_name`
-* `font_face`: FontSpring's [Bulletproof @font-face syntax](http://www.fontspring.com/blog/further-hardening-of-the-bulletproof-syntax)
-* `glyph_selectors`: comma-separated list of all selectors
-* `glyphs`: all selectors and their codepoint assignments (`.icon-example:before { content: "\f103"; }`)
+That should install the gem in a path like below:
+/Users/[USERNAME]/.rvm/gems/[RUBYVERSION]/bundler/gems/fontcustom
-### SVG Guidelines
+Don't forget to update `fontcustom.yml` with the correct paths where it says `PUT_YOUR_PATH_HERE`.
-* All colors will be rendered identically — including white fills.
-* Make transparent colors solid. SVGs with transparency will be skipped.
-* For greater precision, prefer fills to strokes (especially if your icon includes curves).
-* Keep your icon within a square `viewBox`. Font Custom scales each SVG to fit
- a 512x512 canvas with a baseline at 448.
-* Setting `autowidth` to true trims horizontal white space from each glyph. This can be much easier
- than centering dozens of SVGs by hand.
+From there, you can run the command `fontcustom compile` to compile the svgs located in the ./icons directory into updated fauxtonicon font files.
----
-[Licenses](https://github.com/FontCustom/fontcustom/blob/master/LICENSES.txt)
+For more info on Fontcustom, check out their documenation: [Fontcustom documentation](https://github.com/FontCustom/fontcustom)
-Brought to you by [@endtwist](https://github.com/endtwist) and [@ezYZ](https://github.com/ezYZ)
+[Licenses](https://github.com/FontCustom/fontcustom/blob/master/LICENSES.txt)
\ No newline at end of file