desirae.js/DATA.md

74 lines
2.5 KiB
Markdown
Raw Normal View History

2020-11-09 03:01:26 +00:00
# Data
2015-01-13 10:41:14 +00:00
Every template gets an object with the exact same structure - whether it's a template or a widget or a page or a post.
Here we only document Desirae's default behavior, but there are many objects added for compatibility with Ruhoh that are not documented.
2020-11-09 03:01:26 +00:00
## config.yml vs site.yml
site.yml is for anything that changes the content of the site (navigation, title, analytic and ad ids, default author, etc)
config.yml is for anything that doesn't change the site (from where to read directories, which order to load plugins)
2015-01-13 10:41:14 +00:00
```
desi = {}
```
2020-11-09 03:01:26 +00:00
# desi
- `config` - literally `config.yml`, parsed
- `site` - literally `site.yml`, parsed
- `authors` - literally the authors from `authors/*.yml`, parsed
- `author` - the primary author of the site
- `env` - urls and paths for this build (be it production, development, staging, etc)
- `content` - pre-rendered content (i.e. content rendered into the post layout rendered into the default layout)
- `collection` - config related to this collection
- `entity` - the page, post, article, etc that is the focus of the present template process
- `themes` - all themes
- `theme` - the default theme
- `layout` - the selected layout for this theme
- `satch` - the selected swatch for this theme
- `categories` - all categories
- `tags` - all tags
- `styles` - ??? goes into the final template in the head
- `scripts` - ?? that goes into the final template just before the body close
# desi.entity
2015-01-13 10:41:14 +00:00
stuff
2020-11-09 03:01:26 +00:00
- `uuid`
- `title`
- `disqus_url`
- `disqus_identifier`
2015-01-13 10:41:14 +00:00
more stuff
2020-11-09 03:01:26 +00:00
- `type` - `post`, `page`, etc
- `authors` - literally the relevant authors from `authors/*.yml`, parsed
- `author` - the primary author of this entity
- `theme` - null or a non-default theme
- `layout` - null or a non-default layout for this theme
- `swatch` - null or a non-default swatch for this theme
- `categories`: [] // _all_ categories in all collections
- `tags`: [] // _all_ categories in all collections
- `production_canonical_url` the PRODUCTION canonical_url for this entity
- `production_url` the PRODUCTION url for this entity
- `production_path` the PRODUCTION path for this entity
- `url` the full url in the current environment (might be production, development, etc)
- `path` the non-host part (i.e. `/compiled_dev/articles/my-first-post.html`)
- `previous` the previous entity in this collection
- `next` the next entitiy in this collection
2015-01-13 10:41:14 +00:00
NOTE: Plugins, widgets, etc SHOULD NOT modify config, site, authors, author, or env.
2020-11-09 03:01:26 +00:00
# desi.posts
2015-01-13 10:41:14 +00:00
, posts: { collated: desi.collated }
2020-11-09 03:01:26 +00:00
# desi.config
2015-01-13 10:41:14 +00:00
2020-11-09 03:01:26 +00:00
# desi.site
2015-01-13 10:41:14 +00:00
2020-11-09 03:01:26 +00:00
# desi.env