Skip to content

deepset-ai/haystack-home

Repository files navigation

Nighly Build

Haystack

This Haystack website is built using Hugo, a static website generator written in Go.

Contribute

  1. Install Hugo using the appropriate installation method for your OS
  2. Clone the project locally, and install dependencies by running ./build.sh
  3. Add or edit any content in the /content directory
  4. Start a local Hugo server (with drafts enabled) by running hugo server -D
  5. Visit http://localhost:1313/ in your browser to preview any changes made

Adding new content

Edits and Additions to Tutorials:

The tutorials are maintained in the haystack-tutorials repository

  1. Check out the Contributing Guidelines
  2. Create a PR on the haystack-tutorials repository
  3. When merged, your changes will reflect on the Haystack website after the next deployment

Shortcodes

You can use Hugo shortcodes in markdown to call various built-in or custom templates.

Embedding a Youtube or Vimeo video:

{{< youtube w7Ft2ymGmfc >}}

{{< vimeo 146022717 >}}

Adding a button:

{{< button url="https://github.com/deepset-ai/haystack-home" text="Haystack website Github Repo" color="green">}}

# colors options: green, blue, dark-blue

Adding tabbed content:

{{< tabs totalTabs="2">}}
{{< tab tabName="First Tab Name" >}}

First tab content here

{{< /tab >}}

{{< tab tabName="Second Tab Name" >}}

Second tab content here

{{< /tab >}}
{{< /tabs >}}

Adding an image in article content

![alt text](image_path.png#small "Markdown *caption* with a **[bold link](/)**")

Editing the theme

HTML template files are located at /themes/haystack/layouts

CSS (Sass) files are located at /themes/haystack/assets/sass

Exclude Page from sitemap

To exclude any page from the sitemap add the following to the frontmatter of that page: sitemap_exclude: true

Consider this for pages that are versioned that are effectively duplicates of an original page with minor changes, for example the "Benchmarks" page.

Hide Page

To hide a blog post, tutorial or integration page, add hidden: true to the frontmatter.