Changeset 861

Timestamp:

09/12/2014 10:52:07 PM (12 years ago)

Author:

coffee2code

Message:

Code Reference: improve output formatting and styling for hash style parameters

Location:

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer

Files:

• inc/template-tags.php (modified) (1 diff)
• scss/main.scss (modified) (1 diff)
• stylesheets/main.css (modified) (1 diff)

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/inc/template-tags.php

@@ -882 +882 @@
                         return $text;
                 }
-                $text = trim( substr( $text, 1, -1 ) );
-                $text = str_replace( '@type', "<br \>@type", $text );
-                return $text;
+
+                $new_text = '';
+                $text     = trim( substr( $text, 1, -1 ) );
+                $text     = str_replace( '@type', "\n@type", $text );
+
+                $in_list = false;
+                $parts = explode( "\n", $text );
+                foreach ( $parts as $part ) {
+                        $part = preg_replace( '/\s+/', ' ', $part );
+                        list( $wordtype, $type, $name, $description ) = explode( ' ', $part, 4 );
+
+                        if ( '@type' != $wordtype ) {
+                                if ( $in_list ) {
+                                        $in_list = false;
+                                        $new_text .= "</li></ul>\n";
+                                }
+
+                                $new_text .= $part;
+                        } else {
+                                if ( $in_list ) {
+                                        $new_text .= '<li>';
+                                } else {
+                                        $new_text .= '<ul class="param-hash"><li>';
+                                        $in_list = true;
+                                }
+
+                                $new_text .= "<b>'" . substr( $name, 1 ) . "'</b><br /><i><span class='type'>({$type})</span></i> {$description}</li>\n";
+                        }
+                }
+
+                if ( $in_list ) {
+                        $new_text .= "</li></ul>\n";
+                }
+
+                return $new_text;
         }
 

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/scss/main.scss

@@ -905 +905 @@
                                 }
                         }
+                        .param-hash {
+                                margin-left: 1.2em;
+                                margin-bottom: 0.5em;
+                        }
                 }
                 .learn-more {

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/stylesheets/main.css

@@ -1111 +1111 @@
   font-style: italic;
 }
+.devhub-wrap .wp-parser-class .parameters .param-hash, .devhub-wrap .wp-parser-function .parameters .param-hash, .devhub-wrap .wp-parser-hook .parameters .param-hash, .devhub-wrap .wp-parser-method .parameters .param-hash {
+  margin-left: 1.2em;
+  margin-bottom: 0.5em;
+}
 .devhub-wrap .wp-parser-class .learn-more, .devhub-wrap .wp-parser-function .learn-more, .devhub-wrap .wp-parser-hook .learn-more, .devhub-wrap .wp-parser-method .learn-more {
   background-color: #f1f1f1;