testingisdocumenting / znai

Build functional, maintainable, beautiful User Guides with markdown and Znai plugins. Instant pages navigation. Local search. Multiple integrations to work with Python, Java, C++, OpenAPI, etc. Transform "getting started" sections into slideshow for your workshops. Manage multiple documentations with self-deployed znai hub.
https://testingisdocumenting.org/znai
Apache License 2.0
241 stars 13 forks source link
documentation github-pages java markdown openapi openapi3 python rest-api static-site-generator userguide

Discord Server

Join Testing Is Documenting Discord Server to ask questions and discuss features/bugs

Znai

Build functional, maintainable, beautiful User Guides with Znai.

generated site example

Embedding of External Resources at build time

generated site example of external code

Rich Visuals such as Charts, Flow Diagrams and Cards

generated site example of charts

Dark/Light mode switching

generated site example of flow diagram

Cards support

generated site example of cards

Beautiful way to document your API

generated site example of api params

Use two sides layout option to render examples and supporting information side by side with convenient examples language switch

generated site example of two sides layout

Blazing fast local search with results preview

generated site example of search

Automatic Presentation from the same content with zero config

generated site example of presentation mode

Preview

Znai has a preview mode to automatically listen to local files changes. It automatically navigates to a page that was changed (directly or indirectly) and highlights the changes.

Docs Hub

Znai has a free, open-source enterprise support. You can host multiple documentations using single site. It provides landing page to list all the company inner guides.

It also automatically detects documentations in the builds outputs and updates hosted documentations.

Examples (including using Google Cloud) and setup documentation are coming. Please create a GitHub issue if you want to learn more about Enterprise setup. It will help me prioritize.

Read More

Znai documentation website built with Znai

For curios, znai word meaning: znai is a to know in Ukranian and is a prefix for words like knoweldge are built on.

Developers Setup

Local Build