XHTMLCompiler/DOMFilter/Acronymizer.php

   1 <?php
   2
   3 /**
   4  * Based on a list of known acronyms, populates of the title attribute
   5  * of acronym and abbr elements in documents.
   6  * @note Title is a bit of legacy baggage.
   7  */
   8 class XHTMLCompiler_DOMFilter_Acronymizer extends XHTMLCompiler_DOMFilter
   9 {
  10
  11     protected $name = 'Acronymizer';
  12
  13     /**
  14      * Associative array of recognized abbreviations/initialisms
  15      * @note To be used when each letter should be spelled out, such
  16      *       as HTML.
  17      */
  18     protected $abbreviations = array(
  19         // markup languages and related technologies
  20         'SGML' => 'Standard Generalized Markup Language',
  21         'HTML' => 'HyperText Markup Language',
  22         'XHTML' => 'Extensible HyperText Markup Language',
  23         'XML' => 'Extensible Markup Language',
  24         'RSS' => 'Really Simple Syndication',
  25         'DTD' => 'Document Type Definition',
  26         'CSS' => 'Cascading Style Sheets',
  27         // programming/apis
  28         'PHP' => 'PHP: HyperText Preprocessor',
  29         'CMS' => 'Content Management System',
  30         'API' => 'Application Programming Interface',
  31         'SVN' => 'Subversion',
  32         'XSLT' => 'Extensible Stylesheet Language Transformations',
  33         'SQL' => 'Structured Query Language',
  34         // web-app security
  35         'XSS' => 'Cross-Site Scripting',
  36         // organizations/groups
  37         'W3C' => 'World Wide Web Consortium',
  38         'RFC' => 'Request for Comment',
  39         'PECL' => 'PHP Extension Community Library',
  40         // character encodings
  41         'UTF-8' => '8-bit Unicode Transformation Format',
  42         // other
  43         'INI' => 'Initialization',
  44         'CPU' => 'Central Processing Unit',
  45         'LGPL' => 'Lesser GNU Public License',
  46         'FTP' => 'File Transfer Protocol',
  47         'URI' => 'Uniform Resource Identifier',
  48     );
  49
  50     /**
  51      * Array of recognized acronyms.
  52      * @note Acronyms can be spoken literally, if in doubt, make it
  53      *       an abbreviation.
  54      * @todo Make a public API for this, allow multiple acronym sets
  55      *       and different precedences for them.
  56      */
  57     protected $acronyms = array(
  58         // programming
  59         'SAX' => 'Simple API for XML',
  60         'DOM' => 'Document Object Module',
  61         'PEAR' => 'PHP Extension and Application Repository',
  62         'ASCII' => 'American Standard Code for Information Interchange',
  63         'SHA-1' => 'Secure Hash Algorithm',
  64         // paradigms
  65         'WYSIWYG' => 'What You See Is What You Get',
  66         'WYSIWYM' => 'What You See Is What You Mean',
  67     );
  68
  69     public function process(DOMDocument $dom, $page, $manager) {
  70         $nodes = $this->query("//html:acronym[not(@title)]");
  71         foreach ($nodes as $node) $this->addAdvisoryTitle($node, $this->acronyms);
  72
  73         $nodes = $this->query("//html:abbr[not(@title)]");
  74         foreach ($nodes as $node) $this->addAdvisoryTitle($node, $this->abbreviations);
  75
  76         // add self as dependency; when acronym lists change, so does the page
  77         $manager->addDependency(__FILE__);
  78     }
  79
  80     protected function addAdvisoryTitle($node, $lookup) {
  81         $key = $node->textContent;
  82         if (!isset($lookup[$key])) {
  83             // not fatal, but good to let the document author know
  84             trigger_error(htmlspecialchars($key) .
  85                 ' is not a recognized acronym/abbreviation (missing title attribute)');
  86             return;
  87         }
  88         $node->setAttribute('title', $lookup[$key]);
  89     }
  90
  91 }
  92
  93 ?>