-
-
Notifications
You must be signed in to change notification settings - Fork 1.9k
Open
Labels
Description
The documentation currently uses "site" interchangeably for the project, the sites within the project, and the published output.
Definitions:
- site: A specific instance of your project representing a unique combination of language, role, and version. While a simple project may consist of only a single site, Hugo’s multidimensional content model allows a single codebase to generate a matrix of sites simultaneously.
- project: A collection of components used to generate one or more sites. While a project may consist of only a single site, Hugo allows a single project to generate a matrix of sites based on language, role, and version. The project serves as the parent container for the common assets and logic used across all sites within the build.
- build artifacts: The collective output generated in the public directory.
Using build artifacts instead of something like "published site" handles both single-host and multihost projects. Example usage:
When you publish your project, Hugo renders all build artifacts to the
publicdirectory in the root of your project.
Be careful when replacing site with project in the context of configuration: some configuration settings can be site-specific.
TODO:
- Create build artifacts glossary entry
- Assess and replace term usage
Reference: https://discourse.gohugo.io/t/deprecations-in-v0-156-0/56732
Reactions are currently unavailable