1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
#------------------------------------------------------------------------------
#
# Copyright (c) 2005, Enthought, Inc.
# All rights reserved.
#
# This software is provided without warranty under the terms of the BSD
# license included in enthought/LICENSE.txt and may be redistributed only
# under the conditions described in the aforementioned license. The license
# is also available online at http://www.enthought.com/licenses/BSD.txt
#
# Thanks for using Enthought open source!
#
# Author: David C. Morrill
# Date: 10/21/2004
#
#------------------------------------------------------------------------------
""" Defines the HTML editor factory. HTML editors interpret and display
HTML-formatted text, but do not modify it.
"""
#-------------------------------------------------------------------------------
# Imports:
#-------------------------------------------------------------------------------
from __future__ import absolute_import
from traits.api import Str, false
from ..basic_editor_factory import BasicEditorFactory
from ..toolkit import toolkit_object
# Callable that returns the editor to use in the UI.
def html_editor(*args, **traits):
return toolkit_object('html_editor:SimpleEditor')(*args, **traits)
#-------------------------------------------------------------------------------
# Constants:
#-------------------------------------------------------------------------------
# Template used to create code blocks embedded in the module comment
block_template = """<center><table width="95%%"><tr><td bgcolor="#ECECEC"><tt>
%s</tt></td></tr></table></center>"""
# Template used to create lists embedded in the module comment
list_template = """<%s>
%s
</%s>"""
#------------------------------------------------------------------------------
# 'ToolkitEditorFactory' class:
#------------------------------------------------------------------------------
class ToolkitEditorFactory ( BasicEditorFactory ):
""" Editor factory for HTML editors.
"""
#--------------------------------------------------------------------------
# Trait definitions:
#--------------------------------------------------------------------------
# Should implicit text formatting be converted to HTML?
format_text = false
# External objects referenced in the HTML are relative to this url
base_url = Str
# The object trait containing the base URL
base_url_name = Str
# Should links be opened in an external browser?
open_externally = false
#---------------------------------------------------------------------------
# Parses the contents of a formatted text string into the corresponding
# HTML:
#---------------------------------------------------------------------------
def parse_text ( self, text ):
""" Parses the contents of a formatted text string into the
corresponding HTML.
"""
text = text.replace( '\r\n', '\n' )
lines = [ ('.' + line).strip()[1:] for line in text.split( '\n' ) ]
ind = min( *([ self.indent( line ) for line in lines
if line != '' ] + [ 1000, 1000 ]) )
if ind >= 1000:
ind = 0
lines = [ line[ ind: ] for line in lines ]
new_lines = []
i = 0
n = len( lines )
while i < n:
line = lines[i]
m = self.indent( line )
if m > 0:
if line[m] in '-*':
i, line = self.parse_list( lines, i )
else:
i, line = self.parse_block( lines, i )
new_lines.append( line )
else:
new_lines.append( line )
i += 1
text = '\n'.join( new_lines )
paragraphs = [ p.strip() for p in text.split( '\n\n' ) ]
for i, paragraph in enumerate( paragraphs ):
if paragraph[:3].lower() != '<p>':
paragraphs[i] = '<p>%s</p>' % paragraph
return '\n'.join( paragraphs )
#---------------------------------------------------------------------------
# Parses a code block:
#---------------------------------------------------------------------------
def parse_block ( self, lines, i ):
""" Parses a code block.
"""
m = 1000
n = len( lines )
j = i
while j < n:
line = lines[j]
if line != '':
k = self.indent( line )
if k == 0:
break
m = min( m, k )
j += 1
j -= 1
while (j > i) and (lines[j] == ''):
j -= 1
j += 1
temp = [ ((' ' * (self.indent( line ) - m)) +
line.strip()) for line in lines[ i: j ] ]
return ( j, block_template % '\n<br>'.join( temp ) )
#---------------------------------------------------------------------------
# Parses a list:
#---------------------------------------------------------------------------
def parse_list ( self, lines, i ):
""" Parses a list.
"""
line = lines[i]
m = self.indent( line )
kind = line[m]
result = [ '<li>' + line[ m + 1: ].strip() ]
n = len( lines )
j = i + 1
while j < n:
line = lines[j]
k = self.indent( line )
if k < m:
break
if k == m:
if line[k] != kind:
break
result.append( '<li>' + line[ k + 1: ].strip() )
j += 1
elif line[k] in '-*':
j, line = self.parse_list( lines, j )
result.append( line )
else:
result.append( line.strip() )
j += 1
style = [ 'ul', 'ol' ][ kind == '*' ]
return ( j, list_template % ( style, '\n'.join( result ), style ) )
#---------------------------------------------------------------------------
# Calculates the amount of white space at the beginning of a line:
#---------------------------------------------------------------------------
def indent ( self, line ):
""" Calculates the amount of white space at the beginning of a line.
"""
return len( line ) - len( (line + '.').strip() ) + 1
HTMLEditor = ToolkitEditorFactory(klass = html_editor)
#-EOF--------------------------------------------------------------------------
|
