Skip to content

Migrating from version 1.0 to version 2.x

dbohdan edited this page Mar 12, 2019 · 3 revisions
  1. Migrate your website with the migration tool.

Run the migration tool. It will create a copy of your website's input/ directory with updated data. In particular, it will translate your website.conf to the new format. The pageSettings will be moved to a separate file called presets/default; the blogPostSettings will be moved to presets/blog. The frontmatter of the pages will also be updated. Because the new config and frontmatter format allows comments, the incompatible settings will be preserved, but commented out. Note any warnings you receive at the end of the tool's run.

tclsh tools/migrate.tcl /path/to/your/project/input /path/to/your/project/input-new
  1. Try building the updated website with Tclssg 2.x.
tclsh ssg.tcl build /path/to/your/project/input-new
  1. Apply manual fixes as necessary.

The migration may require manual changes. Edit the website config, the presets, and the page frontmatter as necessary to fix any build and visual errors.