Project

pretty_doc

0.01
No commit activity in last 3 years
No release in over 3 years
Pretty Doc is quick and convenient markdown to html converter with beautiful templates, aiming to provide a simple tool to generate beautiful docs for common use.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 1.0.0
>= 0
>= 0
>= 3.0.0
>= 1.0.0

Runtime

~> 1.0.3
~> 1.8.0
~> 1.6.6
~> 0.6.3
~> 2.5.2
 Project Readme

Pretty Doc

Pretty Doc is quick and convenient markdown to html converter with beautiful templates, aiming to provide a simple tool to generate beautiful docs for common use.

[TOC]

Features

  • Beautiful built-in templates: default, bootstrap, parallel
  • Code highlight
  • Markdown TOC supports
  • Easy to customize template
  • Support GFM( GitHub Flavored Markdown ) syntax

Examples

Template Parallel

Installation

Pretty Doc is relied on ruby environment. Please make sure that your system has ruby installed.

gem install pretty_doc

Usage

# Usage: pretty_doc [options] files
#
# Options:
#
#     -o, --output [path]              output to a given folder
#     -t, --template [folder]          choose a template
#     -l, --line-numbers               enable line numbers for codes
#     -v, --version                    output the version number
#     -h, --help                       output usage information

Generate TOC

Use [TOC] or {:toc} in your markdown file to generate table of contents and use [NO_TOC] or {:.no_toc} to ignore specific header.

Example:

Pretty Doc
==========
[NO_TOC]

[TOC]

## Feature

## Usage

Create a custom template

template structure

├── init.rb
├── style.scss
└── template.html.erb

TODO

  • Add docs for how to create a custom template
  • Add file toc support
  • Optimize templates for Windows
  • Add custom fonts and javascripts supports