Home | Screenshots | Downloads | GitHub | Contact
AutoSite wordmark

Apricot (Building Your Site)

Building your site is the process of rendering output pages from your templates and input pages and syncing in any included assets. AutoSite's build engine is called Apricot.

To build your site, select "Build Site" from the Tools menu, click one of the two "Build" buttons in either the Code Editor or the Build Information Panel, or use the Ctrl+B keyboard shortcut. If you have many large included assets or many pages to build, Apricot could take a moment, so be patient.

[#] The Build Log

Apricot will output its build log to the "Log" tab of the Build Information Panel of the AutoSite GUI. This is a detailed log of information and errors for every input page Apricot processes, along with the total time of the process and any errors Apricot encounters during the build process, like missing templates.

Apricot's build log in the AutoSite GUI
Apricot's build log in the AutoSite GUI

If you're using AutoSite Core, the build log will instead be written to the console output.

[#] Sanitary Builds

You might've notice an extra menu option in the Tools menu, that of "Sanitary Build...". A sanitary build will completely remove the out folder before Apricot builds the site as normal, meaning all includes and built files will be fresh ones.

Sanitary builds are incredibly useful if you've been shifting around and renaming files. A normal build doesn't delete or rename files in the out folder, it merely copies new ones in and overwrites existing ones with identical names. A sanitary build takes longer, but it makes sure there are no orphaned or outdated files in the out folder.

As it deletes files, AutoSite will prompt you before you perform a sanitary build. Use with caution.

AutoSite prompting about a sanitary build
AutoSite prompting about a sanitary build