Объект lister

Объекты

Объект lister — похожий на массив (array-like) объект, предназначенный для хранения и обработки списков страниц .

Он доступен в переменной шаблона list:

<ul class="menu">
  {% for item in list.getNearFiles("/blog/index.html") %}
  <li><a href="{{ item.file.path }}">{{ item.meta.title }}</a></li>
  {% endfor %}
</ul>

Поля и методы

tags ( )
Параметры: нет
Возвращает список тегов, отсортированный по названию
sortByMeta ( meta_name, as_number, desc )
Возвращает копию Lister, отсортированную по указанным метаданным
Параметр Тип Зачем
meta_name string Поле метаданных
as_number boolean Числовая сортировка
desc boolean Сортировать в нисходящем порядке
getByPath ( path )
Возвращает страницу по пути на сайте
Параметр Тип Зачем
path string Путь
getByMeta ( meta_name, meta_value )
Возвращает страницу по паре имя/значение метаданных
Параметр Тип Зачем
meta_name string Поле метаданных
meta_value string|number Значение
excludeByMeta ( meta_name, meta_value )
Исключает страницы по паре имя/значение метаданных, возвращает новый Lister
Параметр Тип Зачем
meta_name string Поле метаданных
meta_value string|number Значение
getAllByMeta ( meta_name, meta_value )
Возвращает все страницы с указанным значением метаданных
Параметр Тип Зачем
meta_name string Поле метаданных
meta_value string|number Значение
getAllWithMeta ( meta_name )
Возвращает все страницы, содержащие указанные метаданные
Параметр Тип Зачем
meta_name string Поле метаданных
getAllFiles ( page )
Возвращает все страницы ниже указанного пути (не включая теги, виртуальные и индексные страницы)
Параметр Тип Зачем
page string Путь или объект page
getAllDirs ( page )
Возвращает все индексные страницы (директории) ниже указанного пути
Параметр Тип Зачем
page string Путь или объект page
getNearFiles ( page )
Возвращает все страницы в той же директории, что и указанный путь
Параметр Тип Зачем
page string Путь или объект page
getNearDirs ( page )
Возвращает все индексные страницы (директории) в директории указанного пути
Параметр Тип Зачем
page string Путь или объект page
getParent ( page )
Возвращает ближайший индексный файл выше по дереву директорий
Параметр Тип Зачем
page string Путь или объект page
getBreadcrumbs ( page, skip )
Возвращает "хлебные крошки", директории без индексных файлов пропускаются. Второй параметр определяет, сколько директорий пропустить
Параметр Тип Зачем
page string Путь или объект page
skip number Количество пропускаемых директорий
forEach ( fn )
Стандартный forEach()
Параметр Тип Зачем
fn function Функция, выполняемая для каждого элемента
map ( fn )
Стандартный  map()
Параметр Тип Зачем
fn function Функция, выполняемая для каждого элемента
slice ( start, end )
Стандартный slice() (возвращает массив)
Параметр Тип Зачем
start number Начальный индекс
end number Конечный индекс
sort ( fn )
Возвращает отсортированную копию.
Параметр Тип Зачем
fn function функция сортировки
length
Параметры: нет
Поле length — количество элементов.
replace ( array )
Заменяет текущий список новым и возвращает новый Lister
Параметр Тип Зачем
array array Массив страниц
append ( array )
Добавляет список к текущему Lister, возвращает новый Lister
Параметр Тип Зачем
array array Массив страниц
unwrap ( )
Параметры: нет
Возвращает исходный массив страниц