Class: RDoc::Markup::AttributeManager
- Inherits:
-
Object
- Object
- RDoc::Markup::AttributeManager
- Defined in:
- lib/rdoc/markup/attribute_manager.rb
Constant Summary collapse
- NULL =
"\000".freeze
- A_PROTECT =
We work by substituting non-printing characters in to the text. For now I’m assuming that I can substitute a character in the range 0..8 for a 7 bit character without damaging the encoded string, but this might be optimistic
004
- PROTECT_ATTR =
A_PROTECT.chr
- MATCHING_WORD_PAIRS =
This maps delimiters that occur around words (such as bold or
tt
) where the start and end delimiters and the same. This lets us optimize the regexp {}
- WORD_PAIR_MAP =
And this is used when the delimiters aren’t the same. In this case the hash maps a pattern to the attribute character
{}
- HTML_TAGS =
This maps HTML tags to the corresponding attribute char
{}
- SPECIAL =
And this maps special sequences to a name. A special sequence is something like a WikiWord
{}
- PROTECTABLE =
A \ in front of a character that would normally be processed turns off processing. We do this by turning < into <#PROTECT
%w[<\\]
Instance Method Summary collapse
- #add_html(tag, name) ⇒ Object
- #add_special(pattern, name) ⇒ Object
- #add_word_pair(start, stop, name) ⇒ Object
-
#attribute(turn_on, turn_off) ⇒ Object
Return an attribute object with the given turn_on and turn_off bits set.
- #change_attribute(current, new) ⇒ Object
- #changed_attribute_by_name(current_set, new_set) ⇒ Object
-
#convert_attrs(str, attrs) ⇒ Object
Map attributes like textto the sequence 001002<char>001003<char>, where <char> is a per-attribute specific character.
- #convert_html(str, attrs) ⇒ Object
- #convert_specials(str, attrs) ⇒ Object
- #copy_string(start_pos, end_pos) ⇒ Object
- #display_attributes ⇒ Object
- #flow(str) ⇒ Object
-
#initialize ⇒ AttributeManager
constructor
A new instance of AttributeManager.
- #mask_protected_sequences ⇒ Object
- #split_into_flow ⇒ Object
- #unmask_protected_sequences ⇒ Object
Constructor Details
#initialize ⇒ AttributeManager
Returns a new instance of AttributeManager.
137 138 139 140 141 142 143 144 145 146 147 148 149 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 137 def initialize add_word_pair("*", "*", :BOLD) add_word_pair("_", "_", :EM) add_word_pair("+", "+", :TT) add_html("em", :EM) add_html("i", :EM) add_html("b", :BOLD) add_html("tt", :TT) add_html("code", :TT) add_special(/<!--(.*?)-->/, :COMMENT) end |
Instance Method Details
#add_html(tag, name) ⇒ Object
168 169 170 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 168 def add_html(tag, name) HTML_TAGS[tag.downcase] = RDoc::Markup::Attribute.bitmap_for name end |
#add_special(pattern, name) ⇒ Object
172 173 174 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 172 def add_special(pattern, name) SPECIAL[pattern] = RDoc::Markup::Attribute.bitmap_for name end |
#add_word_pair(start, stop, name) ⇒ Object
151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 151 def add_word_pair(start, stop, name) raise ArgumentError, "Word flags may not start with '<'" if start[0,1] == '<' bitmap = RDoc::Markup::Attribute.bitmap_for name if start == stop then MATCHING_WORD_PAIRS[start] = bitmap else pattern = /(#{Regexp.escape start})(\S+)(#{Regexp.escape stop})/ WORD_PAIR_MAP[pattern] = bitmap end PROTECTABLE << start[0,1] PROTECTABLE.uniq! end |
#attribute(turn_on, turn_off) ⇒ Object
Return an attribute object with the given turn_on and turn_off bits set
43 44 45 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 43 def attribute(turn_on, turn_off) RDoc::Markup::AttrChanger.new turn_on, turn_off end |
#change_attribute(current, new) ⇒ Object
47 48 49 50 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 47 def change_attribute(current, new) diff = current ^ new attribute(new & diff, current & diff) end |
#changed_attribute_by_name(current_set, new_set) ⇒ Object
52 53 54 55 56 57 58 59 60 61 62 63 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 52 def changed_attribute_by_name(current_set, new_set) current = new = 0 current_set.each do |name| current |= RDoc::Markup::Attribute.bitmap_for(name) end new_set.each do |name| new |= RDoc::Markup::Attribute.bitmap_for(name) end change_attribute(current, new) end |
#convert_attrs(str, attrs) ⇒ Object
Map attributes like textto the sequence 001002<char>001003<char>, where <char> is a per-attribute specific character
76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 76 def convert_attrs(str, attrs) # first do matching ones = MATCHING_WORD_PAIRS.keys.join("") re = /(^|\W)([#{}])([#:\\]?[\w.\/-]+?\S?)\2(\W|$)/ 1 while str.gsub!(re) do attr = MATCHING_WORD_PAIRS[$2] attrs.set_attrs($`.length + $1.length + $2.length, $3.length, attr) $1 + NULL * $2.length + $3 + NULL * $2.length + $4 end # then non-matching unless WORD_PAIR_MAP.empty? then WORD_PAIR_MAP.each do |regexp, attr| str.gsub!(regexp) { attrs.set_attrs($`.length + $1.length, $2.length, attr) NULL * $1.length + $2 + NULL * $3.length } end end end |
#convert_html(str, attrs) ⇒ Object
99 100 101 102 103 104 105 106 107 108 109 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 99 def convert_html(str, attrs) = HTML_TAGS.keys.join '|' 1 while str.gsub!(/<(#{})>(.*?)<\/\1>/i) { attr = HTML_TAGS[$1.downcase] html_length = $1.length + 2 seq = NULL * html_length attrs.set_attrs($`.length + html_length, $2.length, attr) seq + $2 + seq + NULL } end |
#convert_specials(str, attrs) ⇒ Object
111 112 113 114 115 116 117 118 119 120 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 111 def convert_specials(str, attrs) unless SPECIAL.empty? SPECIAL.each do |regexp, attr| str.scan(regexp) do attrs.set_attrs($`.length, $&.length, attr | RDoc::Markup::Attribute::SPECIAL) end end end end |
#copy_string(start_pos, end_pos) ⇒ Object
65 66 67 68 69 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 65 def copy_string(start_pos, end_pos) res = @str[start_pos...end_pos] res.gsub!(/\000/, '') res end |
#display_attributes ⇒ Object
197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 197 def display_attributes puts puts @str.tr(NULL, "!") bit = 1 16.times do |bno| line = "" @str.length.times do |i| if (@attrs[i] & bit) == 0 line << " " else if bno.zero? line << "S" else line << ("%d" % (bno+1)) end end end puts(line) unless line =~ /^ *$/ bit <<= 1 end end |
#flow(str) ⇒ Object
176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 176 def flow(str) @str = str puts("Before flow, str='#{@str.dump}'") if $DEBUG_RDOC mask_protected_sequences @attrs = RDoc::Markup::AttrSpan.new @str.length puts("After protecting, str='#{@str.dump}'") if $DEBUG_RDOC convert_attrs(@str, @attrs) convert_html(@str, @attrs) convert_specials(str, @attrs) unmask_protected_sequences puts("After flow, str='#{@str.dump}'") if $DEBUG_RDOC return split_into_flow end |
#mask_protected_sequences ⇒ Object
128 129 130 131 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 128 def mask_protected_sequences protect_pattern = Regexp.new("\\\\([#{Regexp.escape(PROTECTABLE.join(''))}])") @str.gsub!(protect_pattern, "\\1#{PROTECT_ATTR}") end |
#split_into_flow ⇒ Object
219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 219 def split_into_flow display_attributes if $DEBUG_RDOC res = [] current_attr = 0 str = "" str_len = @str.length # skip leading invisible text i = 0 i += 1 while i < str_len and @str[i].chr == "\0" start_pos = i # then scan the string, chunking it on attribute changes while i < str_len new_attr = @attrs[i] if new_attr != current_attr if i > start_pos res << copy_string(start_pos, i) start_pos = i end res << change_attribute(current_attr, new_attr) current_attr = new_attr if (current_attr & RDoc::Markup::Attribute::SPECIAL) != 0 then i += 1 while i < str_len and (@attrs[i] & RDoc::Markup::Attribute::SPECIAL) != 0 res << RDoc::Markup::Special.new(current_attr, copy_string(start_pos, i)) start_pos = i next end end # move on, skipping any invisible characters begin i += 1 end while i < str_len and @str[i].chr == "\0" end # tidy up trailing text if start_pos < str_len res << copy_string(start_pos, str_len) end # and reset to all attributes off res << change_attribute(current_attr, 0) if current_attr != 0 return res end |
#unmask_protected_sequences ⇒ Object
133 134 135 |
# File 'lib/rdoc/markup/attribute_manager.rb', line 133 def unmask_protected_sequences @str.gsub!(/(.)#{PROTECT_ATTR}/, "\\1\000") end |