source/libvpx/examples/includes/PHP-SmartyPants-1.5.1e/smartypants.php - Issue 148913004: libvpx: Pull from upstream

Side by Side Diff: source/libvpx/examples/includes/PHP-SmartyPants-1.5.1e/smartypants.php

Issue 148913004: libvpx: Pull from upstream (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/deps/third_party/libvpx/

Patch Set: Created 6 years, 10 months ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

View unified diff | Download patch | Annotate | Revision Log

« no previous file with comments | « source/libvpx/examples/includes/PHP-Markdown-Extra-1.2.3/markdown.php ('k') | source/libvpx/examples/includes/geshi/contrib/aliased.php » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Hide Comments ('s')

OLD	NEW
	(Empty)
1 <?php

2

3 #

4 # SmartyPants - Smart punctuation for web sites

5 #

6 # by John Gruber

7 # <http://daringfireball.net>

8 #

9 # PHP port by Michel Fortin

10 # <http://www.michelf.com/>

11 #

12 # Copyright (c) 2003-2004 John Gruber

13 # Copyright (c) 2004-2005 Michel Fortin

14 #

15

16

17 global $SmartyPantsPHPVersion, $SmartyPantsSyntaxVersion,

18 $smartypants_attr, $sp_tags_to_skip;

19

20 $SmartyPantsPHPVersion = '1.5.1e'; # Fru 9 Dec 2005

21 $SmartyPantsSyntaxVersion = '1.5.1'; # Fri 12 Mar 2004

22

23

24 # Configurable variables:

25 $smartypants_attr = "1"; # Change this to configure.

26 # 1 => "--" for em-dashes; no en-dash support

27 # 2 => "---" for em-dashes; "--" for en-dashes

28 # 3 => "--" for em-dashes; "---" for en-dashes

29 # See docs for more configuration options.

30

31 # Globals:

32 $sp_tags_to_skip = '<(/?)(?:pre\|code\|kbd\|script\|math)[\s>]';

33

34

35 # -- WordPress plugin interface -----------------------------------------------

36 /*

37 Plugin Name: SmartyPants

38 Plugin URI: http://www.michelf.com/projects/php-smartypants/

39 Description: SmartyPants is a web publishing utility that translates plain ASCII punctuation characters into “smart” typographic punctuation HTML en tities. This plugin <strong>replace the default WordPress Texturize algorithm</s trong> for the content and the title of your posts, the comments body and author name, and everywhere else Texturize normally apply. Based on the original Perl version by <a href="http://daringfireball.net/">John Gruber</a>.

40 Version: 1.5.1e

41 Author: Michel Fortin

42 Author URI: http://www.michelf.com/

43 */

44 if (isset($wp_version)) {

45 # Remove default Texturize filter that would conflict with SmartyPants.

46 remove_filter('category_description', 'wptexturize');

47 remove_filter('list_cats', 'wptexturize');

48 remove_filter('comment_author', 'wptexturize');

49 remove_filter('comment_text', 'wptexturize');

50 remove_filter('single_post_title', 'wptexturize');

51 remove_filter('the_title', 'wptexturize');

52 remove_filter('the_content', 'wptexturize');

53 remove_filter('the_excerpt', 'wptexturize');

54 # Add SmartyPants filter with priority 10 (same as Texturize).

55 add_filter('category_description', 'SmartyPants', 10);

56 add_filter('list_cats', 'SmartyPants', 10);

57 add_filter('comment_author', 'SmartyPants', 10);

58 add_filter('comment_text', 'SmartyPants', 10);

59 add_filter('single_post_title', 'SmartyPants', 10);

60 add_filter('the_title', 'SmartyPants', 10);

61 add_filter('the_content', 'SmartyPants', 10);

62 add_filter('the_excerpt', 'SmartyPants', 10);

63 }

64

65 # -- Smarty Modifier Interface ------------------------------------------------

66 function smarty_modifier_smartypants($text, $attr = NULL) {

67 return SmartyPants($text, $attr);

68 }

69

70

71

72 function SmartyPants($text, $attr = NULL, $ctx = NULL) {

73 global $smartypants_attr, $sp_tags_to_skip;

74 # Paramaters:

75 $text; # text to be parsed

76 $attr; # value of the smart_quotes="" attribute

77 $ctx; # MT context object (unused)

78 if ($attr == NULL) $attr = $smartypants_attr;

79

80 # Options to specify which transformations to make:

81 $do_stupefy = FALSE;

82 $convert_quot = 0; # should we translate " entities into normal quotes ?

83

84 # Parse attributes:

85 # 0 : do nothing

86 # 1 : set all

87 # 2 : set all, using old school en- and em- dash shortcuts

88 # 3 : set all, using inverted old school en and em- dash shortcuts

89 #

90 # q : quotes

91 # b : backtick quotes (``double'' only)

92 # B : backtick quotes (``double'' and `single')

93 # d : dashes

94 # D : old school dashes

95 # i : inverted old school dashes

96 # e : ellipses

97 # w : convert " entities to " for Dreamweaver users

98

99 if ($attr == "0") {

100 # Do nothing.

101 return $text;

102 }

103 else if ($attr == "1") {

104 # Do everything, turn all options on.

105 $do_quotes = 1;

106 $do_backticks = 1;

107 $do_dashes = 1;

108 $do_ellipses = 1;

109 }

110 else if ($attr == "2") {

111 # Do everything, turn all options on, use old school dash shorthand.

112 $do_quotes = 1;

113 $do_backticks = 1;

114 $do_dashes = 2;

115 $do_ellipses = 1;

116 }

117 else if ($attr == "3") {

118 # Do everything, turn all options on, use inverted old school dash short hand.

119 $do_quotes = 1;

120 $do_backticks = 1;

121 $do_dashes = 3;

122 $do_ellipses = 1;

123 }

124 else if ($attr == "-1") {

125 # Special "stupefy" mode.

126 $do_stupefy = 1;

127 }

128 else {

129 $chars = preg_split('//', $attr);

130 foreach ($chars as $c){

131 if ($c == "q") { $do_quotes = 1; }

132 else if ($c == "b") { $do_backticks = 1; }

133 else if ($c == "B") { $do_backticks = 2; }

134 else if ($c == "d") { $do_dashes = 1; }

135 else if ($c == "D") { $do_dashes = 2; }

136 else if ($c == "i") { $do_dashes = 3; }

137 else if ($c == "e") { $do_ellipses = 1; }

138 else if ($c == "w") { $convert_quot = 1; }

139 else {

140 # Unknown attribute option, ignore.

141 }

142 }

143 }

144

145 $tokens = _TokenizeHTML($text);

146 $result = '';

147 $in_pre = 0; # Keep track of when we're inside <pre> or <code> tags.

148

149 $prev_token_last_char = ""; # This is a cheat, used to get some context

150 # for one-character tokens that consist of

151 # just a quote char. What we do is remember

152 # the last character of the previous text

153 # token, to use as context to curl single-

154 # character quote tokens correctly.

155

156 foreach ($tokens as $cur_token) {

157 if ($cur_token[0] == "tag") {

158 # Don't mess with quotes inside tags.

159 $result .= $cur_token[1];

160 if (preg_match("@$sp_tags_to_skip@", $cur_token[1], $matches)) {

161 $in_pre = isset($matches[1]) && $matches[1] == '/' ? 0 : 1;

162 }

163 } else {

164 $t = $cur_token[1];

165 $last_char = substr($t, -1); # Remember last char of this token befo re processing.

166 if (! $in_pre) {

167 $t = ProcessEscapes($t);

168

169 if ($convert_quot) {

170 $t = preg_replace('/"/', '"', $t);

171 }

172

173 if ($do_dashes) {

174 if ($do_dashes == 1) $t = EducateDashes($t);

175 if ($do_dashes == 2) $t = EducateDashesOldSchool($t);

176 if ($do_dashes == 3) $t = EducateDashesOldSchoolInverted($t) ;

177 }

178

179 if ($do_ellipses) $t = EducateEllipses($t);

180

181 # Note: backticks need to be processed before quotes.

182 if ($do_backticks) {

183 $t = EducateBackticks($t);

184 if ($do_backticks == 2) $t = EducateSingleBackticks($t);

185 }

186

187 if ($do_quotes) {

188 if ($t == "'") {

189 # Special case: single-character ' token

190 if (preg_match('/\S/', $prev_token_last_char)) {

191 $t = "’";

192 }

193 else {

194 $t = "‘";

195 }

196 }

197 else if ($t == '"') {

198 # Special case: single-character " token

199 if (preg_match('/\S/', $prev_token_last_char)) {

200 $t = "”";

201 }

202 else {

203 $t = "“";

204 }

205 }

206 else {

207 # Normal case:

208 $t = EducateQuotes($t);

209 }

210 }

211

212 if ($do_stupefy) $t = StupefyEntities($t);

213 }

214 $prev_token_last_char = $last_char;

215 $result .= $t;

216 }

217 }

218

219 return $result;

220 }

221

222

223 function SmartQuotes($text, $attr = NULL, $ctx = NULL) {

224 global $smartypants_attr, $sp_tags_to_skip;

225 # Paramaters:

226 $text; # text to be parsed

227 $attr; # value of the smart_quotes="" attribute

228 $ctx; # MT context object (unused)

229 if ($attr == NULL) $attr = $smartypants_attr;

230

231 $do_backticks; # should we educate ``backticks'' -style quotes?

232

233 if ($attr == 0) {

234 # do nothing;

235 return $text;

236 }

237 else if ($attr == 2) {

238 # smarten ``backticks'' -style quotes

239 $do_backticks = 1;

240 }

241 else {

242 $do_backticks = 0;

243 }

244

245 # Special case to handle quotes at the very end of $text when preceded by

246 # an HTML tag. Add a space to give the quote education algorithm a bit of

247 # context, so that it can guess correctly that it's a closing quote:

248 $add_extra_space = 0;

249 if (preg_match("/>['\"]\\z/", $text)) {

250 $add_extra_space = 1; # Remember, so we can trim the extra space later.

251 $text .= " ";

252 }

253

254 $tokens = _TokenizeHTML($text);

255 $result = '';

256 $in_pre = 0; # Keep track of when we're inside <pre> or <code> tags

257

258 $prev_token_last_char = ""; # This is a cheat, used to get some context

259 # for one-character tokens that consist of

260 # just a quote char. What we do is remember

261 # the last character of the previous text

262 # token, to use as context to curl single-

263 # character quote tokens correctly.

264

265 foreach ($tokens as $cur_token) {

266 if ($cur_token[0] == "tag") {

267 # Don't mess with quotes inside tags

268 $result .= $cur_token[1];

269 if (preg_match("@$sp_tags_to_skip@", $cur_token[1], $matches)) {

270 $in_pre = isset($matches[1]) && $matches[1] == '/' ? 0 : 1;

271 }

272 } else {

273 $t = $cur_token[1];

274 $last_char = substr($t, -1); # Remember last char of this token befo re processing.

275 if (! $in_pre) {

276 $t = ProcessEscapes($t);

277 if ($do_backticks) {

278 $t = EducateBackticks($t);

279 }

280

281 if ($t == "'") {

282 # Special case: single-character ' token

283 if (preg_match('/\S/', $prev_token_last_char)) {

284 $t = "’";

285 }

286 else {

287 $t = "‘";

288 }

289 }

290 else if ($t == '"') {

291 # Special case: single-character " token

292 if (preg_match('/\S/', $prev_token_last_char)) {

293 $t = "”";

294 }

295 else {

296 $t = "“";

297 }

298 }

299 else {

300 # Normal case:

301 $t = EducateQuotes($t);

302 }

303

304 }

305 $prev_token_last_char = $last_char;

306 $result .= $t;

307 }

308 }

309

310 if ($add_extra_space) {

311 preg_replace('/ \z/', '', $result); # Trim trailing space if we added o ne earlier.

312 }

313 return $result;

314 }

315

316

317 function SmartDashes($text, $attr = NULL, $ctx = NULL) {

318 global $smartypants_attr, $sp_tags_to_skip;

319 # Paramaters:

320 $text; # text to be parsed

321 $attr; # value of the smart_dashes="" attribute

322 $ctx; # MT context object (unused)

323 if ($attr == NULL) $attr = $smartypants_attr;

324

325 # reference to the subroutine to use for dash education, default to EducateD ashes:

326 $dash_sub_ref = 'EducateDashes';

327

328 if ($attr == 0) {

329 # do nothing;

330 return $text;

331 }

332 else if ($attr == 2) {

333 # use old smart dash shortcuts, "--" for en, "---" for em

334 $dash_sub_ref = 'EducateDashesOldSchool';

335 }

336 else if ($attr == 3) {

337 # inverse of 2, "--" for em, "---" for en

338 $dash_sub_ref = 'EducateDashesOldSchoolInverted';

339 }

340

341 $tokens;

342 $tokens = _TokenizeHTML($text);

343

344 $result = '';

345 $in_pre = 0; # Keep track of when we're inside <pre> or <code> tags

346 foreach ($tokens as $cur_token) {

347 if ($cur_token[0] == "tag") {

348 # Don't mess with quotes inside tags

349 $result .= $cur_token[1];

350 if (preg_match("@$sp_tags_to_skip@", $cur_token[1], $matches)) {

351 $in_pre = isset($matches[1]) && $matches[1] == '/' ? 0 : 1;

352 }

353 } else {

354 $t = $cur_token[1];

355 if (! $in_pre) {

356 $t = ProcessEscapes($t);

357 $t = $dash_sub_ref($t);

358 }

359 $result .= $t;

360 }

361 }

362 return $result;

363 }

364

365

366 function SmartEllipses($text, $attr = NULL, $ctx = NULL) {

367 # Paramaters:

368 $text; # text to be parsed

369 $attr; # value of the smart_ellipses="" attribute

370 $ctx; # MT context object (unused)

371 if ($attr == NULL) $attr = $smartypants_attr;

372

373 if ($attr == 0) {

374 # do nothing;

375 return $text;

376 }

377

378 $tokens;

379 $tokens = _TokenizeHTML($text);

380

381 $result = '';

382 $in_pre = 0; # Keep track of when we're inside <pre> or <code> tags

383 foreach ($tokens as $cur_token) {

384 if ($cur_token[0] == "tag") {

385 # Don't mess with quotes inside tags

386 $result .= $cur_token[1];

387 if (preg_match("@$sp_tags_to_skip@", $cur_token[1], $matches)) {

388 $in_pre = isset($matches[1]) && $matches[1] == '/' ? 0 : 1;

389 }

390 } else {

391 $t = $cur_token[1];

392 if (! $in_pre) {

393 $t = ProcessEscapes($t);

394 $t = EducateEllipses($t);

395 }

396 $result .= $t;

397 }

398 }

399 return $result;

400 }

401

402

403 function EducateQuotes($_) {

404 #

405 # Parameter: String.

406 #

407 # Returns: The string, with "educated" curly quote HTML entities.

408 #

409 # Example input: "Isn't this fun?"

410 # Example output: “Isn’t this fun?”

411 #

412 # Make our own "punctuation" character class, because the POSIX-style

413 # [:PUNCT:] is only available in Perl 5.6 or later:

414 $punct_class = "[!\"#\\$\\%'()*+,-.\\/:;<=>?\\@\\[\\\\\]\\^_`{\|}~]";

415

416 # Special case if the very first character is a quote

417 # followed by punctuation at a non-word-break. Close the quotes by brute for ce:

418 $_ = preg_replace(

419 array("/^'(?=$punct_class\\B)/", "/^\"(?=$punct_class\\B)/"),

420 array('’', '”'), $_);

421

422

423 # Special case for double sets of quotes, e.g.:

424 # <p>He said, "'Quoted' words in a larger quote."</p>

425 $_ = preg_replace(

426 array("/\"'(?=\w)/", "/'\"(?=\w)/"),

427 array('“‘', '‘“'), $_);

428

429 # Special case for decade abbreviations (the '80s):

430 $_ = preg_replace("/'(?=\\d{2}s)/", '’', $_);

431

432 $close_class = '[^\ \t\r\n\[\{\(\-]';

433 $dec_dashes = '&\#8211;\|&\#8212;';

434

435 # Get most opening single quotes:

436 $_ = preg_replace("{

437 (

438 \\s \| # a whitespace char, or

439   \| # a non-breaking space entity, or

440 -- \| # dashes, or

441 &[mn]dash; \| # named dash entities

442 $dec_dashes \| # or decimal entities

443 &\\#x201[34]; # or hex

444 )

445 ' # the quote

446 (?=\\w) # followed by a word character

447 }x", '\1‘', $_);

448 # Single closing quotes:

449 $_ = preg_replace("{

450 ($close_class)?

451 '

452 (?(1)\| # If $1 captured, then do nothing;

453 (?=\\s \| s\\b) # otherwise, positive lookahead for a whitespace

454 ) # char or an 's' at a word ending position. This

455 # is a special case to handle something like:

456 # \"<i>Custer</i>'s Last Stand.\"

457 }xi", '\1’', $_);

458

459 # Any remaining single quotes should be opening ones:

460 $_ = str_replace("'", '‘', $_);

461

462

463 # Get most opening double quotes:

464 $_ = preg_replace("{

465 (

466 \\s \| # a whitespace char, or

467   \| # a non-breaking space entity, or

468 -- \| # dashes, or

469 &[mn]dash; \| # named dash entities

470 $dec_dashes \| # or decimal entities

471 &\\#x201[34]; # or hex

472 )

473 \" # the quote

474 (?=\\w) # followed by a word character

475 }x", '\1“', $_);

476

477 # Double closing quotes:

478 $_ = preg_replace("{

479 ($close_class)?

480 \"

481 (?(1)\|(?=\\s)) # If $1 captured, then do nothing;

482 # if not, then make sure the next char is whitespace.

483 }x", '\1”', $_);

484

485 # Any remaining quotes should be opening ones.

486 $_ = str_replace('"', '“', $_);

487

488 return $_;

489 }

490

491

492 function EducateBackticks($_) {

493 #

494 # Parameter: String.

495 # Returns: The string, with ``backticks'' -style double quotes

496 # translated into HTML curly quote entities.

497 #

498 # Example input: ``Isn't this fun?''

499 # Example output: “Isn't this fun?”

500 #

501

502 $_ = str_replace(array("``", "''",),

503 array('“', '”'), $_);

504 return $_;

505 }

506

507

508 function EducateSingleBackticks($_) {

509 #

510 # Parameter: String.

511 # Returns: The string, with `backticks' -style single quotes

512 # translated into HTML curly quote entities.

513 #

514 # Example input: `Isn't this fun?'

515 # Example output: ‘Isn’t this fun?’

516 #

517

518 $_ = str_replace(array("`", "'",),

519 array('‘', '’'), $_);

520 return $_;

521 }

522

523

524 function EducateDashes($_) {

525 #

526 # Parameter: String.

527 #

528 # Returns: The string, with each instance of "--" translated to

529 # an em-dash HTML entity.

530 #

531

532 $_ = str_replace('--', '—', $_);

533 return $_;

534 }

535

536

537 function EducateDashesOldSchool($_) {

538 #

539 # Parameter: String.

540 #

541 # Returns: The string, with each instance of "--" translated to

542 # an en-dash HTML entity, and each "---" translated to

543 # an em-dash HTML entity.

544 #

545

546 # em en

547 $_ = str_replace(array("---", "--",),

548 array('—', '–'), $_);

549 return $_;

550 }

551

552

553 function EducateDashesOldSchoolInverted($_) {

554 #

555 # Parameter: String.

556 #

557 # Returns: The string, with each instance of "--" translated to

558 # an em-dash HTML entity, and each "---" translated to

559 # an en-dash HTML entity. Two reasons why: First, unlike the

560 # en- and em-dash syntax supported by

561 # EducateDashesOldSchool(), it's compatible with existing

562 # entries written before SmartyPants 1.1, back when "--" was

563 # only used for em-dashes. Second, em-dashes are more

564 # common than en-dashes, and so it sort of makes sense that

565 # the shortcut should be shorter to type. (Thanks to Aaron

566 # Swartz for the idea.)

567 #

568

569 # en em

570 $_ = str_replace(array("---", "--",),

571 array('–', '—'), $_);

572 return $_;

573 }

574

575

576 function EducateEllipses($_) {

577 #

578 # Parameter: String.

579 # Returns: The string, with each instance of "..." translated to

580 # an ellipsis HTML entity. Also converts the case where

581 # there are spaces between the dots.

582 #

583 # Example input: Huh...?

584 # Example output: Huh…?

585 #

586

587 $_ = str_replace(array("...", ". . .",), '…', $_);

588 return $_;

589 }

590

591

592 function StupefyEntities($_) {

593 #

594 # Parameter: String.

595 # Returns: The string, with each SmartyPants HTML entity translated to

596 # its ASCII counterpart.

597 #

598 # Example input: “Hello — world.”

599 # Example output: "Hello -- world."

600 #

601

602 # en-dash em-dash

603 $_ = str_replace(array('–', '—'),

604 array('-', '--'), $_);

605

606 # single quote open close

607 $_ = str_replace(array('‘', '’'), "'", $_);

608

609 # double quote open close

610 $_ = str_replace(array('“', '”'), '"', $_);

611

612 $_ = str_replace('…', '...', $_); # ellipsis

613

614 return $_;

615 }

616

617

618 function ProcessEscapes($_) {

619 #

620 # Parameter: String.

621 # Returns: The string, with after processing the following backslash

622 # escape sequences. This is useful if you want to force a "dumb"

623 # quote or other character to appear.

624 #

625 # Escape Value

626 # ------ -----

627 # \\ \

628 # \" "

629 # \' '

630 # \. .

631 # \- -

632 # \` `

633 #

634 $_ = str_replace(

635 array('\\\\', '\"', "\'", '\.', '\-', '\`'),

636 array('\', '"', ''', '.', '-', '`'), $_);

637

638 return $_;

639 }

640

641

642 # _TokenizeHTML is shared between PHP SmartyPants and PHP Markdown.

643 # We only define it if it is not already defined.

644 if (!function_exists('_TokenizeHTML')) :

645 function _TokenizeHTML($str) {

646 #

647 # Parameter: String containing HTML markup.

648 # Returns: An array of the tokens comprising the input

649 # string. Each token is either a tag (possibly with nested,

650 # tags contained therein, such as <a href="<MTFoo>">, or a

651 # run of text between tags. Each element of the array is a

652 # two-element array; the first is either 'tag' or 'text';

653 # the second is the actual value.

654 #

655 #

656 # Regular expression derived from the _tokenize() subroutine in

657 # Brad Choate's MTRegex plugin.

658 # <http://www.bradchoate.com/past/mtregex.php>

659 #

660 $index = 0;

661 $tokens = array();

662

663 $match = '(?s:<!(?:--.?--\s)+>)\|'. # comment

664 '(?s:<\?.*?\?>)\|'. # processing instruction

665 # regular tags

666 '(?:<[/!$]?[-a-zA-Z0-9:]+\b(?>[^"\'>]+\|"[^"]"\|\'[^\']\')*>)';

667

668 $parts = preg_split("{($match)}", $str, -1, PREG_SPLIT_DELIM_CAPTURE);

669

670 foreach ($parts as $part) {

671 if (++$index % 2 && $part != '')

672 $tokens[] = array('text', $part);

673 else

674 $tokens[] = array('tag', $part);

675 }

676 return $tokens;

677 }

678 endif;

679

680

681 /*

682

683 PHP SmartyPants

684 ===============

685

686 Description

687 -----------

688

689 This is a PHP translation of the original SmartyPants quote educator written in

690 Perl by John Gruber.

691

692 SmartyPants is a web publishing utility that translates plain ASCII

693 punctuation characters into "smart" typographic punctuation HTML

694 entities. SmartyPants can perform the following transformations:

695

696 * Straight quotes (`"` and `'`) into "curly" quote HTML entities

697 * Backticks-style quotes (` ``like this'' `) into "curly" quote HTML

698 entities

699 * Dashes (`--` and `---`) into en- and em-dash entities

700 * Three consecutive dots (`...`) into an ellipsis entity

701

702 SmartyPants does not modify characters within `<pre>`, `<code>`, `<kbd>`,

703 `<script>`, or `<math>` tag blocks. Typically, these tags are used to

704 display text where smart quotes and other "smart punctuation" would not

705 be appropriate, such as source code or example markup.

706

707

708 ### Backslash Escapes ###

709

710 If you need to use literal straight quotes (or plain hyphens and

711 periods), SmartyPants accepts the following backslash escape sequences

712 to force non-smart punctuation. It does so by transforming the escape

713 sequence into a decimal-encoded HTML entity:

714

715 Escape Value Character

716 ------ ----- ---------

717 \\ \ \

718 \" " "

719 \' ' '

720 \. . .

721 \- - -

722 \` ` `

723

724 This is useful, for example, when you want to use straight quotes as

725 foot and inch marks: 6'2" tall; a 17" iMac.

726

727

728 Bugs

729 ----

730

731 To file bug reports or feature requests (other than topics listed in the

732 Caveats section above) please send email to:

733

734 <michel.fortin@michelf.com>

735

736 If the bug involves quotes being curled the wrong way, please send example

737 text to illustrate.

738

739

740 ### Algorithmic Shortcomings ###

741

742 One situation in which quotes will get curled the wrong way is when

743 apostrophes are used at the start of leading contractions. For example:

744

745 'Twas the night before Christmas.

746

747 In the case above, SmartyPants will turn the apostrophe into an opening

748 single-quote, when in fact it should be a closing one. I don't think

749 this problem can be solved in the general case -- every word processor

750 I've tried gets this wrong as well. In such cases, it's best to use the

751 proper HTML entity for closing single-quotes (`’`) by hand.

752

753

754 Version History

755 ---------------

756

757 1.5.1e (9 Dec 2005)

758

759 * Corrected a bug that prevented special characters from being

760 escaped.

761

762

763 1.5.1d (25 May 2005)

764

765 * Corrected a small bug in `_TokenizeHTML` where a Doctype declaration

766 was not seen as HTML (smart quotes where applied inside).

767

768

769 1.5.1c (13 Dec 2004)

770

771 * Changed a regular expression in `_TokenizeHTML` that could lead to

772 a segmentation fault with PHP 4.3.8 on Linux.

773

774

775 1.5.1b (6 Sep 2004)

776

777 * Corrected a problem with quotes immediately following a dash

778 with no space between: `Text--"quoted text"--text.`

779

780 * PHP SmartyPants can now be used as a modifier by the Smarty

781 template engine. Rename the file to "modifier.smartypants.php"

782 and put it in your smarty plugins folder.

783

784 * Replaced a lot of space characters by tabs, saving about 4 KB.

785

786

787 1.5.1a (30 Jun 2004)

788

789 * PHP Markdown and PHP Smartypants now share the same `_TokenizeHTML`

790 function when loaded simultanously.

791

792 * Changed the internals of `_TokenizeHTML` to lower the PHP version

793 requirement to PHP 4.0.5.

794

795

796 1.5.1 (6 Jun 2004)

797

798 * Initial release of PHP SmartyPants, based on version 1.5.1 of the

799 original SmartyPants written in Perl.

800

801

802 Author

803 ------

804

805 John Gruber

806 <http://daringfireball.net/>

807

808 Ported to PHP by Michel Fortin

809 <http://www.michelf.com/>

810

811

812 Additional Credits

813 ------------------

814

815 Portions of this plug-in are based on Brad Choate's nifty MTRegex plug-in.

816 Brad Choate also contributed a few bits of source code to this plug-in.

817 Brad Choate is a fine hacker indeed. (<http://bradchoate.com/>)

818

819 Jeremy Hedley (<http://antipixel.com/>) and Charles Wiltgen

820 (<http://playbacktime.com/>) deserve mention for exemplary beta testing.

821

822

823 Copyright and License

824 ---------------------

825

826 Copyright (c) 2003 John Gruber

827 <http://daringfireball.net/>

828 All rights reserved.

829

830 Copyright (c) 2004-2005 Michel Fortin

831 <http://www.michelf.com>

832

833 Redistribution and use in source and binary forms, with or without

834 modification, are permitted provided that the following conditions are met:

835

836 * Redistributions of source code must retain the above copyright

837 notice, this list of conditions and the following disclaimer.

838

839 * Redistributions in binary form must reproduce the above copyright

840 notice, this list of conditions and the following disclaimer in the

841 documentation and/or other materials provided with the distribution.

842

843 * Neither the name "SmartyPants" nor the names of its contributors may

844 be used to endorse or promote products derived from this software

845 without specific prior written permission.

846

847 This software is provided by the copyright holders and contributors "as is"

848 and any express or implied warranties, including, but not limited to, the

849 implied warranties of merchantability and fitness for a particular purpose

850 are disclaimed. In no event shall the copyright owner or contributors be

851 liable for any direct, indirect, incidental, special, exemplary, or

852 consequential damages (including, but not limited to, procurement of

853 substitute goods or services; loss of use, data, or profits; or business

854 interruption) however caused and on any theory of liability, whether in

855 contract, strict liability, or tort (including negligence or otherwise)

856 arising in any way out of the use of this software, even if advised of the

857 possibility of such damage.

858

859 */

860 ?>

OLD	NEW