KB4IT

Knowledge Base For Information Technologies

  • Introducción
  • Características
  • Status
  • Descarga
  • Capturas de pantalla
  • Instalación
  • Configuración
  • Uso
  • Mantenimiento
  • Licencia

KB4IT es un gestor de documentación cuya misión es agilizar la puesta en marcha la documentación de uno o varios proyectos.

KB4IT esta basado en Mediawiki así como en varias extensiones. La más importante de todas, la extensión Semantic Mediawiki permite crear modelos de información en base a reglas muy sencillas.

KB4IT no es un programa en sí mismo sino un conjunto de plantillas, formularios y propiedades que, añadidos a Mediawiki, permiten crear un entorno amigable para trabajar con documentación. Surge de la necesidad de gestionar la vasta cantidad de documentos que, como Administrador de Sistemas en mi caso, se obtienen en el día a día. Anotaciones, procedimientos, reseñas, enlaces, teléfonos, nombres, llamadas, tareas que realizar y así un largo etcétera. Muchas de estas anotaciones acaban dispersas en diferentes medios (servilletas, cuadernos, un post-it, un fichero de texto) y aunque a la corta resultan útiles no es muy práctico.

Empezé a trastear hace un par de años con la extensión Semantic Mediawiki y después de entender el funcionamiento interno se ha convertido en un fiel aliado para la gestión de todas esas notas y una auténtica navaja suiza para no perderme en un océano de documentación.

La principal virtud de Mediawiki es que todo son páginas y que estas se crean en base a texto plano las cuales, haciendo uso del lenguaje de marcado (wikicode) permite alterar la forma de dichas páginas incluyendo contenido enriquecido (imágenes, widges, texto formateado, enlaces, etc..).

La extensión Semantic Mediawiki permite dar un significado al texto de las páginas servido por Mediawiki mediante el uso de Propiedades. Las propiedades son la forma más básica de introducir datos semánticos dentro de una página.

  • KB4IT
    • Núcleo básico: gestión de empleados, procedimientos, eventos y proyectos conformando una Agenda.
  • Heredado de la extensión Semantic Web Mediawiki
    • Relaciona información de diferentes áreas de conocimiento con facilidad
    • Reconstrucción automática de las relaciones en base al texto de las páginas
    • Búsquedas semánticas: búsqueda avanzada basada en propiedades
    • Permite información semi-estructurada: crear modelos de información a medida de forma fácil basado en propiedades, formularios, plantillas y categorías
  • Heredado de Mediawiki
    • Permite información destructurada: texto plano con posibiliad de enlaces a otros contenidos
    • Categorización de contenidos
    • Búsqueda avanzada
    • Historial de modificaciones
    • Repositorio de ficheros

En estos momentos está en pleno desarrollo aunque lleva funcionando en mi forja más de un año cumpliendo su cometido al 100%.

Esta primera versión es la base de un desarrollo más completo que incluya internacionalización (actualmente solo está disponible en español) y terminar de completar y/o mejorar las funcionalidades más básicas (gestión de información de empleados, mejoras en la introducción de datos y visualización de eventos e introducción de la información. Por supuesto mejoras en las plantillas ya existentes y arreglo de bugs principalmente.

Hay dos formas de obtener KB4IT:

  • Descargando un paquete comprimido con la última versión (Estable)
  • Accediendo al código del repositorio en Launchpad (Inestable)

  1. Preparar el entorno LAMP en el servidor
  2. Instalar MediaWiki
  3. Instalar Semantic Mediawiki extension:
  4. Instalar las extensiones necesarias (ver fichero kb4it-extensions.txt)
  5. Importar páginas del proyecto

Todas las propiedades tienen una plantilla, un formulario y una categoría asociadas.

Puedes gestionar tu modelo de información desde las páginas especiales. Allí encontrarás enlaces a los formularios, plantillas, propiedades y el resto de páginas que componen KB4IT.

KB4IT puede ser extendido añadiendo más propiedades.

Utiliza como punto de partida la página principal importando el contenido de:

./kb4it-0.1/kb4it/es/data/kb4it-data-extras.xml

ó

módifica la página principal con el siguiente código:

 

 

Utiliza el fichero kb4it-pagelist.txt para llevar un control de las páginas que componen el proyecto. Este fichero solo contiene las páginas que conforman el núcleo de KB4IT. Esta lista de nombres de páginas es la lista que debe ser exportada para crear otro wiki o mantener un sistema de backups de las mismas.

Adicionalmente se encuentra el fichero kb4it-pagelist-optional.txt que contiene páginas que complementan al proyecto (pero que podrían reemplazar páginas estándar del wiki como la página principal o el menú lateral).

 

KB4IT – a document management system

Copyright (C) 2013 Tomás Vírseda García

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program.  If not, see http://www.gnu.org/licenses/agpl-3.0.html.