NAME

       Pandoc::Selector - Pandoc document selector language

SYNOPSIS

         my $selector = Pandoc::Selector->new('Code.perl|CodeBlock.perl');

         # check whether an element matches
         $selector->match($element);

         # use as element method
         $element->match('Code.perl|CodeBlock.perl')

DESCRIPTION

       Pandoc::Selector provides a language to select elements of a Pandoc document.  It borrows
       ideas from CSS Selectors <https://www.w3.org/TR/selectors-3/>, XPath
       <https://www.w3.org/TR/xpath/> and similar languages.

       The language is being developed together with this implementation.

EXAMPLES

         Header#main
         Code.perl
         Code.perl.raw
         :inline

SELECTOR GRAMMAR

       Whitespace between parts of the syntax is optional and not included in the following
       grammar. A Selector is a list of one or more expression lists separated by pipes ("|").
       For instance the selector "Subscript|Superscript" selects both Subscript elements and
       Superscript elements.

         Selector        ::= ExpressionList ( '|' ExpressionList )*

       An expression list is a list of one or more expressions:

         ExpressionList  ::= Expression ( Expression )*

       An expression is any of name expression, id expression, class expression, and type
       expression.

         Expression      ::= NameExpression
                             | IdExpression
                             | ClassExpression
                             | TypeExpression

         NameExpression  ::= Name

         Name            ::= [A-Za-z]+

         IdExpression    ::= '#' [\p{L}\p{N}_-]+

         ClassExpression ::= '.' [\p{L}\p{N}_-]+

         TypeExpression  ::= ':' Name

SEE ALSO

       See example filter "select" to select parts of a document.