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.

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

"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.