Subversion Repositories Applications.papyrus

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
248 jpm 1
<?php
2
 
3
/**
4
*
5
* Parse for links to wiki pages.
6
*
7
* Wiki page names are typically in StudlyCapsStyle made of
8
* WordsSmashedTogether.
9
*
10
* You can also create described links to pages in this style:
11
* [WikiPageName nice text link to use for display]
12
*
13
* The token options for this rule are:
14
*
15
* 'page' => the wiki page name.
16
*
17
* 'text' => the displayed link text.
18
*
19
* 'anchor' => a named anchor on the target wiki page.
20
*
21
* $Id: Wikilink.php,v 1.1 2005-01-20 19:43:20 jpm Exp $
22
*
23
* @author Paul M. Jones <pmjones@ciaweb.net>
24
*
25
* @package Text_Wiki
26
*
27
*/
28
 
29
class Text_Wiki_Parse_Wikilink extends Text_Wiki_Parse {
30
 
31
 
32
    /**
33
    *
34
    * Constructor.
35
    *
36
    * We override the Text_Wiki_Parse constructor so we can
37
    * explicitly comment each part of the $regex property.
38
    *
39
    * @access public
40
    *
41
    * @param object &$obj The calling "parent" Text_Wiki object.
42
    *
43
    */
44
 
45
    function Text_Wiki_Parse_Wikilink(&$obj)
46
    {
47
        parent::Text_Wiki_Parse($obj);
48
 
49
        // allows numbers as "lowercase letters" in the regex
50
        $this->regex =
51
            "(!?" .                 // START WikiPage pattern (1)
52
            "[A-Z]" .             // 1 upper
53
            "[A-Za-z0-9]*" .     // 0+ alpha or digit
54
            "[a-z0-9]+" .         // 1+ lower or digit
55
            "[A-Z]" .             // 1 upper
56
            "[A-Za-z0-9]*" .     // 0+ or more alpha or digit
57
            ")" .                 // END WikiPage pattern (/1)
58
            "((\#" .             // START Anchor pattern (2)(3)
59
            "[A-Za-z]" .         // 1 alpha
60
            "(" .                 // start sub pattern (4)
61
            "[-A-Za-z0-9_:.]*" . // 0+ dash, alpha, digit, underscore, colon, dot
62
            "[-A-Za-z0-9_]" .     // 1 dash, alpha, digit, or underscore
63
            ")?)?)";             // end subpatterns (/4)(/3)(/2)
64
 
65
    }
66
 
67
 
68
    /**
69
    *
70
    * First parses for described links, then for standalone links.
71
    *
72
    * @access public
73
    *
74
    * @return void
75
    *
76
    */
77
 
78
    function parse()
79
    {
80
        // described wiki links
81
        $tmp_regex = '/\[' . $this->regex . ' (.+?)\]/';
82
        $this->wiki->source = preg_replace_callback(
83
            $tmp_regex,
84
            array(&$this, 'processDescr'),
85
            $this->wiki->source
86
        );
87
 
88
        // standalone wiki links
89
        $tmp_regex = '/(^|[^A-Za-z0-9\-_])' . $this->regex . '/';
90
        $this->wiki->source = preg_replace_callback(
91
            $tmp_regex,
92
            array(&$this, 'process'),
93
            $this->wiki->source
94
        );
95
    }
96
 
97
 
98
    /**
99
    *
100
    * Generate a replacement for described links.
101
    *
102
    * @access public
103
    *
104
    * @param array &$matches The array of matches from parse().
105
    *
106
    * @return A delimited token to be used as a placeholder in
107
    * the source text, plus any text priot to the match.
108
    *
109
    */
110
 
111
    function processDescr(&$matches)
112
    {
113
        // set the options
114
        $options = array(
115
            'page'   => $matches[1],
116
            'text'   => $matches[5],
117
            'anchor' => $matches[3]
118
        );
119
 
120
        // create and return the replacement token and preceding text
121
        return $this->wiki->addToken($this->rule, $options); // . $matches[7];
122
    }
123
 
124
 
125
    /**
126
    *
127
    * Generate a replacement for standalone links.
128
    *
129
    *
130
    * @access public
131
    *
132
    * @param array &$matches The array of matches from parse().
133
    *
134
    * @return A delimited token to be used as a placeholder in
135
    * the source text, plus any text prior to the match.
136
    *
137
    */
138
 
139
    function process(&$matches)
140
    {
141
        // when prefixed with !, it's explicitly not a wiki link.
142
        // return everything as it was.
143
        if ($matches[2]{0} == '!') {
144
            return $matches[1] . substr($matches[2], 1) . $matches[3];
145
        }
146
 
147
        // set the options
148
        $options = array(
149
            'page' => $matches[2],
150
            'text' => $matches[2] . $matches[3],
151
            'anchor' => $matches[3]
152
        );
153
 
154
        // create and return the replacement token and preceding text
155
        return $matches[1] . $this->wiki->addToken($this->rule, $options);
156
    }
157
}
158
?>