Объект 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
(
)
Параметры: нет
Возвращает исходный массив страниц