Skip to content
This repository has been archived by the owner. It is now read-only.
Turn .md docs into beautiful sites
JavaScript CSS HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist
docs
html
images
polyfills
scripts
spec
styles
.gitignore
.travis.yml
GruntFile.js
LICENSE
README.md
bower.json
docbase-config.js
docbase.json
index-unic.html
index.html
package.json
sample-docbase-config.js
sample-index.html
search-index.json

README.md

Docbase

Build Status NPM

We are no longer actively maintaining Docbase, we instead recommend using gatsbyjs.

Turn .md files into a beautiful documentation hub with versioning and beautifully rendered menus.

  • Docbase can read files that are hosted on github, locally or a http:// server.
  • It can publish documentation hubs to github pages (via travis) or locally which can be served with as static files with a http:// server.

Docbase comes with a yeoman generator that turns the installation and configuration process into a piece of cake.

A rendered documentation site

Example Hubs built with Docbase

  1. Airbnb JS Style guide
  2. Redis Docs
  3. EmberJS Guide

Installation

1. npm install -g yo

█████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

2. npm install -g generator-docbase

██████████▒▒▒▒▒▒▒▒▒▒

3. yo docbase

Welcome to
    .___           ___.
  __| _/____   ____\_ |__ _____    ______ ____
 / __ |/  _ \_/ ___\| __ \\__  \  /  ___// __ \
/ /_/ (  <_> )  \___| \_\ \/ __ \_\___ \\  ___/
\____ |\____/ \___  >___  (____  /____  >\___  >
     \/           \/    \/     \/     \/     \/
        generator!

...

████████████████████

Docbase is live at: http://127.0.0.1:1234

Read the manual

The manual walks through the generator options, and explains docbase options and features. The manual itself is served with docbase.

Who uses docbase

Send a PR with your name here.

History

v0.3.0 Feb 27 '17

  • Phantom.js dependency upgrade
  • Compatibility with Node v6.9.x
  • Uses scroll in code blocks
  • Fixes mobile read view
  • Adds a feature to see other pages in the directory

v0.2.56 Apr 2 '16

  • Comes with a yeoman generator yo docbase
  • Resizable mobile navigation menu
  • Realtime search with an offline search index
  • No 404s when navigating to folders
  • Updates markdown parser
  • Show github contributors on each documentation page
  • Colorful themes baked in

.
. (54 more releases)
.

v0.0.2 Aug 7 '15

  • All flatdoc theme options supported
  • Customizable root path

v0.0.1 Feb 10 '15

  • Initial release

Credits

Henrique Sa (@henriquesa),
Mateus Freira (@mateusfreira),
Farhan Chauhan (@farhan687),
Siddharth Kothari (@siddharthlatest)

License

MIT

You can’t perform that action at this time.