Giter VIP home page Giter VIP logo

adedayoominiyi / znai Goto Github PK

View Code? Open in Web Editor NEW

This project forked from testingisdocumenting/znai

0.0 2.0 0.0 38.8 MB

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.

Home Page: https://testingisdocumenting.org/znai

License: Apache License 2.0

Shell 0.01% JavaScript 26.42% C++ 0.19% Python 0.96% C 0.01% Java 40.21% Scala 0.01% Groovy 14.77% TypeScript 9.73% XSLT 0.02% CSS 5.20% ANTLR 1.96% Makefile 0.02% HTML 0.10% Batchfile 0.01% Jupyter Notebook 0.40%

znai's Introduction

Znai

Build functional, maintainable, beautiful User Guides with Znai.

  • Markdown with custom extensions and dozens of plugins:
    • Content from external files with markers and filters support
    • Simplified extraction of a function body content (working with examples)
    • Embedding of JavaDoc/PyDoc documentation text, preserving styles
    • Beautiful API documentation capabilities
    • Two Sides Page Layout Option with convenient example languages switch
    • Rich visuals like flow diagrams and charts
    • etc
  • Instant pages navigation
  • Local search
  • Multiple integrations to work with Python, Java, OpenAPI, etc
  • Presentation Mode to automatically turn your documentation into slides, using the same content
  • Dark/Light runtime themes
  • Leverage automated test results to enrich your documentation with annotated images, REST responses, CLI outputs, etc
  • GitHub pages friendly

generated site example

Embedding of External Resources at build time

generated site example of external code

Rich Visuals such as Charts and Flow Diagrams

generated site example of charts

Dark/Light mode switching

generated site example of flow diagram

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

znai's People

Contributors

mykolagolubyev avatar byc1234 avatar jyeakel avatar tsiq-karold avatar dependabot[bot] avatar evinaik avatar motlin avatar steelalex avatar tsiq-nick avatar clemensbertram avatar snyk-bot avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.