📦 Installation

Prerequisites

Before installing Knowledge, ensure your system meets these requirements:

System Requirements

• Node.js: Version 18.0.0 or higher
• Package Manager: npm, yarn, pnpm, or bun
• Operating System: Windows, macOS, or Linux
• Memory: Minimum 512MB RAM available
• Storage: At least 100MB free space

Check Your Environment

Verify your Node.js version:

node --version
# Should output v18.0.0 or higher

Check npm version:

npm --version
# Should output 6.0.0 or higher

Installation Methods

🚀 Global Installation (Recommended)

Install Knowledge globally to use it from anywhere:

# Using npm
npm install -g @riligar/knowledge

# Using yarn
yarn global add @riligar/knowledge

# Using pnpm
pnpm add -g @riligar/knowledge

# Using bun
bun add -g @riligar/knowledge

📦 Local Installation

For project-specific installations:

# Using npm
npm install @riligar/knowledge --save-dev

# Using yarn
yarn add @riligar/knowledge --dev

# Using pnpm
pnpm add @riligar/knowledge --save-dev

# Using bun
bun add @riligar/knowledge --dev

🐳 Using with Docker

Create a Dockerfile for containerized documentation:

FROM node:18-alpine

WORKDIR /app

# Install Knowledge globally
RUN npm install -g @riligar/knowledge

# Copy your documentation
COPY docs/ ./docs/
COPY knowledge.config.ts ./

# Build documentation
RUN knowledge build

# Serve static files
EXPOSE 8080
CMD ["knowledge", "serve", "--port", "8080"]

Configuration

Initial Setup

After installation, create your first documentation project:

# Create a new project
knowledge init my-documentation
cd my-documentation

This creates the following structure:

my-documentation/
├── docs/
│   └── index.md              # Your main documentation file
├── knowledge.config.ts       # Configuration file
└── package.json             # Project dependencies

Configuration File

The knowledge.config.ts file is the heart of your documentation setup:

import type { KnowledgeConfig } from '@riligar/knowledge';

export default {
    // Input and output directories
    inputDir: './docs',
    outputDir: './dist',
    
    // Site metadata
    site: {
        title: 'My Documentation',
        description: 'Comprehensive documentation for my project',
        baseUrl: '/',
        author: 'Your Name'
    },
    
    // Theme and layout
    theme: 'default',
    layout: 'default',
    
    // Navigation settings
    navigation: {
        auto: true  // Automatically generate navigation from file structure
    },
    
    // Feature toggles
    features: {
        search: true,           // Enable search functionality
        syntaxHighlight: true,  // Code syntax highlighting
        darkMode: true,         // Dark mode support
        tableOfContents: true,  // Automatic TOC generation
        breadcrumbs: true,      // Navigation breadcrumbs
        editOnGithub: 'https://github.com/yourusername/your-repo'
    },
    
    // Markdown processing options
    markdown: {
        breaks: true,      // Convert line breaks to 

        linkify: true,     // Auto-convert URLs to links
        typographer: true  // Enable smart quotes and dashes
    },
    
    // Development server settings
    dev: {
        port: 3000,
        host: 'localhost',
        livereload: true
    }
} as KnowledgeConfig;

Environment Variables

You can override configuration using environment variables:

# Set custom port
export KNOWLEDGE_PORT=8080

# Set custom host
export KNOWLEDGE_HOST=0.0.0.0

# Enable debug mode
export KNOWLEDGE_DEBUG=true

Verification

Test Installation

Verify Knowledge is installed correctly:

# Check version
knowledge --version

# View help
knowledge --help

# Test with a simple project
knowledge init test-docs
cd test-docs
knowledge dev

Expected Output

When running knowledge dev, you should see:

🚀 Knowledge Development Server
📁 Input: ./docs
📁 Output: ./dist
🌐 Server: http://localhost:3000
👀 Watching for changes...

✅ Documentation built successfully!
🎉 Server started at http://localhost:3000

Troubleshooting

Permission Issues (macOS/Linux)

# If you get permission errors, use sudo
sudo npm install -g @riligar/knowledge

# Or fix npm permissions
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

Windows PowerShell Execution Policy

# If scripts are blocked, enable execution
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Node.js Version Issues

# Update Node.js using nvm
nvm install 18
nvm use 18

# Or download from nodejs.org

Port Already in Use

# Use a different port
knowledge dev --port 3001

# Or kill the process using the port
lsof -ti:3000 | xargs kill -9  # macOS/Linux
netstat -ano | findstr :3000   # Windows

Next Steps

Now that Knowledge is installed and configured:

1. Create Content: Start writing your documentation in Markdown
2. Customize: Modify the configuration to match your needs
3. Deploy: Build and deploy your documentation to any static host

Continue with our Usage Guide to learn how to create and manage your documentation effectively.

Updating Knowledge

Keep Knowledge up to date with the latest features:

# Update global installation
npm update -g @riligar/knowledge

# Check for updates
npm outdated -g @riligar/knowledge

# View changelog
knowledge changelog

Need help? Check our troubleshooting section or open an issue on GitHub.