PEAR2_Text_Markdown › PEAR2_Text_Markdown-0.1.0/php/PEAR2/Text/Markdown/Apidoc/VariableList.php

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
<?php
/**
 * 
 * Block class to form definition lists.
 * 
 * Syntax is ...
 * 
 *     term
 *     : definition
 *     
 *     term1
 *     term2
 *     : definition
 *     
 *     term
 *     : definition 1
 *     : definition 2
 * 
 * @category Solar
 * 
 * @package Markdown_Apidoc
 * 
 * @author Paul M. Jones <pmjones@solarphp.com>
 * 
 * @license http://opensource.org/licenses/bsd-license.php BSD
 * 
 * @version $Id: VariableList.php 4600 2010-06-16 03:27:55Z pmjones $
 * 
 */
namespace PEAR2\Text;

class Markdown_Apidoc_VariableList extends Markdown_Extra_DefList
{
    /**
     * 
     * The tag to open a variable-list term.
     * 
     * @var string
     * 
     */
    protected $_dt_open = "<term>";
    
    /**
     * 
     * The tag to close a variable-list term.
     * 
     * @var string
     * 
     */
    protected $_dt_close = "</term>";
    
    /**
     * 
     * The tag to open a variable-list item.
     * 
     * @var string
     * 
     */
    protected $_dd_open = "<listitem><para>";
    
    /**
     * 
     * The tag to close a variable-list item.
     * 
     * @var string
     * 
     */
    protected $_dd_close = "</para></listitem>";
    
    /**
     * 
     * Support callback for variable lists.
     * 
     * @param array $matches Matches from preg_replace_callback().
     * 
     * @return string The replacement text.
     * 
     */
    protected function _parse($matches)
    {
        $list   = $matches[1];
        $result = trim($this->_processItems($list));
        $result = "<variablelist>\n\n<varlistentry>\n"
                . $result
                . "\n</varlistentry>\n\n</variablelist>";
        return $this->_toHtmlToken($result) . "\n\n";
    }
    
    /**
     * 
     * Process the contents of a definition list, splitting it into
     * individual list items.
     * 
     * @param string $list_str The source text of the list block.
     * 
     * @return string The replacement text.
     * 
     */
    protected function _processItems($list_str)
    {
        // trim trailing blank lines:
        $list_str = preg_replace("/\n{2,}\\z/", "\n", $list_str);
        
        // process terms and items
        $list_str = parent::_processItems($list_str);
        
        // wrap the entry blocks (i.e., each block of 1+ terms with 1+ items)
        $list_str = str_replace(
            "</listitem>\n\n<term>",
            "</listitem>\n</varlistentry>\n\n<varlistentry>\n<term>",
            $list_str
        );
        
        return $list_str;
    }
}
EOF