Seaside-FontAwesome

A small Seaside wrapper for the FontAwesome project

Quick Start

Installation

First you need to load Seaside, here we load the development version:

Metacello new
  baseline:'Seaside3';
  repository: 'github://SeasideSt/Seaside:develop/repository';
  load.

for any other have a look at https://github.com/SeasideSt/Seaside.

Then load FontAwesome

Metacello new
  baseline:'FontAwesome';
  repository: 'github://astares/Seaside-FontAwesome:master/src';
  load.

Run the Demo locally

Start the web server for Seaside - for instance with Zinc evaluate:

ZnZincServerAdaptor startOn: 8080

Now point your browser to http://localhost:8080/fontawesome

Use in your own application

Necessary Seaside libraries

To add FontAwesome to your Seaside application you just have to add the appropriate seaside file libraries containing the CSS and fonts to your Seaside application.

Depending on the scenario there is a FAWDeploymentLibrary and a FAWDevelopmentLibrary that you will find in the package FontAwesome-Core in the category 'FontAwesome-Core-Libraries'

Have a look at the #register method in the FAWExamplesHome class for an example.

Use in your code

If the FontAwesome library is registered with your Seaside application you can use the fontAwesome selectors in your usual rendering methods (like #renderContentOn:).

At a minimum you need to FontAwesome style to a surrounding div tag/bootstrap container by calling #fontAwesome:

renderContentOn: html
    html div 
            fontAwesome;
            with: [ html span fontAwesomeFacebookIcon ]

Internals

Packages

• FontAwesome-Core - package with the core, contains anything you need in an own app
• FontAwesome-Core-Tests - package with the SUnit tests
• FontAwesome-Examples - example package for the demo

Testing

The package comes with many tests in the package FontAwesome-Core-Tests. Just use the SUnit TestRunner to run them.