git clone 'git://github.com/nibrahim/Hyde.git'
Hyde.el is an Emacs major mode to help create blogs with the excellent
Jekyll blogging system. It comes with a front
hyde.el), a version control backend (
hyde-git.el) and an
slightly modified version of the stock markdown editing mode that
gives you a few bells and whistles while writing posts (
Download the all the
hyde-*.el files and put them somewhere. Once
you do that, add the directory where you put it to your load path like
(add-to-list 'load-path "/path/to/hyde*.el") (require 'hyde)
There are no hyde specific things you'll have to do for your Jekyll
installation. However, there is a
.hyde.el file which you can drop
into your blog directory which contains blog specific settings. This
file is not something that jekyll is aware of so you might want
to update your
_config.yml to not process this file.
This mode is a simply a wrapper for a number of shell commands that are used to create and deploy the site. It doesn't maintain any local state (in the form of status files etc.) so if you change your repository manually outside it, just refreshing the buffer will bring it up to date.
It's tailored to the way I work. I keep my posts in a
(although I do have a crude DVCS abstraction layer if you're using
hg or any other such system). I make changes, commit them and push
the repository to
github (you can, for example, see this files
After that, I make the site using
jekyll manually and then copy it
over to my webspace using
rsync. I don't use any of the git hooks
Following are the variables affecting your blog and its management that you can customise:
jekyllwill generate the site for you to deploy
_draftsby default. You might want to _ignore_ this directory in
_draftsand a top level directory when the post is promoted.
rsyncor whatever else you might please.
"/bin/ls -1tr "by default which will produce a chronologically ordered list. You can change it if you prefer alphabetic or something else.
When you start hyde using
M-x hyde, it will prompt you for the directory where your blog resides. All the paths mentioned above (
posts-dir etc.) are all relative to this. The directory that you specify here will override
hyde-home mentioned above.
Customising any of the above will set them globally (i.e. for all blogs managed by jekyll on your system). If you have multiple blogs which you're managing using jekyll, you can drop a
.hyde.el file into the blog directory where you can manually set any of these variables. In this file, you can manually change any of these variables using
setq. There is a
sample-dot-hyde.el file which shows you how. These settings override the global ones mentioned above and you can have different such settings for different blogs on your system.
The following are commands and predicates used to handle the version control backend. You can change them if you want to add support for a version control system other than
git. If it works for you, please send me a pull request and I'll integrate it.
The main interface looks like the following screenshot
The list of posts are presented on top along with a key of what the letters before the post names mean. The post names are also colourised accordingly
The keys you can use at this time are
The markdown mode in which the buffers open up for editing is slightly modified. It has a few extra covenience bindings
liquidtags will not work).
Hyde supports Octopress by default. The only thing you have to do is to create a directory under
source for draft posts and
.hyde.el file with the right commands. To see an example, check out the emacsmovies.org source repository.
This program is licensed under the GNU General Public License Version 3. Please check the LICENSE file for the full text of the license.
comintinstead of shell commands to do all the work.