prose.yml file for project configuration #296

tristen opened this Issue Mar 25, 2013 · 4 comments


None yet

2 participants

tristen commented Mar 25, 2013

In an effort to keep prose more agnostic, for project settings I wonder if we should remove project configuration rules out of _config.yml and into a separate prose.yml file. .toml could be another candidate too.

Limiting a project to a site-posts like directory would be useful to a wider range of projects.


@tristen I think that is a fantastic idea!

I would also suggest to use the _underscore standard for "partial" files not to be processed by things like Jekyll and DocPad - I'm sure you would have done that anyways... so you could have a project configuration file such as or _prose.yml (obviously) you could do this also for your or _prose.toml.


However I don't think you should limit to just the site-posts directory. Not all projects have just one directory for posts.

Perhaps you could have a site-wide which would configure prose for the entire site. And for all of your new Jekyll-based enhancements you could have a configuration in that file that tells Prose to treat certain paths special e.g. _posts.

Alternatively we could also put individual files in different directories which would allow prose to spin out different "Personalities" based on what we wanted to do with that folder.

So, we could have something like this:

          / -> this has configurations that tells to use the Jekyll flavored interface for posts -> this has all of your normal prose config stuff in it.

This way I could use as a developer to access any text-based files in my project or blog and work on those. Maybe in the future we will have some more features which are flavored differently for HTML editing or CSS or JS editing. Perhaps a special flavor for yml config files.

Each area of my directory could have specific flavors of tools which are specific to it, but with one interface which all works together.

Just an idea :)

tristen commented Apr 11, 2013

So if we want to support backwards compatibility for existing _config.yml I'm not seeing a clean solution. We would need to request the contents of config.yml, evaluate it into an object, check if prose exists and if it doesn't request a _prose.yml file.

The other thing to consider is to punt on this. It's not as if other repo's couldn't indeed have a _config.yml file. This should work just fine.

cc/ @mikemorris @dhcole

tristen commented Apr 15, 2013

Implemented. Closing.

@tristen tristen closed this Apr 15, 2013
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment