deardesi.js/README.md

77 lines
1.4 KiB
Markdown

Dear Desi
=========
A nice, friendly tool to help you get set up and start blogging with Desirae
Front-end written in AngularJS, back-end in Node.js
Install and Usage
=================
If you're on OS X or Linux, it's as easy as pie to install and use Desirae.
First install io.js (or node.js), if you haven't already.
```bash
# io.js
echo "v1.0.1" > /tmp/IOJS_VER
curl -fsSL bit.ly/easy-install-iojs | bash
# node.js
echo "v0.11.14" > /tmp/NODE_VER
curl -fsSL bit.ly/easy-install-node | bash
```
Then install desi
```bash
npm install -g desi
```
And create a copy of the desirae-seed
```
git clone git@github.com:DearDesi/desirae-blog-template.git ~/my-desirae-blog
pushd ~/my-desirae-blog
git submodule init
git submodule update
```
And now fire up Dear Desi to get started
```
desi serve -d ~/my-desirae-blog
```
Now open up your evergreen browser to <http://local.dear.desi:65080>
Commandline
===========
Once you've done the initial setup in the browser, you can run `desi` from the commandline
**NOTE:** You can omit the `-d` if you are already in your blog directory.
Build Production Site
---------------------
You must set `base_path` and `base_url` in `site.yml` before attempting to build.
```
desi build -d ~/my-desirae-blog
```
Outputs to `~/my-desirae-blog/compiled`
Create a new Post
-----------------
```
desi post "My First Post" -d ~/my-desirae-blog
```
Outputs to `~/my-desirae-blog/posts/my-first-post.md`