README.ru.md

toc-md

Создает оглавление для markdown-файлов.

Приложение может быть использовано для английского и русского языков.

Установка

$ npm install toc-md

Использование

Добавьте HTML-комментарий <!-- TOC --> в markdown-файл.

Оглавление будет создано в этом месте для последующих заголовков.

API

var toc = require('toc-md');

toc.insert

@param {String} - исходный текст, в который необходимо добавить оглавление (обязательно должен содержать HTML-комментарий <!--TOC-->)
@param {Object} - опции:

• maxDepth: Number - toc-md будет использовать заголовки, вложенность которых не больше указанного значения (по умолчанию: 6).

@param {Function} - callback

toc.clean

@param {String} - исходный текст, который необходимо очистить от оглавления
@param {Function} - callback

Пример

var fs = require('fs'),
    toc = require('toc-md');

var source = fs.readFileSync('markdown-без-оглавления.md', 'utf-8');

var options = {
    maxDepth: 6
};

toc.insert(source, options, function (err, res) {
    if (err) {
        console.log(err);
    } else {
        fs.writeFileSync('markdown-с-оглавлением.md', res);
    }
});

source = fs.readFileSync('markdown-с-оглавлением.md', 'utf-8');

toc.clean(source, function (err, res) {
    if (err) {
        console.log(err);
    } else {
        fs.writeFileSync('markdown-без-оглавления.md', res);
    }
});

CLI

$ toc-md --help
Создает оглавление для markdown-файлов

Использование:
  toc-md [ОПЦИИ] [АРГУМЕНТЫ]

Опции:
  -h, --help : Помощь
  -v, --version : Показывает номер версии
  -m MAXDEPTH, --max-depth=MAXDEPTH : Использует заголовки, вложенность которых не больше указанного значения (по умолчанию: 6)
  -c, --clean : Очищает оглавление

Arguments:
  SOURCE : Путь к входному markdown-файлу (он должен содержать HTML-комментарий <!-- TOC -->) (обязательный аргумент)
  TARGET : Путь к выходному markdown-файлу

Если аргумент TARGET не указан, то результат будет записан в SOURCE.

Пример

Добавление оглавления

$ toc-md путь/к/входному/markdown-файлу путь/к/выходному/markdown-файлу --max-depth=4

$ toc-md путь/к/markdown-файлу -m 4

Очистка оглавления

$ toc-md путь/к/входному/markdown-файлу путь/к/выходному/markdown-файлу --clean

$ toc-md путь/к/markdown-файлу -c