Main Unison website
The Unison website is primarily constructed via Unison Doc, and the content
lives in the associated Unison codebase. Through a build process and the ucm
docs.to-html command, this content is transformed to HTML pages, post
processed for better fit for the website and finally built by eleventy (static
site generator). This includes both collections like docs, articles, and posts,
as well as individual pages.
Some collections have "partials" that make up their pages. Articles for
instance has a _title Unison Doc term that is transformed into the page as
frontmatter for eleventy, where Docs has _sidebar term that makes up the
index of the language documentation.
Browse the Unison Docs that power the website here: https://share.unison-lang.org/@unison/p/code/latest/namespaces/public/website
Tickets about the website content should be filed using the Unison Share ticketing feature. PR's are gratefully accepted through the regular Unison code contribution workflow.
Ensure all dependencies are installed by running npm install (node v17+
recommended).
npm start will both build and start a local version of the website.
- Convert Docs in a Unison Namespace to HTML files in the build/articles and build/docs
- Pre-process HTML with proper links and parse article sidebars
- Copy from build to src/articles and src/docs
- Render via eleventy to build/site
Note that this requires being setup in Netlify with the correct access.
npm run deploy:prodwill deploy the website to production on https://unison-lang.org.
After the deploy to Netlify has succeeded, update the algolia search index by going to https://unison-lang.org/algolia.json and saving the json file.
Then go to the "docs" index in Algolia, clear it (removing all records), and upload the downloaded json file.