JJust the Docs × Asyntai50 free messages

AI Chatbot for Just the DocsGuides your visitors can simply ask.

How do I borrow e-books? Can I book a study room? Why is my card blocked? Patrons call the desk for things the guides already explain. Asyntai reads your Just the Docs pages and gives the answer, any time the site is open.

Create my assistant Just the Docs setup
Free plan head_custom.html Requests to staff
guides.brightwater.example/ebooks/borrow
Brightwater Library
Library card
Free
E-booksStudy roomsPrinting
Get a card
Brightwater LibraryOnline
Hi! How can the library help?
Powered by Asyntai
1include file
Allguide pages
Afterhours answers
50messages free
Patrons ask

The questions the front desk hears daily

Cards, e-books, rooms and fines. Asyntai replies from your guide pages and sends requests that need a person to staff.

How do I get a card?How do I borrow e-books?Can I book a room?How much is printing?Can I renew a book?Do you charge fines?
What is the Wi-Fi password?Is there story time?When are you open?Can I borrow a laptop?Can I volunteer?Can you order a book?
Features

Ready for Just the Docs sites

Libraries, universities, open-source projects and IT teams that run their guides on Jekyll with the Just the Docs theme.

Reads your guides

Every page in your navigation, plus PDF rules and forms you upload.

Borrow e-booksGuide
Study roomsGuide
Borrowing rules.pdfLearned

head_custom.html

In your _includes folder.

1file

Patrons who speak other languages

A patron who asks in Arabic receives the reply in Arabic.

ENESARZHVIUK

Requests for staff

Book requests and account issues reach the right team with contact details.

DP
Daniel P.Purchase request
New

On phones in the stacks

Patrons often check a guide on their phone inside the building, and the chat fits that screen.

Know what patrons need

A topic chart shows which services cause the most questions.

E-books30%
Rooms22%
Cards17%

Careful with accounts

It explains your policies and sends card or fine issues to staff.

Why is my card blocked?Cards pause when fees reach $10 or a card expires. The Accounts guide explains both, and I can ask staff to check your card.
Example

A patron asks for a new book

A patron cannot find a title. Asyntai explains the request process and saves it for the team.

  • Checks the guide

    Request rules come from your pages.

  • Takes the request

    Title, author and card name are saved.

  • Alerts the team

    Staff see the request with the conversation.

Library colour
Setup

Adding it to a Just the Docs site

Just the Docs has a custom include for the head. HTML in that file goes before the closing head tag on every page.

Get the Asyntai snippet

Make a free Asyntai account, add the URL of your docs site and copy the snippet.

Open _includes

In your Jekyll site, open the _includes folder, or add one at the root.

Add head_custom.html

Paste the snippet in a file named head_custom.html in that folder.

Publish the site

Commit and push for GitHub Pages, or run bundle exec jekyll build and upload the result.

This works with the gem, the remote theme on GitHub Pages and a fork of the theme. Keep any code you already have in head_custom.html.

_includes head_custom.html
head_custom.html
<script src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_ID" async></script>
jekyll build
Benefits

Why Just the Docs sites add it

50 messages come free. Choose a paid plan when demand grows.

Compare plans Create my assistant
01

A quieter front desk

Simple questions get a reply online, so staff can help people in the building.

02

Help in many languages

Your guides are in one language. Patrons can still ask in their own.

03

Guides stay the source

Update a Markdown page and push. The next crawl brings the change into replies.

FAQ

Just the Docs questions

Includes, GitHub Pages, patrons and plans.

Which file do I edit?

_includes/head_custom.html in your site. The theme inserts it before the closing head tag.

Does it work on GitHub Pages?

Yes. With remote_theme, your own _includes folder still overrides the theme file.

Do all pages get the chat?

Yes. The theme adds head_custom.html to the head of each page it renders.

Does it replace the theme search?

No. Lunr search stays. Visitors can search for a word or ask a full question in the chat.

Does it read the whole navigation?

It crawls your published pages, so parent and child pages are included. Crawl again after big edits.

Can it pass requests to staff?

Yes. It saves the request with contact details, and your team gets a notice.

Does it fit the dark color scheme?

Yes. The chat button has its own colors and stays clear on light and dark schemes.

Can visitors ask in Spanish or Arabic?

Yes. Asyntai supports 36 languages and replies in the visitor's language.

What is the price?

The Free plan covers one site and some free messages. Paid plans add more messages per month.

Guide

An AI assistant for Just the Docs sites

Why add an assistant to Just the Docs

Just the Docs gives Jekyll sites a clear sidebar, search and a clean layout.

Visitors still ask before they read. A chat meets them with the answer and the page that holds it.

Answers for everyday questions

Hours, accounts, rooms and e-books fill most of a library's calls.

Asyntai replies from your guides, so staff time goes to people who need more help.

Requests that need a person

Some questions need staff, such as account blocks or book purchases.

The chat takes the details and passes them on, with the full conversation.

Setup with head_custom.html

The theme reads _includes/head_custom.html and adds it before the closing head tag.

Put the snippet there, publish, and every page shows the chat button.

Better guides from real questions

The dashboard shows the topics people ask about.

Add a page or a clearer step where questions pile up.

Help every visitor of your Just the Docs site

One include file adds the chat to the whole site. 50 messages are free.

Create my assistant Compare plans
No card required to start.
Other docs platforms
Jekyll MkDocs Hugo Docusaurus VitePress Sphinx Wiki.js BookStack mdBook Retype