Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Simple project starter for Emacs

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 README.md
Octocat-spinner-32 startproject.el
README.md

startproject

Simplest Emacs project starter for all you framework people — Django, Sproutcore, whatever — they have start commands. Really, the name „startproject“ is from Django‘s script :-)

It just runs framework‘s start command (or just a simple tar command extracting your project skeleton... or a mkdir if you‘re not a framework person) and opens the newly created project with dired. Also it can initialize version control (bzr/hg/git) and open vc-dir.

Requires a modern Emacs and ido. ido usually works out of the box, at least with GNU Emacs from Ubuntu repos and Aquamacs for Mac.

How to use it

  • require it in your init file (.emacs, config.el, or something else if you‘re very creative)

    (add-to-list 'load-path "~/Dropbox/emacs/startproject") (require 'startproject)

  • bind „start-project“ to some key (I don‘t think you want to M-x all the time), like this:

    (global-set-key (kbd "C-x p") 'start-project)

  • add your own starters if you need them, for example, HTML5 Boilerplate:

    (puthash "html5" "tar -xvf ~/Dropbox/webdev/html5-boilerplate-0.9.x.tar.gz" project-starters)

  • change the work directory — I‘m not sure if you want your projects in ~/. Don‘t forget the slashes!:

    (setq projects-dir "~/Dropbox/work/")

  • enjoy it!

FAQ

  • Q: It says something about wrong paths... What the?

    A: You forgot slashes in the projects-dir.

  • Q: Why I have to add a command for my favorite framework by hand? It‘s popular.

    A: Because I‘m too lazy to google these commands for all the mainstream frameworks. Feel free to open a pull request.

  • Q: I don‘t need to open vc-dir! Can I turn it off?

    A: Of course! Just put it in your init file: (setq sp-open-vc-dir nil)

Something went wrong with that request. Please try again.