hollodotme/treemdown

A PHP class for browsing markdown files with HTML rendering, syntax highlighting and search

v2.0.0-rc1 2019-09-10 07:53 UTC

Requires

• php: >=7.1
• ext-iconv: *
• erusev/parsedown-extra: ^0.7.0

Requires (Dev)

• tm/tooly-composer-script: ^1.0

MIT

• Holger Woltersdorf

• tree
• parser
• search
• markdown
• html
• markdown extra
• grep

README

TreeMDown [triː <'em> daʊn]

... is a single page PHP application for browsing markdown documents in a file structure and translating them to HTML.

A full featured demo can be found here!

News

You like TreeMDown and you are interested in browsing multiple trees of markdown files?

Check out TreeMDown-Multi! Live demo is available here.

Latest updates

• Updated highlightjs to version 8.3
• Fixed syntax highlighting of markdown code
• Handling internal links between markdown files in the same tree (see the documentation)

Requirements / Dependencies

• PHP >= 5.3
• Parsedown-Extra via composer
• Webserver (Apache, nginx, etc.)

Note: This application is currently tested on linux systems only.

Installation

Via composer

To get the latest stable release, check the versions at Packagist and add to your composer.json:

{
	"require": {
		"hollodotme/treemdown": "~1.0"
	}
}

To get the bleeding edge version add this to your composer.json:

{
	"repositories": [
		{
			"type": "vcs",
			"url": "[e-mail]:hollodotme/TreeMDown.git"
		}
	],

	"require": {
		"hollodotme/treemdown": "dev-master"
	}
}

Now include the vendor/autoload.php and get started.

Usage

Basic

<?php

use hollodotme\TreeMDown\TreeMDown;

$treemdown = new TreeMDown('/path/to/your/markdown/files');

$treemdown->display();

With personalization and options

<?php

use hollodotme\TreeMDown\TreeMDown;

// Create instance
$treemdown = new TreeMDown( '/path/to/your/markdown/files' );

# [Page meta data]
#
# Set a projectname
$treemdown->setProjectName('Your project name');

# Set a short description
$treemdown->setShortDescription('Your short description');

# Set a company name
$treemdown->setCompanyName('Your company name');

# [Output options]
#
# Show or hide empty folders in tree
#
# Default: Empty folders will be displayed
#
#$treemdown->showEmptyFolders();
$treemdown->hideEmptyFolders();

# Set the default file that is shown if no file or path is selected (initial state)
# The file path must be __relative__ to the root directory above: '/path/to/your/markdown/files'
#
# Default: index.md
#
$treemdown->setDefaultFile('README.md');

# Show/Hide filename suffix
#
# Default: Suffix is shown
#
#$tmd->showFilenameSuffix();
$tmd->hideFilenameSuffix();

# Prettify directory and file names
# This removes all "-" and "_" from the names displayed in the tree
#
# Default: Pretty names are disabled
#
#$tmd->disablePrettyNames();
$tmd->enablePrettyNames();

# [File system options]
#
# Set the patterns for files you want to include
#
# Default: array( '*.md', '*.markdown')
#
$treemdown->setIncludePatterns( array( '*.md', '*.markdown') );

# Set the patterns for files/path you want to exclude
#
# Default: array( '.*' )
#
$treemdown->setExcludePatterns( array( '.*' ) );

$treemdown->display();

Contributions

This application uses the following libraries:

• Parsedown-Extra / ParseDown
• highlight.js
• github markdown stylesheet by Chris Patuzzo
• github ribbon stylesheet by Simon Whitaker
• jQuery