desirae.js/TODO.md

format should change permalink
date
show file path
show prod url
show dev url


POST tests
create a title and delete it (no error)
change the format. does the permalink change? (yes)
change the permalink. change the title. does the permalink stay? (yes)

change the format. does the permalink change? (yes)
change the format in the frontmatter permalink. does the format change? (yes)

create a description and delete it (no error)
create a description. does the frontmatter change? (yes)


protection
Don't allow changing the uuid, original_url, or original_date

TODO
---

check that no other post uses the same permalink



default data-model 'ruhoh@2.2'
other data-model 'desirae@1.0'

Widgets
=======

All widgets should export an object with a `create(widgetConf, desiState)` function that returns a promise.

```yaml
widgets:
  foogizmo:
    # only stuff that is intensely specific to foogizmo goes here
    # stuff like google ad and disqus ids should go in config.yml or data.yml
    config:
      foobeep: boop
      
    handle:
      - html
      - markdown
    handlers:
      post: fooposter
      page: foopager
```

```javascript
'use strict';

module.exports.Foogizmo.create = function (foogizmoConf, desiState) {
  return new Promise(function (resolve) {

    function pager(desiPageState) {
      // Do processing

      return Promise.resolve();
    }

    function poster(desiPostState) {
      // Do processing

      desiPostState.fooembedinator = function (fooval) {
        // figure out what type of link fooval is and return iframe html
        return '<iframe src="http://embedinator.com/"' + foovalProcessed + '></iframe>'
      }
    }

    resolve({ foopager: pager, fooposter: poster });
  });
}
```

Overlays
--------

For any config a widget uses, it should also check on post.fooconfig and theme.fooconfig to make sure that they don't override the foogizmo.config.fooconfig



Migrating from Ruhoh
====================

There are only a few things in Ruhoh that could only be done in ruby or were otherwise difficult to work around.

config.yml
----------

Instead of having special names for some properties (`_root`)
and `use` sub attributes for others (`twitter` theme, posts directory),
I opted to move related stuff together.

```
RuhohSpec 2.6 -> NuhohSpec 3.0

production_url -> production.canonical_url, development.canonical_url
base_path -> production.base_path, development.base_path
compiled_path -> development.compiled_path

twitter -> themes.twitter
twitter.use = theme -> themes.default = twitter

_root -> root

posts -> collections.posts

asset_pipeline [REMOVED (ruby only)]

widgets [NO CHANGE]
```

All directories are ignored by default. If you want a directory to be interpreted as a collection of pages you need to specify it in the `collections` hash.

data.yml
--------

No changes


config.ru
---------

REMOVED (ruby only)

themes layout
-------------

TODO

`twitter/default.html` has stuff like `{{# data.navigation?to__root }}{{> page_list }}{{/ data.navigation?to__root }}`
that appears to be ruby-only syntax that will need to be changed.