Metadata-Version: 2.1
Name: KB4IT
Version: 0.7.6
Summary: A static website generator based on Asciidoctor sources.
Home-page: https://github.com/t00m/KB4IT
Author: Tomás Vírseda
Author-email: tomasvirseda@gmail.com
License: GPL v3
Download-URL: https://github.com/t00m/KB4IT/archive/master.zip
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Other Audience
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Utilities

About KB4IT
===========

Introduction
^^^^^^^^^^^^

*KB4IT* is a static website generator based on Asciidoctor sources mainly for technical documentation purposes.

Motivations
^^^^^^^^^^^
-  The main aim is to provide an easy way to write technical documentation.
-  Don't care about the formatting and focus on the contents.
-  To allow teams to manage their knowledge database easily.
-  Do not depend on third software products like word processors or complex web applications.

Features
^^^^^^^^

Pros
""""

- Writing documentation: Documents must be in Asciidoctor format which is easy to learn.
- Finding documents: Once a document is converted to html, properties can be browsed.
- Publishing your repository: all necessary files are inside a directory. Browse it or copy it to your web server.
- Serverless: There is no need for a web server. Of course, you can use one if you please.
- Smart compiling: Only those documents added or modified are compiled.
- You can create your own themes easily.

Cons
""""

- Not to much documentation at this moment
- No online editor: At this moment, KB4IT doesn't include any online editor. You must create or edit your documents with your preferred editor.
- No dynamic search: KB4IT was developed to be as simple as possible. No dependencies at all excepting Asciidoctor (as text processor and publishing toolchain) and Python (the programming language used).
- It works out but consider the code unstable.

Installation
^^^^^^^^^^^^

From source
"""""""""""

``python3 setup.py install --user``

Pypi package
""""""""""""

``pip3 install kb4it --user -U``

Execution
^^^^^^^^^

The most typical usage would be:

``$HOME/.local/bin/kb4it -source /path/to/asciidoctor/sources -target /path/to/target/directory -log DEBUG -force``

Examples
^^^^^^^^

Check out GitHub repository kb4it-adocs <https://github.com/t00m/kb4it-adocs> with some demos.


Download
^^^^^^^^

Get the code from GitHub:

``git clone https://github.com/t00m/KB4IT``


Credits
^^^^^^^

-  `Python <https://python.org>`_
-  `Asciidoctor <https://asciidoctor.org>`_
-  `UIKit <https://getuikit.com>`_


