Now at https://git.coolaj86.com/coolaj86/deardesi.js
If you're a normal person interested in Desi, the DIY blog platform for normal people, you might have meant to go to DearDesi instead.
Otherwise, if you're a cyborg, wizzard, or web developer: carry on.
These instructions cover the command line only.
If you want instructions for the web interface, head over to DearDesi.
This assumes that you already have git
and iojs
(or node
) installed,
otherwise see iojs-install-script
npm install -g desi
That was easy
Note: both through command line and web you need site.yml
and authors/xyz.yml
configured in order to create a post (as well as build).
The post commands output the location of post in various formats.
You can do this 3 ways:
desi init -d ~/Desktop/blog
# initialize (and or create) a blog directory
desi init -d ~/Desktop/blog
# initialize the current directory
pushd ~/Desktop/blog
desi init
Note that you cannot initialize a directory that is already in use (where 'in use' means has at least one non-dotfile).
There are a number of themes available at https://github.com/DearDesi, just look for ones with 'theme' in the description.
git clone git@github.com:DearDesi/desirae-blog-template.git ~/my-desirae-blog
pushd ~/my-desirae-blog
git submodule add git@github.com:DearDesi/ruhoh-bootstrap-2.git themes/ruhoh-bootstrap-2
You will need to make sure that you have some details about your theme in config.yml
.
Basically that means that you specify a datamap
and which defaults for a page
and post
in the layouts
folder.
Just open it up, it'll make sense.
Obviously this is a little different for everyone, so here's what I'd recommend:
config.yml
to add a config with a permalink with your collections (posts, articles, essays, whatever you call them)site.yml
and authors/xxx.yml
are correct.desi build -d /path/to/blog
to test if there are any issues with your existing yaml
site.yml
urls.base_url
, host
, page.url
that might have an extra /
at the beginning or end or be named slightly differently.See https://github.com/DearDesi/desirae/blob/master/GLOSSARY.md for disambiguation about the meaning of terms in Desi.
authors/YOUR_NAME.yml
and model it after this example
site.yml
, similar to this exampleImportant Things
site.yml.base_url
- the point of ownership (usually blog.example.com or example.com)site.yml.base_path
- where the blog is "mounted", relative to the base_url
(usually /
or /blog
)authors/me.yml.name
- most templates use thisauthors/me.yml.email
- and thisauthors/me.yml.twitter
- and thisThe build will fail if you don't have site.yml
and authors/johndoe.yml
configured.
desi build -d /path/to/blog
desi serve -d /path/to/blog
Now open up your evergreen browser to http://local.dear.desi:65080