https://github.com/whitead/sm-blog

Science and math blog framework
https://github.com/whitead/sm-blog

Last synced: about 1 month ago
JSON representation

Science and math blog framework

• Host: GitHub
• URL: https://github.com/whitead/sm-blog
• Owner: whitead
• Created: 2014-06-10T23:43:28.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2015-03-05T14:06:52.000Z (almost 10 years ago)
• Last Synced: 2024-10-16T02:59:08.455Z (3 months ago)
• Language: CSS
• Size: 1.19 MB
• Stars: 0
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Science & Math Blogging Framework

=========================

A Jekyll blog optimized for equations, graphs, and academic writing.

[See example](http://andrew-white.com/blog)

Dependencies

=========================

Requires `ruby`, `jekyll`, `jekyll-scholar`, `rake` and `uglifier`

    [sudo] gem install jekyll jekyll-scholar rake uglifier

Also requires you to have a local clean version of `bootstrap`, which

you can get by running

    git clone https://github.com/twitter/bootstrap.git bootstrap

I've written this with version 3.3.1, which you can make sure you have by running

 

    cd bootstrap && git checkout tags/v3.3.1

Also requires `node-js` for the package less, which you can get by installing `npm`, the node-js package manager and running

    npm install less

Installation

=========================

After installing dependencies, run:

    git clone https://github.com/whitead/SM-Blog SM-Blog

Then edit the `Rakefile` to point to your bootstrap version in the top

line. Follow instructions from the [jekyll docs](http://jekyllrb.com)

for configuring the website and adding posts.

Building

=========================

To generate and view the website, run the following from the git root directory

    rake

    jekyll serve

Editing CSS

=========================

Edit the CSS in `bootstrap/less/custom.less` to modify the style of

the website. Re-run rake eachtime you modify this file.

Custom Site-URL

=========================

Custom baseurls can be added only to `_config.yml` and the Rakefile

will read and process it as needed.