Code Monkey home page Code Monkey logo

sinatra.github.com's Introduction

Sinatra Website / Documentation

This repo contains the Sinatra website and documentation sources published at http://sinatra.github.com/.

Working Locally

Grab the sources from GitHub:

$ git clone git://github.com/sinatra/sinatra.github.com.git
$ cd sinatra.github.com

Make sure you have the bundler gem installed on your machine:

$ gem install bundler

Install dependencies:

$ bundle install

Run the test server:

$ rake server

Changes are immediately available at:

http://localhost:4000/sinatra.github.com/

Sass / CSS / Gulp

It would be appreciated if you could introduce your changes using the indented Sass syntax (.sass) in one of the existing Sass partials or if needed via new ones of your own. Not a friend of curlies and stuff.

Gulp was set up to streamline your build process. Simply run:

$ gulp watch

gulp watch triggers a couple of processes:

  • After changes have been introduced in the _sass directory, it first builds uncompressed .css files from the corresponding .sass files and puts them into /css/development.
  • Gulp also watches any changes made in the /css/development directory.
  • In turn, any changes in /css/development will get compressed, prefixed and purified of any obsolete style declarations before being placed in their final destination at /css.
  • Your site is reloaded automatically using Browsersync which watches any changes to .css files in /css. No need to install any additional gimmicks.

That means Gulp is configured so that you can either work on .sass files in the /_sass directory or on .css files directly in the /css/development directory. If you want to introduce changes in /css/development, you need to create new filenames to avoid being overwritten when new versions of Sass files get built.

Contributing

See GitHub's "Fork A Repo" for more information.

Creating Blog Posts

Blog posts are stored under the _posts directory. To create a new blog post and open your $EDITOR, use:

thor blog:new 'Blog Post Title'

This requires Thor:

$ gem install thor

Prebuilt Files

You will need thor, rdoc, haml and mislav's hanna gem to rebuild static files and the API docs:

$ gem install thor
$ gem install rdoc -v 2.3.0
$ gem install haml -v 2.0.4
$ gem install mislav-hanna --source=http://gems.github.com/

The prebuilt file sources are maintained under the sinatra and sinatra-book projects. To pull in the latest versions and build them:

rake pull build

The generated files under the "_includes" and "api" directories need to be committed after building. To regenerate and add those files to your index for the next commit:

rake regen

sinatra.github.com's People

Contributors

rkh avatar vis-kid avatar rtomayko avatar cypher avatar sr avatar kgrz avatar namusyaka avatar bmizerany avatar cschneid avatar randomecho avatar syd avatar karmi avatar gnandretta avatar nesquena avatar jkowens avatar tannerburson avatar foca avatar zapnap avatar dependabot[bot] avatar iffyuva avatar victori avatar olleolleolle avatar mattwildig avatar akahn avatar scudelletti avatar koffeinfrei avatar icco avatar prefork avatar neall avatar funkaoshi avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.