pft-ls man page

pft ls — List objects in your PFT site

Synopsys

pft ls <class> [options] pft ls --help

Description

List objects.

The general usage provides a class of objects to lists. For instance

pft ls tags

Will list all the tags from all pages and entries.

Classes

A number of possible classes can be specified. Here follows a list with a short description, while better details can be found in the main "pft" manpage ("man pft").

pages
List all regular pages in "ROOT/content/pages".

This class supports the "--pretty" argument.
blog
List all blog pages in "ROOT/content/blog". This includes daily entries and monthly entries

This class supports the "--pretty" argument.
tags
Scan through all entries and list all used tags.

This class supports the "--count" argument. If supplied the tag usage count is also reported.
tagpages
List all tag pages, that is pages describing tags.

This class supports the "--pretty" argument.

Options

--count
Count the listed items.
--help | -h
Show this help.
--locate

Show paths and titles, namely quick alias for:

--pretty='%h:%t'
--pretty=<fmt>

%t → Title

%p → Path

%g → Comma separated value of tags

%a → Author

%o → Comma separated value of option=value pairs

%D → Date in yyyy-mm-dd format if dated, empty string otherwise

%y → Year if dated, empty string otherwise

%m → Month if dated, empty string otherwise

%d → Day if dated, empty string otherwise

Info

2016-09-03 perl v5.24.0 User Contributed Perl Documentation