Bjørn Erik Pedersen 80230f26a3 Add support for theme composition and inheritance ... This commit adds support for theme composition and inheritance in Hugo. With this, it helps thinking about a theme as a set of ordered components: ```toml theme = ["my-shortcodes", "base-theme", "hyde"] ``` The theme definition example above in `config.toml` creates a theme with the 3 components with presedence from left to right. So, Hugo will, for any given file, data entry etc., look first in the project, and then in `my-shortcode`, `base-theme` and lastly `hyde`. Hugo uses two different algorithms to merge the filesystems, depending on the file type: * For `i18n` and `data` files, Hugo merges deeply using the translation id and data key inside the files. * For `static`, `layouts` (templates) and `archetypes` files, these are merged on file level. So the left-most file will be chosen. The name used in the `theme` definition above must match a folder in `/your-site/themes`, e.g. `/your-site/themes/my-shortcodes`. There are plans to improve on this and get a URL scheme so this can be resolved automatically. Also note that a component that is part of a theme can have its own configuration file, e.g. `config.toml`. There are currently some restrictions to what a theme component can configure: * `params` (global and per language) * `menu` (global and per language) * `outputformats` and `mediatypes` The same rules apply here: The left-most param/menu etc. with the same ID will win. There are some hidden and experimental namespace support in the above, which we will work to improve in the future, but theme authors are encouraged to create their own namespaces to avoid naming conflicts. A final note: Themes/components can also have a `theme` definition in their `config.toml` and similar, which is the "inheritance" part of this commit's title. This is currently not supported by the Hugo theme site. We will have to wait for some "auto dependency" feature to be implemented for that to happen, but this can be a powerful feature if you want to create your own theme-variant based on others. Fixes #4460 Fixes #4450		2018-06-10 23:55:20 +02:00
..
filesystems	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
pagemeta	Refactor the GitInfo into the date handlers	2018-03-11 21:32:05 +01:00
paths	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
testdata	hugolib: Add test for image processing from shortcodes	2018-01-01 12:11:36 +01:00
testsite/content	Refactor the GitInfo into the date handlers	2018-03-11 21:32:05 +01:00
404_test.go	Spring test cleaning, take 2	2018-03-18 09:54:32 +01:00
alias.go	✨ Implement Page bundling and image handling	2017-12-27 18:44:47 +01:00
alias_test.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
author.go	Revert the "standardize author data"	2016-09-18 19:16:39 +02:00
case_insensitive_test.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
config.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
config_test.go	Move the privacy config into a parent	2018-05-22 18:11:03 +02:00
datafiles_test.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
disableKinds_test.go	Add support for a content dir set per language	2018-04-02 08:06:21 +02:00
embedded_shortcodes_test.go	tplimpl: Remove speakerdeck shortcode	2018-06-09 11:13:36 +02:00
embedded_templates_test.go	tpl: Always load GA script over HTTPS	2018-06-09 23:47:44 +02:00
fileInfo.go	Add support for a content dir set per language	2018-04-02 08:06:21 +02:00
gitinfo.go	Refactor the GitInfo into the date handlers	2018-03-11 21:32:05 +01:00
hugo_info.go	Make ge, le etc. work with the Hugo Version number	2018-02-22 09:15:12 +01:00
hugo_info_test.go	Make ge, le etc. work with the Hugo Version number	2018-02-22 09:15:12 +01:00
hugo_sites.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
hugo_sites_build.go	Reset the "distinct error logger" on rebuilds	2018-06-05 10:45:24 +03:00
hugo_sites_build_failures_test.go	hugolib: Fix freeze in invalid front matter error case	2018-03-24 10:06:58 +01:00
hugo_sites_build_test.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
hugo_sites_multihost_test.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
hugo_themes_test.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
language_content_dir_test.go	Add support for a content dir set per language	2018-04-02 08:06:21 +02:00
media.go	Fix copyright headers in source files	2015-12-07 19:57:01 +01:00
menu.go	hugolib: Remove unused code	2018-01-25 17:14:03 +01:00
menu_test.go	Add support for a content dir set per language	2018-04-02 08:06:21 +02:00
multilingual.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
orderedMap.go	hugolib: Defer the unlock in orderedMap.Add	2018-04-22 21:32:05 +02:00
orderedMap_test.go	hugolib: Process and render shortcodes in their order of appearance	2018-04-22 17:40:51 +02:00
page.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
page_bundler.go	Add support for a content dir set per language	2018-04-02 08:06:21 +02:00
page_bundler_capture.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
page_bundler_capture_test.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
page_bundler_handlers.go	Make .Content (almost) always available in shortcodes	2018-04-21 22:02:56 +02:00
page_bundler_test.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
page_collections.go	Add support for a content dir set per language	2018-04-02 08:06:21 +02:00
page_collections_test.go	resource: Add front matter metadata to Resource	2018-01-17 16:22:33 +01:00
page_output.go	Fix some recently broken embedded templates	2018-05-23 10:03:11 +02:00
page_paths.go	hugolib: Extract date and slug from filename	2018-03-11 18:26:18 +01:00
page_paths_test.go	✨ Implement Page bundling and image handling	2017-12-27 18:44:47 +01:00
page_permalink_test.go	all: Update import paths to gohugoio/hugo	2017-06-13 18:42:45 +02:00
page_resource.go	✨ Implement Page bundling and image handling	2017-12-27 18:44:47 +01:00
page_taxonomy_test.go	hugolib: Do not tolower result from Page.GetParam	2017-12-29 08:58:38 +01:00
page_test.go	Fix .WordCount, .FuzzyWordCount, .ReadingTime when summary marker is set	2018-04-29 10:58:58 +02:00
page_time_integration_test.go	all: Update textual references in Go source to point to gohugoio/hugo	2017-06-13 18:47:17 +02:00
page_without_content.go	Make .Content (almost) always available in shortcodes	2018-04-21 22:02:56 +02:00
pageCache.go	Add a way to merge pages by language	2018-03-16 10:10:01 +01:00
pageCache_test.go	Add a way to merge pages by language	2018-03-16 10:10:01 +01:00
pageGroup.go	hugolib: Do not tolower result from Page.GetParam	2017-12-29 08:58:38 +01:00
pageGroup_test.go	resource: Add front matter metadata to Resource	2018-01-17 16:22:33 +01:00
pages_language_merge.go	Add a way to merge pages by language	2018-03-16 10:10:01 +01:00
pages_language_merge_test.go	Add language merge support for Pages in resource.Resources	2018-04-19 16:23:00 +02:00
pages_related.go	hugolib: Fix typo in aquired	2017-09-07 16:21:33 +02:00
pages_related_test.go	resource: Add front matter metadata to Resource	2018-01-17 16:22:33 +01:00
pageSort.go	Make .Content (almost) always available in shortcodes	2018-04-21 22:02:56 +02:00
pageSort_test.go	hugolib: Fix some shortcode vs .Content corner cases	2018-04-25 08:56:46 +02:00
pagesPrevNext.go	hugolib: Simplify Prev/Next	2018-03-12 22:13:25 +01:00
pagesPrevNext_test.go	all: Refactor to nonglobal Viper, i18n etc.	2017-02-17 17:15:26 +01:00
pagination.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
pagination_test.go	hugolib: Fix possible .Content cut	2018-05-08 16:52:51 +02:00
path_separators_test.go	hugolib, output: Incorporate suffix and type in layout resolve	2017-03-27 15:43:56 +02:00
permalinker.go	hugolib: Add optional outputFormat to Ref/RelRef	2017-04-04 23:09:01 +02:00
permalinks.go	resource: Add front matter metadata to Resource	2018-01-17 16:22:33 +01:00
permalinks_test.go	all: Refactor to nonglobal Viper, i18n etc.	2017-02-17 17:15:26 +01:00
prune_resources.go	Add support for a content dir set per language	2018-04-02 08:06:21 +02:00
robotstxt_test.go	Spring test cleaning, take 2	2018-03-18 09:54:32 +01:00
rss_test.go	✨ Implement Page bundling and image handling	2017-12-27 18:44:47 +01:00
scratch.go	hugolib: Add Reset method to delete key from Scratch	2018-03-17 00:13:23 +01:00
scratch_test.go	hugolib: Add Reset method to delete key from Scratch	2018-03-17 00:13:23 +01:00
shortcode.go	hugolib: A little more on shortcode ordinal	2018-05-28 10:29:48 +02:00
shortcode_test.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
shortcodeparser.go	Allow "*/" inside commented out shortcodes	2018-04-11 22:41:48 +02:00
shortcodeparser_test.go	Allow "*/" inside commented out shortcodes	2018-04-11 22:41:48 +02:00
site.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
site_benchmark_test.go	Add a GetPage to the site benchmarks	2018-01-24 09:08:26 +01:00
site_output.go	Allow partial redefinition of the ouputs config	2018-03-10 16:57:25 +01:00
site_output_test.go	Allow partial redefinition of the ouputs config	2018-03-10 16:57:25 +01:00
site_render.go	hugolib: Fix possible .Content cut	2018-05-08 16:52:51 +02:00
site_sections.go	hugolib: Avoid scanning entire site to find the home	2018-02-25 10:50:44 +01:00
site_sections_test.go	resource: Add front matter metadata to Resource	2018-01-17 16:22:33 +01:00
site_stats_test.go	✨ Implement Page bundling and image handling	2017-12-27 18:44:47 +01:00
site_test.go	Add a way to merge pages by language	2018-03-16 10:10:01 +01:00
site_url_test.go	config: Add the foundation for GDPR privacy configuration	2018-05-21 00:41:42 +02:00
siteJSONEncode_test.go	✨ Implement Page bundling and image handling	2017-12-27 18:44:47 +01:00
sitemap.go	hugolib: Fix some more Golint warnings	2016-03-23 10:10:28 +01:00
sitemap_test.go	all: Update import paths to gohugoio/hugo	2017-06-13 18:42:45 +02:00
taxonomy.go	resource: Add front matter metadata to Resource	2018-01-17 16:22:33 +01:00
taxonomy_test.go	Add support for a content dir set per language	2018-04-02 08:06:21 +02:00
template_engines_test.go	Fix broken shortcodes for Ace and Amber	2017-11-18 10:41:31 +01:00
template_test.go	hugolib: Add additional test to TestTemplateLookupOrder	2018-02-05 08:38:04 +01:00
testhelpers_test.go	Add support for theme composition and inheritance	2018-06-10 23:55:20 +02:00
translations.go	hugolib: Fix .IsTranslated with identical filenames	2017-11-17 19:46:32 +01:00