Skip to content

A simple solution in combining the features of a cms and a static site generator.

Notifications You must be signed in to change notification settings

sudokrew/mkdocs-cms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

63 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MkDocs-CMS

Is a simple cms solution for MkDocs wrapped in node.

  • Markdown version (master)
  • Html version (html)

Getting Started

Since this is a wrapper for MkDocs you will need to have it set up and installed on your system. In order to install MkDocs you'll need Python installed, as well as the Python package manager, pip. You can check if you have these already installed ike so:

  $ python --version
  Python 2.7.2

  $ pip --version
  pip 1.5.2

MkDocs supports Python 2.6, 2.7, 3.3 and 3.4.

MkDocs recoomends for Windows users to install Python and pip with Chocolatey

After you have Python & pip, you can use it to install the mkdocs package:

  $ pip install mkdocs

If installed you should now have the mkdocs commands available.

  $ mkdocs help
  mkdocs [help|new|build|serve|gh-deploy] {options}

Project Set Up

  • Node (v 0.12.7)
  $ npm install
  $ bower install

Run development processes

  • Task runner with gulp.js
  $ gulp
  • If gulp is running, "rs" in the terminal will restart the servers
  $ rs

Further Reading

  • MKDocs is a fast, simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file.

  • SimpleMDE is a simple, embeddable, and beautiful markdown editor.

About

A simple solution in combining the features of a cms and a static site generator.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published