Reorganize site.features
(and maybe other) config objects
#41
Labels
Milestone
site.features
(and maybe other) config objects
#41
I initially thought the idea of putting most theme-defining data objects in the
site
scope -- meaning defined in one or more config files -- made a lot of sense, just to have an elegant structure and not use the_data/
dir for theme-defining stuff.Now I think it's just annoying and too restrictive. Since there is no way to declare multiple config files from within a config file (you have to use the CLI's
--config folder/file-one.yml,folder/file-two.yml,etc
argument), it's not easy to break up the config file without adding lots of noise to the commandline. This can easily be remedied by the techniques most shops employ in their build routines, where long CLI commands don't matter, but I want AsciiDocsy to be a good authoring experience right out of the box, which means keeping CLI commands as simple as possible.This leaves us with the option of moving some or all of these to the
_data/config/
path, which for the AsciiDocsy site itself is_docs/_data/theme/
-- another part of the reason I like keeping this out of the data path. But I do think this is the best move. This gives the user complete control over which objects to store together. Even though you have to maintain the hierarchy/tree, with Jekyll'sdata
scope, we have the option to store EVERYTHING in a_data/theme.yml
file or split things up into_data/config/navigation.yml
or even_data/config/navigation/breadcrumbs.yml
and so forth.So now
site.features
will besite.data.theme.features
.Except I think I also want to get rid of the extra tiers in the
features
object, starting with eliminating the category features itself. Theactions
block is probably also superfluous. If we flatten the objects down, we need no_data/config/features/
path, let alone_data/config/features/actions/
.The text was updated successfully, but these errors were encountered: